@primereact/mcp 11.0.0-rc.2

package/data/llms/headless/components/gallery/api.json

@@ -0,0 +1,1349 @@
+[
+  {
+    "name": "useGallery",
+    "source": "apps/showcase/assets/apidoc/usegallery.json",
+    "data": {
+      "description": "The useGallery manages the state and functionality of a Gallery component.",
+      "interfaces": {
+        "UseGalleryChangeEvent": {
+          "description": "Event fired when the gallery's active index changes.",
+          "relatedProp": "",
+          "props": [
+            {
+              "name": "originalEvent",
+              "type": "E",
+              "default": "",
+              "description": "The original event that triggered the change. Absent when the change is\ntriggered programmatically (e.g. via the  `next()`  /  `prev()`  API)."
+            },
+            {
+              "name": "value",
+              "type": "number",
+              "default": "",
+              "description": "The value of the gallery."
+            }
+          ],
+          "methods": []
+        },
+        "UseGalleryProps": {
+          "description": "Defines valid properties in useGallery.",
+          "relatedProp": "",
+          "props": [
+            {
+              "name": "activeIndex",
+              "type": "number",
+              "default": "",
+              "description": "The index of the active item (controlled). Use together with  `onActiveIndexChange` .\nWhen provided, the gallery is controlled and its active item is driven by this value."
+            },
+            {
+              "name": "defaultActiveIndex",
+              "type": "number",
+              "default": "0",
+              "description": "The initial index of the active item for uncontrolled usage."
+            },
+            {
+              "name": "fullscreen",
+              "type": "boolean",
+              "default": "false",
+              "description": "Whether the gallery is rendered fullscreen via a portal. When  `true` , the gallery escapes its parent layout\nand covers the viewport — useful for opening a single image in a modal-style viewer."
+            },
+            {
+              "name": "closeOnEscape",
+              "type": "boolean",
+              "default": "true",
+              "description": "Whether pressing Escape closes the gallery when in fullscreen mode."
+            },
+            {
+              "name": "onFullscreenChange",
+              "type": "(value: boolean) => void",
+              "default": "",
+              "description": "Callback fired when the gallery's fullscreen state changes (via close button, escape key, etc.)."
+            },
+            {
+              "name": "onZoomChange",
+              "type": "(scale: number) => void",
+              "default": "",
+              "description": "Callback fired when the active item's zoom scale changes."
+            },
+            {
+              "name": "onRotateChange",
+              "type": "(rotation: number) => void",
+              "default": "",
+              "description": "Callback fired when the active item's rotation changes."
+            },
+            {
+              "name": "onFlipChange",
+              "type": "(flip: { x: number; y: number }) => void",
+              "default": "",
+              "description": "Callback fired when the active item's flip state changes."
+            },
+            {
+              "name": "onActiveIndexChange",
+              "type": "(event: UseGalleryChangeEvent) => void",
+              "default": "",
+              "description": "Callback fired when the gallery's active index changes."
+            }
+          ],
+          "methods": []
+        },
+        "UseGalleryState": {
+          "description": "Defines valid state in useGallery.",
+          "relatedProp": "",
+          "props": [
+            {
+              "name": "isFullscreen",
+              "type": "boolean",
+              "default": "",
+              "description": "Whether the gallery is in fullscreen mode."
+            },
+            {
+              "name": "activeIndex",
+              "type": "number",
+              "default": "",
+              "description": "The index of the active item."
+            },
+            {
+              "name": "zoomed",
+              "type": "boolean",
+              "default": "",
+              "description": "Whether the active item is zoomed in."
+            },
+            {
+              "name": "rotated",
+              "type": "boolean",
+              "default": "",
+              "description": "Whether the active item is rotated."
+            },
+            {
+              "name": "flipped",
+              "type": "boolean",
+              "default": "",
+              "description": "Whether the active item is flipped."
+            },
+            {
+              "name": "pendingAction",
+              "type": "GalleryPendingAction",
+              "default": "",
+              "description": "The pending action for the active item to consume."
+            }
+          ],
+          "methods": []
+        },
+        "UseGalleryRootProps": {
+          "description": "Pre-built props for the gallery root element.",
+          "relatedProp": "",
+          "props": [
+            {
+              "name": "id",
+              "type": "string",
+              "default": "",
+              "description": "The unique identifier of the gallery."
+            },
+            {
+              "name": "data-scope",
+              "type": "\"gallery\"",
+              "default": "",
+              "description": "Data attribute for scope identification."
+            },
+            {
+              "name": "data-part",
+              "type": "\"root\"",
+              "default": "",
+              "description": "Data attribute for part identification."
+            },
+            {
+              "name": "data-fullscreen",
+              "type": "\"\"",
+              "default": "",
+              "description": "Data attribute when the gallery is in fullscreen mode."
+            },
+            {
+              "name": "data-zoomed",
+              "type": "\"\"",
+              "default": "",
+              "description": "Data attribute when the active item is zoomed."
+            },
+            {
+              "name": "data-rotated",
+              "type": "\"\"",
+              "default": "",
+              "description": "Data attribute when the active item is rotated."
+            },
+            {
+              "name": "data-flipped",
+              "type": "\"\"",
+              "default": "",
+              "description": "Data attribute when the active item is flipped."
+            }
+          ],
+          "methods": []
+        },
+        "UseGalleryNextProps": {
+          "description": "Pre-built props for the gallery next button element.",
+          "relatedProp": "",
+          "props": [
+            {
+              "name": "data-scope",
+              "type": "\"gallery\"",
+              "default": "",
+              "description": "Data attribute for scope identification."
+            },
+            {
+              "name": "data-part",
+              "type": "\"next\"",
+              "default": "",
+              "description": "Data attribute for part identification."
+            },
+            {
+              "name": "onClick",
+              "type": "() => void",
+              "default": "",
+              "description": "Click handler to navigate to the next item."
+            }
+          ],
+          "methods": []
+        },
+        "UseGalleryPrevProps": {
+          "description": "Pre-built props for the gallery previous button element.",
+          "relatedProp": "",
+          "props": [
+            {
+              "name": "data-scope",
+              "type": "\"gallery\"",
+              "default": "",
+              "description": "Data attribute for scope identification."
+            },
+            {
+              "name": "data-part",
+              "type": "\"prev\"",
+              "default": "",
+              "description": "Data attribute for part identification."
+            },
+            {
+              "name": "onClick",
+              "type": "() => void",
+              "default": "",
+              "description": "Click handler to navigate to the previous item."
+            }
+          ],
+          "methods": []
+        },
+        "UseGalleryThumbnailProps": {
+          "description": "Pre-built props for the gallery thumbnail element.",
+          "relatedProp": "",
+          "props": [
+            {
+              "name": "data-scope",
+              "type": "\"gallery\"",
+              "default": "",
+              "description": "Data attribute for scope identification."
+            },
+            {
+              "name": "data-part",
+              "type": "\"thumbnail\"",
+              "default": "",
+              "description": "Data attribute for part identification."
+            },
+            {
+              "name": "slide",
+              "type": "number",
+              "default": "",
+              "description": "The active slide index passed to the carousel."
+            }
+          ],
+          "methods": []
+        },
+        "UseGalleryThumbnailContentProps": {
+          "description": "Pre-built props for the gallery thumbnail content element.",
+          "relatedProp": "",
+          "props": [
+            {
+              "name": "data-scope",
+              "type": "\"gallery\"",
+              "default": "",
+              "description": "Data attribute for scope identification."
+            },
+            {
+              "name": "data-part",
+              "type": "\"thumbnailContent\"",
+              "default": "",
+              "description": "Data attribute for part identification."
+            }
+          ],
+          "methods": []
+        },
+        "UseGalleryThumbnailItemProps": {
+          "description": "Pre-built props for a gallery thumbnail item element.",
+          "relatedProp": "",
+          "props": [
+            {
+              "name": "data-scope",
+              "type": "\"gallery\"",
+              "default": "",
+              "description": "Data attribute for scope identification."
+            },
+            {
+              "name": "data-part",
+              "type": "\"thumbnailItem\"",
+              "default": "",
+              "description": "Data attribute for part identification."
+            },
+            {
+              "name": "role",
+              "type": "\"button\"",
+              "default": "",
+              "description": "ARIA role for the clickable thumbnail."
+            },
+            {
+              "name": "aria-current",
+              "type": "true",
+              "default": "",
+              "description": "Marks the thumbnail of the currently shown slide."
+            },
+            {
+              "name": "aria-label",
+              "type": "string",
+              "default": "",
+              "description": "Accessible name for the thumbnail (e.g. \"Slide 2\")."
+            },
+            {
+              "name": "data-active",
+              "type": "\"\"",
+              "default": "",
+              "description": "Data attribute when the thumbnail item is active."
+            },
+            {
+              "name": "onClick",
+              "type": "(event: MouseEvent) => void",
+              "default": "",
+              "description": "Click handler to select this thumbnail item."
+            }
+          ],
+          "methods": []
+        },
+        "UseGalleryToolbarProps": {
+          "description": "Pre-built props for the gallery toolbar element.",
+          "relatedProp": "",
+          "props": [
+            {
+              "name": "data-scope",
+              "type": "\"gallery\"",
+              "default": "",
+              "description": "Data attribute for scope identification."
+            },
+            {
+              "name": "data-part",
+              "type": "\"toolbar\"",
+              "default": "",
+              "description": "Data attribute for part identification."
+            }
+          ],
+          "methods": []
+        },
+        "UseGalleryToolbarItemProps": {
+          "description": "Pre-built props for a gallery toolbar item element.",
+          "relatedProp": "",
+          "props": [
+            {
+              "name": "data-scope",
+              "type": "\"gallery\"",
+              "default": "",
+              "description": "Data attribute for scope identification."
+            },
+            {
+              "name": "data-part",
+              "type": "\"toolbarItem\"",
+              "default": "",
+              "description": "Data attribute for part identification."
+            },
+            {
+              "name": "onClick",
+              "type": "() => void",
+              "default": "",
+              "description": "Click handler to execute the toolbar action."
+            }
+          ],
+          "methods": []
+        },
+        "UseGalleryHeaderProps": {
+          "description": "Pre-built props for the gallery header element.",
+          "relatedProp": "",
+          "props": [
+            {
+              "name": "data-scope",
+              "type": "\"gallery\"",
+              "default": "",
+              "description": "Data attribute for scope identification."
+            },
+            {
+              "name": "data-part",
+              "type": "\"header\"",
+              "default": "",
+              "description": "Data attribute for part identification."
+            }
+          ],
+          "methods": []
+        },
+        "UseGalleryFooterProps": {
+          "description": "Pre-built props for the gallery footer element.",
+          "relatedProp": "",
+          "props": [
+            {
+              "name": "data-scope",
+              "type": "\"gallery\"",
+              "default": "",
+              "description": "Data attribute for scope identification."
+            },
+            {
+              "name": "data-part",
+              "type": "\"footer\"",
+              "default": "",
+              "description": "Data attribute for part identification."
+            }
+          ],
+          "methods": []
+        },
+        "UseGalleryBackdropProps": {
+          "description": "Pre-built props for the gallery backdrop element.",
+          "relatedProp": "",
+          "props": [
+            {
+              "name": "data-scope",
+              "type": "\"gallery\"",
+              "default": "",
+              "description": "Data attribute for scope identification."
+            },
+            {
+              "name": "data-part",
+              "type": "\"backdrop\"",
+              "default": "",
+              "description": "Data attribute for part identification."
+            }
+          ],
+          "methods": []
+        },
+        "UseGalleryContentProps": {
+          "description": "Pre-built props for the gallery content element.",
+          "relatedProp": "",
+          "props": [
+            {
+              "name": "data-scope",
+              "type": "\"gallery\"",
+              "default": "",
+              "description": "Data attribute for scope identification."
+            },
+            {
+              "name": "data-part",
+              "type": "\"content\"",
+              "default": "",
+              "description": "Data attribute for part identification."
+            }
+          ],
+          "methods": []
+        },
+        "UseGalleryActionProps": {
+          "description": "Pre-built props for a gallery action button element.",
+          "relatedProp": "",
+          "props": [
+            {
+              "name": "data-scope",
+              "type": "\"gallery\"",
+              "default": "",
+              "description": "Data attribute for scope identification."
+            },
+            {
+              "name": "data-part",
+              "type": "string",
+              "default": "",
+              "description": "Data attribute for part identification."
+            },
+            {
+              "name": "data-action",
+              "type": "string",
+              "default": "",
+              "description": "Data attribute for the action type."
+            },
+            {
+              "name": "onClick",
+              "type": "() => void",
+              "default": "",
+              "description": "Click handler to execute the action."
+            }
+          ],
+          "methods": []
+        },
+        "UseGalleryFullScreenProps": {
+          "description": "Pre-built props for the gallery fullscreen button element.",
+          "relatedProp": "",
+          "extendedTypes": "UseGalleryActionProps",
+          "props": [
+            {
+              "name": "data-scope",
+              "type": "\"gallery\"",
+              "default": "",
+              "description": "Data attribute for scope identification."
+            },
+            {
+              "name": "data-part",
+              "type": "string",
+              "default": "",
+              "description": "Data attribute for part identification."
+            },
+            {
+              "name": "data-action",
+              "type": "string",
+              "default": "",
+              "description": "Data attribute for the action type."
+            },
+            {
+              "name": "onClick",
+              "type": "() => void",
+              "default": "",
+              "description": "Click handler to execute the action."
+            },
+            {
+              "name": "data-fullscreen",
+              "type": "\"\"",
+              "default": "",
+              "description": "Data attribute when the gallery is in fullscreen mode."
+            }
+          ],
+          "methods": []
+        },
+        "UseGalleryZoomInProps": {
+          "description": "Pre-built props for the gallery zoom-in button element.",
+          "relatedProp": "",
+          "extendedTypes": "UseGalleryActionProps",
+          "props": [
+            {
+              "name": "data-scope",
+              "type": "\"gallery\"",
+              "default": "",
+              "description": "Data attribute for scope identification."
+            },
+            {
+              "name": "data-part",
+              "type": "string",
+              "default": "",
+              "description": "Data attribute for part identification."
+            },
+            {
+              "name": "data-action",
+              "type": "string",
+              "default": "",
+              "description": "Data attribute for the action type."
+            },
+            {
+              "name": "onClick",
+              "type": "() => void",
+              "default": "",
+              "description": "Click handler to execute the action."
+            },
+            {
+              "name": "disabled",
+              "type": "boolean",
+              "default": "",
+              "description": "Whether the button is disabled (when already zoomed in)."
+            }
+          ],
+          "methods": []
+        },
+        "UseGalleryZoomOutProps": {
+          "description": "Pre-built props for the gallery zoom-out button element.",
+          "relatedProp": "",
+          "extendedTypes": "UseGalleryActionProps",
+          "props": [
+            {
+              "name": "data-scope",
+              "type": "\"gallery\"",
+              "default": "",
+              "description": "Data attribute for scope identification."
+            },
+            {
+              "name": "data-part",
+              "type": "string",
+              "default": "",
+              "description": "Data attribute for part identification."
+            },
+            {
+              "name": "data-action",
+              "type": "string",
+              "default": "",
+              "description": "Data attribute for the action type."
+            },
+            {
+              "name": "onClick",
+              "type": "() => void",
+              "default": "",
+              "description": "Click handler to execute the action."
+            },
+            {
+              "name": "disabled",
+              "type": "boolean",
+              "default": "",
+              "description": "Whether the button is disabled (when not zoomed in)."
+            }
+          ],
+          "methods": []
+        },
+        "UseGalleryGetItemProps": {
+          "description": "Pre-built props returned by the getItemProps getter.",
+          "relatedProp": "",
+          "props": [
+            {
+              "name": "data-scope",
+              "type": "\"gallery\"",
+              "default": "",
+              "description": "Data attribute for scope identification."
+            },
+            {
+              "name": "data-part",
+              "type": "\"item\"",
+              "default": "",
+              "description": "Data attribute for part identification."
+            },
+            {
+              "name": "data-active",
+              "type": "\"\"",
+              "default": "",
+              "description": "Data attribute indicating whether the item is active."
+            }
+          ],
+          "methods": []
+        },
+        "UseGalleryExposes": {
+          "description": "Defines the methods and properties exposed by useGallery.",
+          "relatedProp": "",
+          "props": [
+            {
+              "name": "state",
+              "type": "UseGalleryState",
+              "default": "",
+              "description": "The state of the useGallery."
+            },
+            {
+              "name": "actions",
+              "type": "useGalleryActions",
+              "default": "",
+              "description": "The available actions for the gallery."
+            },
+            {
+              "name": "contentRef",
+              "type": "RefObject<HTMLElement>",
+              "default": "",
+              "description": "Ref to the content element."
+            },
+            {
+              "name": "thumbnailRef",
+              "type": "RefObject<CarouselRootInstance>",
+              "default": "",
+              "description": "Ref to the thumbnail carousel element."
+            },
+            {
+              "name": "prevRef",
+              "type": "RefObject<HTMLButtonElement>",
+              "default": "",
+              "description": "Ref to the previous button element."
+            },
+            {
+              "name": "nextRef",
+              "type": "RefObject<HTMLButtonElement>",
+              "default": "",
+              "description": "Ref to the next button element."
+            },
+            {
+              "name": "registerItem",
+              "type": "(index: number) => { index: number; unregister: () => void }",
+              "default": "",
+              "description": "Registers an item and returns its assigned index plus an  `unregister`  callback to call on item unmount.\nPass null for first registration, or the existing index to re-register."
+            },
+            {
+              "name": "handleNext",
+              "type": "(originalEvent?: SyntheticEvent) => void",
+              "default": "",
+              "description": "Navigates to the next item."
+            },
+            {
+              "name": "handlePrev",
+              "type": "(originalEvent?: SyntheticEvent) => void",
+              "default": "",
+              "description": "Navigates to the previous item."
+            },
+            {
+              "name": "selectItem",
+              "type": "(index: number, originalEvent?: SyntheticEvent) => void",
+              "default": "",
+              "description": "Selects a specific item by index."
+            },
+            {
+              "name": "clearPendingAction",
+              "type": "() => void",
+              "default": "",
+              "description": "Clears the pending action after it has been consumed by the active item."
+            },
+            {
+              "name": "toggleFullScreen",
+              "type": "() => void",
+              "default": "",
+              "description": "Toggles the fullscreen state."
+            },
+            {
+              "name": "handleClickAction",
+              "type": "(action?: string) => void",
+              "default": "",
+              "description": "Handles a click action dispatched from toolbar or action buttons."
+            },
+            {
+              "name": "reportItemState",
+              "type": "(itemState: { zoomed: boolean; rotated: boolean; flipped: boolean; scale: number; rotation: number; flip: { x: number; y: number } }) => void",
+              "default": "",
+              "description": "Reports the active item's transform state to the gallery."
+            },
+            {
+              "name": "rootProps",
+              "type": "UseGalleryRootProps",
+              "default": "",
+              "description": "Pre-built props for the root element."
+            },
+            {
+              "name": "nextProps",
+              "type": "UseGalleryNextProps",
+              "default": "",
+              "description": "Pre-built props for the next button element."
+            },
+            {
+              "name": "prevProps",
+              "type": "UseGalleryPrevProps",
+              "default": "",
+              "description": "Pre-built props for the previous button element."
+            },
+            {
+              "name": "thumbnailProps",
+              "type": "UseGalleryThumbnailProps",
+              "default": "",
+              "description": "Pre-built props for the thumbnail carousel element."
+            },
+            {
+              "name": "thumbnailContentProps",
+              "type": "UseGalleryThumbnailContentProps",
+              "default": "",
+              "description": "Pre-built props for the thumbnail content element."
+            },
+            {
+              "name": "thumbnailItemProps",
+              "type": "(index: number) => UseGalleryThumbnailItemProps",
+              "default": "",
+              "description": "Returns pre-built props for a thumbnail item element."
+            },
+            {
+              "name": "toolbarProps",
+              "type": "UseGalleryToolbarProps",
+              "default": "",
+              "description": "Pre-built props for the toolbar element."
+            },
+            {
+              "name": "toolbarItemProps",
+              "type": "(action: string) => UseGalleryToolbarItemProps",
+              "default": "",
+              "description": "Returns pre-built props for a toolbar item element."
+            },
+            {
+              "name": "headerProps",
+              "type": "UseGalleryHeaderProps",
+              "default": "",
+              "description": "Pre-built props for the header element."
+            },
+            {
+              "name": "footerProps",
+              "type": "UseGalleryFooterProps",
+              "default": "",
+              "description": "Pre-built props for the footer element."
+            },
+            {
+              "name": "backdropProps",
+              "type": "UseGalleryBackdropProps",
+              "default": "",
+              "description": "Pre-built props for the backdrop element."
+            },
+            {
+              "name": "contentProps",
+              "type": "UseGalleryContentProps",
+              "default": "",
+              "description": "Pre-built props for the content element."
+            },
+            {
+              "name": "downloadProps",
+              "type": "UseGalleryActionProps",
+              "default": "",
+              "description": "Pre-built props for the download action button."
+            },
+            {
+              "name": "flipXProps",
+              "type": "UseGalleryActionProps",
+              "default": "",
+              "description": "Pre-built props for the flip-x action button."
+            },
+            {
+              "name": "flipYProps",
+              "type": "UseGalleryActionProps",
+              "default": "",
+              "description": "Pre-built props for the flip-y action button."
+            },
+            {
+              "name": "rotateLeftProps",
+              "type": "UseGalleryActionProps",
+              "default": "",
+              "description": "Pre-built props for the rotate-left action button."
+            },
+            {
+              "name": "rotateRightProps",
+              "type": "UseGalleryActionProps",
+              "default": "",
+              "description": "Pre-built props for the rotate-right action button."
+            },
+            {
+              "name": "fullScreenProps",
+              "type": "UseGalleryFullScreenProps",
+              "default": "",
+              "description": "Pre-built props for the fullscreen toggle button."
+            },
+            {
+              "name": "zoomInProps",
+              "type": "UseGalleryZoomInProps",
+              "default": "",
+              "description": "Pre-built props for the zoom-in action button."
+            },
+            {
+              "name": "zoomOutProps",
+              "type": "UseGalleryZoomOutProps",
+              "default": "",
+              "description": "Pre-built props for the zoom-out action button."
+            },
+            {
+              "name": "zoomToggleProps",
+              "type": "UseGalleryActionProps",
+              "default": "",
+              "description": "Pre-built props for the zoom-toggle action button."
+            },
+            {
+              "name": "getItemProps",
+              "type": "(index: number) => UseGalleryGetItemProps",
+              "default": "",
+              "description": "Returns pre-built props for an item element at the given index."
+            }
+          ],
+          "methods": []
+        }
+      },
+      "types": {
+        "UseGalleryInstance": {
+          "description": "Instance of useGallery headless.",
+          "values": "HeadlessInstance<UseGalleryProps, UseGalleryState, UseGalleryExposes>"
+        }
+      },
+      "variables": {}
+    }
+  },
+  {
+    "name": "useGalleryItem",
+    "source": "apps/showcase/assets/apidoc/usegalleryitem.json",
+    "data": {
+      "description": "The useGalleryItem manages the state and functionality of a GalleryItem component.",
+      "interfaces": {
+        "UseGalleryItemGalleryRef": {
+          "description": "Minimal gallery interface required by useGalleryItem.\nSatisfied by both UseGalleryInstance (headless) and GalleryRootInstance (primitive).",
+          "relatedProp": "",
+          "extendedTypes": "UseGalleryExposes",
+          "props": [
+            {
+              "name": "actions",
+              "type": "useGalleryActions",
+              "default": "",
+              "description": "The available actions for the gallery."
+            },
+            {
+              "name": "contentRef",
+              "type": "RefObject<HTMLElement>",
+              "default": "",
+              "description": "Ref to the content element."
+            },
+            {
+              "name": "thumbnailRef",
+              "type": "RefObject<CarouselRootInstance>",
+              "default": "",
+              "description": "Ref to the thumbnail carousel element."
+            },
+            {
+              "name": "prevRef",
+              "type": "RefObject<HTMLButtonElement>",
+              "default": "",
+              "description": "Ref to the previous button element."
+            },
+            {
+              "name": "nextRef",
+              "type": "RefObject<HTMLButtonElement>",
+              "default": "",
+              "description": "Ref to the next button element."
+            },
+            {
+              "name": "registerItem",
+              "type": "(index: number) => { index: number; unregister: () => void }",
+              "default": "",
+              "description": "Registers an item and returns its assigned index plus an  `unregister`  callback to call on item unmount.\nPass null for first registration, or the existing index to re-register."
+            },
+            {
+              "name": "handleNext",
+              "type": "(originalEvent?: SyntheticEvent) => void",
+              "default": "",
+              "description": "Navigates to the next item."
+            },
+            {
+              "name": "handlePrev",
+              "type": "(originalEvent?: SyntheticEvent) => void",
+              "default": "",
+              "description": "Navigates to the previous item."
+            },
+            {
+              "name": "selectItem",
+              "type": "(index: number, originalEvent?: SyntheticEvent) => void",
+              "default": "",
+              "description": "Selects a specific item by index."
+            },
+            {
+              "name": "clearPendingAction",
+              "type": "() => void",
+              "default": "",
+              "description": "Clears the pending action after it has been consumed by the active item."
+            },
+            {
+              "name": "toggleFullScreen",
+              "type": "() => void",
+              "default": "",
+              "description": "Toggles the fullscreen state."
+            },
+            {
+              "name": "handleClickAction",
+              "type": "(action?: string) => void",
+              "default": "",
+              "description": "Handles a click action dispatched from toolbar or action buttons."
+            },
+            {
+              "name": "reportItemState",
+              "type": "(itemState: { zoomed: boolean; rotated: boolean; flipped: boolean; scale: number; rotation: number; flip: { x: number; y: number } }) => void",
+              "default": "",
+              "description": "Reports the active item's transform state to the gallery."
+            },
+            {
+              "name": "rootProps",
+              "type": "UseGalleryRootProps",
+              "default": "",
+              "description": "Pre-built props for the root element."
+            },
+            {
+              "name": "nextProps",
+              "type": "UseGalleryNextProps",
+              "default": "",
+              "description": "Pre-built props for the next button element."
+            },
+            {
+              "name": "prevProps",
+              "type": "UseGalleryPrevProps",
+              "default": "",
+              "description": "Pre-built props for the previous button element."
+            },
+            {
+              "name": "thumbnailProps",
+              "type": "UseGalleryThumbnailProps",
+              "default": "",
+              "description": "Pre-built props for the thumbnail carousel element."
+            },
+            {
+              "name": "thumbnailContentProps",
+              "type": "UseGalleryThumbnailContentProps",
+              "default": "",
+              "description": "Pre-built props for the thumbnail content element."
+            },
+            {
+              "name": "thumbnailItemProps",
+              "type": "(index: number) => UseGalleryThumbnailItemProps",
+              "default": "",
+              "description": "Returns pre-built props for a thumbnail item element."
+            },
+            {
+              "name": "toolbarProps",
+              "type": "UseGalleryToolbarProps",
+              "default": "",
+              "description": "Pre-built props for the toolbar element."
+            },
+            {
+              "name": "toolbarItemProps",
+              "type": "(action: string) => UseGalleryToolbarItemProps",
+              "default": "",
+              "description": "Returns pre-built props for a toolbar item element."
+            },
+            {
+              "name": "headerProps",
+              "type": "UseGalleryHeaderProps",
+              "default": "",
+              "description": "Pre-built props for the header element."
+            },
+            {
+              "name": "footerProps",
+              "type": "UseGalleryFooterProps",
+              "default": "",
+              "description": "Pre-built props for the footer element."
+            },
+            {
+              "name": "backdropProps",
+              "type": "UseGalleryBackdropProps",
+              "default": "",
+              "description": "Pre-built props for the backdrop element."
+            },
+            {
+              "name": "contentProps",
+              "type": "UseGalleryContentProps",
+              "default": "",
+              "description": "Pre-built props for the content element."
+            },
+            {
+              "name": "downloadProps",
+              "type": "UseGalleryActionProps",
+              "default": "",
+              "description": "Pre-built props for the download action button."
+            },
+            {
+              "name": "flipXProps",
+              "type": "UseGalleryActionProps",
+              "default": "",
+              "description": "Pre-built props for the flip-x action button."
+            },
+            {
+              "name": "flipYProps",
+              "type": "UseGalleryActionProps",
+              "default": "",
+              "description": "Pre-built props for the flip-y action button."
+            },
+            {
+              "name": "rotateLeftProps",
+              "type": "UseGalleryActionProps",
+              "default": "",
+              "description": "Pre-built props for the rotate-left action button."
+            },
+            {
+              "name": "rotateRightProps",
+              "type": "UseGalleryActionProps",
+              "default": "",
+              "description": "Pre-built props for the rotate-right action button."
+            },
+            {
+              "name": "fullScreenProps",
+              "type": "UseGalleryFullScreenProps",
+              "default": "",
+              "description": "Pre-built props for the fullscreen toggle button."
+            },
+            {
+              "name": "zoomInProps",
+              "type": "UseGalleryZoomInProps",
+              "default": "",
+              "description": "Pre-built props for the zoom-in action button."
+            },
+            {
+              "name": "zoomOutProps",
+              "type": "UseGalleryZoomOutProps",
+              "default": "",
+              "description": "Pre-built props for the zoom-out action button."
+            },
+            {
+              "name": "zoomToggleProps",
+              "type": "UseGalleryActionProps",
+              "default": "",
+              "description": "Pre-built props for the zoom-toggle action button."
+            },
+            {
+              "name": "getItemProps",
+              "type": "(index: number) => UseGalleryGetItemProps",
+              "default": "",
+              "description": "Returns pre-built props for an item element at the given index."
+            },
+            {
+              "name": "state",
+              "type": "UseGalleryState",
+              "default": "",
+              "description": "The state of the useGallery."
+            }
+          ],
+          "methods": []
+        },
+        "UseGalleryItemChangeEvent": {
+          "description": "Event fired when the gallery item's active index changes.",
+          "relatedProp": "",
+          "props": [
+            {
+              "name": "originalEvent",
+              "type": "E",
+              "default": "",
+              "description": "The original event that triggered the change."
+            },
+            {
+              "name": "value",
+              "type": "string | number | (string | number)[]",
+              "default": "",
+              "description": "The active index of the gallery item."
+            }
+          ],
+          "methods": []
+        },
+        "UseGalleryItemProps": {
+          "description": "Defines valid properties in useGalleryItem component.",
+          "relatedProp": "",
+          "props": [
+            {
+              "name": "context",
+              "type": "UseGalleryItemGalleryRef",
+              "default": "",
+              "description": "The parent gallery instance. The primitive  `Gallery.Item`  reads it from the\nnearest  `GalleryProvider`  and passes it here; supply it directly for standalone\nheadless usage. The headless hook itself never reads React context, keeping the\nheadless layer independent of the primitive layer."
+            },
+            {
+              "name": "normalScale",
+              "type": "number",
+              "default": "1",
+              "description": "The normal scale of the gallery item."
+            },
+            {
+              "name": "zoomedScale",
+              "type": "number",
+              "default": "3",
+              "description": "The zoomed scale of the gallery item."
+            }
+          ],
+          "methods": []
+        },
+        "UseGalleryItemState": {
+          "description": "Defines valid state in useGalleryItem component.",
+          "relatedProp": "",
+          "props": [
+            {
+              "name": "index",
+              "type": "number",
+              "default": "",
+              "description": "The index of the item in the gallery."
+            },
+            {
+              "name": "isActive",
+              "type": "boolean",
+              "default": "",
+              "description": "Whether the item is the active (visible) item."
+            },
+            {
+              "name": "position",
+              "type": "{ x: number; y: number }",
+              "default": "",
+              "description": "The current pan position."
+            },
+            {
+              "name": "scale",
+              "type": "number",
+              "default": "",
+              "description": "The current zoom scale."
+            },
+            {
+              "name": "rotation",
+              "type": "number",
+              "default": "",
+              "description": "The current rotation in degrees."
+            },
+            {
+              "name": "flip",
+              "type": "{ x: number; y: number }",
+              "default": "",
+              "description": "The current flip state."
+            }
+          ],
+          "methods": []
+        },
+        "UseGalleryItemElementProps": {
+          "description": "Pre-built props for a gallery item element.\n\nThe  `style`  object includes the following CSS custom properties for transforms:\n-  `--position-x` : The horizontal pan position (e.g.  `\"10px\"` ).\n-  `--position-y` : The vertical pan position (e.g.  `\"10px\"` ).\n-  `--scale` : The current zoom scale (e.g.  `\"1\"` ).\n-  `--rotation` : The current rotation (e.g.  `\"90deg\"` ).\n-  `--flip-x` : The horizontal flip multiplier (1 or -1).\n-  `--flip-y` : The vertical flip multiplier (1 or -1).",
+          "relatedProp": "",
+          "props": [
+            {
+              "name": "data-scope",
+              "type": "\"gallery\"",
+              "default": "",
+              "description": "Data attribute for scope identification."
+            },
+            {
+              "name": "data-part",
+              "type": "\"item\"",
+              "default": "",
+              "description": "Data attribute for part identification."
+            },
+            {
+              "name": "data-index",
+              "type": "number",
+              "default": "",
+              "description": "Data attribute for the item index."
+            },
+            {
+              "name": "data-active",
+              "type": "\"\"",
+              "default": "",
+              "description": "Data attribute present when the item is active."
+            },
+            {
+              "name": "data-rotating",
+              "type": "\"\"",
+              "default": "",
+              "description": "Data attribute present while the item is rotating."
+            },
+            {
+              "name": "onClick",
+              "type": "(e: MouseEvent<HTMLDivElement>) => void",
+              "default": "",
+              "description": "Click handler for the item."
+            },
+            {
+              "name": "onPointerDown",
+              "type": "(e: PointerEvent<HTMLDivElement>) => void",
+              "default": "",
+              "description": "Pointer down handler for the item."
+            },
+            {
+              "name": "onPointerMove",
+              "type": "(e: PointerEvent<HTMLDivElement>) => void",
+              "default": "",
+              "description": "Pointer move handler for the item."
+            },
+            {
+              "name": "onPointerUp",
+              "type": "(e: PointerEvent<HTMLDivElement>) => void",
+              "default": "",
+              "description": "Pointer up handler for the item."
+            },
+            {
+              "name": "onDragStart",
+              "type": "(e: DragEvent<HTMLDivElement>) => void",
+              "default": "",
+              "description": "Drag start handler for the item."
+            },
+            {
+              "name": "style",
+              "type": "CSSProperties",
+              "default": "",
+              "description": "Structural style including CSS custom properties for transforms."
+            }
+          ],
+          "methods": []
+        },
+        "UseGalleryItemExposes": {
+          "description": "Defines the methods and properties exposed by useGalleryItem component.",
+          "relatedProp": "",
+          "props": [
+            {
+              "name": "state",
+              "type": "UseGalleryItemState",
+              "default": "",
+              "description": "The state of the useGalleryItem."
+            },
+            {
+              "name": "itemProps",
+              "type": "UseGalleryItemElementProps",
+              "default": "",
+              "description": "Pre-built props for the item root element."
+            },
+            {
+              "name": "handleDragStart",
+              "type": "(e: DragEvent<HTMLDivElement>) => void",
+              "default": "",
+              "description": "Handles the drag start event to prevent default browser drag behavior."
+            },
+            {
+              "name": "handlePointerUp",
+              "type": "(e: PointerEvent<HTMLDivElement>) => void",
+              "default": "",
+              "description": "Handles the pointer up event to end panning."
+            },
+            {
+              "name": "handlePointerMove",
+              "type": "(e: PointerEvent<HTMLDivElement>) => void",
+              "default": "",
+              "description": "Handles the pointer move event for panning while zoomed."
+            },
+            {
+              "name": "handlePointerDown",
+              "type": "(e: PointerEvent<HTMLDivElement>) => void",
+              "default": "",
+              "description": "Handles the pointer down event to start panning."
+            },
+            {
+              "name": "handleClick",
+              "type": "(e: MouseEvent<HTMLDivElement>) => void",
+              "default": "",
+              "description": "Handles the click event to toggle zoom."
+            },
+            {
+              "name": "zoomIn",
+              "type": "() => void",
+              "default": "",
+              "description": "Zooms in the gallery item."
+            },
+            {
+              "name": "zoomOut",
+              "type": "() => void",
+              "default": "",
+              "description": "Zooms out the gallery item."
+            },
+            {
+              "name": "rotateLeft",
+              "type": "() => void",
+              "default": "",
+              "description": "Rotates the gallery item left by 90 degrees."
+            },
+            {
+              "name": "rotateRight",
+              "type": "() => void",
+              "default": "",
+              "description": "Rotates the gallery item right by 90 degrees."
+            },
+            {
+              "name": "flipX",
+              "type": "() => void",
+              "default": "",
+              "description": "Flips the gallery item horizontally."
+            },
+            {
+              "name": "flipY",
+              "type": "() => void",
+              "default": "",
+              "description": "Flips the gallery item vertically."
+            },
+            {
+              "name": "download",
+              "type": "() => void",
+              "default": "",
+              "description": "Downloads the gallery item."
+            },
+            {
+              "name": "calculateConstraints",
+              "type": "() => { minX: number; maxX: number; minY: number; maxY: number }",
+              "default": "",
+              "description": "Calculates the pan constraints for the gallery item based on its current scale."
+            },
+            {
+              "name": "calculateItemSize",
+              "type": "() => void",
+              "default": "",
+              "description": "Recalculates the size of the gallery item element."
+            }
+          ],
+          "methods": []
+        }
+      },
+      "types": {
+        "UseGalleryItemInstance": {
+          "description": "Instance of useGalleryItem headless.",
+          "values": "HeadlessInstance<UseGalleryItemProps, UseGalleryItemState, UseGalleryItemExposes>"
+        }
+      },
+      "variables": {}
+    }
+  }
+]