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

package/dist/richtext-XH7pH80J.d.ts

@@ -0,0 +1,82 @@
+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/rsc.d.mts

@@ -0,0 +1,5 @@
+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 { LocalessServerComponent, LocalessServerComponentProps, LocalessServerDocument, LocalessServerDocumentProps } from './ssr.mjs';
+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';

package/dist/rsc.d.ts

@@ -0,0 +1,5 @@
+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 { LocalessServerComponent, LocalessServerComponentProps, LocalessServerDocument, LocalessServerDocumentProps } from './ssr.js';
+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';

package/dist/rsc.js

@@ -0,0 +1,294 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/rsc/index.ts
+var rsc_exports = {};
+__export(rsc_exports, {
+  LocalessComponent: () => LocalessComponent,
+  LocalessServerComponent: () => LocalessServerComponent,
+  LocalessServerDocument: () => LocalessServerDocument,
+  findLink: () => findLink,
+  getComponent: () => getComponent,
+  getFallbackComponent: () => getFallbackComponent,
+  getLocalessClient: () => getLocalessClient,
+  isBrowser: () => import_client2.isBrowser,
+  isIframe: () => import_client2.isIframe,
+  isServer: () => import_client2.isServer,
+  isSyncEnabled: () => isSyncEnabled,
+  localessEditable: () => import_client2.localessEditable,
+  localessEditableField: () => import_client2.localessEditableField,
+  localessInit: () => localessInit,
+  registerComponent: () => registerComponent,
+  renderRichTextToReact: () => renderRichTextToReact,
+  resolveAsset: () => resolveAsset,
+  unregisterComponent: () => unregisterComponent,
+  useLocaless: () => useLocaless
+});
+module.exports = __toCommonJS(rsc_exports);
+
+// src/core/state.ts
+var import_client = require("@localess/client");
+
+// src/console.ts
+var FONT_BOLD = "font-weight: bold";
+var FONT_NORMAL = "font-weight: normal";
+
+// src/core/state.ts
+var _client = void 0;
+var _components = {};
+var _fallbackComponent = void 0;
+var _enableSync = false;
+var _assetPathPrefix = "";
+function localessInit(options) {
+  console.log("localessInit", options);
+  const { components, fallbackComponent, enableSync, ...restOptions } = options;
+  _client = (0, import_client.localessClient)(restOptions);
+  _assetPathPrefix = `${options.origin}/api/v1/spaces/${options.spaceId}/assets/`;
+  _components = components || {};
+  _fallbackComponent = fallbackComponent;
+  if (enableSync) {
+    _enableSync = true;
+    (0, import_client.loadLocalessSync)(restOptions.origin);
+  }
+  return _client;
+}
+function getLocalessClient() {
+  if (!_client) {
+    console.error("[Localess] No client found. Please check if the Localess is initialized.");
+    throw new Error("[Localess] No client found.");
+  }
+  return _client;
+}
+function registerComponent(key, component) {
+  _components[key] = component;
+}
+function unregisterComponent(key) {
+  delete _components[key];
+}
+function getComponent(key) {
+  if (Object.hasOwn(_components, key)) {
+    return _components[key];
+  }
+  console.error(`[Localess] component %c${key}%c can't be found.`, FONT_BOLD, FONT_NORMAL);
+  return void 0;
+}
+function getFallbackComponent() {
+  return _fallbackComponent;
+}
+function isSyncEnabled() {
+  return _enableSync;
+}
+function resolveAsset(asset) {
+  return `${_assetPathPrefix}${asset.uri}`;
+}
+
+// src/ssr/localess-component.tsx
+var import_react = require("react");
+var import_jsx_runtime = require("react/jsx-runtime");
+var LocalessServerComponent = (0, import_react.forwardRef)(({ data, links, references, ...restProps }, ref) => {
+  if (!data) {
+    console.error("LocalessServerComponent property %cdata%c is not provided.", FONT_BOLD, FONT_NORMAL);
+    return /* @__PURE__ */ (0, import_jsx_runtime.jsxs)("div", { children: [
+      "LocalessServerComponent property ",
+      /* @__PURE__ */ (0, import_jsx_runtime.jsx)("b", { children: "data" }),
+      " is not provided."
+    ] });
+  }
+  const Comp = getComponent(data._schema);
+  if (Comp) {
+    return /* @__PURE__ */ (0, import_jsx_runtime.jsx)(Comp, { ref, data, links, references, ...restProps });
+  }
+  const FallbackComponent = getFallbackComponent();
+  if (FallbackComponent) {
+    return /* @__PURE__ */ (0, import_jsx_runtime.jsx)(FallbackComponent, { ref, data, links, references, ...restProps });
+  }
+  return /* @__PURE__ */ (0, import_jsx_runtime.jsxs)("p", { children: [
+    /* @__PURE__ */ (0, import_jsx_runtime.jsx)("b", { children: "LocalessServerComponent" }),
+    " could not found component with key ",
+    /* @__PURE__ */ (0, import_jsx_runtime.jsx)("b", { children: data._schema }),
+    ". ",
+    /* @__PURE__ */ (0, import_jsx_runtime.jsx)("br", {}),
+    "Please check if your configuration is correct."
+  ] });
+});
+
+// src/ssr/localess-document.tsx
+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) {
+    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 ",
+      /* @__PURE__ */ (0, import_jsx_runtime2.jsx)("b", { children: "document.data" }),
+      " is not provided."
+    ] });
+  }
+  return /* @__PURE__ */ (0, import_jsx_runtime2.jsx)(LocalessServerComponent, { ref, data: document.data, links: document.links, references: document.references });
+});
+
+// src/core/richtext.ts
+var import_react3 = require("@tiptap/static-renderer/pm/react");
+var import_extension_document = require("@tiptap/extension-document");
+var import_extension_text = require("@tiptap/extension-text");
+var import_extension_paragraph = require("@tiptap/extension-paragraph");
+var import_extension_heading = require("@tiptap/extension-heading");
+var import_extension_bold = require("@tiptap/extension-bold");
+var import_extension_italic = require("@tiptap/extension-italic");
+var import_extension_strike = require("@tiptap/extension-strike");
+var import_extension_underline = require("@tiptap/extension-underline");
+var import_extension_history = require("@tiptap/extension-history");
+var import_extension_list_item = require("@tiptap/extension-list-item");
+var import_extension_ordered_list = require("@tiptap/extension-ordered-list");
+var import_extension_bullet_list = require("@tiptap/extension-bullet-list");
+var import_extension_code = require("@tiptap/extension-code");
+var import_extension_code_block_lowlight = require("@tiptap/extension-code-block-lowlight");
+var import_extension_link = require("@tiptap/extension-link");
+function renderRichTextToReact(content) {
+  return (0, import_react3.renderToReactElement)({
+    content,
+    extensions: [
+      import_extension_document.Document,
+      import_extension_text.Text,
+      import_extension_paragraph.Paragraph,
+      import_extension_heading.Heading.configure({
+        levels: [1, 2, 3, 4, 5, 6]
+      }),
+      import_extension_bold.Bold,
+      import_extension_italic.Italic,
+      import_extension_strike.Strike,
+      import_extension_underline.Underline,
+      import_extension_history.History,
+      import_extension_list_item.ListItem,
+      import_extension_ordered_list.OrderedList,
+      import_extension_bullet_list.BulletList,
+      import_extension_code.Code,
+      import_extension_code_block_lowlight.CodeBlockLowlight,
+      import_extension_link.Link
+    ]
+  });
+}
+
+// src/core/utils/index.ts
+var import_client2 = require("@localess/client");
+
+// src/core/utils/link.util.ts
+function findLink(links, link) {
+  switch (link.type) {
+    case "content": {
+      if (links) {
+        const path = links[link.uri];
+        if (path) {
+          return "/" + path.fullSlug;
+        } else {
+          return "/not-found";
+        }
+      }
+      return "/not-found";
+    }
+    case "url":
+      return link.uri;
+    default:
+      return "no-type";
+  }
+}
+
+// src/core/components/localess-component.tsx
+var import_react4 = require("react");
+var import_jsx_runtime3 = require("react/jsx-runtime");
+var LocalessComponent = (0, import_react4.forwardRef)(
+  ({ data, links, references, ...restProps }, ref) => {
+    if (!data) {
+      console.error("LocalessComponent property %cdata%c is not provided.", FONT_BOLD, FONT_NORMAL);
+      return /* @__PURE__ */ (0, import_jsx_runtime3.jsxs)("div", { children: [
+        "LocalessComponent property ",
+        /* @__PURE__ */ (0, import_jsx_runtime3.jsx)("b", { children: "data" }),
+        " is not provided."
+      ] });
+    }
+    const Comp = getComponent(data._schema);
+    if (Comp) {
+      const attr = isSyncEnabled() ? (0, import_client2.localessEditable)(data) : {};
+      return /* @__PURE__ */ (0, import_jsx_runtime3.jsx)(Comp, { ref, data, links, references, ...attr, ...restProps });
+    }
+    const FallbackComponent = getFallbackComponent();
+    if (FallbackComponent) {
+      return /* @__PURE__ */ (0, import_jsx_runtime3.jsx)(FallbackComponent, { ref, data, links, references, ...restProps });
+    }
+    return /* @__PURE__ */ (0, import_jsx_runtime3.jsxs)("p", { children: [
+      /* @__PURE__ */ (0, import_jsx_runtime3.jsx)("b", { children: "LocalessComponent" }),
+      " could not found component with key ",
+      /* @__PURE__ */ (0, import_jsx_runtime3.jsx)("b", { children: data._schema }),
+      ". ",
+      /* @__PURE__ */ (0, import_jsx_runtime3.jsx)("br", {}),
+      "Please check if your configuration is correct."
+    ] });
+  }
+);
+
+// src/core/hooks/use-localess.ts
+var import_react5 = require("react");
+var import_client3 = require("@localess/client");
+var useLocaless = (slug, options = {}) => {
+  const [document, setDocument] = (0, import_react5.useState)();
+  const client = getLocalessClient();
+  let normalizedSlug;
+  if (Array.isArray(slug)) {
+    normalizedSlug = slug.join("/");
+  } else {
+    normalizedSlug = slug;
+  }
+  (0, import_react5.useEffect)(() => {
+    async function loadDocument() {
+      const document2 = await client.getContentBySlug(normalizedSlug, options);
+      setDocument(document2);
+      if (isSyncEnabled() && (0, import_client3.isBrowser)()) {
+        window.localess?.on(["input", "change"], (event) => {
+          if (event.type === "change" || event.type === "input") {
+            setDocument({ ...document2, data: event.data });
+          }
+        });
+      }
+    }
+    loadDocument();
+  }, [slug, options, client]);
+  return document;
+};
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  LocalessComponent,
+  LocalessServerComponent,
+  LocalessServerDocument,
+  findLink,
+  getComponent,
+  getFallbackComponent,
+  getLocalessClient,
+  isBrowser,
+  isIframe,
+  isServer,
+  isSyncEnabled,
+  localessEditable,
+  localessEditableField,
+  localessInit,
+  registerComponent,
+  renderRichTextToReact,
+  resolveAsset,
+  unregisterComponent,
+  useLocaless
+});

package/dist/rsc.mjs

@@ -0,0 +1,46 @@
+import {
+  LocalessComponent,
+  useLocaless
+} from "./chunk-V6JSXN66.mjs";
+import {
+  LocalessServerComponent,
+  LocalessServerDocument
+} from "./chunk-AJP75NRT.mjs";
+import {
+  findLink,
+  getComponent,
+  getFallbackComponent,
+  getLocalessClient,
+  isBrowser,
+  isIframe,
+  isServer,
+  isSyncEnabled,
+  localessEditable,
+  localessEditableField,
+  localessInit,
+  registerComponent,
+  renderRichTextToReact,
+  resolveAsset,
+  unregisterComponent
+} from "./chunk-ETSLIILF.mjs";
+export {
+  LocalessComponent,
+  LocalessServerComponent,
+  LocalessServerDocument,
+  findLink,
+  getComponent,
+  getFallbackComponent,
+  getLocalessClient,
+  isBrowser,
+  isIframe,
+  isServer,
+  isSyncEnabled,
+  localessEditable,
+  localessEditableField,
+  localessInit,
+  registerComponent,
+  renderRichTextToReact,
+  resolveAsset,
+  unregisterComponent,
+  useLocaless
+};

package/dist/ssr.d.mts

@@ -0,0 +1,18 @@
+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';
+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';
+
+type LocalessServerComponentProps<T extends ContentData = ContentData> = {
+    data: T;
+    links?: Links;
+    references?: References;
+};
+declare const LocalessServerComponent: React.ForwardRefExoticComponent<LocalessServerComponentProps<ContentData> & React.RefAttributes<HTMLElement>>;
+
+type LocalessServerDocumentProps<T extends ContentData = ContentData> = {
+    document: Content<T>;
+};
+declare const LocalessServerDocument: React.ForwardRefExoticComponent<LocalessServerDocumentProps<ContentData> & React.RefAttributes<HTMLElement>>;
+
+export { LocalessServerComponent, type LocalessServerComponentProps, LocalessServerDocument, type LocalessServerDocumentProps };

package/dist/ssr.d.ts

@@ -0,0 +1,18 @@
+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';
+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';
+
+type LocalessServerComponentProps<T extends ContentData = ContentData> = {
+    data: T;
+    links?: Links;
+    references?: References;
+};
+declare const LocalessServerComponent: React.ForwardRefExoticComponent<LocalessServerComponentProps<ContentData> & React.RefAttributes<HTMLElement>>;
+
+type LocalessServerDocumentProps<T extends ContentData = ContentData> = {
+    document: Content<T>;
+};
+declare const LocalessServerDocument: React.ForwardRefExoticComponent<LocalessServerDocumentProps<ContentData> & React.RefAttributes<HTMLElement>>;
+
+export { LocalessServerComponent, type LocalessServerComponentProps, LocalessServerDocument, type LocalessServerDocumentProps };