@ampless/plugin-cookie-consent 0.1.0-alpha.1 → 0.1.0-alpha.2

package/README.ja.md

@@ -31,7 +31,7 @@ export default defineConfig({
     // cookie-consent を最初に登録し、後続の analytics プラグインが
     // window.amplessConsent を参照できるようにする。
     cookieConsentPlugin(),
-    // analyticsGa4Plugin({ ... }),  // PR D 以降
+    // analyticsGa4Plugin({ measurementId: 'G-XXXXXXXX', consentCategory: 'analytics' }),
   ],
 })
 ```
@@ -46,9 +46,10 @@ export default defineConfig({
 
 | キー | 型 | デフォルト | 備考 |
 |---|---|---|---|
-| `bannerText` | textarea | `'このサイトは…'` | バナー上部に表示するメッセージ。 |
+| `bannerText` | textarea | `'This site uses cookies…'` | バナー上部に表示するメッセージ。デフォルトは英語、日本語サイトでは `/admin/plugins` から日本語に上書きします。 |
 | `acceptLabel` | text | `'Accept all'` | 「すべて同意」ボタンのラベル。 |
 | `rejectLabel` | text | `'Reject non-essential'` | 「拒否」ボタンのラベル。 |
+| `saveLabel` | text | `'Save selected'` | 個別トグルの状態をそのまま保存するボタンのラベル。「全て同意」「全て拒否」とは別の選択肢。 |
 | `position` | select | `'bottom'` | `'bottom'` / `'top'` / `'modal'`。 |
 | `categories` | repeatable | `[]` | 同意カテゴリのリスト。 |
 
@@ -97,9 +98,9 @@ analytics の gate には `has`、バナーが「再プロンプトすべきか
 
 詳細な API 仕様と analytics 側の consume パターンは [`docs/architecture/08-plugin-architecture.ja.md` — Consent Convention](https://github.com/heavymoons/ampless/blob/main/docs/architecture/08-plugin-architecture.ja.md#consent-convention) を参照してください。
 
-## analytics プラグインとの組み合わせ（PR D 以降）
+## analytics プラグインとの組み合わせ
 
-GA4 / GTM / Plausible プラグインに `consentCategory` サポートが追加された後（Phase 3b PR D）、次のように組み合わせられます:
+公式バンドルの `@ampless/plugin-analytics-ga4` / `@ampless/plugin-gtm` / `@ampless/plugin-plausible` はいずれも `consentCategory` をサポートしています:
 
 ```ts
 plugins: [
@@ -109,9 +110,7 @@ plugins: [
 ]
 ```
 
-`consentCategory` を設定した analytics プラグインは、訪問者が該当カテゴリに同意するまで発火しません。`window.amplessConsent` がインストールされていない場合（`cookieConsentPlugin` が `cms.config.ts` に未登録の場合）、トラッキングは**永久に発火しません** — これは意図した fail-closed 設計です。
-
-> **注意:** GA4 / GTM / Plausible の `consentCategory` 対応は Phase 3b PR D で実装予定（未リリース）です。
+`consentCategory` を設定した analytics プラグインは、訪問者が該当カテゴリに同意するまで発火しません。`window.amplessConsent` がインストールされていない場合（`cookieConsentPlugin` が `cms.config.ts` に未登録の場合）、トラッキングは**永久に発火しません** — これは意図した fail-closed 設計です（5 秒後に `console.warn` で設定ミスを通知）。
 
 ## トラストレベル
 

package/README.md

@@ -31,7 +31,7 @@ export default defineConfig({
     // List cookie-consent FIRST so its window.amplessConsent API is
     // available when subsequent analytics plugins initialise.
     cookieConsentPlugin(),
-    // analyticsGa4Plugin({ ... }),  // PR D — coming soon
+    // analyticsGa4Plugin({ measurementId: 'G-XXXXXXXX', consentCategory: 'analytics' }),
   ],
 })
 ```
@@ -49,6 +49,7 @@ Configure from `/admin/plugins → Cookie Consent`:
 | `bannerText` | textarea | `'This site uses cookies…'` | Message shown at the top of the banner. |
 | `acceptLabel` | text | `'Accept all'` | Label for the "accept all" button. |
 | `rejectLabel` | text | `'Reject non-essential'` | Label for the "reject" button. |
+| `saveLabel` | text | `'Save selected'` | Label for the button that persists the per-category toggle state as the visitor checked it. |
 | `position` | select | `'bottom'` | `'bottom'` / `'top'` / `'modal'`. |
 | `categories` | repeatable | `[]` | List of consent categories. |
 
@@ -97,9 +98,9 @@ Consent state is persisted in `localStorage` under the key `'ampless:consent'` a
 
 For the full API specification and the analytics consume pattern see [`docs/architecture/08-plugin-architecture.md` — Consent Convention](https://github.com/heavymoons/ampless/blob/main/docs/architecture/08-plugin-architecture.md#consent-convention).
 
-## Combining with analytics plugins (coming in PR D)
+## Combining with analytics plugins
 
-Once GA4, GTM, and Plausible plugins add `consentCategory` support (Phase 3b PR D), you can gate them like this:
+The bundled `@ampless/plugin-analytics-ga4`, `@ampless/plugin-gtm`, and `@ampless/plugin-plausible` plugins all support `consentCategory`:
 
 ```ts
 plugins: [
@@ -109,9 +110,7 @@ plugins: [
 ]
 ```
 
-With `consentCategory` set, the analytics plugin will not fire until the visitor grants consent for that category. If `window.amplessConsent` is not installed (i.e. `cookieConsentPlugin` is missing from `cms.config.ts`), tracking will **never fire** — this is the intended fail-closed design.
-
-> **Note:** `consentCategory` support in GA4, GTM, and Plausible is implemented in Phase 3b PR D (not yet released).
+With `consentCategory` set, the analytics plugin will not fire until the visitor grants consent for that category. If `window.amplessConsent` is not installed (i.e. `cookieConsentPlugin` is missing from `cms.config.ts`), tracking will **never fire** — this is the intended fail-closed design (a `console.warn` surfaces the misconfiguration after 5s).
 
 ## Trust level
 

package/dist/index.js

@@ -71,6 +71,20 @@ function cookieConsentPlugin(options = {}) {
           },
           default: "Reject non-essential"
         },
+        {
+          type: "text",
+          key: "saveLabel",
+          maxLength: 50,
+          label: {
+            en: "Save-selected button label",
+            ja: "\u300C\u9078\u629E\u3092\u4FDD\u5B58\u300D\u30DC\u30BF\u30F3\u306E\u30E9\u30D9\u30EB"
+          },
+          description: {
+            en: "Label for the button that saves the per-category toggle state without granting (or rejecting) everything.",
+            ja: "\u500B\u5225\u30C8\u30B0\u30EB\u306E\u72B6\u614B\u3092\u305D\u306E\u307E\u307E\u4FDD\u5B58\u3059\u308B\u30DC\u30BF\u30F3\u306E\u30E9\u30D9\u30EB\u3002\u300C\u5168\u3066\u540C\u610F\u300D\u300C\u5168\u3066\u62D2\u5426\u300D\u3068\u306F\u5225\u306E\u9078\u629E\u80A2\u3002"
+          },
+          default: "Save selected"
+        },
         {
           type: "select",
           key: "position",
@@ -240,10 +254,12 @@ function cookieConsentPlugin(options = {}) {
       const bannerText = (ctx.setting("bannerText") ?? "").trim() || "This site uses cookies to enhance your browsing experience. You can manage your preferences below.";
       const acceptLabel = (ctx.setting("acceptLabel") ?? "").trim() || "Accept all";
       const rejectLabel = (ctx.setting("rejectLabel") ?? "").trim() || "Reject non-essential";
+      const saveLabel = (ctx.setting("saveLabel") ?? "").trim() || "Save selected";
       const position = ctx.setting("position") ?? "bottom";
       const bannerTextJs = escapeJsString(bannerText);
       const acceptLabelJs = escapeJsString(acceptLabel);
       const rejectLabelJs = escapeJsString(rejectLabel);
+      const saveLabelJs = escapeJsString(saveLabel);
       const nonEssentialJson = JSON.stringify(
         nonEssential.map((c) => ({
           id: c.id,
@@ -289,6 +305,7 @@ function cookieConsentPlugin(options = {}) {
             `  var bannerText = '${bannerTextJs}';`,
             `  var acceptLabel = '${acceptLabelJs}';`,
             `  var rejectLabel = '${rejectLabelJs}';`,
+            `  var saveLabel = '${saveLabelJs}';`,
             "",
             "  // Build banner DOM outside React tree (avoids hydration conflicts).",
             "  var container = document.createElement('div');",
@@ -375,7 +392,7 @@ function cookieConsentPlugin(options = {}) {
             "  // Save selected (granular toggle state).",
             "  var saveBtn = document.createElement('button');",
             "  saveBtn.style.cssText = btnBase + 'background:#fff;color:#111;';",
-            "  saveBtn.textContent = 'Save selected';",
+            "  saveBtn.textContent = saveLabel;",
             "  saveBtn.addEventListener('click', function() {",
             "    nonEssential.forEach(function(cat) {",
             "      if (window.amplessConsent) window.amplessConsent.set(cat.id, toggleState[cat.id] === true);",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ampless/plugin-cookie-consent",
-  "version": "0.1.0-alpha.1",
+  "version": "0.1.0-alpha.2",
   "description": "Cookie consent banner plugin for ampless — installs window.amplessConsent API and renders a configurable consent banner",
   "license": "MIT",
   "type": "module",
@@ -26,7 +26,7 @@
   "homepage": "https://github.com/heavymoons/ampless/tree/main/packages/plugin-cookie-consent#readme",
   "bugs": "https://github.com/heavymoons/ampless/issues",
   "dependencies": {
-    "ampless": "1.0.0-alpha.26"
+    "ampless": "1.0.0-alpha.27"
   },
   "keywords": [
     "ampless",