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

package/dist/console.d.ts

@@ -0,0 +1,2 @@
+export declare const FONT_BOLD = "font-weight: bold";
+export declare const FONT_NORMAL = "font-weight: normal";

package/dist/console.js

@@ -0,0 +1 @@
+var e=`font-weight: bold`,t=`font-weight: normal`;exports.FONT_BOLD=e,exports.FONT_NORMAL=t;

package/dist/console.mjs

@@ -0,0 +1,4 @@
+//#region src/console.ts
+var e = "font-weight: bold", t = "font-weight: normal";
+//#endregion
+export { e as FONT_BOLD, t as FONT_NORMAL };

package/dist/core/components/index.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Core components barrel.
+ *
+ * LocalessComponent  — maps content._schema to a registered React component.
+ *                      Server-safe (no 'use client'). Used in SPA and RSC flows.
+ */
+export * from './localess-component';
+export * from './localess-document';

package/dist/{localess-component-DikkO35Z.d.ts → core/components/localess-component.d.ts}

@@ -1,12 +1,10 @@
-import * as react from 'react';
-import { ContentData, Links, References } from '@localess/client';
-
+import { ContentData, Links, References } from '../models';
 /**
  * Props for {@link LocalessComponent}.
  *
  * @template T - The content data shape. Defaults to the base {@link ContentData} type.
  */
-type LocalessComponentProps<T extends ContentData = ContentData> = {
+export 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`.
@@ -53,6 +51,4 @@ type LocalessComponentProps<T extends ContentData = ContentData> = {
  * ))}
  * ```
  */
-declare const LocalessComponent: react.ForwardRefExoticComponent<LocalessComponentProps<ContentData> & react.RefAttributes<HTMLElement>>;
-
-export { LocalessComponent as L, type LocalessComponentProps as a };
+export declare const LocalessComponent: import('react').ForwardRefExoticComponent<LocalessComponentProps<ContentData> & import('react').RefAttributes<HTMLElement>>;

package/dist/core/components/localess-component.js

@@ -0,0 +1 @@
+const e=require(`../../console.js`),t=require(`../state.js`);let n=require(`react`),r=require(`react/jsx-runtime`),i=require(`@localess/client`);var a=(0,n.forwardRef)(({data:n,links:a,references:o,...s},c)=>{if(!n)return console.error(`LocalessComponent property %cdata%c is not provided.`,e.FONT_BOLD,e.FONT_NORMAL),(0,r.jsxs)(`div`,{children:[`LocalessComponent property `,(0,r.jsx)(`b`,{children:`data`}),` is not provided.`]});let l=t.getComponent(n._schema);if(l)return(0,r.jsx)(l,{ref:c,data:n,links:a,references:o,...(0,i.localessEditable)(n),...s});let u=t.getFallbackComponent();return u?(0,r.jsx)(u,{ref:c,data:n,links:a,references:o,...s}):(0,r.jsxs)(`p`,{children:[(0,r.jsx)(`b`,{children:`LocalessComponent`}),` could not found component with key `,(0,r.jsx)(`b`,{children:n._schema}),`. `,(0,r.jsx)(`br`,{}),`Please check if your configuration is correct.`]})});exports.LocalessComponent=a;

package/dist/core/components/localess-component.mjs

@@ -0,0 +1,39 @@
+import { FONT_BOLD as e, FONT_NORMAL as t } from "../../console.mjs";
+import { getComponent as n, getFallbackComponent as r } from "../state.mjs";
+import { localessEditable as i } from "../utils/index.mjs";
+import { forwardRef as a } from "react";
+import { jsx as o, jsxs as s } from "react/jsx-runtime";
+//#region src/core/components/localess-component.tsx
+var c = a(({ data: a, links: c, references: l, ...u }, d) => {
+	if (!a) return console.error("LocalessComponent property %cdata%c is not provided.", e, t), /* @__PURE__ */ s("div", { children: [
+		"LocalessComponent property ",
+		/* @__PURE__ */ o("b", { children: "data" }),
+		" is not provided."
+	] });
+	let f = n(a._schema);
+	if (f) return /* @__PURE__ */ o(f, {
+		ref: d,
+		data: a,
+		links: c,
+		references: l,
+		...i(a),
+		...u
+	});
+	let p = r();
+	return p ? /* @__PURE__ */ o(p, {
+		ref: d,
+		data: a,
+		links: c,
+		references: l,
+		...u
+	}) : /* @__PURE__ */ s("p", { children: [
+		/* @__PURE__ */ o("b", { children: "LocalessComponent" }),
+		" could not found component with key ",
+		/* @__PURE__ */ o("b", { children: a._schema }),
+		". ",
+		/* @__PURE__ */ o("br", {}),
+		"Please check if your configuration is correct."
+	] });
+});
+//#endregion
+export { c as LocalessComponent };

package/dist/{rsc.d.ts → core/components/localess-document.d.ts}

@@ -1,16 +1,10 @@
-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-D6tBmv-7.js';
-export { LocalessServerComponent, LocalessServerComponentProps, LocalessServerDocument, LocalessServerDocumentProps } from './ssr.js';
-import { ContentData, 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';
-export { L as LocalessComponent, a as LocalessComponentProps } from './localess-component-DikkO35Z.js';
-import * as react from 'react';
-
+import { Content, ContentData } from '../models';
 /**
  * Props for {@link LocalessDocument}.
  *
  * @template T - The content data shape. Defaults to the base {@link ContentData} type.
  */
-type LocalessDocumentProps<T extends ContentData = ContentData> = {
+export type LocalessDocumentProps<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.
@@ -56,6 +50,4 @@ type LocalessDocumentProps<T extends ContentData = ContentData> = {
  * }
  * ```
  */
-declare const LocalessDocument: react.ForwardRefExoticComponent<LocalessDocumentProps<ContentData> & react.RefAttributes<HTMLElement>>;
-
-export { LocalessDocument, type LocalessDocumentProps };
+export declare const LocalessDocument: import('react').ForwardRefExoticComponent<LocalessDocumentProps<ContentData> & import('react').RefAttributes<HTMLElement>>;

package/dist/core/components/localess-document.js

@@ -0,0 +1 @@
+const e=require(`../../console.js`),t=require(`../state.js`),n=require(`./localess-component.js`);let r=require(`react`),i=require(`react/jsx-runtime`),a=require(`@localess/client`);var o=(0,r.forwardRef)(({document:o},s)=>{let[c,l]=(0,r.useState)(o.data);return(0,r.useEffect)(()=>{t.isSyncEnabled()&&(0,a.isBrowser)()&&(0,a.isIframe)()&&window.localess?.on([`input`,`change`],e=>{(e.type===`change`||e.type===`input`)&&l(e.data)})},[]),c?(0,i.jsx)(n.LocalessComponent,{ref:s,data:c,links:o.links,references:o.references}):(console.error(`LocalessDocument property %cdocument.data%c is not provided.`,e.FONT_BOLD,e.FONT_NORMAL),(0,i.jsxs)(`div`,{children:[`LocalessDocument property `,(0,i.jsx)(`b`,{children:`document.data`}),` is not provided.`]}))});exports.LocalessDocument=o;

package/dist/core/components/localess-document.mjs

@@ -0,0 +1,26 @@
+import { FONT_BOLD as e, FONT_NORMAL as t } from "../../console.mjs";
+import { isSyncEnabled as n } from "../state.mjs";
+import { isBrowser as r, isIframe as i } from "../utils/index.mjs";
+import { LocalessComponent as a } from "./localess-component.mjs";
+import { forwardRef as o, useEffect as s, useState as c } from "react";
+import { jsx as l, jsxs as u } from "react/jsx-runtime";
+//#region src/core/components/localess-document.tsx
+var d = o(({ document: o }, d) => {
+	let [f, p] = c(o.data);
+	return s(() => {
+		n() && r() && i() && window.localess?.on(["input", "change"], (e) => {
+			(e.type === "change" || e.type === "input") && p(e.data);
+		});
+	}, []), f ? /* @__PURE__ */ l(a, {
+		ref: d,
+		data: f,
+		links: o.links,
+		references: o.references
+	}) : (console.error("LocalessDocument property %cdocument.data%c is not provided.", e, t), /* @__PURE__ */ u("div", { children: [
+		"LocalessDocument property ",
+		/* @__PURE__ */ l("b", { children: "document.data" }),
+		" is not provided."
+	] }));
+});
+//#endregion
+export { d as LocalessDocument };

package/dist/core/hooks/index.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Core hooks barrel.
+ *
+ * useLocaless<T>(slug, options?) — fetch content by slug inside a Client Component ('use client').
+ *                                   Accepts a string or string[] slug (array joined with '/').
+ *                                   Subscribes to Visual Editor sync events when isSyncEnabled() is true.
+ *                                   Returns Content<T> | undefined.
+ */
+export * from './use-localess';

package/dist/core/hooks/use-localess.d.ts

@@ -0,0 +1,45 @@
+import { ContentFetchParams } from '@localess/client';
+import { Content, ContentData } from '../models';
+/**
+ * Options for {@link useLocaless}.
+ * Extends {@link ContentFetchParams} with any future hook-specific settings.
+ */
+export 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' });
+ * ```
+ */
+export declare const useLocaless: <T extends ContentData = ContentData>(slug: string | string[], options?: UseLocalessOptions) => Content<T> | undefined;

package/dist/core/hooks/use-localess.js

@@ -0,0 +1 @@
+const e=require(`../state.js`);let t=require(`react`),n=require(`@localess/client`);var r=(r,i={})=>{let[a,o]=(0,t.useState)(),s=e.getLocalessClient(),c;return c=Array.isArray(r)?r.join(`/`):r,(0,t.useEffect)(()=>{async function t(){let t=await s.getContentBySlug(c,i);o(t),e.isSyncEnabled()&&(0,n.isBrowser)()&&(0,n.isIframe)()&&window.localess?.on([`input`,`change`],e=>{(e.type===`change`||e.type===`input`)&&o({...t,data:e.data})})}t()},[r,i,s]),a};exports.useLocaless=r;

package/dist/core/hooks/use-localess.mjs

@@ -0,0 +1,25 @@
+import { getLocalessClient as e, isSyncEnabled as t } from "../state.mjs";
+import { isBrowser as n, isIframe as r } from "../utils/index.mjs";
+import { useEffect as i, useState as a } from "react";
+//#region src/core/hooks/use-localess.ts
+var o = (o, s = {}) => {
+	let [c, l] = a(), u = e(), d;
+	return d = Array.isArray(o) ? o.join("/") : o, i(() => {
+		async function e() {
+			let e = await u.getContentBySlug(d, s);
+			l(e), t() && n() && r() && window.localess?.on(["input", "change"], (t) => {
+				(t.type === "change" || t.type === "input") && l({
+					...e,
+					data: t.data
+				});
+			});
+		}
+		e();
+	}, [
+		o,
+		s,
+		u
+	]), c;
+};
+//#endregion
+export { o as useLocaless };

package/dist/core/models/client.d.ts

@@ -0,0 +1,43 @@
+import { default as React } from 'react';
+import { LocalessClientOptions } from '@localess/client';
+export type { LocalessClient } 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.
+ */
+export 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.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.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;
+};

package/dist/core/models/content.d.ts

@@ -0,0 +1 @@
+export type { Content, ContentData, ContentMetadata, ContentDataSchema, ContentDataField, ContentAsset, ContentRichText, ContentLink, ContentReference, Links, References, } from '@localess/client';

package/dist/core/models/index.d.ts

@@ -0,0 +1,33 @@
+/**
+ * Core models barrel.
+ *
+ * Client & init types:
+ *   LocalessClient   — the client instance type returned by localessInit / getLocalessClient.
+ *   LocalessOptions  — full init options: LocalessClientOptions + components, fallbackComponent, enableSync.
+ *
+ * Content types:
+ *   Content<T>          — wrapper returned by getContentBySlug / getContentById: { data, links, references }.
+ *   ContentData         — base content shape with _id and _schema fields.
+ *   ContentMetadata     — content metadata (slug, name, locale, publishedAt, updatedAt, …).
+ *   ContentDataSchema   — minimal shape used by localessEditable: { _id, _schema }.
+ *   ContentDataField    — base shape for nested content fields.
+ *   ContentAsset        — asset reference with uri field; pass to resolveAsset() for a full URL.
+ *   ContentRichText     — TipTap document structure; pass to renderRichTextToReact() to render.
+ *   ContentLink         — link reference with type ('content' | 'url') and uri; pass to findLink() to resolve.
+ *   ContentReference    — resolved content reference.
+ *   Links               — Record<string, { fullSlug }> map of content links, keyed by link ID.
+ *   References          — Record<string, ContentData> map of resolved references, keyed by reference ID.
+ *
+ * Sync / Visual Editor types:
+ *   LocalessSync    — type of window.localess (exposes .on() and .onChange()).
+ *   EventToApp      — event payload sent from the Visual Editor to the app.
+ *   EventCallback   — callback signature for window.localess.on(events, callback).
+ *   EventToAppType  — union of Visual Editor event type strings ('input' | 'change' | 'pong' | …).
+ *
+ * Translation types:
+ *   Translations — locale-keyed flat translation record.
+ */
+export * from './client';
+export * from './content';
+export * from './sync';
+export * from './translation';

package/dist/core/models/sync.d.ts

@@ -0,0 +1 @@
+export type { LocalessSync, EventToApp, EventCallback, EventToAppType } from '@localess/client';

package/dist/core/models/translation.d.ts

@@ -0,0 +1 @@
+export type { Translations } from '@localess/client';

package/dist/core/richtext.d.ts

@@ -0,0 +1,26 @@
+import { default as React } from 'react';
+import { ContentRichText } from '@localess/client';
+/**
+ * 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>;
+ * }
+ * ```
+ */
+export declare function renderRichTextToReact(content: ContentRichText): React.ReactNode;

package/dist/core/richtext.js

@@ -0,0 +1 @@
+let e=require(`@tiptap/static-renderer/pm/react`),t=require(`@tiptap/extension-document`),n=require(`@tiptap/extension-text`),r=require(`@tiptap/extension-paragraph`),i=require(`@tiptap/extension-heading`),a=require(`@tiptap/extension-bold`),o=require(`@tiptap/extension-italic`),s=require(`@tiptap/extension-strike`),c=require(`@tiptap/extension-underline`),l=require(`@tiptap/extension-history`),u=require(`@tiptap/extension-list-item`),d=require(`@tiptap/extension-ordered-list`),f=require(`@tiptap/extension-bullet-list`),p=require(`@tiptap/extension-code`),m=require(`@tiptap/extension-code-block-lowlight`),h=require(`@tiptap/extension-link`);function g(g){return(0,e.renderToReactElement)({content:g,extensions:[t.Document,n.Text,r.Paragraph,i.Heading.configure({levels:[1,2,3,4,5,6]}),a.Bold,o.Italic,s.Strike,c.Underline,l.History,u.ListItem,d.OrderedList,f.BulletList,p.Code,m.CodeBlockLowlight,h.Link]})}exports.renderRichTextToReact=g;

package/dist/core/richtext.mjs

@@ -0,0 +1,48 @@
+import { renderToReactElement as e } from "@tiptap/static-renderer/pm/react";
+import { Document as t } from "@tiptap/extension-document";
+import { Text as n } from "@tiptap/extension-text";
+import { Paragraph as r } from "@tiptap/extension-paragraph";
+import { Heading as i } from "@tiptap/extension-heading";
+import { Bold as a } from "@tiptap/extension-bold";
+import { Italic as o } from "@tiptap/extension-italic";
+import { Strike as s } from "@tiptap/extension-strike";
+import { Underline as c } from "@tiptap/extension-underline";
+import { History as l } from "@tiptap/extension-history";
+import { ListItem as u } from "@tiptap/extension-list-item";
+import { OrderedList as d } from "@tiptap/extension-ordered-list";
+import { BulletList as f } from "@tiptap/extension-bullet-list";
+import { Code as p } from "@tiptap/extension-code";
+import { CodeBlockLowlight as m } from "@tiptap/extension-code-block-lowlight";
+import { Link as h } from "@tiptap/extension-link";
+//#region src/core/richtext.ts
+function g(g) {
+	return e({
+		content: g,
+		extensions: [
+			t,
+			n,
+			r,
+			i.configure({ levels: [
+				1,
+				2,
+				3,
+				4,
+				5,
+				6
+			] }),
+			a,
+			o,
+			s,
+			c,
+			l,
+			u,
+			d,
+			f,
+			p,
+			m,
+			h
+		]
+	});
+}
+//#endregion
+export { g as renderRichTextToReact };

package/dist/core/state.d.ts

@@ -0,0 +1,127 @@
+import { default as React } from 'react';
+import { LocalessClient } from '@localess/client';
+import { LocalessOptions, ContentAsset } from './models';
+/**
+ * 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 },
+ * });
+ * ```
+ */
+export 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' });
+ * ```
+ */
+export 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.
+ */
+export declare function registerComponent(key: string, component: React.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.
+ */
+export 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.
+ */
+export declare function setComponents(components: Record<string, React.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.
+ */
+export declare function getComponent(key: string): React.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.
+ */
+export declare function setFallbackComponent(fallbackComponent: React.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`.
+ */
+export declare function getFallbackComponent(): React.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.
+ */
+export declare function isSyncEnabled(): boolean;
+export declare function getOrigin(): string;
+/**
+ * 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} />
+ * ```
+ */
+export declare function resolveAsset(asset: ContentAsset): string;

package/dist/core/state.js

@@ -0,0 +1 @@
+const e=require(`../console.js`);let t=require(`@localess/client`);var n=void 0,r=void 0,i={},a=void 0,o=!1,s=``;function c(e){let{components:c,fallbackComponent:l,enableSync:u,...d}=e;return r=(0,t.localessClient)(d),n=d.origin,s=`${e.origin}/api/v1/spaces/${e.spaceId}/assets/`,i=c||{},a=l,u&&(o=!0,(0,t.loadLocalessSync)(d.origin)),r}function l(){if(!r)throw console.error(`[Localess] No client found. Please check if the Localess is initialized. Use localessInit function.`),Error(`[Localess] No client found.`);return r}function u(e,t){i[e]=t}function d(e){delete i[e]}function f(e){i=e}function p(t){if(Object.hasOwn(i,t))return i[t];console.error(`[Localess] component %c${t}%c can't be found.`,e.FONT_BOLD,e.FONT_NORMAL)}function m(e){a=e}function h(){return a}function g(){return o}function _(){if(!n)throw console.error(`[Localess] No origin found. Please check if the Localess is initialized. Use localessInit function.`),Error(`[Localess] No origin found.`);return n}function v(e){return`${s}${e.uri}`}exports.getComponent=p,exports.getFallbackComponent=h,exports.getLocalessClient=l,exports.getOrigin=_,exports.isSyncEnabled=g,exports.localessInit=c,exports.registerComponent=u,exports.resolveAsset=v,exports.setComponents=f,exports.setFallbackComponent=m,exports.unregisterComponent=d;

package/dist/core/state.mjs

@@ -0,0 +1,43 @@
+import { FONT_BOLD as e, FONT_NORMAL as t } from "../console.mjs";
+import { loadLocalessSync as n, localessClient as r } from "@localess/client";
+//#region src/core/state.ts
+var i = void 0, a = void 0, o = {}, s = void 0, c = !1, l = "";
+function u(e) {
+	let { components: t, fallbackComponent: u, enableSync: d, ...f } = e;
+	return a = r(f), i = f.origin, l = `${e.origin}/api/v1/spaces/${e.spaceId}/assets/`, o = t || {}, s = u, d && (c = !0, n(f.origin)), a;
+}
+function d() {
+	if (!a) throw console.error("[Localess] No client found. Please check if the Localess is initialized. Use localessInit function."), Error("[Localess] No client found.");
+	return a;
+}
+function f(e, t) {
+	o[e] = t;
+}
+function p(e) {
+	delete o[e];
+}
+function m(e) {
+	o = e;
+}
+function h(n) {
+	if (Object.hasOwn(o, n)) return o[n];
+	console.error(`[Localess] component %c${n}%c can't be found.`, e, t);
+}
+function g(e) {
+	s = e;
+}
+function _() {
+	return s;
+}
+function v() {
+	return c;
+}
+function y() {
+	if (!i) throw console.error("[Localess] No origin found. Please check if the Localess is initialized. Use localessInit function."), Error("[Localess] No origin found.");
+	return i;
+}
+function b(e) {
+	return `${l}${e.uri}`;
+}
+//#endregion
+export { h as getComponent, _ as getFallbackComponent, d as getLocalessClient, y as getOrigin, v as isSyncEnabled, u as localessInit, f as registerComponent, b as resolveAsset, m as setComponents, g as setFallbackComponent, p as unregisterComponent };

package/dist/core/utils/index.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Core utils barrel.
+ *
+ * From @localess/client:
+ *   localessEditable(content)           — returns { 'data-ll-id', 'data-ll-schema' } for Visual Editor targeting.
+ *                                         Spread on a component's root element.
+ *   localessEditableField<T>(fieldName) — returns { 'data-ll-field' } for field-level Visual Editor targeting.
+ *                                         Generic type T restricts fieldName to valid content keys.
+ *   isBrowser  — true when running in a browser (window is defined).
+ *   isServer   — true when running in a Node.js / server environment.
+ *   isIframe   — true when the page is loaded inside an iframe (i.e. inside the Visual Editor).
+ *
+ * Local:
+ *   findLink(links, link) — resolve a ContentLink to a URL string.
+ *                           Returns '/' + fullSlug for type:'content', raw uri for type:'url',
+ *                           '/not-found' when the link cannot be resolved.
+ */
+export { localessEditable, localessEditableField, isBrowser, isServer, isIframe } from '@localess/client';
+export * from './link.util';

package/dist/core/utils/index.mjs

@@ -0,0 +1,3 @@
+import "./link.util.mjs";
+import { isBrowser as e, isIframe as t, isServer as n, localessEditable as r, localessEditableField as i } from "@localess/client";
+export { e as isBrowser, t as isIframe, n as isServer, r as localessEditable, i as localessEditableField };

package/dist/core/utils/link.util.d.ts

@@ -0,0 +1,24 @@
+import { ContentLink, Links } from '../models';
+/**
+ * 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>;
+ * }
+ * ```
+ */
+export declare function findLink(links: Links | undefined, link: ContentLink): string;

package/dist/core/utils/link.util.js

@@ -0,0 +1 @@
+function e(e,t){switch(t.type){case`content`:if(e){let n=e[t.uri];return n?`/`+n.fullSlug:`/not-found`}return`/not-found`;case`url`:return t.uri;default:return`no-type`}}exports.findLink=e;