@alpaca-headless/dynamic-renderings 1.0.4696 → 1.0.4697

package/README.md

@@ -100,9 +100,11 @@ Whether the browser also loads the real component is decided per page:
 
 | Page | Client code |
 | --- | --- |
-| edit mode | never: the first paint only |
 | a sealed request (`requestAuth` recognised it) | every island loads, inside an opaque-origin frame only |
-| anything else | islands of renderings the CM reports as `approved` |
+| anything else, edit mode included | islands of renderings the CM reports as `approved` |
+
+A loaded component always gets `editing: false`, in the edit canvas too; the first paint renders
+with `editing: true`.
 
 A bundle URL is `{prefix}/api/alpaca/renderings/client/{clientHash}-{compiledFormat}.js?id={renderingId}&database={db}`
 (plus `&page={pageId}` when sealed), where `clientHash` is the first 16 hex digits of the SHA-256

package/dist/client/DynamicIsland.js

@@ -3,9 +3,11 @@ import { Fragment as _Fragment, jsx as _jsx } from "react/jsx-runtime";
 // A component of a rendering's client code. It always shows the first paint the engine rendered
 // (static, sanitized) and replaces it with the real component once the browser bundle loaded.
 // The server passes this only where client code may run: `approved` for a rendering an
-// administrator approved (never in the edit canvas), `sealed` for an editor's isolated preview.
+// administrator approved (the edit canvas included), `sealed` for an editor's isolated preview.
 // A sealed island also checks that it really runs in an opaque-origin document, where its code
-// cannot reach the editor, a CM response or any cookie.
+// cannot reach the editor, a CM response or any cookie. The loaded component always gets
+// `editing: false` and runs as on the live page, in the edit canvas too; `editing: true` is the
+// first paint's (a static render).
 import { Component, useEffect, useState } from "react";
 class IslandBoundary extends Component {
     state = { failed: false };

package/dist/react/DynamicRendering.d.ts

@@ -22,7 +22,10 @@ export declare function ErrorBox({ title, detail }: {
  * which holds a token, it must fit the CM's URL length limit; the query has its own.
  */
 export declare function clientBundleUrl(state: Pick<DynamicPageState, "prefix" | "database" | "sealed" | "pageId">, renderingId: string, clientHash: string): string;
-/** Where this rendering's client code may run on this page, if anywhere. */
+/**
+ * Where this rendering's client code may run on this page, if anywhere: approved code everywhere,
+ * the edit canvas included (the approval is the review), and any code in the sealed preview.
+ */
 export declare function clientLoading(state: DynamicPageState, prepared: PreparedComponent, editing: boolean): ConvertContext["client"];
 /**
  * Returns the component the SDK's Placeholder mounts for every component whose layout JSON

package/dist/react/DynamicRendering.js

@@ -33,11 +33,14 @@ export function clientBundleUrl(state, renderingId, clientHash) {
         query.set("page", state.pageId);
     return `${state.prefix}/api/alpaca/renderings/client/${clientHash}-${protocol.compiledFormat}.js?${query}`;
 }
-/** Where this rendering's client code may run on this page, if anywhere. */
+/**
+ * Where this rendering's client code may run on this page, if anywhere: approved code everywhere,
+ * the edit canvas included (the approval is the review), and any code in the sealed preview.
+ */
 export function clientLoading(state, prepared, editing) {
-    if (editing || state.clientMode === "edit" || !prepared.clientHash)
+    if (!prepared.clientHash)
         return undefined;
-    if (state.clientMode === "sealed")
+    if (state.clientMode === "sealed" && !editing)
         return { mode: "sealed", src: clientBundleUrl(state, prepared.renderingId, prepared.clientHash) };
     return prepared.approved ? { mode: "approved", src: clientBundleUrl(state, prepared.renderingId, prepared.clientHash) } : undefined;
 }

package/dist/server/page.d.ts

@@ -39,10 +39,10 @@ export type PreparedTheme = {
     rejected?: string;
 };
 /**
- * Which client code loads in the browser: none in edit mode (first paints only), all of it in a
- * sealed request, and otherwise only that of approved renderings.
+ * Which client code loads in the browser: all of it in a sealed request (never in edit mode), and
+ * otherwise only that of approved renderings, the edit canvas included.
  */
-export type ClientMode = "edit" | "sealed" | "approved";
+export type ClientMode = "sealed" | "approved";
 export type DynamicPageState = {
     nonce: string;
     mode: string;

package/dist/server/page.js

@@ -16,7 +16,7 @@ export function emptyDynamicPage(mode, prefix = "", { sealed = false, pageId = "
         editing,
         preview: mode === "preview",
         sealed,
-        clientMode: editing ? "edit" : sealed ? "sealed" : "approved",
+        clientMode: sealed && !editing ? "sealed" : "approved",
         components: new Map(),
         prefix,
         pageId,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@alpaca-headless/dynamic-renderings",
-  "version": "1.0.4696",
+  "version": "1.0.4697",
   "description": "Optional Alpaca Headless dynamic renderings: source client, safe React rendering, client code and Next.js integration.",
   "type": "module",
   "publishConfig": {
@@ -79,7 +79,7 @@
     "acceptance": "node scripts/acceptance.mjs"
   },
   "dependencies": {
-    "@alpaca-headless/dynamic-renderings-engine": "1.0.4696",
+    "@alpaca-headless/dynamic-renderings-engine": "1.0.4697",
     "lucide-react": "^1.38.0",
     "postcss": "^8.5.26",
     "postcss-selector-parser": "^7.1.6",