@draftbase/renderer 0.5.2 → 0.5.3

package/dist/MDXContent.d.ts

@@ -1,6 +1,6 @@
 import type { MDXComponents } from "mdx/types";
 import type { ComponentType, ElementType, ReactNode } from "react";
-import { type FailedMDX } from "./core.js";
+import { type FailedMDX, type LinkedEntryData } from "./core.js";
 export interface CompiledMDX {
     ok: true;
     Content: ComponentType<{
@@ -33,9 +33,14 @@ export interface MDXContentProps {
      * throws while rendering. Either way the fallback plain-text output still renders instead of
      * crashing. */
     onError?: (error: unknown) => void;
+    /** The containing entry's own `entryLinks` (from `getEntry`/`getEntries` called with `include`
+     * set) — id-keyed resolved data for every `<EntryLink id="...">` found in `source`. When given,
+     * each `EntryLink` instance receives its target's data as extra props, so `components.EntryLink`
+     * doesn't need to re-fetch it. */
+    entryLinks?: Record<string, LinkedEntryData>;
 }
 /**
  * Next.js Server Component wrapper around {@link compileMDX}. For non-RSC React, call `compileMDX` directly instead —
  * `await` inside a component body only works as an RSC.
  */
-export declare function MDXContent({ source, components, unstyled, className, wrapperTag, errorTag, onError, }: MDXContentProps): Promise<ReactNode>;
+export declare function MDXContent({ source, components, unstyled, className, wrapperTag, errorTag, onError, entryLinks, }: MDXContentProps): Promise<ReactNode>;

package/dist/MDXContent.js

@@ -1,6 +1,6 @@
 import { jsx as _jsx, Fragment as _Fragment, jsxs as _jsxs } from "react/jsx-runtime";
 import * as runtime from "react/jsx-runtime";
-import { compileMDXCore, makeDefaultEntryLink, makeDefaultImage } from "./core.js";
+import { compileMDXCore, makeDefaultEntryLink, makeDefaultImage, withEntryLinkData, } from "./core.js";
 import { wrapperClassName } from "./wrapperClassName.js";
 import { MDXErrorBoundary } from "./MDXErrorBoundary.js";
 import { CSS_TEXT } from "./cssText.js";
@@ -19,10 +19,16 @@ export async function compileMDX(source) {
  * Next.js Server Component wrapper around {@link compileMDX}. For non-RSC React, call `compileMDX` directly instead —
  * `await` inside a component body only works as an RSC.
  */
-export async function MDXContent({ source, components, unstyled, className, wrapperTag = "div", errorTag = "p", onError, }) {
+export async function MDXContent({ source, components, unstyled, className, wrapperTag = "div", errorTag = "p", onError, entryLinks, }) {
     const Wrapper = wrapperTag;
     const ErrorTag = errorTag;
     const wrapperClass = wrapperClassName(unstyled, className);
+    const effectiveComponents = entryLinks
+        ? {
+            ...components,
+            EntryLink: withEntryLinkData(components?.EntryLink ?? defaultComponents.EntryLink, entryLinks, runtime),
+        }
+        : components;
     // `href` + `precedence` make React DOM treat this as a de-duplicated, hoisted stylesheet
     // resource (React 19+) instead of a plain inline tag repeated per render.
     const styles = unstyled ? null : (_jsx("style", { href: "db-content-styles", precedence: "default", children: CSS_TEXT }));
@@ -35,5 +41,5 @@ export async function MDXContent({ source, components, unstyled, className, wrap
         return (_jsxs(_Fragment, { children: [styles, _jsx(Wrapper, { className: wrapperClass, children: _jsx(ErrorTag, { children: source }) })] }));
     }
     const { Content } = compiled;
-    return (_jsxs(_Fragment, { children: [styles, _jsx(Wrapper, { className: wrapperClass, children: _jsx(MDXErrorBoundary, { fallback: _jsx(ErrorTag, { children: source }), onError: onError, children: _jsx(Content, { components: components }) }) })] }));
+    return (_jsxs(_Fragment, { children: [styles, _jsx(Wrapper, { className: wrapperClass, children: _jsx(MDXErrorBoundary, { fallback: _jsx(ErrorTag, { children: source }), onError: onError, children: _jsx(Content, { components: effectiveComponents }) }) })] }));
 }

package/dist/core.d.ts

@@ -13,12 +13,31 @@ export interface FailedMDX {
  * the remark/rehype pipeline. `defaultComponents`, when given, are merged underneath the caller's own `components` (caller always wins per-tag).
  */
 export declare function compileMDXCore<TComponent>(source: string, jsxRuntime: JsxRuntime, defaultComponents?: Record<string, unknown>): Promise<CompiledMDX<TComponent> | FailedMDX>;
-/** Default `EntryLink` for a given JSX runtime — renders `<a href="/entries/{id}">`; apps that
- * route entries differently override it by passing `components.EntryLink`. */
-export declare function makeDefaultEntryLink(jsxRuntime: JsxRuntime): ({ id, children }: {
+/** The linked entry's own resolved data — the same shape the delivery API's `getEntry`/`getEntries`
+ * attach at `entry.entryLinks[id]` when called with `include` set (optionally widened with
+ * `entryLinkFields`). Mirrors the SDK's `EntryLinkView` minus `id`, kept local so the
+ * framework-agnostic renderer doesn't depend on `@draftbase/sdk`. */
+export interface LinkedEntryData {
+    templateId: string;
+    title: string;
+    status: string;
+    fields?: Record<string, unknown>;
+}
+/** Props passed to `EntryLink` — the id of the linked entry, authored via the entry picker in
+ * the MDX editor, plus that entry's own resolved data when the caller passed `entryLinks` to
+ * `MDXContent`/`compileMDX` (avoids an extra per-link fetch at render time). Apps overriding
+ * `components.EntryLink` should type their component against this. */
+export interface EntryLinkProps extends Partial<LinkedEntryData> {
     id?: string;
     children?: unknown;
-}) => JSX.Element;
+}
+/** Default `EntryLink` for a given JSX runtime — renders `<a href="/entries/{id}">`; apps that
+ * route entries differently override it by passing `components.EntryLink`. */
+export declare function makeDefaultEntryLink(jsxRuntime: JsxRuntime): ({ id, children }: EntryLinkProps) => JSX.Element;
+/** Wraps `EntryLink` (custom or default) so every instance also receives its resolved
+ * `LinkedEntryData` from `entryLinks[id]` — the caller's already-fetched `getEntry`/`getEntries`
+ * result — instead of each link having to re-fetch its own target. */
+export declare function withEntryLinkData(EntryLink: unknown, entryLinks: Record<string, LinkedEntryData> | undefined, jsxRuntime: JsxRuntime): unknown;
 /** Default `img` for a given JSX runtime — defers offscreen image loads instead of the browser's
  * eager default. Apps that want `next/image` (or another optimizer) override it via `components.img`;
  * an explicit `loading`/`decoding` on the element itself (rare, but author-settable) still wins. */

package/dist/core.js

@@ -38,6 +38,17 @@ export function makeDefaultEntryLink(jsxRuntime) {
         return jsxRuntime.jsx("a", { href: id ? `/entries/${id}` : undefined, children });
     };
 }
+/** Wraps `EntryLink` (custom or default) so every instance also receives its resolved
+ * `LinkedEntryData` from `entryLinks[id]` — the caller's already-fetched `getEntry`/`getEntries`
+ * result — instead of each link having to re-fetch its own target. */
+export function withEntryLinkData(EntryLink, entryLinks, jsxRuntime) {
+    if (!entryLinks)
+        return EntryLink;
+    return function EntryLinkWithData(props) {
+        const linked = props.id ? entryLinks[props.id] : undefined;
+        return jsxRuntime.jsx(EntryLink, { ...props, ...linked });
+    };
+}
 /** Default `img` for a given JSX runtime — defers offscreen image loads instead of the browser's
  * eager default. Apps that want `next/image` (or another optimizer) override it via `components.img`;
  * an explicit `loading`/`decoding` on the element itself (rare, but author-settable) still wins. */

package/dist/index.d.ts

@@ -1,4 +1,5 @@
 export { MDXContent, compileMDX } from "./MDXContent.js";
 export type { MDXContentProps, CompiledMDX, FailedMDX } from "./MDXContent.js";
+export type { EntryLinkProps, LinkedEntryData } from "./core.js";
 export { toHtml } from "./toHtml.js";
 export { MDXErrorBoundary } from "./MDXErrorBoundary.js";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@draftbase/renderer",
-  "version": "0.5.2",
+  "version": "0.5.3",
   "description": "Framework-agnostic MDX renderer for Draftbase content (React, Next.js RSC, React Native, Astro, Vite, Vue)",
   "keywords": [
     "draftbase",