@ampless/runtime 1.0.0-beta.61 → 1.0.0-beta.62

package/dist/index.d.ts

@@ -336,6 +336,20 @@ interface PluginHeadApi {
      * `pluginSettings.loadAll()`.
      */
     contextForPlugins(): Promise<(plugin: AmplessPlugin) => PluginPublicRenderContext>;
+    /**
+     * Non-gated variant of `renderHead()` for use by the admin post preview.
+     *
+     * WHY this bypasses `isPublicRequest()`: the preview iframe is editor-only
+     * and must faithfully show what the published article looks like — including
+     * content-decoration plugins like mermaid/highlight that only register their
+     * scripts via `publicHead`. The `isPublicRequest()` gate correctly blocks
+     * analytics on public pages served to the admin or login routes, but for the
+     * preview we intentionally collect ALL publicHead descriptors so diagrams and
+     * syntax highlighting render. Analytics scripts (GA4/GTM/Plausible) also fire
+     * on preview as a side-effect; this is accepted (preview is not end-user
+     * traffic). Do NOT use this from public layouts — use `renderHead()` there.
+     */
+    renderHeadForPreview(): Promise<ReactNode>;
 }
 /**
  * Position-bucketed result of `renderHtmlForPost`. Themes embed these
@@ -576,6 +590,13 @@ interface Ampless {
     postMetadata(post: Post): Promise<Metadata>;
     siteMetadata(): Promise<Metadata>;
     publicHead(): Promise<ReactNode>;
+    /**
+     * Non-gated head collector for the admin post preview. Collects ALL
+     * `publicHead` descriptors without calling `isPublicRequest()` so
+     * content-decoration plugins (mermaid, highlight) render in preview.
+     * Do NOT call from public layouts — use `publicHead()` there.
+     */
+    publicHeadForPreview(): Promise<ReactNode>;
     publicBodyEnd(): Promise<ReactNode>;
     /**
      * Per-post body descriptors (Phase 4 `schema` capability). Theme

package/dist/index.js

@@ -1589,6 +1589,16 @@ function createPluginHead(cmsConfig, pluginSettings) {
     async contextForPlugins() {
       const snapshot = await pluginSettings.loadAll();
       return (plugin) => makeCtx(plugin, cmsConfig.site, snapshot);
+    },
+    async renderHeadForPreview() {
+      const snapshot = await pluginSettings.loadAll();
+      return collectFor(
+        validPlugins,
+        cmsConfig.site,
+        snapshot,
+        (p) => p.publicHead,
+        renderHeadDescriptor
+      );
     }
   };
 }
@@ -1829,6 +1839,7 @@ function createAmpless(opts) {
     postMetadata: (post) => seo.postMetadata(post),
     siteMetadata: () => seo.siteMetadata(),
     publicHead: () => pluginHead.renderHead(),
+    publicHeadForPreview: () => pluginHead.renderHeadForPreview(),
     publicBodyEnd: () => pluginHead.renderBodyEnd(),
     publicBodyForPost: (post) => pluginHead.renderBodyForPost(post),
     publicHtmlForPost: (post) => pluginHead.renderHtmlForPost(post),

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ampless/runtime",
-  "version": "1.0.0-beta.61",
+  "version": "1.0.0-beta.62",
   "description": "Public-side runtime for ampless: post fetching, theme dispatch, middleware, public route handlers",
   "license": "MIT",
   "type": "module",