@trungkhai/dynamic-form 0.1.0

package/README.md

@@ -0,0 +1,149 @@
+# @trungkhai/dynamic-form
+
+Reusable schema-driven form library built on Ant Design.
+
+## Install
+
+```bash
+pnpm add @trungkhai/dynamic-form
+```
+
+Peer dependencies: `react`, `react-dom`, `antd`, `@ant-design/icons`, `dayjs`.
+
+Supported ranges: React 18–19, Ant Design 5–6.
+
+## Quick start (v0.1 API)
+
+```tsx
+import { ConfigProvider, Form } from "antd";
+import {
+  DynamicFormProvider,
+  DynamicForm,
+  createAxiosDynamicFormClient,
+} from "@trungkhai/dynamic-form";
+import authInstance from "./authInstance";
+
+const client = createAxiosDynamicFormClient(authInstance);
+
+<ConfigProvider>
+  <DynamicFormProvider
+    client={client}
+    upload={{
+      uploadUrl: "/resources/upload",
+      remove: async ({ path }) => {
+        await authInstance.delete(path);
+        return true;
+      },
+    }}
+    i18n={{
+      messages: {
+        submit: "Lưu",
+        submitError: "Gửi form thất bại",
+        inputPlaceholder: (l) => `Nhập ${l}`,
+        selectPlaceholder: (l) => `Chọn ${l}`,
+      },
+    }}
+    cache={{ ttlMs: 60_000 }}
+  >
+    <DynamicForm formConfig={config} formInstance={form} />
+  </DynamicFormProvider>
+</ConfigProvider>
+```
+
+## Provider groups
+
+| Group | Purpose |
+|-------|---------|
+| `client` | HTTP transport (`client.request`) |
+| `upload` | `upload`, `remove`, `getPayload`, `uploadUrl` |
+| `i18n` | Labels, placeholders, error messages |
+| `parsers` | `optionResponse`, `submitResponse`, `viewResponse` |
+| `renderers` | `fields`, `layout`, `submitActions`, `viewValue`, `link` |
+| `transformers` | `normalizeInitialValues`, `transformFieldValue`, `transformSubmitValues` |
+| `cache` | In-memory TTL cache for options/view requests |
+
+## Custom field renderer
+
+```tsx
+renderers={{
+  fields: [
+    { match: "my_field_code", render: (group, ctx) => <MyInput /> },
+    { match: "select", render: (group, ctx) => <CustomSelect options={ctx.options} /> },
+  ],
+}}
+```
+
+## Migration from v0.0.x
+
+| v0.0.x | v0.1.x |
+|--------|--------|
+| `requestClient` prop | `client={{ request }}` or keep `requestClient` (deprecated) |
+| `uploadAdapter` | `upload.upload` |
+| `deleteUploadAdapter(path)` | `upload.remove({ path, fieldCode, fieldGroup })` |
+| `messages` | `i18n.messages` |
+| `optionResponseParser` | `parsers.optionResponse` |
+| `customFieldRenderers` map | `renderers.fields` array |
+| `onSubmitSuccess(data)` | `onSubmitSuccess({ values, response, data })` |
+| `uploadResourceUrl` | `uploadUrl` (alias kept) |
+
+## API View Mode (MetaView)
+
+Unified mode `api` replaces `api_ids` and `api_detail`:
+
+```json
+{
+  "mode": "api",
+  "api": {
+    "url": "/obs/users",
+    "method": "POST",
+    "data": { "ids": "{{value}}" },
+    "data_path": "data.items",
+    "result_type": "array",
+    "mapping_attr": ["name", "id"],
+    "link": "https://example.com/{{id}}"
+  }
+}
+```
+
+Single object response:
+
+```json
+{
+  "mode": "api",
+  "api": {
+    "url": "/obs/users/{{id}}",
+    "method": "GET",
+    "url_template": true,
+    "data_path": "data",
+    "result_type": "object",
+    "mapping_attr": ["name"]
+  }
+}
+```
+
+| Field | Description |
+|-------|-------------|
+| `url` | API endpoint (supports `{{id}}` when `url_template: true`) |
+| `method` | HTTP method |
+| `data_path` | Dot path to extract data from response (e.g. `data.items`) |
+| `result_type` | `array` (list) or `object` (single row); auto-inferred if omitted |
+| `params` / `data` | Request binding with templates `{{value}}`, `{{id}}` |
+| `url_template` | Fill URL per value item (legacy `api_detail` behavior) |
+| `mapping_attr` | Fields to join as display label |
+| `link` | URL template from item data |
+
+Legacy `api_ids` / `api_detail` configs still work via automatic normalization.
+
+## Performance notes
+
+- `FormItem` is memoized; only re-renders when its own state changes.
+- Option API calls are cached with TTL and abort stale requests.
+- Dependency fields use targeted `Form.useWatch` instead of watching entire form.
+- Submit uses ref guard to prevent double-submit.
+
+## Exports
+
+- Components: `DynamicForm`, `FormItem`, `MetaItemValue`, `ApiViewItem`, `ApiItem`, `ApiDetailItem`
+- Hooks: `useViewMode`, `useDynamicOptions`, `useFieldGroups`, `useFieldStates`, `useProcessedValues`
+- Utils: `parseFormValues`, `normalizeMetaForForm`, `resolveFieldViewValue`, `mapOptions`
+- Adapters: `createAxiosDynamicFormClient`

package/dist/index.cjs.js

@@ -0,0 +1 @@
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const m=require("react/jsx-runtime"),w=require("antd"),l=require("react"),z=require("dayjs"),_e=require("@ant-design/icons"),X=l.createContext(null);function P(){const e=l.useContext(X);if(!e)throw new Error("useDynamicFormContext must be used within DynamicFormProvider");return e}function Ne(){return l.useContext(X)}function ve(e,t=[]){for(const i of t){if(typeof i=="function")continue;const{match:a,render:s}=i;if(typeof a=="string"){if(a===e.field?.type?.code||a===e.code)return s}else if(a(e))return s}const n=e.field?.type?.code;for(const i of t);}function ge(e,t=[],n={}){return ve(e,t)??n[e.code]??n[e.field?.type?.code??""]}function we(e,t){const n=t.option_config?.label_attr,i=t.option_config?.value_attr||"value";let a;if(n?.length){const s=n.join(" - ");e[s]!==void 0?a=String(e[s]):a=n.map(r=>e[r]).filter(r=>r!=null&&r!=="").join(" - ")}else a=String(e[i]??"");return{label:a,value:e[i]}}function Se(e,t){return t.option_config&&t.is_option_api?e?.map(n=>we(n,t)):t.metas?.map(n=>({label:n.label,value:n.value}))}function H(e,t){let n;return(...i)=>{n&&clearTimeout(n),n=setTimeout(()=>e(...i),t)}}const Ye=({onSearchKeyword:e,searchDebounceMs:t=500,...n})=>{const[i,a]=l.useState(""),s=l.useMemo(()=>H(o=>e?.(o),t),[e,t]),r=o=>{a(o),s(o)};return m.jsx(w.Select,{allowClear:!0,showSearch:!0,searchValue:i,onSearch:r,filterOption:!1,...n})},Je=l.memo(Ye),Qe=({fieldName:e,formInstance:t,...n})=>{const i=w.Form.useWatch(e,t);l.useEffect(()=>{if(i?.fileList?.length&&i.fileList.some(r=>!r.type?.startsWith("image/"))){const r=i.fileList.filter(o=>o.type?.startsWith("image/"));t.setFieldValue(e,r?.length?{file:r[0]?.originFileObj,fileList:r}:null)}},[e,t,i]);const a=m.jsx("button",{style:{border:0,background:"none",cursor:"pointer"},type:"button",children:m.jsx(_e.FileImageOutlined,{})});return m.jsx(w.Upload,{listType:"picture-card",accept:"image/*",...n,children:a})},Xe=l.memo(Qe),Ze=({fieldName:e,formInstance:t,...n})=>{const i=w.Form.useWatch(e,t);return m.jsx(w.Upload,{fileList:i?.fileList,...n,children:m.jsx(w.Button,{icon:m.jsx(_e.UploadOutlined,{})})})},et=l.memo(Ze),Fe=({formInstance:e,uploadUrl:t,setFieldState:n})=>{const{client:i,upload:a,i18n:s,renderers:r}=P(),{messages:o}=s,u=l.useCallback(()=>{if(a.upload)return a.upload;const c=t??a.uploadUrl;if(c)return async({file:h,signal:p,onProgress:y,fieldCode:x,fieldGroup:g,metadata:S})=>{const f=a.getPayload?a.getPayload({file:h,fieldCode:x,fieldGroup:g,uploadUrl:c,signal:p,onProgress:y,metadata:S}):(()=>{const v=new FormData;return v.append("file",h),S&&Object.entries(S).forEach(([A,R])=>{v.append(A,String(R))}),v})(),F=(await i.request({method:"POST",url:c,data:f,headers:f instanceof FormData?{"Content-Type":"multipart/form-data"}:void 0,signal:p,onUploadProgress:v=>{y?.(Math.round(v.loaded*100/(v.total||1)))}})).data;return{uid:h.uid,...F,path:String(F.path??"")}}},[i,a,t]),d=l.useCallback((c,h)=>p=>{const{file:y,onProgress:x,onError:g,onSuccess:S}=p,f=new AbortController,j=u();return j?(j({file:y,fieldCode:c,fieldGroup:h,uploadUrl:t??a.uploadUrl,signal:f.signal,onProgress:F=>x?.({percent:F})}).then(F=>S?.({...F,uid:F.uid??y.uid,path:F.path,upload_date:z().format("YYYY-MM-DD HH:mm:ss")})).catch(F=>g?.(F)),{abort:()=>f.abort()}):(g?.(new Error(o.uploadError??"Upload not configured")),{abort(){}})},[o.uploadError,u,a.uploadUrl,t]),b=l.useCallback((c,h)=>async p=>{const y=p.response?.path;return y?a.remove({path:y,fieldCode:c,fieldGroup:h}):!0},[a]),_=l.useCallback((c,{state:h,options:p,optionsLoading:y,optionsError:x,onSearchKeyword:g,readOnly:S=!1})=>{const{additional_config:f,field:j}=c,F=j?.type?.code,v=S||c.is_readonly||h?.disabled,A=ge(c,r.fields);if(A)return A(c,{state:h,options:p,optionsLoading:y,optionsError:x,onSearchKeyword:g,readOnly:S,formInstance:e,disabled:!!v,setFieldState:n});const R=Se(p,c);switch(F){case"text":return f?.text?.textarea?m.jsx(w.Input.TextArea,{disabled:v,placeholder:o.inputPlaceholder(c.label),rows:f?.text?.rows}):m.jsx(w.Input,{disabled:v,placeholder:o.inputPlaceholder(c.label)});case"number":return m.jsx(w.InputNumber,{style:{width:"100%"},disabled:v,placeholder:o.inputPlaceholder(c.label),min:f?.number?.min,max:f?.number?.max});case"select":{const M={disabled:v,options:R,placeholder:o.selectPlaceholder(c.label),allowClear:!0,loading:y,mode:f?.select?.multiple?"multiple":void 0,notFoundContent:x?o.optionError:y?o.optionLoading:void 0};return g?m.jsx(Je,{...M,onSearchKeyword:g,searchDebounceMs:f?.select?.searchDebounceMs??500}):m.jsx(w.Select,{...M,showSearch:!0,optionFilterProp:"label"})}case"radio":return m.jsx(w.Radio.Group,{disabled:v,options:R});case"checkbox":return m.jsx(w.Checkbox.Group,{disabled:v,options:R});case"datetime":return m.jsx(w.DatePicker,{style:{width:"100%"},disabled:v,showTime:f?.datetime?.showTime,format:f?.datetime?.format});case"file":return m.jsx(et,{disabled:v,fieldName:c.code,formInstance:e,multiple:f?.file?.multiple||!1,maxCount:f?.file?.max,accept:f?.file?.accept,customRequest:d(c.code,c),onRemove:b(c.code,c)});case"image":return m.jsx(Xe,{disabled:v,fieldName:c.code,formInstance:e,multiple:f?.image?.multiple||!1,maxCount:f?.image?.max,accept:f?.image?.accept??"image/*",customRequest:d(c.code,c),onRemove:b(c.code,c)});default:return null}},[d,b,e,o,r.fields,n]);return l.useMemo(()=>({getDynamicField:_}),[_])};function N(e){return JSON.stringify(e)}function xe(e,t){const n=e.get(t);if(n){if(Date.now()>n.expiresAt){e.delete(t);return}return n.data}}function je(e,t,n,i){e.set(t,{data:n,expiresAt:Date.now()+i})}async function Z(e,t,n,i,a){const s=e[t];if(e.cache.enabled){const d=xe(s,n);if(d!==void 0)return d}const r=new AbortController,o=a?AbortSignal.any([a,r.signal]):r.signal,u=await i(o);return e.cache.enabled&&je(s,n,u,e.cache.ttlMs),u}function T(e,t){return t.split(".").reduce((n,i)=>{if(n&&typeof n=="object")return n[i]},e)}function tt(e,t){if(typeof e!="string")return e;const n=e.match(/^\{\{(.+?)\}\}$/);if(!n)return e;const i=n[1].trim(),a=T(t,i);return a!==void 0?a:e}function Ae(e,t){const n={};for(const i in e)n[i]=tt(e[i],t);return n}function nt(e,t){const n={...e};return t.forEach(i=>{const a=e[i.code];if(a==null)return;switch(i.field?.type?.code){case"datetime":{const r=z(a);r.isValid()&&(n[i.code]=r);break}case"file":case"image":{if(Array.isArray(a)&&a.length>0){const r=a.map((o,u)=>{const d=o;return{uid:String(d.uid??d.path??u),name:d.name??`file-${u}`,status:"done",percent:100,type:d.type,size:d.size,response:o}});n[i.code]={fileList:r}}break}}}),n}function Ce(e){const t=e.option_config?.api_options?.params||{},n=e.option_config?.api_options?.data||{},i=a=>Object.values(a).filter(s=>typeof s=="string"&&s.startsWith("{{")&&s.endsWith("}}")).map(s=>s.slice(2,-2).trim());return Array.from(new Set([...i(t),...i(n)]))}function E(e,t){const n={};for(const i in e){const a=e[i];if(typeof a=="string"&&a.startsWith("{{")&&a.endsWith("}}")){const s=a.slice(2,-2).trim();n[i]=t?.[s]}else n[i]=a}return n}function Re(e,t){return e.replace(/\{\{\s*(\w+)\s*\}\}/g,(n,i)=>{const a=t?.[i];return a!=null?String(a):""})}function De(e,t){const n=l.useMemo(()=>Ce(e),[e]),i=w.Form.useWatch(n.length>0?n:void 0,t);return l.useMemo(()=>{if(!n.length)return{};const a={};return n.forEach((s,r)=>{Array.isArray(i)?a[s]=i[r]:a[s]=i}),a},[n,i])}function Me({group:e,formInstance:t,searchKeyword:n="",searchDebounceMs:i=500}){const a=P(),s=De(e,t),[r,o]=l.useState(),[u,d]=l.useState(!1),[b,_]=l.useState(),c=l.useRef(null),[h,p]=l.useState(n),y=e.additional_config?.select?.search_keyword??!1,x=l.useMemo(()=>H(f=>p(f),i),[i]);l.useEffect(()=>{y?x(n):p("")},[n,y,x]);const g=l.useMemo(()=>{const f=e.option_config?.api_options?.params,j=e.option_config?.api_options?.data;if(!(!f&&!j))return{params:f?E(f,s):void 0,data:j?E(j,s):void 0}},[s,e]),S=l.useCallback(async()=>{if(!e.option_config||!e.is_option_api||!e.option_config.url)return;c.current?.abort();const f=new AbortController;c.current=f;const j=e.option_config.method?.toUpperCase()==="GET"||!e.option_config.method,F=y?h:"",v=N([e.code,e.option_config.url,e.option_config.method,g,F]);d(!0),_(void 0);try{const A=await Z(a,"optionCache",v,async R=>{const M=await a.client.request({method:e.option_config?.method||"GET",url:e.option_config?.url,params:j&&y?{...g?.params,keywords:F}:g?.params,data:!j&&y?{...g?.data,keywords:F}:g?.data,signal:R});return a.parsers.optionResponse(M.data,e)},f.signal);f.signal.aborted||o(A)}catch(A){f.signal.aborted||_(A)}finally{f.signal.aborted||d(!1)}},[g,a,h,e,y]);return l.useEffect(()=>(e.option_config&&e.is_option_api&&S(),()=>c.current?.abort()),[S,e]),{options:r,isLoading:u,error:b,refetch:S}}const it=({group:e,formInstance:t,fieldState:n,setFieldState:i,uploadUrl:a,readOnly:s=!1,size:r="middle",...o})=>{const{getDynamicField:u}=Fe({formInstance:t,uploadUrl:a,setFieldState:i}),d=w.Form.useWatch(e.code,t),[b,_]=l.useState(""),c=e.additional_config?.select?.search_keyword??!1,{options:h,isLoading:p,error:y}=Me({group:e,formInstance:t,searchKeyword:b,searchDebounceMs:e.additional_config?.select?.searchDebounceMs??500}),x=l.useCallback(S=>{_(S)},[]);l.useEffect(()=>{if(e.additional_config?.on_field_change?.clear?.length){const S=t.getFieldsValue(e.additional_config.on_field_change.clear),f=e.additional_config.on_field_change.clear.filter(j=>S?.[j]);f.length&&t.resetFields(f)}e.additional_config?.on_field_empty?.disable?.length&&e.additional_config.on_field_empty.disable.forEach(S=>{i(S,{disabled:!d})})},[d,t,e,i]);const g=r==="small"?4:12;return m.jsx(w.Form.Item,{label:e.label,name:e.code,hidden:n?.hidden,rules:[{required:n?.required||!1}],style:{marginBottom:g,...o.style},...o,children:u(e,{state:n,options:h,optionsLoading:p,optionsError:y,onSearchKeyword:c?x:void 0,readOnly:s})})};function at(e,t){return e.group.id===t.group.id&&e.readOnly===t.readOnly&&e.uploadUrl===t.uploadUrl&&e.size===t.size&&e.fieldState?.disabled===t.fieldState?.disabled&&e.fieldState?.hidden===t.fieldState?.hidden&&e.fieldState?.required===t.fieldState?.required}const ke=l.memo(it,at);function Ee({fieldGroups:e,fieldStates:t,renderField:n,gutter:i,defaultColSpan:a}){return m.jsx(w.Row,{gutter:i,children:e.map(s=>{const r=t[s.code]?.hidden?0:Number(s.additional_config?.field_col_span)||a;return m.jsx(w.Col,{xs:r,children:n(s)},s.id)})})}function Ve(e){return l.useMemo(()=>{const t=e?.form?.field_groups??[],n=new Map,i={};t.forEach(s=>{n.set(s.code,s),s.additional_config?.default!==void 0&&(i[s.code]=s.additional_config.default)});const a=t.filter(s=>!s.is_hidden);return{fieldGroups:t,fieldByCode:n,visibleFieldGroups:a,initialValues:i}},[e])}function ye(e){const t={};return e.forEach(n=>{t[n.code]={disabled:n.is_readonly,hidden:n.is_hidden,required:n.is_required}}),t}function Pe(e){const[t,n]=l.useState(()=>ye(e));l.useEffect(()=>{n(ye(e))},[e]);const i=l.useCallback((a,s)=>{n(r=>({...r,[a]:{...r[a],...s}}))},[]);return{fieldStates:t,setFieldStates:n,setFieldState:i}}function Te({formInstance:e,fieldByCode:t,relatedData:n,transformers:i}){return{buildProcessedValues:l.useCallback(async()=>{await e.validateFields();const s=e.getFieldsValue(),r={};for(const d of Object.keys(s)){const b=t.get(d);if(!b)continue;let _;switch(b.field?.type?.code){case"datetime":_=s[d]?z(s[d]).format(b.additional_config?.datetime?.format):null;break;case"image":case"file":s[d]?.fileList?.length&&(_=s[d].fileList.filter(c=>c.percent===100).map(c=>({...c.response,name:c.name,type:c.type,size:c.size})));break;default:_=s[d]}i.transformFieldValue&&(_=i.transformFieldValue(d,_,b)),r[d]=_}let o=r;return i.transformSubmitValues&&(o=i.transformSubmitValues(o,Array.from(t.values()),n)),(i.parseRelatedDataTemplates??Ae)(o,n??{})},[t,e,n,i])}}const Oe=l.forwardRef(({formConfig:e,formInstance:t,relatedData:n,uploadUrl:i,uploadResourceUrl:a,submitTrackingUrl:s,onBeforeSubmit:r,onSubmitSuccess:o,onSubmitError:u,isRedirectAfterCreate:d,onRedirect:b,size:_="middle",manualSubmit:c=!1,onValuesChange:h,readOnly:p=!1,submitDebounceMs:y,gutter:x=[8,0],defaultColSpan:g=12,submitButtonLabel:S},f)=>{const{message:j}=w.App.useApp(),F=P(),{i18n:v,client:A,parsers:R,redirectHandler:M,renderers:q,transformers:I}=F,oe=i??a,re=y??F.submitDebounceMs,le=S??v.messages.submit,{fieldGroups:k,fieldByCode:$e,initialValues:U}=Ve(e),{fieldStates:G,setFieldState:ce}=Pe(k),{buildProcessedValues:W}=Te({formInstance:t,fieldByCode:$e,relatedData:n,transformers:I}),B=l.useRef(!1),[de,ue]=l.useState(!1),[me,fe]=l.useState(!1);l.useEffect(()=>{if(Object.keys(U).length>0){const C=I.normalizeInitialValues?I.normalizeInitialValues(U,k):U;t.setFieldsValue(C)}},[k,t,U,I]);const K=l.useCallback(async()=>{if(!B.current){B.current=!0,ue(!0);try{let C=await W();try{s&&(fe(!0),await A.request({method:"POST",url:s,data:C}));const D=await r?.(C);if(D===!1)return;D&&typeof D=="object"&&(C=D)}catch(D){console.error(D);return}finally{fe(!1)}const O=await A.request({method:e.method,url:e.action,data:C});t.resetFields(k.filter(D=>!D.is_hidden).map(D=>D.code));const Y=R.submitResponse(O.data);d&&Y.redirectUrl&&(b??M)(Y.redirectUrl,"_blank"),o?.({values:C,response:O.data,data:Y.data??O.data})}catch(C){const O=C;j.error(O?.response?.data?.message??v.messages.submitError),u?.(C)}finally{B.current=!1,ue(!1)}}},[W,A,k,e.action,e.method,t,v.messages.submitError,d,j,r,b,u,o,R,M,s]);l.useImperativeHandle(f,()=>({submit:K,getProcessedValues:W,isSubmitting:()=>B.current}),[W,K]);const pe=l.useMemo(()=>H(()=>{K()},re),[K,re]),he=l.useCallback(C=>m.jsx(ke,{group:C,formInstance:t,fieldState:G[C.code],setFieldState:ce,uploadUrl:oe,readOnly:p,size:_},C.id),[G,t,p,oe,ce,_]),ze=q.layout?q.layout({fieldGroups:k,fieldStates:G,renderField:he,gutter:x,defaultColSpan:g,size:_}):m.jsx(Ee,{fieldGroups:k,fieldStates:G,renderField:he,gutter:x,defaultColSpan:g,size:_}),He=!c&&!p&&(q.submitActions?q.submitActions({onSubmit:pe,loading:de||me,label:le}):m.jsx(w.Flex,{justify:"flex-end",children:m.jsx(w.Button,{type:"primary",onClick:pe,loading:de||me,children:le})}));return m.jsxs(w.Form,{layout:"vertical",form:t,size:_,onValuesChange:h,children:[ze,He]})});Oe.displayName="DynamicForm";function ee(e){if(!e)return;const{mode:t}=e;if(t==="api"&&e.api?.url)return e.api;if(t==="api_ids"&&e.api_ids?.url){const n=e.api_ids,i=n.method?.toUpperCase()==="POST";return{url:n.url,method:n.method,data_path:n.data_path,mapping_attr:n.mapping_attr,link:n.link,result_type:n.result_type??"array",params:n.params??(!i&&!n.data?{ids:"{{value}}"}:void 0),data:n.data??(i&&!n.params?{ids:"{{value}}"}:void 0)}}if(t==="api_detail"&&e.api_detail?.url){const n=e.api_detail;return{url:n.url,method:n.method,data_path:n.data_path,mapping_attr:n.mapping_attr,link:n.link,result_type:n.result_type??"object",url_template:n.url_template??!0,params:n.params,data:n.data}}}function be(e){return{value:e,id:e}}function Le(e,t){const n=t.method||"GET",i=n.toUpperCase()==="GET";if(t.url_template)return(Array.isArray(e)?e.filter(u=>u!=null&&u!==""):e!=null&&e!==""?[e]:[]).map(u=>{const d=be(u),b=Re(t.url,d),_=t.params?E(t.params,d):void 0,c=t.data?E(t.data,d):void 0;return{method:n,url:b,params:i?_:void 0,data:i?void 0:c}});const a=be(e),s=t.params?E(t.params,a):void 0,r=t.data?E(t.data,a):void 0;return[{method:n,url:t.url,params:i?s:void 0,data:i?void 0:r}]}function te(e,t){const n=t.data_path?T(e,t.data_path):e;return(t.result_type??(Array.isArray(n)?"array":"object"))==="array"?Array.isArray(n)?n:n!=null?[n]:[]:Array.isArray(n)?n.length?[n[0]]:[]:n&&typeof n=="object"?[n]:[]}function ne(e,t){return dt(e,t.mapping_attr)}function ie(e,t){return ut(t.link,e)}async function qe(e,t,n,i){const a=Le(e,t);if(!a.length)return[];const s=await Promise.all(a.map(o=>n({...o,signal:i}))),r=[];for(const o of s)r.push(...te(o.data,t));return r}function V(e){return!!(e==null||e===""||Array.isArray(e)&&e.length===0)}function Ie(e,t){const n=e.option_config?.api_options?.params,i=e.option_config?.api_options?.data;if(!n&&!i)return;const a=s=>{const r={};for(const o in s)if(typeof s[o]=="string"&&s[o].startsWith("{{")&&s[o].endsWith("}}")){const u=s[o].slice(2,-2).trim();r[o]=t?.[u]}else r[o]=s[o];return r};return{params:n?a(n):void 0,data:i?a(i):void 0}}function st(e,t){const n=t.option_config?.label_attr,i=t.option_config?.value_attr||"";if(n?.length){const a=n.join(" - ");return e[a]!==void 0?String(e[a]):n.map(s=>e[s]).filter(s=>s!=null&&s!=="").join(" - ")}return String(e[i]??"")}function ot(e,t){if(!t?.length)return null;const i=(Array.isArray(e)?e:[e]).map(a=>t.find(s=>String(s.value)===String(a))?.label).filter(a=>!!a);return i.length?i.join(", "):null}function rt(e,t,n){if(V(e))return null;const i=t.option_config?.value_attr||"value",a=Array.isArray(e)?e:[e];if(t.is_option_api&&n?.length){const r=a.map(o=>{const u=n.find(d=>String(d[i])===String(o));return u?st(u,t):String(o)}).filter(Boolean);return r.length?r.join(", "):null}const s=ot(e,t.metas);return s||a.map(String).join(", ")}function lt(e,t){if(V(e))return null;const n=t.additional_config?.datetime?.format,i=z(e);return i.isValid()?n?i.format(n):i.format("YYYY-MM-DD HH:mm:ss"):String(e)}function ct(e){if(V(e))return null;if(Array.isArray(e)){const t=e.map(n=>typeof n=="object"&&n&&"name"in n?String(n.name):String(n)).filter(Boolean);return t.length?t.join(", "):null}return String(e)}function dt(e,t){return t?.length?t.map(n=>{const i=T(e,n)??e[n];return i!=null?String(i):""}).filter(Boolean).join(" - "):JSON.stringify(e)}function ut(e,t){return e?e.replace(/\{\{(.+?)\}\}/g,(n,i)=>{const a=i.trim(),s=T(t,a)??t[a];return s!=null?String(s):""}):null}function Q(e,t,n){if(V(e))return null;switch(t?.mode??"formatted"){case"raw":case"formatted":return Array.isArray(e)?e.map(String).join(", "):String(e);case"api":case"api_ids":case"api_detail":{const a=ee(t);if(!n||!a)return Array.isArray(e)?e.map(String).join(", "):String(e);const s=te(n,a);return s.length?s.map(o=>{const u=ne(o,a),d=ie(o,a);return d?`${u} (${d})`:u}).filter(Boolean).join(", ")||null:String(e)}default:return String(e)}}function Ue(e,t,n){const i=e.additional_config?.view_value;if(i?.mode==="api"||i?.mode==="api_ids"||i?.mode==="api_detail")return Q(t,i,n.viewValueFetched);switch(e.field?.type?.code){case"text":case"number":return V(t)?null:String(t);case"datetime":return lt(t,e);case"select":case"radio":case"checkbox":return rt(t,e,n.optionList);case"image":case"file":return ct(t);default:return i?Q(t,i,n.viewValueFetched):V(t)?null:String(t)}}function ae(e,t,n=!0){const i=P(),[a,s]=l.useState(),[r,o]=l.useState(!1),[u,d]=l.useState(),b=l.useRef(null),_=l.useCallback(async()=>{if(!n)return;b.current?.abort();const c=new AbortController;b.current=c;const h=N(e);o(!0),d(void 0);try{const p=await Z(i,"viewCache",h,t,c.signal);return c.signal.aborted||s(p),p}catch(p){throw c.signal.aborted||d(p),p}finally{c.signal.aborted||o(!1)}},[e,i,n,t]);return l.useEffect(()=>(n&&_(),()=>b.current?.abort()),[n,_]),{data:a,isLoading:r,error:u,refetch:_}}const mt=({value:e,code:t,modeConfig:n,viewConfig:i})=>{const{client:a,renderers:s,i18n:r}=P(),o=n??(i?ee(i):void 0),{data:u,isLoading:d,error:b}=ae(["api_view",t,e,o?.url,o?.method,o?.data_path],async h=>o?qe(e,o,p=>a.request(p),h):[],!!(e&&o?.url)),_=(h,p,y)=>s.link?s.link({url:h,label:p,data:y}):m.jsx("a",{href:h,target:"_blank",rel:"noreferrer",children:p}),c=(h,p)=>{if(!o)return null;const y=ne(h,o),x=ie(h,o),g=x?_(x,y,h):y;return m.jsx("div",{children:g},h.id??p)};return d?m.jsx(m.Fragment,{children:s.viewLoading?.()??m.jsx(w.Spin,{size:"small"})}):b?m.jsx(m.Fragment,{children:s.viewError?.(b)??r.messages.viewError}):u?.length?o?.result_type==="object"&&u.length===1?c(u[0],0):m.jsx(w.Flex,{vertical:!0,children:u.map(c)}):m.jsx(m.Fragment,{children:s.viewEmpty?.()??r.messages.viewEmpty})},L=l.memo(mt);function ft(e){return!!(e.option_config&&e.is_option_api)}function pt(e){return e==="api"||e==="api_ids"||e==="api_detail"}function ht(e,t){const n=P(),i=N(["viewModeOptions",e.map(s=>s.code),t]),{data:a}=ae([i],async s=>{const r={};return await Promise.all(e.map(async o=>{if(!o.option_config?.url)return;const u=Ie(o,t),d=o.option_config.method?.toUpperCase()==="GET"||!o.option_config.method,b=await n.client.request({method:o.option_config.method||"GET",url:o.option_config.url,params:d?u?.params:void 0,data:d?void 0:u?.data,signal:s});r[o.code]={optionList:n.parsers.optionResponse(b.data,o)}})),r},e.length>0);return a??{}}const yt=({formConfig:e,formValues:t})=>{const n=e?.form?.field_groups??[],i=l.useMemo(()=>n.filter(ft),[n]),a=ht(i,t);return l.useMemo(()=>n.filter(r=>!r.is_hidden).map(r=>{const o=t?.[r.code],u=r.additional_config?.view_value,d=u?.mode;if(pt(d)&&u)return{key:r.code,label:r.label,rawValue:o,viewValue:m.jsx(L,{code:r.code,value:o,viewConfig:u}),field_group:r};const b=a[r.code]??{};return{key:r.code,label:r.label,rawValue:o,viewValue:Ue(r,o,b),field_group:r}}),[a,n,t])},bt=({code:e,value:t,fieldGroup:n})=>{const i=n?.additional_config?.view_value;switch(i?.mode){case"raw":return t;case"api":case"api_ids":case"api_detail":return m.jsx(L,{code:e,value:t,viewConfig:i});default:return t}},_t=l.memo(bt),vt=({value:e,code:t,modeConfig:n})=>m.jsx(L,{code:t,value:e,viewConfig:n?{mode:"api_ids",api_ids:n}:void 0}),gt=l.memo(vt),wt=({value:e,code:t,modeConfig:n})=>m.jsx(L,{code:t,value:e,viewConfig:n?{mode:"api_detail",api_detail:n}:void 0}),St=l.memo(wt),se={submit:"Save",submitError:"Failed to submit form",inputPlaceholder:e=>`Enter ${e}`,selectPlaceholder:e=>`Select ${e}`,optionLoading:"Loading...",optionError:"Failed to load options",uploadError:"Upload failed",viewLoading:"Loading...",viewEmpty:"-",viewError:"Failed to load"},Ft={messages:se},Ge=e=>{if(Array.isArray(e))return e;if(e&&typeof e=="object"&&"items"in e&&Array.isArray(e.items))return e.items;if(e&&typeof e=="object"&&"data"in e&&e.data&&typeof e.data=="object"&&"items"in(e.data??{})){const t=e.data;return Array.isArray(t.items)?t.items:[]}return[]},We=e=>({redirectUrl:e?.redirect_after_create,data:e}),Be=(e,t)=>t?.dataPath?T(e,t.dataPath):e,$={optionResponse:Ge,submitResponse:We,viewResponse:Be},Ke=(e,t="_blank")=>{window.open(e,t)},J={upload:async()=>{throw new Error("Upload adapter is not configured")},remove:async()=>!1};function xt({children:e,client:t,upload:n,i18n:i,parsers:a,renderers:s={},transformers:r={},cache:o,submitDebounceMs:u=200,redirectHandler:d,requestClient:b,uploadAdapter:_,deleteUploadAdapter:c,messages:h,optionResponseParser:p,customFieldRenderers:y}){const x=l.useRef(new Map),g=l.useRef(new Map),S=l.useMemo(()=>{const f=t??{request:b??(()=>{throw new Error("DynamicFormProvider requires client or requestClient")})},j=y?Object.entries(y).map(([A,R])=>({match:A,render:R})):[],F={...se,...i?.messages,...h},v={...J,...n,upload:n?.upload??_??J.upload,remove:n?.remove??(c?A=>c(A.path):J.remove)};return{client:f,upload:v,i18n:{messages:F},parsers:{optionResponse:a?.optionResponse??p??$.optionResponse,submitResponse:a?.submitResponse??$.submitResponse,viewResponse:a?.viewResponse??$.viewResponse},renderers:{...s,fields:[...s.fields??[],...j]},transformers:r,cache:{enabled:o?.enabled??!0,ttlMs:o?.ttlMs??6e4},submitDebounceMs:u,redirectHandler:d??Ke,optionCache:x.current,viewCache:g.current}},[t,b,n,_,c,i?.messages,h,a?.optionResponse,a?.submitResponse,a?.viewResponse,p,s,y,r,o?.enabled,o?.ttlMs,u,d]);return m.jsx(X.Provider,{value:S,children:e})}function jt(e){return{request:async t=>({data:(await e({method:t.method,url:t.url,params:t.params,data:t.data,signal:t.signal,headers:t.headers,onUploadProgress:t.onUploadProgress})).data})}}exports.ApiDetailItem=St;exports.ApiItem=gt;exports.ApiViewItem=L;exports.DefaultLayout=Ee;exports.DynamicForm=Oe;exports.DynamicFormProvider=xt;exports.FormItem=ke;exports.MetaItemValue=_t;exports.buildApiViewRequests=Le;exports.buildCacheKey=N;exports.cachedRequest=Z;exports.createAxiosDynamicFormClient=jt;exports.debounce=H;exports.defaultI18n=Ft;exports.defaultMessages=se;exports.defaultOptionResponseParser=Ge;exports.defaultParsers=$;exports.defaultRedirectHandler=Ke;exports.defaultSubmitResponseParser=We;exports.defaultViewResponseParser=Be;exports.extractDependencyFields=Ce;exports.extractViewData=te;exports.fetchApiViewItems=qe;exports.fillTemplate=Re;exports.getByPath=T;exports.getCached=xe;exports.getMappedLabel=ne;exports.getMappedLink=ie;exports.isEmptyValue=V;exports.mapOptionToSelectItem=we;exports.mapOptions=Se;exports.normalizeApiViewConfig=ee;exports.normalizeMetaForForm=nt;exports.parseFormValues=Ae;exports.replaceTemplateInObject=E;exports.resolveApiOptionMeta=Ie;exports.resolveFieldRenderer=ve;exports.resolveFieldRendererFromMap=ge;exports.resolveFieldViewValue=Ue;exports.resolveViewValueConfig=Q;exports.setCache=je;exports.useCachedViewRequest=ae;exports.useDependencyValues=De;exports.useDynamicField=Fe;exports.useDynamicFormContext=P;exports.useDynamicFormContextOptional=Ne;exports.useDynamicOptions=Me;exports.useFieldGroups=Ve;exports.useFieldStates=Pe;exports.useProcessedValues=Te;exports.useViewMode=yt;