@puckeditor/core 0.23.0 → 0.24.0-canary.34794e5d

package/dist/{Editor-44C53YAG.mjs → Editor-7HVJABBS.mjs}

@@ -4,16 +4,16 @@ import {
 import {
   EditorInner,
   LoadedRichTextMenu
-} from "./chunk-WF6I3XOL.mjs";
+} from "./chunk-FVMO3IOJ.mjs";
 import "./chunk-H635BA2V.mjs";
-import "./chunk-GNR2HNTB.mjs";
-import "./chunk-67Y7M4OJ.mjs";
-import "./chunk-4P4VZS4P.mjs";
-import "./chunk-NJTGWYYH.mjs";
+import "./chunk-FHGOTDB5.mjs";
+import "./chunk-YBKRDXOL.mjs";
+import "./chunk-L24AF7CT.mjs";
+import "./chunk-75VT4L37.mjs";
 import {
   useAppStore,
   useAppStoreApi
-} from "./chunk-K2LNXU54.mjs";
+} from "./chunk-OOTCJDR3.mjs";
 import "./chunk-Z2MS6UIF.mjs";
 import "./chunk-ZRAERXB4.mjs";
 import "./chunk-Y2EFNT5P.mjs";

package/dist/{actions-DA1J5F56.d.mts → actions-DzP_zhsF.d.mts}

@@ -1,4 +1,4 @@
-import { ReactElement, CSSProperties, ReactNode, ElementType, Ref, JSX } from 'react';
+import { ElementType, CSSProperties, Ref, ComponentPropsWithoutRef, ReactElement, ReactNode, JSX } from 'react';
 import { EditorStateSnapshot, Editor, Extensions } from '@tiptap/react';
 import { BlockquoteOptions } from '@tiptap/extension-blockquote';
 import { BoldOptions } from '@tiptap/extension-bold';
@@ -20,6 +20,62 @@ type ItemSelector = {
     zone?: string;
 };
 
+/**
+ * Props consumed by Puck internally that are shared between DropZones and slots.
+ */
+type DropZoneSharedProps<ComponentType extends ElementType = "div"> = {
+    allow?: string[];
+    disallow?: string[];
+    style?: CSSProperties;
+    minEmptyHeight?: CSSProperties["minHeight"] | number;
+    className?: string;
+    collisionAxis?: DragAxis;
+    ref?: Ref<any>;
+    as?: ComponentType;
+};
+/**
+ * All props consumed by Puck for a DropZone component. `zone` lives here only.
+ *
+ * On slots `zone` is injected internally, so slots use {@link SlotProps} instead.
+ */
+type DropZoneOwnProps<ComponentType extends ElementType = "div"> = DropZoneSharedProps<ComponentType> & {
+    zone: string;
+};
+/**
+ * Unsupported additional props that are never forwarded to `as`.
+ *
+ * Omitted from the public types AND stripped at runtime.
+ */
+type NonForwardableProps = {
+    children?: unknown;
+    dangerouslySetInnerHTML?: unknown;
+};
+/**
+ * Keys internally consumed by Puck and never forwarded to `as`.
+ */
+type ConsumedPropKey = keyof DropZoneOwnProps | "as" | "content" | "config" | "metadata";
+/**
+ * Additional props forwarded to the element or component provided via `as`,
+ * typed against it.
+ *
+ * Puck-internal/unsupported props are stripped so they don't leak onto the DOM.
+ */
+type ForwardedProps<ComponentType extends ElementType> = Omit<ComponentPropsWithoutRef<ComponentType>, ConsumedPropKey | keyof NonForwardableProps>;
+/**
+ * Props for a `DropZone` component.
+ *
+ * Any additional props not consumed by Puck are forwarded to the element or
+ * component provided via `as` (defaulting to a `div`), typed against it.
+ */
+type DropZoneProps<ComponentType extends ElementType = "div"> = DropZoneOwnProps<ComponentType> & ForwardedProps<ComponentType>;
+/**
+ * Props for a `slot` render component.
+ *
+ * Any additional props not consumed by Puck are forwarded to the element or
+ * component provided via `as` (defaulting to a `div`), typed against it.
+ */
+type SlotProps<ComponentType extends ElementType = "div"> = DropZoneSharedProps<ComponentType> & ForwardedProps<ComponentType>;
+
 declare const defaultEditorState: (ctx: EditorStateSnapshot, readOnly: boolean) => {
     isAlignLeft?: undefined;
     canAlignLeft?: undefined;
@@ -338,20 +394,11 @@ type FieldProps<F = Field<any>, ValueType = any> = {
     readOnly?: boolean;
 };
 
-type DropZoneProps = {
-    zone: string;
-    allow?: string[];
-    disallow?: string[];
-    style?: CSSProperties;
-    minEmptyHeight?: CSSProperties["minHeight"] | number;
-    className?: string;
-    collisionAxis?: DragAxis;
-    as?: ElementType;
-    ref?: Ref<any>;
-};
-
 type PuckContext = {
-    renderDropZone: (props: DropZoneProps) => React.ReactNode;
+    /**
+     * @deprecated Use {@link https://puckeditor.com/docs/api-reference/fields/slot Slots} instead.
+     */
+    renderDropZone: <ComponentType extends ElementType = "div">(props: DropZoneProps<ComponentType>) => React.ReactNode;
     metadata: Metadata;
     isEditing: boolean;
     dragRef: ((element: Element | null) => void) | null;
@@ -399,7 +446,7 @@ type ExtractField<UserField extends {
     type: T;
 }>;
 
-type SlotComponent = (props?: Omit<DropZoneProps, "zone">) => ReactNode;
+type SlotComponent = <ComponentType extends ElementType = "div">(props?: SlotProps<ComponentType>) => ReactNode;
 type PuckComponent<Props> = (props: WithId<WithPuckProps<{
     [K in keyof Props]: WithDeepSlots<Props[K], SlotComponent>;
 }>>) => JSX.Element;
@@ -713,12 +760,12 @@ type Overrides<UserConfig extends Config = Config> = OverridesGeneric<{
 }>;
 type FieldRenderFunctions<UserConfig extends Config = Config, G extends UserGenerics<UserConfig> = UserGenerics<UserConfig>, UserField extends {
     type: string;
-} = Field | G["UserField"]> = Omit<{
+} = Field | G["UserField"]> = {
     [Type in UserField["type"]]: React.FunctionComponent<FieldProps<ExtractField<UserField, Type>, any> & {
         children: ReactNode;
         name: string;
-    }>;
-}, "custom">;
+    }> | null;
+};
 
 type Direction = "left" | "right" | "up" | "down" | null;
 type DragAxis = "dynamic" | "y" | "x";

package/dist/{actions-DA1J5F56.d.ts → actions-DzP_zhsF.d.ts}

@@ -1,4 +1,4 @@
-import { ReactElement, CSSProperties, ReactNode, ElementType, Ref, JSX } from 'react';
+import { ElementType, CSSProperties, Ref, ComponentPropsWithoutRef, ReactElement, ReactNode, JSX } from 'react';
 import { EditorStateSnapshot, Editor, Extensions } from '@tiptap/react';
 import { BlockquoteOptions } from '@tiptap/extension-blockquote';
 import { BoldOptions } from '@tiptap/extension-bold';
@@ -20,6 +20,62 @@ type ItemSelector = {
     zone?: string;
 };
 
+/**
+ * Props consumed by Puck internally that are shared between DropZones and slots.
+ */
+type DropZoneSharedProps<ComponentType extends ElementType = "div"> = {
+    allow?: string[];
+    disallow?: string[];
+    style?: CSSProperties;
+    minEmptyHeight?: CSSProperties["minHeight"] | number;
+    className?: string;
+    collisionAxis?: DragAxis;
+    ref?: Ref<any>;
+    as?: ComponentType;
+};
+/**
+ * All props consumed by Puck for a DropZone component. `zone` lives here only.
+ *
+ * On slots `zone` is injected internally, so slots use {@link SlotProps} instead.
+ */
+type DropZoneOwnProps<ComponentType extends ElementType = "div"> = DropZoneSharedProps<ComponentType> & {
+    zone: string;
+};
+/**
+ * Unsupported additional props that are never forwarded to `as`.
+ *
+ * Omitted from the public types AND stripped at runtime.
+ */
+type NonForwardableProps = {
+    children?: unknown;
+    dangerouslySetInnerHTML?: unknown;
+};
+/**
+ * Keys internally consumed by Puck and never forwarded to `as`.
+ */
+type ConsumedPropKey = keyof DropZoneOwnProps | "as" | "content" | "config" | "metadata";
+/**
+ * Additional props forwarded to the element or component provided via `as`,
+ * typed against it.
+ *
+ * Puck-internal/unsupported props are stripped so they don't leak onto the DOM.
+ */
+type ForwardedProps<ComponentType extends ElementType> = Omit<ComponentPropsWithoutRef<ComponentType>, ConsumedPropKey | keyof NonForwardableProps>;
+/**
+ * Props for a `DropZone` component.
+ *
+ * Any additional props not consumed by Puck are forwarded to the element or
+ * component provided via `as` (defaulting to a `div`), typed against it.
+ */
+type DropZoneProps<ComponentType extends ElementType = "div"> = DropZoneOwnProps<ComponentType> & ForwardedProps<ComponentType>;
+/**
+ * Props for a `slot` render component.
+ *
+ * Any additional props not consumed by Puck are forwarded to the element or
+ * component provided via `as` (defaulting to a `div`), typed against it.
+ */
+type SlotProps<ComponentType extends ElementType = "div"> = DropZoneSharedProps<ComponentType> & ForwardedProps<ComponentType>;
+
 declare const defaultEditorState: (ctx: EditorStateSnapshot, readOnly: boolean) => {
     isAlignLeft?: undefined;
     canAlignLeft?: undefined;
@@ -338,20 +394,11 @@ type FieldProps<F = Field<any>, ValueType = any> = {
     readOnly?: boolean;
 };
 
-type DropZoneProps = {
-    zone: string;
-    allow?: string[];
-    disallow?: string[];
-    style?: CSSProperties;
-    minEmptyHeight?: CSSProperties["minHeight"] | number;
-    className?: string;
-    collisionAxis?: DragAxis;
-    as?: ElementType;
-    ref?: Ref<any>;
-};
-
 type PuckContext = {
-    renderDropZone: (props: DropZoneProps) => React.ReactNode;
+    /**
+     * @deprecated Use {@link https://puckeditor.com/docs/api-reference/fields/slot Slots} instead.
+     */
+    renderDropZone: <ComponentType extends ElementType = "div">(props: DropZoneProps<ComponentType>) => React.ReactNode;
     metadata: Metadata;
     isEditing: boolean;
     dragRef: ((element: Element | null) => void) | null;
@@ -399,7 +446,7 @@ type ExtractField<UserField extends {
     type: T;
 }>;
 
-type SlotComponent = (props?: Omit<DropZoneProps, "zone">) => ReactNode;
+type SlotComponent = <ComponentType extends ElementType = "div">(props?: SlotProps<ComponentType>) => ReactNode;
 type PuckComponent<Props> = (props: WithId<WithPuckProps<{
     [K in keyof Props]: WithDeepSlots<Props[K], SlotComponent>;
 }>>) => JSX.Element;
@@ -713,12 +760,12 @@ type Overrides<UserConfig extends Config = Config> = OverridesGeneric<{
 }>;
 type FieldRenderFunctions<UserConfig extends Config = Config, G extends UserGenerics<UserConfig> = UserGenerics<UserConfig>, UserField extends {
     type: string;
-} = Field | G["UserField"]> = Omit<{
+} = Field | G["UserField"]> = {
     [Type in UserField["type"]]: React.FunctionComponent<FieldProps<ExtractField<UserField, Type>, any> & {
         children: ReactNode;
         name: string;
-    }>;
-}, "custom">;
+    }> | null;
+};
 
 type Direction = "left" | "right" | "up" | "down" | null;
 type DragAxis = "dynamic" | "y" | "x";

package/dist/{chunk-NJTGWYYH.mjs → chunk-75VT4L37.mjs}

@@ -2,7 +2,7 @@ import {
   List,
   ListOrdered,
   useMessage
-} from "./chunk-K2LNXU54.mjs";
+} from "./chunk-OOTCJDR3.mjs";
 import {
   init_react_import
 } from "./chunk-M6W7YEVX.mjs";