@cloudhal/mcp-server 0.3.6 → 0.3.8

package/dist/src/render/checks/fonts.d.ts

@@ -0,0 +1,5 @@
+/**
+ * In-page checks, part of `RENDER_CHECK_SCRIPT`: font-fallback.
+ * Plain source text, run inside the page; it shares the script's locals (see ./index.ts).
+ */
+export declare const FONT_CHECKS = "  // font-fallback (RFC-0023 \u00A72): text set in a web font whose stack has no metric-matched fallback\n  // right after it (a face with size-adjust or ascent-override). Without one, the text is first\n  // drawn in a system font of another size and moves when the web font arrives.\n  if (document.fonts) {\n    const tuned = new Set(), web = new Set();\n    const name = (f) => f.trim().replace(/^[\"']|[\"']$/g, \"\").toLowerCase();\n    for (const f of document.fonts) {\n      const fam = name(f.family);\n      if ((f.sizeAdjust && f.sizeAdjust !== \"100%\") || (f.ascentOverride && f.ascentOverride !== \"normal\")) tuned.add(fam);\n      else if (f.status === \"loaded\") web.add(fam);\n    }\n    const seen = new Set();\n    const walker = document.createTreeWalker(document.body, NodeFilter.SHOW_TEXT);\n    for (let n = walker.nextNode(); n; n = walker.nextNode()) {\n      const el = n.parentElement;\n      if (!el || !n.textContent.trim()) continue;\n      const stack = getComputedStyle(el).fontFamily;\n      if (seen.has(stack)) continue;\n      seen.add(stack);\n      const fams = stack.split(\",\").map(name);\n      if (!web.has(fams[0]) || tuned.has(fams[0]) || tuned.has(fams[1] || \"\")) continue;\n      if (!visible(el)) { seen.delete(stack); continue; }\n      add(\"font-fallback\", el, JSON.stringify(fams[0]) + \" has no metric-matched fallback after it, so the text moves when the font loads\");\n    }\n  }\n";

package/dist/src/render/checks/fonts.js

@@ -0,0 +1,30 @@
+/**
+ * In-page checks, part of `RENDER_CHECK_SCRIPT`: font-fallback.
+ * Plain source text, run inside the page; it shares the script's locals (see ./index.ts).
+ */
+export const FONT_CHECKS = `  // font-fallback (RFC-0023 §2): text set in a web font whose stack has no metric-matched fallback
+  // right after it (a face with size-adjust or ascent-override). Without one, the text is first
+  // drawn in a system font of another size and moves when the web font arrives.
+  if (document.fonts) {
+    const tuned = new Set(), web = new Set();
+    const name = (f) => f.trim().replace(/^["']|["']$/g, "").toLowerCase();
+    for (const f of document.fonts) {
+      const fam = name(f.family);
+      if ((f.sizeAdjust && f.sizeAdjust !== "100%") || (f.ascentOverride && f.ascentOverride !== "normal")) tuned.add(fam);
+      else if (f.status === "loaded") web.add(fam);
+    }
+    const seen = new Set();
+    const walker = document.createTreeWalker(document.body, NodeFilter.SHOW_TEXT);
+    for (let n = walker.nextNode(); n; n = walker.nextNode()) {
+      const el = n.parentElement;
+      if (!el || !n.textContent.trim()) continue;
+      const stack = getComputedStyle(el).fontFamily;
+      if (seen.has(stack)) continue;
+      seen.add(stack);
+      const fams = stack.split(",").map(name);
+      if (!web.has(fams[0]) || tuned.has(fams[0]) || tuned.has(fams[1] || "")) continue;
+      if (!visible(el)) { seen.delete(stack); continue; }
+      add("font-fallback", el, JSON.stringify(fams[0]) + " has no metric-matched fallback after it, so the text moves when the font loads");
+    }
+  }
+`;

package/dist/src/render/checks/index.js

@@ -10,6 +10,7 @@
 import { COMPONENT_CHECKS } from "./components.js";
 import { CONTENT_CHECKS } from "./content.js";
 import { CONTRAST_CHECKS } from "./contrast.js";
+import { FONT_CHECKS } from "./fonts.js";
 import { LAYOUT_CHECKS } from "./layout.js";
 import { MOTION_CHECKS } from "./motion.js";
 import { NAVIGATION_CHECKS } from "./navigation.js";
@@ -21,6 +22,7 @@ export const RENDER_CHECK_SCRIPT = [
   LAYOUT_CHECKS,
   CONTRAST_CHECKS,
   CONTENT_CHECKS,
+  FONT_CHECKS,
   MOTION_CHECKS,
   NAVIGATION_CHECKS,
   COMPONENT_CHECKS,

package/dist/src/render/types.d.ts

@@ -41,7 +41,7 @@ export interface RenderCheck {
     /** The widths it failed at. */
     widths: number[];
 }
-export declare const RENDER_CHECK_IDS: readonly ["overflow-x", "img-alt", "img-broken", "heading-order", "contrast", "empty-section", "tap-target", "long-line", "input-label", "chart-empty", "reduced-motion", "motion-cls", "motion-budget", "flash", "skip-link", "landmarks", "header-contrast", "focus-obscured", "overlay-open", "carousel-label", "carousel-lcp", "carousel-focus", "carousel-autoplay", "image-fit"];
+export declare const RENDER_CHECK_IDS: readonly ["overflow-x", "img-alt", "img-broken", "heading-order", "contrast", "empty-section", "tap-target", "long-line", "input-label", "chart-empty", "reduced-motion", "motion-cls", "motion-budget", "flash", "skip-link", "landmarks", "header-contrast", "focus-obscured", "overlay-open", "carousel-label", "carousel-lcp", "carousel-focus", "carousel-autoplay", "image-fit", "font-fallback"];
 export type RenderCheckId = (typeof RENDER_CHECK_IDS)[number];
 export interface RenderShot {
     width: number;

package/dist/src/render/types.js

@@ -87,6 +87,8 @@ export const RENDER_CHECK_IDS = [
   "carousel-autoplay",
   // RFC-0028: an image cropped hard by cover with no focal point to keep its subject in view.
   "image-fit",
+  // RFC-0023 §2: a web font with no metric-matched fallback, so its text moves when it loads.
+  "font-fallback",
 ]         ;
                                                               
 

package/dist/src/render-tools.js

@@ -72,6 +72,7 @@ const WHAT                                                    = {
   "carousel-focus": "carousel focus",
   "carousel-autoplay": "carousel autoplay",
   "image-fit": "image crops",
+  "font-fallback": "font swap shift",
 };
 
 function summary(r                  )         {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cloudhal/mcp-server",
-  "version": "0.3.6",
+  "version": "0.3.8",
   "description": "Cloudhal MCP server: semantic site tools (pages, articles, snapshots, preview, publish) governed by the policy engine",
   "license": "Apache-2.0",
   "homepage": "https://cloudhal.dev",
@@ -56,15 +56,15 @@
     "README.md"
   ],
   "dependencies": {
-    "@cloudhal/analytics": "0.3.6",
-    "@cloudhal/agent-runtime": "0.3.6",
-    "@cloudhal/astro-renderer": "0.3.6",
-    "@cloudhal/comments": "0.3.6",
-    "@cloudhal/core-contracts": "0.3.6",
-    "@cloudhal/core-ts": "0.3.6",
-    "@cloudhal/storage": "0.3.6",
+    "@cloudhal/analytics": "0.3.8",
+    "@cloudhal/agent-runtime": "0.3.8",
+    "@cloudhal/astro-renderer": "0.3.8",
+    "@cloudhal/comments": "0.3.8",
+    "@cloudhal/core-contracts": "0.3.8",
+    "@cloudhal/core-ts": "0.3.8",
+    "@cloudhal/storage": "0.3.8",
     "@modelcontextprotocol/server": "2.3.1",
-    "@cloudhal/schedules": "0.3.6"
+    "@cloudhal/schedules": "0.3.8"
   },
   "devDependencies": {
     "@cloudflare/workers-types": "^5.20261007.1",