@forgebook/testing 0.0.0-stage → 0.1.2

package/dist/bin/forgebook-shot/forgebook-shot.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"forgebook-shot.mjs","sourceRoot":"","sources":["../../../bin/forgebook-shot/forgebook-shot.mts"],"names":[],"mappings":"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"}

package/dist/bin/forgebook-shot/storyShot.d.ts

@@ -0,0 +1,34 @@
+import type { StoryShot } from "./storyShot.types.ts";
+/** What a shot is taken of, and how. */
+export type ShotRequest = {
+    /** The catalogue's address (`http://localhost:5310/`). */
+    readonly catalogue: string;
+    /** The story's id (`acme-ui:feedback-counter--plain`). */
+    readonly story: string;
+    /** The view, as the catalogue's address writes it (`theme=dark&lang=it`); empty for the defaults. */
+    readonly view: string;
+    /** The width the story is drawn at, in CSS px. */
+    readonly width: number;
+    /** Where the picture goes; none for no picture. */
+    readonly out: string | undefined;
+    /** Whether to check the story's accessibility. */
+    readonly isA11y: boolean;
+    /** How long to wait for the story, in ms. */
+    readonly timeout: number;
+};
+/**
+ * The frame's address of a story with a view: the catalogue's own `frame.html`, with only what the frame reads.
+ *
+ * @param catalogue - the catalogue's address.
+ * @param story - the story's id.
+ * @param view - the view as the catalogue's address writes it.
+ */
+export declare const shotAddress: (catalogue: string, story: string, view: string) => string;
+/**
+ * Opens a story's frame, waits for it, and reports what it shows.
+ *
+ * @param request - the story, the view and what to do.
+ * @returns the report; a frame that never answers is `timeout`, not an exception.
+ */
+export declare const takeShot: (request: ShotRequest) => Promise<StoryShot>;
+//# sourceMappingURL=storyShot.d.ts.map

package/dist/bin/forgebook-shot/storyShot.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"storyShot.d.ts","sourceRoot":"","sources":["../../../bin/forgebook-shot/storyShot.ts"],"names":[],"mappings":"AAiBA,OAAO,KAAK,EAAc,SAAS,EAAE,MAAM,sBAAsB,CAAC;AAElE,wCAAwC;AACxC,MAAM,MAAM,WAAW,GAAG;IACxB,0DAA0D;IAC1D,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,0DAA0D;IAC1D,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,qGAAqG;IACrG,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,kDAAkD;IAClD,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,mDAAmD;IACnD,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,CAAC;IACjC,kDAAkD;IAClD,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;IACzB,6CAA6C;IAC7C,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CAC1B,CAAC;AAEF;;;;;;GAMG;AACH,eAAO,MAAM,WAAW,cAAe,MAAM,SAAS,MAAM,QAAQ,MAAM,KAAG,MAEpE,CAAC;AAEV;;;;;GAKG;AACH,eAAO,MAAM,QAAQ,YAAmB,WAAW,KAAG,OAAO,CAAC,SAAS,CA0DtE,CAAC"}

package/dist/bin/forgebook-shot/storyShot.js

@@ -0,0 +1,83 @@
+/**
+ * The logic of `forgebook-shot`: the frame's address of a story with a view, and the run in a browser that opens it,
+ * waits for its story and reports.
+ *
+ * @remarks
+ * The frame page is the address the catalogue and the generated tests open: what an agent sees is what a
+ * person sees in the stage. `shotAddress` is pure; `takeShot` drives Chromium through Playwright.
+ *
+ * @module
+ */
+import { AxeBuilder } from "@axe-core/playwright";
+import { chromium } from "@playwright/test";
+import { DEFAULT_A11Y_TAGS } from "forgebook/catalogue";
+import { STATUS_ATTRIBUTE } from "forgebook/frame-status";
+import { frameAddressOf } from "forgebook/view-state";
+/**
+ * The frame's address of a story with a view: the catalogue's own `frame.html`, with only what the frame reads.
+ *
+ * @param catalogue - the catalogue's address.
+ * @param story - the story's id.
+ * @param view - the view as the catalogue's address writes it.
+ */
+export const shotAddress = (catalogue, story, view) => new URL(frameAddressOf("frame.html", story, view), catalogue.endsWith("/") ? catalogue : `${catalogue}/`)
+    .href;
+/**
+ * Opens a story's frame, waits for it, and reports what it shows.
+ *
+ * @param request - the story, the view and what to do.
+ * @returns the report; a frame that never answers is `timeout`, not an exception.
+ */
+export const takeShot = async (request) => {
+    const address = shotAddress(request.catalogue, request.story, request.view);
+    const browser = await chromium.launch();
+    try {
+        // a context of its own: axe works only on a page made by one
+        const context = await browser.newContext({ viewport: { width: request.width, height: 800 } });
+        const page = await context.newPage();
+        const consoleErrors = [];
+        page.on("pageerror", (error) => consoleErrors.push(error.message));
+        page.on("console", (message) => {
+            if (message.type() === "error")
+                consoleErrors.push(message.text());
+        });
+        await page.goto(address);
+        // a text expression: the command runs on Node, where the page's own globals are not typed
+        const status = await page
+            .waitForFunction(`document.documentElement.getAttribute(${JSON.stringify(STATUS_ATTRIBUTE)})`, undefined, {
+            timeout: request.timeout
+        })
+            .then(async (handle) => ((await handle.jsonValue()) === "ready" ? "ready" : "error"))
+            .catch(() => "timeout");
+        const error = status === "error"
+            ? ((await page.locator(".forgebook-frame-error__message").first().textContent()) ?? undefined)
+            : undefined;
+        const box = await page.locator("body").boundingBox();
+        const size = { width: Math.ceil(box?.width ?? 0), height: Math.ceil(box?.height ?? 0) };
+        if (request.out !== undefined)
+            await page.screenshot({ path: request.out, fullPage: true, animations: "disabled" });
+        const violations = request.isA11y
+            ? (await new AxeBuilder({ page }).withTags([...DEFAULT_A11Y_TAGS]).analyze()).violations.map((violation) => ({
+                id: violation.id,
+                help: violation.help,
+                impact: violation.impact ?? undefined,
+                helpUrl: violation.helpUrl,
+                targets: violation.nodes.map((node) => node.target.map(String).join(" "))
+            }))
+            : undefined;
+        return {
+            story: request.story,
+            address,
+            status,
+            ...(error === undefined ? {} : { error }),
+            size,
+            ...(request.out === undefined ? {} : { screenshot: request.out }),
+            consoleErrors,
+            ...(violations === undefined ? {} : { violations })
+        };
+    }
+    finally {
+        await browser.close();
+    }
+};
+//# sourceMappingURL=storyShot.js.map

package/dist/bin/forgebook-shot/storyShot.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"storyShot.js","sourceRoot":"","sources":["../../../bin/forgebook-shot/storyShot.ts"],"names":[],"mappings":"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"}

package/dist/bin/forgebook-shot/storyShot.types.d.ts

@@ -0,0 +1,32 @@
+/**
+ * The `--json` document of `forgebook-shot`: how a story's frame ended, its size, where its picture went and, when
+ * asked, the accessibility rules it breaks.
+ *
+ * @module
+ */
+import type { Violation } from "forgebook/a11y";
+/** How the frame ended: its story shown, its error shown, or no answer before the time ran out. */
+export type ShotStatus = "ready" | "error" | "timeout";
+/** What `forgebook-shot` reports. */
+export type StoryShot = {
+    /** The story's id. */
+    readonly story: string;
+    /** The frame's address that was opened. */
+    readonly address: string;
+    /** How the frame ended. */
+    readonly status: ShotStatus;
+    /** The frame's error, when its story could not be shown. */
+    readonly error?: string;
+    /** The story's size in CSS px, at the width it was drawn at. */
+    readonly size: {
+        readonly width: number;
+        readonly height: number;
+    };
+    /** The picture's path, when one was written. */
+    readonly screenshot?: string;
+    /** The errors the page printed or threw. */
+    readonly consoleErrors: readonly string[];
+    /** The accessibility rules the story breaks, when asked (`--a11y`). */
+    readonly violations?: readonly Violation[];
+};
+//# sourceMappingURL=storyShot.types.d.ts.map

package/dist/bin/forgebook-shot/storyShot.types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"storyShot.types.d.ts","sourceRoot":"","sources":["../../../bin/forgebook-shot/storyShot.types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAEhD,mGAAmG;AACnG,MAAM,MAAM,UAAU,GAAG,OAAO,GAAG,OAAO,GAAG,SAAS,CAAC;AAEvD,qCAAqC;AACrC,MAAM,MAAM,SAAS,GAAG;IACtB,sBAAsB;IACtB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,2CAA2C;IAC3C,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,2BAA2B;IAC3B,QAAQ,CAAC,MAAM,EAAE,UAAU,CAAC;IAC5B,4DAA4D;IAC5D,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,gEAAgE;IAChE,QAAQ,CAAC,IAAI,EAAE;QAAE,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC;IACnE,gDAAgD;IAChD,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAC7B,4CAA4C;IAC5C,QAAQ,CAAC,aAAa,EAAE,SAAS,MAAM,EAAE,CAAC;IAC1C,uEAAuE;IACvE,QAAQ,CAAC,UAAU,CAAC,EAAE,SAAS,SAAS,EAAE,CAAC;CAC5C,CAAC"}

package/dist/bin/forgebook-shot/storyShot.types.js

@@ -0,0 +1 @@
+//# sourceMappingURL=storyShot.types.js.map

package/dist/bin/forgebook-shot/storyShot.types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"storyShot.types.js","sourceRoot":"","sources":["../../../bin/forgebook-shot/storyShot.types.ts"],"names":[],"mappings":""}

package/dist/src/browserTests.d.ts

@@ -0,0 +1,55 @@
+import { type Page } from "@playwright/test";
+import { type CatalogueLists } from "forgebook/catalogue";
+import { type ViewSwitch } from "forgebook/switches";
+import { type ViewState } from "forgebook/view-state";
+import { type StoryFilesOptions } from "./storyFiles.ts";
+/** One way of showing every story. */
+export type StoryVariant = {
+    /** The variant's name, in the test's title and the reference image's name. */
+    readonly name: string;
+    /**
+     * What it sets over the defaults: switches' values, the style sheets, the text size; never the backdrop, since
+     * every test draws the story on its page's colour.
+     */
+    readonly view: Partial<Omit<ViewState, "backdrop">>;
+    /** The frame's width in CSS px; the test browser's default when none. */
+    readonly width?: number;
+};
+/** The narrow variant's width: about the catalogue's stage beside the props panel in a laptop window, in CSS px. */
+export declare const NARROW_WIDTH = 560;
+/**
+ * The variants every story is tested in, from the catalogue's switches: each scheme of its colour scheme switch (the
+ * system's left out, it draws one of them), each at more contrast when it has a contrast switch (`dark-more`), then the
+ * first scheme with the structure only, and in a narrow frame.
+ *
+ * @param switches - the catalogue's switches.
+ */
+export declare const storyVariants: (switches: readonly ViewSwitch[]) => StoryVariant[];
+/** The variants of a catalogue with the default switches: light, dark, both at more contrast, structure, narrow. */
+export declare const STORY_VARIANTS: readonly StoryVariant[];
+/** The generated tests' options. */
+export type StoryBrowserTestsOptions = StoryFilesOptions & {
+    /** The frame page, relative to the test's `baseURL`; `frame.html` by default. */
+    readonly frameUrl?: string;
+    /** The catalogue's switches, as the frame page's configuration gives them; the theme and the contrast by default. */
+    readonly switches?: readonly ViewSwitch[];
+    /** The catalogue's lists, as its configuration gives them: its accessibility rules, backgrounds, text sizes. */
+    readonly lists?: CatalogueLists;
+    /** The variants; `storyVariants` of the switches by default. */
+    readonly variants?: readonly StoryVariant[];
+    /** Compare each frame with its reference image instead of running the checks; `false` by default. */
+    readonly screenshot?: boolean;
+    /**
+     * A check of the source's own, run on every story's frame after axe (a rule of its components that axe does not
+     * know); it fails the test with Playwright's `expect`. None by default; skipped with `screenshot`.
+     */
+    readonly check?: (page: Page) => Promise<void>;
+};
+/**
+ * Declares the tests, one `describe` per component and one test per story and variant.
+ *
+ * @param options - where the stories are, the frame page, the variants, whether to compare screenshots, and a check of
+ * the source's own.
+ */
+export declare const storyBrowserTests: (options: StoryBrowserTestsOptions) => void;
+//# sourceMappingURL=browserTests.d.ts.map

package/dist/src/browserTests.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"browserTests.d.ts","sourceRoot":"","sources":["../../src/browserTests.ts"],"names":[],"mappings":"AAiBA,OAAO,EAAU,KAAK,IAAI,EAAQ,MAAM,kBAAkB,CAAC;AAC3D,OAAO,EAAE,KAAK,cAAc,EAAqB,MAAM,qBAAqB,CAAC;AAI7E,OAAO,EAAoC,KAAK,UAAU,EAAE,MAAM,oBAAoB,CAAC;AACvF,OAAO,EAA6B,KAAK,SAAS,EAAE,MAAM,sBAAsB,CAAC;AAIjF,OAAO,EAAiB,KAAK,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AAExE,sCAAsC;AACtC,MAAM,MAAM,YAAY,GAAG;IACzB,8EAA8E;IAC9E,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB;;;OAGG;IACH,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC,IAAI,CAAC,SAAS,EAAE,UAAU,CAAC,CAAC,CAAC;IACpD,yEAAyE;IACzE,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;CACzB,CAAC;AAEF,oHAAoH;AACpH,eAAO,MAAM,YAAY,MAAM,CAAC;AAEhC;;;;;;GAMG;AACH,eAAO,MAAM,aAAa,aAAc,SAAS,UAAU,EAAE,KAAG,YAAY,EAuB3E,CAAC;AAEF,oHAAoH;AACpH,eAAO,MAAM,cAAc,EAAE,SAAS,YAAY,EAAoC,CAAC;AAEvF,oCAAoC;AACpC,MAAM,MAAM,wBAAwB,GAAG,iBAAiB,GAAG;IACzD,iFAAiF;IACjF,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,qHAAqH;IACrH,QAAQ,CAAC,QAAQ,CAAC,EAAE,SAAS,UAAU,EAAE,CAAC;IAC1C,gHAAgH;IAChH,QAAQ,CAAC,KAAK,CAAC,EAAE,cAAc,CAAC;IAChC,gEAAgE;IAChE,QAAQ,CAAC,QAAQ,CAAC,EAAE,SAAS,YAAY,EAAE,CAAC;IAC5C,qGAAqG;IACrG,QAAQ,CAAC,UAAU,CAAC,EAAE,OAAO,CAAC;IAC9B;;;OAGG;IACH,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC,IAAI,EAAE,IAAI,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;CAChD,CAAC;AAwBF;;;;;GAKG;AACH,eAAO,MAAM,iBAAiB,YAAa,wBAAwB,KAAG,IAsDrE,CAAC"}

package/dist/src/browserTests.js

@@ -0,0 +1,137 @@
+/**
+ * One Playwright test per story and variant, on the catalogue's frame pages: the address the catalogue shows is the
+ * address the tests open.
+ *
+ * @remarks
+ * Each test opens the frame for a story in a variant (the theme, the contrast, the style sheets), waits for the
+ * frame to say the story is shown (`data-forgebook-status`), its story clock held at its start, and fails on an error in the console or the page, or on
+ * an axe violation of WCAG 2.2 A and AA, on an element that spills out of its parent (`spills.ts`: what overlaps a
+ * neighbour when the story is narrower than it was drawn for), on an overlay its play leaves open past the frame the
+ * catalogue would give it (`overlays.ts`: the story then declares `parameters.height`), or on the source's own
+ * `check`. The variants include a
+ * narrow frame, as wide as the catalogue's stage beside the props panel. With `screenshot` it compares the frame with its reference image instead,
+ * for the visual tests, which run in the Playwright container so fonts and rendering are the same everywhere.
+ *
+ * @module
+ */
+import { AxeBuilder } from "@axe-core/playwright";
+import { expect, test } from "@playwright/test";
+import { catalogueSettings } from "forgebook/catalogue";
+import { STATUS_ATTRIBUTE } from "forgebook/frame-status";
+import { heldClockAddress } from "forgebook/story-clock";
+import { storyTree, testedStoryLocations } from "forgebook/story-tree";
+import { DEFAULT_SWITCHES, switchWithRole } from "forgebook/switches";
+import { defaultView, frameAddress } from "forgebook/view-state";
+import { findOverlaysPastFrame, isOverlayChecked } from "./overlays.js";
+import { findSpills } from "./spills.js";
+import { indexedSource } from "./storyFiles.js";
+/** The narrow variant's width: about the catalogue's stage beside the props panel in a laptop window, in CSS px. */
+export const NARROW_WIDTH = 560;
+/**
+ * The variants every story is tested in, from the catalogue's switches: each scheme of its colour scheme switch (the
+ * system's left out, it draws one of them), each at more contrast when it has a contrast switch (`dark-more`), then the
+ * first scheme with the structure only, and in a narrow frame.
+ *
+ * @param switches - the catalogue's switches.
+ */
+export const storyVariants = (switches) => {
+    const scheme = switchWithRole(switches, "colorScheme");
+    const contrast = switchWithRole(switches, "contrast");
+    const more = contrast?.values.find((value) => value.isMore === true);
+    const schemes = (scheme?.values ?? []).filter((value) => value.isUnset !== true);
+    const schemeView = (value) => scheme === undefined || value === undefined ? {} : { [scheme.id]: value };
+    const first = schemeView(schemes[0]?.value);
+    const named = schemes.length > 0 ? schemes : [undefined];
+    return [
+        ...named.map((value) => ({
+            name: value?.value ?? "default",
+            view: { switches: schemeView(value?.value) }
+        })),
+        ...(contrast === undefined || more === undefined
+            ? []
+            : named.map((value) => ({
+                name: `${value?.value ?? "default"}-more`,
+                view: { switches: { ...schemeView(value?.value), [contrast.id]: more.value } }
+            }))),
+        { name: "structure", view: { switches: first, sheets: "structure" } },
+        { name: "narrow", view: { switches: first }, width: NARROW_WIDTH }
+    ];
+};
+/** The variants of a catalogue with the default switches: light, dark, both at more contrast, structure, narrow. */
+export const STORY_VARIANTS = storyVariants(DEFAULT_SWITCHES);
+/**
+ * The overlays a story's play leaves open past its frame, as the test's messages; none in a view that is not checked
+ * (`isOverlayChecked`).
+ *
+ * @param page - the story's frame page, its play over.
+ * @param variant - the variant the test shows the story in.
+ * @param sceneHeight - the height the story declares, in CSS px, if any.
+ * @returns one message per overlay past the frame.
+ */
+const overlayProblems = async (page, variant, sceneHeight) => {
+    if (!isOverlayChecked(variant.view))
+        return [];
+    const overlays = await findOverlaysPastFrame(page, sceneHeight);
+    return overlays.map((overlay) => `${overlay.element} ends ${overlay.by}px below the frame's ${overlay.frameHeight}px: declare parameters.height`);
+};
+/**
+ * Declares the tests, one `describe` per component and one test per story and variant.
+ *
+ * @param options - where the stories are, the frame page, the variants, whether to compare screenshots, and a check of
+ * the source's own.
+ */
+export const storyBrowserTests = (options) => {
+    const { frameUrl = "frame.html", switches = DEFAULT_SWITCHES, screenshot = false, check } = options;
+    const variants = options.variants ?? storyVariants(switches);
+    const catalogue = catalogueSettings("", switches, options.lists);
+    const defaults = defaultView(catalogue);
+    const tree = storyTree([indexedSource(options)]);
+    const groups = Map.groupBy(testedStoryLocations(tree), (location) => location.component.title);
+    for (const [title, locations] of groups) {
+        test.describe(title, () => {
+            for (const { story } of locations) {
+                for (const variant of variants) {
+                    test(`${story.name} · ${variant.name}`, async ({ page }) => {
+                        const errors = [];
+                        page.on("pageerror", (error) => errors.push(error.message));
+                        page.on("console", (message) => {
+                            if (message.type() === "error")
+                                errors.push(message.text());
+                        });
+                        if (variant.width !== undefined)
+                            await page.setViewportSize({ width: variant.width, height: 800 });
+                        // a Live story is checked and pictured at its start: its clock held, so its image never changes;
+                        // always on its page's own colour, whatever a variant names: a backdrop is for looking
+                        const view = {
+                            ...defaults,
+                            ...variant.view,
+                            switches: { ...defaults.switches, ...variant.view.switches },
+                            backdrop: "plain"
+                        };
+                        await page.goto(heldClockAddress(frameAddress(frameUrl, story.id, view, switches)));
+                        await expect(page.locator("html")).toHaveAttribute(STATUS_ATTRIBUTE, "ready");
+                        if (screenshot) {
+                            await expect(page).toHaveScreenshot(`${story.id.replace(":", "--")}--${variant.name}.png`, {
+                                fullPage: true,
+                                animations: "disabled"
+                            });
+                            return;
+                        }
+                        const { violations } = await new AxeBuilder({ page })
+                            .withTags([...catalogue.a11y.tags])
+                            .disableRules([...catalogue.a11y.disabledRules])
+                            .analyze();
+                        expect(violations.map((violation) => `${violation.id}: ${violation.help}`)).toEqual([]);
+                        const spills = await page.evaluate(findSpills, ".forgebook-frame");
+                        expect(spills.map((spill) => `${spill.element} spills out of ${spill.parent} by ${spill.by}px`)).toEqual([]);
+                        await check?.(page);
+                        // last: it resizes the window, which may close what the story left open
+                        expect(await overlayProblems(page, variant, story.height)).toEqual([]);
+                        expect(errors).toEqual([]);
+                    });
+                }
+            }
+        });
+    }
+};
+//# sourceMappingURL=browserTests.js.map

package/dist/src/browserTests.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"browserTests.js","sourceRoot":"","sources":["../../src/browserTests.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AACH,OAAO,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAClD,OAAO,EAAE,MAAM,EAAa,IAAI,EAAE,MAAM,kBAAkB,CAAC;AAC3D,OAAO,EAAuB,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAC7E,OAAO,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAC1D,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AACzD,OAAO,EAAE,SAAS,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAC;AACvE,OAAO,EAAE,gBAAgB,EAAE,cAAc,EAAmB,MAAM,oBAAoB,CAAC;AACvF,OAAO,EAAE,WAAW,EAAE,YAAY,EAAkB,MAAM,sBAAsB,CAAC;AAEjF,OAAO,EAAE,qBAAqB,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AACxE,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,aAAa,EAA0B,MAAM,iBAAiB,CAAC;AAexE,oHAAoH;AACpH,MAAM,CAAC,MAAM,YAAY,GAAG,GAAG,CAAC;AAEhC;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC,QAA+B,EAAkB,EAAE;IAC/E,MAAM,MAAM,GAAG,cAAc,CAAC,QAAQ,EAAE,aAAa,CAAC,CAAC;IACvD,MAAM,QAAQ,GAAG,cAAc,CAAC,QAAQ,EAAE,UAAU,CAAC,CAAC;IACtD,MAAM,IAAI,GAAG,QAAQ,EAAE,MAAM,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,MAAM,KAAK,IAAI,CAAC,CAAC;IACrE,MAAM,OAAO,GAAG,CAAC,MAAM,EAAE,MAAM,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,OAAO,KAAK,IAAI,CAAC,CAAC;IACjF,MAAM,UAAU,GAAG,CAAC,KAAyB,EAAoC,EAAE,CACjF,MAAM,KAAK,SAAS,IAAI,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,MAAM,CAAC,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC;IAC5E,MAAM,KAAK,GAAG,UAAU,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC;IAC5C,MAAM,KAAK,GAAG,OAAO,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC;IACzD,OAAO;QACL,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;YACvB,IAAI,EAAE,KAAK,EAAE,KAAK,IAAI,SAAS;YAC/B,IAAI,EAAE,EAAE,QAAQ,EAAE,UAAU,CAAC,KAAK,EAAE,KAAK,CAAC,EAAE;SAC7C,CAAC,CAAC;QACH,GAAG,CAAC,QAAQ,KAAK,SAAS,IAAI,IAAI,KAAK,SAAS;YAC9C,CAAC,CAAC,EAAE;YACJ,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;gBACpB,IAAI,EAAE,GAAG,KAAK,EAAE,KAAK,IAAI,SAAS,OAAO;gBACzC,IAAI,EAAE,EAAE,QAAQ,EAAE,EAAE,GAAG,UAAU,CAAC,KAAK,EAAE,KAAK,CAAC,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,EAAE,IAAI,CAAC,KAAK,EAAE,EAAE;aAC/E,CAAC,CAAC,CAAC;QACR,EAAE,IAAI,EAAE,WAAW,EAAE,IAAI,EAAE,EAAE,QAAQ,EAAE,KAAK,EAAE,MAAM,EAAE,WAAW,EAAE,EAAE;QACrE,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,EAAE,QAAQ,EAAE,KAAK,EAAE,EAAE,KAAK,EAAE,YAAY,EAAE;KACnE,CAAC;AACJ,CAAC,CAAC;AAEF,oHAAoH;AACpH,MAAM,CAAC,MAAM,cAAc,GAA4B,aAAa,CAAC,gBAAgB,CAAC,CAAC;AAqBvF;;;;;;;;GAQG;AACH,MAAM,eAAe,GAAG,KAAK,EAC3B,IAAU,EACV,OAAqB,EACrB,WAA+B,EACZ,EAAE;IACrB,IAAI,CAAC,gBAAgB,CAAC,OAAO,CAAC,IAAI,CAAC;QAAE,OAAO,EAAE,CAAC;IAC/C,MAAM,QAAQ,GAAG,MAAM,qBAAqB,CAAC,IAAI,EAAE,WAAW,CAAC,CAAC;IAChE,OAAO,QAAQ,CAAC,GAAG,CACjB,CAAC,OAAO,EAAE,EAAE,CACV,GAAG,OAAO,CAAC,OAAO,SAAS,OAAO,CAAC,EAAE,wBAAwB,OAAO,CAAC,WAAW,+BAA+B,CAClH,CAAC;AACJ,CAAC,CAAC;AAEF;;;;;GAKG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,OAAiC,EAAQ,EAAE;IAC3E,MAAM,EAAE,QAAQ,GAAG,YAAY,EAAE,QAAQ,GAAG,gBAAgB,EAAE,UAAU,GAAG,KAAK,EAAE,KAAK,EAAE,GAAG,OAAO,CAAC;IACpG,MAAM,QAAQ,GAAG,OAAO,CAAC,QAAQ,IAAI,aAAa,CAAC,QAAQ,CAAC,CAAC;IAC7D,MAAM,SAAS,GAAG,iBAAiB,CAAC,EAAE,EAAE,QAAQ,EAAE,OAAO,CAAC,KAAK,CAAC,CAAC;IACjE,MAAM,QAAQ,GAAG,WAAW,CAAC,SAAS,CAAC,CAAC;IACxC,MAAM,IAAI,GAAG,SAAS,CAAC,CAAC,aAAa,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;IACjD,MAAM,MAAM,GAAG,GAAG,CAAC,OAAO,CAAC,oBAAoB,CAAC,IAAI,CAAC,EAAE,CAAC,QAAQ,EAAE,EAAE,CAAC,QAAQ,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;IAC/F,KAAK,MAAM,CAAC,KAAK,EAAE,SAAS,CAAC,IAAI,MAAM,EAAE,CAAC;QACxC,IAAI,CAAC,QAAQ,CAAC,KAAK,EAAE,GAAG,EAAE;YACxB,KAAK,MAAM,EAAE,KAAK,EAAE,IAAI,SAAS,EAAE,CAAC;gBAClC,KAAK,MAAM,OAAO,IAAI,QAAQ,EAAE,CAAC;oBAC/B,IAAI,CAAC,GAAG,KAAK,CAAC,IAAI,MAAM,OAAO,CAAC,IAAI,EAAE,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,EAAE,EAAE;wBACzD,MAAM,MAAM,GAAa,EAAE,CAAC;wBAC5B,IAAI,CAAC,EAAE,CAAC,WAAW,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC;wBAC5D,IAAI,CAAC,EAAE,CAAC,SAAS,EAAE,CAAC,OAAO,EAAE,EAAE;4BAC7B,IAAI,OAAO,CAAC,IAAI,EAAE,KAAK,OAAO;gCAAE,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC,CAAC;wBAC9D,CAAC,CAAC,CAAC;wBACH,IAAI,OAAO,CAAC,KAAK,KAAK,SAAS;4BAC7B,MAAM,IAAI,CAAC,eAAe,CAAC,EAAE,KAAK,EAAE,OAAO,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,CAAC,CAAC;wBACpE,iGAAiG;wBACjG,uFAAuF;wBACvF,MAAM,IAAI,GAAc;4BACtB,GAAG,QAAQ;4BACX,GAAG,OAAO,CAAC,IAAI;4BACf,QAAQ,EAAE,EAAE,GAAG,QAAQ,CAAC,QAAQ,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,QAAQ,EAAE;4BAC5D,QAAQ,EAAE,OAAO;yBAClB,CAAC;wBACF,MAAM,IAAI,CAAC,IAAI,CAAC,gBAAgB,CAAC,YAAY,CAAC,QAAQ,EAAE,KAAK,CAAC,EAAE,EAAE,IAAI,EAAE,QAAQ,CAAC,CAAC,CAAC,CAAC;wBACpF,MAAM,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,eAAe,CAAC,gBAAgB,EAAE,OAAO,CAAC,CAAC;wBAC9E,IAAI,UAAU,EAAE,CAAC;4BACf,MAAM,MAAM,CAAC,IAAI,CAAC,CAAC,gBAAgB,CAAC,GAAG,KAAK,CAAC,EAAE,CAAC,OAAO,CAAC,GAAG,EAAE,IAAI,CAAC,KAAK,OAAO,CAAC,IAAI,MAAM,EAAE;gCACzF,QAAQ,EAAE,IAAI;gCACd,UAAU,EAAE,UAAU;6BACvB,CAAC,CAAC;4BACH,OAAO;wBACT,CAAC;wBACD,MAAM,EAAE,UAAU,EAAE,GAAG,MAAM,IAAI,UAAU,CAAC,EAAE,IAAI,EAAE,CAAC;6BAClD,QAAQ,CAAC,CAAC,GAAG,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;6BAClC,YAAY,CAAC,CAAC,GAAG,SAAS,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;6BAC/C,OAAO,EAAE,CAAC;wBACb,MAAM,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,GAAG,SAAS,CAAC,EAAE,KAAK,SAAS,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;wBACxF,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,QAAQ,CAAC,UAAU,EAAE,kBAAkB,CAAC,CAAC;wBACnE,MAAM,CACJ,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,GAAG,KAAK,CAAC,OAAO,kBAAkB,KAAK,CAAC,MAAM,OAAO,KAAK,CAAC,EAAE,IAAI,CAAC,CACzF,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;wBACd,MAAM,KAAK,EAAE,CAAC,IAAI,CAAC,CAAC;wBACpB,wEAAwE;wBACxE,MAAM,CAAC,MAAM,eAAe,CAAC,IAAI,EAAE,OAAO,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;wBACvE,MAAM,CAAC,MAAM,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;oBAC7B,CAAC,CAAC,CAAC;gBACL,CAAC;YACH,CAAC;QACH,CAAC,CAAC,CAAC;IACL,CAAC;AACH,CAAC,CAAC"}

package/dist/src/fonts/Inter-OFL.txt

@@ -0,0 +1,92 @@
+Copyright (c) 2016 The Inter Project Authors (https://github.com/rsms/inter)
+
+This Font Software is licensed under the SIL Open Font License, Version 1.1.
+This license is copied below, and is also available with a FAQ at:
+http://scripts.sil.org/OFL
+
+-----------------------------------------------------------
+SIL OPEN FONT LICENSE Version 1.1 - 26 February 2007
+-----------------------------------------------------------
+
+PREAMBLE
+The goals of the Open Font License (OFL) are to stimulate worldwide
+development of collaborative font projects, to support the font creation
+efforts of academic and linguistic communities, and to provide a free and
+open framework in which fonts may be shared and improved in partnership
+with others.
+
+The OFL allows the licensed fonts to be used, studied, modified and
+redistributed freely as long as they are not sold by themselves. The
+fonts, including any derivative works, can be bundled, embedded,
+redistributed and/or sold with any software provided that any reserved
+names are not used by derivative works. The fonts and derivatives,
+however, cannot be released under any other type of license. The
+requirement for fonts to remain under this license does not apply
+to any document created using the fonts or their derivatives.
+
+DEFINITIONS
+"Font Software" refers to the set of files released by the Copyright
+Holder(s) under this license and clearly marked as such. This may
+include source files, build scripts and documentation.
+
+"Reserved Font Name" refers to any names specified as such after the
+copyright statement(s).
+
+"Original Version" refers to the collection of Font Software components as
+distributed by the Copyright Holder(s).
+
+"Modified Version" refers to any derivative made by adding to, deleting,
+or substituting -- in part or in whole -- any of the components of the
+Original Version, by changing formats or by porting the Font Software to a
+new environment.
+
+"Author" refers to any designer, engineer, programmer, technical
+writer or other person who contributed to the Font Software.
+
+PERMISSION AND CONDITIONS
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of the Font Software, to use, study, copy, merge, embed, modify,
+redistribute, and sell modified and unmodified copies of the Font
+Software, subject to the following conditions:
+
+1) Neither the Font Software nor any of its individual components,
+in Original or Modified Versions, may be sold by itself.
+
+2) Original or Modified Versions of the Font Software may be bundled,
+redistributed and/or sold with any software, provided that each copy
+contains the above copyright notice and this license. These can be
+included either as stand-alone text files, human-readable headers or
+in the appropriate machine-readable metadata fields within text or
+binary files as long as those fields can be easily viewed by the user.
+
+3) No Modified Version of the Font Software may use the Reserved Font
+Name(s) unless explicit written permission is granted by the corresponding
+Copyright Holder. This restriction only applies to the primary font name as
+presented to the users.
+
+4) The name(s) of the Copyright Holder(s) or the Author(s) of the Font
+Software shall not be used to promote, endorse or advertise any
+Modified Version, except to acknowledge the contribution(s) of the
+Copyright Holder(s) and the Author(s) or with their explicit written
+permission.
+
+5) The Font Software, modified or unmodified, in part or in whole,
+must be distributed entirely under this license, and must not be
+distributed under any other license. The requirement for fonts to
+remain under this license does not apply to any document created
+using the Font Software.
+
+TERMINATION
+This license becomes null and void if any of the above conditions are
+not met.
+
+DISCLAIMER
+THE FONT SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO ANY WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT
+OF COPYRIGHT, PATENT, TRADEMARK, OR OTHER RIGHT. IN NO EVENT SHALL THE
+COPYRIGHT HOLDER BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY,
+INCLUDING ANY GENERAL, SPECIAL, INDIRECT, INCIDENTAL, OR CONSEQUENTIAL
+DAMAGES, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
+FROM, OUT OF THE USE OR INABILITY TO USE THE FONT SOFTWARE OR FROM
+OTHER DEALINGS IN THE FONT SOFTWARE.

package/dist/src/fonts/JetBrainsMono-OFL.txt

@@ -0,0 +1,93 @@
+Copyright 2020 The JetBrains Mono Project Authors (https://github.com/JetBrains/JetBrainsMono)
+
+This Font Software is licensed under the SIL Open Font License, Version 1.1.
+This license is copied below, and is also available with a FAQ at:
+https://openfontlicense.org
+
+
+-----------------------------------------------------------
+SIL OPEN FONT LICENSE Version 1.1 - 26 February 2007
+-----------------------------------------------------------
+
+PREAMBLE
+The goals of the Open Font License (OFL) are to stimulate worldwide
+development of collaborative font projects, to support the font creation
+efforts of academic and linguistic communities, and to provide a free and
+open framework in which fonts may be shared and improved in partnership
+with others.
+
+The OFL allows the licensed fonts to be used, studied, modified and
+redistributed freely as long as they are not sold by themselves. The
+fonts, including any derivative works, can be bundled, embedded, 
+redistributed and/or sold with any software provided that any reserved
+names are not used by derivative works. The fonts and derivatives,
+however, cannot be released under any other type of license. The
+requirement for fonts to remain under this license does not apply
+to any document created using the fonts or their derivatives.
+
+DEFINITIONS
+"Font Software" refers to the set of files released by the Copyright
+Holder(s) under this license and clearly marked as such. This may
+include source files, build scripts and documentation.
+
+"Reserved Font Name" refers to any names specified as such after the
+copyright statement(s).
+
+"Original Version" refers to the collection of Font Software components as
+distributed by the Copyright Holder(s).
+
+"Modified Version" refers to any derivative made by adding to, deleting,
+or substituting -- in part or in whole -- any of the components of the
+Original Version, by changing formats or by porting the Font Software to a
+new environment.
+
+"Author" refers to any designer, engineer, programmer, technical
+writer or other person who contributed to the Font Software.
+
+PERMISSION & CONDITIONS
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of the Font Software, to use, study, copy, merge, embed, modify,
+redistribute, and sell modified and unmodified copies of the Font
+Software, subject to the following conditions:
+
+1) Neither the Font Software nor any of its individual components,
+in Original or Modified Versions, may be sold by itself.
+
+2) Original or Modified Versions of the Font Software may be bundled,
+redistributed and/or sold with any software, provided that each copy
+contains the above copyright notice and this license. These can be
+included either as stand-alone text files, human-readable headers or
+in the appropriate machine-readable metadata fields within text or
+binary files as long as those fields can be easily viewed by the user.
+
+3) No Modified Version of the Font Software may use the Reserved Font
+Name(s) unless explicit written permission is granted by the corresponding
+Copyright Holder. This restriction only applies to the primary font name as
+presented to the users.
+
+4) The name(s) of the Copyright Holder(s) or the Author(s) of the Font
+Software shall not be used to promote, endorse or advertise any
+Modified Version, except to acknowledge the contribution(s) of the
+Copyright Holder(s) and the Author(s) or with their explicit written
+permission.
+
+5) The Font Software, modified or unmodified, in part or in whole,
+must be distributed entirely under this license, and must not be
+distributed under any other license. The requirement for fonts to
+remain under this license does not apply to any document created
+using the Font Software.
+
+TERMINATION
+This license becomes null and void if any of the above conditions are
+not met.
+
+DISCLAIMER
+THE FONT SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO ANY WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT
+OF COPYRIGHT, PATENT, TRADEMARK, OR OTHER RIGHT. IN NO EVENT SHALL THE
+COPYRIGHT HOLDER BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY,
+INCLUDING ANY GENERAL, SPECIAL, INDIRECT, INCIDENTAL, OR CONSEQUENTIAL
+DAMAGES, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
+FROM, OUT OF THE USE OR INABILITY TO USE THE FONT SOFTWARE OR FROM
+OTHER DEALINGS IN THE FONT SOFTWARE.

package/dist/src/fonts/fonts.css

@@ -0,0 +1,34 @@
+/*
+ * The fonts of the visual tests: Inter and JetBrains Mono (SIL Open Font License 1.1, the licences beside them).
+ * The visual tests run in the Playwright container, on Linux, where `-apple-system` and `SF Mono` do not exist: a
+ * library's font stacks fall back to these, the same on every run. Published as `./testing/fonts.css` and imported
+ * only by a package's test frame page, never by a catalogue.
+ */
+@font-face {
+  font-family: "Inter";
+  font-style: normal;
+  font-weight: 100 900;
+  src: url("./Inter-latin-ext.woff2") format("woff2");
+  unicode-range: U+0100-02BA, U+02BD-02C5, U+02C7-02CC, U+02CE-02D7, U+02DD-02FF, U+0304, U+0308, U+0329, U+1D00-1DBF, U+1E00-1E9F, U+1EF2-1EFF, U+2020, U+20A0-20AB, U+20AD-20C4, U+2113, U+2C60-2C7F, U+A720-A7FF;
+}
+@font-face {
+  font-family: "Inter";
+  font-style: normal;
+  font-weight: 100 900;
+  src: url("./Inter-latin.woff2") format("woff2");
+  unicode-range: U+0000-00FF, U+0131, U+0152-0153, U+02BB-02BC, U+02C6, U+02DA, U+02DC, U+0304, U+0308, U+0329, U+2000-206F, U+20AC, U+2122, U+2191, U+2193, U+2212, U+2215, U+FEFF, U+FFFD;
+}
+@font-face {
+  font-family: "JetBrains Mono";
+  font-style: normal;
+  font-weight: 100 800;
+  src: url("./JetBrainsMono-latin-ext.woff2") format("woff2");
+  unicode-range: U+0100-02BA, U+02BD-02C5, U+02C7-02CC, U+02CE-02D7, U+02DD-02FF, U+0304, U+0308, U+0329, U+1D00-1DBF, U+1E00-1E9F, U+1EF2-1EFF, U+2020, U+20A0-20AB, U+20AD-20C4, U+2113, U+2C60-2C7F, U+A720-A7FF;
+}
+@font-face {
+  font-family: "JetBrains Mono";
+  font-style: normal;
+  font-weight: 100 800;
+  src: url("./JetBrainsMono-latin.woff2") format("woff2");
+  unicode-range: U+0000-00FF, U+0131, U+0152-0153, U+02BB-02BC, U+02C6, U+02DA, U+02DC, U+0304, U+0308, U+0329, U+2000-206F, U+20AC, U+2122, U+2191, U+2193, U+2212, U+2215, U+FEFF, U+FFFD;
+}