@elytracms/next 0.0.92 → 0.0.93

package/dist/host-image.d.ts

@@ -1,4 +1,5 @@
 import { ReactNode } from 'react';
+import { ResolvedAsset } from '@elytracms/core/cms-core';
 
 /**
  * `@elytracms/next/host-image` — the host image-delivery seam for DUAL-RENDERED
@@ -37,26 +38,21 @@ import { ReactNode } from 'react';
  * second singleton instance into the server entry, disconnecting
  * `setHostImage` from `getHostImage` — pinned by `package-build.test.ts`).
  */
-/** The resolved-asset slice a host image renderer needs (mirrors `ResolvedAsset`). */
-interface HostImageAsset {
-    url: string;
-    width: number | null;
-    height: number | null;
-    alt: string | null;
-    focalPoint: {
-        x: number;
-        y: number;
-    } | null;
-    /**
-     * LQIP blur-placeholder data URI (EC-420) → next/image blurDataURL. Optional so a
-     * consumer mapping a `ResolvedAsset` in stays source-compatible; when present the
-     * delivered image blurs up while the optimized bytes load.
-     */
-    lqip?: string | null;
-}
+/**
+ * The resolved-asset slice a host image renderer needs — DERIVED from `ResolvedAsset`
+ * (EC-587; it used to mirror it by hand). `lqip` (EC-420 → next/image blurDataURL) is
+ * optional so a caller handing a partial asset stays source-compatible; when present
+ * the delivered image blurs up while the optimized bytes load.
+ */
+type HostImageAsset = Pick<ResolvedAsset, 'url' | 'width' | 'height' | 'alt' | 'focalPoint'> & Partial<Pick<ResolvedAsset, 'lqip'>>;
 interface HostImageProps {
     asset: HostImageAsset;
-    alt: string;
+    /**
+     * The image's alt text. Omitted → the ASSET's alt (EC-587: an asset's alt has one
+     * home and one reader). Pass it only to override deliberately — e.g. `''` for a
+     * decorative image.
+     */
+    alt?: string;
     className?: string;
     loading?: 'eager' | 'lazy';
     /** Above-the-fold opt-out of lazy-loading (the hero image). */

package/dist/host-image.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/host-image.ts"],"names":[],"mappings":";AAoEA,IAAI,SAAA,GAAsC,IAAA;AAGnC,SAAS,aAAa,QAAA,EAA0C;AACrE,EAAA,SAAA,GAAY,QAAA;AACd;AAGO,SAAS,YAAA,GAAyC;AACvD,EAAA,OAAO,SAAA;AACT;AAiBO,IAAM,yBAAA,GAAgF;AAAA,EAC3F,EAAE,QAAA,EAAU,OAAA,EAAS,QAAA,EAAU,gBAAA;AACjC","file":"host-image.js","sourcesContent":["import type { ReactNode } from 'react'\n\n/**\n * `@elytracms/next/host-image` — the host image-delivery seam for DUAL-RENDERED\n * project components (EC-368, from the consumer-proven EC-271 pattern).\n *\n * The `project.*` page-builder components are dual-rendered: the SAME module\n * renders in the Vite studio canvas AND the Next host (AD-2/AD-11), so it may\n * not statically import `next/image` — that would break the Vite build. And in\n * the Next host these components render as Server Components, where React\n * context is unavailable, so an optimized `<Image>` can't be threaded through a\n * provider either.\n *\n * The seam that satisfies both: a tiny module singleton the host sets once at\n * boot. The studio never sets it (it renders the components via the root\n * `elytra.config`, which never imports the Next host), so the canvas keeps a\n * plain-`<img>` fallback; the Next host injects the `ElytraImage`-backed\n * renderer so content images go through `next/image`'s optimizer:\n *\n * ```ts\n * // frontend/lib/host.ts — imported once by the catch-all route at boot\n * import { elytraHostImage } from '@elytracms/next'\n * import { setHostImage } from '@elytracms/next/host-image'\n *\n * setHostImage(elytraHostImage())\n * ```\n *\n * WHEN (and whether) to register stays consumer-owned — legacy-interop windows\n * are real: a host whose global `next/image` config is still owned by a\n * previous stack (e.g. a Sanity-era custom loader) deliberately skips\n * registration until the conflict clears, and its components keep the honest\n * plain-`<img>` fallback.\n *\n * This module is deliberately its OWN subpath entry importing nothing but React\n * types — safe in Vite, in RSC, and in `next.config.*`. The main\n * `@elytracms/next` entry never imports it at runtime (that would bundle a\n * second singleton instance into the server entry, disconnecting\n * `setHostImage` from `getHostImage` — pinned by `package-build.test.ts`).\n */\n\n/** The resolved-asset slice a host image renderer needs (mirrors `ResolvedAsset`). */\nexport interface HostImageAsset {\n  url: string\n  width: number | null\n  height: number | null\n  alt: string | null\n  focalPoint: { x: number; y: number } | null\n  /**\n   * LQIP blur-placeholder data URI (EC-420) → next/image blurDataURL. Optional so a\n   * consumer mapping a `ResolvedAsset` in stays source-compatible; when present the\n   * delivered image blurs up while the optimized bytes load.\n   */\n  lqip?: string | null\n}\n\nexport interface HostImageProps {\n  asset: HostImageAsset\n  alt: string\n  className?: string\n  loading?: 'eager' | 'lazy'\n  /** Above-the-fold opt-out of lazy-loading (the hero image). */\n  priority?: boolean\n  /** Responsive `sizes` hint so the optimizer serves a column-sized variant. */\n  sizes?: string\n}\n\nexport type HostImageRenderer = (props: HostImageProps) => ReactNode\n\nlet hostImage: HostImageRenderer | null = null\n\n/** Host-only: register the optimized image renderer (called once at host boot). */\nexport function setHostImage(renderer: HostImageRenderer | null): void {\n  hostImage = renderer\n}\n\n/** The registered host renderer, or `null` in the studio canvas (plain-`<img>` fallback). */\nexport function getHostImage(): HostImageRenderer | null {\n  return hostImage\n}\n\n/**\n * The `next.config.*` `images.remotePatterns` preset for Elytra asset delivery\n * (EC-368 image defaults): Convex file-storage serve URLs, where uploaded\n * assets live in connected mode. Without it `next/image` refuses the remote\n * origin and delivery images 400 — spread it into your config:\n *\n * ```js\n * // next.config.mjs\n * import { convexAssetRemotePatterns } from '@elytracms/next/host-image'\n *\n * const nextConfig = {\n *   images: { remotePatterns: [...convexAssetRemotePatterns] },\n * }\n * ```\n */\nexport const convexAssetRemotePatterns: readonly { protocol: 'https'; hostname: string }[] = [\n  { protocol: 'https', hostname: '*.convex.cloud' },\n]\n"]}
+{"version":3,"sources":["../src/host-image.ts"],"names":[],"mappings":";AAoEA,IAAI,SAAA,GAAsC,IAAA;AAGnC,SAAS,aAAa,QAAA,EAA0C;AACrE,EAAA,SAAA,GAAY,QAAA;AACd;AAGO,SAAS,YAAA,GAAyC;AACvD,EAAA,OAAO,SAAA;AACT;AAiBO,IAAM,yBAAA,GAAgF;AAAA,EAC3F,EAAE,QAAA,EAAU,OAAA,EAAS,QAAA,EAAU,gBAAA;AACjC","file":"host-image.js","sourcesContent":["import type { ReactNode } from 'react'\nimport type { ResolvedAsset } from '@elytracms/core/cms-core'\n\n/**\n * `@elytracms/next/host-image` — the host image-delivery seam for DUAL-RENDERED\n * project components (EC-368, from the consumer-proven EC-271 pattern).\n *\n * The `project.*` page-builder components are dual-rendered: the SAME module\n * renders in the Vite studio canvas AND the Next host (AD-2/AD-11), so it may\n * not statically import `next/image` — that would break the Vite build. And in\n * the Next host these components render as Server Components, where React\n * context is unavailable, so an optimized `<Image>` can't be threaded through a\n * provider either.\n *\n * The seam that satisfies both: a tiny module singleton the host sets once at\n * boot. The studio never sets it (it renders the components via the root\n * `elytra.config`, which never imports the Next host), so the canvas keeps a\n * plain-`<img>` fallback; the Next host injects the `ElytraImage`-backed\n * renderer so content images go through `next/image`'s optimizer:\n *\n * ```ts\n * // frontend/lib/host.ts — imported once by the catch-all route at boot\n * import { elytraHostImage } from '@elytracms/next'\n * import { setHostImage } from '@elytracms/next/host-image'\n *\n * setHostImage(elytraHostImage())\n * ```\n *\n * WHEN (and whether) to register stays consumer-owned — legacy-interop windows\n * are real: a host whose global `next/image` config is still owned by a\n * previous stack (e.g. a Sanity-era custom loader) deliberately skips\n * registration until the conflict clears, and its components keep the honest\n * plain-`<img>` fallback.\n *\n * This module is deliberately its OWN subpath entry importing nothing but React\n * types — safe in Vite, in RSC, and in `next.config.*`. The main\n * `@elytracms/next` entry never imports it at runtime (that would bundle a\n * second singleton instance into the server entry, disconnecting\n * `setHostImage` from `getHostImage` — pinned by `package-build.test.ts`).\n */\n\n/**\n * The resolved-asset slice a host image renderer needs — DERIVED from `ResolvedAsset`\n * (EC-587; it used to mirror it by hand). `lqip` (EC-420 → next/image blurDataURL) is\n * optional so a caller handing a partial asset stays source-compatible; when present\n * the delivered image blurs up while the optimized bytes load.\n */\nexport type HostImageAsset = Pick<ResolvedAsset, 'url' | 'width' | 'height' | 'alt' | 'focalPoint'> &\n  Partial<Pick<ResolvedAsset, 'lqip'>>\n\nexport interface HostImageProps {\n  asset: HostImageAsset\n  /**\n   * The image's alt text. Omitted → the ASSET's alt (EC-587: an asset's alt has one\n   * home and one reader). Pass it only to override deliberately — e.g. `''` for a\n   * decorative image.\n   */\n  alt?: string\n  className?: string\n  loading?: 'eager' | 'lazy'\n  /** Above-the-fold opt-out of lazy-loading (the hero image). */\n  priority?: boolean\n  /** Responsive `sizes` hint so the optimizer serves a column-sized variant. */\n  sizes?: string\n}\n\nexport type HostImageRenderer = (props: HostImageProps) => ReactNode\n\nlet hostImage: HostImageRenderer | null = null\n\n/** Host-only: register the optimized image renderer (called once at host boot). */\nexport function setHostImage(renderer: HostImageRenderer | null): void {\n  hostImage = renderer\n}\n\n/** The registered host renderer, or `null` in the studio canvas (plain-`<img>` fallback). */\nexport function getHostImage(): HostImageRenderer | null {\n  return hostImage\n}\n\n/**\n * The `next.config.*` `images.remotePatterns` preset for Elytra asset delivery\n * (EC-368 image defaults): Convex file-storage serve URLs, where uploaded\n * assets live in connected mode. Without it `next/image` refuses the remote\n * origin and delivery images 400 — spread it into your config:\n *\n * ```js\n * // next.config.mjs\n * import { convexAssetRemotePatterns } from '@elytracms/next/host-image'\n *\n * const nextConfig = {\n *   images: { remotePatterns: [...convexAssetRemotePatterns] },\n * }\n * ```\n */\nexport const convexAssetRemotePatterns: readonly { protocol: 'https'; hostname: string }[] = [\n  { protocol: 'https', hostname: '*.convex.cloud' },\n]\n"]}

package/dist/index.d.ts

@@ -310,6 +310,12 @@ interface StaticContentData {
      * explicit unresolved-placeholder scheme (never a silent empty string).
      */
     assetUrl?: (asset: AssetRecord) => string;
+    /**
+     * EC-585 — the stored rows the host could not read (`parseDeliveredDocuments`), handed
+     * to every client of this source as its `sourceIssues` (and in the results they
+     * concern). A malformed row is not delivered, and never silently.
+     */
+    sourceIssues?: readonly CmsValidationIssue[];
 }
 /**
  * Assemble a `ContentSource` from plain prefetched data — the pure half of

package/dist/index.js

@@ -1,9 +1,8 @@
-import { registerComponents, renderDocumentBodyItems, documentBodyItems, serializeListingQuery, documentBodyRichTextValues, documentBodyCompositionNodes, richTextEmbedsInValue, collectReferencedAssetIds, collectRichTextRefsInValue, collectReferencedRelations, collectReferencedListings, collectReferencedRichTextLinks, RenderErrorBoundary, nodeListingOf, listingRequestOf } from '@elytracms/core/runtime-renderer';
-import { Fragment as Fragment$1, isValidElement } from 'react';
+import { registerComponents, createRenderContext, renderDocumentBodyItems, documentBodyItems, serializeListingQuery, documentBodyRichTextValues, documentBodyCompositionNodes, richTextEmbedsInValue, collectReferencedAssetIds, collectRichTextRefsInValue, collectReferencedRelations, collectReferencedListings, collectReferencedRichTextLinks, listingRequestOf } from '@elytracms/core/runtime-renderer';
 import { isBlockSequenceValueShape } from '@elytracms/core/rich-text';
-import { jsx, Fragment, jsxs } from 'react/jsx-runtime';
-import { cacheTags, isDocumentHistory, resolvedAsset, createContentClient, createContentContext } from '@elytracms/core/content';
-import { DEFAULT_SEO_FIELD, parseLocaleConfig, documentKey, liveRedirectRecords, SEO_SUBFIELDS, splitLocalePath, DRAFT_PERSPECTIVE, splitPath, localeUrlPath, variantOf, DRAFT_VARIANT, createRouter, presentationBodyFields, documentSchema, redirectRecordSchema } from '@elytracms/core/cms-core';
+import { jsx, Fragment } from 'react/jsx-runtime';
+import { cacheTags, isDocumentHistory, resolvedAsset, parseDeliveredDocuments, createContentClient, createContentContext } from '@elytracms/core/content';
+import { DEFAULT_SEO_FIELD, parseLocaleConfig, documentKey, liveRedirectRecords, SEO_SUBFIELDS, splitLocalePath, DRAFT_PERSPECTIVE, splitPath, localeUrlPath, variantOf, DRAFT_VARIANT, createRouter, presentationBodyFields, redirectRecordSchema } from '@elytracms/core/cms-core';
 export { DRAFT_PERSPECTIVE, documentSchema, localeConfigSchema, localeUrlPath, parseLocaleConfig, redirectRecordSchema, resolveLocale, routeRecordSchema, splitLocalePath, textDirection, variantOf } from '@elytracms/core/cms-core';
 import { revalidateTag, cacheTag } from 'next/cache';
 import { draftMode } from 'next/headers';
@@ -34,33 +33,15 @@ function listingResolver(listings) {
     return Array.isArray(baked) ? baked : null;
   };
 }
-function listingFailureOf(node, components, listings) {
-  const manifest = components.registry.getManifest(node.componentId);
-  if (!manifest) return null;
-  const listing = nodeListingOf(node, manifest, components.registry);
-  if (!listing || listing.state === "awaiting") return null;
-  if (listing.state === "invalid") return listing.messages;
-  const baked = listings?.[serializeListingQuery(listing.query)];
-  return baked && !Array.isArray(baked) ? baked.errors.map((error) => error.message) : null;
-}
-function InvalidListingNotice(props) {
-  return /* @__PURE__ */ jsx("div", { "data-ec-fallback": "invalid-listing", "data-ec-node-id": props.nodeId, role: "note", children: `This listing can't run: ${props.messages.join(" ")}` });
+function bakedListingFailure(listings) {
+  return (query) => {
+    const baked = listings[serializeListingQuery(query)];
+    return baked && !Array.isArray(baked) ? baked.errors.map((error) => error.message) : null;
+  };
 }
 function assetResolver(assets) {
   const byId = new Map(assets.map((asset) => [asset.id, asset]));
-  return (id) => {
-    const asset = byId.get(id);
-    return asset ? {
-      url: asset.url,
-      width: asset.width,
-      height: asset.height,
-      alt: asset.alt,
-      focalPoint: asset.focalPoint,
-      // EC-420: carry the LQIP so a placed Image blurs up on delivery.
-      lqip: asset.lqip,
-      meta: asset.meta
-    } : null;
-  };
+  return (id) => byId.get(id) ?? null;
 }
 function UnresolvedPageFallback(props) {
   return /* @__PURE__ */ jsx("div", { "data-ec-fallback": "unresolved-page", "data-ec-status": props.status, children: `This URL did not resolve to a page (status: ${props.status}).` });
@@ -68,41 +49,28 @@ function UnresolvedPageFallback(props) {
 function MissingDocumentFallback() {
   return /* @__PURE__ */ jsx("div", { "data-ec-fallback": "missing-document", children: `Route resolved but carried no page document to render.` });
 }
-function stripServerErrorBoundary(_node, rendered) {
-  if (isValidElement(rendered) && rendered.type === RenderErrorBoundary) {
-    return rendered.props.children ?? null;
-  }
-  return rendered;
-}
 async function CanvasRenderer(props) {
   const { result, components } = props;
   if (result.status !== "ok") {
     return /* @__PURE__ */ jsx(UnresolvedPageFallback, { status: result.status });
   }
-  const ctx = {
-    registry: components.registry,
-    implementations: components.implementations,
-    resolveAsset: assetResolver(props.assets ?? []),
-    // EC-254: wire relation population only when the host baked the populated
-    // targets, so a host that did not opt in keeps the raw-ref passthrough.
-    ...props.relations ? { resolveRelation: relationResolver(props.relations) } : {},
-    // EC-255: wire the listing resolver only when the host baked the query results,
-    // so a host that did not opt in keeps listing props empty (the block's own state).
-    ...props.listings ? { resolveListing: listingResolver(props.listings) } : {},
-    // EC-291: wire the rich-text link resolver only when the host baked the link map,
-    // so a host that did not opt in degrades a reference link to the visible
-    // `unresolved-ref` issue (EC-290) rather than a wrong href.
-    ...props.links ? { resolveLink: linkResolver(props.links) } : {},
-    decorateNode: (node, rendered) => {
-      const stripped = stripServerErrorBoundary(node, rendered);
-      const failure = listingFailureOf(node, components, props.listings);
-      if (!failure) return stripped;
-      return /* @__PURE__ */ jsxs(Fragment$1, { children: [
-        /* @__PURE__ */ jsx(InvalidListingNotice, { nodeId: node.id, messages: failure }),
-        stripped
-      ] }, node.id);
+  const ctx = createRenderContext({
+    components,
+    mode: "delivery",
+    source: {
+      resolveAsset: assetResolver(props.assets ?? []),
+      // EC-254: wire relation population only when the host baked the populated
+      // targets, so a host that did not opt in keeps the raw-ref passthrough.
+      ...props.relations ? { resolveRelation: relationResolver(props.relations) } : {},
+      // EC-255: wire the listing resolver only when the host baked the query results,
+      // so a host that did not opt in keeps listing props empty (the block's own state).
+      ...props.listings ? { resolveListing: listingResolver(props.listings), listingFailure: bakedListingFailure(props.listings) } : {},
+      // EC-291: wire the rich-text link resolver only when the host baked the link map,
+      // so a host that did not opt in degrades a reference link to the visible
+      // `unresolved-ref` issue (EC-290) rather than a wrong href.
+      ...props.links ? { resolveLink: linkResolver(props.links) } : {}
     }
-  };
+  });
   const document = result.document;
   if (document) {
     return /* @__PURE__ */ jsx(Fragment, { children: renderDocumentBodyItems(bodyItemsOf(document, props.presentation), ctx) });
@@ -181,7 +149,8 @@ function createStaticContentSource(data) {
       locales
     }),
     routes,
-    redirects
+    redirects,
+    ...data.sourceIssues ? { sourceIssues: data.sourceIssues } : {}
   });
   return {
     projectId: data.projectId,
@@ -243,16 +212,12 @@ function seoContextOf(result, assets = []) {
 function str(value) {
   return typeof value === "string" && value.length > 0 ? value : null;
 }
-function looksLikeUrl(value) {
-  return /^(https?:)?\/\//.test(value) || value.startsWith("/");
-}
 function resolveSeoImage(value, assets) {
   if (value && typeof value === "object") {
     const url = value.url;
     return typeof url === "string" && url.length > 0 ? url : null;
   }
   if (typeof value !== "string" || value.length === 0) return null;
-  if (looksLikeUrl(value)) return value;
   return assets.find((asset) => asset.id === value)?.url ?? null;
 }
 function openGraphLocale(locale) {
@@ -878,7 +843,7 @@ function elytraHostImage(options = {}) {
   return ({ asset, alt, className, priority, sizes, loading }) => /* @__PURE__ */ jsx(
     ElytraImage,
     {
-      asset: { ...asset, alt },
+      asset: { ...asset, alt: alt ?? asset.alt },
       ...className !== void 0 ? { className } : {},
       ...priority ? { priority: true } : {},
       ...sizes !== void 0 ? { sizes } : {},
@@ -930,14 +895,6 @@ async function runConvexQuery(fetchImpl, convexUrl, path, args) {
   }
   return body.value;
 }
-function parseDocuments(rows) {
-  const documents = [];
-  for (const row of rows) {
-    const parsed = documentSchema.safeParse(row);
-    if (parsed.success) documents.push(parsed.data);
-  }
-  return documents;
-}
 function parseRedirects(rows) {
   const redirects = [];
   for (const row of rows) {
@@ -948,7 +905,7 @@ function parseRedirects(rows) {
 }
 function assembleLiveSource(payload, options, perspective) {
   const locales = options.locales;
-  const documents = parseDocuments(payload.documents);
+  const { documents, issues: sourceIssues } = parseDeliveredDocuments(payload.documents);
   const routes = [...options.routes];
   const documentSources = perspective === "published" ? documents.map((doc) => ({ draft: doc, published: doc, versions: [] })) : documents;
   return createStaticContentSource({
@@ -961,7 +918,8 @@ function assembleLiveSource(payload, options, perspective) {
     redirects: parseRedirects(payload.redirects ?? []),
     collections: [...options.collections],
     documents: documentSources,
-    assets: payload.assets
+    assets: payload.assets,
+    ...sourceIssues.length > 0 ? { sourceIssues } : {}
   });
 }
 async function loadLiveContent(options, perspective) {
@@ -1023,11 +981,7 @@ function resolveGlobals(source, options = {}) {
   const navDocs = listDocs(navigationCollection);
   const navigation = (slot) => navDocs.find((doc) => doc.alias === slot) ?? null;
   const assetUrl = (value) => {
-    if (typeof value === "string") {
-      const found = assetById.get(value);
-      if (found) return found.url;
-      return value.startsWith("http") || value.startsWith("/") ? value : void 0;
-    }
+    if (typeof value === "string") return assetById.get(value)?.url;
     const url = record(value).url;
     return typeof url === "string" && url.length > 0 ? url : void 0;
   };