@lo-tek/interfaces 0.0.0-stage → 0.37.0

package/dist/components/standalone/toast/toast.js

@@ -0,0 +1,42 @@
+import { attributes } from "../../css/shared.js";
+import { DEFAULT_TEXTS } from "../../default-texts.js";
+/**
+ * The class on the host, that is, the region the messages are in.
+ *
+ * Until 0.28.0 this was the class on each message, and the region was styled
+ * by its element name. Registered under another name, with
+ * `defineLtToast("my-toast")`, it then lost its position.
+ */
+export const TOAST_CLASS = "lt-toast";
+export const TOAST_MESSAGE_CLASS = "lt-toast__message";
+export const TOAST_CLOSE_CLASS = "lt-toast__close";
+/**
+ * The attributes for the toast region.
+ *
+ * The region is `role="status"` and not `role="alert"`. A message that comes
+ * because something went well should not interrupt what the screen reader is
+ * doing.
+ *
+ * `data-ignore-morph` is not optional. `<lt-toast>` creates and removes its
+ * message elements inside the region, and without the attribute the Datastar
+ * morph tears them away at the next patch, because the server's version of
+ * the region is empty. The attribute must be in the HTML the server sends:
+ * the component cannot set it on itself, since the morph reads it from the
+ * server's node.
+ */
+export const toast = ({ label = DEFAULT_TEXTS.toastRegion, closeLabel, } = {}) => ({
+    host: attributes({
+        class: TOAST_CLASS,
+        role: "status",
+        "aria-live": "polite",
+        // `status` is atomic by default, and then the whole stack is announced
+        // again for every message that is added.
+        "aria-atomic": "false",
+        "aria-label": label,
+        "close-label": closeLabel,
+        "data-ignore-morph": "",
+    }),
+    message: attributes({ class: TOAST_MESSAGE_CLASS }),
+    close: attributes({ class: TOAST_CLOSE_CLASS }),
+});
+//# sourceMappingURL=toast.js.map

package/dist/components/standalone/toast/toast.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"toast.js","sourceRoot":"","sources":["../../../../src/components/standalone/toast/toast.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAA;AAChD,OAAO,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAA;AAEtD;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,WAAW,GAAG,UAAmB,CAAA;AAC9C,MAAM,CAAC,MAAM,mBAAmB,GAAG,mBAA4B,CAAA;AAC/D,MAAM,CAAC,MAAM,iBAAiB,GAAG,iBAA0B,CAAA;AA0B3D;;;;;;;;;;;;;GAaG;AACH,MAAM,CAAC,MAAM,KAAK,GAAG,CAAC,EACpB,KAAK,GAAG,aAAa,CAAC,WAAW,EACjC,UAAU,MACM,EAAE,EAAmB,EAAE,CAAC,CAAC;IACzC,IAAI,EAAE,UAAU,CAAC;QACf,KAAK,EAAE,WAAW;QAClB,IAAI,EAAE,QAAiB;QACvB,WAAW,EAAE,QAAiB;QAC9B,uEAAuE;QACvE,yCAAyC;QACzC,aAAa,EAAE,OAAgB;QAC/B,YAAY,EAAE,KAAK;QACnB,aAAa,EAAE,UAAU;QACzB,mBAAmB,EAAE,EAAW;KACjC,CAAC;IACF,OAAO,EAAE,UAAU,CAAC,EAAE,KAAK,EAAE,mBAAmB,EAAE,CAAC;IACnD,KAAK,EAAE,UAAU,CAAC,EAAE,KAAK,EAAE,iBAAiB,EAAE,CAAC;CAChD,CAAC,CAAA"}

package/dist/diagnostics/core.d.ts

@@ -0,0 +1,137 @@
+/**
+ * The core: LO-TEK's check and theme generator, written in Rust and built to
+ * a single WebAssembly module.
+ *
+ * The same module runs here, in VS Code, on the JVM (Chicory) and in
+ * IntelliJ, and gives the same answer everywhere. The module has no imports,
+ * so it needs no glue: the loader writes the text in as UTF-8 and reads the
+ * answer out as JSON, as every host language does.
+ *
+ * The core carries no data. The vocabulary and the colour contract are given
+ * to it with `loadManifest` and `loadContract`, from the files in the package.
+ *
+ * `diagnoseMarkup` and `diagnosePage` in `index.ts` load the module and the
+ * files from the package themselves. `loadCore` is for anyone who has the
+ * module some other way, such as an extension that bundles it, or a browser:
+ *
+ * ```ts
+ * const core = loadCore(await WebAssembly.compileStreaming(fetch(url)))
+ * core.loadManifest(await (await fetch(manifestUrl)).text())
+ * core.diagnosePage(html)
+ * ```
+ *
+ * Synchronous, because Node, Bun and VS Code allow it. In the browser the
+ * module must be compiled with `WebAssembly.compile` first, and the compiled
+ * module passed here.
+ */
+export type Severity = "error" | "warning";
+/** One edit in a fix: replace the text from `start` to `end` with `text`. */
+export type Edit = {
+    start: number;
+    end: number;
+    text: string;
+};
+/**
+ * A fix the editor can offer: one or more edits that belong together, such
+ * as `id` on the field and `for` on the label. They are in text order and do
+ * not overlap; apply them from the end, so the positions hold. `preferred`
+ * marks the safe one, such as `onlinetext` to `online-text`: the same
+ * letters, only written differently. A suggestion at a distance is a
+ * suggestion.
+ */
+export type Fix = {
+    title: string;
+    edits: Edit[];
+    preferred?: boolean;
+};
+export type Finding = {
+    /** Where the finding starts, as an index into the text (UTF-16, like a `string`). */
+    start: number;
+    end: number;
+    /** The line the finding starts on, from 1. */
+    line: number;
+    /** The column the finding starts at, from 1, in UTF-16 units. */
+    column: number;
+    message: string;
+    severity: Severity;
+    /** The name of the rule, such as `unknown-class`. That is what `lotek-ignore-next` takes. */
+    rule: string;
+    /** The component page, as a link in the message. */
+    link: string;
+    fix?: Fix;
+};
+export type CoreVersion = {
+    /** The version of the core. */
+    core: string;
+    /** The version of `@lo-tek/interfaces` the manifest was written from, or `null` without a manifest. */
+    manifest: string | null;
+    /** The manifest format the core understands. */
+    schemaVersion: number;
+};
+/** A promise in the colour contract that does not hold. */
+export type Violation = {
+    family: string;
+    promise: string;
+    ratio: number;
+    required: number;
+};
+/** The theme `buildTheme` returns: the tokens per appearance, the promises that break, and the CSS. */
+export type CoreTheme = {
+    light: Record<string, string>;
+    dark: Record<string, string>;
+    /** Promises that do not hold. Empty when the theme is sound. */
+    violations: Violation[];
+    css: string;
+};
+/** What `inspectTheme` found in a theme the consumer has written by hand. */
+export type CoreThemeReport = {
+    problems: {
+        selector: string;
+        message: string;
+    }[];
+    /** Blocks that were actually read. */
+    blocks: number;
+    /** Values the consumer wrote, and that were understood. */
+    declarations: number;
+    /** Promises that were actually checked. */
+    promises: number;
+};
+/** What `inspectStyles` found in a stylesheet. */
+export type CoreStyles = {
+    /** Every class that appears in a selector. */
+    classes: string[];
+    /** Every class with an attribute, and the value when the selector requires one. */
+    attributes: {
+        class: string;
+        attribute: string;
+        value?: string;
+    }[];
+    /** The URLs in `@import`. */
+    imports: string[];
+};
+export type Core = {
+    /** Checks a template or a fragment. Throws without a manifest. */
+    diagnoseMarkup(html: string): Finding[];
+    /** Checks a whole page, including the wiring. Throws without a manifest. */
+    diagnosePage(html: string): Finding[];
+    /** Gives the core the vocabulary. Throws with the core's explanation if it cannot be read. */
+    loadManifest(json: string): void;
+    /** Gives the core the colour contract. Throws with the core's explanation if it cannot be read. */
+    loadContract(json: string): void;
+    version(): CoreVersion;
+    /** Builds a theme from the recipe. Throws without a colour contract, or when the recipe cannot be used. */
+    buildTheme(recipe: unknown): CoreTheme;
+    /** Checks every promise in a theme written as CSS. Throws without a colour contract. */
+    inspectTheme(css: string): CoreThemeReport;
+    /** The classes and attribute values a stylesheet styles, read with the core's CSS reader. */
+    inspectStyles(css: string): CoreStyles;
+    /**
+     * The check with the stylesheets as well: a class none of them styles, and
+     * a value without a rule. `page` checks as `diagnosePage`, otherwise as
+     * `diagnoseMarkup`. Throws without a manifest.
+     */
+    diagnoseStyled(html: string, css: string[], page: boolean): Finding[];
+};
+/** Loads the core from the module's bytes or an already compiled module. */
+export declare function loadCore(source: BufferSource | WebAssembly.Module): Core;
+//# sourceMappingURL=core.d.ts.map

package/dist/diagnostics/core.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"core.d.ts","sourceRoot":"","sources":["../../src/diagnostics/core.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AAEH,MAAM,MAAM,QAAQ,GAAG,OAAO,GAAG,SAAS,CAAA;AAE1C,6EAA6E;AAC7E,MAAM,MAAM,IAAI,GAAG;IACjB,KAAK,EAAE,MAAM,CAAA;IACb,GAAG,EAAE,MAAM,CAAA;IACX,IAAI,EAAE,MAAM,CAAA;CACb,CAAA;AAED;;;;;;;GAOG;AACH,MAAM,MAAM,GAAG,GAAG;IAChB,KAAK,EAAE,MAAM,CAAA;IACb,KAAK,EAAE,IAAI,EAAE,CAAA;IACb,SAAS,CAAC,EAAE,OAAO,CAAA;CACpB,CAAA;AAED,MAAM,MAAM,OAAO,GAAG;IACpB,qFAAqF;IACrF,KAAK,EAAE,MAAM,CAAA;IACb,GAAG,EAAE,MAAM,CAAA;IACX,8CAA8C;IAC9C,IAAI,EAAE,MAAM,CAAA;IACZ,iEAAiE;IACjE,MAAM,EAAE,MAAM,CAAA;IACd,OAAO,EAAE,MAAM,CAAA;IACf,QAAQ,EAAE,QAAQ,CAAA;IAClB,6FAA6F;IAC7F,IAAI,EAAE,MAAM,CAAA;IACZ,oDAAoD;IACpD,IAAI,EAAE,MAAM,CAAA;IACZ,GAAG,CAAC,EAAE,GAAG,CAAA;CACV,CAAA;AAED,MAAM,MAAM,WAAW,GAAG;IACxB,+BAA+B;IAC/B,IAAI,EAAE,MAAM,CAAA;IACZ,uGAAuG;IACvG,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAA;IACvB,gDAAgD;IAChD,aAAa,EAAE,MAAM,CAAA;CACtB,CAAA;AAED,2DAA2D;AAC3D,MAAM,MAAM,SAAS,GAAG;IACtB,MAAM,EAAE,MAAM,CAAA;IACd,OAAO,EAAE,MAAM,CAAA;IACf,KAAK,EAAE,MAAM,CAAA;IACb,QAAQ,EAAE,MAAM,CAAA;CACjB,CAAA;AAED,uGAAuG;AACvG,MAAM,MAAM,SAAS,GAAG;IACtB,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IAC7B,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IAC5B,gEAAgE;IAChE,UAAU,EAAE,SAAS,EAAE,CAAA;IACvB,GAAG,EAAE,MAAM,CAAA;CACZ,CAAA;AAED,6EAA6E;AAC7E,MAAM,MAAM,eAAe,GAAG;IAC5B,QAAQ,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,EAAE,CAAA;IACjD,sCAAsC;IACtC,MAAM,EAAE,MAAM,CAAA;IACd,2DAA2D;IAC3D,YAAY,EAAE,MAAM,CAAA;IACpB,2CAA2C;IAC3C,QAAQ,EAAE,MAAM,CAAA;CACjB,CAAA;AAED,kDAAkD;AAClD,MAAM,MAAM,UAAU,GAAG;IACvB,8CAA8C;IAC9C,OAAO,EAAE,MAAM,EAAE,CAAA;IACjB,mFAAmF;IACnF,UAAU,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,EAAE,CAAA;IAClE,6BAA6B;IAC7B,OAAO,EAAE,MAAM,EAAE,CAAA;CAClB,CAAA;AAED,MAAM,MAAM,IAAI,GAAG;IACjB,kEAAkE;IAClE,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,EAAE,CAAA;IACvC,4EAA4E;IAC5E,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,EAAE,CAAA;IACrC,8FAA8F;IAC9F,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAA;IAChC,mGAAmG;IACnG,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAA;IAChC,OAAO,IAAI,WAAW,CAAA;IACtB,2GAA2G;IAC3G,UAAU,CAAC,MAAM,EAAE,OAAO,GAAG,SAAS,CAAA;IACtC,wFAAwF;IACxF,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,eAAe,CAAA;IAC1C,6FAA6F;IAC7F,aAAa,CAAC,GAAG,EAAE,MAAM,GAAG,UAAU,CAAA;IACtC;;;;OAIG;IACH,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,EAAE,IAAI,EAAE,OAAO,GAAG,OAAO,EAAE,CAAA;CACtE,CAAA;AAkBD,4EAA4E;AAC5E,wBAAgB,QAAQ,CAAC,MAAM,EAAE,YAAY,GAAG,WAAW,CAAC,MAAM,GAAG,IAAI,CAsDxE"}

package/dist/diagnostics/core.js

@@ -0,0 +1,72 @@
+/**
+ * The core: LO-TEK's check and theme generator, written in Rust and built to
+ * a single WebAssembly module.
+ *
+ * The same module runs here, in VS Code, on the JVM (Chicory) and in
+ * IntelliJ, and gives the same answer everywhere. The module has no imports,
+ * so it needs no glue: the loader writes the text in as UTF-8 and reads the
+ * answer out as JSON, as every host language does.
+ *
+ * The core carries no data. The vocabulary and the colour contract are given
+ * to it with `loadManifest` and `loadContract`, from the files in the package.
+ *
+ * `diagnoseMarkup` and `diagnosePage` in `index.ts` load the module and the
+ * files from the package themselves. `loadCore` is for anyone who has the
+ * module some other way, such as an extension that bundles it, or a browser:
+ *
+ * ```ts
+ * const core = loadCore(await WebAssembly.compileStreaming(fetch(url)))
+ * core.loadManifest(await (await fetch(manifestUrl)).text())
+ * core.diagnosePage(html)
+ * ```
+ *
+ * Synchronous, because Node, Bun and VS Code allow it. In the browser the
+ * module must be compiled with `WebAssembly.compile` first, and the compiled
+ * module passed here.
+ */
+/** Loads the core from the module's bytes or an already compiled module. */
+export function loadCore(source) {
+    const module = source instanceof WebAssembly.Module
+        ? source
+        : new WebAssembly.Module(source);
+    const e = new WebAssembly.Instance(module, {}).exports;
+    const encoder = new TextEncoder();
+    const decoder = new TextDecoder();
+    /** Writes the text into the module's memory and returns the pointer and length. */
+    const write = (text) => {
+        const bytes = encoder.encode(text);
+        const pointer = e.alloc(bytes.length);
+        // The memory can grow on every call, so the view is created after `alloc`.
+        new Uint8Array(e.memory.buffer, pointer, bytes.length).set(bytes);
+        return [pointer, bytes.length];
+    };
+    const read = () => JSON.parse(decoder.decode(new Uint8Array(e.memory.buffer, e.result_ptr(), e.result_len())));
+    /** The answer from a call that can be rejected: the value, or the core's explanation as an error. */
+    const answer = (status) => {
+        if (status !== 0)
+            throw new Error(read().error);
+        return read();
+    };
+    return {
+        diagnoseMarkup: (html) => answer(e.diagnose_markup_raw(...write(html))),
+        diagnosePage: (html) => answer(e.diagnose_page_raw(...write(html))),
+        loadManifest: (json) => {
+            answer(e.load_manifest_raw(...write(json)));
+        },
+        loadContract: (json) => {
+            answer(e.load_contract_raw(...write(json)));
+        },
+        version: () => {
+            e.version_raw();
+            return read();
+        },
+        buildTheme: (recipe) => answer(e.build_theme_raw(...write(JSON.stringify(recipe)))),
+        inspectTheme: (css) => answer(e.inspect_theme_raw(...write(css))),
+        inspectStyles: (css) => {
+            e.inspect_styles_raw(...write(css));
+            return read();
+        },
+        diagnoseStyled: (html, css, page) => answer(e.diagnose_styled_raw(...write(JSON.stringify({ html, css, page })))),
+    };
+}
+//# sourceMappingURL=core.js.map

package/dist/diagnostics/core.js.map

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

package/dist/diagnostics/default-core.d.ts

@@ -0,0 +1,10 @@
+/**
+ * The core from the package itself, loaded the first time it is needed, with
+ * the package's manifest and colour contract, which sit next to the module.
+ *
+ * Both the check (`@lo-tek/interfaces/diagnostics`) and the theme
+ * (`@lo-tek/interfaces/theme` and `theme-check`) use the same instance.
+ */
+import { type Core } from "./core.js";
+export declare function defaultCore(): Core;
+//# sourceMappingURL=default-core.d.ts.map

package/dist/diagnostics/default-core.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"default-core.d.ts","sourceRoot":"","sources":["../../src/diagnostics/default-core.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,KAAK,IAAI,EAAY,MAAM,WAAW,CAAA;AAoB/C,wBAAgB,WAAW,IAAI,IAAI,CAoDlC"}

package/dist/diagnostics/default-core.js

@@ -0,0 +1,72 @@
+/**
+ * The core from the package itself, loaded the first time it is needed, with
+ * the package's manifest and colour contract, which sit next to the module.
+ *
+ * Both the check (`@lo-tek/interfaces/diagnostics`) and the theme
+ * (`@lo-tek/interfaces/theme` and `theme-check`) use the same instance.
+ */
+import { loadCore } from "./core.js";
+/** The files in the package, seen from both `src/diagnostics/` and `dist/diagnostics/`. */
+const MODULE = new URL("../../core/lotek-core.wasm", import.meta.url);
+const MANIFEST = new URL("../../manifest/manifest.json", import.meta.url);
+const CONTRACT = new URL("../../src/tokens/color-contract.json", import.meta.url);
+let core;
+/*
+ * Loaded the first time it is needed, not when the module is imported:
+ * anyone who only wants the types, or `loadCore`, should not pay for it.
+ *
+ * `node:fs` is fetched with `process.getBuiltinModule` instead of an import,
+ * so the file can be bundled for the browser without the bundler looking
+ * for `fs`.
+ */
+export function defaultCore() {
+    if (core)
+        return core;
+    const fs = globalThis.process?.getBuiltinModule?.("node:fs");
+    if (!fs) {
+        // `getBuiltinModule` arrived in Node 20.16 and 22.3, so Node 21 and 22.0
+        // to 22.2 are excluded even though they are newer than 20.16. `engines`
+        // in package.json says the same. A Node without it is still Node, and
+        // should be told that the version is wrong, with both limits, so Node
+        // 22.1 is not told it is older than 20.16.
+        const node = globalThis.process?.versions?.node;
+        throw new Error(node
+            ? `LO-TEK requires Node 20.16 or later in the 20 series, or Node 22.3 or later, and this is Node ${node}.`
+            : "LO-TEK reads the core from the package, which requires Node, Bun or Deno. In the browser, load lotek-core.wasm yourself, pass it to loadCore, and give the core manifest.json with loadManifest and color-contract.json with loadContract.");
+    }
+    let bytes;
+    try {
+        bytes = fs.readFileSync(MODULE);
+    }
+    catch {
+        throw new Error(`Could not find the core at ${MODULE.pathname}. In the repository it is built with "bun run core" in interfaces/, which requires Rust.`);
+    }
+    // The manifest is only needed by the check, and the colour contract only
+    // by the theme. Each is read the first time a call needs it.
+    const loaded = loadCore(bytes);
+    let manifest = false;
+    let contract = false;
+    const withManifest = () => {
+        if (!manifest)
+            loaded.loadManifest(fs.readFileSync(MANIFEST, "utf8"));
+        manifest = true;
+        return loaded;
+    };
+    const withContract = () => {
+        if (!contract)
+            loaded.loadContract(fs.readFileSync(CONTRACT, "utf8"));
+        contract = true;
+        return loaded;
+    };
+    core = {
+        ...loaded,
+        diagnoseMarkup: (html) => withManifest().diagnoseMarkup(html),
+        diagnosePage: (html) => withManifest().diagnosePage(html),
+        diagnoseStyled: (html, css, page) => withManifest().diagnoseStyled(html, css, page),
+        version: () => withManifest().version(),
+        buildTheme: (recipe) => withContract().buildTheme(recipe),
+        inspectTheme: (css) => withContract().inspectTheme(css),
+    };
+    return core;
+}
+//# sourceMappingURL=default-core.js.map

package/dist/diagnostics/default-core.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"default-core.js","sourceRoot":"","sources":["../../src/diagnostics/default-core.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAa,QAAQ,EAAE,MAAM,WAAW,CAAA;AAE/C,2FAA2F;AAC3F,MAAM,MAAM,GAAG,IAAI,GAAG,CAAC,4BAA4B,EAAE,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAA;AACrE,MAAM,QAAQ,GAAG,IAAI,GAAG,CAAC,8BAA8B,EAAE,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAA;AACzE,MAAM,QAAQ,GAAG,IAAI,GAAG,CACtB,sCAAsC,EACtC,MAAM,CAAC,IAAI,CAAC,GAAG,CAChB,CAAA;AAED,IAAI,IAAsB,CAAA;AAE1B;;;;;;;GAOG;AACH,MAAM,UAAU,WAAW;IACzB,IAAI,IAAI;QAAE,OAAO,IAAI,CAAA;IACrB,MAAM,EAAE,GAAG,UAAU,CAAC,OAAO,EAAE,gBAAgB,EAAE,CAAC,SAAS,CAE9C,CAAA;IACb,IAAI,CAAC,EAAE,EAAE,CAAC;QACR,yEAAyE;QACzE,wEAAwE;QACxE,sEAAsE;QACtE,sEAAsE;QACtE,2CAA2C;QAC3C,MAAM,IAAI,GAAG,UAAU,CAAC,OAAO,EAAE,QAAQ,EAAE,IAAI,CAAA;QAC/C,MAAM,IAAI,KAAK,CACb,IAAI;YACF,CAAC,CAAC,iGAAiG,IAAI,GAAG;YAC1G,CAAC,CAAC,4OAA4O,CACjP,CAAA;IACH,CAAC;IACD,IAAI,KAAiB,CAAA;IACrB,IAAI,CAAC;QACH,KAAK,GAAG,EAAE,CAAC,YAAY,CAAC,MAAM,CAAC,CAAA;IACjC,CAAC;IAAC,MAAM,CAAC;QACP,MAAM,IAAI,KAAK,CACb,8BAA8B,MAAM,CAAC,QAAQ,0FAA0F,CACxI,CAAA;IACH,CAAC;IACD,yEAAyE;IACzE,6DAA6D;IAC7D,MAAM,MAAM,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAA;IAC9B,IAAI,QAAQ,GAAG,KAAK,CAAA;IACpB,IAAI,QAAQ,GAAG,KAAK,CAAA;IACpB,MAAM,YAAY,GAAG,GAAG,EAAE;QACxB,IAAI,CAAC,QAAQ;YAAE,MAAM,CAAC,YAAY,CAAC,EAAE,CAAC,YAAY,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC,CAAA;QACrE,QAAQ,GAAG,IAAI,CAAA;QACf,OAAO,MAAM,CAAA;IACf,CAAC,CAAA;IACD,MAAM,YAAY,GAAG,GAAG,EAAE;QACxB,IAAI,CAAC,QAAQ;YAAE,MAAM,CAAC,YAAY,CAAC,EAAE,CAAC,YAAY,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC,CAAA;QACrE,QAAQ,GAAG,IAAI,CAAA;QACf,OAAO,MAAM,CAAA;IACf,CAAC,CAAA;IACD,IAAI,GAAG;QACL,GAAG,MAAM;QACT,cAAc,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,YAAY,EAAE,CAAC,cAAc,CAAC,IAAI,CAAC;QAC7D,YAAY,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,YAAY,EAAE,CAAC,YAAY,CAAC,IAAI,CAAC;QACzD,cAAc,EAAE,CAAC,IAAI,EAAE,GAAG,EAAE,IAAI,EAAE,EAAE,CAClC,YAAY,EAAE,CAAC,cAAc,CAAC,IAAI,EAAE,GAAG,EAAE,IAAI,CAAC;QAChD,OAAO,EAAE,GAAG,EAAE,CAAC,YAAY,EAAE,CAAC,OAAO,EAAE;QACvC,UAAU,EAAE,CAAC,MAAM,EAAE,EAAE,CAAC,YAAY,EAAE,CAAC,UAAU,CAAC,MAAM,CAAC;QACzD,YAAY,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,YAAY,EAAE,CAAC,YAAY,CAAC,GAAG,CAAC;KACxD,CAAA;IACD,OAAO,IAAI,CAAA;AACb,CAAC"}

package/dist/diagnostics/index.d.ts

@@ -0,0 +1,84 @@
+/**
+ * Checks markup against LO-TEK, outside the browser.
+ *
+ * `diagnoseMarkup(html)` is the same check the editor extensions run while
+ * you type, and that `lotek check` runs on the command line. It is here
+ * because markup produced without JavaScript, in a Go template, a Kotlin
+ * string or a Razor view, has no compiler looking at the attributes. A test
+ * in the app can then run it over the HTML the server actually sends:
+ *
+ * ```ts
+ * import { diagnosePage } from "@lo-tek/interfaces/diagnostics"
+ *
+ * expect(diagnosePage(html)).toEqual([])
+ * ```
+ *
+ * The check is the core, written in Rust and built to WebAssembly (see
+ * `core.ts`). The module ships with the package, and is loaded the first
+ * time one of the functions is called, in Node, Bun and Deno. In the
+ * browser, or where the module is bundled some other way, `loadCore` loads
+ * it.
+ */
+import type { Finding } from "./core.js";
+export type { Manifest } from "../vocabulary/types.js";
+export { type Core, type CoreStyles, type CoreTheme, type CoreThemeReport, type CoreVersion, type Finding, type Fix, loadCore, type Severity, type Violation, } from "./core.js";
+/** Options for the check. */
+export type DiagnoseOptions = {
+    /**
+     * The stylesheets the page loads, as text. With them the check also
+     * reports a class none of them styles, as when the component's stylesheet
+     * is not loaded, and a value without a rule, such as a variant added to a
+     * taken-over component without the CSS getting it.
+     */
+    css?: string[];
+};
+/** Every finding in the text: the vocabulary, for a template or a fragment of a page. */
+export declare function diagnoseMarkup(text: string, options?: DiagnoseOptions): Finding[];
+/**
+ * Every finding on a whole page: what `diagnoseMarkup` finds, and also that
+ * every `for`, `aria-describedby`, `aria-labelledby` and `aria-controls`
+ * points to an id that exists, that no id appears twice, and that every
+ * LO-TEK field and every help text and error text is wired.
+ *
+ * Use it on the HTML the server sends, not on a template: in a template split
+ * into pieces, the id can be in another file.
+ *
+ * ```ts
+ * const html = await (await fetch("http://localhost:8080/form")).text()
+ * expect(diagnosePage(html)).toEqual([])
+ * ```
+ */
+export declare function diagnosePage(text: string, options?: DiagnoseOptions): Finding[];
+/** What `diagnoseRendered` needs from a page: `evaluate`, as in Playwright. */
+export type RenderedPage = {
+    evaluate<T>(script: () => Promise<T>): Promise<T>;
+};
+/**
+ * Reads the rendered page in the browser: the DOM as it stands now, and the
+ * text of every stylesheet, with what they import. A stylesheet from another
+ * origin, such as a CDN, cannot be read through the CSSOM without
+ * `crossorigin`, and is then fetched again with `fetch`.
+ *
+ * The function runs in the browser, and cannot use anything outside itself.
+ */
+export declare const READ_RENDERED_PAGE: () => Promise<{
+    html: string;
+    css: string[];
+}>;
+/**
+ * Checks the page as the browser has rendered it, with the stylesheets it
+ * has loaded: what `diagnosePage` finds, and what the stylesheets do not
+ * style. Markup the web components have added, and a class JavaScript has
+ * set, are included.
+ *
+ * ```ts
+ * import { diagnoseRendered } from "@lo-tek/interfaces/diagnostics"
+ *
+ * await page.goto("http://localhost:8080/form")
+ * expect(await diagnoseRendered(page)).toEqual([])
+ * ```
+ *
+ * `page` is a Playwright page, or anything with `evaluate`.
+ */
+export declare function diagnoseRendered(page: RenderedPage): Promise<Finding[]>;
+//# sourceMappingURL=index.d.ts.map

package/dist/diagnostics/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/diagnostics/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AAExC,YAAY,EAAE,QAAQ,EAAE,MAAM,wBAAwB,CAAA;AAItD,OAAO,EACL,KAAK,IAAI,EACT,KAAK,UAAU,EACf,KAAK,SAAS,EACd,KAAK,eAAe,EACpB,KAAK,WAAW,EAChB,KAAK,OAAO,EACZ,KAAK,GAAG,EACR,QAAQ,EACR,KAAK,QAAQ,EACb,KAAK,SAAS,GACf,MAAM,WAAW,CAAA;AAElB,6BAA6B;AAC7B,MAAM,MAAM,eAAe,GAAG;IAC5B;;;;;OAKG;IACH,GAAG,CAAC,EAAE,MAAM,EAAE,CAAA;CACf,CAAA;AAED,yFAAyF;AACzF,wBAAgB,cAAc,CAC5B,IAAI,EAAE,MAAM,EACZ,OAAO,GAAE,eAAoB,GAC5B,OAAO,EAAE,CAIX;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,YAAY,CAC1B,IAAI,EAAE,MAAM,EACZ,OAAO,GAAE,eAAoB,GAC5B,OAAO,EAAE,CAIX;AAED,+EAA+E;AAC/E,MAAM,MAAM,YAAY,GAAG;IACzB,QAAQ,CAAC,CAAC,EAAE,MAAM,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAAA;CAClD,CAAA;AAED;;;;;;;GAOG;AACH,eAAO,MAAM,kBAAkB,QAAa,OAAO,CAAC;IAClD,IAAI,EAAE,MAAM,CAAA;IACZ,GAAG,EAAE,MAAM,EAAE,CAAA;CACd,CA4BA,CAAA;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAsB,gBAAgB,CAAC,IAAI,EAAE,YAAY,GAAG,OAAO,CAAC,OAAO,EAAE,CAAC,CAG7E"}

package/dist/diagnostics/index.js

@@ -0,0 +1,106 @@
+/**
+ * Checks markup against LO-TEK, outside the browser.
+ *
+ * `diagnoseMarkup(html)` is the same check the editor extensions run while
+ * you type, and that `lotek check` runs on the command line. It is here
+ * because markup produced without JavaScript, in a Go template, a Kotlin
+ * string or a Razor view, has no compiler looking at the attributes. A test
+ * in the app can then run it over the HTML the server actually sends:
+ *
+ * ```ts
+ * import { diagnosePage } from "@lo-tek/interfaces/diagnostics"
+ *
+ * expect(diagnosePage(html)).toEqual([])
+ * ```
+ *
+ * The check is the core, written in Rust and built to WebAssembly (see
+ * `core.ts`). The module ships with the package, and is loaded the first
+ * time one of the functions is called, in Node, Bun and Deno. In the
+ * browser, or where the module is bundled some other way, `loadCore` loads
+ * it.
+ */
+import { defaultCore } from "./default-core.js";
+export { loadCore, } from "./core.js";
+/** Every finding in the text: the vocabulary, for a template or a fragment of a page. */
+export function diagnoseMarkup(text, options = {}) {
+    return options.css
+        ? defaultCore().diagnoseStyled(text, options.css, false)
+        : defaultCore().diagnoseMarkup(text);
+}
+/**
+ * Every finding on a whole page: what `diagnoseMarkup` finds, and also that
+ * every `for`, `aria-describedby`, `aria-labelledby` and `aria-controls`
+ * points to an id that exists, that no id appears twice, and that every
+ * LO-TEK field and every help text and error text is wired.
+ *
+ * Use it on the HTML the server sends, not on a template: in a template split
+ * into pieces, the id can be in another file.
+ *
+ * ```ts
+ * const html = await (await fetch("http://localhost:8080/form")).text()
+ * expect(diagnosePage(html)).toEqual([])
+ * ```
+ */
+export function diagnosePage(text, options = {}) {
+    return options.css
+        ? defaultCore().diagnoseStyled(text, options.css, true)
+        : defaultCore().diagnosePage(text);
+}
+/**
+ * Reads the rendered page in the browser: the DOM as it stands now, and the
+ * text of every stylesheet, with what they import. A stylesheet from another
+ * origin, such as a CDN, cannot be read through the CSSOM without
+ * `crossorigin`, and is then fetched again with `fetch`.
+ *
+ * The function runs in the browser, and cannot use anything outside itself.
+ */
+export const READ_RENDERED_PAGE = async () => {
+    const sheets = [
+        ...document.styleSheets,
+        ...document.adoptedStyleSheets,
+    ];
+    const css = [];
+    const read = async (sheet) => {
+        let rules;
+        try {
+            rules = sheet.cssRules;
+        }
+        catch {
+            if (!sheet.href)
+                return;
+            const answer = await fetch(sheet.href);
+            if (!answer.ok)
+                throw new Error(`The stylesheet ${sheet.href} could not be read, and answered ${answer.status} when it was fetched again.`);
+            css.push(await answer.text());
+            return;
+        }
+        for (const rule of rules)
+            if (rule instanceof CSSImportRule && rule.styleSheet)
+                await read(rule.styleSheet);
+        css.push([...rules].map((rule) => rule.cssText).join("\n"));
+    };
+    for (const sheet of sheets)
+        await read(sheet);
+    const doctype = document.doctype ? `<!DOCTYPE ${document.doctype.name}>` : "";
+    return { html: doctype + document.documentElement.outerHTML, css };
+};
+/**
+ * Checks the page as the browser has rendered it, with the stylesheets it
+ * has loaded: what `diagnosePage` finds, and what the stylesheets do not
+ * style. Markup the web components have added, and a class JavaScript has
+ * set, are included.
+ *
+ * ```ts
+ * import { diagnoseRendered } from "@lo-tek/interfaces/diagnostics"
+ *
+ * await page.goto("http://localhost:8080/form")
+ * expect(await diagnoseRendered(page)).toEqual([])
+ * ```
+ *
+ * `page` is a Playwright page, or anything with `evaluate`.
+ */
+export async function diagnoseRendered(page) {
+    const { html, css } = await page.evaluate(READ_RENDERED_PAGE);
+    return defaultCore().diagnoseStyled(html, css, true);
+}
+//# sourceMappingURL=index.js.map

package/dist/diagnostics/index.js.map

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

package/dist/dom.d.ts

@@ -0,0 +1,55 @@
+/**
+ * Applying the attributes to an element in the plain DOM.
+ *
+ * In JSX you spread the object straight onto the element. Without JSX you
+ * would have to loop through it yourself, and take care to remove attributes
+ * from the previous state. When a field goes from invalid to valid, the
+ * builder function leaves out `data-state`, and a `setAttribute` alone would
+ * have left the old value in place.
+ */
+/**
+ * The values a builder function can output.
+ *
+ * `true` and `false` are included because several of them are boolean HTML
+ * attributes: `disabled` on a switch, `multiple` on a file field, `hidden` on
+ * an error text. In HTML such an attribute is true as long as it exists,
+ * whatever its value, so `true` is set as the empty string and `false`
+ * removes it.
+ */
+export type Attributes = Record<string, string | boolean | undefined>;
+/**
+ * Sets the attributes from an `lt` function on an element.
+ *
+ * ```ts
+ * import { lt } from "@lo-tek/interfaces"
+ *
+ * const field = document.querySelector("input")
+ * lt.setAttributes(field, lt.input({ type: "email", state: "invalid" }))
+ * ```
+ *
+ * Call it again to change state. What the builder function manages and is
+ * not in the new set is removed, and the `lt-` classes are replaced. A
+ * builder function manages the attributes it has an option for:
+ * `lt.spinner()` has `label`, and so manages `role` and `aria-label`. What it
+ * has no option for stays as it is: `lt.button()` has never written
+ * `disabled`, so a disabled button is still disabled afterwards. `id` and
+ * `for` are never removed.
+ *
+ * When two sets go on the same element, pass them separately, not spread
+ * together:
+ *
+ * ```ts
+ * lt.setAttributes(field, lt.input({ type: "email" }), wiring.control)
+ * ```
+ *
+ * A spread object is a new object, and then the function does not know which
+ * builder function it came from. It is set correctly, but only `data-*` is
+ * cleaned up. An explicit `false` in a handwritten set removes the attribute.
+ *
+ * It accepts `null`, and then does nothing. `document.querySelector()`
+ * returns `Element | null`, so without that every call site in a `strict` app
+ * would need a guard or an exclamation mark around a lookup that almost
+ * always succeeds. It is the same trade-off as `element?.classList`.
+ */
+export declare function setAttributes(element: Element | null | undefined, ...sets: Attributes[]): void;
+//# sourceMappingURL=dom.d.ts.map

package/dist/dom.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dom.d.ts","sourceRoot":"","sources":["../src/dom.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AA0CH;;;;;;;;GAQG;AACH,MAAM,MAAM,UAAU,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,GAAG,SAAS,CAAC,CAAA;AAErE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AACH,wBAAgB,aAAa,CAC3B,OAAO,EAAE,OAAO,GAAG,IAAI,GAAG,SAAS,EACnC,GAAG,IAAI,EAAE,UAAU,EAAE,GACpB,IAAI,CAsDN"}