@localess/react 3.0.10-dev.20260520210718 → 3.1.0-dev.20260529181548

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

@@ -1,8 +1,2 @@
-/**
- * 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/core/components/localess-component.d.ts

@@ -1,4 +1,4 @@
-import { ContentData, Links, References } from '../models';
+import { Assets, ContentData, Links, References } from '../models';
 /**
  * Props for {@link LocalessComponent}.
  *
@@ -20,6 +20,11 @@ export type LocalessComponentProps<T extends ContentData = ContentData> = {
      * Pass through to child components that consume referenced content.
      */
     references?: References;
+    /**
+     * Optional map of resolved content assets keyed by asset ID.
+     * Pass through to child components that consume asset content.
+     */
+    assets?: Assets;
 };
 /**
  * Dynamic schema-to-component renderer for use in SPA and client-side contexts.

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

@@ -1 +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;
+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,assets:s,...c},l)=>{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 u=t.getComponent(n._schema);if(u)return(0,r.jsx)(u,{ref:l,data:n,assets:s,links:a,references:o,...(0,i.localessEditable)(n),...c});let d=t.getFallbackComponent();return d?(0,r.jsx)(d,{ref:l,data:n,assets:s,links:a,references:o,...c}):(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

@@ -4,28 +4,30 @@ 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) => {
+var c = a(({ data: a, links: c, references: l, assets: u, ...d }, f) => {
 	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,
+	let p = n(a._schema);
+	if (p) return /* @__PURE__ */ o(p, {
+		ref: f,
 		data: a,
+		assets: u,
 		links: c,
 		references: l,
 		...i(a),
-		...u
+		...d
 	});
-	let p = r();
-	return p ? /* @__PURE__ */ o(p, {
-		ref: d,
+	let m = r();
+	return m ? /* @__PURE__ */ o(m, {
+		ref: f,
 		data: a,
+		assets: u,
 		links: c,
 		references: l,
-		...u
+		...d
 	}) : /* @__PURE__ */ s("p", { children: [
 		/* @__PURE__ */ o("b", { children: "LocalessComponent" }),
 		" could not found component with key ",

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

@@ -1 +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;
+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,assets:o.assets,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

@@ -14,6 +14,7 @@ var d = o(({ document: o }, d) => {
 	}, []), f ? /* @__PURE__ */ l(a, {
 		ref: d,
 		data: f,
+		assets: o.assets,
 		links: o.links,
 		references: o.references
 	}) : (console.error("LocalessDocument property %cdocument.data%c is not provided.", e, t), /* @__PURE__ */ u("div", { children: [

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

@@ -1,9 +1 @@
-/**
- * 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/models/content.d.ts

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

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

@@ -1,32 +1,3 @@
-/**
- * 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';

package/dist/core/state.d.ts

@@ -117,6 +117,7 @@ export declare function getOrigin(): string;
  * `{origin}/api/v1/spaces/{spaceId}/assets/{asset.uri}`
  *
  * @param asset - The asset reference object containing a `uri` field.
+ * @param params
  * @returns The fully qualified asset URL string.
  *
  * @example

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

@@ -1,19 +1,2 @@
-/**
- * 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 * from './link.util';
 export { AssetTransformParams, isBrowser, isIframe, isServer, localessEditable, localessEditableField } from '@localess/client';

package/dist/index.d.ts

@@ -18,9 +18,9 @@
  * import { localessInit, LocalessComponent, useLocaless, localessEditable } from '@localess/react';
  * ```
  */
-export * from './core/state';
 export * from './core/components';
 export * from './core/hooks';
-export * from './core/utils';
-export * from './core/richtext';
 export type * from './core/models';
+export * from './core/richtext';
+export * from './core/state';
+export * from './core/utils';

package/dist/rsc/localess-document.js

@@ -1 +1 @@
-const e=require(`../console.js`),t=require(`../core/state.js`),n=require(`../core/components/localess-component.js`),r=require(`./localess-sync.js`);let i=require(`react`),a=require(`react/jsx-runtime`);var o=(0,i.forwardRef)(({document:i},o)=>i.data?(0,a.jsxs)(a.Fragment,{children:[(0,a.jsx)(n.LocalessComponent,{ref:o,data:i.data,links:i.links,references:i.references}),(0,a.jsx)(r.LocalessSync,{document:i,origin:t.getOrigin(),enableSync:t.isSyncEnabled()})]}):(console.error(`LocalessDocument property %cdocument.data%c is not provided.`,e.FONT_BOLD,e.FONT_NORMAL),(0,a.jsxs)(`div`,{children:[`LocalessDocument property `,(0,a.jsx)(`b`,{children:`document.data`}),` is not provided.`]})));exports.LocalessDocument=o;
+const e=require(`../console.js`),t=require(`../core/state.js`),n=require(`../core/components/localess-component.js`),r=require(`./localess-sync.js`);let i=require(`react`),a=require(`react/jsx-runtime`);var o=(0,i.forwardRef)(({document:i},o)=>i.data?(0,a.jsxs)(a.Fragment,{children:[(0,a.jsx)(n.LocalessComponent,{ref:o,data:i.data,assets:i.assets,links:i.links,references:i.references}),(0,a.jsx)(r.LocalessSync,{document:i,origin:t.getOrigin(),enableSync:t.isSyncEnabled()})]}):(console.error(`LocalessDocument property %cdocument.data%c is not provided.`,e.FONT_BOLD,e.FONT_NORMAL),(0,a.jsxs)(`div`,{children:[`LocalessDocument property `,(0,a.jsx)(`b`,{children:`document.data`}),` is not provided.`]})));exports.LocalessDocument=o;

package/dist/rsc/localess-document.mjs

@@ -8,6 +8,7 @@ import { Fragment as s, jsx as c, jsxs as l } from "react/jsx-runtime";
 var u = o(({ document: o }, u) => o.data ? /* @__PURE__ */ l(s, { children: [/* @__PURE__ */ c(i, {
 	ref: u,
 	data: o.data,
+	assets: o.assets,
 	links: o.links,
 	references: o.references
 }), /* @__PURE__ */ c(a, {

package/dist/rsc/localess-sync.js

@@ -1 +1 @@
-"use client";let e=require(`@localess/client`),t=require(`react`);var n=n=>(console.info(`LocalessSync:init`),(0,t.useEffect)(()=>{async function t(){n.enableSync&&(0,e.isBrowser)()&&(0,e.isIframe)()&&(await(0,e.loadLocalessSync)(n.origin),window.localess?.on([`input`,`change`],e=>{console.info(`LocalessSync:change:`,e),(e.type===`change`||e.type===`input`)&&(n.document.data=e.data)}))}t()},[]),null);exports.LocalessSync=n;
+"use client";let e=require(`react`),t=require(`@localess/client`);var n=n=>(console.info(`LocalessSync:init`),(0,e.useEffect)(()=>{async function e(){n.enableSync&&(0,t.isBrowser)()&&(0,t.isIframe)()&&(await(0,t.loadLocalessSync)(n.origin),window.localess?.on([`input`,`change`],e=>{console.info(`LocalessSync:change:`,e),(e.type===`change`||e.type===`input`)&&(n.document.data=e.data)}))}e()},[]),null);exports.LocalessSync=n;

package/dist/rsc/localess-sync.mjs

@@ -1,15 +1,15 @@
 "use client";
 import { isBrowser as e, isIframe as t } from "../core/utils/index.mjs";
-import { loadLocalessSync as n } from "@localess/client";
-import { useEffect as r } from "react";
+import { useEffect as n } from "react";
+import { loadLocalessSync as r } from "@localess/client";
 //#region src/rsc/localess-sync.tsx
-var i = (i) => (console.info("LocalessSync:init"), r(() => {
-	async function r() {
-		i.enableSync && e() && t() && (await n(i.origin), window.localess?.on(["input", "change"], (e) => {
+var i = (i) => (console.info("LocalessSync:init"), n(() => {
+	async function n() {
+		i.enableSync && e() && t() && (await r(i.origin), window.localess?.on(["input", "change"], (e) => {
 			console.info("LocalessSync:change:", e), (e.type === "change" || e.type === "input") && (i.document.data = e.data);
 		}));
 	}
-	r();
+	n();
 }, []), null);
 //#endregion
 export { i as LocalessSync };

package/dist/ssr/localess-component.d.ts

@@ -1,4 +1,4 @@
-import { ContentData, Links, References } from '../core/models';
+import { Assets, ContentData, Links, References } from '../core/models';
 /**
  * Props for {@link LocalessServerComponent}.
  *
@@ -20,6 +20,11 @@ export type LocalessServerComponentProps<T extends ContentData = ContentData> =
      * Pass through to child components that consume referenced content.
      */
     references?: References;
+    /**
+     * Optional map of resolved content assets keyed by asset ID.
+     * Pass through to child components that consume asset content.
+     */
+    assets?: Assets;
 };
 /**
  * Server-safe dynamic schema-to-component renderer for SSR and static-export environments.

package/dist/ssr/localess-component.js

@@ -1 +1 @@
-const e=require(`../console.js`),t=require(`../core/state.js`);let n=require(`react`),r=require(`react/jsx-runtime`);var i=(0,n.forwardRef)(({data:n,links:i,references:a,...o},s)=>{if(!n)return console.error(`LocalessServerComponent property %cdata%c is not provided.`,e.FONT_BOLD,e.FONT_NORMAL),(0,r.jsxs)(`div`,{children:[`LocalessServerComponent property `,(0,r.jsx)(`b`,{children:`data`}),` is not provided.`]});let c=t.getComponent(n._schema);if(c)return(0,r.jsx)(c,{ref:s,data:n,links:i,references:a,...o});let l=t.getFallbackComponent();return l?(0,r.jsx)(l,{ref:s,data:n,links:i,references:a,...o}):(0,r.jsxs)(`p`,{children:[(0,r.jsx)(`b`,{children:`LocalessServerComponent`}),` 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.LocalessServerComponent=i;
+const e=require(`../console.js`),t=require(`../core/state.js`);let n=require(`react`),r=require(`react/jsx-runtime`);var i=(0,n.forwardRef)(({data:n,assets:i,links:a,references:o,...s},c)=>{if(!n)return console.error(`LocalessServerComponent property %cdata%c is not provided.`,e.FONT_BOLD,e.FONT_NORMAL),(0,r.jsxs)(`div`,{children:[`LocalessServerComponent 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,assets:i,links:a,references:o,...s});let u=t.getFallbackComponent();return u?(0,r.jsx)(u,{ref:c,data:n,assets:i,links:a,references:o,...s}):(0,r.jsxs)(`p`,{children:[(0,r.jsx)(`b`,{children:`LocalessServerComponent`}),` 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.LocalessServerComponent=i;

package/dist/ssr/localess-component.mjs

@@ -3,27 +3,29 @@ import { getComponent as n, getFallbackComponent as r } from "../core/state.mjs"
 import { forwardRef as i } from "react";
 import { jsx as a, jsxs as o } from "react/jsx-runtime";
 //#region src/ssr/localess-component.tsx
-var s = i(({ data: i, links: s, references: c, ...l }, u) => {
+var s = i(({ data: i, assets: s, links: c, references: l, ...u }, d) => {
 	if (!i) return console.error("LocalessServerComponent property %cdata%c is not provided.", e, t), /* @__PURE__ */ o("div", { children: [
 		"LocalessServerComponent property ",
 		/* @__PURE__ */ a("b", { children: "data" }),
 		" is not provided."
 	] });
-	let d = n(i._schema);
-	if (d) return /* @__PURE__ */ a(d, {
-		ref: u,
+	let f = n(i._schema);
+	if (f) return /* @__PURE__ */ a(f, {
+		ref: d,
 		data: i,
-		links: s,
-		references: c,
-		...l
+		assets: s,
+		links: c,
+		references: l,
+		...u
 	});
-	let f = r();
-	return f ? /* @__PURE__ */ a(f, {
-		ref: u,
+	let p = r();
+	return p ? /* @__PURE__ */ a(p, {
+		ref: d,
 		data: i,
-		links: s,
-		references: c,
-		...l
+		assets: s,
+		links: c,
+		references: l,
+		...u
 	}) : /* @__PURE__ */ o("p", { children: [
 		/* @__PURE__ */ a("b", { children: "LocalessServerComponent" }),
 		" could not found component with key ",

package/dist/ssr/localess-document.js

@@ -1 +1 @@
-const e=require(`../console.js`),t=require(`./localess-component.js`);let n=require(`react`),r=require(`react/jsx-runtime`);var i=(0,n.forwardRef)(({document:n},i)=>n.data?(0,r.jsx)(t.LocalessServerComponent,{ref:i,data:n.data,links:n.links,references:n.references}):(console.error(`LocalessServerDocument property %cdocument.data%c is not provided.`,e.FONT_BOLD,e.FONT_NORMAL),(0,r.jsxs)(`div`,{children:[`LocalessServerDocument property `,(0,r.jsx)(`b`,{children:`document.data`}),` is not provided.`]})));exports.LocalessServerDocument=i;
+const e=require(`../console.js`),t=require(`./localess-component.js`);let n=require(`react`),r=require(`react/jsx-runtime`);var i=(0,n.forwardRef)(({document:n},i)=>n.data?(0,r.jsx)(t.LocalessServerComponent,{ref:i,data:n.data,assets:n.assets,links:n.links,references:n.references}):(console.error(`LocalessServerDocument property %cdocument.data%c is not provided.`,e.FONT_BOLD,e.FONT_NORMAL),(0,r.jsxs)(`div`,{children:[`LocalessServerDocument property `,(0,r.jsx)(`b`,{children:`document.data`}),` is not provided.`]})));exports.LocalessServerDocument=i;

package/dist/ssr/localess-document.mjs

@@ -6,6 +6,7 @@ import { jsx as i, jsxs as a } from "react/jsx-runtime";
 var o = r(({ document: r }, o) => r.data ? /* @__PURE__ */ i(n, {
 	ref: o,
 	data: r.data,
+	assets: r.assets,
 	links: r.links,
 	references: r.references
 }) : (console.error("LocalessServerDocument property %cdocument.data%c is not provided.", e, t), /* @__PURE__ */ a("div", { children: [

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@localess/react",
-  "version": "3.0.10-dev.20260520210718",
+  "version": "3.1.0-dev.20260529181548",
   "description": "ReactJS JavaScript/TypeScript SDK for Localess's API.",
   "keywords": [
     "localess",
@@ -61,7 +61,7 @@
     "react-dom": "^17 || ^18 || ^19"
   },
   "dependencies": {
-    "@localess/client": "3.0.10-dev.20260520210718",
+    "@localess/client": "3.1.0-dev.20260529181548",
     "@tiptap/extension-bold": "^3.22.5",
     "@tiptap/extension-bullet-list": "^3.22.5",
     "@tiptap/extension-code": "^3.22.5",