@vtex/faststore 0.0.1

package/dist/particles/footer-social/footer-social.d.ts

@@ -0,0 +1,79 @@
+import { ContentValue } from "../../core/dist/define-content-type.js";
+import { ComponentDefinition } from "../../core/dist/define-component.js";
+import "../../core/dist/index.js";
+import { ComponentPropsWithRef } from "react";
+//#region src/particles/footer-social/footer-social.d.ts
+export declare const FooterSocialContent: {
+  readonly id: "footer-social";
+  readonly title: "Footer Social";
+  readonly description: "Links to the store's official social profiles, shown as a row of platform icons.";
+  readonly schema: {
+    readonly type: "object";
+    readonly additionalProperties: false;
+    readonly properties: {
+      readonly heading: {
+        readonly type: "string";
+        readonly title: "Heading";
+      };
+      readonly entries: {
+        readonly type: "array";
+        readonly title: "Social profiles";
+        readonly minItems: 1;
+        readonly items: {
+          readonly type: "object";
+          readonly additionalProperties: false;
+          readonly required: readonly ["label", "url"];
+          readonly properties: {
+            readonly platform: {
+              readonly type: "string";
+              readonly enum: readonly ["facebook", "instagram", "linkedin", "pinterest", "youtube"];
+              readonly title: "Platform";
+            };
+            readonly url: {
+              readonly type: "string";
+              readonly minLength: 1;
+              readonly title: "Profile URL";
+              readonly format: "uri-reference";
+              readonly pattern: "^(?:https?://.*|mailto:.+|tel:.+|/(?:[^/].*)?)$";
+            };
+            readonly label: {
+              readonly type: "string";
+              readonly minLength: 1;
+              readonly title: "Label";
+            };
+            readonly iconUrl: {
+              readonly type: "string";
+              readonly format: "uri";
+              readonly title: "Custom icon";
+              readonly widget: {
+                readonly 'ui:widget': "media-gallery";
+              };
+            };
+          };
+        };
+      };
+    };
+  };
+};
+/**
+ * The platform glyphs `platform` admits, every one verified to resolve. Exported because a store's
+ * `global.json` has to list them under `icons.include` for a CMS-chosen name to resolve at runtime —
+ * one import there instead of five retyped strings. Reading it off the model rather than declaring it
+ * beside one makes the two impossible to drift apart.
+ */
+export declare const SOCIAL_PLATFORM_NAMES: readonly ["facebook", "instagram", "linkedin", "pinterest", "youtube"];
+type FooterSocialContentValue = ContentValue<typeof FooterSocialContent>;
+/** One profile in the row. Derived from the model so the prop and content channels cannot drift. */
+export type FooterSocialEntry = NonNullable<FooterSocialContentValue['entries']>[number];
+export type FooterSocialProps = ComponentPropsWithRef<'div'> & {
+  /** Authored fallback for the section heading, used when no CMS entry supplies one. */
+  heading?: string;
+  /** Authored fallback for the profile list, used when no CMS entry supplies one. */
+  entries?: readonly FooterSocialEntry[];
+  /** Injected by the compiler, sliced from the page's or layout's composite content entry. */
+  $content?: FooterSocialContentValue;
+};
+export declare const FooterSocialDefinition: ComponentDefinition<FooterSocialProps>;
+export declare function FooterSocial({ heading, entries, $content, className, ...props }: FooterSocialProps): import("react/jsx-runtime").JSX.Element | null;
+//#endregion
+//# sourceMappingURL=footer-social.d.ts.map

package/dist/particles/footer-social/footer-social.js

@@ -0,0 +1,176 @@
+import { defineComponent } from "../../core/dist/define-component.js";
+import { defineContentType } from "../../core/dist/define-content-type.js";
+import "../../core/dist/index.js";
+import { Icon } from "../icon/icon.js";
+import { resolveSafeHref } from "../../utils/safe-href.js";
+import { NavigationLink } from "../navigation-link/navigation-link.js";
+import { Image } from "../image/image.js";
+import { Fragment, jsx, jsxs } from "react/jsx-runtime";
+//#region src/particles/footer-social/footer-social.tsx
+const FooterSocialContent = defineContentType({
+	id: "footer-social",
+	title: "Footer Social",
+	description: "Links to the store's official social profiles, shown as a row of platform icons.",
+	schema: {
+		type: "object",
+		additionalProperties: false,
+		properties: {
+			heading: {
+				type: "string",
+				title: "Heading"
+			},
+			entries: {
+				type: "array",
+				title: "Social profiles",
+				minItems: 1,
+				items: {
+					type: "object",
+					additionalProperties: false,
+					required: ["label", "url"],
+					properties: {
+						platform: {
+							type: "string",
+							enum: [
+								"facebook",
+								"instagram",
+								"linkedin",
+								"pinterest",
+								"youtube"
+							],
+							title: "Platform"
+						},
+						url: {
+							type: "string",
+							minLength: 1,
+							title: "Profile URL",
+							format: "uri-reference",
+							pattern: "^(?:https?://.*|mailto:.+|tel:.+|/(?:[^/].*)?)$"
+						},
+						label: {
+							type: "string",
+							minLength: 1,
+							title: "Label"
+						},
+						iconUrl: {
+							type: "string",
+							format: "uri",
+							title: "Custom icon",
+							widget: { "ui:widget": "media-gallery" }
+						}
+					}
+				}
+			}
+		}
+	}
+});
+/**
+* The platform glyphs `platform` admits, every one verified to resolve. Exported because a store's
+* `global.json` has to list them under `icons.include` for a CMS-chosen name to resolve at runtime —
+* one import there instead of five retyped strings. Reading it off the model rather than declaring it
+* beside one makes the two impossible to drift apart.
+*/
+const SOCIAL_PLATFORM_NAMES = FooterSocialContent.schema.properties.entries.items.properties.platform.enum;
+const FooterSocialDefinition = defineComponent({
+	name: "FooterSocial",
+	importPath: "@vtex/faststore/components",
+	component: FooterSocial,
+	content: FooterSocialContent,
+	editor: {
+		label: "Footer Social",
+		category: "navigation"
+	},
+	schema: {
+		heading: {
+			type: "string",
+			label: "Heading"
+		},
+		entries: {
+			type: "array",
+			label: "Social profiles"
+		}
+	},
+	guideline: "The store's official social profiles as a row of icon links, both the heading and the list CMS-editable. Every link opens in a new tab. Every predefined platform name must be listed in the store's icons.include. See footer-social.md."
+});
+/**
+* Drops every entry that cannot render both a glyph and an accessible name, then vets what is left.
+* Neither read-time gate enforces `minLength`, so a blank label reaches the component, and `platform`
+* is optional so TikTok can arrive through `iconUrl` — which leaves an entry carrying neither, also
+* legal and also unrenderable. An icon with no name is the one thing F3 must not ship.
+*
+* Renderability is settled before the destination is looked at, so a dropped entry never logs: the
+* filter answers whether this is a social entry at all, and the destination only decides which form
+* it takes.
+*/
+function resolveEntries(entries) {
+	const resolved = [];
+	entries.forEach((entry, index) => {
+		if (!entry.label.trim() || !(entry.iconUrl?.trim() || entry.platform)) return;
+		const destination = resolveSafeHref(entry.url);
+		if (!destination.safe) console.warn("[FooterSocial] link destination rejected", {
+			index,
+			reason: destination.reason
+		});
+		const href = destination.safe ? destination.href : null;
+		if (entry.iconUrl?.trim()) resolved.push({
+			label: entry.label,
+			href,
+			platform: entry.platform,
+			src: entry.iconUrl
+		});
+		else if (entry.platform) resolved.push({
+			label: entry.label,
+			href,
+			platform: entry.platform
+		});
+	});
+	return resolved;
+}
+function FooterSocial({ heading, entries, $content, className, ...props }) {
+	const sectionHeading = $content?.heading ?? heading;
+	const resolved = resolveEntries($content?.entries ?? entries ?? []);
+	if (resolved.length === 0) return null;
+	const named = Boolean(sectionHeading?.trim());
+	return /* @__PURE__ */ jsxs("div", {
+		...props,
+		className,
+		"data-fs-footer-social": "",
+		children: [named ? /* @__PURE__ */ jsx("h3", {
+			"data-fs-text": "",
+			"data-fs-footer-social-heading": "",
+			children: sectionHeading
+		}) : null, /* @__PURE__ */ jsx("ul", {
+			role: "list",
+			"data-fs-footer-social-list": "",
+			"aria-label": named ? sectionHeading : void 0,
+			children: resolved.map((entry, index) => /* @__PURE__ */ jsx("li", {
+				"data-fs-footer-social-item": "",
+				"data-fs-footer-social-platform": entry.platform,
+				children: entry.href === null ? /* @__PURE__ */ jsx("span", {
+					"data-fs-text": "",
+					"data-fs-footer-social-text": "",
+					children: entry.label
+				}) : /* @__PURE__ */ jsx(NavigationLink, {
+					href: entry.href,
+					target: "_blank",
+					"data-fs-footer-social-link": "",
+					children: entry.src === void 0 ? /* @__PURE__ */ jsxs(Fragment, { children: [/* @__PURE__ */ jsx(Icon, {
+						name: entry.platform,
+						"data-fs-footer-social-icon": ""
+					}), /* @__PURE__ */ jsx("span", {
+						"data-fs-sr-only": "",
+						className: "sr-only",
+						children: entry.label
+					})] }) : /* @__PURE__ */ jsx(Image, {
+						src: entry.src,
+						alt: entry.label,
+						"data-fs-footer-social-icon": ""
+					})
+				})
+			}, index))
+		})]
+	});
+}
+//#endregion
+export { FooterSocial, FooterSocialContent, FooterSocialDefinition, SOCIAL_PLATFORM_NAMES };
+
+//# sourceMappingURL=footer-social.js.map

package/dist/particles/footer-social/footer-social.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"footer-social.js","names":[],"sources":["../../../src/particles/footer-social/footer-social.tsx"],"sourcesContent":["import { type ContentValue, defineComponent, defineContentType } from '@vtex/fs-core';\nimport type { ComponentPropsWithRef } from 'react';\nimport { resolveSafeHref } from '../../utils/safe-href.js';\nimport { Icon } from '../icon/icon.js';\nimport { Image } from '../image/image.js';\nimport { NavigationLink } from '../navigation-link/navigation-link.js';\n\n// ---------------------------------------------------------------------------\n// Content model\n// ---------------------------------------------------------------------------\n\nexport const FooterSocialContent = defineContentType({\n  id: 'footer-social',\n  title: 'Footer Social',\n  description: \"Links to the store's official social profiles, shown as a row of platform icons.\",\n  schema: {\n    type: 'object',\n    additionalProperties: false,\n    // Neither property is required. A missing element key already omits the component before any\n    // required check runs, so requiring them would buy nothing and cost the prop fallback: an entry\n    // authoring one field alone would be shape-invalid and take the whole element down with it.\n    properties: {\n      heading: { type: 'string', title: 'Heading' },\n      entries: {\n        type: 'array',\n        title: 'Social profiles',\n        // Author-time guidance only: no read-time gate enforces item bounds, so its one consumer is\n        // the Content Platform Admin's form. An empty list still reaches the component, which\n        // self-hides on it. No ceiling — a brand is on as many platforms as it is on.\n        minItems: 1,\n        items: {\n          type: 'object',\n          additionalProperties: false,\n          required: ['label', 'url'],\n          properties: {\n            // Inline rather than a named constant: the catalog scanner reads this file statically\n            // and rejects an identifier it cannot evaluate. `SOCIAL_PLATFORM_NAMES` derives from here.\n            // Every name resolves: facebook, instagram and pinterest through the base dialect's\n            // embedded floor, linkedin and youtube only through a provisioned lucide. No twitter —\n            // both vocabularies still draw the old bird, and an enum member cannot be narrowed once\n            // published, so Twitter/X rides iconUrl alongside TikTok and WhatsApp.\n            platform: {\n              type: 'string',\n              enum: ['facebook', 'instagram', 'linkedin', 'pinterest', 'youtube'],\n              title: 'Platform',\n            },\n            url: {\n              type: 'string',\n              minLength: 1,\n              title: 'Profile URL',\n              format: 'uri-reference',\n              // Author-time guidance only, and deliberately identical to FooterLinkGroup's: the Admin\n              // form must not reject a destination `resolveSafeHref` would have accepted. Lookahead-free\n              // because the Admin's regex engine may be an RE2 family that rejects lookahead outright.\n              pattern: '^(?:https?://.*|mailto:.+|tel:.+|/(?:[^/].*)?)$',\n            },\n            label: { type: 'string', minLength: 1, title: 'Label' },\n            iconUrl: {\n              type: 'string',\n              format: 'uri',\n              title: 'Custom icon',\n              widget: { 'ui:widget': 'media-gallery' },\n            },\n          },\n        },\n      },\n    },\n  },\n});\n\n/**\n * The platform glyphs `platform` admits, every one verified to resolve. Exported because a store's\n * `global.json` has to list them under `icons.include` for a CMS-chosen name to resolve at runtime —\n * one import there instead of five retyped strings. Reading it off the model rather than declaring it\n * beside one makes the two impossible to drift apart.\n */\nexport const SOCIAL_PLATFORM_NAMES = FooterSocialContent.schema.properties.entries.items.properties.platform.enum;\n\n// ---------------------------------------------------------------------------\n// Types\n// ---------------------------------------------------------------------------\n\ntype FooterSocialContentValue = ContentValue<typeof FooterSocialContent>;\n\n/** One profile in the row. Derived from the model so the prop and content channels cannot drift. */\nexport type FooterSocialEntry = NonNullable<FooterSocialContentValue['entries']>[number];\n\ntype SocialPlatformName = NonNullable<FooterSocialEntry['platform']>;\n\nexport type FooterSocialProps = ComponentPropsWithRef<'div'> & {\n  /** Authored fallback for the section heading, used when no CMS entry supplies one. */\n  heading?: string;\n  /** Authored fallback for the profile list, used when no CMS entry supplies one. */\n  entries?: readonly FooterSocialEntry[];\n  /** Injected by the compiler, sliced from the page's or layout's composite content entry. */\n  $content?: FooterSocialContentValue;\n};\n\n// ---------------------------------------------------------------------------\n// Definition\n// ---------------------------------------------------------------------------\n\nexport const FooterSocialDefinition = defineComponent({\n  name: 'FooterSocial',\n  importPath: '@vtex/faststore/components',\n  component: FooterSocial,\n  content: FooterSocialContent,\n  editor: { label: 'Footer Social', category: 'navigation' },\n  schema: {\n    heading: { type: 'string', label: 'Heading' },\n    entries: { type: 'array', label: 'Social profiles' },\n  },\n  guideline:\n    \"The store's official social profiles as a row of icon links, both the heading and the list CMS-editable. Every link opens in a new tab. Every predefined platform name must be listed in the store's icons.include. See footer-social.md.\",\n});\n\n// ---------------------------------------------------------------------------\n// Implementation\n// ---------------------------------------------------------------------------\n\n/**\n * An entry that can render: a non-blank label, one glyph source, and a destination the allowlist\n * either cleared or refused. The render branches on `href` first — a null one renders the label as\n * text and no glyph at all — so on that path the glyph source survives only to key the discriminator.\n */\ntype ResolvedEntry =\n  | { label: string; href: string | null; platform: SocialPlatformName; src?: undefined }\n  | { label: string; href: string | null; platform?: SocialPlatformName; src: string };\n\n/**\n * Drops every entry that cannot render both a glyph and an accessible name, then vets what is left.\n * Neither read-time gate enforces `minLength`, so a blank label reaches the component, and `platform`\n * is optional so TikTok can arrive through `iconUrl` — which leaves an entry carrying neither, also\n * legal and also unrenderable. An icon with no name is the one thing F3 must not ship.\n *\n * Renderability is settled before the destination is looked at, so a dropped entry never logs: the\n * filter answers whether this is a social entry at all, and the destination only decides which form\n * it takes.\n */\nfunction resolveEntries(entries: readonly FooterSocialEntry[]): ResolvedEntry[] {\n  const resolved: ResolvedEntry[] = [];\n\n  entries.forEach((entry, index) => {\n    if (!entry.label.trim() || !(entry.iconUrl?.trim() || entry.platform)) {\n      return;\n    }\n\n    const destination = resolveSafeHref(entry.url);\n    if (!destination.safe) {\n      // A bounded reason and no authored value, the convention the content runtime's own log follows.\n      console.warn('[FooterSocial] link destination rejected', { index, reason: destination.reason });\n    }\n    const href = destination.safe ? destination.href : null;\n\n    if (entry.iconUrl?.trim()) {\n      resolved.push({ label: entry.label, href, platform: entry.platform, src: entry.iconUrl });\n    } else if (entry.platform) {\n      resolved.push({ label: entry.label, href, platform: entry.platform });\n    }\n  });\n\n  return resolved;\n}\n\nexport function FooterSocial({ heading, entries, $content, className, ...props }: FooterSocialProps) {\n  const sectionHeading = $content?.heading ?? heading;\n  // An entry supplying `entries: []` beats an authored prop: a merchant who cleared the row cleared it.\n  const resolved = resolveEntries($content?.entries ?? entries ?? []);\n\n  if (resolved.length === 0) return null;\n\n  // A blank heading is unconfigured, not an empty value: no element and no group name, rather than\n  // an empty one. Trim to decide, never to render.\n  const named = Boolean(sectionHeading?.trim());\n\n  return (\n    <div {...props} className={className} data-fs-footer-social=\"\">\n      {named ? (\n        <h3 data-fs-text=\"\" data-fs-footer-social-heading=\"\">\n          {sectionHeading}\n        </h3>\n      ) : null}\n      {/* biome-ignore lint/a11y/noRedundantRoles: WebKit drops the implicit list role from a ul whose\n          computed `list-style` is `none` — exactly what this component's swatch sets — so the explicit\n          role is what holds the semantics the named list was chosen for. */}\n      <ul role=\"list\" data-fs-footer-social-list=\"\" aria-label={named ? sectionHeading : undefined}>\n        {resolved.map((entry, index) => (\n          <li key={index} data-fs-footer-social-item=\"\" data-fs-footer-social-platform={entry.platform}>\n            {entry.href === null ? (\n              <span data-fs-text=\"\" data-fs-footer-social-text=\"\">\n                {entry.label}\n              </span>\n            ) : (\n              <NavigationLink href={entry.href} target=\"_blank\" data-fs-footer-social-link=\"\">\n                {entry.src === undefined ? (\n                  <>\n                    <Icon name={entry.platform} data-fs-footer-social-icon=\"\" />\n                    <span data-fs-sr-only=\"\" className=\"sr-only\">\n                      {entry.label}\n                    </span>\n                  </>\n                ) : (\n                  <Image src={entry.src} alt={entry.label} data-fs-footer-social-icon=\"\" />\n                )}\n              </NavigationLink>\n            )}\n          </li>\n        ))}\n      </ul>\n    </div>\n  );\n}\n"],"mappings":"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"}

package/dist/particles/gallery/gallery.d.ts

@@ -0,0 +1,181 @@
+import { ComponentDefinition } from "../../core/dist/define-component.js";
+import "../../core/dist/index.js";
+import { ComponentPropsWithRef, ReactNode } from "react";
+//#region src/particles/gallery/gallery.d.ts
+export type GalleryMediaType = 'image' | 'video';
+export type GalleryMediaItem = {
+  type: GalleryMediaType;
+  url: string;
+  altText: string;
+  previewImageUrl?: string;
+};
+export type GalleryContextValue = {
+  media: GalleryMediaItem[];
+  selectedIndex: number;
+  setSelectedIndex: (index: number) => void;
+  fullscreenOpen: boolean;
+  openFullscreen: () => void;
+  closeFullscreen: () => void;
+  selectOnHover: boolean;
+  thumbnailOpensFullscreen: boolean;
+  zoomActive: boolean;
+  setZoomActive: (active: boolean) => void;
+  zoomPosition: {
+    x: number;
+    y: number;
+  };
+  setZoomPosition: (pos: {
+    x: number;
+    y: number;
+  }) => void;
+  magnification: number;
+  lensSize: number;
+  setZoomConfig: (config: {
+    magnification: number;
+    lensSize: number;
+  }) => void;
+  zoomContainerSize: {
+    width: number;
+    height: number;
+  };
+  setZoomContainerSize: (size: {
+    width: number;
+    height: number;
+  }) => void;
+  thumbnailOffset: number;
+  setThumbnailOffset: (offset: number) => void;
+  thumbnailsWindowSize: number;
+  setThumbnailsWindowSize: (size: number) => void;
+};
+export type GalleryItemContextValue = {
+  item: GalleryMediaItem;
+  index: number;
+  isOverflow: boolean;
+  overflowCount: number;
+};
+export type GalleryRootProps = ComponentPropsWithRef<'div'> & {
+  media?: GalleryMediaItem[];
+  defaultIndex?: number;
+  selectOnHover?: boolean;
+  thumbnailOpensFullscreen?: boolean;
+};
+export type GalleryMainMediaProps = ComponentPropsWithRef<'div'> & {
+  objectFit?: 'contain' | 'cover' | 'fill' | 'none';
+  aspectRatio?: string;
+  videoAutoPlay?: boolean;
+  videoControls?: boolean;
+  clickOpensFullscreen?: boolean;
+};
+export type GalleryThumbnailsProps = ComponentPropsWithRef<'div'> & {
+  maxVisible?: number;
+  slider?: boolean;
+  animated?: boolean;
+  direction?: 'horizontal' | 'vertical';
+  hideWhenSingle?: boolean;
+  children?: ReactNode;
+};
+export type GalleryThumbnailsPreviousProps = ComponentPropsWithRef<'button'> & {
+  children?: ReactNode;
+  step?: number;
+};
+export type GalleryThumbnailsNextProps = ComponentPropsWithRef<'button'> & {
+  children?: ReactNode;
+  step?: number;
+};
+export type GalleryThumbnailProps = ComponentPropsWithRef<'button'> & {
+  objectFit?: 'contain' | 'cover' | 'fill' | 'none';
+  aspectRatio?: string;
+};
+export type GalleryOverflowCountProps = ComponentPropsWithRef<'button'> & {
+  template?: string;
+  ariaLabel?: string;
+};
+export type GalleryMediaProps = ComponentPropsWithRef<'div'> & {
+  objectFit?: 'contain' | 'cover' | 'fill' | 'none';
+  aspectRatio?: string;
+  videoAutoPlay?: boolean;
+  videoControls?: boolean;
+  clickOpensFullscreen?: boolean;
+};
+export type GalleryZoomProps = ComponentPropsWithRef<'div'> & {
+  magnification?: number;
+  lensSize?: number;
+};
+export type GalleryZoomLensProps = ComponentPropsWithRef<'div'>;
+export type GalleryZoomResultProps = ComponentPropsWithRef<'div'>;
+export type GalleryFullscreenProps = ComponentPropsWithRef<'div'> & {
+  children?: ReactNode;
+};
+export type GalleryFullscreenTitleProps = ComponentPropsWithRef<'h2'>;
+export type GalleryFullscreenCloseProps = ComponentPropsWithRef<'button'> & {
+  children?: ReactNode;
+};
+export type GalleryPreviousProps = ComponentPropsWithRef<'button'> & {
+  children?: ReactNode;
+  wrap?: boolean;
+};
+export type GalleryNextProps = ComponentPropsWithRef<'button'> & {
+  children?: ReactNode;
+  wrap?: boolean;
+};
+export type GalleryMediaCountProps = ComponentPropsWithRef<'span'> & {
+  template?: string;
+};
+export declare const GalleryItemContext: import("react").Context<GalleryItemContextValue | null>;
+export declare function useGallery(): GalleryContextValue;
+export declare function useGalleryItem(): GalleryItemContextValue;
+export declare const GalleryRootDefinition: ComponentDefinition<GalleryRootProps>;
+export declare const GalleryMainMediaDefinition: ComponentDefinition<GalleryMainMediaProps>;
+export declare const GalleryThumbnailsDefinition: ComponentDefinition<GalleryThumbnailsProps>;
+export declare const GalleryThumbnailsPreviousDefinition: ComponentDefinition<GalleryThumbnailsPreviousProps>;
+export declare const GalleryThumbnailsNextDefinition: ComponentDefinition<GalleryThumbnailsNextProps>;
+export declare const GalleryThumbnailDefinition: ComponentDefinition<GalleryThumbnailProps>;
+export declare const GalleryOverflowCountDefinition: ComponentDefinition<GalleryOverflowCountProps>;
+export declare const GalleryMediaDefinition: ComponentDefinition<GalleryMediaProps>;
+export declare const GalleryZoomDefinition: ComponentDefinition<GalleryZoomProps>;
+export declare const GalleryZoomLensDefinition: ComponentDefinition<import("react").DetailedHTMLProps<import("react").HTMLAttributes<HTMLDivElement>, HTMLDivElement>>;
+export declare const GalleryZoomResultDefinition: ComponentDefinition<import("react").DetailedHTMLProps<import("react").HTMLAttributes<HTMLDivElement>, HTMLDivElement>>;
+export declare const GalleryFullscreenDefinition: ComponentDefinition<GalleryFullscreenProps>;
+export declare const GalleryFullscreenTitleDefinition: ComponentDefinition<import("react").DetailedHTMLProps<import("react").HTMLAttributes<HTMLHeadingElement>, HTMLHeadingElement>>;
+export declare const GalleryFullscreenCloseDefinition: ComponentDefinition<GalleryFullscreenCloseProps>;
+export declare const GalleryPreviousDefinition: ComponentDefinition<GalleryPreviousProps>;
+export declare const GalleryNextDefinition: ComponentDefinition<GalleryNextProps>;
+export declare const GalleryMediaCountDefinition: ComponentDefinition<GalleryMediaCountProps>;
+export declare function GalleryRoot({ media, defaultIndex, selectOnHover, thumbnailOpensFullscreen, children, ...props }: GalleryRootProps): import("react/jsx-runtime").JSX.Element;
+export declare function GalleryMainMedia({ objectFit, aspectRatio, videoAutoPlay, videoControls, clickOpensFullscreen, style, ...props }: GalleryMainMediaProps): import("react/jsx-runtime").JSX.Element;
+export declare function GalleryThumbnails({ hideWhenSingle, ...rest }: GalleryThumbnailsProps): import("react/jsx-runtime").JSX.Element | null;
+export declare function GalleryThumbnail({ objectFit, aspectRatio, style, ...props }: GalleryThumbnailProps): import("react/jsx-runtime").JSX.Element;
+export declare function GalleryOverflowCount({ template, ariaLabel, ...props }: GalleryOverflowCountProps): import("react/jsx-runtime").JSX.Element | null;
+export declare function GalleryMedia({ objectFit, aspectRatio, videoAutoPlay, videoControls, clickOpensFullscreen, style, ...props }: GalleryMediaProps): import("react/jsx-runtime").JSX.Element;
+export declare function GalleryZoom({ magnification, lensSize, children, ...props }: GalleryZoomProps): import("react/jsx-runtime").JSX.Element;
+export declare function GalleryZoomLens({ style, ...props }: GalleryZoomLensProps): import("react/jsx-runtime").JSX.Element | null;
+export declare function GalleryZoomResult({ style, ...props }: GalleryZoomResultProps): import("react/jsx-runtime").JSX.Element;
+export declare function GalleryFullscreen({ children, ...props }: GalleryFullscreenProps): import("react/jsx-runtime").JSX.Element;
+export declare function GalleryFullscreenTitle({ children, ...props }: GalleryFullscreenTitleProps): import("react/jsx-runtime").JSX.Element;
+export declare function GalleryFullscreenClose({ children, ...props }: GalleryFullscreenCloseProps): import("react/jsx-runtime").JSX.Element;
+export declare function GalleryPrevious({ children, wrap, ...props }: GalleryPreviousProps): import("react/jsx-runtime").JSX.Element;
+export declare function GalleryNext({ children, wrap, ...props }: GalleryNextProps): import("react/jsx-runtime").JSX.Element;
+export declare function GalleryThumbnailsPrevious({ step, children, ...props }: GalleryThumbnailsPreviousProps): import("react/jsx-runtime").JSX.Element;
+export declare function GalleryThumbnailsNext({ step, children, ...props }: GalleryThumbnailsNextProps): import("react/jsx-runtime").JSX.Element;
+export declare function GalleryMediaCount({ template, ...props }: GalleryMediaCountProps): import("react/jsx-runtime").JSX.Element;
+export declare const Gallery: {
+  Root: typeof GalleryRoot;
+  MainMedia: typeof GalleryMainMedia;
+  Media: typeof GalleryMedia;
+  Thumbnails: typeof GalleryThumbnails;
+  ThumbnailsPrevious: typeof GalleryThumbnailsPrevious;
+  ThumbnailsNext: typeof GalleryThumbnailsNext;
+  Thumbnail: typeof GalleryThumbnail;
+  OverflowCount: typeof GalleryOverflowCount;
+  Zoom: typeof GalleryZoom;
+  ZoomLens: typeof GalleryZoomLens;
+  ZoomResult: typeof GalleryZoomResult;
+  Fullscreen: typeof GalleryFullscreen;
+  FullscreenTitle: typeof GalleryFullscreenTitle;
+  FullscreenClose: typeof GalleryFullscreenClose;
+  Previous: typeof GalleryPrevious;
+  Next: typeof GalleryNext;
+  MediaCount: typeof GalleryMediaCount;
+};
+//#endregion
+//# sourceMappingURL=gallery.d.ts.map