ding-react-admin 1.0.0

package/dist/src/data/dataProviderTypes.d.ts

@@ -0,0 +1,67 @@
+/** Resource primary key as accepted by `DataProvider` methods. */
+export type Identifier = string | number;
+export type SortOrder = "ASC" | "DESC";
+export type SortSpec = {
+    field: string;
+    order: SortOrder;
+};
+export type PaginationParams = {
+    page: number;
+    perPage: number;
+};
+export type GetListParams = {
+    pagination?: PaginationParams;
+    /** Single or multi-column sort. */
+    sort?: SortSpec | SortSpec[];
+    /** Filter values; arrays mean "match any of" for that field. */
+    filter?: Record<string, unknown>;
+};
+export type GetListResult<RecordType extends Record<string, unknown>> = {
+    data: RecordType[];
+    total: number;
+};
+export type GetOneResult<RecordType extends Record<string, unknown>> = {
+    data: RecordType;
+};
+export type CreateResult<RecordType extends Record<string, unknown>> = {
+    data: RecordType;
+};
+export type UpdateParams<RecordType extends Record<string, unknown>> = {
+    id: Identifier;
+    data: Partial<RecordType>;
+};
+export type UpdateResult<RecordType extends Record<string, unknown>> = {
+    data: RecordType;
+};
+export type DeleteResult<RecordType extends Record<string, unknown>> = {
+    data: RecordType | null;
+};
+export type FormMutation = "create" | "update";
+export type ParseFormErrorContext = {
+    resource: string;
+    mutation: FormMutation;
+    /** Set when saving an inline row — prefix field paths for that row. */
+    inlineArrayName?: string;
+    rowIndex?: number;
+};
+/** Field paths match react-hook-form `name` (form `source` or inline `arrayName.index.source`). */
+export type FormValidationErrors = {
+    fields?: Record<string, string | string[]>;
+    /** Errors not tied to a single field (e.g. non_field_errors). */
+    global?: string | string[];
+};
+export type ParseFormError = (error: unknown, context: ParseFormErrorContext) => FormValidationErrors | null | undefined;
+/**
+ * Small, framework-agnostic data layer (react-admin–style names).
+ * Implement with REST, GraphQL, or an in-memory mock.
+ */
+export type DataProvider<RecordType extends Record<string, unknown> = Record<string, unknown>> = {
+    getList: (resource: string, params: GetListParams) => Promise<GetListResult<RecordType>>;
+    getOne: (resource: string, id: Identifier) => Promise<GetOneResult<RecordType>>;
+    create: (resource: string, data: Partial<RecordType>) => Promise<CreateResult<RecordType>>;
+    update: (resource: string, params: UpdateParams<RecordType>) => Promise<UpdateResult<RecordType>>;
+    delete: (resource: string, id: Identifier) => Promise<DeleteResult<RecordType>>;
+    /** Map API validation errors to form field paths. Optional. */
+    parseFormError?: ParseFormError;
+};
+//# sourceMappingURL=dataProviderTypes.d.ts.map

package/dist/src/data/dataProviderTypes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dataProviderTypes.d.ts","sourceRoot":"","sources":["../../../src/data/dataProviderTypes.ts"],"names":[],"mappings":"AAAA,kEAAkE;AAClE,MAAM,MAAM,UAAU,GAAG,MAAM,GAAG,MAAM,CAAC;AAEzC,MAAM,MAAM,SAAS,GAAG,KAAK,GAAG,MAAM,CAAC;AAEvC,MAAM,MAAM,QAAQ,GAAG;IACrB,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,SAAS,CAAC;CAClB,CAAC;AAEF,MAAM,MAAM,gBAAgB,GAAG;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;CACjB,CAAC;AAEF,MAAM,MAAM,aAAa,GAAG;IAC1B,UAAU,CAAC,EAAE,gBAAgB,CAAC;IAC9B,mCAAmC;IACnC,IAAI,CAAC,EAAE,QAAQ,GAAG,QAAQ,EAAE,CAAC;IAC7B,gEAAgE;IAChE,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAClC,CAAC;AAEF,MAAM,MAAM,aAAa,CAAC,UAAU,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,IAAI;IACtE,IAAI,EAAE,UAAU,EAAE,CAAC;IACnB,KAAK,EAAE,MAAM,CAAC;CACf,CAAC;AAEF,MAAM,MAAM,YAAY,CAAC,UAAU,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,IAAI;IACrE,IAAI,EAAE,UAAU,CAAC;CAClB,CAAC;AAEF,MAAM,MAAM,YAAY,CAAC,UAAU,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,IAAI;IACrE,IAAI,EAAE,UAAU,CAAC;CAClB,CAAC;AAEF,MAAM,MAAM,YAAY,CAAC,UAAU,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,IAAI;IACrE,EAAE,EAAE,UAAU,CAAC;IACf,IAAI,EAAE,OAAO,CAAC,UAAU,CAAC,CAAC;CAC3B,CAAC;AAEF,MAAM,MAAM,YAAY,CAAC,UAAU,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,IAAI;IACrE,IAAI,EAAE,UAAU,CAAC;CAClB,CAAC;AAEF,MAAM,MAAM,YAAY,CAAC,UAAU,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,IAAI;IACrE,IAAI,EAAE,UAAU,GAAG,IAAI,CAAC;CACzB,CAAC;AAEF,MAAM,MAAM,YAAY,GAAG,QAAQ,GAAG,QAAQ,CAAC;AAE/C,MAAM,MAAM,qBAAqB,GAAG;IAClC,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,YAAY,CAAC;IACvB,uEAAuE;IACvE,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB,CAAC;AAEF,mGAAmG;AACnG,MAAM,MAAM,oBAAoB,GAAG;IACjC,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC,CAAC;IAC3C,iEAAiE;IACjE,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC;CAC5B,CAAC;AAEF,MAAM,MAAM,cAAc,GAAG,CAC3B,KAAK,EAAE,OAAO,EACd,OAAO,EAAE,qBAAqB,KAC3B,oBAAoB,GAAG,IAAI,GAAG,SAAS,CAAC;AAE7C;;;GAGG;AACH,MAAM,MAAM,YAAY,CACtB,UAAU,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,IAClE;IACF,OAAO,EAAE,CACP,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,aAAa,KAClB,OAAO,CAAC,aAAa,CAAC,UAAU,CAAC,CAAC,CAAC;IACxC,MAAM,EAAE,CACN,QAAQ,EAAE,MAAM,EAChB,EAAE,EAAE,UAAU,KACX,OAAO,CAAC,YAAY,CAAC,UAAU,CAAC,CAAC,CAAC;IACvC,MAAM,EAAE,CACN,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,OAAO,CAAC,UAAU,CAAC,KACtB,OAAO,CAAC,YAAY,CAAC,UAAU,CAAC,CAAC,CAAC;IACvC,MAAM,EAAE,CACN,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,YAAY,CAAC,UAAU,CAAC,KAC7B,OAAO,CAAC,YAAY,CAAC,UAAU,CAAC,CAAC,CAAC;IACvC,MAAM,EAAE,CACN,QAAQ,EAAE,MAAM,EAChB,EAAE,EAAE,UAAU,KACX,OAAO,CAAC,YAAY,CAAC,UAAU,CAAC,CAAC,CAAC;IACvC,+DAA+D;IAC/D,cAAc,CAAC,EAAE,cAAc,CAAC;CACjC,CAAC"}

package/dist/src/data/dataUtils.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=dataUtils.test.d.ts.map

package/dist/src/data/dataUtils.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dataUtils.test.d.ts","sourceRoot":"","sources":["../../../src/data/dataUtils.test.ts"],"names":[],"mappings":""}

package/dist/src/data/inMemoryList.d.ts

@@ -0,0 +1,12 @@
+import { GetListParams, Identifier } from './dataProviderTypes';
+export declare function rowIdMatches(rowId: string | number, id: Identifier): boolean;
+export declare function getById<T extends {
+    id: string | number;
+}>(rows: T[], id: Identifier): T;
+export declare function filterRows<T extends Record<string, unknown>>(rows: T[], filter?: Record<string, unknown>): T[];
+/** Apply CRUD list filters, sort, and pagination to an in-memory row array. */
+export declare function applyInMemoryListParams<T extends Record<string, unknown>>(rows: T[], params: GetListParams): {
+    data: T[];
+    total: number;
+};
+//# sourceMappingURL=inMemoryList.d.ts.map

package/dist/src/data/inMemoryList.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"inMemoryList.d.ts","sourceRoot":"","sources":["../../../src/data/inMemoryList.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,UAAU,EAAY,MAAM,qBAAqB,CAAC;AAE/E,wBAAgB,YAAY,CAC1B,KAAK,EAAE,MAAM,GAAG,MAAM,EACtB,EAAE,EAAE,UAAU,GACb,OAAO,CAET;AAED,wBAAgB,OAAO,CAAC,CAAC,SAAS;IAAE,EAAE,EAAE,MAAM,GAAG,MAAM,CAAA;CAAE,EACvD,IAAI,EAAE,CAAC,EAAE,EACT,EAAE,EAAE,UAAU,GACb,CAAC,CAIH;AA6CD,wBAAgB,UAAU,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC1D,IAAI,EAAE,CAAC,EAAE,EACT,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC/B,CAAC,EAAE,CAKL;AAUD,+EAA+E;AAC/E,wBAAgB,uBAAuB,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACvE,IAAI,EAAE,CAAC,EAAE,EACT,MAAM,EAAE,aAAa,GACpB;IAAE,IAAI,EAAE,CAAC,EAAE,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAa9B"}

package/dist/src/data/parseFormErrorHelpers.d.ts

@@ -0,0 +1,35 @@
+import { FormValidationErrors, ParseFormErrorContext } from './dataProviderTypes';
+export declare function asStringMessages(value: unknown): string[];
+/** Read JSON from `throw { body }` or axios-style `{ response: { data } }`. */
+export declare function getErrorBody(error: unknown): Record<string, unknown> | null;
+export declare function applyInlineFieldPaths(fields: Record<string, string | string[]>, ctx: ParseFormErrorContext): Record<string, string | string[]>;
+export declare function finalizeFormErrors(fields: Record<string, string | string[]>, global: string[], ctx: ParseFormErrorContext): FormValidationErrors;
+/**
+ * Django REST framework validation body:
+ * `{ "email": ["Invalid"], "non_field_errors": ["…"] }`
+ */
+export declare function parseDjangoDRFFormErrors(error: unknown, ctx: ParseFormErrorContext): FormValidationErrors | null;
+export type DotNetFormErrorOptions = {
+    /** Map API property names to form `source` paths. */
+    fieldMap?: Record<string, string>;
+    /** `Email` → `email`. Default true. */
+    camelCase?: boolean;
+    /** Include `title` / `message` in global toasts. Default false (often generic). */
+    includeSummary?: boolean;
+};
+/**
+ * ASP.NET Core `ValidationProblemDetails`:
+ * `{ "errors": { "Email": ["The Email field is required."] } }`
+ */
+export declare function parseDotNetFormErrors(error: unknown, ctx: ParseFormErrorContext, options?: DotNetFormErrorOptions): FormValidationErrors | null;
+export type NodeFormErrorOptions = {
+    fieldMap?: Record<string, string>;
+};
+/**
+ * Common Node / Express shapes:
+ * - `{ errors: { email: ["Invalid"] } }`
+ * - `{ errors: [{ path: "email", msg: "Invalid" }] }` (express-validator)
+ * - `{ details: [{ message: "…", path: ["email"] }] }` (Joi)
+ */
+export declare function parseNodeFormErrors(error: unknown, ctx: ParseFormErrorContext, options?: NodeFormErrorOptions): FormValidationErrors | null;
+//# sourceMappingURL=parseFormErrorHelpers.d.ts.map

package/dist/src/data/parseFormErrorHelpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parseFormErrorHelpers.d.ts","sourceRoot":"","sources":["../../../src/data/parseFormErrorHelpers.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,oBAAoB,EACpB,qBAAqB,EACtB,MAAM,qBAAqB,CAAC;AAE7B,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,EAAE,CAOzD;AAMD,+EAA+E;AAC/E,wBAAgB,YAAY,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAc3E;AAED,wBAAgB,qBAAqB,CACnC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC,EACzC,GAAG,EAAE,qBAAqB,GACzB,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC,CAQnC;AAED,wBAAgB,kBAAkB,CAChC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC,EACzC,MAAM,EAAE,MAAM,EAAE,EAChB,GAAG,EAAE,qBAAqB,GACzB,oBAAoB,CAMtB;AAID;;;GAGG;AACH,wBAAgB,wBAAwB,CACtC,KAAK,EAAE,OAAO,EACd,GAAG,EAAE,qBAAqB,GACzB,oBAAoB,GAAG,IAAI,CAkB7B;AAED,MAAM,MAAM,sBAAsB,GAAG;IACnC,qDAAqD;IACrD,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAClC,uCAAuC;IACvC,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,mFAAmF;IACnF,cAAc,CAAC,EAAE,OAAO,CAAC;CAC1B,CAAC;AAEF;;;GAGG;AACH,wBAAgB,qBAAqB,CACnC,KAAK,EAAE,OAAO,EACd,GAAG,EAAE,qBAAqB,EAC1B,OAAO,CAAC,EAAE,sBAAsB,GAC/B,oBAAoB,GAAG,IAAI,CA0B7B;AAED,MAAM,MAAM,oBAAoB,GAAG;IACjC,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACnC,CAAC;AAEF;;;;;GAKG;AACH,wBAAgB,mBAAmB,CACjC,KAAK,EAAE,OAAO,EACd,GAAG,EAAE,qBAAqB,EAC1B,OAAO,CAAC,EAAE,oBAAoB,GAC7B,oBAAoB,GAAG,IAAI,CAyD7B"}

package/dist/src/data/parseFormErrorHelpers.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=parseFormErrorHelpers.test.d.ts.map

package/dist/src/data/parseFormErrorHelpers.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parseFormErrorHelpers.test.d.ts","sourceRoot":"","sources":["../../../src/data/parseFormErrorHelpers.test.ts"],"names":[],"mappings":""}

package/dist/src/data/resourceHandlers.d.ts

@@ -0,0 +1,33 @@
+import { PermissionsChecker } from '../context/PermissionsProvider';
+import { ResourcePermissions } from '../permissions/resourcePermissions';
+import { CreateResult, DataProvider, DeleteResult, GetListParams, GetListResult, GetOneResult, Identifier, ParseFormError, UpdateParams, UpdateResult } from './dataProviderTypes';
+export type ResourceAction = "list" | "read" | "add" | "change" | "delete";
+/** @deprecated Use per-resource `permissions` with `can` in combineResourceHandlers options. */
+export type ResourceGuard = (resource: string, action: ResourceAction) => void;
+/** CRUD handlers for a single resource (no resource name on each method). */
+export type ResourceHandlers<RecordType extends Record<string, unknown> = Record<string, unknown>> = {
+    getList: (params: GetListParams) => Promise<GetListResult<RecordType>>;
+    getOne: (id: Identifier) => Promise<GetOneResult<RecordType>>;
+    create: (data: Partial<RecordType>) => Promise<CreateResult<RecordType>>;
+    update: (params: UpdateParams<RecordType>) => Promise<UpdateResult<RecordType>>;
+    delete: (id: Identifier) => Promise<DeleteResult<RecordType>>;
+};
+export type ResourceHandlerEntry = ResourceHandlers | {
+    handlers: ResourceHandlers;
+    permissions?: ResourcePermissions;
+};
+export type ResourceHandlerMap = Record<string, ResourceHandlerEntry>;
+export type CombineResourceHandlersOptions = {
+    /** Permission checker from PermissionsProvider wiring. */
+    can?: PermissionsChecker;
+    /** @deprecated Use per-resource `permissions` entries instead. */
+    guard?: ResourceGuard;
+    /** Wired to `ResourceForm` / `ResourceFormModal` save error handling. */
+    parseFormError?: ParseFormError;
+};
+/**
+ * Compose per-entity handlers into a react-admin-style `DataProvider`.
+ * Map an OpenAPI / tRPC / REST client in each entity module, then register here.
+ */
+export declare function combineResourceHandlers(handlers: ResourceHandlerMap, options?: CombineResourceHandlersOptions): DataProvider;
+//# sourceMappingURL=resourceHandlers.d.ts.map

package/dist/src/data/resourceHandlers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resourceHandlers.d.ts","sourceRoot":"","sources":["../../../src/data/resourceHandlers.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,gCAAgC,CAAC;AACzE,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,oCAAoC,CAAC;AAE9E,OAAO,KAAK,EACV,YAAY,EACZ,YAAY,EACZ,YAAY,EACZ,aAAa,EACb,aAAa,EACb,YAAY,EACZ,UAAU,EACV,cAAc,EACd,YAAY,EACZ,YAAY,EACb,MAAM,qBAAqB,CAAC;AAE7B,MAAM,MAAM,cAAc,GAAG,MAAM,GAAG,MAAM,GAAG,KAAK,GAAG,QAAQ,GAAG,QAAQ,CAAC;AAE3E,gGAAgG;AAChG,MAAM,MAAM,aAAa,GAAG,CAC1B,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,cAAc,KACnB,IAAI,CAAC;AAEV,6EAA6E;AAC7E,MAAM,MAAM,gBAAgB,CAC1B,UAAU,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,IAClE;IACF,OAAO,EAAE,CAAC,MAAM,EAAE,aAAa,KAAK,OAAO,CAAC,aAAa,CAAC,UAAU,CAAC,CAAC,CAAC;IACvE,MAAM,EAAE,CAAC,EAAE,EAAE,UAAU,KAAK,OAAO,CAAC,YAAY,CAAC,UAAU,CAAC,CAAC,CAAC;IAC9D,MAAM,EAAE,CAAC,IAAI,EAAE,OAAO,CAAC,UAAU,CAAC,KAAK,OAAO,CAAC,YAAY,CAAC,UAAU,CAAC,CAAC,CAAC;IACzE,MAAM,EAAE,CACN,MAAM,EAAE,YAAY,CAAC,UAAU,CAAC,KAC7B,OAAO,CAAC,YAAY,CAAC,UAAU,CAAC,CAAC,CAAC;IACvC,MAAM,EAAE,CAAC,EAAE,EAAE,UAAU,KAAK,OAAO,CAAC,YAAY,CAAC,UAAU,CAAC,CAAC,CAAC;CAC/D,CAAC;AAEF,MAAM,MAAM,oBAAoB,GAC5B,gBAAgB,GAChB;IACE,QAAQ,EAAE,gBAAgB,CAAC;IAC3B,WAAW,CAAC,EAAE,mBAAmB,CAAC;CACnC,CAAC;AAEN,MAAM,MAAM,kBAAkB,GAAG,MAAM,CAAC,MAAM,EAAE,oBAAoB,CAAC,CAAC;AAEtE,MAAM,MAAM,8BAA8B,GAAG;IAC3C,0DAA0D;IAC1D,GAAG,CAAC,EAAE,kBAAkB,CAAC;IACzB,kEAAkE;IAClE,KAAK,CAAC,EAAE,aAAa,CAAC;IACtB,yEAAyE;IACzE,cAAc,CAAC,EAAE,cAAc,CAAC;CACjC,CAAC;AAqBF;;;GAGG;AACH,wBAAgB,uBAAuB,CACrC,QAAQ,EAAE,kBAAkB,EAC5B,OAAO,CAAC,EAAE,8BAA8B,GACvC,YAAY,CA0Cd"}

package/dist/src/data/sortHelpers.d.ts

@@ -0,0 +1,17 @@
+import { SortSpec } from './dataProviderTypes';
+/**
+ * Django REST Framework `ordering` query param.
+ * ASC → `username`; DESC → `-username`; multi → `username,-date_joined`.
+ */
+export declare function toDjangoRestOrdering(sort?: SortSpec | SortSpec[]): string | undefined;
+/**
+ * OData `$orderby` query param.
+ * ASC → `username asc`; DESC → `username desc`.
+ */
+export declare function toODataOrderBy(sort?: SortSpec | SortSpec[]): string | undefined;
+/**
+ * Common JSON:API `sort` query param.
+ * ASC → `username`; DESC → `-username`.
+ */
+export declare function toJsonApiSort(sort?: SortSpec | SortSpec[]): string | undefined;
+//# sourceMappingURL=sortHelpers.d.ts.map

package/dist/src/data/sortHelpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sortHelpers.d.ts","sourceRoot":"","sources":["../../../src/data/sortHelpers.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAOpD;;;GAGG;AACH,wBAAgB,oBAAoB,CAClC,IAAI,CAAC,EAAE,QAAQ,GAAG,QAAQ,EAAE,GAC3B,MAAM,GAAG,SAAS,CAMpB;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAC5B,IAAI,CAAC,EAAE,QAAQ,GAAG,QAAQ,EAAE,GAC3B,MAAM,GAAG,SAAS,CAMpB;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAC3B,IAAI,CAAC,EAAE,QAAQ,GAAG,QAAQ,EAAE,GAC3B,MAAM,GAAG,SAAS,CAMpB"}

package/dist/src/index.d.ts

@@ -0,0 +1,31 @@
+export { AdminApp } from './app/AdminApp';
+export { AdminLayout } from './layouts/AdminLayout';
+export { AuthProvider, createSessionStorageAuthAdapter, useAuth, type AuthProviderProps, } from './context/AuthProvider';
+export { DataProvider, useDataProvider, type DataProviderProps, } from './context/DataProvider';
+export { PermissionsProvider, createPermissionsChecker, useCan, usePermissions, type PermissionsProviderProps, } from './context/PermissionsProvider';
+export { AppThemeProvider, useThemeMode, } from './context/AppThemeProvider';
+export type { CreateResult, DataProvider as DataProviderContract, DeleteResult, GetListParams, GetListResult, GetOneResult, Identifier, PaginationParams, SortOrder, SortSpec, UpdateParams, UpdateResult, FormMutation, FormValidationErrors, ParseFormError, ParseFormErrorContext, } from './data/dataProviderTypes';
+export { combineResourceHandlers } from './data/resourceHandlers';
+export { parseDjangoDRFFormErrors, parseDotNetFormErrors, parseNodeFormErrors, getErrorBody, applyInlineFieldPaths, asStringMessages, finalizeFormErrors, } from './data/parseFormErrorHelpers';
+export type { DotNetFormErrorOptions, NodeFormErrorOptions, } from './data/parseFormErrorHelpers';
+export { createMemoryResourceHandlers } from './data/createMemoryResourceHandlers';
+export { createRestResourceHandlers } from './data/createRestResourceHandlers';
+export type { RestResourceHandlersConfig } from './data/createRestResourceHandlers';
+export { toDjangoRestOrdering, toODataOrderBy, toJsonApiSort, } from './data/sortHelpers';
+export { applyInMemoryListParams, filterRows, getById as getRowById, } from './data/inMemoryList';
+export type { CombineResourceHandlersOptions, ResourceAction, ResourceGuard, ResourceHandlerEntry, ResourceHandlerMap, ResourceHandlers, } from './data/resourceHandlers';
+export type { ResourcePermissions } from './permissions/resourcePermissions';
+export { filterNavByPermission } from './permissions/resourcePermissions';
+export type { MemoryResourceHandlersConfig } from './data/createMemoryResourceHandlers';
+export type { PermissionsChecker } from './context/PermissionsProvider';
+export { LoginPage } from './pages/LoginPage';
+export { PlaceholderPage } from './pages/PlaceholderPage';
+export { AuthPageLayout } from './layouts/AuthPageLayout';
+export { AuthAlternateLink, DensitySwitch, ThemeSwitch, ThemeToolbar, } from './components';
+export { Guard, GuestOnly, Protected, RequirePermission } from './router/guards';
+export { createAdminRouter } from './router/createAdminRouter';
+export { deriveAuthPaths, getRouteAccess, partitionAdminRoutes, } from './router/routeAccess';
+export type { AdminAppProps, AdminLayoutProps, AdminRouteChild, AppThemeProviderProps, AuthAdapter, LoginCredentials, AuthRedirects, CreateAdminRouterOptions, AuthAlternateLinkProps, AuthPageLayoutProps, LoginPageProps, NavItem, RouteAccess, ThemeDensity, ThemeMode, } from './types';
+export { ResourceList, FilterBar, ResourceForm, ResourceFormModal, InlineFormSet, FormTabs, FormTab, FormSteps, FormStep, saveInlineRows, loadInlineRows, TextField, NumberField, BooleanField, DateField, SelectField, PasswordField, ReferenceField, ReferenceManyField, TextColumn, NumberColumn, BooleanColumn, DateColumn, ReferenceColumn, ReferenceManyColumn, CustomColumn, TextFilter, NumberFilter, BooleanFilter, DateFilter, SelectFilter, ReferenceFilter, ReferenceManyFilter, useListQueryState, useChoices, getByPath, pickBySources, inlineArrayName, useResourceListContext, useRegisterFormSource, } from './crud';
+export type { ResourceFormProps, ResourceFormInlineConfig, ResourceFormModalProps, InlineFormSetProps, FormTabsProps, FormTabProps, FormStepsProps, FormStepProps, SaveInlineOptions, InlineFormSetLayout, ResourceListProps, BaseSourceProps, ChoiceOption, ChoicesLoader, ReferenceProps, DisplayProps, EditMode, FieldRules, ResourceListBuiltInActions, ResourceListBulkAction, ResourceListBulkActionHelpers, ResourceListRowActionsHelpers, ListQueryState, ListQueryActions, } from './crud';
+//# sourceMappingURL=index.d.ts.map

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

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

package/dist/src/layouts/AdminLayout.d.ts

@@ -0,0 +1,3 @@
+import { AdminLayoutProps } from '../types';
+export declare function AdminLayout({ navItems, brand, collapsedBrand, mobileDrawerTitle, headerExtras, userMenuItems, onUserMenuClick, loginPath, siderCollapsedStorageKey, }: AdminLayoutProps): import("react/jsx-runtime").JSX.Element;
+//# sourceMappingURL=AdminLayout.d.ts.map

package/dist/src/layouts/AdminLayout.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AdminLayout.d.ts","sourceRoot":"","sources":["../../../src/layouts/AdminLayout.tsx"],"names":[],"mappings":"AAwBA,OAAO,KAAK,EAAE,gBAAgB,EAAW,MAAM,UAAU,CAAC;AAyG1D,wBAAgB,WAAW,CAAC,EAC1B,QAAQ,EACR,KAAe,EACf,cAAoB,EACpB,iBAAiB,EACjB,YAAY,EACZ,aAAa,EACb,eAAe,EACf,SAAoB,EACpB,wBAA4C,GAC7C,EAAE,gBAAgB,2CAiPlB"}

package/dist/src/layouts/AuthPageLayout.d.ts

@@ -0,0 +1,11 @@
+import { ReactNode } from 'react';
+export type AuthPageLayoutProps = {
+    children: ReactNode;
+    /** Brand mark centered above the card. */
+    brand?: ReactNode;
+    /** Row below the card (e.g. link to register or login). */
+    footer?: ReactNode;
+    showThemeToolbar?: boolean;
+};
+export declare function AuthPageLayout({ children, brand, footer, showThemeToolbar, }: AuthPageLayoutProps): import("react/jsx-runtime").JSX.Element;
+//# sourceMappingURL=AuthPageLayout.d.ts.map

package/dist/src/layouts/AuthPageLayout.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AuthPageLayout.d.ts","sourceRoot":"","sources":["../../../src/layouts/AuthPageLayout.tsx"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAGvC,MAAM,MAAM,mBAAmB,GAAG;IAChC,QAAQ,EAAE,SAAS,CAAC;IACpB,0CAA0C;IAC1C,KAAK,CAAC,EAAE,SAAS,CAAC;IAClB,2DAA2D;IAC3D,MAAM,CAAC,EAAE,SAAS,CAAC;IACnB,gBAAgB,CAAC,EAAE,OAAO,CAAC;CAC5B,CAAC;AAEF,wBAAgB,cAAc,CAAC,EAC7B,QAAQ,EACR,KAAK,EACL,MAAM,EACN,gBAAuB,GACxB,EAAE,mBAAmB,2CA8DrB"}

package/dist/src/pages/LoginPage.d.ts

@@ -0,0 +1,3 @@
+import { LoginPageProps } from '../types';
+export declare function LoginPage({ title, description, logo, brand, extraFields, showThemeToolbar, afterLoginPath, alternateAuth, footer, }: LoginPageProps): import("react/jsx-runtime").JSX.Element;
+//# sourceMappingURL=LoginPage.d.ts.map

package/dist/src/pages/LoginPage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"LoginPage.d.ts","sourceRoot":"","sources":["../../../src/pages/LoginPage.tsx"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AAE/C,wBAAgB,SAAS,CAAC,EACxB,KAAiB,EACjB,WAA0D,EAC1D,IAAI,EACJ,KAAK,EACL,WAAW,EACX,gBAAuB,EACvB,cAAoB,EACpB,aAAa,EACb,MAAM,GACP,EAAE,cAAc,2CA8DhB"}

package/dist/src/pages/PlaceholderPage.d.ts

@@ -0,0 +1,4 @@
+export declare function PlaceholderPage({ title }: {
+    title: string;
+}): import("react/jsx-runtime").JSX.Element;
+//# sourceMappingURL=PlaceholderPage.d.ts.map

package/dist/src/pages/PlaceholderPage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"PlaceholderPage.d.ts","sourceRoot":"","sources":["../../../src/pages/PlaceholderPage.tsx"],"names":[],"mappings":"AAEA,wBAAgB,eAAe,CAAC,EAAE,KAAK,EAAE,EAAE;IAAE,KAAK,EAAE,MAAM,CAAA;CAAE,2CAM3D"}

package/dist/src/permissions/resourcePermissions.d.ts

@@ -0,0 +1,22 @@
+import { PermissionsChecker } from '../context/PermissionsProvider';
+/** Opaque permission strings per CRUD action (values come from your backend). */
+export type ResourcePermissions = {
+    /** List page, nav, route guard */
+    list?: string;
+    /** getOne — falls back to `list` when omitted */
+    read?: string;
+    /** New button, create modal, POST */
+    add?: string;
+    /** Edit / Quick edit, PATCH/PUT */
+    change?: string;
+    /** Row delete, bulk delete */
+    delete?: string;
+};
+export type ResourcePermissionSlot = keyof ResourcePermissions;
+/** When `permissions` is omitted, allow. When provided, missing slot → deny. */
+export declare function checkResourcePermission(can: PermissionsChecker, permissions: ResourcePermissions | undefined, slot: ResourcePermissionSlot): boolean;
+export declare function filterNavByPermission<T extends {
+    permission?: string;
+    children?: T[];
+}>(items: T[], can: PermissionsChecker): T[];
+//# sourceMappingURL=resourcePermissions.d.ts.map

package/dist/src/permissions/resourcePermissions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resourcePermissions.d.ts","sourceRoot":"","sources":["../../../src/permissions/resourcePermissions.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,gCAAgC,CAAC;AAEzE,iFAAiF;AACjF,MAAM,MAAM,mBAAmB,GAAG;IAChC,kCAAkC;IAClC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,iDAAiD;IACjD,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,qCAAqC;IACrC,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,mCAAmC;IACnC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,8BAA8B;IAC9B,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB,CAAC;AAEF,MAAM,MAAM,sBAAsB,GAAG,MAAM,mBAAmB,CAAC;AAE/D,gFAAgF;AAChF,wBAAgB,uBAAuB,CACrC,GAAG,EAAE,kBAAkB,EACvB,WAAW,EAAE,mBAAmB,GAAG,SAAS,EAC5C,IAAI,EAAE,sBAAsB,GAC3B,OAAO,CAMT;AAED,wBAAgB,qBAAqB,CAAC,CAAC,SAAS;IAAE,UAAU,CAAC,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,CAAC,EAAE,CAAA;CAAE,EACrF,KAAK,EAAE,CAAC,EAAE,EACV,GAAG,EAAE,kBAAkB,GACtB,CAAC,EAAE,CAYL"}

package/dist/src/router/createAdminRouter.d.ts

@@ -0,0 +1,3 @@
+import { CreateAdminRouterOptions } from '../types';
+export declare function createAdminRouter({ navItems, children, layoutProps, redirects, }: CreateAdminRouterOptions): import('react-router').DataRouter;
+//# sourceMappingURL=createAdminRouter.d.ts.map

package/dist/src/router/createAdminRouter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"createAdminRouter.d.ts","sourceRoot":"","sources":["../../../src/router/createAdminRouter.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,UAAU,CAAC;AASzD,wBAAgB,iBAAiB,CAAC,EAChC,QAAQ,EACR,QAAQ,EACR,WAAW,EACX,SAAS,GACV,EAAE,wBAAwB,qCA+C1B"}

package/dist/src/router/guards.d.ts

@@ -0,0 +1,20 @@
+import { ReactElement } from 'react';
+export declare function Guard({ when, redirect, children, }: {
+    when: boolean;
+    redirect: string;
+    children: ReactElement;
+}): import("react/jsx-runtime").JSX.Element;
+export declare function Protected({ children, redirectTo, }: {
+    children: ReactElement;
+    redirectTo?: string;
+}): import("react/jsx-runtime").JSX.Element;
+export declare function GuestOnly({ children, redirectTo, }: {
+    children: ReactElement;
+    redirectTo?: string;
+}): import("react/jsx-runtime").JSX.Element;
+export declare function RequirePermission({ permission, redirect, children, }: {
+    permission: string;
+    redirect: string;
+    children: ReactElement;
+}): import("react/jsx-runtime").JSX.Element;
+//# sourceMappingURL=guards.d.ts.map

package/dist/src/router/guards.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"guards.d.ts","sourceRoot":"","sources":["../../../src/router/guards.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,OAAO,CAAC;AAK1C,wBAAgB,KAAK,CAAC,EACpB,IAAI,EACJ,QAAQ,EACR,QAAQ,GACT,EAAE;IACD,IAAI,EAAE,OAAO,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,YAAY,CAAC;CACxB,2CAEA;AAED,wBAAgB,SAAS,CAAC,EACxB,QAAQ,EACR,UAAqB,GACtB,EAAE;IACD,QAAQ,EAAE,YAAY,CAAC;IACvB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB,2CAOA;AAED,wBAAgB,SAAS,CAAC,EACxB,QAAQ,EACR,UAAgB,GACjB,EAAE;IACD,QAAQ,EAAE,YAAY,CAAC;IACvB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB,2CAOA;AAED,wBAAgB,iBAAiB,CAAC,EAChC,UAAU,EACV,QAAQ,EACR,QAAQ,GACT,EAAE;IACD,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,YAAY,CAAC;CACxB,2CAOA"}

package/dist/src/router/routeAccess.d.ts

@@ -0,0 +1,21 @@
+import { RouteObject } from 'react-router-dom';
+import { AdminRouteChild, AuthRedirects, RouteAccess } from '../types';
+export declare function getRouteAccess(route: AdminRouteChild): RouteAccess;
+export declare function partitionAdminRoutes(routes: AdminRouteChild[]): {
+    guest: AdminRouteChild[];
+    public: AdminRouteChild[];
+    protected: AdminRouteChild[];
+};
+/** React Router path segment for a top-level route (`/login` → `login`). */
+export declare function toRouterSegment(path: string): string;
+export declare function toAbsolutePath(path: string): string;
+/**
+ * Resolve redirect targets from declared routes and optional overrides.
+ * Throws when protected or guest routes exist but paths cannot be determined.
+ */
+export declare function deriveAuthPaths(routes: AdminRouteChild[], redirects?: AuthRedirects): {
+    loginPath: string;
+    homePath: string;
+};
+export declare function toProtectedRouteObject(route: AdminRouteChild): RouteObject;
+//# sourceMappingURL=routeAccess.d.ts.map

package/dist/src/router/routeAccess.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"routeAccess.d.ts","sourceRoot":"","sources":["../../../src/router/routeAccess.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AACpD,OAAO,KAAK,EAAE,eAAe,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AAE5E,wBAAgB,cAAc,CAAC,KAAK,EAAE,eAAe,GAAG,WAAW,CAElE;AAED,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,eAAe,EAAE;;;;EAa7D;AAED,4EAA4E;AAC5E,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAEpD;AAED,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAEnD;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAC7B,MAAM,EAAE,eAAe,EAAE,EACzB,SAAS,CAAC,EAAE,aAAa,GACxB;IAAE,SAAS,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,CA2CzC;AAED,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,eAAe,GAAG,WAAW,CAK1E"}

package/dist/src/types.d.ts

@@ -0,0 +1,123 @@
+import { MenuProps } from 'antd';
+import { ReactElement, ReactNode } from 'react';
+export type ThemeMode = "light" | "dark" | "system";
+export type ThemeDensity = "comfortable" | "compact";
+/**
+ * Sidebar / app-hub navigation row. Maps to Ant Design `Menu` items.
+ *
+ * - **`children`** — nested submenu; parent rows should use a `path` that you **do not** navigate to as a leaf (for example `/catalog`), unless you define that route.
+ * - **`label`** — string or any React node (badges, extra markup).
+ * - **`Icon`** — optional; omit on group-only rows if you prefer text-only labels.
+ */
+export type NavItem = {
+    /** Menu item key and `navigate()` target for leaf items (pathname). Parents use this as submenu key. */
+    path: string;
+    label: ReactNode;
+    Icon?: React.ComponentType;
+    /** Hide this item when the user lacks this permission string. */
+    permission?: string;
+    children?: NavItem[];
+};
+/** Credentials passed from login forms to `AuthAdapter.login` and `useAuth().login`. */
+export type LoginCredentials = {
+    username: string;
+    password: string;
+    [key: string]: unknown;
+};
+/** Pluggable login/logout/token backend (e.g. sessionStorage, your REST API). */
+export type AuthAdapter = {
+    login: (credentials: LoginCredentials) => Promise<void>;
+    logout: () => void;
+    /** Synchronous read of session (e.g. token). Used after mount and after login/logout. */
+    getToken: () => string | null;
+};
+/** How a route participates in auth when using `AdminApp` / `createAdminRouter`. */
+export type RouteAccess = 
+/** Inside `AdminLayout`; requires a session. Default. */
+"protected"
+/** Top-level; no session required (signup, forgot-password, etc.). */
+ | "public"
+/** Top-level; only for guests (`GuestOnly`). Use for login. */
+ | "guest";
+export type AuthRedirects = {
+    /** Where unauthenticated users are sent. Required with protected routes unless a guest route is declared. */
+    unauthenticated?: string;
+    /** After login and when visiting guest routes while authenticated. Required with guest routes unless a protected route is declared. */
+    afterLogin?: string;
+};
+export type AppThemeProviderProps = {
+    children: ReactNode;
+    /** localStorage key for theme mode. Default `ding-react-admin-theme-mode`. */
+    modeStorageKey?: string;
+    /** localStorage key for density. Default `ding-react-admin-theme-density`. */
+    densityStorageKey?: string;
+};
+export type AdminLayoutProps = {
+    navItems: NavItem[];
+    /** Shown in sider header when expanded; drawer title on mobile. */
+    brand?: ReactNode;
+    /** Shown in sider header when collapsed. */
+    collapsedBrand?: ReactNode;
+    /** Optional drawer title override (defaults to `brand`). */
+    mobileDrawerTitle?: ReactNode;
+    headerExtras?: ReactNode;
+    /** Full menu items for the account dropdown. If omitted, a default “Log out” item is used. */
+    userMenuItems?: MenuProps["items"];
+    onUserMenuClick?: MenuProps["onClick"];
+    /** Where to send the user after logout. Default `/login`. */
+    loginPath?: string;
+    /** localStorage key for sider collapsed state. Default `ding-react-admin-sider-collapsed`. */
+    siderCollapsedStorageKey?: string;
+};
+export type { AuthPageLayoutProps } from './layouts/AuthPageLayout';
+export type { AuthAlternateLinkProps } from './components/AuthAlternateLink';
+export type LoginPageProps = {
+    title?: ReactNode;
+    description?: ReactNode;
+    /** @deprecated Use `brand` — shown above the card, not in the card header. */
+    logo?: ReactNode;
+    /** Brand mark centered above the card. */
+    brand?: ReactNode;
+    /** Extra form items rendered before the submit button. */
+    extraFields?: ReactNode;
+    showThemeToolbar?: boolean;
+    /** Navigate here after successful login. Default `/`. */
+    afterLoginPath?: string;
+    /** Row below the card linking to registration (or another auth flow). */
+    alternateAuth?: {
+        prompt?: string;
+        linkText: string;
+        to: string;
+    };
+    /** Custom footer below the card; overrides `alternateAuth` when set. */
+    footer?: ReactNode;
+};
+type AdminRouteChildBase = {
+    element: ReactElement;
+    /** Default `protected`. See [docs/routing.md](../docs/routing.md). */
+    access?: RouteAccess;
+};
+/** Route list for `AdminApp` / `createAdminRouter`. */
+export type AdminRouteChild = (AdminRouteChildBase & {
+    index: true;
+    path?: undefined;
+}) | (AdminRouteChildBase & {
+    path: string;
+    index?: undefined;
+});
+export type CreateAdminRouterOptions = {
+    navItems: NavItem[];
+    /** App routes; split by `access` into guest, public, and protected segments. */
+    children: AdminRouteChild[];
+    layoutProps?: Partial<AdminLayoutProps>;
+    redirects?: AuthRedirects;
+};
+export type AdminAppProps = {
+    navItems: NavItem[];
+    routes: AdminRouteChild[];
+    /** Override login / post-login redirect paths when they cannot be inferred from routes. */
+    authRedirects?: AuthRedirects;
+    layoutProps?: Partial<AdminLayoutProps>;
+    theme?: Partial<Pick<AppThemeProviderProps, "modeStorageKey" | "densityStorageKey">>;
+};
+//# sourceMappingURL=types.d.ts.map

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

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

package/package.json

@@ -0,0 +1,58 @@
+{
+  "name": "ding-react-admin",
+  "version": "1.0.0",
+  "type": "module",
+  "license": "MIT",
+  "description": "Composable admin shell (Ant Design + React Router): quick-start AdminApp or build your own layout.",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/Muhammadinaam/ding-react-admin.git"
+  },
+  "main": "./dist/index.js",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "src"
+  ],
+  "scripts": {
+    "build": "vite build && node -e \"require('fs').writeFileSync('dist/index.d.ts','export * from \\\"./src/index\\\";\\n')\"",
+    "dev:example": "yarn --cwd examples/playground dev",
+    "build:example": "yarn --cwd examples/playground build",
+    "build:example:gh-pages": "yarn --cwd examples/playground build:gh-pages",
+    "test": "vitest run",
+    "prepublishOnly": "yarn build"
+  },
+  "peerDependencies": {
+    "@ant-design/icons": ">=6",
+    "antd": ">=6",
+    "dayjs": ">=1",
+    "react": ">=18",
+    "react-dom": ">=18",
+    "react-hook-form": ">=7",
+    "react-router-dom": ">=6"
+  },
+  "devDependencies": {
+    "@ant-design/icons": "^6.0.0",
+    "@types/react": "^19.2.14",
+    "@types/react-dom": "^19.2.3",
+    "@vitejs/plugin-react": "^6.0.1",
+    "antd": "^6.0.0",
+    "dayjs": "^1.11.13",
+    "react": "^19.2.5",
+    "react-dom": "^19.2.5",
+    "react-hook-form": "^7.56.4",
+    "react-router-dom": "^7.14.2",
+    "typescript": "~6.0.2",
+    "vite": "^8.0.9",
+    "vite-plugin-dts": "^4.5.4",
+    "vitest": "^3.2.4"
+  },
+  "dependencies": {}
+}

package/src/app/AdminApp.tsx

@@ -0,0 +1,34 @@
+import { useMemo } from "react";
+import { RouterProvider } from "react-router-dom";
+import { AppThemeProvider } from "../context/AppThemeProvider";
+import { createAdminRouter } from "../router/createAdminRouter";
+import type { AdminAppProps } from "../types";
+
+/**
+ * Declarative admin shell: theme, router, and layout from your route list.
+ * Wrap in `<AuthProvider adapter={...}>` — auth is not configured on this component.
+ */
+export function AdminApp({
+  navItems,
+  routes,
+  authRedirects,
+  layoutProps,
+  theme: themeKeys,
+}: AdminAppProps) {
+  const router = useMemo(
+    () =>
+      createAdminRouter({
+        navItems,
+        children: routes,
+        layoutProps,
+        redirects: authRedirects,
+      }),
+    [navItems, routes, layoutProps, authRedirects],
+  );
+
+  return (
+    <AppThemeProvider {...themeKeys}>
+      <RouterProvider router={router} />
+    </AppThemeProvider>
+  );
+}