@localess/react 3.0.1-dev.20260410070330 → 3.0.1-dev.20260411012947

package/dist/rsc.mjs

@@ -1,12 +1,13 @@
 import {
-  LocalessComponent,
-  useLocaless
-} from "./chunk-V6JSXN66.mjs";
+  LocalessComponent
+} from "./chunk-UW7OWE53.mjs";
 import {
   LocalessServerComponent,
   LocalessServerDocument
-} from "./chunk-AJP75NRT.mjs";
+} from "./chunk-DD2NUMQJ.mjs";
 import {
+  FONT_BOLD,
+  FONT_NORMAL,
   findLink,
   getComponent,
   getFallbackComponent,
@@ -25,22 +26,18 @@ import {
 } from "./chunk-ETSLIILF.mjs";
 
 // src/rsc/localess-document.tsx
-import { forwardRef, useEffect, useState } from "react";
-import { isBrowser as isBrowser2 } from "@localess/client";
-import { jsx } from "react/jsx-runtime";
-var LocalessDocument = forwardRef(({ data, links, references, ...restProps }, ref) => {
-  const [contentData, setContentData] = useState(data);
-  useEffect(() => {
-    if (isSyncEnabled() && isBrowser2()) {
-      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 });
+import { forwardRef } from "react";
+import { Fragment, jsx, jsxs } from "react/jsx-runtime";
+var LocalessDocument = forwardRef(({ document }, ref) => {
+  if (!document.data) {
+    console.error("LocalessDocument property %cdocument.data%c is not provided.", FONT_BOLD, FONT_NORMAL);
+    return /* @__PURE__ */ jsxs("div", { children: [
+      "LocalessDocument property ",
+      /* @__PURE__ */ jsx("b", { children: "document.data" }),
+      " is not provided."
+    ] });
+  }
+  return /* @__PURE__ */ jsx(Fragment, { children: /* @__PURE__ */ jsx(LocalessComponent, { ref, data: document.data, links: document.links, references: document.references }) });
 });
 export {
   LocalessComponent,
@@ -61,6 +58,5 @@ export {
   registerComponent,
   renderRichTextToReact,
   resolveAsset,
-  unregisterComponent,
-  useLocaless
+  unregisterComponent
 };

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';
-import * as React from 'react';
+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-D6tBmv-7.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;
 };
-declare const LocalessServerComponent: React.ForwardRefExoticComponent<LocalessServerComponentProps<ContentData> & React.RefAttributes<HTMLElement>>;
+/**
+ * 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>;
 };
-declare const LocalessServerDocument: React.ForwardRefExoticComponent<LocalessServerDocumentProps<ContentData> & React.RefAttributes<HTMLElement>>;
+/**
+ * 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';
-import * as React from 'react';
+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-D6tBmv-7.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;
 };
-declare const LocalessServerComponent: React.ForwardRefExoticComponent<LocalessServerComponentProps<ContentData> & React.RefAttributes<HTMLElement>>;
+/**
+ * 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>;
 };
-declare const LocalessServerDocument: React.ForwardRefExoticComponent<LocalessServerDocumentProps<ContentData> & React.RefAttributes<HTMLElement>>;
+/**
+ * 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.js

@@ -126,7 +126,7 @@ var LocalessServerComponent = (0, import_react.forwardRef)(({ data, links, refer
 var import_react2 = require("react");
 var import_jsx_runtime2 = require("react/jsx-runtime");
 var LocalessServerDocument = (0, import_react2.forwardRef)(({ document }, ref) => {
-  if (!document || !document.data) {
+  if (!document.data) {
     console.error("LocalessServerDocument property %cdocument.data%c is not provided.", FONT_BOLD, FONT_NORMAL);
     return /* @__PURE__ */ (0, import_jsx_runtime2.jsxs)("div", { children: [
       "LocalessServerDocument property ",

package/dist/ssr.mjs

@@ -1,7 +1,7 @@
 import {
   LocalessServerComponent,
   LocalessServerDocument
-} from "./chunk-AJP75NRT.mjs";
+} from "./chunk-DD2NUMQJ.mjs";
 import {
   findLink,
   getComponent,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@localess/react",
-  "version": "3.0.1-dev.20260410070330",
+  "version": "3.0.1-dev.20260411012947",
   "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.20260410070330",
+    "@localess/client": "3.0.1-dev.20260411012947",
     "@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 };