@domandigital/craft 0.20.0 → 0.20.2

package/dist/phone.d.cts

@@ -335,6 +335,35 @@ interface ViewportsResult extends MeasuredRoute {
  * not judge or throw on a finding: the baseline decides.
  */
 declare function measureViewports(page: ViewportPage, options: MeasureViewportsOptions): Promise<ViewportsResult>;
+/** The desktop context the wide half is measured in, beside `PHONE` for the phone half. Spread into `browser.newContext`. */
+declare const DESKTOP: {
+    readonly viewport: {
+        readonly width: 1024;
+        readonly height: 768;
+    };
+    readonly deviceScaleFactor: 1;
+};
+/** A page opened at the route, and how to close it when its half is measured. */
+interface OpenedPage {
+    page: ViewportPage;
+    close?: () => Promise<void>;
+}
+/**
+ * Every viewport for a route only the caller can open, such as a portal screen
+ * behind a sign-in (DOM-835). As `measureSite` does for a public page, the
+ * phone half is measured in a phone context and the wide half in a desktop
+ * one; `open(scope)` returns a page already at the route, signed in with the
+ * suite's fixtures, in `PHONE` for "phone" and `DESKTOP` for "wide". The two
+ * halves are merged and written once, for `craft phone-first --measured`.
+ *
+ *     await measureRoute(async (scope) => {
+ *       const context = await browser.newContext({ ...(scope === "phone" ? PHONE : DESKTOP), extraHTTPHeaders: auth });
+ *       const page = await context.newPage();
+ *       await page.goto(base + route);
+ *       return { page, close: () => context.close() };
+ *     }, { route, mainAction: 'a[href="/portal/requests/new"]' });
+ */
+declare function measureRoute(open: (scope: "phone" | "wide") => Promise<OpenedPage>, options: Omit<MeasureViewportsOptions, "scope">): Promise<ViewportsResult>;
 interface SitePage extends ViewportPage {
     goto(url: string): Promise<{
         ok(): boolean;
@@ -419,4 +448,4 @@ interface MeasurePhoneOptions {
  */
 declare function measurePhone(page: MinimalPage, options: MeasurePhoneOptions): Promise<MeasuredRoute>;
 
-export { BANDS, type Band, type Baseline, DEFAULT_MEASURED_DIR, DEFAULT_SWEEP, DEFAULT_THRESHOLDS, EMPTY_BASELINE, type FileException, type InPageGroup, type Judgement, LADDER, type MainAction, type MeasurePhoneOptions, type MeasureSiteOptions, type MeasureViewportsOptions, type MeasuredRoute, PHONE, PHONE_FLOORS, type PhoneCheck, type PhoneFloors, type RawPhoneFinding, SHORT_PHONE, type SiteBrowser, type SitePage, type SiteResult, type StaticFinding, type Sweep, type Thresholds, type Viewport, type ViewportArg, type ViewportPage, type ViewportsResult, WIDE_WIDTHS, bandOf, checkExceptions, formatWidths, judgeMeasured, judgeStatic, mainActionFor, measurePhone, measurePhoneInPage, measureSite, measureViewportInPage, measureViewports, mergeViewportFindings, normaliseElement, reasonOf, routeFile, scanPhoneFirst, sweepWidths, writeBaseline };
+export { BANDS, type Band, type Baseline, DEFAULT_MEASURED_DIR, DEFAULT_SWEEP, DEFAULT_THRESHOLDS, DESKTOP, EMPTY_BASELINE, type FileException, type InPageGroup, type Judgement, LADDER, type MainAction, type MeasurePhoneOptions, type MeasureSiteOptions, type MeasureViewportsOptions, type MeasuredRoute, type OpenedPage, PHONE, PHONE_FLOORS, type PhoneCheck, type PhoneFloors, type RawPhoneFinding, SHORT_PHONE, type SiteBrowser, type SitePage, type SiteResult, type StaticFinding, type Sweep, type Thresholds, type Viewport, type ViewportArg, type ViewportPage, type ViewportsResult, WIDE_WIDTHS, bandOf, checkExceptions, formatWidths, judgeMeasured, judgeStatic, mainActionFor, measurePhone, measurePhoneInPage, measureRoute, measureSite, measureViewportInPage, measureViewports, mergeViewportFindings, normaliseElement, reasonOf, routeFile, scanPhoneFirst, sweepWidths, writeBaseline };

package/dist/phone.d.ts

@@ -335,6 +335,35 @@ interface ViewportsResult extends MeasuredRoute {
  * not judge or throw on a finding: the baseline decides.
  */
 declare function measureViewports(page: ViewportPage, options: MeasureViewportsOptions): Promise<ViewportsResult>;
+/** The desktop context the wide half is measured in, beside `PHONE` for the phone half. Spread into `browser.newContext`. */
+declare const DESKTOP: {
+    readonly viewport: {
+        readonly width: 1024;
+        readonly height: 768;
+    };
+    readonly deviceScaleFactor: 1;
+};
+/** A page opened at the route, and how to close it when its half is measured. */
+interface OpenedPage {
+    page: ViewportPage;
+    close?: () => Promise<void>;
+}
+/**
+ * Every viewport for a route only the caller can open, such as a portal screen
+ * behind a sign-in (DOM-835). As `measureSite` does for a public page, the
+ * phone half is measured in a phone context and the wide half in a desktop
+ * one; `open(scope)` returns a page already at the route, signed in with the
+ * suite's fixtures, in `PHONE` for "phone" and `DESKTOP` for "wide". The two
+ * halves are merged and written once, for `craft phone-first --measured`.
+ *
+ *     await measureRoute(async (scope) => {
+ *       const context = await browser.newContext({ ...(scope === "phone" ? PHONE : DESKTOP), extraHTTPHeaders: auth });
+ *       const page = await context.newPage();
+ *       await page.goto(base + route);
+ *       return { page, close: () => context.close() };
+ *     }, { route, mainAction: 'a[href="/portal/requests/new"]' });
+ */
+declare function measureRoute(open: (scope: "phone" | "wide") => Promise<OpenedPage>, options: Omit<MeasureViewportsOptions, "scope">): Promise<ViewportsResult>;
 interface SitePage extends ViewportPage {
     goto(url: string): Promise<{
         ok(): boolean;
@@ -419,4 +448,4 @@ interface MeasurePhoneOptions {
  */
 declare function measurePhone(page: MinimalPage, options: MeasurePhoneOptions): Promise<MeasuredRoute>;
 
-export { BANDS, type Band, type Baseline, DEFAULT_MEASURED_DIR, DEFAULT_SWEEP, DEFAULT_THRESHOLDS, EMPTY_BASELINE, type FileException, type InPageGroup, type Judgement, LADDER, type MainAction, type MeasurePhoneOptions, type MeasureSiteOptions, type MeasureViewportsOptions, type MeasuredRoute, PHONE, PHONE_FLOORS, type PhoneCheck, type PhoneFloors, type RawPhoneFinding, SHORT_PHONE, type SiteBrowser, type SitePage, type SiteResult, type StaticFinding, type Sweep, type Thresholds, type Viewport, type ViewportArg, type ViewportPage, type ViewportsResult, WIDE_WIDTHS, bandOf, checkExceptions, formatWidths, judgeMeasured, judgeStatic, mainActionFor, measurePhone, measurePhoneInPage, measureSite, measureViewportInPage, measureViewports, mergeViewportFindings, normaliseElement, reasonOf, routeFile, scanPhoneFirst, sweepWidths, writeBaseline };
+export { BANDS, type Band, type Baseline, DEFAULT_MEASURED_DIR, DEFAULT_SWEEP, DEFAULT_THRESHOLDS, DESKTOP, EMPTY_BASELINE, type FileException, type InPageGroup, type Judgement, LADDER, type MainAction, type MeasurePhoneOptions, type MeasureSiteOptions, type MeasureViewportsOptions, type MeasuredRoute, type OpenedPage, PHONE, PHONE_FLOORS, type PhoneCheck, type PhoneFloors, type RawPhoneFinding, SHORT_PHONE, type SiteBrowser, type SitePage, type SiteResult, type StaticFinding, type Sweep, type Thresholds, type Viewport, type ViewportArg, type ViewportPage, type ViewportsResult, WIDE_WIDTHS, bandOf, checkExceptions, formatWidths, judgeMeasured, judgeStatic, mainActionFor, measurePhone, measurePhoneInPage, measureRoute, measureSite, measureViewportInPage, measureViewports, mergeViewportFindings, normaliseElement, reasonOf, routeFile, scanPhoneFirst, sweepWidths, writeBaseline };

package/dist/phone.js

@@ -673,6 +673,21 @@ async function measureViewports(page, options) {
   await page.evaluate(() => document.fonts?.ready.then(() => void 0), void 0);
   return finish(options.route, await collect(page, options), options.out);
 }
+var DESKTOP = { viewport: { width: 1024, height: 768 }, deviceScaleFactor: 1 };
+async function measureRoute(open, options) {
+  if (!options.route.startsWith("/")) throw new Error(`measureRoute: route "${options.route}" should start with /`);
+  const collected = [];
+  for (const scope of ["phone", "wide"]) {
+    const { page, close } = await open(scope);
+    try {
+      await page.evaluate(() => document.fonts?.ready.then(() => void 0), void 0);
+      collected.push(await collect(page, { ...options, scope }));
+    } finally {
+      await close?.();
+    }
+  }
+  return finish(options.route, { perViewport: collected.flatMap((c) => c.perViewport), tested: collected.flatMap((c) => c.tested) }, options.out);
+}
 async function measureSite(browser, options) {
   const result = { routes: [], errors: [] };
   for (const route of options.routes) {
@@ -680,7 +695,7 @@ async function measureSite(browser, options) {
     let failed = null;
     for (const [scope, context] of [
       ["phone", PHONE],
-      ["wide", { viewport: { width: 1024, height: 768 }, deviceScaleFactor: 1 }]
+      ["wide", DESKTOP]
     ]) {
       const ctx = await browser.newContext({ ...context });
       try {
@@ -723,6 +738,7 @@ export {
   DEFAULT_MEASURED_DIR,
   DEFAULT_SWEEP,
   DEFAULT_THRESHOLDS,
+  DESKTOP,
   EMPTY_BASELINE,
   LADDER,
   PHONE,
@@ -737,6 +753,7 @@ export {
   mainActionFor,
   measurePhone,
   measurePhoneInPage,
+  measureRoute,
   measureSite,
   measureViewportInPage,
   measureViewports,

package/dist/{viewports-cli-RYV4LDQK.js → viewports-cli-WWWWEBKI.js}

@@ -5,13 +5,13 @@ import {
 } from "./chunk-IJUZ7RV4.js";
 import {
   loadPlaywright
-} from "./chunk-VDUIIWG7.js";
+} from "./chunk-YOZLPNJS.js";
 import "./chunk-JYNXGCYZ.js";
 import {
   toJson
 } from "./chunk-QIEDBL4J.js";
-import "./chunk-WK2WMWTH.js";
-import "./chunk-CZ7KT452.js";
+import "./chunk-JGWOA4LI.js";
+import "./chunk-7DQDF3VL.js";
 import "./chunk-QYBAVU3P.js";
 
 // src/phone/viewports-cli.ts
@@ -534,6 +534,7 @@ function writeMeasured(result, dir) {
   writeFileSync(join(dir, routeFile(route)), `${JSON.stringify({ route, ...viewport ? { viewport } : {}, ...viewports ? { viewports } : {}, findings }, null, 1)}
 `);
 }
+var DESKTOP = { viewport: { width: 1024, height: 768 }, deviceScaleFactor: 1 };
 async function measureSite(browser, options) {
   const result = { routes: [], errors: [] };
   for (const route of options.routes) {
@@ -541,7 +542,7 @@ async function measureSite(browser, options) {
     let failed = null;
     for (const [scope, context] of [
       ["phone", PHONE],
-      ["wide", { viewport: { width: 1024, height: 768 }, deviceScaleFactor: 1 }]
+      ["wide", DESKTOP]
     ]) {
       const ctx = await browser.newContext({ ...context });
       try {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@domandigital/craft",
-  "version": "0.20.0",
+  "version": "0.20.2",
   "private": false,
   "description": "The Doman Digital house craft standard as numbers: OKLCh colour ramps that snap to existing anchors, derived semantic tokens with measured WCAG and APCA contrast, one shared motion vocabulary for CSS and JS, and a base stylesheet. Zero dependencies.",
   "license": "Apache-2.0",

package/word-lists.json

@@ -1,5 +1,5 @@
 {
-  "catalogueVersion": "2026.09.12",
+  "catalogueVersion": "2026.10.2",
   "lists": {
     "aiWords": [
       "tapestry",
@@ -150,6 +150,8 @@
       "truly",
       "genuinely",
       "deeply",
+      "clear",
+      "clearly",
       "ultimately",
       "one-size-fits-all",
       "one size fits all",