ampless 1.0.0-beta.51 → 1.0.0-beta.52

package/docs/plugin-author-guide.ja.md

@@ -481,6 +481,15 @@ runtime は `body` を `sanitize-html` の厳格 allowlist で sanitize し（
 
 `cms.config.plugins` の順序は集約後も保たれます。
 
+> **`publicHead` / `publicBodyEnd` はいつ描画される？**
+> runtime は、ampless middleware が処理した公開リクエストでのみ
+> これらのサーフェスの出力を描画します。`/admin`、`/login`、
+> そして theme preview リクエスト（`?previewTheme=` /
+> `?previewColorScheme=` iframe）では描画されません。これにより、
+> GTM / GA / consent script が admin page view や live preview traffic で
+> analytics を汚染することを防ぎます。この挙動は
+> `@ampless/runtime` の npm update だけで反映され、サイトコードの変更は不要です。
+
 ### `publicBodyForPost` の使用例（Phase 4）
 
 `schema` capability を宣言してサーフェスを実装します：

package/docs/plugin-author-guide.md

@@ -603,6 +603,16 @@ interpolates that fragment directly:
 `cms.config.plugins` iteration order is preserved across the
 collected list.
 
+> **When are `publicHead` / `publicBodyEnd` rendered?**
+> The runtime renders output from these surfaces only on public requests
+> that have been processed by the ampless middleware. They are **not**
+> rendered under `/admin`, `/login`, or on theme-preview requests
+> (`?previewTheme=` / `?previewColorScheme=` iframe). This prevents GTM,
+> GA, and consent scripts from polluting analytics with admin page views
+> or live-preview traffic. An npm update to `@ampless/runtime` is
+> sufficient to pick up this behaviour — no changes to site code are
+> required.
+
 ### `publicBodyForPost` example (Phase 4)
 
 Declare the `schema` capability and implement the surface:

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ampless",
-  "version": "1.0.0-beta.51",
+  "version": "1.0.0-beta.52",
   "description": "Serverless CMS for AWS Amplify",
   "license": "MIT",
   "type": "module",