docs: add jsdoc

packages/primitives/src/block-editor/image.tsx

@@ -5,6 +5,11 @@ import { isBlobURL } from '@wordpress/blob';
 import { ImagePrimitive, ImagePrimitiveValue } from '../shared/types.js';
 import { useBlockPrimitiveProps } from './block.js';
 
+/**
+ * The Image Block Editor Primitive
+ *
+ * Expects an attribute of type {@link ImagePrimitiveValue}
+ */
 const Image = ({
 	name,
 	onPrimitiveSelect,

packages/primitives/src/shared/types.ts

@@ -26,28 +26,83 @@ export type MediaReplaceFlow = {
 	popoverProps?: DropdownProps['popoverProps'];
 };
 
+/**
+ * Represents an image stored with {@link ImagePrimitive}
+ */
 export type ImagePrimitiveValue = {
+	/**
+	 * Image ID
+	 */
 	id: number;
+
+	/**
+	 * Image URL
+	 */
 	url: string;
+
+	/**
+	 * Image alt text
+	 */
 	alt: string;
 };
 
+/**
+ * The ImagePrimitive interface
+ */
 export interface ImagePrimitive extends Omit<MediaReplaceFlow, 'onSelect'> {
+	/**
+	 * The name of the attribute where image data should be stored
+	 */
 	name: string;
+
+	/**
+	 * The name/label of the toolbar control
+	 */
 	title?: string;
+
+	/**
+	 * The actual value
+	 */
 	value?: ImagePrimitiveValue;
+
+	/**
+	 * Optional custom onSelect handler
+	 *
+	 * @param name The name of the attribute
+	 * @param media The media object
+	 * @param setAttributes The setAttributes handler
+	 * @param attributes The attributes object
+	 *
+	 */
 	onPrimitiveSelect?: (
 		name: string,
-		value: Parameters<MediaReplaceFlow['onSelect']>['0'],
+		media: Parameters<MediaReplaceFlow['onSelect']>['0'],
 		setAttributes: SetAttributes,
 		attributes: Attributes,
 	) => void;
 }
 
 export interface RichTextPrimitive<T extends keyof HTMLElementTagNameMap>
 	extends Omit<RichText.Props<T>, 'onChange' | 'value'> {
+	/**
+	 * The name of the attribute where image data should be stored
+	 */
 	name: string;
+
+	/**
+	 * The actual value
+	 */
 	value?: string;
+
+	/**
+	 * Optional custom onSelect handler
+	 *
+	 * @param name The name of the attribute
+	 * @param value The value
+	 * @param setAttributes The setAttributes handler
+	 * @param attributes The attributes object
+	 *
+	 */
 	onPrimitiveChange?: (
 		name: string,
 		value: string,