react-datocms 8.0.0-0 → 8.0.0

package/dist/esm/VideoPlayer/index.js

@@ -1,4 +1,4 @@
-"use client";
+'use client';
 var __rest = (this && this.__rest) || function (s, e) {
     var t = {};
     for (var p in s) if (Object.prototype.hasOwnProperty.call(s, p) && e.indexOf(p) < 0)
@@ -17,22 +17,43 @@ var __rest = (this && this.__rest) || function (s, e) {
 // The React player written by MUX is an adapter for a web component.
 //
 // [1]: https://www.mux.com/player
-import React, { forwardRef } from "react";
+import React, { forwardRef } from 'react';
 // React MUX player is made available in two flavours: eager and lazy loaded. We
-// choose to use the eager loading version as the default approch, but
-// we also provide a lazy loading version..
-import MuxPlayer from "@mux/mux-player-react";
+// choose to use the lazy version to avoid loading the web component uselessly.
+// MUX player lazy version loads internally the eager version using
+// `React.lazy()`.
+import MuxPlayer from '@mux/mux-player-react/lazy';
 // The core of this component is the `useVideoPlayer` hook: it takes
 // data from DatoCMS GraphQL API and returns props as expected by the
 // `<MuxPlayer />` component.
-import { useVideoPlayer } from "../useVideoPlayer/index.js";
+import { decodeStega } from '@datocms/content-link';
+import { useVideoPlayer } from '../useVideoPlayer/index.js';
 export const VideoPlayer = forwardRef((props, ref) => {
-    const { data = {}, disableCookies = true, preload = "metadata", style: styleFromProps } = props, rest = __rest(props, ["data", "disableCookies", "preload", "style"]);
+    const { data = {}, disableCookies = true, disableTracking = true, preload = 'metadata', style: styleFromProps } = props, rest = __rest(props, ["data", "disableCookies", "disableTracking", "preload", "style"]);
     const { title, playbackId, style: styleFromHook, placeholder, } = useVideoPlayer({
         data,
     });
     const style = Object.assign(Object.assign({}, styleFromHook), styleFromProps);
-    return (React.createElement(MuxPlayer, Object.assign({ ref: ref, streamType: "on-demand", preload: preload, title: title, disableCookies: disableCookies, playbackId: playbackId, style: style, placeholder: placeholder }, rest)));
+    // Extract alt for DatoCMS Content Link integration
+    // See: https://github.com/datocms/content-link
+    const { alt } = data;
+    // Only include data-datocms-content-link-source if alt contains stega encoding
+    const contentLinkSource = alt && decodeStega(alt) ? alt : undefined;
+    // Note: Custom data-* attributes can be passed to the underlying <mux-player> web component
+    // in two ways:
+    //
+    // 1. Kebab-case (passes through as-is):
+    //    <VideoPlayer data-player-id="my-player" />
+    //
+    // 2. CamelCase (auto-converts to kebab-case):
+    //    <VideoPlayer dataPlayerId="my-player" />
+    //
+    // Both result in: <mux-player data-player-id="my-player">
+    //
+    // The MuxPlayer React component transforms camelCase props to kebab-case to match
+    // web component attribute conventions. Any props not explicitly handled by VideoPlayer
+    // are spread via {...rest} and forwarded to MuxPlayer, which then applies them to
+    // the underlying <mux-player> element.
+    return (React.createElement(MuxPlayer, Object.assign({ ref: ref, streamType: "on-demand", preload: preload, title: title, disableCookies: disableCookies, disableTracking: disableTracking, playbackId: playbackId, style: style, placeholder: placeholder, "data-datocms-content-link-source": contentLinkSource }, rest)));
 });
-export default VideoPlayer;
 //# sourceMappingURL=index.js.map

package/dist/esm/VideoPlayer/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/VideoPlayer/index.tsx"],"names":[],"mappings":"AAAA,YAAY,CAAC;;;;;;;;;;;;AAEb,gFAAgF;AAChF,8EAA8E;AAC9E,2EAA2E;AAC3E,EAAE;AACF,qEAAqE;AACrE,EAAE;AACF,kCAAkC;AAElC,OAAO,KAAK,EAAE,EAAE,UAAU,EAAE,MAAM,OAAO,CAAC;AAO1C,gFAAgF;AAChF,sEAAsE;AACtE,2CAA2C;AAE3C,OAAO,SAAS,MAAM,uBAAuB,CAAC;AAE9C,oEAAoE;AACpE,qEAAqE;AACrE,6BAA6B;AAE7B,OAAO,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC;AAyC5D,MAAM,CAAC,MAAM,WAAW,GAAoB,UAAU,CAGpD,CAAC,KAAuB,EAAE,GAAG,EAAE,EAAE;IACjC,MAAM,EACJ,IAAI,GAAG,EAAE,EACT,cAAc,GAAG,IAAI,EACrB,OAAO,GAAG,UAAU,EACpB,KAAK,EAAE,cAAc,KAEnB,KAAK,EADJ,IAAI,UACL,KAAK,EANH,8CAML,CAAQ,CAAC;IAEV,MAAM,EACJ,KAAK,EACL,UAAU,EACV,KAAK,EAAE,aAAa,EACpB,WAAW,GACZ,GAAG,cAAc,CAAC;QACjB,IAAI;KACL,CAAC,CAAC;IAEH,MAAM,KAAK,mCACN,aAAa,GACb,cAAc,CAClB,CAAC;IAEF,OAAO,CACL,oBAAC,SAAS,kBACR,GAAG,EAAE,GAAG,EACR,UAAU,EAAC,WAAW,EACtB,OAAO,EAAE,OAAO,EAChB,KAAK,EAAE,KAAK,EACZ,cAAc,EAAE,cAAc,EAC9B,UAAU,EAAE,UAAU,EACtB,KAAK,EAAE,KAAK,EACZ,WAAW,EAAE,WAAW,IACpB,IAAI,EACR,CACH,CAAC;AACJ,CAAC,CAAC,CAAC;AAEH,eAAe,WAAW,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/VideoPlayer/index.tsx"],"names":[],"mappings":"AAAA,YAAY,CAAC;;;;;;;;;;;;AAEb,gFAAgF;AAChF,8EAA8E;AAC9E,2EAA2E;AAC3E,EAAE;AACF,qEAAqE;AACrE,EAAE;AACF,kCAAkC;AAElC,OAAO,KAAK,EAAE,EAAE,UAAU,EAAE,MAAM,OAAO,CAAC;AAO1C,gFAAgF;AAChF,+EAA+E;AAC/E,mEAAmE;AACnE,kBAAkB;AAElB,OAAO,SAAS,MAAM,4BAA4B,CAAC;AAEnD,oEAAoE;AACpE,qEAAqE;AACrE,6BAA6B;AAE7B,OAAO,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AACpD,OAAO,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC;AAuC5D,MAAM,CAAC,MAAM,WAAW,GAEY,UAAU,CAG5C,CAAC,KAAK,EAAE,GAAG,EAAE,EAAE;IACf,MAAM,EACJ,IAAI,GAAG,EAAE,EACT,cAAc,GAAG,IAAI,EACrB,eAAe,GAAG,IAAI,EACtB,OAAO,GAAG,UAAU,EACpB,KAAK,EAAE,cAAc,KAEnB,KAAK,EADJ,IAAI,UACL,KAAK,EAPH,iEAOL,CAAQ,CAAC;IAEV,MAAM,EACJ,KAAK,EACL,UAAU,EACV,KAAK,EAAE,aAAa,EACpB,WAAW,GACZ,GAAG,cAAc,CAAC;QACjB,IAAI;KACL,CAAC,CAAC;IAEH,MAAM,KAAK,mCACN,aAAa,GACb,cAAc,CAClB,CAAC;IAEF,mDAAmD;IACnD,+CAA+C;IAC/C,MAAM,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC;IAErB,+EAA+E;IAC/E,MAAM,iBAAiB,GAAG,GAAG,IAAI,WAAW,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,SAAS,CAAC;IAEpE,4FAA4F;IAC5F,eAAe;IACf,EAAE;IACF,wCAAwC;IACxC,gDAAgD;IAChD,EAAE;IACF,8CAA8C;IAC9C,8CAA8C;IAC9C,EAAE;IACF,0DAA0D;IAC1D,EAAE;IACF,kFAAkF;IAClF,uFAAuF;IACvF,kFAAkF;IAClF,uCAAuC;IAEvC,OAAO,CACL,oBAAC,SAAS,kBACR,GAAG,EAAE,GAAG,EACR,UAAU,EAAC,WAAW,EACtB,OAAO,EAAE,OAAO,EAChB,KAAK,EAAE,KAAK,EACZ,cAAc,EAAE,cAAc,EAC9B,eAAe,EAAE,eAAe,EAChC,UAAU,EAAE,UAAU,EACtB,KAAK,EAAE,KAAK,EACZ,WAAW,EAAE,WAAW,sCACU,iBAAiB,IAC/C,IAAI,EACR,CACH,CAAC;AACJ,CAAC,CAAC,CAAC"}

package/dist/esm/index.js

@@ -6,4 +6,6 @@ export * from './VideoPlayer/index.js';
 export * from './useQuerySubscription/index.js';
 export * from './useSiteSearch/index.js';
 export * from './useVideoPlayer/index.js';
+export * from './ContentLink/index.js';
+export * from './useContentLink/index.js';
 //# sourceMappingURL=index.js.map

package/dist/esm/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,kBAAkB,CAAC;AACjC,cAAc,qBAAqB,CAAC;AACpC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,2BAA2B,CAAC;AAC1C,cAAc,wBAAwB,CAAC;AAEvC,cAAc,iCAAiC,CAAC;AAChD,cAAc,0BAA0B,CAAC;AACzC,cAAc,2BAA2B,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,kBAAkB,CAAC;AACjC,cAAc,qBAAqB,CAAC;AACpC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,2BAA2B,CAAC;AAC1C,cAAc,wBAAwB,CAAC;AAEvC,cAAc,iCAAiC,CAAC;AAChD,cAAc,0BAA0B,CAAC;AACzC,cAAc,2BAA2B,CAAC;AAE1C,cAAc,wBAAwB,CAAC;AACvC,cAAc,2BAA2B,CAAC"}

package/dist/esm/useContentLink/index.js

@@ -0,0 +1,105 @@
+'use client';
+import { createController } from '@datocms/content-link';
+import { useCallback, useEffect, useRef } from 'react';
+// Re-export types and utilities from @datocms/content-link for convenience
+export { decodeStega, stripStega } from '@datocms/content-link';
+/**
+ * Hook to control the ContentLink controller for Visual Editing.
+ *
+ * This hook provides low-level access to the @datocms/content-link controller,
+ * allowing you to programmatically control click-to-edit overlays and
+ * communicate with the DatoCMS Web Previews plugin.
+ *
+ * @param options - Configuration options for the controller
+ * @returns An object containing the controller instance and its methods
+ *
+ * @example
+ * ```tsx
+ * import { useContentLink } from 'react-datocms';
+ *
+ * function MyComponent() {
+ *   const { enableClickToEdit, flashAll } = useContentLink({
+ *     onNavigateTo: (path) => router.push(path),
+ *   });
+ *
+ *   return (
+ *     <button onClick={() => enableClickToEdit({ scrollToNearestTarget: true })}>
+ *       Enable Editing
+ *     </button>
+ *   );
+ * }
+ * ```
+ */
+export function useContentLink(options = {}) {
+    const { enabled = true, onNavigateTo, root } = options;
+    const controllerRef = useRef(null);
+    // Store the callback in a ref to avoid recreating the controller when it changes
+    const onNavigateToRef = useRef(onNavigateTo);
+    // Keep the callback ref up to date
+    useEffect(() => {
+        onNavigateToRef.current = onNavigateTo;
+    }, [onNavigateTo]);
+    // Create/dispose controller based on enabled flag and root only
+    // The onNavigateTo callback is accessed via ref, so changes don't trigger recreation
+    useEffect(() => {
+        // Check if controller is disabled
+        const isEnabled = enabled === true || (typeof enabled === 'object' && enabled !== null);
+        if (!isEnabled) {
+            if (controllerRef.current) {
+                controllerRef.current.dispose();
+                controllerRef.current = null;
+            }
+            return;
+        }
+        // Extract stripStega option if enabled is an object
+        const stripStega = typeof enabled === 'object' ? enabled.stripStega : false;
+        const controller = createController({
+            onNavigateTo: (path) => { var _a; return (_a = onNavigateToRef.current) === null || _a === void 0 ? void 0 : _a.call(onNavigateToRef, path); },
+            root: (root === null || root === void 0 ? void 0 : root.current) || undefined,
+            stripStega,
+        });
+        controllerRef.current = controller;
+        return () => {
+            controller.dispose();
+            controllerRef.current = null;
+        };
+    }, [enabled, root]);
+    // Stable method references that call through to the controller
+    const enableClickToEdit = useCallback((opts) => {
+        var _a;
+        // If hoverOnly is true, check if the device supports hover
+        if ((opts === null || opts === void 0 ? void 0 : opts.hoverOnly) &&
+            (typeof window === 'undefined' ||
+                !window.matchMedia('(hover: hover)').matches)) {
+            return;
+        }
+        (_a = controllerRef.current) === null || _a === void 0 ? void 0 : _a.enableClickToEdit((opts === null || opts === void 0 ? void 0 : opts.scrollToNearestTarget)
+            ? { scrollToNearestTarget: opts.scrollToNearestTarget }
+            : undefined);
+    }, []);
+    const disableClickToEdit = useCallback(() => {
+        var _a;
+        (_a = controllerRef.current) === null || _a === void 0 ? void 0 : _a.disableClickToEdit();
+    }, []);
+    const isClickToEditEnabled = useCallback(() => {
+        var _a, _b;
+        return (_b = (_a = controllerRef.current) === null || _a === void 0 ? void 0 : _a.isClickToEditEnabled()) !== null && _b !== void 0 ? _b : false;
+    }, []);
+    const flashAll = useCallback((scrollToNearestTarget) => {
+        var _a;
+        (_a = controllerRef.current) === null || _a === void 0 ? void 0 : _a.flashAll(scrollToNearestTarget);
+    }, []);
+    const setCurrentPath = useCallback((path) => {
+        var _a;
+        (_a = controllerRef.current) === null || _a === void 0 ? void 0 : _a.setCurrentPath(path);
+    }, []);
+    return {
+        controller: controllerRef.current,
+        enableClickToEdit,
+        disableClickToEdit,
+        isClickToEditEnabled,
+        flashAll,
+        setCurrentPath,
+    };
+}
+//# sourceMappingURL=index.js.map

package/dist/esm/useContentLink/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/useContentLink/index.ts"],"names":[],"mappings":"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"}

package/dist/esm/useSiteSearch/index.js

@@ -37,19 +37,12 @@ export function useSiteSearch(config) {
                 }
                 setResponse(undefined);
                 const request = {
-                    filter: {
-                        query: state.query,
-                        locale: state.locale,
-                        build_trigger_id: config.buildTriggerId,
-                    },
+                    filter: Object.assign({ query: state.query, locale: state.locale, build_trigger_id: config.buildTriggerId, search_index_id: config.searchIndexId }, (config.fuzzySearch === true ? { fuzzy: true } : {})),
                     page: {
                         limit: resultsPerPage,
                         offset: resultsPerPage * state.page,
                     },
                 };
-                if (config.fuzzySearch) {
-                    request.fuzzy = 'true';
-                }
                 const response = yield config.client.searchResults.rawList(request);
                 if (!isCancelled) {
                     setResponse(response);
@@ -75,6 +68,7 @@ export function useSiteSearch(config) {
         resultsPerPage,
         state,
         config.buildTriggerId,
+        config.searchIndexId,
         config.fuzzySearch,
         config.client.config.apiToken,
     ]);

package/dist/esm/useSiteSearch/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/useSiteSearch/index.tsx"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/useSiteSearch/index.tsx"],"names":[],"mappings":"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"}

package/dist/types/ContentLink/index.d.ts

@@ -0,0 +1,88 @@
+import { type ClickToEditOptions, type UseContentLinkOptions } from '../useContentLink/index.js';
+export type ContentLinkProps = Omit<UseContentLinkOptions, 'enabled'> & {
+    /** Current pathname to sync with Web Previews plugin */
+    currentPath?: string;
+    /**
+     * Whether to enable click-to-edit overlays on mount, or options to configure them.
+     *
+     * - `true`: Enable click-to-edit mode immediately
+     * - `{ scrollToNearestTarget: true }`: Enable and scroll to nearest editable if none visible
+     * - `{ hoverOnly: true }`: Only enable on devices with hover capability (non-touch)
+     * - `false`/`undefined`: Don't enable automatically (use Alt/Option key to toggle)
+     *
+     * @example
+     * ```tsx
+     * <ContentLink enableClickToEdit={true} />
+     * <ContentLink enableClickToEdit={{ scrollToNearestTarget: true }} />
+     * <ContentLink enableClickToEdit={{ hoverOnly: true, scrollToNearestTarget: true }} />
+     * ```
+     */
+    enableClickToEdit?: boolean | ClickToEditOptions;
+    /** Whether to strip stega encoding from text nodes after stamping. */
+    stripStega?: boolean;
+};
+/**
+ * ContentLink component for Visual Editing with DatoCMS.
+ *
+ * This component enables Visual Editing by:
+ * - Detecting stega-encoded metadata in content and creating click-to-edit overlays
+ * - Integrating with DatoCMS Web Previews plugin for in-editor editing
+ * - Supporting Alt/Option key for temporary click-to-edit mode
+ * - Providing bidirectional communication between preview and DatoCMS editor
+ *
+ * ## Basic Usage (Standalone Website with Click-to-Edit)
+ *
+ * For standalone websites with click-to-edit overlays:
+ *
+ * ```tsx
+ * import { ContentLink } from 'react-datocms';
+ *
+ * function App() {
+ *   return (
+ *     <>
+ *       <ContentLink enableClickToEdit={true} />
+ *       {/* Your content with stega-encoded data *\/}
+ *     </>
+ *   );
+ * }
+ * ```
+ *
+ * ## Web Previews Plugin Integration (Next.js Example)
+ *
+ * For integration with DatoCMS Web Previews plugin, provide navigation callbacks:
+ *
+ * ```tsx
+ * 'use client';
+ * import { ContentLink } from 'react-datocms';
+ * import { useRouter, usePathname } from 'next/navigation';
+ *
+ * export function VisualEditing() {
+ *   const router = useRouter();
+ *   const pathname = usePathname();
+ *
+ *   return (
+ *     <ContentLink
+ *       onNavigateTo={(path) => router.push(path)}
+ *       currentPath={pathname}
+ *     />
+ *   );
+ * }
+ * ```
+ *
+ * ## How Visual Editing Works
+ *
+ * 1. **Fetch content with stega encoding**: Use the `contentLink` and `baseEditingUrl` options
+ *    when fetching content from DatoCMS to embed editing metadata.
+ *
+ * 2. **Add ContentLink component**: Place this component in your app to scan for encoded
+ *    content and create overlays.
+ *
+ * 3. **Enable editing**: Either set `enableClickToEdit={true}` prop or hold Alt/Option key
+ *    for temporary editing mode.
+ *
+ * 4. **Click to edit**: Click on any content to open the DatoCMS editor at that field.
+ *
+ * @param props - Configuration props for ContentLink
+ * @returns null - This component has no visual output
+ */
+export declare function ContentLink(props: ContentLinkProps): null;

package/dist/types/Image/index.d.ts

@@ -1,4 +1,4 @@
-import React from 'react';
+import React, { HTMLAttributeReferrerPolicy } from 'react';
 import { type CSSProperties } from 'react';
 type Maybe<T> = T | null;
 export type ResponsiveImageType = {
@@ -91,6 +91,13 @@ export type ImagePropTypes = {
      * Default candidate multipliers are [0.25, 0.5, 0.75, 1, 1.5, 2, 3, 4]
      **/
     srcSetCandidates?: number[];
+    /**
+     * Defines which referrer is sent when fetching the image
+     * Read more: https://developer.mozilla.org/en-US/docs/Web/HTML/Element/img#referrerpolicy
+     *
+     * Defaults to `no-referrer-when-downgrade` to give more useful stats in DatoCMS Project Usages
+     **/
+    referrerPolicy?: HTMLAttributeReferrerPolicy;
 };
 export declare const Image: React.ForwardRefExoticComponent<ImagePropTypes & React.RefAttributes<HTMLDivElement>>;
 export {};

package/dist/types/Image/utils.d.ts

@@ -1,4 +1,3 @@
-/// <reference types="react" />
 export declare const isSsr: boolean;
 export declare const isIntersectionObserverAvailable: boolean;
 export declare const universalBtoa: (str: string) => string;

package/dist/types/SRCImage/index.d.ts

@@ -1,5 +1,5 @@
-import React from 'react';
-import type { ResponsiveImageType } from '../Image';
+import React, { HTMLAttributeReferrerPolicy } from 'react';
+import type { ResponsiveImageType } from '../Image/index.js';
 export type SRCImagePropTypes = {
     /** The actual response you get from a DatoCMS `responsiveImage` GraphQL query */
     data: ResponsiveImageType;
@@ -33,5 +33,12 @@ export type SRCImagePropTypes = {
      * Default candidate multipliers are [0.25, 0.5, 0.75, 1, 1.5, 2, 3, 4]
      **/
     srcSetCandidates?: number[];
+    /**
+     * Defines which referrer is sent when fetching the image
+     * Read more: https://developer.mozilla.org/en-US/docs/Web/HTML/Element/img#referrerpolicy
+     *
+     * Defaults to `no-referrer-when-downgrade` to give more useful stats in DatoCMS Project Usages
+     **/
+    referrerPolicy?: HTMLAttributeReferrerPolicy;
 };
-export declare function SRCImage({ pictureClassName, pictureStyle, imgClassName, imgStyle, data, usePlaceholder, priority, sizes, srcSetCandidates, }: SRCImagePropTypes): JSX.Element;
+export declare function SRCImage({ pictureClassName, pictureStyle, imgClassName, imgStyle, data, usePlaceholder, priority, sizes, srcSetCandidates, referrerPolicy, }: SRCImagePropTypes): JSX.Element;

package/dist/types/SRCImage/utils.d.ts

@@ -1,5 +1,4 @@
-/// <reference types="react" />
-import type { ResponsiveImageType } from '../Image';
+import type { ResponsiveImageType } from '../Image/index.js';
 export declare function priorityProp(fetchPriority?: string): Record<string, string | undefined>;
 export declare const buildSrcSetFromSrc: (src: string | null | undefined, width: number | undefined, candidateMultipliers: number[]) => string | undefined;
 export declare function buildWebpSource(data: ResponsiveImageType, sizes: HTMLImageElement['sizes'] | undefined): "" | JSX.Element | null | undefined;

package/dist/types/Seo/renderMetaTags.d.ts

@@ -1,3 +1,2 @@
-/// <reference types="react" />
 import type { SeoOrFaviconTag, TitleMetaLinkTag } from './types.js';
 export declare function renderMetaTags(data: TitleMetaLinkTag[] | SeoOrFaviconTag[]): JSX.Element[];

package/dist/types/StructuredText/index.d.ts

@@ -1,9 +1,8 @@
 import { type RenderMarkRule, type TransformMetaFn, type TransformedMeta, renderMarkRule, renderNodeRule } from 'datocms-structured-text-generic-html-renderer';
-import { type Node, RenderError, type RenderResult, type RenderRule, type Document as StructuredTextDocument, type StructuredText as StructuredTextGraphQlResponse, type Record as StructuredTextGraphQlResponseRecord, type TypesafeStructuredText as TypesafeStructuredTextGraphQlResponse } from 'datocms-structured-text-utils';
+import { type CdaStructuredTextRecord, type CdaStructuredTextValue, type Node, RenderError, type RenderResult, type RenderRule, type Document as StructuredTextDocument, type StructuredText as StructuredTextGraphQlResponse, type Record as StructuredTextGraphQlResponseRecord, type TypesafeCdaStructuredTextValue, type TypesafeStructuredText as TypesafeStructuredTextGraphQlResponse } from 'datocms-structured-text-utils';
 import { type ReactElement } from 'react';
 export { renderNodeRule, renderMarkRule, RenderError };
-export { renderNodeRule as renderRule };
-export type { StructuredTextGraphQlResponse, TypesafeStructuredTextGraphQlResponse, StructuredTextDocument, StructuredTextGraphQlResponseRecord, };
+export type { StructuredTextDocument, CdaStructuredTextValue, TypesafeCdaStructuredTextValue, CdaStructuredTextRecord, };
 type AdapterReturn = ReactElement | string | null;
 export declare const defaultAdapter: {
     renderNode: (...args: any) => AdapterReturn;
@@ -25,19 +24,21 @@ export type RenderRecordLinkContext<R extends StructuredTextGraphQlResponseRecor
 export type RenderBlockContext<R extends StructuredTextGraphQlResponseRecord> = {
     record: R;
 };
-export type StructuredTextPropTypes<R1 extends StructuredTextGraphQlResponseRecord, R2 extends StructuredTextGraphQlResponseRecord = R1> = {
+export type StructuredTextPropTypes<BlockRecord extends StructuredTextGraphQlResponseRecord = StructuredTextGraphQlResponseRecord, LinkRecord extends StructuredTextGraphQlResponseRecord = StructuredTextGraphQlResponseRecord, InlineBlockRecord extends StructuredTextGraphQlResponseRecord = StructuredTextGraphQlResponseRecord> = {
     /** The actual field value you get from DatoCMS **/
-    data: StructuredTextGraphQlResponse<R1, R2> | StructuredTextDocument | Node | null | undefined;
+    data: StructuredTextGraphQlResponse<BlockRecord, LinkRecord, InlineBlockRecord> | StructuredTextDocument | Node | null | undefined;
     /** A set of additional rules to convert nodes to JSX **/
     customNodeRules?: RenderRule<H, T, F>[];
     /** A set of additional rules to convert marks to JSX **/
     customMarkRules?: RenderMarkRule<H, T, F>[];
     /** Fuction that converts an 'inlineItem' node into React **/
-    renderInlineRecord?: (context: RenderInlineRecordContext<R2>) => ReactElement | null;
+    renderInlineRecord?: (context: RenderInlineRecordContext<LinkRecord>) => ReactElement | null;
     /** Fuction that converts an 'itemLink' node into React **/
-    renderLinkToRecord?: (context: RenderRecordLinkContext<R2>) => ReactElement | null;
+    renderLinkToRecord?: (context: RenderRecordLinkContext<LinkRecord>) => ReactElement | null;
     /** Fuction that converts a 'block' node into React **/
-    renderBlock?: (context: RenderBlockContext<R1>) => ReactElement | null;
+    renderBlock?: (context: RenderBlockContext<BlockRecord>) => ReactElement | null;
+    /** Fuction that converts an 'inlineBlock' node into React **/
+    renderInlineBlock?: (context: RenderBlockContext<InlineBlockRecord>) => ReactElement | null;
     /** Function that converts 'link' and 'itemLink' `meta` into HTML props */
     metaTransformer?: TransformMetaFn;
     /** Fuction that converts a simple string text into React **/
@@ -49,4 +50,14 @@ export type StructuredTextPropTypes<R1 extends StructuredTextGraphQlResponseReco
     /** @deprecated use customNodeRules **/
     customRules?: RenderRule<H, T, F>[];
 };
-export declare function StructuredText<R1 extends StructuredTextGraphQlResponseRecord, R2 extends StructuredTextGraphQlResponseRecord = R1>({ data, renderInlineRecord, renderLinkToRecord, renderBlock, renderText, renderNode, renderFragment, customMarkRules, customRules, customNodeRules, metaTransformer, }: StructuredTextPropTypes<R1, R2>): ReactElement | null;
+export declare function StructuredText<BlockRecord extends StructuredTextGraphQlResponseRecord = StructuredTextGraphQlResponseRecord, LinkRecord extends StructuredTextGraphQlResponseRecord = StructuredTextGraphQlResponseRecord, InlineBlockRecord extends StructuredTextGraphQlResponseRecord = StructuredTextGraphQlResponseRecord>({ data, renderInlineRecord, renderLinkToRecord, renderBlock, renderInlineBlock, renderText, renderNode, renderFragment, customMarkRules, customRules, customNodeRules, metaTransformer, }: StructuredTextPropTypes<BlockRecord, LinkRecord, InlineBlockRecord>): ReactElement | null;
+/**
+ * @deprecated Use renderNodeRule instead
+ */
+export { renderNodeRule as renderRule };
+/** @deprecated Use CdaStructuredTextValue */
+export type { StructuredTextGraphQlResponse };
+/** @deprecated Use TypesafeCdaStructuredTextValue */
+export type { TypesafeStructuredTextGraphQlResponse };
+/** @deprecated Use CdaStructuredTextRecord */
+export type { StructuredTextGraphQlResponseRecord };

package/dist/types/VideoPlayer/index.d.ts

@@ -1,11 +1,12 @@
-import React from "react";
-import type MuxPlayerElement from "@mux/mux-player";
-import type { MuxPlayerProps } from "@mux/mux-player-react";
+import type { MuxPlayerProps } from '@mux/mux-player-react';
+import MuxPlayer from '@mux/mux-player-react/lazy';
 type Maybe<T> = T | null;
 type Possibly<T> = Maybe<T> | undefined;
 export type Video = {
     /** Title attribute (`title`) for the video */
     title?: Possibly<string>;
+    /** Alt attribute used for content link integration (passed as data-datocms-content-link-source) */
+    alt?: Possibly<string>;
     /** The height of the video */
     height?: Possibly<number>;
     /** The width of the video */
@@ -23,6 +24,5 @@ export type VideoPlayerProps = MuxPlayerProps & {
     /** The actual response you get from a DatoCMS `video` GraphQL query */
     data?: Video;
 };
-type VideoPlayerType = React.ForwardRefExoticComponent<VideoPlayerProps & React.RefAttributes<MuxPlayerElement>>;
-export declare const VideoPlayer: VideoPlayerType;
-export default VideoPlayer;
+export declare const VideoPlayer: (props: VideoPlayerProps) => ReturnType<typeof MuxPlayer>;
+export {};

package/dist/types/index.d.ts

@@ -6,3 +6,5 @@ export * from './VideoPlayer/index.js';
 export * from './useQuerySubscription/index.js';
 export * from './useSiteSearch/index.js';
 export * from './useVideoPlayer/index.js';
+export * from './ContentLink/index.js';
+export * from './useContentLink/index.js';

package/dist/types/useContentLink/index.d.ts

@@ -0,0 +1,91 @@
+import { type Controller } from '@datocms/content-link';
+export { decodeStega, stripStega } from '@datocms/content-link';
+export type { Controller } from '@datocms/content-link';
+export type UseContentLinkOptions = {
+    /**
+     * Whether the controller is enabled, or an options object.
+     * - Pass `true` (default): Enables the controller with stega encoding preserved (allows controller recreation)
+     * - Pass `false`: Disables the controller completely
+     * - Pass `{ stripStega: true }`: Enables the controller and strips stega encoding after stamping
+     *
+     * When stripStega is false (default): Stega encoding remains in the DOM, allowing controllers
+     * to be disposed and recreated on the same page. The invisible characters don't affect display
+     * but preserve the source of truth.
+     *
+     * When stripStega is true: Stega encoding is permanently removed from text nodes, providing
+     * clean textContent for programmatic access. However, recreating a controller on the same page
+     * won't detect elements since the encoding is lost.
+     */
+    enabled?: boolean | {
+        stripStega: boolean;
+    };
+    /** Callback when Web Previews plugin requests navigation */
+    onNavigateTo?: (path: string) => void;
+    /** Ref to limit scanning to this root instead of document */
+    root?: React.RefObject<HTMLElement>;
+};
+export interface ClickToEditOptions {
+    /**
+     * Whether to automatically scroll to the nearest editable element if none
+     * is currently visible in the viewport when click-to-edit mode is enabled.
+     *
+     * @default false
+     */
+    scrollToNearestTarget?: boolean;
+    /**
+     * Only enable click-to-edit on devices that support hover (i.e., non-touch devices).
+     * Uses `window.matchMedia('(hover: hover)')` to detect hover capability.
+     *
+     * This is useful to avoid showing overlays on touch devices where they may
+     * interfere with normal scrolling and tapping behavior.
+     *
+     * When set to `true` on a touch-only device, click-to-edit will not be
+     * automatically enabled, but users can still toggle it manually using
+     * the Alt/Option key.
+     *
+     * @default false
+     */
+    hoverOnly?: boolean;
+}
+export type UseContentLinkResult = {
+    /** The controller instance, or null if disabled */
+    controller: Controller | null;
+    /** Enable click-to-edit overlays */
+    enableClickToEdit: (options?: ClickToEditOptions) => void;
+    /** Disable click-to-edit overlays */
+    disableClickToEdit: () => void;
+    /** Check if click-to-edit is enabled */
+    isClickToEditEnabled: () => boolean;
+    /** Highlight all editable elements */
+    flashAll: (scrollToNearestTarget?: boolean) => void;
+    /** Notify Web Previews plugin of current path */
+    setCurrentPath: (path: string) => void;
+};
+/**
+ * Hook to control the ContentLink controller for Visual Editing.
+ *
+ * This hook provides low-level access to the @datocms/content-link controller,
+ * allowing you to programmatically control click-to-edit overlays and
+ * communicate with the DatoCMS Web Previews plugin.
+ *
+ * @param options - Configuration options for the controller
+ * @returns An object containing the controller instance and its methods
+ *
+ * @example
+ * ```tsx
+ * import { useContentLink } from 'react-datocms';
+ *
+ * function MyComponent() {
+ *   const { enableClickToEdit, flashAll } = useContentLink({
+ *     onNavigateTo: (path) => router.push(path),
+ *   });
+ *
+ *   return (
+ *     <button onClick={() => enableClickToEdit({ scrollToNearestTarget: true })}>
+ *       Enable Editing
+ *     </button>
+ *   );
+ * }
+ * ```
+ */
+export declare function useContentLink(options?: UseContentLinkOptions): UseContentLinkResult;

package/dist/types/useSiteSearch/index.d.ts

@@ -9,6 +9,7 @@ type SearchResultInstancesHrefSchema = {
         fuzzy?: boolean;
         query: string;
         build_trigger_id?: string;
+        search_index_id?: string;
         locale?: string;
         [k: string]: unknown;
     };
@@ -45,7 +46,8 @@ declare class GenericClient {
 type Highlighter = (match: string, key: string, context: 'title' | 'bodyExcerpt') => React.ReactNode;
 export type UseSiteSearchConfig<Client extends GenericClient> = {
     client: Client;
-    buildTriggerId: string;
+    buildTriggerId?: string;
+    searchIndexId?: string;
     fuzzySearch?: boolean;
     resultsPerPage?: number;
     highlightMatch?: Highlighter;

package/dist/types/useVideoPlayer/index.d.ts

@@ -1,5 +1,5 @@
-import type { MuxPlayerProps } from '@mux/mux-player-react/.';
-import type { Video } from '../VideoPlayer';
+import type { MuxPlayerProps } from '@mux/mux-player-react';
+import type { Video } from '../VideoPlayer/index.js';
 type Style = MuxPlayerProps['style'];
 type Title = MuxPlayerProps['title'];
 type PlaybackId = MuxPlayerProps['playbackId'];