@loadbare/app 0.6.0 → 0.7.0

package/dist/tests/expand.test.js

@@ -1,253 +0,0 @@
-/**
- * Expansion — see docs/reference/custom-elements.md and docs/testing.md, tier 1.
- *
- * Definitions are written inline here because `expand` takes them as a map
- * and a two-line definition beside its assertion reads better than a file
- * reference. The cases that genuinely need files — the checks `loadDefinitions`
- * runs, and directory ordering — use tests/fixtures/definitions.
- */
-import assert from "node:assert/strict";
-import { describe, it } from "node:test";
-import { fileURLToPath } from "node:url";
-import { JSDOM } from "jsdom";
-import { expand, loadDefinitions } from "../build/expand";
-const FIXTURES = fileURLToPath(new URL("./fixtures/definitions", import.meta.url));
-/**
- * Read expansion's output as a tree.
- *
- * Used where the claim is about the document rather than about the text —
- * which elements exist, which attributes an element has. Matching a
- * serialization would test the serializer.
- */
-function parseHtml(html) {
-    const holder = new JSDOM("").window.document.createElement("div");
-    holder.innerHTML = html;
-    return holder;
-}
-/** Definitions are keyed by the uppercased tag they define. */
-function defs(entries) {
-    const map = {};
-    for (const [tag, source] of Object.entries(entries)) {
-        map[tag.toUpperCase()] = source;
-    }
-    return map;
-}
-// --- Rejections ----------------------------------------------------------
-//
-// Expansion runs before any request exists, so every one of these is a build
-// that must not produce output. Each asserts on the message as well as the
-// throw: an author reads the message, and it is the whole of the diagnosis.
-describe("expansion rejects", () => {
-    it("a parameter the definition never declared", () => {
-        assert.throws(() => expand(`<lb-thing exp-label="Name"></lb-thing>`, defs({ "lb-thing": `<div></div>` })), /given exp-label, but its definition has no \{\{label\}\}/);
-    });
-    it("a placeholder no tag could supply", async () => {
-        await assert.rejects(() => loadDefinitions([`${FIXTURES}/camel`]), /declares \{\{inputClass\}\}.*Write \{\{input-class\}\}/s);
-    });
-    it("a cycle in the definition graph", async () => {
-        await assert.rejects(() => loadDefinitions([`${FIXTURES}/cycle`]), /cycle in the definition graph/);
-    });
-    it("two destinations with one name", () => {
-        assert.throws(() => expand(`<lb-thing></lb-thing>`, defs({
-            "lb-thing": `<table><thead lb-template="head"></thead><tfoot lb-template="head"></tfoot></table>`,
-        })), /declares two lb-template="head" destinations/);
-    });
-    it("two templates for one destination", () => {
-        assert.throws(() => expand(`<lb-thing>` +
-            `<template lb-template="head"><tr></tr></template>` +
-            `<template lb-template="head"><tr></tr></template>` +
-            `</lb-thing>`, defs({
-            "lb-thing": `<table><thead lb-template="head"></thead></table>`,
-        })), /was given two templates for 'head'/);
-    });
-    it("a template naming a destination the definition does not have", () => {
-        assert.throws(() => expand(`<lb-thing><template lb-template="foot"><tr></tr></template></lb-thing>`, defs({
-            "lb-thing": `<table><thead lb-template="head"></thead></table>`,
-        })), /has no destination by that name/);
-    });
-    it("content written into a definition with no slot", () => {
-        assert.throws(() => expand(`<lb-thing><p>hello</p></lb-thing>`, defs({ "lb-thing": `<div></div>` })), /content was written inside <lb-thing>, whose definition has no lb-slot/);
-    });
-    it("a definition declaring more than one slot", () => {
-        assert.throws(() => expand(`<lb-thing></lb-thing>`, defs({
-            "lb-thing": `<div lb-slot></div><span lb-slot></span>`,
-        })), /declares more than one lb-slot/);
-    });
-});
-// --- Substitution --------------------------------------------------------
-describe("substitution", () => {
-    it("fills an attribute and a text node", () => {
-        const html = expand(`<lb-thing exp-label="Name" exp-name="who"></lb-thing>`, defs({
-            "lb-thing": `<label>{{label}}<input name="{{name}}" /></label>`,
-        }));
-        assert.match(html, /<label>Name<input name="who"><\/label>/);
-    });
-    it("drops an attribute whose placeholder was not supplied", () => {
-        // Presence propagates: an unsupplied placeholder must not emit
-        // readonly="", which HTML reads as readonly.
-        const html = expand(`<lb-thing></lb-thing>`, defs({ "lb-thing": `<input readonly="{{readonly}}" />` }));
-        assert.match(html, /<input>/);
-        assert.doesNotMatch(html, /readonly/);
-    });
-    it("keeps the whitespace around a text placeholder", () => {
-        // "{{label}} <input>" has to keep separating the label from the control.
-        const html = expand(`<lb-thing exp-label="Name"></lb-thing>`, defs({ "lb-thing": `<label>{{label}} <input /></label>` }));
-        assert.match(html, /<label>Name <input><\/label>/);
-    });
-    it("fills an unsupplied text placeholder with nothing", () => {
-        const html = expand(`<lb-thing></lb-thing>`, defs({ "lb-thing": `<label>{{label}}</label>` }));
-        assert.match(html, /<label><\/label>/);
-    });
-    it("falls back to a default the definition wrote", () => {
-        const html = expand(`<lb-thing></lb-thing>`, defs({ "lb-thing": `<button>{{text|OK}}</button>` }));
-        assert.match(html, /<button>OK<\/button>/);
-    });
-    it("lets a supplied value win over a default", () => {
-        const html = expand(`<lb-thing exp-text="Go"></lb-thing>`, defs({ "lb-thing": `<button>{{text|OK}}</button>` }));
-        assert.match(html, /<button>Go<\/button>/);
-    });
-    it("trims whitespace around a name and its default", () => {
-        // A spaced form that shipped as literal braces would be a silent failure
-        // found in the browser, so the space is not part of either side.
-        const html = expand(`<lb-thing></lb-thing>`, defs({
-            "lb-thing": `<button title="{{ tip | Press me }}">{{ text | OK }}</button>`,
-        }));
-        assert.match(html, /<button title="Press me">OK<\/button>/);
-    });
-    it("emits an attribute whose default is empty", () => {
-        // The one case a default distinguishes from no default: presence.
-        // readonly="{{readonly|}}" is a boolean attribute on unless a tag turns
-        // it off — which, since a supplied value is a string, a tag cannot do;
-        // the default is for a definition that wants the attribute there.
-        const html = expand(`<lb-thing></lb-thing>`, defs({ "lb-thing": `<input readonly="{{readonly|}}" />` }));
-        assert.match(html, /<input readonly="">/);
-    });
-    it("reaches placeholders inside template content", () => {
-        // lb-picker ships a row template of its own, so {{key}} written inside
-        // one has to be a placeholder rather than literal text that ships.
-        const html = expand(`<lb-thing exp-key="id" exp-cell="name"></lb-thing>`, defs({
-            "lb-thing": `<select><template lb-key="{{key}}"><option lb-cell="{{cell}}"></option></template></select>`,
-        }));
-        assert.match(html, /<template lb-key="id">/);
-        assert.match(html, /<option lb-cell="name">/);
-    });
-    it("leaves a partial placeholder alone", () => {
-        // A placeholder is an entire attribute value or an entire text node.
-        const html = expand(`<lb-thing></lb-thing>`, defs({ "lb-thing": `<label title="a {{label}} b"></label>` }));
-        assert.match(html, /title="a \{\{label\}\} b"/);
-    });
-    it("refuses a parameter for a partial placeholder", () => {
-        // The consequence of the rule above, and the reason it is safe: a name
-        // that is not a placeholder is a name the definition never declared, so
-        // supplying it is the same error as supplying a name that is not there
-        // at all. The author is told rather than shipped literal braces.
-        assert.throws(() => expand(`<lb-thing exp-label="Name"></lb-thing>`, defs({ "lb-thing": `<label title="a {{label}} b"></label>` })), /has no \{\{label\}\}/);
-    });
-    it("keeps the exp- attributes on the expanded tag", () => {
-        // What ships shows what was asked for beside what it produced.
-        const html = expand(`<lb-thing exp-label="Name"></lb-thing>`, defs({ "lb-thing": `<label>{{label}}</label>` }));
-        assert.match(html, /<lb-thing exp-label="Name">/);
-    });
-    it("cannot inject markup, by construction", () => {
-        // Substitution goes through setAttribute and node values, never through a
-        // string. This test exists to fail if anyone reaches for concatenation.
-        //
-        // The assertion reparses rather than matching the serialization, because
-        // the serialization is not the claim. An expanded tag keeps the exp-
-        // attributes it was given, and `<` in an attribute value is legal HTML
-        // that no serializer has to escape — so the output does contain the
-        // characters. What must not exist is an element.
-        const html = expand(`<lb-thing exp-label="<img src=x onerror=alert(1)>" exp-name="&quot; onclick=&quot;alert(1)"></lb-thing>`, defs({
-            "lb-thing": `<label>{{label}}<input name="{{name}}" /></label>`,
-        }));
-        const tree = parseHtml(html);
-        assert.equal(tree.querySelectorAll("img").length, 0);
-        assert.equal(tree.querySelector("label").textContent, "<img src=x onerror=alert(1)>");
-        // The second value closes an attribute and opens an event handler, if it
-        // is ever concatenated. Through setAttribute it is one attribute's value.
-        const input = tree.querySelector("input");
-        assert.deepEqual([...input.attributes].map((a) => a.name), ["name"]);
-        assert.equal(input.getAttribute("name"), `" onclick="alert(1)`);
-    });
-});
-// --- Slots and destinations ---------------------------------------------
-describe("placement", () => {
-    it("puts authored content in the slot and removes the marker", () => {
-        const html = expand(`<lb-list><p>hello</p></lb-list>`, defs({ "lb-list": `<div lb-slot></div>` }));
-        assert.match(html, /<div><p>hello<\/p><\/div>/);
-        assert.doesNotMatch(html, /lb-slot/);
-    });
-    it("unwraps a named template into its destination as real markup", () => {
-        // The wrapper existed only to survive the parser. What ships is a real
-        // <tr> in a real <thead>, visible in view-source like everything else.
-        const html = expand(`<lb-table>` +
-            `<template lb-template="head"><tr><th>Name</th></tr></template>` +
-            `<template lb-key="id"><tr><td lb-cell="name"></td></tr></template>` +
-            `</lb-table>`, defs({
-            "lb-table": `<table><thead lb-template="head"></thead><tbody lb-slot></tbody></table>`,
-        }));
-        assert.match(html, /<thead><tr><th>Name<\/th><\/tr><\/thead>/);
-        assert.match(html, /<tbody><template lb-key="id">/);
-        assert.doesNotMatch(html, /lb-template/);
-    });
-    it("does not count whitespace as content", () => {
-        // An author who writes only named templates still leaves the newlines
-        // between them, and those are the file's formatting.
-        const html = expand(`<lb-thing>\n  \n</lb-thing>`, defs({ "lb-thing": `<div></div>` }));
-        assert.match(html, /<lb-thing><div><\/div><\/lb-thing>/);
-    });
-    it("expands a widget used inside a definition", () => {
-        const html = expand(`<lb-outer></lb-outer>`, defs({
-            "lb-outer": `<div><lb-inner exp-label="deep"></lb-inner></div>`,
-            "lb-inner": `<span>{{label}}</span>`,
-        }));
-        assert.match(html, /<span>deep<\/span>/);
-    });
-    it("expands a widget written inside a page's row template", () => {
-        // Template content is markup in a file like any other, and it is inert,
-        // so a row template ships already expanded.
-        const html = expand(`<lb-list><template lb-key="id"><lb-inner exp-label="row"></lb-inner></template></lb-list>`, defs({
-            "lb-list": `<div lb-slot></div>`,
-            "lb-inner": `<span>{{label}}</span>`,
-        }));
-        assert.match(html, /<span>row<\/span>/);
-    });
-    it("expands a tag outside the lb- namespace when it has a definition", () => {
-        // An application's widget can use its own prefix — see docs/tutorials/000-getting-started.md.
-        // The definition must still apply; discovering it is not enough.
-        const html = expand(`<app-nav exp-label="Site"></app-nav>`, defs({ "app-nav": `<nav aria-label="{{label}}" lb-slot></nav>` }));
-        assert.match(html, /<nav aria-label="Site"><\/nav>/);
-    });
-    it("leaves a tag outside the lb- namespace alone when it has no definition", () => {
-        // A plain custom element, registered by script alone — see build/elements.ts.
-        const html = expand(`<app-box>hi</app-box>`, defs({}));
-        assert.match(html, /<app-box>hi<\/app-box>/);
-    });
-    it("leaves a tag with no definition alone, whatever its name", () => {
-        // No name is special, the hub's own tag included. A tag that has neither
-        // a definition nor a script is refused once, in build/elements.ts.
-        const html = expand(`<lb-nope></lb-nope><lb-hub></lb-hub>`, defs({}));
-        assert.match(html, /<lb-nope><\/lb-nope><lb-hub><\/lb-hub>/);
-    });
-});
-// --- Loading -------------------------------------------------------------
-describe("loadDefinitions", () => {
-    it("keys a definition by the tag its filename names", async () => {
-        const loaded = await loadDefinitions([`${FIXTURES}/base`]);
-        assert.deepEqual(Object.keys(loaded), ["LB-THING"]);
-    });
-    it("lets a later directory override a built-in", async () => {
-        const loaded = await loadDefinitions([
-            `${FIXTURES}/base`,
-            `${FIXTURES}/override`,
-        ]);
-        assert.match(loaded["LB-THING"], /application/);
-    });
-    it("skips a directory that is not there", async () => {
-        const loaded = await loadDefinitions([
-            `${FIXTURES}/nothing-here`,
-            `${FIXTURES}/base`,
-        ]);
-        assert.deepEqual(Object.keys(loaded), ["LB-THING"]);
-    });
-});

package/dist/tests/fixtures/elements/collision/imports.d.ts

@@ -1,3 +0,0 @@
-declare const _default: string[];
-export default _default;
-//# sourceMappingURL=imports.d.ts.map

package/dist/tests/fixtures/elements/collision/imports.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"imports.d.ts","sourceRoot":"","sources":["../../../../../tests/fixtures/elements/collision/imports.ts"],"names":[],"mappings":";AAAA,wBAAgC"}

package/dist/tests/fixtures/elements/collision/imports.js

@@ -1 +0,0 @@
-export default ["@acme/widget"];

package/dist/tests/fixtures/elements/collision/widgets/acme-widget.browser.d.ts

@@ -1,2 +0,0 @@
-export {};
-//# sourceMappingURL=acme-widget.browser.d.ts.map

package/dist/tests/fixtures/elements/collision/widgets/acme-widget.browser.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"acme-widget.browser.d.ts","sourceRoot":"","sources":["../../../../../../tests/fixtures/elements/collision/widgets/acme-widget.browser.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC"}

package/dist/tests/fixtures/elements/collision/widgets/acme-widget.browser.js

@@ -1 +0,0 @@
-export {};

package/dist/tests/fixtures/elements/local/widgets/app-box.browser.d.ts

@@ -1,2 +0,0 @@
-export {};
-//# sourceMappingURL=app-box.browser.d.ts.map

package/dist/tests/fixtures/elements/local/widgets/app-box.browser.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"app-box.browser.d.ts","sourceRoot":"","sources":["../../../../../../tests/fixtures/elements/local/widgets/app-box.browser.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,CAAC"}

package/dist/tests/fixtures/elements/local/widgets/app-box.browser.js

@@ -1 +0,0 @@
-export {};

package/dist/tests/fixtures/elements/manifest/imports.d.ts

@@ -1,3 +0,0 @@
-declare const _default: string[];
-export default _default;
-//# sourceMappingURL=imports.d.ts.map

package/dist/tests/fixtures/elements/manifest/imports.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"imports.d.ts","sourceRoot":"","sources":["../../../../../tests/fixtures/elements/manifest/imports.ts"],"names":[],"mappings":";AAAA,wBAAgC"}

package/dist/tests/fixtures/elements/manifest/imports.js

@@ -1 +0,0 @@
-export default ["@acme/widget"];

package/dist/tests/fixtures/elements/manifest-bad-entry/imports.d.ts

@@ -1,3 +0,0 @@
-declare const _default: (string | number)[];
-export default _default;
-//# sourceMappingURL=imports.d.ts.map

package/dist/tests/fixtures/elements/manifest-bad-entry/imports.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"imports.d.ts","sourceRoot":"","sources":["../../../../../tests/fixtures/elements/manifest-bad-entry/imports.ts"],"names":[],"mappings":";AAAA,wBAAoC"}

package/dist/tests/fixtures/elements/manifest-bad-entry/imports.js

@@ -1 +0,0 @@
-export default ["@acme/widget", 42];

package/dist/tests/fixtures/elements/manifest-not-array/imports.d.ts

@@ -1,5 +0,0 @@
-declare const _default: {
-    "acme-widget": string;
-};
-export default _default;
-//# sourceMappingURL=imports.d.ts.map

package/dist/tests/fixtures/elements/manifest-not-array/imports.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"imports.d.ts","sourceRoot":"","sources":["../../../../../tests/fixtures/elements/manifest-not-array/imports.ts"],"names":[],"mappings":";;;AAAA,wBAAiD"}

package/dist/tests/fixtures/elements/manifest-not-array/imports.js

@@ -1 +0,0 @@
-export default { "acme-widget": "@acme/widget" };

package/dist/tests/fixtures/elements/pkg/acme-widget.browser.d.ts

@@ -1,2 +0,0 @@
-export {};
-//# sourceMappingURL=acme-widget.browser.d.ts.map

package/dist/tests/fixtures/elements/pkg/acme-widget.browser.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"acme-widget.browser.d.ts","sourceRoot":"","sources":["../../../../../tests/fixtures/elements/pkg/acme-widget.browser.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC"}

package/dist/tests/fixtures/elements/pkg/acme-widget.browser.js

@@ -1 +0,0 @@
-export {};

package/dist/tests/fixtures/elements/unmarked/widgets/app-box.d.ts

@@ -1,6 +0,0 @@
-/**
- * A widget script that forgot to say `.browser` — the fixture behind the
- * error that names the file instead of reporting an absence.
- */
-export {};
-//# sourceMappingURL=app-box.d.ts.map

package/dist/tests/fixtures/elements/unmarked/widgets/app-box.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"app-box.d.ts","sourceRoot":"","sources":["../../../../../../tests/fixtures/elements/unmarked/widgets/app-box.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,EAAE,CAAC"}

package/dist/tests/fixtures/elements/unmarked/widgets/app-box.js

@@ -1 +0,0 @@
-export {};

package/dist/tests/helpers/console.d.ts

@@ -1,20 +0,0 @@
-/**
- * The console is an interface — see docs/testing.md.
- *
- * Loadbare App reports what it survives through `console.warn` and `console.error`:
- * a page that does not exist, a query with no scope, a list widget with no
- * template. The behavior under test in those cases is that Loadbare App reported and
- * carried on, so the report is as much the assertion as the return value is.
- *
- * This is the seam until those calls go through one `report()` in `core/`.
- */
-type Line = string;
-export interface Captured<T> {
-    result: T;
-    warn: Line[];
-    error: Line[];
-}
-/** Run something with the console collected rather than printed. */
-export declare function captured<T>(run: () => T | Promise<T>): Promise<Captured<T>>;
-export {};
-//# sourceMappingURL=console.d.ts.map

package/dist/tests/helpers/console.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"console.d.ts","sourceRoot":"","sources":["../../../tests/helpers/console.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,KAAK,IAAI,GAAG,MAAM,CAAC;AAEnB,MAAM,WAAW,QAAQ,CAAC,CAAC;IACzB,MAAM,EAAE,CAAC,CAAC;IACV,IAAI,EAAE,IAAI,EAAE,CAAC;IACb,KAAK,EAAE,IAAI,EAAE,CAAC;CACf;AAED,oEAAoE;AACpE,wBAAsB,QAAQ,CAAC,CAAC,EAC9B,GAAG,EAAE,MAAM,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,GACxB,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAgBtB"}

package/dist/tests/helpers/console.js

@@ -1,28 +0,0 @@
-/**
- * The console is an interface — see docs/testing.md.
- *
- * Loadbare App reports what it survives through `console.warn` and `console.error`:
- * a page that does not exist, a query with no scope, a list widget with no
- * template. The behavior under test in those cases is that Loadbare App reported and
- * carried on, so the report is as much the assertion as the return value is.
- *
- * This is the seam until those calls go through one `report()` in `core/`.
- */
-/** Run something with the console collected rather than printed. */
-export async function captured(run) {
-    const warn = [];
-    const error = [];
-    const realWarn = console.warn;
-    const realError = console.error;
-    // Arguments are joined the way the console would show them, so a test can
-    // match one string against the message an author would read.
-    console.warn = (...args) => void warn.push(args.join(" "));
-    console.error = (...args) => void error.push(args.join(" "));
-    try {
-        return { result: await run(), warn, error };
-    }
-    finally {
-        console.warn = realWarn;
-        console.error = realError;
-    }
-}

package/dist/tests/helpers/dom.d.ts

@@ -1,18 +0,0 @@
-/**
- * A document for tier 3 — see docs/testing.md.
- *
- * The landing code touches nothing global: it is handed a root and calls
- * `matches`, `querySelectorAll`, `cloneNode` and `setAttribute` on it. So a
- * test needs a parsed tree and nothing else — no globals installed, no
- * custom elements registered, no window on the loose between test files.
- *
- * Markup is parsed as the body of a document rather than into a detached
- * `<div>`, because the parser's content models are half of what this code
- * exists to work around: a `<tr>` assigned to a div's innerHTML is discarded,
- * and a test that lost its rows would be testing the parser.
- */
-/** Parse markup and hand back the body holding it. */
-export declare function body(html: string): HTMLElement;
-/** Parse markup and hand back its first element. */
-export declare function one(html: string): Element;
-//# sourceMappingURL=dom.d.ts.map

package/dist/tests/helpers/dom.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"dom.d.ts","sourceRoot":"","sources":["../../../tests/helpers/dom.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAIH,sDAAsD;AACtD,wBAAgB,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,WAAW,CAE9C;AAED,oDAAoD;AACpD,wBAAgB,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAEzC"}

package/dist/tests/helpers/dom.js

@@ -1,22 +0,0 @@
-/**
- * A document for tier 3 — see docs/testing.md.
- *
- * The landing code touches nothing global: it is handed a root and calls
- * `matches`, `querySelectorAll`, `cloneNode` and `setAttribute` on it. So a
- * test needs a parsed tree and nothing else — no globals installed, no
- * custom elements registered, no window on the loose between test files.
- *
- * Markup is parsed as the body of a document rather than into a detached
- * `<div>`, because the parser's content models are half of what this code
- * exists to work around: a `<tr>` assigned to a div's innerHTML is discarded,
- * and a test that lost its rows would be testing the parser.
- */
-import { JSDOM } from "jsdom";
-/** Parse markup and hand back the body holding it. */
-export function body(html) {
-    return new JSDOM(`<!doctype html><body>${html}</body>`).window.document.body;
-}
-/** Parse markup and hand back its first element. */
-export function one(html) {
-    return body(html).firstElementChild;
-}

package/dist/tests/helpers/hub.d.ts

@@ -1,73 +0,0 @@
-/**
- * A window for tier 4 — see docs/testing.md.
- *
- * Tier 3 needed no globals: the landing code is handed a root and calls
- * methods on it. The hub is the opposite. It extends `HTMLElement`, it
- * registers itself with `customElements` when its module loads, and it
- * reaches `document`, `history` and `location` on its own. So the window has
- * to exist before the module does, which is why the hub is imported
- * dynamically, after `installWindow()` has run:
- *
- *     installWindow();
- *     await import("../hub/lb-hub.browser");
- *
- * One window per test file, since registration is global and permanent.
- *
- * Two things the hub reaches for do not exist in jsdom 25 and are supplied
- * here. `fetch` is absent, and a scripted one is what a test wants in any
- * case. `HTMLDialogElement.showModal` is absent, so it is recorded rather
- * than performed. Everything else — `history.pushState`, `popstate`, event
- * delegation, form controls — is jsdom's own.
- */
-import type { HubData, HubRequest } from "../../core/lb-types";
-/** One round trip the hub asked for. */
-export interface Sent {
-    page: string;
-    request: HubRequest | Record<string, never>;
-}
-export interface Server {
-    /** Every round trip, in order. */
-    sent: Sent[];
-    /** What the next round trip answers with. Replace it per test. */
-    answer: HubData;
-    /** Set to fail the next round trip instead of answering it. */
-    fail?: string;
-}
-/** The scripted server every test in a file shares. */
-export declare const server: Server;
-export declare function installWindow(): void;
-/**
- * Put a built document in place and hand back the hub in it.
- *
- * `pages` are the page hosts the builder would have written, keyed by stub —
- * see build/assemble.ts. `chrome` is what goes inside `<lb-hub>` beside
- * `<main>`. `path` is where the browser is when the hub connects, and it is
- * reset for every mount so no test inherits where the last one navigated to.
- *
- * Connecting the hub is what runs `connectedCallback`, and that navigates,
- * so the caller awaits the first round trip before asserting.
- */
-export declare function mountHub(chrome: string, pages?: Record<string, string>, path?: string): Promise<Element>;
-/**
- * Let the hub's pending round trip finish.
- *
- * `navigate` is async and nothing hands a test its promise, so a test waits
- * on the microtask queue the way the page does. Two turns: one for the fetch
- * and one for reading its body.
- */
-export declare function settle(): Promise<void>;
-/**
- * Step back and let the hub answer.
- *
- * `history.back()` is queued rather than synchronous, so a test waits for
- * the `popstate` the hub is listening for and then for the round trip it
- * starts.
- */
-export declare function back(): Promise<void>;
-/** Fire the event a person's click fires. */
-export declare function click(el: Element): Promise<void>;
-/** Fire the event a form's submit fires. */
-export declare function submit(form: Element): Promise<void>;
-/** Dispatch a request the way a widget does. */
-export declare function send(el: Element, detail: HubRequest | undefined): Promise<void>;
-//# sourceMappingURL=hub.d.ts.map

package/dist/tests/helpers/hub.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"hub.d.ts","sourceRoot":"","sources":["../../../tests/helpers/hub.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAGH,OAAO,KAAK,EAAE,OAAO,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAyB/D,wCAAwC;AACxC,MAAM,WAAW,IAAI;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,UAAU,GAAG,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;CAC7C;AAED,MAAM,WAAW,MAAM;IACrB,kCAAkC;IAClC,IAAI,EAAE,IAAI,EAAE,CAAC;IACb,kEAAkE;IAClE,MAAM,EAAE,OAAO,CAAC;IAChB,+DAA+D;IAC/D,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,uDAAuD;AACvD,eAAO,MAAM,MAAM,EAAE,MAAiC,CAAC;AAEvD,wBAAgB,aAAa,IAAI,IAAI,CAgDpC;AAED;;;;;;;;;;GAUG;AACH,wBAAsB,QAAQ,CAC5B,MAAM,EAAE,MAAM,EACd,KAAK,GAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAiB,EAC7C,IAAI,SAAM,GACT,OAAO,CAAC,OAAO,CAAC,CAQlB;AAED;;;;;;GAMG;AACH,wBAAsB,MAAM,IAAI,OAAO,CAAC,IAAI,CAAC,CAG5C;AAED;;;;;;GAMG;AACH,wBAAsB,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,CAO1C;AAED,6CAA6C;AAC7C,wBAAsB,KAAK,CAAC,EAAE,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAKtD;AAED,4CAA4C;AAC5C,wBAAsB,MAAM,CAAC,IAAI,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAGzD;AAED,gDAAgD;AAChD,wBAAsB,IAAI,CACxB,EAAE,EAAE,OAAO,EACX,MAAM,EAAE,UAAU,GAAG,SAAS,GAC7B,OAAO,CAAC,IAAI,CAAC,CAGf"}