@dyrected/admin 2.5.34 → 2.5.36

package/dist/lib/admin-icons.d.ts

@@ -1,4 +1,15 @@
 import { LucideIcon } from 'lucide-react';
 import { AdminIconName } from '@dyrected/core';
+/**
+ * Type guard — returns `true` if `value` is a string that matches a known
+ * Lucide icon name (i.e. a valid `AdminIconName`).
+ */
 export declare function isAdminIconName(value: unknown): value is AdminIconName;
+/**
+ * Returns the Lucide icon component for `value` if it is a valid `AdminIconName`,
+ * otherwise returns `fallback`.
+ *
+ * @param value - An untrusted value that may or may not be an icon name.
+ * @param fallback - The icon to use when `value` is not a valid icon name.
+ */
 export declare function resolveAdminIcon(value: unknown, fallback: LucideIcon): LucideIcon;

package/dist/lib/filter-rules.d.ts

@@ -1,16 +1,32 @@
 import { WhereClause, WhereOperatorName } from '@dyrected/core';
+/**
+ * A single filter rule in the admin filter builder.
+ * An array of rules is AND'd together and converted to a `WhereClause`
+ * before being passed to `collection.find({ where })`.
+ */
 export interface FilterRule {
+    /** Field name from the collection schema. */
     field: string;
+    /** Comparison operator (e.g. `"equals"`, `"contains"`, `"gt"`). */
     operator: WhereOperatorName;
+    /** Comparison value. `undefined` when the operator is `"exists"`. */
     value: unknown;
 }
 /**
- * Converts an array of FilterRules into a WhereClause.
- * All rules are ANDed together.
+ * Converts an array of `FilterRule`s into a flat `WhereClause`.
+ * All rules are AND'd together. When the same field appears more than once
+ * the extra conditions are moved into the top-level `AND` array.
+ *
+ * @param rules - Active filter rules from the filter builder UI.
+ * @returns A `WhereClause` ready to pass to `collection.find({ where })`.
  */
 export declare function rulesToWhere(rules: FilterRule[]): WhereClause;
 /**
- * Converts a flat WhereClause back into an array of FilterRules.
- * Best effort extraction for UI state.
+ * Converts a flat `WhereClause` back into an array of `FilterRule`s.
+ * Best-effort: nested `AND` conditions are unpacked; `OR` clauses are ignored.
+ * Used to restore filter builder state from the URL `?where=` param.
+ *
+ * @param where - A `WhereClause` object, typically parsed from the URL.
+ * @returns An array of `FilterRule`s suitable for rendering in the filter builder.
  */
 export declare function whereToRules(where: WhereClause | undefined): FilterRule[];

package/dist/lib/utils.d.ts

@@ -1,3 +1,22 @@
 import { ClassValue } from 'clsx';
+/**
+ * Merges Tailwind class names, resolving conflicts with the `dy-` prefix.
+ * Drop-in replacement for `clsx` that handles Dyrected's scoped Tailwind build.
+ */
 export declare function cn(...inputs: ClassValue[]): string;
+/**
+ * Resolves a media field value to an absolute URL.
+ *
+ * Handles three input shapes:
+ * - A fully-qualified URL (`https://...`) — returned as-is.
+ * - A root-relative path (`/uploads/...`) — origin prepended from `baseUrl`.
+ * - A bare filename or storage path (`default/photo.jpg`) — prefixed with `/api/media/`.
+ *
+ * Bare strings that look like document IDs (no extension, no slash) are returned
+ * as an empty string so they are not treated as media assets.
+ *
+ * @param val - A media field value: a URL string, storage path, or a document object with a `url` or `filename` property.
+ * @param baseUrl - The Dyrected backend base URL, used to build the origin for relative paths.
+ * @returns A fully-qualified URL string, or `""` if the value cannot be resolved.
+ */
 export declare function getMediaUrl(val: string | any, baseUrl: string): string;

package/dist/providers/dyrected-provider.d.ts

@@ -28,5 +28,12 @@ export interface DyrectedProviderProps {
     components?: DyrectedContextType['components'];
 }
 export declare function DyrectedProvider({ children, apiKey: initialApiKey, baseUrl: initialBaseUrl, siteId: initialSiteId, initialToken, defaultTechStack, components }: DyrectedProviderProps): import("react/jsx-runtime").JSX.Element;
+/**
+ * Returns the Dyrected admin context: the SDK client, current user, loaded
+ * schemas, auth helpers, and registered component overrides.
+ *
+ * Must be called within a component tree wrapped by `DyrectedProvider`.
+ * Throws if called outside of that context.
+ */
 export declare const useDyrected: () => DyrectedContextType;
 export {};

package/dist/types/admin-components.d.ts

@@ -1,23 +1,36 @@
 import { ComponentType } from 'react';
 import { AdminConfig, CollectionConfig, GlobalConfig } from '@dyrected/core';
 import { DyrectedClient, PaginatedResult } from '@dyrected/sdk';
+/** All collection and global schemas returned by the backend, plus optional admin config. */
 export interface AdminSchemas {
     collections: CollectionConfig[];
     globals: GlobalConfig[];
     admin?: AdminConfig;
 }
+/** Props injected into custom dashboard slot components. */
 export interface DashboardSlotProps {
+    /** Authenticated SDK client — use this to call any API. */
     client: DyrectedClient;
+    /** Currently logged-in user document, or `null` when unauthenticated. */
     user: Record<string, unknown> | null;
+    /** All schemas loaded from the backend. */
     schemas: AdminSchemas;
 }
+/** Props injected into custom collection list slot components. */
 export interface CollectionListSlotProps {
+    /** Authenticated SDK client. */
     client: DyrectedClient;
+    /** Currently logged-in user document, or `null` when unauthenticated. */
     user: Record<string, unknown> | null;
+    /** Schema config for the collection being rendered. */
     collection: CollectionConfig;
+    /** URL slug of the collection (e.g. `"posts"`). */
     collectionSlug: string;
+    /** Raw paginated response from the last `find()` call. */
     response: PaginatedResult<Record<string, unknown>> | undefined;
+    /** Unwrapped document array from `response`. */
     documents: Record<string, unknown>[];
+    /** `true` while the list query is in-flight. */
     isLoading: boolean;
     pagination: {
         page: number;
@@ -27,16 +40,47 @@ export interface CollectionListSlotProps {
         hasPrevPage: boolean;
     };
     permissions: {
+        /** Whether the current user may read documents in this collection. */
         canRead: boolean;
+        /** Whether the current user may create new documents. */
         canCreate: boolean;
     };
     urls: {
+        /** Admin URL for the collection list view. */
         collection: string;
+        /** Admin URL for the new-document form. */
         create: string;
     };
 }
+/**
+ * Custom component overrides passed to `<DyrectedAdmin />`.
+ *
+ * @example
+ * ```tsx
+ * <DyrectedAdmin
+ *   components={{
+ *     fields: { color: ColorPickerField },
+ *     dashboard: { analytics: AnalyticsWidget },
+ *     collectionList: { posts: PostsListView },
+ *   }}
+ * />
+ * ```
+ */
 export interface AdminComponents {
+    /**
+     * Custom field renderers keyed by field type name.
+     * A component registered here replaces the built-in renderer for every
+     * field whose `type` matches the key.
+     */
     fields?: Record<string, ComponentType<any>>;
+    /**
+     * Custom dashboard slot components keyed by a slot name of your choice.
+     * All registered components are rendered inside the dashboard page.
+     */
     dashboard?: Record<string, ComponentType<DashboardSlotProps>>;
+    /**
+     * Custom collection list slot components keyed by collection slug.
+     * The registered component replaces the entire list view for that collection.
+     */
     collectionList?: Record<string, ComponentType<CollectionListSlotProps>>;
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dyrected/admin",
-  "version": "2.5.34",
+  "version": "2.5.36",
   "type": "module",
   "files": [
     "dist"
@@ -54,6 +54,7 @@
     "jexl": "^2.3.0",
     "lucide-react": "^1.14.0",
     "react-blurhash": "^0.3.0",
+    "react-datasheet-grid": "^4.1.2",
     "react-day-picker": "^9.14.0",
     "react-dropzone": "^15.0.0",
     "react-hook-form": "^7.75.0",
@@ -62,8 +63,8 @@
     "tailwind-merge": "^3.5.0",
     "tailwindcss-animate": "^1.0.7",
     "zod": "^3.25.76",
-    "@dyrected/core": "^2.5.34",
-    "@dyrected/sdk": "^2.5.34"
+    "@dyrected/core": "^2.5.36",
+    "@dyrected/sdk": "^2.5.36"
   },
   "peerDependencies": {
     "@tanstack/react-query": "^5.0.0",