@taprootio/site-authoring 0.27.1 → 0.29.0

package/README.md

@@ -140,7 +140,7 @@ with no credential, no network, and no write: every page source (metadata,
 Markdown conversion, media references, content vocabulary, section contexts),
 page paths and templates against the pages the pull recorded, navigation,
 redirects, forms, and the complete theme, appearance, header, brand, and
-footer. Navigation to a generated page (a section, tag or place page) resolves
+footer. Navigation to a generated page (a section or folder page) resolves
 against the pages the pull recorded. It reports every problem at once in
 `error.problems`, each with its file, code, and field, instead of one per run.
 Warnings never refuse: `linkWarnings` names a link whose address is only
@@ -506,12 +506,11 @@ listings only while that person can still be named: a former member's page, or
 a member who can no longer create pages, reports none, and a push that names
 someone else on it is refused as a conflict.
 
-Pages Taproot generates from the site's content — a tag, the tags index, a
-published year or month, a place archive, a folder — are update-only sources.
-`pull` writes each as `pages/<name>.pm.json` with `"template": "generated"`:
-`data` holds what the page is (`kind`, `tagId`, `year`, `month`, `countryCode`,
-`regionCode`, `citySlug`, `categorySlug`, which you leave as pulled) and the four
-things that are yours to author: `customTitle`, `breadcrumbTitle`,
+Pages Taproot generates from the site's content — the published archive, a
+folder — are update-only sources. `pull` writes each as
+`pages/<name>.pm.json` with `"template": "generated"`: `data` holds what the
+page is (`kind`, which you leave as pulled) and the four things
+that are yours to author: `customTitle`, `breadcrumbTitle`,
 `customDescription` and `introductionBody`. An empty string means "use the
 generated default"; the description then falls back to the introduction's first
 paragraph, else the system default. The manifest keeps the title and description
@@ -525,8 +524,8 @@ move one (`pages.generated_move`) or change its kind or identity
 (`pages.generated_identity`, also when the manifest has no record of what the
 file was pulled as: run `pull`); there is no Markdown form
 (`pages.generated_markdown`). A generated page you did not edit never blocks a
-push of the whole workspace, even when Taproot moved it since the pull (a tag was
-renamed). If the site no longer has the page (its tag, month or folder is gone),
+push of the whole workspace, even when Taproot changed it since the pull. If the
+site no longer has the page (its folder is gone, or Taproot retired its kind),
 a whole-workspace push reports the file under `pages.staleGeneratedSources` and
 sends nothing for it, and `pull` says so; delete the file. Naming that path in
 `pages push <page-path>` is refused with `pages.generated_create`. A description over 160 characters is warned about,
@@ -857,8 +856,8 @@ taproot-site places category clear <placeId>
 `list` prints the closed list `set` accepts; a name outside it is refused, and
 capitalization is ignored. The category is the site's alone and applies to every
 review of that place on the site: the place itself and other sites do not
-change. Place-review bylines and the `/places/<category>` pages use it from the
-site's next deployment, including reviews nobody has edited. `clear` removes it.
+change. Place-review bylines use it from the site's next deployment, including
+reviews nobody has edited. `clear` removes it.
 Both need the same page-editing permission as `places select`.
 
 ### Pages generated in 0.18.0
@@ -892,7 +891,7 @@ once).
   page's title, description or author; `pull` keeps the edit until `pages push`
   sends it. Descriptions are warned about over 160 characters and refused over
   1000, here and by Taproot.
-- Generated pages (tags, archives, places, folders) pull as update-only sources
+- Generated pages (the published archive, the map, folders) pull as update-only sources
   whose custom title, breadcrumb, description and introduction you can edit.
 - Pages are authorless by default. `authors list`, `authors add` and
   `authors.json` name a member who can create pages or a site author without a

package/examples/riverbend-wellness/settings/site-publishing-preferences.json

@@ -18,6 +18,14 @@
           "pageResourceId": "a0000000-0000-4000-8000-000000000013"
         }
       ],
+      "socialLinks": [
+        {
+          "id": "a0000000-0000-4000-8000-000000000048",
+          "platform": "instagram",
+          "url": "https://instagram.example.test/riverbendwellness",
+          "label": "Riverbend on Instagram"
+        }
+      ],
       "light": {
         "backgroundColor": "--esp-color-layer-1",
         "textColor": "--esp-color-text",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@taprootio/site-authoring",
-  "version": "0.27.1",
+  "version": "0.29.0",
   "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,42 @@
 {
   "entries": [
+    {
+      "version": "0.29.0",
+      "note": "Pages gain an image-row component for linked pictures at a set height and a product-grid component for priced cards with a button each; feature-grid help states its icon sizes and square crop, and published feature-grid icons now render at the documented sizes.",
+      "behavior": [
+        "A free-form page may hold an image-row component: one to twelve pictures at one height (small 2.5rem/40px, medium 4rem/64px, large 6rem/96px at a 16px root), each with required alt text, required width and height, and an optional link. Pictures keep their own shape, are never cropped or framed, and one wider than the row shrinks to fit. See help component image-row.",
+        "help component feature-grid states the icon box sizes (small 3rem/48px, medium 6rem/96px, large 10rem/160px, xlarge 16rem/256px at a 16px root) and that icons are cropped to a square and framed by the site's image border. Published feature-grid icons now render at those sizes; before this release they filled the item's width with a 2em margin, so re-check existing grids after the runtime update.",
+        "A free-form page may hold a product-grid component: one to a hundred equal-height cards for things to buy or book, each with a title, free-text price and note, badge, description, up to eight feature lines, an optional 16:9 image and one button that links to any checkout; columns 2 to 4, standard or compact density, a border width, and a highlighted card drawn in the site's action color. Site checks now read buttonUrl and linkUrl addresses, so a card-grid, cta or product-grid link to a missing page is reported. See help component product-grid.",
+        "A free-form page may hold a social-links component: one to twelve links, each a platform from a fixed list (Instagram, Facebook, Yelp, YouTube, TikTok, LinkedIn, X, Threads, Bluesky, Mastodon, Pinterest, or Website for any other site) with an https address and an optional label the link reads to screen readers; icons at small 1.5rem, medium 2rem or large 3rem, aligned start, center or end (the align field), with labels shown or hidden. The address must be absolute https, without credentials, to a domain of unaccented letters, digits and hyphens. See help component social-links.",
+        "Footer settings gain socialLinks: up to twelve links with an id, a platform key, an https address and an optional label, published as an icon row between the bottom copy and the utility links. The footer draft hash moves to footer-draft-v4, so every footer draft hash issued before this release is stale once: pull the footer again before pushing it. See help footer.",
+        "The help reference version is 48."
+      ],
+      "help": [
+        "components",
+        "component",
+        "footer"
+      ]
+    },
+    {
+      "version": "0.28.0",
+      "note": "Taproot no longer generates /places, year and month, or tag pages, so a generated page's data drops those fields. One /published page lists every month, a folder page reaches search only with an introduction or three cards, and a review's location byline opens Google Maps.",
+      "behavior": [
+        "The /published/<year> and /published/<year>/<month> pages are no longer generated. One /published page carries a year and a month picker filled from JSON files the release writes (published/months.json and published/<year>/<month>.json), and a content byline links to /published?year=YYYY&month=M. Those file paths are refused as redirect sources with redirect.source_generated_file.",
+        "A generated page's data drops year and month beside the place fields: pull writes kind and the four authored fields, and a source that still carries year or month is refused by pages push with pages.document_shape as an unsupported field: delete the year and month lines from sources pulled before this release (every generated page pulled earlier carries year: 0 and month: 0).",
+        "The /places index, country, region, city and category pages are no longer generated, so a site has no generated page of those kinds to pull. On a published review, article or album with a place on a site with no map page, the location byline opens the place's Google Maps listing in a new tab; the review's category byline is plain text.",
+        "A generated page's data holds kind and the four authored fields. pull no longer writes countryCode, regionCode, citySlug or categorySlug, and a source that still carries one is refused by pages push with pages.document_shape as an unsupported field: delete the four lines from sources pulled before this release.",
+        "/places is no longer a reserved path, so a page may be authored there.",
+        "A workspace that pulled a /places page before this release keeps that file: pages push reports it as the source of a generated page Taproot no longer publishes and sends the rest, whether or not the site has synchronized the page away yet; naming its path is refused with pages.generated_create. Delete the file.",
+        "Taproot no longer generates tag pages (/tags and /tags/<slug>): tags stay page metadata with no public page, a workspace that pulled one keeps the file and pages push reports it as the source of a page Taproot no longer publishes, and /tags is no longer a reserved path. A generated page's data holds kind and the four authored fields; tagId leaves the identity, and a source that still carries it is refused by pages push with pages.document_shape as an unsupported field: delete the line from sources pulled before this release.",
+        "A folder index is a search destination when it has an introduction or renders at least three cards; otherwise it carries noindex and leaves the sitemap. Write the page's introductionBody in its pulled .pm.json source to make a small folder one.",
+        "Taproot generates a /map page for a site with a public post that has a location. It is a new generated kind in pulls, /map and every path under it are reserved, and /map/places.json cannot be a redirect source.",
+        "The help reference version is 47."
+      ],
+      "help": [
+        "pages",
+        "page"
+      ]
+    },
     {
       "version": "0.27.1",
       "note": "The site checks refuse a page or redirect source named like a search-engine key file, which the platform now publishes at the site root.",

package/src/cli.js

@@ -139,7 +139,7 @@ const VERBS = Object.freeze([
       + "appearance, header, brand, footer, navigation, redirects, and forms are checked with the validators the "
       + "pushes use, and every problem is reported at once in error.problems (each with its file, code, and field) "
       + "rather than one per run. A pulled workspace is checked offline against the pages (generated ones included, "
-      + "so navigation to a section or tag page resolves), images, and baselines its manifests recorded at the pull. "
+      + "so navigation to a folder index resolves), images, and baselines its manifests recorded at the pull. "
       + "A link whose address is only http(s):// plus its own text (left by older editor autolinking) is reported in "
       + "linkWarnings without refusing; pages push reports the same for the pages it sends. "
       + "The site checks that can run offline are reported in findings (a rule id, severity, file, and the value "
@@ -287,7 +287,7 @@ const VERBS = Object.freeze([
       + "and pull again. A locally edited '.pm.json' is kept rather than overwritten for the same reason. "
       + "First revisions adopted without a completed body comparison are counted in pages.revisionsRecordedWithoutBodyComparison "
       + "and announced on the human channel. New downloads and compared bodies are excluded. "
-      + "A page Taproot generates (a tag, an archive, a place, a folder) is pulled as an update-only '.pm.json' "
+      + "A page Taproot generates (the published archive, the map or a folder) is pulled as an update-only '.pm.json' "
       + "(template 'generated'): you edit its custom title, breadcrumb title, custom description and introduction, "
       + "and the manifest keeps the title and description the site reports. "
       + "A form a page places is written back by its key, the name 'forms/<key>.json' uses, though the site stores "
@@ -445,7 +445,7 @@ const VERBS = Object.freeze([
       + "'places category list', which prints the closed list; a name outside it is refused, and capitalization is "
       + "ignored. Use it when Google's own category for a place is not the one this site wants, such as a park filed "
       + "under Other. The category is this site's alone and applies to every review of that place here: the place "
-      + "itself and other sites do not change. Place-review bylines and the /places/<category> pages use it from the "
+      + "itself and other sites do not change. Place-review bylines use it from the "
       + "next deployment, which a changed category alone is enough to start. Undo it with 'places category clear'.",
   },
   {