kirby-types 1.4.8 → 1.4.9

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "kirby-types",
   "type": "module",
-  "version": "1.4.8",
+  "version": "1.4.9",
   "packageManager": "pnpm@10.33.2",
   "description": "TypeScript types for Kirby Panel plugins and headless CMS usage",
   "author": "Johann Schopplich <hello@johannschopplich.com>",

package/src/panel/features.d.ts

@@ -662,12 +662,8 @@ export interface PanelViewDefaults extends PanelFeatureDefaults {
   id: string | null;
   /** View link */
   link: string | null;
-  /**
-   * Relative path to this view.
-   * Inherits the `string | null` shape from `PanelFeatureDefaults.path`;
-   * View does not override the runtime default of `null`.
-   */
-  path: string | null;
+  /** Relative path to this view */
+  path: string;
   /** Default search type */
   search: string;
   /** View title */
@@ -699,8 +695,8 @@ export interface PanelView extends Omit<
   id: string | null;
   /** View link */
   link: string | null;
-  /** Relative path to this view (inherits `string | null` from feature defaults) */
-  path: string | null;
+  /** Relative path to this view */
+  path: string;
   /** Default search type */
   search: string;
   /** View title */
@@ -1193,6 +1189,26 @@ export interface PanelSearcher {
 // Upload
 // -----------------------------------------------------------------------------
 
+/**
+ * Server-side file model passed to `PanelUpload.replace()` and stored in
+ * `PanelUploadDefaults.replacing`. Distinct from `PanelUploadFile` (the
+ * client-side queued upload). Carries the fields read by `replace()` to
+ * configure the upload picker (`url`, `accept`).
+ *
+ * @see https://github.com/getkirby/kirby/blob/main/panel/src/panel/upload.js
+ * @source panel/src/panel/upload.js
+ */
+export interface PanelUploadReplaceFile {
+  /** API path segment used to build the upload URL */
+  link: string;
+  /** File extension without dot, used for the picker `accept` filter */
+  extension: string;
+  /** MIME type, used for the picker `accept` filter */
+  mime: string;
+  /** Additional server-side fields */
+  [key: string]: any;
+}
+
 /**
  * Upload file state representing a file in the upload queue.
  *
@@ -1248,7 +1264,7 @@ export interface PanelUploadDefaults {
   /** File preview data */
   preview: Record<string, any>;
   /** Server file model being replaced (carries `link`, `extension`, `mime`). */
-  replacing: any | null;
+  replacing: PanelUploadReplaceFile | null;
   /** Upload endpoint URL */
   url: string | null;
 }
@@ -1280,7 +1296,7 @@ export interface PanelUpload
   /** File preview data */
   preview: Record<string, any>;
   /** Server file model being replaced (see `PanelUploadDefaults.replacing`) */
-  replacing: any | null;
+  replacing: PanelUploadReplaceFile | null;
   /** Upload endpoint URL */
   url: string | null;
 
@@ -1355,7 +1371,10 @@ export interface PanelUpload
    * @param file - Server file model being replaced
    * @param options - Upload options
    */
-  replace: (file: any, options?: Partial<PanelUploadDefaults>) => void;
+  replace: (
+    file: PanelUploadReplaceFile,
+    options?: Partial<PanelUploadDefaults>,
+  ) => void;
 
   /**
    * Adds files to upload list with deduplication.

package/src/panel/index.d.ts

@@ -1353,14 +1353,16 @@ export interface PanelViewProps {
   tab?: PanelViewPropsTab;
   /**
    * Sibling navigation link to the next model. Present on Page, File and
-   * User views; not emitted for Site.
+   * User views (may be `null` when there is no next sibling); not emitted
+   * for Site.
    */
-  next?: PanelViewPropsNavigation;
+  next?: PanelViewPropsNavigation | null;
   /**
    * Sibling navigation link to the previous model. Present on Page, File
-   * and User views; not emitted for Site.
+   * and User views (may be `null` when there is no previous sibling); not
+   * emitted for Site.
    */
-  prev?: PanelViewPropsNavigation;
+  prev?: PanelViewPropsNavigation | null;
   blueprint: string;
   model: PanelViewPropsModel;
   title: string;