@localess/react 3.0.1-dev.20260410065141 → 3.0.1-dev.20260410071322

package/dist/index.d.mts

@@ -1,16 +1,104 @@
-export { L as LocalessOptions, f as findLink, g as getComponent, a as getFallbackComponent, b as getLocalessClient, i as isSyncEnabled, l as localessInit, r as registerComponent, c as renderRichTextToReact, d as resolveAsset, s as setComponents, e as setFallbackComponent, u as unregisterComponent } from './richtext-XH7pH80J.mjs';
+export { L as LocalessOptions, f as findLink, g as getComponent, a as getFallbackComponent, b as getLocalessClient, i as isSyncEnabled, l as localessInit, r as registerComponent, c as renderRichTextToReact, d as resolveAsset, s as setComponents, e as setFallbackComponent, u as unregisterComponent } from './richtext-l2BRZFEP.mjs';
 import * as React from 'react';
 import { ContentData, Links, References, ContentFetchParams, Content } from '@localess/client';
 export { Content, ContentAsset, ContentData, ContentDataField, ContentDataSchema, ContentLink, ContentMetadata, ContentReference, ContentRichText, EventCallback, EventToApp, EventToAppType, Links, LocalessClient, LocalessSync, References, Translations, isBrowser, isIframe, isServer, localessEditable, localessEditableField } from '@localess/client';
 
+/**
+ * Props for {@link LocalessComponent}.
+ *
+ * @template T - The content data shape. Defaults to the base {@link ContentData} type.
+ */
 type LocalessComponentProps<T extends ContentData = ContentData> = {
+    /**
+     * The content data object to render. Must have a `_schema` field that matches a key
+     * in the component registry configured via `localessInit`.
+     */
     data: T;
+    /**
+     * Optional map of content links keyed by link ID.
+     * Pass through to child components so they can resolve {@link ContentLink} values with `findLink`.
+     */
     links?: Links;
+    /**
+     * Optional map of resolved content references keyed by reference ID.
+     * Pass through to child components that consume referenced content.
+     */
     references?: References;
 };
+/**
+ * Dynamic schema-to-component renderer for use in SPA and client-side contexts.
+ *
+ * Looks up `data._schema` in the component registry (set via `localessInit` or `setComponents`),
+ * renders the matched component, and — when Visual Editor sync is active — automatically
+ * spreads `localessEditable` attributes on the root element for live targeting.
+ *
+ * Falls back to the `fallbackComponent` (if registered) when the schema key is not found,
+ * or renders an inline error message as a last resort.
+ *
+ * **Server-safe** — does not include a `'use client'` directive and can be used in
+ * React Server Components. For SSR / static-export environments use {@link LocalessServerComponent}
+ * from `@localess/react/ssr` instead, which omits the sync attribute injection.
+ *
+ * @template T - The content data shape. Defaults to {@link ContentData}.
+ *
+ * @example Basic usage
+ * ```tsx
+ * import { LocalessComponent } from '@localess/react';
+ *
+ * <LocalessComponent data={content.data} links={content.links} references={content.references} />
+ * ```
+ *
+ * @example Rendering a list of nested blocks
+ * ```tsx
+ * {data.body.map(item => (
+ *   <LocalessComponent key={item._id} data={item} links={content.links} references={content.references} />
+ * ))}
+ * ```
+ */
 declare const LocalessComponent: React.ForwardRefExoticComponent<LocalessComponentProps<ContentData> & React.RefAttributes<HTMLElement>>;
 
+/**
+ * Options for {@link useLocaless}.
+ * Extends {@link ContentFetchParams} with any future hook-specific settings.
+ */
 type UseLocalessOptions = ContentFetchParams & {};
+/**
+ * React hook for fetching Localess content by slug inside a Client Component.
+ *
+ * Fetches content on mount using `getLocalessClient().getContentBySlug`, stores it in local state,
+ * and — when `enableSync` is active and the page is running inside the Visual Editor iframe —
+ * automatically subscribes to `input` and `change` events so content updates live without a reload.
+ *
+ * **Requires `'use client'`** — must be called inside a Client Component.
+ *
+ * **Recommended pattern:** fetch data server-side and pass it as `initialContent`, then use the
+ * hook result with `?? initialContent` to avoid a loading flash:
+ * ```tsx
+ * const content = useLocaless('home', { locale }) ?? initialContent;
+ * ```
+ *
+ * @template T - The content data shape. Defaults to {@link ContentData}.
+ *
+ * @param slug - Content slug string, or an array of path segments that will be joined with `/`.
+ * @param options - Optional fetch parameters (locale, version, resolveReference, resolveLink).
+ * @returns The fetched {@link Content}<T> object, or `undefined` while the initial fetch is in flight.
+ *
+ * @example Basic usage
+ * ```tsx
+ * 'use client';
+ * import { useLocaless } from '@localess/react/rsc';
+ *
+ * export function PageClient({ initialContent, locale }) {
+ *   const content = useLocaless('home', { locale }) ?? initialContent;
+ *   return <LocalessComponent data={content.data} links={content.links} />;
+ * }
+ * ```
+ *
+ * @example Array slug (joined as 'blog/my-post')
+ * ```tsx
+ * const content = useLocaless(['blog', 'my-post'], { locale: 'en' });
+ * ```
+ */
 declare const useLocaless: <T extends ContentData = ContentData>(slug: string | string[], options?: UseLocalessOptions) => Content<T> | undefined;
 
 export { LocalessComponent, type LocalessComponentProps, type UseLocalessOptions, useLocaless };

package/dist/index.d.ts

@@ -1,16 +1,104 @@
-export { L as LocalessOptions, f as findLink, g as getComponent, a as getFallbackComponent, b as getLocalessClient, i as isSyncEnabled, l as localessInit, r as registerComponent, c as renderRichTextToReact, d as resolveAsset, s as setComponents, e as setFallbackComponent, u as unregisterComponent } from './richtext-XH7pH80J.js';
+export { L as LocalessOptions, f as findLink, g as getComponent, a as getFallbackComponent, b as getLocalessClient, i as isSyncEnabled, l as localessInit, r as registerComponent, c as renderRichTextToReact, d as resolveAsset, s as setComponents, e as setFallbackComponent, u as unregisterComponent } from './richtext-l2BRZFEP.js';
 import * as React from 'react';
 import { ContentData, Links, References, ContentFetchParams, Content } from '@localess/client';
 export { Content, ContentAsset, ContentData, ContentDataField, ContentDataSchema, ContentLink, ContentMetadata, ContentReference, ContentRichText, EventCallback, EventToApp, EventToAppType, Links, LocalessClient, LocalessSync, References, Translations, isBrowser, isIframe, isServer, localessEditable, localessEditableField } from '@localess/client';
 
+/**
+ * Props for {@link LocalessComponent}.
+ *
+ * @template T - The content data shape. Defaults to the base {@link ContentData} type.
+ */
 type LocalessComponentProps<T extends ContentData = ContentData> = {
+    /**
+     * The content data object to render. Must have a `_schema` field that matches a key
+     * in the component registry configured via `localessInit`.
+     */
     data: T;
+    /**
+     * Optional map of content links keyed by link ID.
+     * Pass through to child components so they can resolve {@link ContentLink} values with `findLink`.
+     */
     links?: Links;
+    /**
+     * Optional map of resolved content references keyed by reference ID.
+     * Pass through to child components that consume referenced content.
+     */
     references?: References;
 };
+/**
+ * Dynamic schema-to-component renderer for use in SPA and client-side contexts.
+ *
+ * Looks up `data._schema` in the component registry (set via `localessInit` or `setComponents`),
+ * renders the matched component, and — when Visual Editor sync is active — automatically
+ * spreads `localessEditable` attributes on the root element for live targeting.
+ *
+ * Falls back to the `fallbackComponent` (if registered) when the schema key is not found,
+ * or renders an inline error message as a last resort.
+ *
+ * **Server-safe** — does not include a `'use client'` directive and can be used in
+ * React Server Components. For SSR / static-export environments use {@link LocalessServerComponent}
+ * from `@localess/react/ssr` instead, which omits the sync attribute injection.
+ *
+ * @template T - The content data shape. Defaults to {@link ContentData}.
+ *
+ * @example Basic usage
+ * ```tsx
+ * import { LocalessComponent } from '@localess/react';
+ *
+ * <LocalessComponent data={content.data} links={content.links} references={content.references} />
+ * ```
+ *
+ * @example Rendering a list of nested blocks
+ * ```tsx
+ * {data.body.map(item => (
+ *   <LocalessComponent key={item._id} data={item} links={content.links} references={content.references} />
+ * ))}
+ * ```
+ */
 declare const LocalessComponent: React.ForwardRefExoticComponent<LocalessComponentProps<ContentData> & React.RefAttributes<HTMLElement>>;
 
+/**
+ * Options for {@link useLocaless}.
+ * Extends {@link ContentFetchParams} with any future hook-specific settings.
+ */
 type UseLocalessOptions = ContentFetchParams & {};
+/**
+ * React hook for fetching Localess content by slug inside a Client Component.
+ *
+ * Fetches content on mount using `getLocalessClient().getContentBySlug`, stores it in local state,
+ * and — when `enableSync` is active and the page is running inside the Visual Editor iframe —
+ * automatically subscribes to `input` and `change` events so content updates live without a reload.
+ *
+ * **Requires `'use client'`** — must be called inside a Client Component.
+ *
+ * **Recommended pattern:** fetch data server-side and pass it as `initialContent`, then use the
+ * hook result with `?? initialContent` to avoid a loading flash:
+ * ```tsx
+ * const content = useLocaless('home', { locale }) ?? initialContent;
+ * ```
+ *
+ * @template T - The content data shape. Defaults to {@link ContentData}.
+ *
+ * @param slug - Content slug string, or an array of path segments that will be joined with `/`.
+ * @param options - Optional fetch parameters (locale, version, resolveReference, resolveLink).
+ * @returns The fetched {@link Content}<T> object, or `undefined` while the initial fetch is in flight.
+ *
+ * @example Basic usage
+ * ```tsx
+ * 'use client';
+ * import { useLocaless } from '@localess/react/rsc';
+ *
+ * export function PageClient({ initialContent, locale }) {
+ *   const content = useLocaless('home', { locale }) ?? initialContent;
+ *   return <LocalessComponent data={content.data} links={content.links} />;
+ * }
+ * ```
+ *
+ * @example Array slug (joined as 'blog/my-post')
+ * ```tsx
+ * const content = useLocaless(['blog', 'my-post'], { locale: 'en' });
+ * ```
+ */
 declare const useLocaless: <T extends ContentData = ContentData>(slug: string | string[], options?: UseLocalessOptions) => Content<T> | undefined;
 
 export { LocalessComponent, type LocalessComponentProps, type UseLocalessOptions, useLocaless };

package/dist/richtext-l2BRZFEP.d.mts

@@ -0,0 +1,218 @@
+import React__default from 'react';
+import { LocalessClientOptions, LocalessClient, ContentAsset, Links, ContentLink, ContentRichText } from '@localess/client';
+
+/**
+ * Initialization options for {@link localessInit}.
+ *
+ * Extends {@link LocalessClientOptions} (origin, spaceId, token, version, debug, cacheTTL)
+ * with React-specific settings for component mapping and Visual Editor sync.
+ */
+type LocalessOptions = LocalessClientOptions & {
+    /**
+     * Map of schema keys to React components used by {@link LocalessComponent} and
+     * {@link LocalessServerComponent} to render content blocks.
+     *
+     * Keys must match the `_schema` field of your Localess content objects.
+     * Use lowercase hyphenated names by convention (e.g. `'hero-section'`).
+     *
+     * @example
+     * ```ts
+     * components: {
+     *   'page': PageComponent,
+     *   'hero-section': HeroSection,
+     *   'nav-menu': NavMenu,
+     * }
+     * ```
+     */
+    components?: Record<string, React__default.ElementType>;
+    /**
+     * Fallback React component rendered when `_schema` has no match in the registry.
+     * Receives the same `data`, `links`, and `references` props as any registered component.
+     * If omitted, an inline error message is rendered instead.
+     */
+    fallbackComponent?: React__default.ElementType;
+    /**
+     * When `true`, injects the Localess Visual Editor sync script (`sync-v1.js`) into
+     * `<head>` so that `input` and `change` events from the editor reach the app.
+     * Only takes effect when the page is running inside the Visual Editor iframe.
+     * Set to `false` (or omit) in production builds to avoid loading the script.
+     *
+     * @default false
+     */
+    enableSync?: boolean;
+};
+
+/**
+ * Initialize the Localess SDK.
+ *
+ * Must be called **once** at application startup (e.g. root layout, `_app.tsx`) before any
+ * other SDK function is used. Calling it again overwrites the existing client and state.
+ *
+ * - Creates the underlying {@link LocalessClient} with the supplied API options.
+ * - Registers the component map and optional fallback component.
+ * - When `enableSync` is `true` and the page is running inside the Visual Editor iframe,
+ *   injects the Localess sync script into `<head>` to enable live editing events.
+ *
+ * @param options - Initialization options. Extends {@link LocalessClientOptions} with
+ *   `components`, `fallbackComponent`, and `enableSync`.
+ * @returns The initialized {@link LocalessClient} instance.
+ *
+ * @example
+ * ```ts
+ * import { localessInit } from '@localess/react';
+ * import { Page, Header, Teaser } from '@/components';
+ *
+ * localessInit({
+ *   origin: 'https://my-localess.web.app',
+ *   spaceId: 'YOUR_SPACE_ID',
+ *   token: 'YOUR_API_TOKEN',          // keep server-side only
+ *   enableSync: process.env.NODE_ENV !== 'production',
+ *   components: { page: Page, header: Header, teaser: Teaser },
+ * });
+ * ```
+ */
+declare function localessInit(options: LocalessOptions): LocalessClient;
+/**
+ * Returns the initialized {@link LocalessClient} instance.
+ *
+ * Throws an error if called before {@link localessInit}. Use this in server components,
+ * API routes, or server-side data fetching functions to make API calls.
+ *
+ * @throws {Error} If `localessInit` has not been called yet.
+ * @returns The active {@link LocalessClient}.
+ *
+ * @example
+ * ```ts
+ * const content = await getLocalessClient().getContentBySlug<MyPage>('home', { locale: 'en' });
+ * ```
+ */
+declare function getLocalessClient(): LocalessClient;
+/**
+ * Adds a single component to the registry under the given schema key.
+ *
+ * The key must match the `_schema` field of the content objects you want to render.
+ * Overwrites any previously registered component for the same key.
+ *
+ * @param key - The schema key (e.g. `'hero-section'`).
+ * @param component - The React component to render for this schema key.
+ */
+declare function registerComponent(key: string, component: React__default.ElementType): void;
+/**
+ * Removes a component from the registry by schema key.
+ * No-op if the key does not exist.
+ *
+ * @param key - The schema key to remove.
+ */
+declare function unregisterComponent(key: string): void;
+/**
+ * Replaces the entire component registry with the supplied map.
+ *
+ * Useful when you need to swap all components at once (e.g. lazy-loaded registry).
+ * Any previously registered components (including those set via `localessInit`) are discarded.
+ *
+ * @param components - A record mapping schema keys to React components.
+ */
+declare function setComponents(components: Record<string, React__default.ElementType>): void;
+/**
+ * Looks up a React component by its schema key.
+ *
+ * Returns `undefined` and logs a console error when the key is not found.
+ * Called internally by {@link LocalessComponent} and {@link LocalessServerComponent}.
+ *
+ * @param key - The schema key to look up (matches `content._schema`).
+ * @returns The registered React component, or `undefined` if not found.
+ */
+declare function getComponent(key: string): React__default.ElementType | undefined;
+/**
+ * Sets the fallback component rendered when no registry match is found for a schema key.
+ *
+ * The fallback receives the same `data`, `links`, and `references` props as any
+ * registered component, so it can render a generic placeholder or log the unknown schema.
+ *
+ * @param fallbackComponent - The React component to use as the fallback.
+ */
+declare function setFallbackComponent(fallbackComponent: React__default.ElementType): void;
+/**
+ * Returns the currently registered fallback component, or `undefined` if none is set.
+ *
+ * Called internally by {@link LocalessComponent} and {@link LocalessServerComponent}
+ * when a schema key has no matching component in the registry.
+ *
+ * @returns The fallback React component, or `undefined`.
+ */
+declare function getFallbackComponent(): React__default.ElementType | undefined;
+/**
+ * Returns `true` when Visual Editor sync was enabled via `enableSync: true` in `localessInit`.
+ *
+ * Used internally by {@link LocalessComponent}, {@link LocalessDocument}, and {@link useLocaless}
+ * to decide whether to inject editable attributes and subscribe to sync events.
+ *
+ * @returns `true` if sync is enabled, `false` otherwise.
+ */
+declare function isSyncEnabled(): boolean;
+/**
+ * Resolves a {@link ContentAsset} to its full URL string.
+ *
+ * Constructs the URL using the `origin` and `spaceId` from `localessInit`:
+ * `{origin}/api/v1/spaces/{spaceId}/assets/{asset.uri}`
+ *
+ * @param asset - The asset reference object containing a `uri` field.
+ * @returns The fully qualified asset URL string.
+ *
+ * @example
+ * ```tsx
+ * <img src={resolveAsset(data.heroImage)} alt={data.heroImage.alt} />
+ * ```
+ */
+declare function resolveAsset(asset: ContentAsset): string;
+
+/**
+ * Resolves a {@link ContentLink} reference to a navigable URL string.
+ *
+ * Resolution rules by `link.type`:
+ * - `'content'` — looks up `link.uri` in the `links` map and returns `'/' + fullSlug`.
+ *   Returns `'/not-found'` when `links` is undefined or the URI is not in the map.
+ * - `'url'`     — returns `link.uri` directly (external or absolute URL).
+ * - anything else — returns `'no-type'` (indicates a misconfigured link field).
+ *
+ * @param links - The links map from `content.links` (keyed by link URI). May be `undefined`.
+ * @param link  - The content link reference to resolve.
+ * @returns A URL string ready to use in an `<a href>` or Next.js `<Link href>`.
+ *
+ * @example
+ * ```tsx
+ * import { findLink } from '@localess/react';
+ *
+ * function NavItem({ data, links }) {
+ *   return <a href={findLink(links, data.url)}>{data.label}</a>;
+ * }
+ * ```
+ */
+declare function findLink(links: Links | undefined, link: ContentLink): string;
+
+/**
+ * Renders a Localess rich text field to a React node tree.
+ *
+ * Converts a {@link ContentRichText} value (TipTap ProseMirror document JSON) into
+ * `React.ReactNode` using TipTap's static renderer. No browser APIs are required —
+ * safe to call in React Server Components and SSR.
+ *
+ * Supported TipTap extensions: Document, Text, Paragraph, Heading (h1–h6), Bold,
+ * Italic, Strike, Underline, History, ListItem, OrderedList, BulletList, Code,
+ * CodeBlockLowlight, Link.
+ *
+ * @param content - The rich text value from a Localess content field (type `ContentRichText`).
+ * @returns A `React.ReactNode` ready to render inside JSX.
+ *
+ * @example
+ * ```tsx
+ * import { renderRichTextToReact } from '@localess/react';
+ *
+ * export function Article({ data }: { data: MyContent }) {
+ *   return <article>{renderRichTextToReact(data.body)}</article>;
+ * }
+ * ```
+ */
+declare function renderRichTextToReact(content: ContentRichText): React__default.ReactNode;
+
+export { type LocalessOptions as L, getFallbackComponent as a, getLocalessClient as b, renderRichTextToReact as c, resolveAsset as d, setFallbackComponent as e, findLink as f, getComponent as g, isSyncEnabled as i, localessInit as l, registerComponent as r, setComponents as s, unregisterComponent as u };

package/dist/richtext-l2BRZFEP.d.ts

@@ -0,0 +1,218 @@
+import React__default from 'react';
+import { LocalessClientOptions, LocalessClient, ContentAsset, Links, ContentLink, ContentRichText } from '@localess/client';
+
+/**
+ * Initialization options for {@link localessInit}.
+ *
+ * Extends {@link LocalessClientOptions} (origin, spaceId, token, version, debug, cacheTTL)
+ * with React-specific settings for component mapping and Visual Editor sync.
+ */
+type LocalessOptions = LocalessClientOptions & {
+    /**
+     * Map of schema keys to React components used by {@link LocalessComponent} and
+     * {@link LocalessServerComponent} to render content blocks.
+     *
+     * Keys must match the `_schema` field of your Localess content objects.
+     * Use lowercase hyphenated names by convention (e.g. `'hero-section'`).
+     *
+     * @example
+     * ```ts
+     * components: {
+     *   'page': PageComponent,
+     *   'hero-section': HeroSection,
+     *   'nav-menu': NavMenu,
+     * }
+     * ```
+     */
+    components?: Record<string, React__default.ElementType>;
+    /**
+     * Fallback React component rendered when `_schema` has no match in the registry.
+     * Receives the same `data`, `links`, and `references` props as any registered component.
+     * If omitted, an inline error message is rendered instead.
+     */
+    fallbackComponent?: React__default.ElementType;
+    /**
+     * When `true`, injects the Localess Visual Editor sync script (`sync-v1.js`) into
+     * `<head>` so that `input` and `change` events from the editor reach the app.
+     * Only takes effect when the page is running inside the Visual Editor iframe.
+     * Set to `false` (or omit) in production builds to avoid loading the script.
+     *
+     * @default false
+     */
+    enableSync?: boolean;
+};
+
+/**
+ * Initialize the Localess SDK.
+ *
+ * Must be called **once** at application startup (e.g. root layout, `_app.tsx`) before any
+ * other SDK function is used. Calling it again overwrites the existing client and state.
+ *
+ * - Creates the underlying {@link LocalessClient} with the supplied API options.
+ * - Registers the component map and optional fallback component.
+ * - When `enableSync` is `true` and the page is running inside the Visual Editor iframe,
+ *   injects the Localess sync script into `<head>` to enable live editing events.
+ *
+ * @param options - Initialization options. Extends {@link LocalessClientOptions} with
+ *   `components`, `fallbackComponent`, and `enableSync`.
+ * @returns The initialized {@link LocalessClient} instance.
+ *
+ * @example
+ * ```ts
+ * import { localessInit } from '@localess/react';
+ * import { Page, Header, Teaser } from '@/components';
+ *
+ * localessInit({
+ *   origin: 'https://my-localess.web.app',
+ *   spaceId: 'YOUR_SPACE_ID',
+ *   token: 'YOUR_API_TOKEN',          // keep server-side only
+ *   enableSync: process.env.NODE_ENV !== 'production',
+ *   components: { page: Page, header: Header, teaser: Teaser },
+ * });
+ * ```
+ */
+declare function localessInit(options: LocalessOptions): LocalessClient;
+/**
+ * Returns the initialized {@link LocalessClient} instance.
+ *
+ * Throws an error if called before {@link localessInit}. Use this in server components,
+ * API routes, or server-side data fetching functions to make API calls.
+ *
+ * @throws {Error} If `localessInit` has not been called yet.
+ * @returns The active {@link LocalessClient}.
+ *
+ * @example
+ * ```ts
+ * const content = await getLocalessClient().getContentBySlug<MyPage>('home', { locale: 'en' });
+ * ```
+ */
+declare function getLocalessClient(): LocalessClient;
+/**
+ * Adds a single component to the registry under the given schema key.
+ *
+ * The key must match the `_schema` field of the content objects you want to render.
+ * Overwrites any previously registered component for the same key.
+ *
+ * @param key - The schema key (e.g. `'hero-section'`).
+ * @param component - The React component to render for this schema key.
+ */
+declare function registerComponent(key: string, component: React__default.ElementType): void;
+/**
+ * Removes a component from the registry by schema key.
+ * No-op if the key does not exist.
+ *
+ * @param key - The schema key to remove.
+ */
+declare function unregisterComponent(key: string): void;
+/**
+ * Replaces the entire component registry with the supplied map.
+ *
+ * Useful when you need to swap all components at once (e.g. lazy-loaded registry).
+ * Any previously registered components (including those set via `localessInit`) are discarded.
+ *
+ * @param components - A record mapping schema keys to React components.
+ */
+declare function setComponents(components: Record<string, React__default.ElementType>): void;
+/**
+ * Looks up a React component by its schema key.
+ *
+ * Returns `undefined` and logs a console error when the key is not found.
+ * Called internally by {@link LocalessComponent} and {@link LocalessServerComponent}.
+ *
+ * @param key - The schema key to look up (matches `content._schema`).
+ * @returns The registered React component, or `undefined` if not found.
+ */
+declare function getComponent(key: string): React__default.ElementType | undefined;
+/**
+ * Sets the fallback component rendered when no registry match is found for a schema key.
+ *
+ * The fallback receives the same `data`, `links`, and `references` props as any
+ * registered component, so it can render a generic placeholder or log the unknown schema.
+ *
+ * @param fallbackComponent - The React component to use as the fallback.
+ */
+declare function setFallbackComponent(fallbackComponent: React__default.ElementType): void;
+/**
+ * Returns the currently registered fallback component, or `undefined` if none is set.
+ *
+ * Called internally by {@link LocalessComponent} and {@link LocalessServerComponent}
+ * when a schema key has no matching component in the registry.
+ *
+ * @returns The fallback React component, or `undefined`.
+ */
+declare function getFallbackComponent(): React__default.ElementType | undefined;
+/**
+ * Returns `true` when Visual Editor sync was enabled via `enableSync: true` in `localessInit`.
+ *
+ * Used internally by {@link LocalessComponent}, {@link LocalessDocument}, and {@link useLocaless}
+ * to decide whether to inject editable attributes and subscribe to sync events.
+ *
+ * @returns `true` if sync is enabled, `false` otherwise.
+ */
+declare function isSyncEnabled(): boolean;
+/**
+ * Resolves a {@link ContentAsset} to its full URL string.
+ *
+ * Constructs the URL using the `origin` and `spaceId` from `localessInit`:
+ * `{origin}/api/v1/spaces/{spaceId}/assets/{asset.uri}`
+ *
+ * @param asset - The asset reference object containing a `uri` field.
+ * @returns The fully qualified asset URL string.
+ *
+ * @example
+ * ```tsx
+ * <img src={resolveAsset(data.heroImage)} alt={data.heroImage.alt} />
+ * ```
+ */
+declare function resolveAsset(asset: ContentAsset): string;
+
+/**
+ * Resolves a {@link ContentLink} reference to a navigable URL string.
+ *
+ * Resolution rules by `link.type`:
+ * - `'content'` — looks up `link.uri` in the `links` map and returns `'/' + fullSlug`.
+ *   Returns `'/not-found'` when `links` is undefined or the URI is not in the map.
+ * - `'url'`     — returns `link.uri` directly (external or absolute URL).
+ * - anything else — returns `'no-type'` (indicates a misconfigured link field).
+ *
+ * @param links - The links map from `content.links` (keyed by link URI). May be `undefined`.
+ * @param link  - The content link reference to resolve.
+ * @returns A URL string ready to use in an `<a href>` or Next.js `<Link href>`.
+ *
+ * @example
+ * ```tsx
+ * import { findLink } from '@localess/react';
+ *
+ * function NavItem({ data, links }) {
+ *   return <a href={findLink(links, data.url)}>{data.label}</a>;
+ * }
+ * ```
+ */
+declare function findLink(links: Links | undefined, link: ContentLink): string;
+
+/**
+ * Renders a Localess rich text field to a React node tree.
+ *
+ * Converts a {@link ContentRichText} value (TipTap ProseMirror document JSON) into
+ * `React.ReactNode` using TipTap's static renderer. No browser APIs are required —
+ * safe to call in React Server Components and SSR.
+ *
+ * Supported TipTap extensions: Document, Text, Paragraph, Heading (h1–h6), Bold,
+ * Italic, Strike, Underline, History, ListItem, OrderedList, BulletList, Code,
+ * CodeBlockLowlight, Link.
+ *
+ * @param content - The rich text value from a Localess content field (type `ContentRichText`).
+ * @returns A `React.ReactNode` ready to render inside JSX.
+ *
+ * @example
+ * ```tsx
+ * import { renderRichTextToReact } from '@localess/react';
+ *
+ * export function Article({ data }: { data: MyContent }) {
+ *   return <article>{renderRichTextToReact(data.body)}</article>;
+ * }
+ * ```
+ */
+declare function renderRichTextToReact(content: ContentRichText): React__default.ReactNode;
+
+export { type LocalessOptions as L, getFallbackComponent as a, getLocalessClient as b, renderRichTextToReact as c, resolveAsset as d, setFallbackComponent as e, findLink as f, getComponent as g, isSyncEnabled as i, localessInit as l, registerComponent as r, setComponents as s, unregisterComponent as u };

package/dist/rsc.d.mts

@@ -1,5 +1,72 @@
-export { L as LocalessOptions, f as findLink, g as getComponent, a as getFallbackComponent, b as getLocalessClient, i as isSyncEnabled, l as localessInit, r as registerComponent, c as renderRichTextToReact, d as resolveAsset, u as unregisterComponent } from './richtext-XH7pH80J.mjs';
+export { L as LocalessOptions, f as findLink, g as getComponent, a as getFallbackComponent, b as getLocalessClient, i as isSyncEnabled, l as localessInit, r as registerComponent, c as renderRichTextToReact, d as resolveAsset, u as unregisterComponent } from './richtext-l2BRZFEP.mjs';
 export { LocalessServerComponent, LocalessServerComponentProps, LocalessServerDocument, LocalessServerDocumentProps } from './ssr.mjs';
+import { ContentData, Links, References } from '@localess/client';
 export { Content, ContentAsset, ContentData, ContentDataField, ContentDataSchema, ContentLink, ContentMetadata, ContentReference, ContentRichText, EventCallback, EventToApp, EventToAppType, Links, LocalessClient, LocalessSync, References, Translations, isBrowser, isIframe, isServer, localessEditable, localessEditableField } from '@localess/client';
 export { LocalessComponent, LocalessComponentProps, UseLocalessOptions, useLocaless } from './index.mjs';
-import 'react';
+import * as React from 'react';
+
+/**
+ * Props for {@link LocalessDocument}.
+ *
+ * @template T - The content data shape. Defaults to the base {@link ContentData} type.
+ */
+type LocalessDocumentProps<T extends ContentData = ContentData> = {
+    /**
+     * The content data object to render — typically `content.data` from `getContentBySlug`.
+     * Should be fetched server-side and passed as a prop so the page renders immediately
+     * without a loading flash.
+     */
+    data: T;
+    /**
+     * Optional map of content links keyed by link ID.
+     * Passed through to child components for resolving {@link ContentLink} values with `findLink`.
+     */
+    links?: Links;
+    /**
+     * Optional map of resolved content references keyed by reference ID.
+     * Passed through to child components that consume referenced content.
+     */
+    references?: References;
+};
+/**
+ * Client Component that renders content and automatically subscribes to Visual Editor sync events.
+ *
+ * Wraps {@link LocalessComponent} with local state so that live `input` and `change` events
+ * from the Localess Visual Editor update the rendered content without a full page reload.
+ *
+ * **Recommended pattern for Next.js App Router:** fetch data in a Server Component and pass it
+ * as props. The page renders immediately with server data; once the client hydrates, live editing
+ * activates on top — no loading state needed.
+ *
+ * Sync only activates when `enableSync: true` was passed to `localessInit` **and** the page
+ * is running inside the Visual Editor iframe (`isIframe()` is true).
+ *
+ * **Requires `'use client'`** — must be used inside a Client Component boundary in Next.js
+ * App Router. Available from `@localess/react` (SPA) and `@localess/react/rsc` (RSC).
+ * Not available from `@localess/react/ssr`.
+ *
+ * @template T - The content data shape. Defaults to {@link ContentData}.
+ *
+ * @example Server Component passes data; Client Component renders with live sync
+ * ```tsx
+ * // app/[locale]/page.tsx  (Server Component)
+ * import { getLocalessClient } from '@localess/react/rsc';
+ * import PageClient from './page-client';
+ *
+ * export default async function Page({ params }) {
+ *   const content = await getLocalessClient().getContentBySlug('home', { locale: params.locale });
+ *   return <PageClient data={content.data} links={content.links} references={content.references} />;
+ * }
+ *
+ * // app/[locale]/page-client.tsx  (Client Component)
+ * 'use client';
+ * import { LocalessDocument } from '@localess/react/rsc';
+ *
+ * export default function PageClient({ data, links, references }) {
+ *   return <LocalessDocument data={data} links={links} references={references} />;
+ * }
+ * ```
+ */
+declare const LocalessDocument: React.ForwardRefExoticComponent<LocalessDocumentProps<ContentData> & React.RefAttributes<HTMLElement>>;
+
+export { LocalessDocument, type LocalessDocumentProps };

package/dist/rsc.d.ts

@@ -1,5 +1,72 @@
-export { L as LocalessOptions, f as findLink, g as getComponent, a as getFallbackComponent, b as getLocalessClient, i as isSyncEnabled, l as localessInit, r as registerComponent, c as renderRichTextToReact, d as resolveAsset, u as unregisterComponent } from './richtext-XH7pH80J.js';
+export { L as LocalessOptions, f as findLink, g as getComponent, a as getFallbackComponent, b as getLocalessClient, i as isSyncEnabled, l as localessInit, r as registerComponent, c as renderRichTextToReact, d as resolveAsset, u as unregisterComponent } from './richtext-l2BRZFEP.js';
 export { LocalessServerComponent, LocalessServerComponentProps, LocalessServerDocument, LocalessServerDocumentProps } from './ssr.js';
+import { ContentData, Links, References } from '@localess/client';
 export { Content, ContentAsset, ContentData, ContentDataField, ContentDataSchema, ContentLink, ContentMetadata, ContentReference, ContentRichText, EventCallback, EventToApp, EventToAppType, Links, LocalessClient, LocalessSync, References, Translations, isBrowser, isIframe, isServer, localessEditable, localessEditableField } from '@localess/client';
 export { LocalessComponent, LocalessComponentProps, UseLocalessOptions, useLocaless } from './index.js';
-import 'react';
+import * as React from 'react';
+
+/**
+ * Props for {@link LocalessDocument}.
+ *
+ * @template T - The content data shape. Defaults to the base {@link ContentData} type.
+ */
+type LocalessDocumentProps<T extends ContentData = ContentData> = {
+    /**
+     * The content data object to render — typically `content.data` from `getContentBySlug`.
+     * Should be fetched server-side and passed as a prop so the page renders immediately
+     * without a loading flash.
+     */
+    data: T;
+    /**
+     * Optional map of content links keyed by link ID.
+     * Passed through to child components for resolving {@link ContentLink} values with `findLink`.
+     */
+    links?: Links;
+    /**
+     * Optional map of resolved content references keyed by reference ID.
+     * Passed through to child components that consume referenced content.
+     */
+    references?: References;
+};
+/**
+ * Client Component that renders content and automatically subscribes to Visual Editor sync events.
+ *
+ * Wraps {@link LocalessComponent} with local state so that live `input` and `change` events
+ * from the Localess Visual Editor update the rendered content without a full page reload.
+ *
+ * **Recommended pattern for Next.js App Router:** fetch data in a Server Component and pass it
+ * as props. The page renders immediately with server data; once the client hydrates, live editing
+ * activates on top — no loading state needed.
+ *
+ * Sync only activates when `enableSync: true` was passed to `localessInit` **and** the page
+ * is running inside the Visual Editor iframe (`isIframe()` is true).
+ *
+ * **Requires `'use client'`** — must be used inside a Client Component boundary in Next.js
+ * App Router. Available from `@localess/react` (SPA) and `@localess/react/rsc` (RSC).
+ * Not available from `@localess/react/ssr`.
+ *
+ * @template T - The content data shape. Defaults to {@link ContentData}.
+ *
+ * @example Server Component passes data; Client Component renders with live sync
+ * ```tsx
+ * // app/[locale]/page.tsx  (Server Component)
+ * import { getLocalessClient } from '@localess/react/rsc';
+ * import PageClient from './page-client';
+ *
+ * export default async function Page({ params }) {
+ *   const content = await getLocalessClient().getContentBySlug('home', { locale: params.locale });
+ *   return <PageClient data={content.data} links={content.links} references={content.references} />;
+ * }
+ *
+ * // app/[locale]/page-client.tsx  (Client Component)
+ * 'use client';
+ * import { LocalessDocument } from '@localess/react/rsc';
+ *
+ * export default function PageClient({ data, links, references }) {
+ *   return <LocalessDocument data={data} links={links} references={references} />;
+ * }
+ * ```
+ */
+declare const LocalessDocument: React.ForwardRefExoticComponent<LocalessDocumentProps<ContentData> & React.RefAttributes<HTMLElement>>;
+
+export { LocalessDocument, type LocalessDocumentProps };

package/dist/rsc.js

@@ -21,6 +21,7 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 var rsc_exports = {};
 __export(rsc_exports, {
   LocalessComponent: () => LocalessComponent,
+  LocalessDocument: () => LocalessDocument,
   LocalessServerComponent: () => LocalessServerComponent,
   LocalessServerDocument: () => LocalessServerDocument,
   findLink: () => findLink,
@@ -242,11 +243,37 @@ var LocalessComponent = (0, import_react4.forwardRef)(
   }
 );
 
-// src/core/hooks/use-localess.ts
+// src/rsc/localess-document.tsx
 var import_react5 = require("react");
+var import_jsx_runtime4 = require("react/jsx-runtime");
+var LocalessDocument = (0, import_react5.forwardRef)(({
+  data,
+  links,
+  references,
+  ...restProps
+}, ref) => {
+  const [contentData, setContentData] = (0, import_react5.useState)(data);
+  (0, import_react5.useEffect)(() => {
+    console.log("LocalessDocument isSyncEnabled:", isSyncEnabled());
+    console.log("LocalessDocument isBrowser:", (0, import_client2.isBrowser)());
+    console.log("LocalessDocument isBrowser:", (0, import_client2.isBrowser)());
+    if (isSyncEnabled() && (0, import_client2.isBrowser)() && (0, import_client2.isIframe)()) {
+      window.localess?.on(["input", "change"], (event) => {
+        console.log("Localess:event", event);
+        if (event.type === "change" || event.type === "input") {
+          setContentData(event.data);
+        }
+      });
+    }
+  }, []);
+  return /* @__PURE__ */ (0, import_jsx_runtime4.jsx)(LocalessComponent, { ref, data: contentData, links, references, ...restProps });
+});
+
+// src/core/hooks/use-localess.ts
+var import_react6 = require("react");
 var import_client3 = require("@localess/client");
 var useLocaless = (slug, options = {}) => {
-  const [document, setDocument] = (0, import_react5.useState)();
+  const [document, setDocument] = (0, import_react6.useState)();
   const client = getLocalessClient();
   let normalizedSlug;
   if (Array.isArray(slug)) {
@@ -254,7 +281,7 @@ var useLocaless = (slug, options = {}) => {
   } else {
     normalizedSlug = slug;
   }
-  (0, import_react5.useEffect)(() => {
+  (0, import_react6.useEffect)(() => {
     async function loadDocument() {
       const document2 = await client.getContentBySlug(normalizedSlug, options);
       setDocument(document2);
@@ -273,6 +300,7 @@ var useLocaless = (slug, options = {}) => {
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   LocalessComponent,
+  LocalessDocument,
   LocalessServerComponent,
   LocalessServerDocument,
   findLink,

package/dist/rsc.mjs

@@ -23,8 +23,35 @@ import {
   resolveAsset,
   unregisterComponent
 } from "./chunk-ETSLIILF.mjs";
+
+// src/rsc/localess-document.tsx
+import { forwardRef, useEffect, useState } from "react";
+import { jsx } from "react/jsx-runtime";
+var LocalessDocument = forwardRef(({
+  data,
+  links,
+  references,
+  ...restProps
+}, ref) => {
+  const [contentData, setContentData] = useState(data);
+  useEffect(() => {
+    console.log("LocalessDocument isSyncEnabled:", isSyncEnabled());
+    console.log("LocalessDocument isBrowser:", isBrowser());
+    console.log("LocalessDocument isBrowser:", isBrowser());
+    if (isSyncEnabled() && isBrowser() && isIframe()) {
+      window.localess?.on(["input", "change"], (event) => {
+        console.log("Localess:event", event);
+        if (event.type === "change" || event.type === "input") {
+          setContentData(event.data);
+        }
+      });
+    }
+  }, []);
+  return /* @__PURE__ */ jsx(LocalessComponent, { ref, data: contentData, links, references, ...restProps });
+});
 export {
   LocalessComponent,
+  LocalessDocument,
   LocalessServerComponent,
   LocalessServerDocument,
   findLink,

package/dist/ssr.d.mts

@@ -1,18 +1,96 @@
-export { L as LocalessOptions, f as findLink, g as getComponent, a as getFallbackComponent, b as getLocalessClient, l as localessInit, r as registerComponent, c as renderRichTextToReact, d as resolveAsset, u as unregisterComponent } from './richtext-XH7pH80J.mjs';
+export { L as LocalessOptions, f as findLink, g as getComponent, a as getFallbackComponent, b as getLocalessClient, l as localessInit, r as registerComponent, c as renderRichTextToReact, d as resolveAsset, u as unregisterComponent } from './richtext-l2BRZFEP.mjs';
 import * as React from 'react';
 import { ContentData, Links, References, Content } from '@localess/client';
 export { Content, ContentAsset, ContentData, ContentDataField, ContentDataSchema, ContentLink, ContentMetadata, ContentReference, ContentRichText, EventCallback, EventToApp, EventToAppType, Links, LocalessClient, LocalessSync, References, Translations, isBrowser, isIframe, isServer, localessEditable, localessEditableField } from '@localess/client';
 
+/**
+ * Props for {@link LocalessServerComponent}.
+ *
+ * @template T - The content data shape. Defaults to the base {@link ContentData} type.
+ */
 type LocalessServerComponentProps<T extends ContentData = ContentData> = {
+    /**
+     * The content data object to render. Must have a `_schema` field that matches a key
+     * in the component registry configured via `localessInit`.
+     */
     data: T;
+    /**
+     * Optional map of content links keyed by link ID.
+     * Pass through to child components so they can resolve {@link ContentLink} values with `findLink`.
+     */
     links?: Links;
+    /**
+     * Optional map of resolved content references keyed by reference ID.
+     * Pass through to child components that consume referenced content.
+     */
     references?: References;
 };
+/**
+ * Server-safe dynamic schema-to-component renderer for SSR and static-export environments.
+ *
+ * Equivalent to {@link LocalessComponent} but intentionally omits Visual Editor sync
+ * attribute injection (`localessEditable`), making it safe for:
+ * - Next.js static exports (`output: 'export'`)
+ * - Server-side rendering where live editing is not needed
+ *
+ * Looks up `data._schema` in the component registry, renders the matched component,
+ * falls back to the `fallbackComponent` if registered, or renders an inline error.
+ *
+ * **No `'use client'` directive** — safe to render in React Server Components.
+ * If you need live Visual Editor editing use {@link LocalessComponent} from
+ * `@localess/react` or `@localess/react/rsc` instead.
+ *
+ * @template T - The content data shape. Defaults to {@link ContentData}.
+ *
+ * @example
+ * ```tsx
+ * import { LocalessServerComponent } from '@localess/react/ssr';
+ *
+ * <LocalessServerComponent data={content.data} links={content.links} references={content.references} />
+ * ```
+ */
 declare const LocalessServerComponent: React.ForwardRefExoticComponent<LocalessServerComponentProps<ContentData> & React.RefAttributes<HTMLElement>>;
 
+/**
+ * Props for {@link LocalessServerDocument}.
+ *
+ * @template T - The content data shape. Defaults to the base {@link ContentData} type.
+ */
 type LocalessServerDocumentProps<T extends ContentData = ContentData> = {
+    /**
+     * The full content response object as returned by `getContentBySlug` or `getContentById`.
+     * Must contain a `data` field with a valid `_schema` key.
+     */
     document: Content<T>;
 };
+/**
+ * Server-safe document renderer for SSR and static-export environments.
+ *
+ * Accepts the full {@link Content} wrapper (as returned by `getContentBySlug` /
+ * `getContentById`) and delegates to {@link LocalessServerComponent}, automatically
+ * passing `data`, `links`, and `references` through.
+ *
+ * This is a convenience wrapper — use it when you want to render a fetched
+ * `Content<T>` object without manually destructuring it.
+ *
+ * **No live editing** — does not subscribe to Visual Editor sync events.
+ * For live Visual Editor editing use {@link LocalessDocument} from `@localess/react/rsc`.
+ *
+ * **No `'use client'` directive** — safe to render in React Server Components
+ * and Next.js static export pages.
+ *
+ * @template T - The content data shape. Defaults to {@link ContentData}.
+ *
+ * @example
+ * ```tsx
+ * import { LocalessServerDocument } from '@localess/react/ssr';
+ *
+ * // Server Component or getServerSideProps
+ * const content = await getLocalessClient().getContentBySlug<MyPage>('home', { locale: 'en' });
+ *
+ * return <LocalessServerDocument document={content} />;
+ * ```
+ */
 declare const LocalessServerDocument: React.ForwardRefExoticComponent<LocalessServerDocumentProps<ContentData> & React.RefAttributes<HTMLElement>>;
 
 export { LocalessServerComponent, type LocalessServerComponentProps, LocalessServerDocument, type LocalessServerDocumentProps };

package/dist/ssr.d.ts

@@ -1,18 +1,96 @@
-export { L as LocalessOptions, f as findLink, g as getComponent, a as getFallbackComponent, b as getLocalessClient, l as localessInit, r as registerComponent, c as renderRichTextToReact, d as resolveAsset, u as unregisterComponent } from './richtext-XH7pH80J.js';
+export { L as LocalessOptions, f as findLink, g as getComponent, a as getFallbackComponent, b as getLocalessClient, l as localessInit, r as registerComponent, c as renderRichTextToReact, d as resolveAsset, u as unregisterComponent } from './richtext-l2BRZFEP.js';
 import * as React from 'react';
 import { ContentData, Links, References, Content } from '@localess/client';
 export { Content, ContentAsset, ContentData, ContentDataField, ContentDataSchema, ContentLink, ContentMetadata, ContentReference, ContentRichText, EventCallback, EventToApp, EventToAppType, Links, LocalessClient, LocalessSync, References, Translations, isBrowser, isIframe, isServer, localessEditable, localessEditableField } from '@localess/client';
 
+/**
+ * Props for {@link LocalessServerComponent}.
+ *
+ * @template T - The content data shape. Defaults to the base {@link ContentData} type.
+ */
 type LocalessServerComponentProps<T extends ContentData = ContentData> = {
+    /**
+     * The content data object to render. Must have a `_schema` field that matches a key
+     * in the component registry configured via `localessInit`.
+     */
     data: T;
+    /**
+     * Optional map of content links keyed by link ID.
+     * Pass through to child components so they can resolve {@link ContentLink} values with `findLink`.
+     */
     links?: Links;
+    /**
+     * Optional map of resolved content references keyed by reference ID.
+     * Pass through to child components that consume referenced content.
+     */
     references?: References;
 };
+/**
+ * Server-safe dynamic schema-to-component renderer for SSR and static-export environments.
+ *
+ * Equivalent to {@link LocalessComponent} but intentionally omits Visual Editor sync
+ * attribute injection (`localessEditable`), making it safe for:
+ * - Next.js static exports (`output: 'export'`)
+ * - Server-side rendering where live editing is not needed
+ *
+ * Looks up `data._schema` in the component registry, renders the matched component,
+ * falls back to the `fallbackComponent` if registered, or renders an inline error.
+ *
+ * **No `'use client'` directive** — safe to render in React Server Components.
+ * If you need live Visual Editor editing use {@link LocalessComponent} from
+ * `@localess/react` or `@localess/react/rsc` instead.
+ *
+ * @template T - The content data shape. Defaults to {@link ContentData}.
+ *
+ * @example
+ * ```tsx
+ * import { LocalessServerComponent } from '@localess/react/ssr';
+ *
+ * <LocalessServerComponent data={content.data} links={content.links} references={content.references} />
+ * ```
+ */
 declare const LocalessServerComponent: React.ForwardRefExoticComponent<LocalessServerComponentProps<ContentData> & React.RefAttributes<HTMLElement>>;
 
+/**
+ * Props for {@link LocalessServerDocument}.
+ *
+ * @template T - The content data shape. Defaults to the base {@link ContentData} type.
+ */
 type LocalessServerDocumentProps<T extends ContentData = ContentData> = {
+    /**
+     * The full content response object as returned by `getContentBySlug` or `getContentById`.
+     * Must contain a `data` field with a valid `_schema` key.
+     */
     document: Content<T>;
 };
+/**
+ * Server-safe document renderer for SSR and static-export environments.
+ *
+ * Accepts the full {@link Content} wrapper (as returned by `getContentBySlug` /
+ * `getContentById`) and delegates to {@link LocalessServerComponent}, automatically
+ * passing `data`, `links`, and `references` through.
+ *
+ * This is a convenience wrapper — use it when you want to render a fetched
+ * `Content<T>` object without manually destructuring it.
+ *
+ * **No live editing** — does not subscribe to Visual Editor sync events.
+ * For live Visual Editor editing use {@link LocalessDocument} from `@localess/react/rsc`.
+ *
+ * **No `'use client'` directive** — safe to render in React Server Components
+ * and Next.js static export pages.
+ *
+ * @template T - The content data shape. Defaults to {@link ContentData}.
+ *
+ * @example
+ * ```tsx
+ * import { LocalessServerDocument } from '@localess/react/ssr';
+ *
+ * // Server Component or getServerSideProps
+ * const content = await getLocalessClient().getContentBySlug<MyPage>('home', { locale: 'en' });
+ *
+ * return <LocalessServerDocument document={content} />;
+ * ```
+ */
 declare const LocalessServerDocument: React.ForwardRefExoticComponent<LocalessServerDocumentProps<ContentData> & React.RefAttributes<HTMLElement>>;
 
 export { LocalessServerComponent, type LocalessServerComponentProps, LocalessServerDocument, type LocalessServerDocumentProps };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@localess/react",
-  "version": "3.0.1-dev.20260410065141",
+  "version": "3.0.1-dev.20260410071322",
   "description": "ReactJS JavaScript/TypeScript SDK for Localess's API.",
   "keywords": [
     "localess",
@@ -56,7 +56,7 @@
     "react-dom": "^17 || ^18 || ^19"
   },
   "dependencies": {
-    "@localess/client": "3.0.1-dev.20260410065141",
+    "@localess/client": "3.0.1-dev.20260410071322",
     "@tiptap/static-renderer": "^3.20.1",
     "@tiptap/html": "^3.20.1",
     "@tiptap/extension-bold": "^3.20.1",

package/dist/richtext-XH7pH80J.d.mts

@@ -1,82 +0,0 @@
-import React__default from 'react';
-import { LocalessClientOptions, LocalessClient, ContentAsset, Links, ContentLink, ContentRichText } from '@localess/client';
-
-type LocalessOptions = LocalessClientOptions & {
-    /**
-     * Components mapping for Localess Component integration
-     */
-    components?: Record<string, React__default.ElementType>;
-    /**
-     * Component used if expected key didn't return anything
-     */
-    fallbackComponent?: React__default.ElementType;
-    /**
-     * Load Sync Script, for Visual Editor integration
-     */
-    enableSync?: boolean;
-};
-
-/**
- * Initialize Localess Client
- * @param options
- * @returns LocalessClient
- */
-declare function localessInit(options: LocalessOptions): LocalessClient;
-/**
- * Get Localess Client
- * @returns LocalessClient
- */
-declare function getLocalessClient(): LocalessClient;
-/**
- * Register Component
- * @param key - component key
- * @param component - React Component
- */
-declare function registerComponent(key: string, component: React__default.ElementType): void;
-/**
- * Unregister Component
- * @param key - component key
- */
-declare function unregisterComponent(key: string): void;
-/**
- * Set Components
- * @param components - Record of components
- */
-declare function setComponents(components: Record<string, React__default.ElementType>): void;
-/**
- * Get Component
- * @param key - component key
- * @returns React Component
- */
-declare function getComponent(key: string): React__default.ElementType | undefined;
-/**
- * Set Fallback Component
- * @param fallbackComponent
- */
-declare function setFallbackComponent(fallbackComponent: React__default.ElementType): void;
-/**
- * Get Fallback Component
- * @returns React Component
- */
-declare function getFallbackComponent(): React__default.ElementType | undefined;
-/**
- * Check if Sync is enabled
- */
-declare function isSyncEnabled(): boolean;
-/**
- * Resolve Asset URL
- * @param asset - ContentAsset
- * @returns Asset URL
- */
-declare function resolveAsset(asset: ContentAsset): string;
-
-declare function findLink(links: Links | undefined, link: ContentLink): string;
-
-/**
- * Render Localess Rich Text content to React elements
- * @param content - The Rich Text content to render
- * @returns React.ReactNode - The rendered React elements
- */
-declare function renderRichTextToReact(content: ContentRichText): React__default.ReactNode;
-
-export { type LocalessOptions as L, getFallbackComponent as a, getLocalessClient as b, renderRichTextToReact as c, resolveAsset as d, setFallbackComponent as e, findLink as f, getComponent as g, isSyncEnabled as i, localessInit as l, registerComponent as r, setComponents as s, unregisterComponent as u };

package/dist/richtext-XH7pH80J.d.ts

@@ -1,82 +0,0 @@
-import React__default from 'react';
-import { LocalessClientOptions, LocalessClient, ContentAsset, Links, ContentLink, ContentRichText } from '@localess/client';
-
-type LocalessOptions = LocalessClientOptions & {
-    /**
-     * Components mapping for Localess Component integration
-     */
-    components?: Record<string, React__default.ElementType>;
-    /**
-     * Component used if expected key didn't return anything
-     */
-    fallbackComponent?: React__default.ElementType;
-    /**
-     * Load Sync Script, for Visual Editor integration
-     */
-    enableSync?: boolean;
-};
-
-/**
- * Initialize Localess Client
- * @param options
- * @returns LocalessClient
- */
-declare function localessInit(options: LocalessOptions): LocalessClient;
-/**
- * Get Localess Client
- * @returns LocalessClient
- */
-declare function getLocalessClient(): LocalessClient;
-/**
- * Register Component
- * @param key - component key
- * @param component - React Component
- */
-declare function registerComponent(key: string, component: React__default.ElementType): void;
-/**
- * Unregister Component
- * @param key - component key
- */
-declare function unregisterComponent(key: string): void;
-/**
- * Set Components
- * @param components - Record of components
- */
-declare function setComponents(components: Record<string, React__default.ElementType>): void;
-/**
- * Get Component
- * @param key - component key
- * @returns React Component
- */
-declare function getComponent(key: string): React__default.ElementType | undefined;
-/**
- * Set Fallback Component
- * @param fallbackComponent
- */
-declare function setFallbackComponent(fallbackComponent: React__default.ElementType): void;
-/**
- * Get Fallback Component
- * @returns React Component
- */
-declare function getFallbackComponent(): React__default.ElementType | undefined;
-/**
- * Check if Sync is enabled
- */
-declare function isSyncEnabled(): boolean;
-/**
- * Resolve Asset URL
- * @param asset - ContentAsset
- * @returns Asset URL
- */
-declare function resolveAsset(asset: ContentAsset): string;
-
-declare function findLink(links: Links | undefined, link: ContentLink): string;
-
-/**
- * Render Localess Rich Text content to React elements
- * @param content - The Rich Text content to render
- * @returns React.ReactNode - The rendered React elements
- */
-declare function renderRichTextToReact(content: ContentRichText): React__default.ReactNode;
-
-export { type LocalessOptions as L, getFallbackComponent as a, getLocalessClient as b, renderRichTextToReact as c, resolveAsset as d, setFallbackComponent as e, findLink as f, getComponent as g, isSyncEnabled as i, localessInit as l, registerComponent as r, setComponents as s, unregisterComponent as u };