@dyrected/admin 2.5.59 → 2.5.61

package/dist/lib/format.d.ts

@@ -0,0 +1,77 @@
+import { BooleanFormat, DateFormat, DisplayTone, JsonFormat, LinkFormat, NumberFormat, OptionFormat, TextFormat } from '@dyrected/core';
+/**
+ * Display-only formatting for `number` and `date`/`datetime`/`time` field values,
+ * driven by a field's `admin.format` option. Everything here is best-effort: an
+ * unparseable value or an unsupported option falls back to a plain string rather
+ * than throwing, because these run inside list-cell rendering.
+ */
+type NumberFormatObject = Exclude<NumberFormat, string>;
+type DateFormatObject = Exclude<DateFormat, string>;
+/** Normalize the shorthand string form into the object form. */
+export declare function resolveNumberFormat(format: NumberFormat | undefined): NumberFormatObject | null;
+/** Normalize the shorthand string form into the object form. */
+export declare function resolveDateFormat(format: DateFormat | undefined): DateFormatObject | null;
+export interface RatingSpec {
+    value: number;
+    max: number;
+}
+/**
+ * When the field uses the `rating` format, return the numeric value and star
+ * count so the caller can render stars. Returns `null` for every other format,
+ * signalling that {@link formatNumber} should be used instead.
+ */
+export declare function getRatingSpec(value: unknown, format: NumberFormat | undefined): RatingSpec | null;
+/**
+ * Format a numeric field value for display. Returns a plain string for every
+ * format except `rating` (use {@link getRatingSpec} for that). Non-numeric input
+ * is stringified unchanged.
+ */
+export declare function formatNumber(value: unknown, format: NumberFormat | undefined): string;
+/**
+ * Format a date/datetime/time field value for display. `now` is injected so the
+ * `relative` format stays deterministic and testable. Unparseable input is
+ * stringified unchanged.
+ */
+export declare function formatDate(value: unknown, format: DateFormat | undefined, fieldType: "date" | "datetime" | "time", now?: number): string;
+/** The color classes for a tone, falling back to `neutral`. */
+export declare function displayToneClass(tone: DisplayTone | undefined): string;
+type OptionFormatObject = Exclude<OptionFormat, string>;
+export declare function resolveOptionFormat(format: OptionFormat | undefined): OptionFormatObject | null;
+/** Field `options` as they arrive at render time — bare strings or `{ label, value }`. */
+type FieldOption = string | {
+    label?: string;
+    value?: unknown;
+};
+export interface BadgeSpec {
+    label: string;
+    tone: DisplayTone;
+}
+/**
+ * Resolve a single option value into a badge label + tone. Returns `null` when
+ * the field has no badge format, signalling the caller to render plainly.
+ */
+export declare function getOptionBadge(value: unknown, format: OptionFormat | undefined, options?: FieldOption[]): BadgeSpec | null;
+/**
+ * Resolve a boolean value into a custom label + tone. Returns `null` when the
+ * field has no boolean format, so the caller keeps the default Yes/No badge.
+ */
+export declare function getBooleanBadge(value: unknown, format: BooleanFormat | undefined): BadgeSpec | null;
+type TextFormatObject = Exclude<TextFormat, string>;
+export declare function resolveTextFormat(format: TextFormat | undefined): TextFormatObject | null;
+/** Apply a display-only transform to a text value. */
+export declare function formatText(value: unknown, format: TextFormat | undefined): string;
+/** Whether a text format should render in a monospace pill. */
+export declare function isCodeText(format: TextFormat | undefined): boolean;
+export interface LinkSpec {
+    href: string;
+    label: string;
+    newTab: boolean;
+}
+/**
+ * Resolve a url/email value into a link spec. Returns `null` when the field has
+ * no link format. `fieldType` selects between an `http` link and a `mailto:`.
+ */
+export declare function getLinkSpec(value: unknown, format: LinkFormat | undefined, fieldType: "url" | "email"): LinkSpec | null;
+/** Format a JSON value as a compact summary or truncated code preview. */
+export declare function formatJson(value: unknown, format: JsonFormat | undefined): string;
+export {};

package/dist/lib/format.test.d.ts

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

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

@@ -54,34 +54,43 @@ export interface CollectionListSlotProps {
     };
 }
 /**
- * Custom component overrides passed to `<DyrectedAdmin />`.
+ * Custom component overrides passed to `<DyrectedAdmin />`. Each key is a
+ * registry: you reference a component by a string key in your schema config,
+ * then provide the real component under that same key here.
  *
  * @example
  * ```tsx
  * <DyrectedAdmin
  *   components={{
- *     fields: { color: ColorPickerField },
+ *     // field's admin.component: 'brand-color'
+ *     fields: { 'brand-color': ColorPickerField },
+ *     // admin.components.beforeDashboard: ['analytics']
  *     dashboard: { analytics: AnalyticsWidget },
- *     collectionList: { posts: PostsListView },
+ *     // collection admin.components.beforeList: ['posts-header']
+ *     collectionList: { 'posts-header': PostsHeader },
  *   }}
  * />
  * ```
  */
 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.
+     * Custom field inputs keyed by the `admin.component` string set on a field.
+     * A field opts in by setting `admin.component: '<key>'`; the component
+     * 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>>;
     /**
-     * Custom dashboard slot components keyed by a slot name of your choice.
-     * All registered components are rendered inside the dashboard page.
+     * Dashboard slot components keyed by the slot-key names declared in the
+     * top-level `admin.components` (`beforeDashboard` / `afterDashboard`).
+     * The registered components render around the built-in dashboard.
      */
     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.
+     * Collection-list slot components keyed by the slot-key names declared in a
+     * collection's `admin.components` (`beforeList` / `beforeListTable` /
+     * `afterListTable` / `afterList`). They inject content around the built-in
+     * list — they do not replace it.
      */
     collectionList?: Record<string, ComponentType<CollectionListSlotProps>>;
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dyrected/admin",
-  "version": "2.5.59",
+  "version": "2.5.61",
   "type": "module",
   "files": [
     "dist"
@@ -56,7 +56,7 @@
     "papaparse": "^5.5.4",
     "react-blurhash": "^0.3.0",
     "react-datasheet-grid": "^4.1.2",
-    "react-day-picker": "^9.14.0",
+    "react-day-picker": "^8.10.1",
     "react-dropzone": "^15.0.0",
     "react-hook-form": "^7.75.0",
     "react-image-crop": "^11.0.10",
@@ -64,9 +64,9 @@
     "tailwind-merge": "^3.5.0",
     "tailwindcss-animate": "^1.0.7",
     "zod": "^3.25.76",
-    "@dyrected/core": "^2.5.59",
-    "@dyrected/sdk": "^2.5.59",
-    "@dyrected/knowledge": "^0.2.11"
+    "@dyrected/core": "^2.5.61",
+    "@dyrected/knowledge": "^0.2.13",
+    "@dyrected/sdk": "^2.5.61"
   },
   "peerDependencies": {
     "@tanstack/react-query": "^5.0.0",