@typeroll/mcp-server 0.45.84 → 0.45.86

package/dist/tools/settings.js

@@ -84,7 +84,8 @@ export const settingsTools = [
             staging_url: z.string().nullable().optional().describe('URL of a staging environment for this site, reported as urls.staging. Stored on the Site, not per version. Trailing slashes are dropped; empty string or null clears.'),
             form_submission_retention_days: z.number().int().min(30).max(3650).nullable().optional().describe('Opt-in deletion of completed form submissions this many days (30–3650) after they were completed, on every form of the site, including existing submissions: those already older are deleted immediately and cannot be restored. null (the default) keeps submissions until someone deletes them. Site administrators only (never an Extension credential); stored on the Site, not per version. The response reports form_submission_retention { updated, deleted }. Partial submissions keep their form\'s partial_ttl_days.'),
             render_version: z.number().int().min(1).optional().describe('Platform render version. Platform output changes ship as new versions so existing sites never change look on their own. Upgrade only after previewing (get_preview_link render_version) and with the user\'s approval; the tr-upgrade-rendering skill compares every page. Lowering it returns to an earlier version.'),
-            design_scales: z.record(z.string(), z.record(z.string(), z.string())).optional().describe('Site token scales (replaced as a whole): type_size xs/sm/md/lg/xl/2xl/3xl; space none/xs/sm/md/lg/xl in px/rem/em; leading tight/snug/normal/relaxed/loose as unitless 1–2. Omitted steps use platform defaults.'),
+            typography: z.object({ ratio_mobile: z.number().min(1.1).max(1.5).optional(), ratio_desktop: z.number().min(1.1).max(1.5).optional(), rhythm: z.number().min(0.5).max(2).optional(), line_length: z.number().min(40).max(90).optional() }).strict().optional().describe('Fluid design controls (render version 10+). Base size is fonts.size_base. Replaces typography as a whole; omitted controls use defaults.'),
+            design_scales: z.record(z.string(), z.record(z.string(), z.union([z.string(), z.object({ mobile: z.string().optional(), tablet: z.string().optional(), laptop: z.string().optional(), desktop: z.string().optional(), wide: z.string().optional() }).strict()]))).optional().describe('Site token scales (replaced as a whole): type_size xs/sm/md/lg/xl/2xl/3xl; space none/xs/sm/md/lg/xl in px/rem/em or clamp(min, length + vw, max), or responsive maps; leading tight/snug/normal/relaxed/loose as unitless 1–2. Omitted steps use platform defaults.'),
             colors: z.record(z.string(), z.string().nullable()).optional().describe('Palette: primary, secondary, accent, background, surface, surface_hover, text, text_light (shallow-merged). Optional on_primary, on_secondary, on_accent set the text colour on that theme colour (buttons, badges, tabs, call-to-action sections, styles using the on_* tokens) as a hex colour such as "#ffffff"; null returns to the automatic black or white (chosen by APCA from render version 8, by the WCAG 2 ratio before). A chosen on_* colour applies on every render version. The response lists `on_colors` with each one\'s APCA Lc and WCAG 2 ratio; a choice below APCA Lc 60 (button text, 16px/600) is kept and returned as a warning. Prefer the automatic choice unless the brand specifies a colour.'),
             fonts: z.record(z.string(), z.unknown()).optional().describe('heading, body, mono (Google Fonts family or "system"), size_base (px) and smoothing: "auto" (browser default) or "antialiased" (thinner text on macOS, for light text on dark backgrounds); null clears smoothing. Unset smoothing is auto from render version 6.'),
             contact: z

package/dist/version.js

@@ -8,4 +8,4 @@
 //
 // Keep it in lockstep with package.json: tests/version.test.ts asserts
 // VERSION === package.json.version, so a bump that forgets this line fails CI.
-export const VERSION = '0.45.84';
+export const VERSION = '0.45.86';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@typeroll/mcp-server",
-  "version": "0.45.84",
+  "version": "0.45.86",
   "description": "Typeroll CMS MCP server \u2013 connect AI agents to the REST API to manage content and publish static websites.",
   "license": "MIT",
   "repository": {

package/skills/tr-brand.md

@@ -367,3 +367,26 @@ Open in browser. Check:
   phantom margins inside the wrapper — visible as white bands above and
   below the photo. Zero it explicitly in your figure CSS:
   `.my-figure img { margin: 0; border-radius: 0 }`.
+
+## Fluid typography and component rhythm
+
+Core 0.2.114 / MCP 0.45.85 / capabilities 0.55.0 adds responsive scales.
+Check the connected versions before using this contract. New sites use render
+version 10. For an existing site, test a Version first; upgrading rendering
+and replacing existing roles are separate, deliberate choices.
+
+Use `fonts.size_base` (default 16), `typography.ratio_mobile` (1.2),
+`typography.ratio_desktop` (1.25), `typography.rhythm` (1), and
+`typography.line_length` (65 ch). Set the controls once, then use named type,
+spacing and line-height steps. `apply_standard_styles` uses those steps;
+`overwrite: true` resets existing roles, so review their current values first.
+Explicit sizes and breakpoint overrides still win and are not silently migrated.
+
+Heading role margins belong to editorial flow. Component titles use their own
+padding/gap, and opening headings in containers/sections add no top margin.
+Use role-linked `core/heading` size `auto` or `theme`; explicit hero sizes remain
+deliberate exceptions. Do not compensate with per-card negative margins.
+Compare 375, 768 and 1280px in Site settings → Design and in a full site preview.
+After a rendering upgrade/rebuild, recheck cards, boxed headings, leading text
+and webfonts. Boxes should get their outer air from padding. Keep exceptions
+in decisions.md, and run lint_design_tokens before launch.

package/skills/tr-migrate-wp.md

@@ -429,3 +429,26 @@ DNS, explicitly prepare the last published snapshot for the future hosts with
 traffic separately. If newer content is published while the candidate waits,
 prepare again before cutover; do not overwrite it with an outdated snapshot. Respect preserve/renew choices for owner-supplied facts;
 "timeless" wording must not invent recurring events or erase preserved copy.
+
+## Fluid typography and component rhythm
+
+Core 0.2.114 / MCP 0.45.85 / capabilities 0.55.0 adds responsive scales.
+Check the connected versions before using this contract. New sites use render
+version 10. For an existing site, test a Version first; upgrading rendering
+and replacing existing roles are separate, deliberate choices.
+
+Use `fonts.size_base` (default 16), `typography.ratio_mobile` (1.2),
+`typography.ratio_desktop` (1.25), `typography.rhythm` (1), and
+`typography.line_length` (65 ch). Set the controls once, then use named type,
+spacing and line-height steps. `apply_standard_styles` uses those steps;
+`overwrite: true` resets existing roles, so review their current values first.
+Explicit sizes and breakpoint overrides still win and are not silently migrated.
+
+Heading role margins belong to editorial flow. Component titles use their own
+padding/gap, and opening headings in containers/sections add no top margin.
+Use role-linked `core/heading` size `auto` or `theme`; explicit hero sizes remain
+deliberate exceptions. Do not compensate with per-card negative margins.
+Compare 375, 768 and 1280px in Site settings → Design and in a full site preview.
+After a rendering upgrade/rebuild, recheck cards, boxed headings, leading text
+and webfonts. Boxes should get their outer air from padding. Keep exceptions
+in decisions.md, and run lint_design_tokens before launch.

package/skills/tr-new-site.md

@@ -437,3 +437,26 @@ For migrated legacy pages or a hand-crafted one-off, `content_mode:
 ## Organization access
 
 When a Cloud write reports `organization_trial_ended` or `organization_access_ended`, use `read_organization_access` on the selected Site. Explain the deadline and recovery URL; keep reads and export available when permitted. Do not repeatedly retry or create another organization to bypass the lock. Self-hosted installations are unrestricted by default. A trial does not limit AI credits: the organization supplies its own provider key.
+
+## Fluid typography and component rhythm
+
+Core 0.2.114 / MCP 0.45.85 / capabilities 0.55.0 adds responsive scales.
+Check the connected versions before using this contract. New sites use render
+version 10. For an existing site, test a Version first; upgrading rendering
+and replacing existing roles are separate, deliberate choices.
+
+Use `fonts.size_base` (default 16), `typography.ratio_mobile` (1.2),
+`typography.ratio_desktop` (1.25), `typography.rhythm` (1), and
+`typography.line_length` (65 ch). Set the controls once, then use named type,
+spacing and line-height steps. `apply_standard_styles` uses those steps;
+`overwrite: true` resets existing roles, so review their current values first.
+Explicit sizes and breakpoint overrides still win and are not silently migrated.
+
+Heading role margins belong to editorial flow. Component titles use their own
+padding/gap, and opening headings in containers/sections add no top margin.
+Use role-linked `core/heading` size `auto` or `theme`; explicit hero sizes remain
+deliberate exceptions. Do not compensate with per-card negative margins.
+Compare 375, 768 and 1280px in Site settings → Design and in a full site preview.
+After a rendering upgrade/rebuild, recheck cards, boxed headings, leading text
+and webfonts. Boxes should get their outer air from padding. Keep exceptions
+in decisions.md, and run lint_design_tokens before launch.

package/skills/tr-starter-design.md

@@ -113,3 +113,26 @@ uses the same color-mix() recipe as the header.
   match what's already there.
 - Choosing a new palette or fonts is brand work (the MCP recipe `tr-brand`),
   not this reference.
+
+## Fluid typography and component rhythm
+
+Core 0.2.114 / MCP 0.45.85 / capabilities 0.55.0 adds responsive scales.
+Check the connected versions before using this contract. New sites use render
+version 10. For an existing site, test a Version first; upgrading rendering
+and replacing existing roles are separate, deliberate choices.
+
+Use `fonts.size_base` (default 16), `typography.ratio_mobile` (1.2),
+`typography.ratio_desktop` (1.25), `typography.rhythm` (1), and
+`typography.line_length` (65 ch). Set the controls once, then use named type,
+spacing and line-height steps. `apply_standard_styles` uses those steps;
+`overwrite: true` resets existing roles, so review their current values first.
+Explicit sizes and breakpoint overrides still win and are not silently migrated.
+
+Heading role margins belong to editorial flow. Component titles use their own
+padding/gap, and opening headings in containers/sections add no top margin.
+Use role-linked `core/heading` size `auto` or `theme`; explicit hero sizes remain
+deliberate exceptions. Do not compensate with per-card negative margins.
+Compare 375, 768 and 1280px in Site settings → Design and in a full site preview.
+After a rendering upgrade/rebuild, recheck cards, boxed headings, leading text
+and webfonts. Boxes should get their outer air from padding. Keep exceptions
+in decisions.md, and run lint_design_tokens before launch.

package/workspace-templates/qa/checklist.md

@@ -57,3 +57,9 @@ Follow workflows/page-notes.md and pages/README.md. Create notes during migratio
 read before edits, update afterward, check external links at each editorial review,
 and archive notes for confirmed removed Pages under pages/archived/. Refreshing
 generated facts never counts as a completed review. Keep notes out of public output.
+
+- After a Core rendering upgrade, compare typography and spacing at 375, 768
+  and 1280px. Opening headings in cards, boxes and sections must not add the
+  editorial heading's top margin. Check actual fonts as well as the Site settings
+  scale preview. Run `node scripts/typeroll/check_heading_spacing.cjs <origin>`
+  and review deliberate exceptions in decisions.md.

package/workspace-templates/scripts/README.md

@@ -117,3 +117,12 @@ See workflows/source-media.md for archive verification and original preservation
 Omit --dry-run to write local files; --migration-inventory adds recorded redirect
 sources. It never writes to the CMS, marks a Page reviewed or deletes notes. Read
 pages/README.md and workflows/page-notes.md before first use.
+
+### Heading rhythm after a rebuild
+
+`node scripts/typeroll/check_heading_spacing.cjs https://example.com [paths.json]`
+checks opening component headings and card spacing at 375, 768 and 1280px.
+`paths.json` is an array of same-origin page paths; otherwise it reads a flat
+sitemap. Requires Playwright and its Chromium browser. Findings need visual
+review: deliberate asymmetric cards belong in decisions.md. It is a read-only
+QA helper, not a publication gate or a CSS repair tool.

package/workspace-templates/scripts/typeroll/check_heading_spacing.cjs

@@ -0,0 +1,49 @@
+// Read-only component rhythm QA. Deliberate exceptions require visual review.
+const { chromium } = require('playwright');
+const fs = require('node:fs');
+async function main() {
+  const origin = new URL(process.argv[2]);
+  if (!['http:', 'https:'].includes(origin.protocol) || origin.username || origin.password) throw Error('Use an http(s) origin without credentials.');
+  const browser = await chromium.launch();
+  try {
+    const page = await browser.newPage();
+    let paths;
+    if (process.argv[3]) paths = JSON.parse(fs.readFileSync(process.argv[3], 'utf8'));
+    else {
+      const response = await page.request.get(new URL('/sitemap.xml', origin).href);
+      if (!response.ok()) throw Error(`Sitemap returned ${response.status()}`);
+      const xml = await response.text();
+      if (xml.includes('<sitemapindex')) throw Error('Provide paths.json for a sitemap index.');
+      paths = [...xml.matchAll(/<loc>([^<]+)<\/loc>/g)].map(m => m[1].replace(/&amp;/g,'&'));
+    }
+    if (!Array.isArray(paths) || !paths.length || paths.some(p => typeof p !== 'string' || new URL(p,origin).origin !== origin.origin)) throw Error('Provide a nonempty array of same-origin paths.');
+    let count = 0;
+    for (const width of [375,768,1280]) {
+      await page.setViewportSize({width,height:900});
+      for (const path of [...new Set(paths)]) {
+        await page.goto(new URL(path,origin).href,{waitUntil:'domcontentloaded'});
+        await page.evaluate(()=>document.fonts.ready);
+        const findings=await page.evaluate(()=>{
+          const found=[];
+          const roots=document.querySelectorAll('[data-block="container"], .block-section-inner, [data-block="post_card"] [class*="postcard-body"], [data-block="icon_box"]');
+          for(const root of roots) {
+            const visible=[...root.children].filter(e=>e.getBoundingClientRect().height>0);
+            const first=visible[0];
+            const heading=first?.matches('h1,h2,h3,h4,h5,h6')?first:first?.matches('[data-block="heading"],hgroup')?first.querySelector('h1,h2,h3,h4,h5,h6'):null;
+            if(heading && parseFloat(getComputedStyle(heading).marginBlockStart)>1) found.push({kind:'opening_heading_margin',block:root.closest('[data-block]')?.getAttribute('data-block'),text:heading.textContent.slice(0,80),px:parseFloat(getComputedStyle(heading).marginBlockStart)});
+            if(root.closest('[data-block="post_card"]') && visible.length) {
+              const rect=root.getBoundingClientRect(),top=visible[0].getBoundingClientRect().top-rect.top,bottom=rect.bottom-visible.at(-1).getBoundingClientRect().bottom;
+              if(top>bottom+4) found.push({kind:'asymmetric_card',top:Math.round(top),bottom:Math.round(bottom)});
+            }
+          }
+          return found;
+        });
+        count+=findings.length;
+        if(findings.length) console.log(JSON.stringify({path:new URL(path,origin).pathname,width,findings}));
+      }
+    }
+    console.log(JSON.stringify({pages:paths.length,widths:[375,768,1280],findings:count}));
+    process.exitCode=count?1:0;
+  } finally {await browser.close();}
+}
+main().catch(error=>{console.error(error.message);process.exitCode=2;});

package/workspace-templates/workflows/design.md

@@ -63,3 +63,26 @@ review the plan before applying it in a dedicated Version. Equal hex values can
 mean different roles: never automatically choose between background and text.
 Verify a primary/surface change in a test Version across header, footer, cards,
 menus and buttons, then restore the test settings. Do not republish automatically.
+
+## Fluid typography and component rhythm
+
+Core 0.2.114 / MCP 0.45.85 / capabilities 0.55.0 adds responsive scales.
+Check the connected versions before using this contract. New sites use render
+version 10. For an existing site, test a Version first; upgrading rendering
+and replacing existing roles are separate, deliberate choices.
+
+Use `fonts.size_base` (default 16), `typography.ratio_mobile` (1.2),
+`typography.ratio_desktop` (1.25), `typography.rhythm` (1), and
+`typography.line_length` (65 ch). Set the controls once, then use named type,
+spacing and line-height steps. `apply_standard_styles` uses those steps;
+`overwrite: true` resets existing roles, so review their current values first.
+Explicit sizes and breakpoint overrides still win and are not silently migrated.
+
+Heading role margins belong to editorial flow. Component titles use their own
+padding/gap, and opening headings in containers/sections add no top margin.
+Use role-linked `core/heading` size `auto` or `theme`; explicit hero sizes remain
+deliberate exceptions. Do not compensate with per-card negative margins.
+Compare 375, 768 and 1280px in Site settings → Design and in a full site preview.
+After a rendering upgrade/rebuild, recheck cards, boxed headings, leading text
+and webfonts. Boxes should get their outer air from padding. Keep exceptions
+in decisions.md, and run lint_design_tokens before launch.

package/workspace-templates/workflows/migration.md

@@ -134,3 +134,26 @@ Follow workflows/page-notes.md and pages/README.md. Create notes during migratio
 read before edits, update afterward, check external links at each editorial review,
 and archive notes for confirmed removed Pages under pages/archived/. Refreshing
 generated facts never counts as a completed review. Keep notes out of public output.
+
+## Fluid typography and component rhythm
+
+Core 0.2.114 / MCP 0.45.85 / capabilities 0.55.0 adds responsive scales.
+Check the connected versions before using this contract. New sites use render
+version 10. For an existing site, test a Version first; upgrading rendering
+and replacing existing roles are separate, deliberate choices.
+
+Use `fonts.size_base` (default 16), `typography.ratio_mobile` (1.2),
+`typography.ratio_desktop` (1.25), `typography.rhythm` (1), and
+`typography.line_length` (65 ch). Set the controls once, then use named type,
+spacing and line-height steps. `apply_standard_styles` uses those steps;
+`overwrite: true` resets existing roles, so review their current values first.
+Explicit sizes and breakpoint overrides still win and are not silently migrated.
+
+Heading role margins belong to editorial flow. Component titles use their own
+padding/gap, and opening headings in containers/sections add no top margin.
+Use role-linked `core/heading` size `auto` or `theme`; explicit hero sizes remain
+deliberate exceptions. Do not compensate with per-card negative margins.
+Compare 375, 768 and 1280px in Site settings → Design and in a full site preview.
+After a rendering upgrade/rebuild, recheck cards, boxed headings, leading text
+and webfonts. Boxes should get their outer air from padding. Keep exceptions
+in decisions.md, and run lint_design_tokens before launch.