@getvitops/generator 8.2.0-alpha.0 → 8.2.0

package/config.schema.json

@@ -2226,70 +2226,115 @@
           "additionalProperties": false
         },
         "seo": {
-          "description": "SEO defaults: title/description templates, robots policy, verification tokens, Open Graph + Twitter cards, and post-deploy indexing notification.",
+          "description": "SEO defaults: site name, title/description defaults, robots policy, verification tokens, Open Graph + Twitter cards, and post-deploy indexing notification. Read by `<Seo />`, `vitops robots` and `vitops search notify`.",
           "type": "object",
           "properties": {
+            "siteName": {
+              "description": "`og:site_name`, and the `<title>` when a page passes none. Defaults to `organization.name`, so most sites never state it.",
+              "anyOf": [
+                {
+                  "type": "string"
+                },
+                {
+                  "type": "object",
+                  "propertyNames": {
+                    "type": "string"
+                  },
+                  "additionalProperties": {
+                    "type": "string"
+                  }
+                }
+              ]
+            },
             "titleTemplate": {
-              "description": "Page-title pattern (e.g. \"%s · Acme\").",
-              "type": "string"
+              "description": "Page-title pattern; `%s` is the page title (e.g. \"%s · Acme\"). Applies to `<title>` only, never to `og:title`, and is skipped when the page title already equals the site name.",
+              "anyOf": [
+                {
+                  "type": "string"
+                },
+                {
+                  "type": "object",
+                  "propertyNames": {
+                    "type": "string"
+                  },
+                  "additionalProperties": {
+                    "type": "string"
+                  }
+                }
+              ]
             },
-            "descriptionTemplate": {
-              "type": "string"
+            "defaultTitle": {
+              "description": "`<title>` for pages that pass none. Used verbatim — the template is not applied. Defaults to the site name.",
+              "anyOf": [
+                {
+                  "type": "string"
+                },
+                {
+                  "type": "object",
+                  "propertyNames": {
+                    "type": "string"
+                  },
+                  "additionalProperties": {
+                    "type": "string"
+                  }
+                }
+              ]
+            },
+            "defaultDescription": {
+              "description": "`<meta name=\"description\">` for pages that pass none.",
+              "anyOf": [
+                {
+                  "type": "string"
+                },
+                {
+                  "type": "object",
+                  "propertyNames": {
+                    "type": "string"
+                  },
+                  "additionalProperties": {
+                    "type": "string"
+                  }
+                }
+              ]
             },
             "robots": {
-              "description": "e.g. \"index,follow\" / \"noindex,nofollow\".",
+              "description": "Site-wide robots directive (e.g. \"index,follow\" / \"noindex,nofollow\"). `site.environments.<env>.robots` wins over it.",
               "type": "string"
             },
             "googleSiteVerification": {
+              "description": "Google Search Console verification token (`<meta name=\"google-site-verification\">`).",
               "type": "string"
             },
             "bingSiteVerification": {
+              "description": "Bing Webmaster Tools verification token (`<meta name=\"msvalidate.01\">`).",
               "type": "string"
             },
             "openGraph": {
+              "description": "Open Graph defaults. Per-page `<Seo />` props override them.",
               "type": "object",
               "properties": {
                 "type": {
-                  "type": "string"
+                  "description": "Default `og:type`. Default `website`.",
+                  "type": "string",
+                  "enum": [
+                    "website",
+                    "article",
+                    "profile"
+                  ]
                 },
-                "siteName": {
+                "locale": {
+                  "description": "`og:locale`. `en-CA` and `en_CA` both emit `en_CA`.",
                   "type": "string"
                 },
-                "title": {
-                  "anyOf": [
-                    {
-                      "type": "string"
-                    },
-                    {
-                      "type": "object",
-                      "propertyNames": {
-                        "type": "string"
-                      },
-                      "additionalProperties": {
-                        "type": "string"
-                      }
-                    }
-                  ],
-                  "description": "A string, or a per-locale map of strings (`{ en: \"…\", fr: \"…\" }`)."
-                },
-                "description": {
-                  "anyOf": [
-                    {
-                      "type": "string"
-                    },
-                    {
-                      "type": "object",
-                      "propertyNames": {
-                        "type": "string"
-                      },
-                      "additionalProperties": {
-                        "type": "string"
-                      }
-                    }
-                  ],
-                  "description": "A string, or a per-locale map of strings (`{ en: \"…\", fr: \"…\" }`)."
+                "localeAlternates": {
+                  "description": "Other locales the same content exists in → `og:locale:alternate`.",
+                  "type": "array",
+                  "items": {
+                    "type": "string"
+                  }
                 },
                 "image": {
+                  "description": "Fallback share image for pages that bring none.",
                   "anyOf": [
                     {
                       "type": "string"
@@ -2298,7 +2343,8 @@
                       "type": "object",
                       "properties": {
                         "src": {
-                          "type": "string"
+                          "type": "string",
+                          "description": "Absolute, or relative to `site` (resolved at render time)."
                         },
                         "alt": {
                           "type": "string"
@@ -2308,26 +2354,28 @@
                         },
                         "height": {
                           "type": "number"
+                        },
+                        "type": {
+                          "description": "MIME type, e.g. `image/png`.",
+                          "type": "string"
                         }
                       },
                       "required": [
-                        "src",
-                        "alt"
+                        "src"
                       ],
                       "additionalProperties": false
                     }
                   ]
-                },
-                "locale": {
-                  "type": "string"
                 }
               },
               "additionalProperties": false
             },
             "twitter": {
+              "description": "Twitter/X card defaults.",
               "type": "object",
               "properties": {
                 "card": {
+                  "description": "Card type when no image resolves (default `summary`).",
                   "type": "string",
                   "enum": [
                     "summary",
@@ -2337,73 +2385,12 @@
                   ]
                 },
                 "site": {
+                  "description": "The site's own handle, e.g. \"@acme\".",
                   "type": "string"
                 },
                 "creator": {
+                  "description": "Default author handle, e.g. \"@ada\".",
                   "type": "string"
-                },
-                "title": {
-                  "anyOf": [
-                    {
-                      "type": "string"
-                    },
-                    {
-                      "type": "object",
-                      "propertyNames": {
-                        "type": "string"
-                      },
-                      "additionalProperties": {
-                        "type": "string"
-                      }
-                    }
-                  ],
-                  "description": "A string, or a per-locale map of strings (`{ en: \"…\", fr: \"…\" }`)."
-                },
-                "description": {
-                  "anyOf": [
-                    {
-                      "type": "string"
-                    },
-                    {
-                      "type": "object",
-                      "propertyNames": {
-                        "type": "string"
-                      },
-                      "additionalProperties": {
-                        "type": "string"
-                      }
-                    }
-                  ],
-                  "description": "A string, or a per-locale map of strings (`{ en: \"…\", fr: \"…\" }`)."
-                },
-                "image": {
-                  "anyOf": [
-                    {
-                      "type": "string"
-                    },
-                    {
-                      "type": "object",
-                      "properties": {
-                        "src": {
-                          "type": "string"
-                        },
-                        "alt": {
-                          "type": "string"
-                        },
-                        "width": {
-                          "type": "number"
-                        },
-                        "height": {
-                          "type": "number"
-                        }
-                      },
-                      "required": [
-                        "src",
-                        "alt"
-                      ],
-                      "additionalProperties": false
-                    }
-                  ]
                 }
               },
               "additionalProperties": false
@@ -2671,6 +2658,40 @@
                   }
                 ]
               },
+              "conversionActionId": {
+                "description": "Google Ads only: the conversion action **resource id(s)** (a numeric id, or a full `customers/…/conversionActions/…` resource name) used for server-side offline conversion upload — NOT the same value as `conversionLabel`, which is the opaque label the web tag uses and which the Ads API's upload endpoint does not accept. Only meaningful when `reporting: \"server\"`.",
+                "anyOf": [
+                  {
+                    "type": "string"
+                  },
+                  {
+                    "type": "object",
+                    "properties": {
+                      "call": {
+                        "description": "Fired on a tel: link click.",
+                        "type": "string"
+                      },
+                      "email": {
+                        "description": "Fired on a mailto: link click.",
+                        "type": "string"
+                      },
+                      "form": {
+                        "description": "Fired on a form submission.",
+                        "type": "string"
+                      }
+                    },
+                    "additionalProperties": false
+                  }
+                ]
+              },
+              "reporting": {
+                "description": "Google Ads only: `\"client\"` (default) fires the conversion via `gtag.js` in the browser at click/submit time; `\"server\"` uploads it via the Ads API from the conversion endpoint instead (see `conversionActionId`). An action with no matching `conversionActionId` keeps firing client-side regardless of this setting, so setting it before `conversionActionId` is filled in never silently drops a conversion.",
+                "type": "string",
+                "enum": [
+                  "client",
+                  "server"
+                ]
+              },
               "domain": {
                 "description": "Bare hostname to verify with this platform. Defaults to the host of `domains.canonical` — set it only when the ad account is verified against a different domain.",
                 "type": "string"