ding-react-admin 1.0.2 → 2.0.0

package/src/index.ts

@@ -28,6 +28,7 @@ export type {
   DeleteResult,
   GetListParams,
   GetListResult,
+  GetOneParams,
   GetOneResult,
   Identifier,
   PaginationParams,
@@ -36,17 +37,20 @@ export type {
   UpdateParams,
   UpdateResult,
   FormMutation,
+  FormMutationBody,
   FormValidationErrors,
   ParseFormError,
   ParseFormErrorContext,
 } from "./data/dataProviderTypes";
 export { combineResourceHandlers } from "./data/resourceHandlers";
+export { isAbortError } from "./data/abortError";
 export {
   parseDjangoDRFFormErrors,
   parseDotNetFormErrors,
   parseNodeFormErrors,
   getErrorBody,
-  applyInlineFieldPaths,
+  resolveErrorBody,
+  flattenNestedArrayErrors,
   asStringMessages,
   finalizeFormErrors,
 } from "./data/parseFormErrorHelpers";
@@ -118,12 +122,11 @@ export {
   ResourceForm,
   ResourceFormModal,
   InlineFormSet,
+  InlineFormSetStacked,
   FormTabs,
   FormTab,
   FormSteps,
   FormStep,
-  saveInlineRows,
-  loadInlineRows,
   TextField,
   NumberField,
   BooleanField,
@@ -132,12 +135,16 @@ export {
   PasswordField,
   ReferenceField,
   ReferenceManyField,
+  ImageField,
+  FileField,
+  FieldWrapper,
   TextColumn,
   NumberColumn,
   BooleanColumn,
   DateColumn,
   ReferenceColumn,
   ReferenceManyColumn,
+  ImageColumn,
   CustomColumn,
   TextFilter,
   NumberFilter,
@@ -148,22 +155,29 @@ export {
   ReferenceManyFilter,
   useListQueryState,
   useChoices,
-  getByPath,
-  pickBySources,
-  inlineArrayName,
+  useAbortableEffect,
+  getFormValue,
+  setFormValue,
+  buildFormPayload,
+  buildInlineRowsPayload,
+  buildResourceFormSubmitBody,
+  prepareFormSubmitBody,
+  toFormData,
+  hasUploadValues,
+  nestedFieldPath,
   useResourceListContext,
-  useRegisterFormSource,
+  useRegisterPayloadField,
+  useRegisterSectionField,
 } from "./crud";
 export type {
   ResourceFormProps,
-  ResourceFormInlineConfig,
   ResourceFormModalProps,
   InlineFormSetProps,
+  InlineFormSetStackedProps,
   FormTabsProps,
   FormTabProps,
   FormStepsProps,
   FormStepProps,
-  SaveInlineOptions,
   InlineFormSetLayout,
   ResourceListProps,
   BaseSourceProps,
@@ -173,6 +187,17 @@ export type {
   DisplayProps,
   EditMode,
   FieldRules,
+  InlineCellContext,
+  InlineColumnDef,
+  InlineFormSetBaseProps,
+  InlineRowContext,
+  InlineFieldRegistration,
+  FieldWrapperProps,
+  ImageFieldProps,
+  FileFieldProps,
+  UploadFieldValue,
+  ToFormDataOptions,
+  PrepareFormSubmitBodyOptions,
   ResourceListBuiltInActions,
   ResourceListBulkAction,
   ResourceListBulkActionHelpers,

package/src/layouts/AdminLayout.tsx

@@ -321,7 +321,7 @@ export function AdminLayout({
           />
         </Drawer>
       )}
-      <Layout>
+      <Layout style={{ minWidth: 0 }}>
         <Layout.Header
           style={{
             background: token.colorBgContainer,
@@ -371,6 +371,7 @@ export function AdminLayout({
         <Layout.Content
           style={{
             margin: isMobile ? token.marginSM : token.marginLG,
+            minWidth: 0,
           }}
         >
           <Outlet />

package/dist/src/crud/context/FormFieldsContext.d.ts

@@ -1,14 +0,0 @@
-import { MutableRefObject, ReactNode } from 'react';
-type FormFieldsContextValue = {
-    registerSource: (source: string) => () => void;
-    getSources: () => string[];
-};
-export declare function FormFieldsProvider({ children, sourcesRef: externalSourcesRef, }: {
-    children: ReactNode;
-    /** Optional ref shared with submit handler outside this provider. */
-    sourcesRef?: MutableRefObject<Set<string>>;
-}): import("react/jsx-runtime").JSX.Element;
-export declare function useFormFieldsOptional(): FormFieldsContextValue | null;
-export declare function useRegisterFormSource(source: string): void;
-export {};
-//# sourceMappingURL=FormFieldsContext.d.ts.map

package/dist/src/crud/context/FormFieldsContext.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"FormFieldsContext.d.ts","sourceRoot":"","sources":["../../../../src/crud/context/FormFieldsContext.tsx"],"names":[],"mappings":"AAAA,OAAO,EAOL,KAAK,gBAAgB,EACrB,KAAK,SAAS,EACf,MAAM,OAAO,CAAC;AAGf,KAAK,sBAAsB,GAAG;IAC5B,cAAc,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,MAAM,IAAI,CAAC;IAC/C,UAAU,EAAE,MAAM,MAAM,EAAE,CAAC;CAC5B,CAAC;AAIF,wBAAgB,kBAAkB,CAAC,EACjC,QAAQ,EACR,UAAU,EAAE,kBAAkB,GAC/B,EAAE;IACD,QAAQ,EAAE,SAAS,CAAC;IACpB,qEAAqE;IACrE,UAAU,CAAC,EAAE,gBAAgB,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC;CAC5C,2CA6BA;AAED,wBAAgB,qBAAqB,kCAEpC;AAED,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,MAAM,QAcnD"}

package/dist/src/crud/context/InlineFormContext.d.ts

@@ -1,16 +0,0 @@
-import { ReactNode } from 'react';
-import { InlineFieldDefinition } from '../types';
-export type InlineFormSetLayout = "tabular" | "stacked";
-export declare function InlineFormSetProvider({ children, arrayName, layout, }: {
-    children: ReactNode;
-    arrayName: string;
-    layout?: InlineFormSetLayout;
-}): import("react/jsx-runtime").JSX.Element;
-export declare function useInlineFormSetContext(): {
-    fields: InlineFieldDefinition[];
-    registerField: (def: InlineFieldDefinition) => () => void;
-    arrayName: string;
-    layout: InlineFormSetLayout;
-} | null;
-export declare function useRegisterInlineField(def: InlineFieldDefinition): void;
-//# sourceMappingURL=InlineFormContext.d.ts.map

package/dist/src/crud/context/InlineFormContext.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"InlineFormContext.d.ts","sourceRoot":"","sources":["../../../../src/crud/context/InlineFormContext.tsx"],"names":[],"mappings":"AAAA,OAAO,EAOL,KAAK,SAAS,EACf,MAAM,OAAO,CAAC;AACf,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,UAAU,CAAC;AAEtD,MAAM,MAAM,mBAAmB,GAAG,SAAS,GAAG,SAAS,CAAC;AAWxD,wBAAgB,qBAAqB,CAAC,EACpC,QAAQ,EACR,SAAS,EACT,MAAkB,GACnB,EAAE;IACD,QAAQ,EAAE,SAAS,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,mBAAmB,CAAC;CAC9B,2CAyBA;AAED,wBAAgB,uBAAuB;;mBA3CtB,CAAC,GAAG,EAAE,qBAAqB,KAAK,MAAM,IAAI;eAC9C,MAAM;YACT,mBAAmB;SA8C5B;AAED,wBAAgB,sBAAsB,CAAC,GAAG,EAAE,qBAAqB,QAMhE"}

package/dist/src/crud/fields/useInlineOrFormField.d.ts

@@ -1,10 +0,0 @@
-import { ReactNode } from 'react';
-import { FieldRenderProps, FieldRules, InlineFieldOptions } from '../types';
-export declare function useInlineOrFormField(source: string, label: string | undefined, required: boolean | undefined, rules: FieldRules | undefined, renderInput: (props: FieldRenderProps) => ReactNode, inlineOptions?: InlineFieldOptions): {
-    mode: "inline";
-    element?: undefined;
-} | {
-    mode: "form";
-    element: import("react/jsx-runtime").JSX.Element;
-};
-//# sourceMappingURL=useInlineOrFormField.d.ts.map

package/dist/src/crud/fields/useInlineOrFormField.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"useInlineOrFormField.d.ts","sourceRoot":"","sources":["../../../../src/crud/fields/useInlineOrFormField.tsx"],"names":[],"mappings":"AAAA,OAAO,EAA8B,KAAK,SAAS,EAAE,MAAM,OAAO,CAAC;AAEnE,OAAO,KAAK,EACV,gBAAgB,EAChB,UAAU,EAEV,kBAAkB,EACnB,MAAM,UAAU,CAAC;AAGlB,wBAAgB,oBAAoB,CAClC,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,MAAM,GAAG,SAAS,EACzB,QAAQ,EAAE,OAAO,GAAG,SAAS,EAC7B,KAAK,EAAE,UAAU,GAAG,SAAS,EAC7B,WAAW,EAAE,CAAC,KAAK,EAAE,gBAAgB,KAAK,SAAS,EACnD,aAAa,CAAC,EAAE,kBAAkB;;;;;;EA0EnC"}

package/dist/src/crud/utils/getByPath.d.ts

@@ -1,3 +0,0 @@
-/** Read nested value from a record using dot notation, e.g. `brand.name`. */
-export declare function getByPath(record: Record<string, unknown>, path: string): unknown;
-//# sourceMappingURL=getByPath.d.ts.map

package/dist/src/crud/utils/getByPath.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"getByPath.d.ts","sourceRoot":"","sources":["../../../../src/crud/utils/getByPath.ts"],"names":[],"mappings":"AAAA,6EAA6E;AAC7E,wBAAgB,SAAS,CACvB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC/B,IAAI,EAAE,MAAM,GACX,OAAO,CAQT"}

package/dist/src/crud/utils/inlineArrayName.d.ts

@@ -1,3 +0,0 @@
-/** Shared field-array name for InlineFormSet + ResourceForm inline loading. */
-export declare function inlineArrayName(resource: string, name?: string): string;
-//# sourceMappingURL=inlineArrayName.d.ts.map

package/dist/src/crud/utils/inlineArrayName.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"inlineArrayName.d.ts","sourceRoot":"","sources":["../../../../src/crud/utils/inlineArrayName.ts"],"names":[],"mappings":"AAAA,+EAA+E;AAC/E,wBAAgB,eAAe,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,UAE9D"}

package/dist/src/crud/utils/pickBySources.d.ts

@@ -1,6 +0,0 @@
-/**
- * Build a submit payload from form values using declared field `source` paths.
- * Flat `username` → `{ username }`; nested `invoiceLine.product` → `{ invoiceLine: { product } }`.
- */
-export declare function pickBySources(values: Record<string, unknown>, sources: string[]): Record<string, unknown>;
-//# sourceMappingURL=pickBySources.d.ts.map

package/dist/src/crud/utils/pickBySources.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"pickBySources.d.ts","sourceRoot":"","sources":["../../../../src/crud/utils/pickBySources.ts"],"names":[],"mappings":"AAGA;;;GAGG;AACH,wBAAgB,aAAa,CAC3B,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC/B,OAAO,EAAE,MAAM,EAAE,GAChB,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAazB"}

package/dist/src/crud/utils/setByPath.d.ts

@@ -1,3 +0,0 @@
-/** Write a value into a record using dot notation, e.g. `invoiceLine.product`. */
-export declare function setByPath(record: Record<string, unknown>, path: string, value: unknown): void;
-//# sourceMappingURL=setByPath.d.ts.map

package/dist/src/crud/utils/setByPath.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"setByPath.d.ts","sourceRoot":"","sources":["../../../../src/crud/utils/setByPath.ts"],"names":[],"mappings":"AAAA,kFAAkF;AAClF,wBAAgB,SAAS,CACvB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC/B,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,OAAO,GACb,IAAI,CAYN"}

package/src/crud/context/FormFieldsContext.tsx

@@ -1,76 +0,0 @@
-import {
-  createContext,
-  useCallback,
-  useContext,
-  useEffect,
-  useMemo,
-  useRef,
-  type MutableRefObject,
-  type ReactNode,
-} from "react";
-import { useFormSectionSourcesOptional } from "./FormSectionContext";
-
-type FormFieldsContextValue = {
-  registerSource: (source: string) => () => void;
-  getSources: () => string[];
-};
-
-const FormFieldsContext = createContext<FormFieldsContextValue | null>(null);
-
-export function FormFieldsProvider({
-  children,
-  sourcesRef: externalSourcesRef,
-}: {
-  children: ReactNode;
-  /** Optional ref shared with submit handler outside this provider. */
-  sourcesRef?: MutableRefObject<Set<string>>;
-}) {
-  const internalSourcesRef = useRef(new Set<string>());
-  const sourcesRef = externalSourcesRef ?? internalSourcesRef;
-
-  const registerSource = useCallback(
-    (source: string) => {
-      sourcesRef.current.add(source);
-      return () => {
-        sourcesRef.current.delete(source);
-      };
-    },
-    [sourcesRef],
-  );
-
-  const getSources = useCallback(
-    () => Array.from(sourcesRef.current),
-    [sourcesRef],
-  );
-
-  const value = useMemo(
-    () => ({ registerSource, getSources }),
-    [registerSource, getSources],
-  );
-
-  return (
-    <FormFieldsContext.Provider value={value}>
-      {children}
-    </FormFieldsContext.Provider>
-  );
-}
-
-export function useFormFieldsOptional() {
-  return useContext(FormFieldsContext);
-}
-
-export function useRegisterFormSource(source: string) {
-  const ctx = useFormFieldsOptional();
-  const registerSource = ctx?.registerSource;
-  const sectionSourcesRef = useFormSectionSourcesOptional();
-
-  useEffect(() => {
-    if (!registerSource) return;
-    const unregister = registerSource(source);
-    sectionSourcesRef?.current.add(source);
-    return () => {
-      unregister();
-      sectionSourcesRef?.current.delete(source);
-    };
-  }, [registerSource, sectionSourcesRef, source]);
-}

package/src/crud/context/InlineFormContext.tsx

@@ -1,71 +0,0 @@
-import {
-  createContext,
-  useCallback,
-  useContext,
-  useEffect,
-  useMemo,
-  useState,
-  type ReactNode,
-} from "react";
-import type { InlineFieldDefinition } from "../types";
-
-export type InlineFormSetLayout = "tabular" | "stacked";
-
-type InlineFormSetMeta = {
-  registerField: (def: InlineFieldDefinition) => () => void;
-  arrayName: string;
-  layout: InlineFormSetLayout;
-};
-
-const InlineFormSetMetaContext = createContext<InlineFormSetMeta | null>(null);
-const InlineFormSetFieldsContext = createContext<InlineFieldDefinition[]>([]);
-
-export function InlineFormSetProvider({
-  children,
-  arrayName,
-  layout = "tabular",
-}: {
-  children: ReactNode;
-  arrayName: string;
-  layout?: InlineFormSetLayout;
-}) {
-  const [fields, setFields] = useState<InlineFieldDefinition[]>([]);
-
-  const registerField = useCallback((def: InlineFieldDefinition) => {
-    setFields((prev) => {
-      if (prev.some((f) => f.key === def.key)) return prev;
-      return [...prev, def];
-    });
-    return () => {
-      setFields((prev) => prev.filter((f) => f.key !== def.key));
-    };
-  }, []);
-
-  const meta = useMemo(
-    (): InlineFormSetMeta => ({ arrayName, registerField, layout }),
-    [arrayName, registerField, layout],
-  );
-
-  return (
-    <InlineFormSetMetaContext.Provider value={meta}>
-      <InlineFormSetFieldsContext.Provider value={fields}>
-        {children}
-      </InlineFormSetFieldsContext.Provider>
-    </InlineFormSetMetaContext.Provider>
-  );
-}
-
-export function useInlineFormSetContext() {
-  const meta = useContext(InlineFormSetMetaContext);
-  const fields = useContext(InlineFormSetFieldsContext);
-  if (!meta) return null;
-  return { ...meta, fields };
-}
-
-export function useRegisterInlineField(def: InlineFieldDefinition) {
-  const registerField = useContext(InlineFormSetMetaContext)?.registerField;
-  useEffect(() => {
-    if (!registerField) return;
-    return registerField(def);
-  }, [registerField, def]);
-}

package/src/crud/fields/useInlineOrFormField.tsx

@@ -1,91 +0,0 @@
-import { useEffect, useMemo, useRef, type ReactNode } from "react";
-import { useInlineFormSetContext } from "../context/InlineFormContext";
-import type {
-  FieldRenderProps,
-  FieldRules,
-  InlineFieldDefinition,
-  InlineFieldOptions,
-} from "../types";
-import { FieldWrapper, InlineFieldWrapper } from "./FieldWrapper";
-
-export function useInlineOrFormField(
-  source: string,
-  label: string | undefined,
-  required: boolean | undefined,
-  rules: FieldRules | undefined,
-  renderInput: (props: FieldRenderProps) => ReactNode,
-  inlineOptions?: InlineFieldOptions,
-) {
-  const inlineCtx = useInlineFormSetContext();
-  const registerField = inlineCtx?.registerField;
-  const isInline = registerField != null;
-  const renderInputRef = useRef(renderInput);
-  renderInputRef.current = renderInput;
-
-  const inlineDef = useMemo((): InlineFieldDefinition | null => {
-    if (!registerField) return null;
-    return {
-      key: source,
-      source,
-      label,
-      width: inlineOptions?.width,
-      minWidth: inlineOptions?.minWidth,
-      render: ({ name, index }) => (
-        <InlineFieldWrapper
-          name={name}
-          label={label}
-          required={required}
-          rules={rules}
-          hideLabel={inlineCtx?.layout !== "stacked"}
-        >
-          {({ value, onChange, onBlur }) =>
-            renderInputRef.current({
-              value,
-              onChange,
-              onBlur,
-              name,
-              index,
-            })
-          }
-        </InlineFieldWrapper>
-      ),
-    };
-  }, [
-    registerField,
-    source,
-    label,
-    required,
-    rules,
-    inlineCtx?.layout,
-    inlineOptions?.width,
-    inlineOptions?.minWidth,
-  ]);
-
-  const inlineDefRef = useRef(inlineDef);
-  inlineDefRef.current = inlineDef;
-
-  useEffect(() => {
-    if (!registerField) return;
-    const def = inlineDefRef.current;
-    if (!def) return;
-    return registerField(def);
-  }, [registerField, source]);
-
-  if (isInline) return { mode: "inline" as const };
-
-  return {
-    mode: "form" as const,
-    element: (
-      <FieldWrapper
-        source={source}
-        label={label}
-        required={required}
-        rules={rules}
-      >
-        {({ value, onChange, onBlur, disabled }) =>
-          renderInput({ value, onChange, onBlur, disabled })
-        }
-      </FieldWrapper>
-    ),
-  };
-}

package/src/crud/utils/inlineArrayName.ts

@@ -1,4 +0,0 @@
-/** Shared field-array name for InlineFormSet + ResourceForm inline loading. */
-export function inlineArrayName(resource: string, name?: string) {
-  return name ?? `__inline_${resource.replace(/[^a-z0-9]/gi, "_")}`;
-}

package/src/crud/utils/pickBySources.ts

@@ -1,24 +0,0 @@
-import { getByPath } from "./getByPath";
-import { setByPath } from "./setByPath";
-
-/**
- * Build a submit payload from form values using declared field `source` paths.
- * Flat `username` → `{ username }`; nested `invoiceLine.product` → `{ invoiceLine: { product } }`.
- */
-export function pickBySources(
-  values: Record<string, unknown>,
-  sources: string[],
-): Record<string, unknown> {
-  if (sources.length === 0) {
-    return { ...values };
-  }
-
-  const result: Record<string, unknown> = {};
-  for (const source of sources) {
-    const value = getByPath(values, source);
-    if (value !== undefined) {
-      setByPath(result, source, value);
-    }
-  }
-  return result;
-}