@taprootio/site-authoring 0.22.2 → 0.22.4

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@taprootio/site-authoring",
-  "version": "0.22.2",
+  "version": "0.22.4",
   "description": "Taproot site authoring CLI: sign in once in the browser, then pull, validate, push, preview, approve, and deploy a site from the terminal",
   "type": "module",
   "license": "ISC",

package/src/changelog.json

@@ -1,5 +1,25 @@
 {
   "entries": [
+    {
+      "version": "0.22.4",
+      "note": "The publishing preferences gain analyticsConsentPrompt, the switch that asks readers before the visit cookie is set.",
+      "behavior": [
+        "A pulled settings snapshot now carries analyticsConsentPrompt (default false) in the publishing preferences, and a push can set it. It is staged like the rest of the group and applies after a deployment. With it on, published pages show a small prompt and the 30-minute visit cookie is set only after a reader accepts."
+      ],
+      "help": [
+        "settings"
+      ]
+    },
+    {
+      "version": "0.22.3",
+      "note": "The forms reference now says site moderators can read form submissions.",
+      "behavior": [
+        "The forms help names who holds the submissions permissions: site.forms.submissions.read belongs to a site's owners, admins and moderators, and site.forms.submissions.manage to its owners and admins. No command or refusal changed."
+      ],
+      "help": [
+        "forms"
+      ]
+    },
     {
       "version": "0.22.2",
       "note": "Free-form sections pad evenly with the page padding wherever they render, including preview-page; Espalier 6.5.0 lets the page preview take the width a capped main column leaves it.",

package/src/reference-help.js

@@ -88,7 +88,7 @@ import {
 
 export { getAppearanceReference, getFooterReference, getSettingsReference, getThemeReference };
 
-export const REFERENCE_VERSION = 38;
+export const REFERENCE_VERSION = 40;
 
 // The date-limit examples `help forms` prints; tests run them through the form validator.
 export const FORM_DATE_WINDOW_FIELD = Object.freeze({
@@ -869,9 +869,9 @@ const WORKFLOW_REFERENCES = Object.freeze({
       + "turns the id back into the key. Then deploy: the release freezes the form it was built with.",
       "The delegation.content capability carries site.forms.manage, which every forms verb needs: it covers "
       + "definitions, settings and status. Visitors' submissions are in no capability: reading them "
-      + "(site.forms.submissions.read) and finding, marking or deleting them (site.forms.submissions.manage) belong "
-      + "to the site's owners and admins on the site's Forms page, never to a key. A refusal names the missing "
-      + "permission.",
+      + "(site.forms.submissions.read) belongs to the site's owners, admins and moderators, and finding, marking or "
+      + "deleting them (site.forms.submissions.manage) to its owners and admins, on the site's Forms page, never to "
+      + "a key. A refusal names the missing permission.",
     ]),
     example: Object.freeze({
       key: "contact",

package/src/setting-reference.js

@@ -263,6 +263,15 @@ const PREFERENCES_ENTRIES = {
     "The image lightbox.",
     false,
   ),
+  analyticsConsentPrompt: entry(
+    `${FEATURES} > Ask readers before counting visits`,
+    "Whether published pages ask readers to accept one short-lived cookie before Taproot counts their visits. Off, "
+      + "the cookie is set without asking; on, readers who decline or ignore the prompt are counted by the estimate "
+      + "only.",
+    "Every page of a published Standard site, as a small prompt at the bottom of the screen. A change applies after "
+      + "a deployment.",
+    false,
+  ),
   tiptapImageMaxHeightVh: entry(
     `${FEATURES} > Image height`,
     "The tallest an image in a page body may be, as a percent of the screen height (45, 60, 75 or 90).",

package/src/settings-catalog.js

@@ -127,6 +127,9 @@ export const SETTINGS_GROUPS = Object.freeze([
       // zero and the default agree and a snapshot of an untouched site reads
       // the same as the site behaves.
       { name: "hideLightboxComments", wireType: "boolean" },
+      // Asks readers before the visit cookie is set (TR01263). Off is what an omitted value means, so a snapshot of
+      // an untouched site reads the same as the site behaves.
+      { name: "analyticsConsentPrompt", wireType: "boolean" },
       { name: "tiptapImageMaxHeightVh", wireType: "int" },
       { name: "tiptapImageMaxImagesPerRow", wireType: "int" },
       { name: "tiptapImageBorderWidth", wireType: "int" },