@dyrected/admin 2.6.0 → 2.6.2

package/dist/lib/__tests__/external-media.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/lib/__tests__/media-utils.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/lib/compress-image.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Compress a raster image file client-side using the Canvas API before upload.
+ * - Skips SVGs, GIFs, and non-images (returned unchanged).
+ * - Skips if the environment lacks DOM Canvas / URL API (SSR or Node.js test environment).
+ * - Skips if the result would be larger than the original.
+ * - maxDimension: longest edge cap in pixels (default 2048).
+ * - quality: JPEG/WebP quality 0–1 (default 0.85).
+ */
+export declare function compressImage(file: File, maxDimension?: number, quality?: number): Promise<File>;

package/dist/lib/draft-live-compare.d.ts

@@ -0,0 +1,38 @@
+import { Field as FieldSchema } from '@dyrected/sdk';
+export type CompareGroup = "Text changes" | "Media changes" | "Layout / sections changed" | "Settings changed";
+export type CompareStatus = "Changed" | "Added" | "Removed";
+export interface CompareCard {
+    id: string;
+    group: CompareGroup;
+    label: string;
+    status: CompareStatus;
+    path: string;
+    kind: "text" | "richText" | "media" | "array" | "setting";
+    liveValue: unknown;
+    draftValue: unknown;
+    liveText: string;
+    draftText: string;
+    liveMedia?: CompareMediaPreview | null;
+    draftMedia?: CompareMediaPreview | null;
+}
+export interface CompareMediaPreview {
+    url: string | null;
+    filename: string | null;
+    alt: string | null;
+}
+export interface DraftLiveComparison {
+    hasPublishedVersion: boolean;
+    hasChanges: boolean;
+    fieldChangeCount: number;
+    sectionsAdded: number;
+    sectionsRemoved: number;
+    groups: Array<{
+        title: CompareGroup;
+        cards: CompareCard[];
+    }>;
+}
+export declare function buildDraftLiveComparison(args: {
+    fields: FieldSchema[];
+    draft: Record<string, unknown> | null | undefined;
+    live: Record<string, unknown> | null | undefined;
+}): DraftLiveComparison;

package/dist/lib/draft-live-compare.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/lib/external-media.d.ts

@@ -2,10 +2,9 @@
  * Detects the kind of external media a URL points to and builds the document
  * payload used to store it as a media record (no file bytes — just a reference).
  *
- * Supports YouTube and Vimeo video links, direct image URLs, and generic files.
- * The resulting `mimeType` (`video/youtube`, `video/vimeo`, `image/external`, or a
- * generic type) is what the media grid/preview components key off to render the
- * asset correctly.
+ * Supports YouTube and Vimeo video links, direct image URLs, direct video URLs, and generic files.
+ * The resulting `mimeType` (`video/youtube`, `video/vimeo`, `image/external`, `video/external`, or a
+ * generic type) is what the media grid/preview components key off to render the asset correctly.
  */
 export interface ExternalMediaPayload {
     filename: string;
@@ -14,6 +13,12 @@ export interface ExternalMediaPayload {
     filesize: number;
     id: string;
 }
+/** Extract the trailing filename from a URL, stripping any query string. */
+export declare function filenameFromUrl(url: string, fallback: string): string;
+/** Check if a URL points to an embeddable video streaming site (YouTube or Vimeo). */
+export declare function isEmbeddableVideoUrl(url: string): boolean;
+/** Check if a URL points directly to a raster/vector image file. */
+export declare function isDirectImageUrl(url: string): boolean;
 /**
  * Build a media document payload from an external URL.
  * Returns `null` when the input is empty/whitespace.

package/dist/lib/media-utils.d.ts

@@ -0,0 +1,26 @@
+export interface MediaSourceInfo {
+    source: "external" | "internal";
+    type: "youtube" | "vimeo" | "external-cdn" | "storage";
+    label: string;
+}
+/**
+ * Safely resolves the collection slug to use for media uploads.
+ * If the target collection is upload-enabled, returns collectionSlug.
+ * Otherwise, safely falls back to "media".
+ */
+export declare function resolveActiveMediaCollection(schemas: any, collectionSlug: string): string;
+/**
+ * Determines whether a media item is an External asset (embed/remote link) or an
+ * Internal asset (uploaded file in storage) based strictly on its persisted metadata.
+ */
+export declare function getMediaSourceInfo(item: unknown): MediaSourceInfo;
+/** Returns true if the given item is an external asset. */
+export declare function isExternalMedia(item: unknown): boolean;
+/**
+ * Checks whether an error indicates that Dyrected media storage is not configured.
+ */
+export declare function isStorageNotConfiguredError(error: unknown): boolean;
+/**
+ * Formats a media error into a friendly, non-technical message.
+ */
+export declare function formatMediaErrorMessage(error: unknown): string;

package/dist/lib/workflow-autosave.d.ts

@@ -0,0 +1,18 @@
+export declare const DEFAULT_WORKFLOW_AUTOSAVE_DELAY_MS = 1500;
+type WorkflowAutosaveAdminConfig = {
+    autosave?: boolean;
+    autosaveDelayMs?: number;
+} & Record<string, unknown>;
+type WorkflowAutosaveCollectionLike = {
+    workflow?: unknown;
+    drafts?: boolean;
+    admin?: WorkflowAutosaveAdminConfig;
+};
+export type WorkflowAutosaveState = "idle" | "dirty" | "saving" | "saved" | "error" | "conflict";
+export declare function isWorkflowEnabledCollection(collection?: WorkflowAutosaveCollectionLike | null): boolean;
+export declare function resolveWorkflowAutosaveSettings(collection?: WorkflowAutosaveCollectionLike | null): {
+    enabled: boolean;
+    delayMs: number;
+};
+export declare function classifyWorkflowAutosaveError(error: unknown): Extract<WorkflowAutosaveState, "error" | "conflict">;
+export {};

package/dist/lib/workflow-autosave.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/lib/workflow-ui.d.ts

@@ -0,0 +1,22 @@
+import { CollectionConfig, WorkflowConfig, WorkflowMetadata, WorkflowState, WorkflowTransition } from '@dyrected/core';
+export type WorkflowDocumentLike = Record<string, unknown> & {
+    id?: string;
+    _workflow?: WorkflowMetadata | null;
+};
+export declare function resolveWorkflowState(workflowConfig: WorkflowConfig | null | undefined, workflowMeta: Pick<WorkflowMetadata, "state"> | null | undefined): WorkflowState | null;
+export declare function resolveWorkflowStateFromDocument(workflowConfig: WorkflowConfig | null | undefined, item: WorkflowDocumentLike): WorkflowState | null;
+export type PublishingStatusSummary = {
+    label: "Draft" | "Published" | "Changed";
+    color: "warning" | "success" | "info";
+    workflowStateLabel: string | null;
+};
+export declare function resolvePublishingStatus(schema: CollectionConfig | undefined, item: Record<string, unknown>): PublishingStatusSummary | null;
+export declare function getAvailableWorkflowTransitions(workflowConfig: WorkflowConfig | null | undefined, workflowMeta: WorkflowMetadata | null | undefined): WorkflowTransition[];
+export declare function getPrimaryWorkflowTransition(transitions: WorkflowTransition[]): WorkflowTransition | null;
+export declare function shouldUseSaveDraftAsPrimaryAction(workflowConfig: WorkflowConfig | null | undefined, workflowMeta: WorkflowMetadata | null | undefined): boolean;
+export type GroupedWorkflowTransitions = {
+    normal: WorkflowTransition[];
+    unpublish: WorkflowTransition[];
+};
+export declare function groupWorkflowTransitions(transitions: WorkflowTransition[]): GroupedWorkflowTransitions;
+export declare function getCommonWorkflowTransitions(workflowConfig: WorkflowConfig | null | undefined, docs: WorkflowDocumentLike[]): WorkflowTransition[];

package/dist/lib/workflow-ui.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/providers/dyrected-form-context.d.ts

@@ -0,0 +1,14 @@
+import { DyrectedFormController } from '../controllers/form';
+import * as React from "react";
+export interface DyrectedFormProviderProps {
+    controller: DyrectedFormController;
+    children: React.ReactNode;
+}
+export declare function DyrectedFormProvider({ controller, children }: DyrectedFormProviderProps): React.JSX.Element;
+export interface DyrectedFieldPathProviderProps {
+    path: string;
+    children: React.ReactNode;
+}
+export declare function DyrectedFieldPathProvider({ path, children, }: DyrectedFieldPathProviderProps): React.JSX.Element;
+export declare function useDyrectedFormControllerContext(): DyrectedFormController;
+export declare function useDyrectedFieldPathContext(): string | null;

package/dist/public/contracts.d.ts

@@ -0,0 +1,230 @@
+import { AdminThemeController } from '../controllers/theme';
+import { AdminThemePreference, ResolvedAdminTheme } from '../hooks/admin-theme';
+import { DyrectedFieldController } from '../controllers/field';
+import { DyrectedFieldPathPart, DyrectedFieldState, DyrectedFormController, DyrectedFormState, DyrectedFormValues, DyrectedSetValueOptions } from '../controllers/form';
+import { MediaLibraryController, MediaRecord, MediaUploadController, MediaUploadQueueItem, MediaURLClassification, MediaURLController } from '../controllers/media';
+import { AdminSchemas } from '../types/admin-components';
+export interface AdminSchemasResult {
+    /** Loaded admin schemas for the active Dyrected client. */
+    schemas: AdminSchemas | null;
+    /** `true` while schemas are being fetched or refreshed. */
+    isLoading: boolean;
+    /** The last schema-loading error, if one occurred. */
+    error: Error | null;
+    /** Re-fetch the schema registry from the backend. */
+    refresh(): Promise<AdminSchemas>;
+}
+export interface MediaUploadHookOptions {
+    /** Target upload collection. Falls back to `"media"` when the collection is not upload-enabled. */
+    collectionSlug?: string;
+    /** Compress image files in the browser before upload. */
+    compressImages?: boolean;
+    /** Maximum image width or height after compression. */
+    maxDimension?: number;
+    /** Output image quality used during client-side compression. */
+    quality?: number;
+    /** Called each time a file completes successfully. */
+    onCompletedItem?: (item: MediaRecord) => void | Promise<void>;
+    /** Called once the full batch completes successfully. */
+    onAllCompleted?: (items: MediaRecord[]) => void | Promise<void>;
+    /** Called when an individual file upload fails. */
+    onError?: (error: Error, file: File) => void;
+}
+export interface MediaUploadHookResult {
+    /** The current upload queue. */
+    queue: MediaUploadQueueItem[];
+    /** `true` while any queued file is uploading. */
+    isUploading: boolean;
+    /** The collection currently being uploaded to. */
+    activeCollection: string;
+    /** Add one or more files to the upload queue and process them. */
+    uploadFiles(files: File[]): Promise<MediaRecord[]>;
+    /** Retry a previously failed queue item. */
+    retryUpload(id: string): Promise<MediaRecord | null>;
+    /** Remove one queue item without clearing the full queue. */
+    removeQueueItem(id: string): void;
+    /** Remove completed items from the queue. */
+    clearCompleted(): void;
+    /** Clear the queue contents exposed by this public API. */
+    clearQueue(): void;
+    /** Underlying framework-agnostic controller for advanced integrations. */
+    controller: MediaUploadController;
+}
+export interface MediaLibraryHookOptions {
+    /** Collection whose media should be browsed. Falls back to `"media"` when needed. */
+    collection: string;
+    /** Number of assets to fetch per page. */
+    pageSize?: number;
+    /** Initial filename search query. */
+    initialSearchQuery?: string;
+    /** Asset ids that should start selected. */
+    initialSelectedIds?: string[];
+}
+export interface MediaLibraryHookResult {
+    /** The resolved collection used by the media library. */
+    activeCollection: string;
+    /** Media items loaded for the current page and query. */
+    items: MediaRecord[];
+    /** Currently selected media ids. */
+    selectedIds: string[];
+    /** Selected media items derived from `items` and `selectedIds`. */
+    selectedItems: MediaRecord[];
+    /** Current search query. */
+    searchQuery: string;
+    /** Current page number. */
+    page: number;
+    /** `true` when another page can be loaded. */
+    hasNextPage: boolean;
+    /** `true` while a library request is in flight. */
+    isLoading: boolean;
+    /** The last library error, if any. */
+    error: Error | null;
+    /** Load the first page using the current query. */
+    load(): Promise<MediaRecord[]>;
+    /** Run a filename search and load the first page of results. */
+    search(query: string): Promise<MediaRecord[]>;
+    /** Load the next page and append it to the current results. */
+    loadNextPage(): Promise<MediaRecord[]>;
+    /** Replace the current selection with these ids. */
+    setSelectedIds(ids: string[]): void;
+    /** Add one id to the current selection. */
+    select(id: string): void;
+    /** Remove one id from the current selection. */
+    deselect(id: string): void;
+    /** Toggle one id in the current selection. */
+    toggle(id: string): void;
+    /** Clear all selected ids. */
+    clearSelection(): void;
+    /** Underlying framework-agnostic controller for advanced integrations. */
+    controller: MediaLibraryController;
+}
+export interface MediaURLHookOptions {
+    /** Collection where imported media records should be created. */
+    collection: string;
+    /** Compress direct image URLs after fetch and before upload. */
+    compressImages?: boolean;
+    /** Maximum image width or height after compression. */
+    maxDimension?: number;
+    /** Output image quality used during client-side compression. */
+    quality?: number;
+    /** Called when a URL import creates a media record successfully. */
+    onAdded?: (media: MediaRecord) => void | Promise<void>;
+    /** Called when URL classification or import fails. */
+    onError?: (error: Error) => void;
+}
+export interface MediaURLHookResult {
+    /** The current buffered URL. */
+    url: string;
+    /** Replace the buffered URL value. */
+    setUrl(nextUrl: string): void;
+    /** Submit the buffered URL. */
+    submit(): Promise<void>;
+    /** Import a URL directly without using the buffered value. */
+    importURL(nextUrl: string): Promise<MediaRecord>;
+    /** Classify a URL before importing it. */
+    classifyURL(nextUrl: string): MediaURLClassification;
+    /** `true` while a URL import is in flight. */
+    isSubmitting: boolean;
+    /** `true` when `submit()` can run with the current state. */
+    canSubmit: boolean;
+    /** The resolved collection used for the import. */
+    activeCollection: string;
+    /** Underlying framework-agnostic controller for advanced integrations. */
+    controller: MediaURLController;
+}
+export interface DyrectedFormHookResult {
+    /** Collection currently being edited. */
+    collection: string;
+    /** Field schema list for the form. */
+    fields: DyrectedFormState["fields"];
+    /** Current form values. */
+    values: DyrectedFormValues;
+    /** Current validation errors keyed by field path. */
+    errors: DyrectedFormState["errors"];
+    /** Dirty flags keyed by field path. */
+    dirtyFields: DyrectedFormState["dirtyFields"];
+    /** Touched flags keyed by field path. */
+    touchedFields: DyrectedFormState["touchedFields"];
+    /** `true` when any field has been marked dirty. */
+    isDirty: boolean;
+    /** `true` while submit is in progress. */
+    isSubmitting: boolean;
+    /** `true` when the form is currently valid. */
+    isValid: boolean;
+    /** Number of submit attempts made through this controller. */
+    submitCount: number;
+    /** `true` when the form is read-only. */
+    readOnly: boolean;
+    /** Current document id, when editing an existing document. */
+    documentId?: string;
+    /** Read one value by dotted field path. */
+    getValue(path: string): unknown;
+    /** Read the full form value object. */
+    getValues(): DyrectedFormValues;
+    /** Write one value by dotted field path. */
+    setValue(path: string, value: unknown, options?: DyrectedSetValueOptions): void;
+    /** Read one field schema by dotted field path. */
+    getFieldSchema(path: string): DyrectedFieldState["schema"];
+    /** Read one field state by dotted field path. */
+    getFieldState(path: string): DyrectedFieldState;
+    /** Reset the form to supplied values or initial state. */
+    reset(values?: DyrectedFormValues): void;
+    /** Validate the full form or one or more field paths. */
+    validate(paths?: string | string[]): Promise<boolean>;
+    /** Submit the form through its configured adapter. */
+    submit(): Promise<unknown>;
+    /** Underlying framework-agnostic controller for advanced integrations. */
+    controller: DyrectedFormController;
+}
+export interface DyrectedFieldHookResult {
+    /** Full resolved field path. */
+    path: string;
+    /** Field schema for this path. */
+    schema: DyrectedFieldState["schema"];
+    /** Current field value. */
+    value: unknown;
+    /** Validation error for this field, if any. */
+    error?: string;
+    /** `true` when this field is dirty. */
+    isDirty: boolean;
+    /** `true` when this field has been touched. */
+    isTouched: boolean;
+    /** `true` when this field is invalid. */
+    invalid: boolean;
+    /** Path split into segments. */
+    pathSegments: string[];
+    /** Parent path for this field. */
+    parentPath: string;
+    /** Join child path segments onto this field path. */
+    getChildPath(...parts: DyrectedFieldPathPart[]): string;
+    /** Build a child path under a specific array index. */
+    getItemPath(index: number, ...parts: DyrectedFieldPathPart[]): string;
+    /** Read a nested child value relative to this field path. */
+    getChildValue(...parts: DyrectedFieldPathPart[]): unknown;
+    /** Read a nested child schema relative to this field path. */
+    getChildSchema(...parts: DyrectedFieldPathPart[]): DyrectedFieldState["schema"];
+    /** Read a nested child state relative to this field path. */
+    getChildState(...parts: DyrectedFieldPathPart[]): DyrectedFieldState;
+    /** Write a nested child value relative to this field path. */
+    setChildValue(parts: DyrectedFieldPathPart | DyrectedFieldPathPart[], value: unknown, options?: DyrectedSetValueOptions): void;
+    /** Write this field's value. */
+    setValue(value: unknown, options?: DyrectedSetValueOptions): void;
+    /** Validate this field path. */
+    validate(): Promise<boolean>;
+    /** Underlying framework-agnostic controller for advanced integrations. */
+    controller: DyrectedFieldController;
+}
+export interface AdminThemeHookResult {
+    /** Stored theme preference. */
+    theme: AdminThemePreference;
+    /** Current detected system theme. */
+    systemTheme: ResolvedAdminTheme;
+    /** Resolved theme after applying the preference. */
+    resolvedTheme: ResolvedAdminTheme;
+    /** CSS class name that should be applied to the themed root. */
+    themeClassName: string;
+    /** Update the stored theme preference. */
+    setTheme(theme: AdminThemePreference): void;
+    /** Underlying controller, or `null` when using fallback state without a provider. */
+    controller: AdminThemeController | null;
+}

package/dist/public/index.d.ts

@@ -0,0 +1,26 @@
+export type { AdminComponents, AdminFieldComponentContext, AdminFieldComponentProps, AdminSchemas, CollectionListSlotProps, DashboardSlotProps, } from '../types/admin-components';
+export type { AdminSchemasResult, AdminThemeHookResult, DyrectedFieldHookResult, DyrectedFormHookResult, MediaLibraryHookOptions, MediaLibraryHookResult, MediaUploadHookOptions, MediaUploadHookResult, MediaURLHookOptions, MediaURLHookResult, } from './contracts';
+export { createDyrectedFieldController, } from '../controllers/field';
+export { createDyrectedFormController, getFieldPathSegments, getParentFieldPath, getValueAtPath, joinFieldPath, normalizeFieldPath, setValueAtPath, } from '../controllers/form';
+export { createAdminThemeController, } from '../controllers/theme';
+export { createMediaLibraryController, createMediaUploadController, createMediaURLController, } from '../controllers/media';
+export type { DyrectedFieldController, } from '../controllers/field';
+export type { DyrectedFieldState, DyrectedFormController, DyrectedFormControllerAdapters, DyrectedFormControllerOptions, DyrectedFieldPathPart, DyrectedFormState, DyrectedFormValues, DyrectedSetValueOptions, } from '../controllers/form';
+export type { AdminThemeController, AdminThemeControllerOptions, AdminThemeControllerState, } from '../controllers/theme';
+export type { MediaControllerSchemas, MediaLibraryController, MediaLibraryControllerOptions, MediaLibraryControllerState, MediaRecord, MediaUploadController, MediaUploadControllerOptions, MediaUploadControllerState, MediaUploadQueueItem, MediaURLClassification, MediaURLController, MediaURLControllerOptions, MediaURLControllerState, } from '../controllers/media';
+export { compressImage } from '../lib/compress-image';
+export { buildExternalMediaPayload, filenameFromUrl, isDirectImageUrl, isEmbeddableVideoUrl, } from '../lib/external-media';
+export { formatMediaErrorMessage, getMediaSourceInfo, isExternalMedia, resolveActiveMediaCollection, } from '../lib/media-utils';
+export { buildDefaultValues, buildSchemaShape, formatPath, getFlatErrors, resolveContainerPath, } from '../components/forms/utils';
+export { DyrectedFieldPathProvider, DyrectedFormProvider, } from '../providers/dyrected-form-context';
+export type { DyrectedFieldPathProviderProps, DyrectedFormProviderProps, } from '../providers/dyrected-form-context';
+export { AdminThemeProvider, AdminThemedRoot, } from '../hooks/admin-theme-provider';
+export { adminThemeClassName, getSystemAdminTheme, resolveAdminTheme, } from '../hooks/admin-theme';
+export type { AdminThemePreference, ResolvedAdminTheme, } from '../hooks/admin-theme';
+export { useAdminTheme } from '../hooks/use-admin-theme';
+export { useDyrectedForm } from '../hooks/use-dyrected-form';
+export { useField } from '../hooks/use-field';
+export { useMediaLibrary } from '../hooks/use-media-library';
+export { useMediaUpload } from '../hooks/use-media-upload';
+export { useMediaURL } from '../hooks/use-media-url';
+export { useAddMediaFromUrl } from '../hooks/use-add-media-from-url';

package/dist/public/index.js

@@ -0,0 +1,2 @@
+import { A as buildExternalMediaPayload, C as useMediaUpload, D as createMediaURLController, E as createMediaLibraryController, F as isEmbeddableVideoUrl, G as resolveAdminTheme, H as useAdminTheme, L as formatMediaErrorMessage, O as createMediaUploadController, P as isDirectImageUrl, R as getMediaSourceInfo, S as resolveContainerPath, T as useMediaLibrary, U as adminThemeClassName, V as resolveActiveMediaCollection, W as getSystemAdminTheme, _ as buildDefaultValues, a as useField, b as getFlatErrors, c as DyrectedFieldPathProvider, d as getFieldPathSegments, f as getParentFieldPath, g as setValueAtPath, h as normalizeFieldPath, i as createAdminThemeController, j as filenameFromUrl, k as compressImage, l as DyrectedFormProvider, m as joinFieldPath, n as AdminThemeProvider, o as createDyrectedFieldController, p as getValueAtPath, r as AdminThemedRoot, s as useDyrectedForm, t as useAddMediaFromUrl, u as createDyrectedFormController, v as buildSchemaShape, w as useMediaURL, y as formatPath, z as isExternalMedia } from "../use-add-media-from-url-DHGAAVLY.js";
+export { AdminThemeProvider, AdminThemedRoot, DyrectedFieldPathProvider, DyrectedFormProvider, adminThemeClassName, buildDefaultValues, buildExternalMediaPayload, buildSchemaShape, compressImage, createAdminThemeController, createDyrectedFieldController, createDyrectedFormController, createMediaLibraryController, createMediaURLController, createMediaUploadController, filenameFromUrl, formatMediaErrorMessage, formatPath, getFieldPathSegments, getFlatErrors, getMediaSourceInfo, getParentFieldPath, getSystemAdminTheme, getValueAtPath, isDirectImageUrl, isEmbeddableVideoUrl, isExternalMedia, joinFieldPath, normalizeFieldPath, resolveActiveMediaCollection, resolveAdminTheme, resolveContainerPath, setValueAtPath, useAddMediaFromUrl, useAdminTheme, useDyrectedForm, useField, useMediaLibrary, useMediaURL, useMediaUpload };

package/dist/public.d.ts

@@ -0,0 +1,2 @@
+export * from './public/index.js'
+export {}

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

@@ -1,5 +1,5 @@
 import { ComponentType } from 'react';
-import { AdminConfig, Block, CollectionConfig, GlobalConfig, PublicAdminAuthConfig } from '@dyrected/core';
+import { AdminConfig, Block, CollectionConfig, Field as FieldSchema, GlobalConfig, PublicAdminAuthConfig } 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 {
@@ -8,6 +8,7 @@ export interface AdminSchemas {
     globals: GlobalConfig[];
     admin?: AdminConfig;
     adminAuth?: PublicAdminAuthConfig;
+    hasStorage?: boolean;
 }
 /** Props injected into custom dashboard slot components. */
 export interface DashboardSlotProps {
@@ -54,6 +55,20 @@ export interface CollectionListSlotProps {
         create: string;
     };
 }
+export interface AdminFieldComponentContext {
+    user: Record<string, unknown> | null;
+    schemas?: AdminSchemas;
+    siblingData: Record<string, unknown>;
+}
+export interface AdminFieldComponentProps {
+    value: unknown;
+    onChange: (...event: any[]) => void;
+    field: FieldSchema;
+    path: string;
+    disabled?: boolean;
+    collection: string;
+    context?: AdminFieldComponentContext;
+}
 /**
  * Custom component overrides passed to `<DyrectedAdmin />`. Each key is a
  * registry: you reference a component by a string key in your schema config,
@@ -80,7 +95,7 @@ export interface AdminComponents {
      * registered under that key replaces the built-in input for that field.
      * Keys are arbitrary — this is a per-field override, not a per-type one.
      */
-    fields?: Record<string, ComponentType<any>>;
+    fields?: Record<string, ComponentType<AdminFieldComponentProps>>;
     /**
      * Dashboard slot components keyed by the slot-key names declared in the
      * top-level `admin.components` (`beforeDashboard` / `afterDashboard`).