react-cheminfo 0.3.0 → 0.4.0

package/lib/citation/ui/useCopyFeedback.js

@@ -0,0 +1,49 @@
+import { useEffect, useRef, useState } from 'react';
+import { copyCitations } from "../core/clipboard.js";
+// How long the tick replaces the clipboard glyph of an entry after a copy.
+const FEEDBACK_MS = 1500;
+/**
+ * Hold which entry of a citation menu was clicked last and how it went, so the
+ * tick — or the cross a denied clipboard leaves — shows on that entry alone.
+ * @returns The copy action, and the feedback of the entry that used it.
+ */
+export function useCopyFeedback() {
+    const [copied, setCopied] = useState(null);
+    const [hasFailed, setHasFailed] = useState(false);
+    const timeout = useRef(null);
+    useEffect(() => {
+        return () => {
+            if (timeout.current !== null)
+                window.clearTimeout(timeout.current);
+        };
+    }, []);
+    function announce(key, failed) {
+        setCopied(key);
+        setHasFailed(failed);
+        if (timeout.current !== null)
+            window.clearTimeout(timeout.current);
+        timeout.current = window.setTimeout(() => {
+            setCopied(null);
+            setHasFailed(false);
+        }, FEEDBACK_MS);
+    }
+    return {
+        stateOf: (key) => (copied === key ? feedback(hasFailed) : null),
+        copy: (key, references, format, style) => {
+            copyCitations(references, format, style).then(() => {
+                announce(key, false);
+            }, () => {
+                // A denied clipboard permission is the usual cause, and the menu is
+                // the only place the user can be told about it.
+                announce(key, true);
+            });
+        },
+    };
+}
+function feedback(failed) {
+    if (failed) {
+        return { icon: 'cross', intent: 'danger', label: 'copy failed' };
+    }
+    return { icon: 'tick', intent: 'success', label: 'copied' };
+}
+//# sourceMappingURL=useCopyFeedback.js.map

package/lib/citation/ui/useCopyFeedback.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useCopyFeedback.js","sourceRoot":"","sources":["../../../src/citation/ui/useCopyFeedback.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAC;AAEpD,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAOrD,2EAA2E;AAC3E,MAAM,WAAW,GAAG,IAAI,CAAC;AAiBzB;;;;GAIG;AACH,MAAM,UAAU,eAAe;IAC7B,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,GAAG,QAAQ,CAAgB,IAAI,CAAC,CAAC;IAC1D,MAAM,CAAC,SAAS,EAAE,YAAY,CAAC,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC;IAClD,MAAM,OAAO,GAAG,MAAM,CAAgB,IAAI,CAAC,CAAC;IAE5C,SAAS,CAAC,GAAG,EAAE;QACb,OAAO,GAAG,EAAE;YACV,IAAI,OAAO,CAAC,OAAO,KAAK,IAAI;gBAAE,MAAM,CAAC,YAAY,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;QACrE,CAAC,CAAC;IACJ,CAAC,EAAE,EAAE,CAAC,CAAC;IAEP,SAAS,QAAQ,CAAC,GAAW,EAAE,MAAe;QAC5C,SAAS,CAAC,GAAG,CAAC,CAAC;QACf,YAAY,CAAC,MAAM,CAAC,CAAC;QACrB,IAAI,OAAO,CAAC,OAAO,KAAK,IAAI;YAAE,MAAM,CAAC,YAAY,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;QACnE,OAAO,CAAC,OAAO,GAAG,MAAM,CAAC,UAAU,CAAC,GAAG,EAAE;YACvC,SAAS,CAAC,IAAI,CAAC,CAAC;YAChB,YAAY,CAAC,KAAK,CAAC,CAAC;QACtB,CAAC,EAAE,WAAW,CAAC,CAAC;IAClB,CAAC;IAED,OAAO;QACL,OAAO,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC,MAAM,KAAK,GAAG,CAAC,CAAC,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;QAC/D,IAAI,EAAE,CAAC,GAAG,EAAE,UAAU,EAAE,MAAM,EAAE,KAAK,EAAE,EAAE;YACvC,aAAa,CAAC,UAAU,EAAE,MAAM,EAAE,KAAK,CAAC,CAAC,IAAI,CAC3C,GAAG,EAAE;gBACH,QAAQ,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;YACvB,CAAC,EACD,GAAG,EAAE;gBACH,oEAAoE;gBACpE,gDAAgD;gBAChD,QAAQ,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;YACtB,CAAC,CACF,CAAC;QACJ,CAAC;KACF,CAAC;AACJ,CAAC;AAED,SAAS,QAAQ,CAAC,MAAe;IAC/B,IAAI,MAAM,EAAE,CAAC;QACX,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,KAAK,EAAE,aAAa,EAAE,CAAC;IACnE,CAAC;IACD,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,KAAK,EAAE,QAAQ,EAAE,CAAC;AAC9D,CAAC"}

package/lib/clipboard/core/index.d.ts

@@ -0,0 +1,2 @@
+export { writeToClipboard } from './writeToClipboard.ts';
+//# sourceMappingURL=index.d.ts.map

package/lib/clipboard/core/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/clipboard/core/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC"}

package/lib/clipboard/core/index.js

@@ -0,0 +1,2 @@
+export { writeToClipboard } from "./writeToClipboard.js";
+//# sourceMappingURL=index.js.map

package/lib/clipboard/core/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/clipboard/core/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC"}

package/lib/clipboard/core/writeToClipboard.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Put a piece of text on the clipboard, without ever throwing at the caller.
+ *
+ * The async Clipboard API is tried first and a hidden textarea is the fallback,
+ * which is what a page served over plain HTTP, an older Safari, or a browser
+ * that refused the permission is left with. A refusal is an outcome the caller
+ * shows rather than an error it has to catch, so both paths resolve.
+ * @param text - What to put on the clipboard.
+ * @returns Whether the clipboard now holds the text.
+ */
+export declare function writeToClipboard(text: string): Promise<boolean>;
+//# sourceMappingURL=writeToClipboard.d.ts.map

package/lib/clipboard/core/writeToClipboard.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"writeToClipboard.d.ts","sourceRoot":"","sources":["../../../src/clipboard/core/writeToClipboard.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,wBAAsB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAYrE"}

package/lib/clipboard/core/writeToClipboard.js

@@ -0,0 +1,49 @@
+/**
+ * Put a piece of text on the clipboard, without ever throwing at the caller.
+ *
+ * The async Clipboard API is tried first and a hidden textarea is the fallback,
+ * which is what a page served over plain HTTP, an older Safari, or a browser
+ * that refused the permission is left with. A refusal is an outcome the caller
+ * shows rather than an error it has to catch, so both paths resolve.
+ * @param text - What to put on the clipboard.
+ * @returns Whether the clipboard now holds the text.
+ */
+export async function writeToClipboard(text) {
+    const clipboard = globalThis.navigator?.clipboard;
+    if (clipboard) {
+        try {
+            await clipboard.writeText(text);
+            return true;
+        }
+        catch {
+            // A denied permission, or a call the browser no longer considers to come
+            // from a user gesture. The textarea below still works in both cases.
+        }
+    }
+    return writeWithTextArea(text);
+}
+function writeWithTextArea(text) {
+    if (typeof document === 'undefined')
+        return false;
+    const textArea = document.createElement('textarea');
+    textArea.value = text;
+    textArea.setAttribute('readonly', '');
+    // Off the screen rather than hidden: a `display: none` element selects
+    // nothing, and a visible one scrolls the page as it is focused.
+    textArea.style.position = 'fixed';
+    textArea.style.top = '-9999px';
+    textArea.style.opacity = '0';
+    document.body.append(textArea);
+    textArea.select();
+    try {
+        // eslint-disable-next-line @typescript-eslint/no-deprecated -- the deprecated command is what the fallback is
+        return document.execCommand('copy');
+    }
+    catch {
+        return false;
+    }
+    finally {
+        textArea.remove();
+    }
+}
+//# sourceMappingURL=writeToClipboard.js.map

package/lib/clipboard/core/writeToClipboard.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"writeToClipboard.js","sourceRoot":"","sources":["../../../src/clipboard/core/writeToClipboard.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,MAAM,CAAC,KAAK,UAAU,gBAAgB,CAAC,IAAY;IACjD,MAAM,SAAS,GAAG,UAAU,CAAC,SAAS,EAAE,SAAS,CAAC;IAClD,IAAI,SAAS,EAAE,CAAC;QACd,IAAI,CAAC;YACH,MAAM,SAAS,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;YAChC,OAAO,IAAI,CAAC;QACd,CAAC;QAAC,MAAM,CAAC;YACP,yEAAyE;YACzE,qEAAqE;QACvE,CAAC;IACH,CAAC;IACD,OAAO,iBAAiB,CAAC,IAAI,CAAC,CAAC;AACjC,CAAC;AAED,SAAS,iBAAiB,CAAC,IAAY;IACrC,IAAI,OAAO,QAAQ,KAAK,WAAW;QAAE,OAAO,KAAK,CAAC;IAElD,MAAM,QAAQ,GAAG,QAAQ,CAAC,aAAa,CAAC,UAAU,CAAC,CAAC;IACpD,QAAQ,CAAC,KAAK,GAAG,IAAI,CAAC;IACtB,QAAQ,CAAC,YAAY,CAAC,UAAU,EAAE,EAAE,CAAC,CAAC;IACtC,uEAAuE;IACvE,gEAAgE;IAChE,QAAQ,CAAC,KAAK,CAAC,QAAQ,GAAG,OAAO,CAAC;IAClC,QAAQ,CAAC,KAAK,CAAC,GAAG,GAAG,SAAS,CAAC;IAC/B,QAAQ,CAAC,KAAK,CAAC,OAAO,GAAG,GAAG,CAAC;IAC7B,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;IAC/B,QAAQ,CAAC,MAAM,EAAE,CAAC;IAElB,IAAI,CAAC;QACH,8GAA8G;QAC9G,OAAO,QAAQ,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC;IACtC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;YAAS,CAAC;QACT,QAAQ,CAAC,MAAM,EAAE,CAAC;IACpB,CAAC;AACH,CAAC"}

package/lib/clipboard/ui/CodeBlock.d.ts

@@ -0,0 +1,43 @@
+import type { ReactElement, ReactNode } from 'react';
+/** How a code block sits on the page it is shown in. */
+export type CodeBlockTone = 'default' | 'muted' | 'dark';
+export interface CodeBlockProps {
+    /** The text shown, and what the copy button hands over. */
+    code: string;
+    /**
+     * What is drawn in place of the plain text — syntax coloured spans, for
+     * instance. The code itself is still what gets copied.
+     * @default undefined — the code is shown as it is
+     */
+    children?: ReactNode;
+    /**
+     * How the block is painted: nothing of its own, a light grey panel, or a
+     * dark one.
+     * @default 'default'
+     */
+    tone?: CodeBlockTone;
+    /**
+     * Whether a copy button sits in the corner of the block.
+     * @default false
+     */
+    copyable?: boolean;
+    /**
+     * Height past which the block scrolls on its own rather than pushing what
+     * follows it down the page.
+     * @default undefined — the block is as tall as its content
+     */
+    maxHeight?: number | string;
+    /**
+     * Class the holder carries, in addition to `code-block`.
+     * @default undefined
+     */
+    className?: string;
+}
+/**
+ * A block of text to hand over: the address of a page, the markup that frames
+ * it, or a sample meant to be pasted into an editor and run.
+ * @param props - The code, how it is painted, and whether it can be copied.
+ * @returns The code block.
+ */
+export declare function CodeBlock(props: CodeBlockProps): ReactElement;
+//# sourceMappingURL=CodeBlock.d.ts.map

package/lib/clipboard/ui/CodeBlock.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"CodeBlock.d.ts","sourceRoot":"","sources":["../../../src/clipboard/ui/CodeBlock.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAiB,YAAY,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAIpE,wDAAwD;AACxD,MAAM,MAAM,aAAa,GAAG,SAAS,GAAG,OAAO,GAAG,MAAM,CAAC;AAwBzD,MAAM,WAAW,cAAc;IAC7B,2DAA2D;IAC3D,IAAI,EAAE,MAAM,CAAC;IACb;;;;OAIG;IACH,QAAQ,CAAC,EAAE,SAAS,CAAC;IACrB;;;;OAIG;IACH,IAAI,CAAC,EAAE,aAAa,CAAC;IACrB;;;OAGG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB;;;;OAIG;IACH,SAAS,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IAC5B;;;OAGG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;;;;GAKG;AACH,wBAAgB,SAAS,CAAC,KAAK,EAAE,cAAc,GAAG,YAAY,CAoB7D"}

package/lib/clipboard/ui/CodeBlock.js

@@ -0,0 +1,49 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { CopyButton } from "./CopyButton.js";
+const HOLDER_STYLE = { position: 'relative' };
+const COPY_STYLE = { position: 'absolute', top: 4, right: 4 };
+const BASE_PRE_STYLE = {
+    margin: 0,
+    padding: '8px 10px',
+    borderRadius: 4,
+    fontSize: 12,
+    whiteSpace: 'pre-wrap',
+    overflowWrap: 'anywhere',
+};
+const TONE_STYLE = {
+    default: {},
+    muted: { background: '#f6f7f9', border: '1px solid #d3d8de' },
+    dark: {
+        background: '#1e293b',
+        border: '1px solid #1e293b',
+        color: '#e2e8f0',
+    },
+};
+/**
+ * A block of text to hand over: the address of a page, the markup that frames
+ * it, or a sample meant to be pasted into an editor and run.
+ * @param props - The code, how it is painted, and whether it can be copied.
+ * @returns The code block.
+ */
+export function CodeBlock(props) {
+    const { code, children, tone = 'default', copyable = false, maxHeight, className, } = props;
+    return (_jsxs("div", { className: holderClassName(tone, className), style: HOLDER_STYLE, children: [_jsx("pre", { style: preStyle(tone, copyable, maxHeight), children: children ?? code }), copyable ? (_jsx("span", { style: COPY_STYLE, children: _jsx(CopyButton, { content: code, minimal: true, small: true }) })) : null] }));
+}
+function holderClassName(tone, className) {
+    const names = ['code-block'];
+    if (tone !== 'default')
+        names.push(`code-block--${tone}`);
+    if (className !== undefined)
+        names.push(className);
+    return names.join(' ');
+}
+function preStyle(tone, copyable, maxHeight) {
+    return {
+        ...BASE_PRE_STYLE,
+        ...TONE_STYLE[tone],
+        // The button floats over the corner, so the text stops before it.
+        ...(copyable ? { paddingRight: 42 } : {}),
+        ...(maxHeight === undefined ? {} : { maxHeight, overflowY: 'auto' }),
+    };
+}
+//# sourceMappingURL=CodeBlock.js.map

package/lib/clipboard/ui/CodeBlock.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"CodeBlock.js","sourceRoot":"","sources":["../../../src/clipboard/ui/CodeBlock.tsx"],"names":[],"mappings":";AAEA,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAkB,CAAC;AAK9C,MAAM,YAAY,GAAkB,EAAE,QAAQ,EAAE,UAAU,EAAE,CAAC;AAC7D,MAAM,UAAU,GAAkB,EAAE,QAAQ,EAAE,UAAU,EAAE,GAAG,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,CAAC;AAE7E,MAAM,cAAc,GAAkB;IACpC,MAAM,EAAE,CAAC;IACT,OAAO,EAAE,UAAU;IACnB,YAAY,EAAE,CAAC;IACf,QAAQ,EAAE,EAAE;IACZ,UAAU,EAAE,UAAU;IACtB,YAAY,EAAE,UAAU;CACzB,CAAC;AAEF,MAAM,UAAU,GAAyC;IACvD,OAAO,EAAE,EAAE;IACX,KAAK,EAAE,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,EAAE,mBAAmB,EAAE;IAC7D,IAAI,EAAE;QACJ,UAAU,EAAE,SAAS;QACrB,MAAM,EAAE,mBAAmB;QAC3B,KAAK,EAAE,SAAS;KACjB;CACF,CAAC;AAmCF;;;;;GAKG;AACH,MAAM,UAAU,SAAS,CAAC,KAAqB;IAC7C,MAAM,EACJ,IAAI,EACJ,QAAQ,EACR,IAAI,GAAG,SAAS,EAChB,QAAQ,GAAG,KAAK,EAChB,SAAS,EACT,SAAS,GACV,GAAG,KAAK,CAAC;IAEV,OAAO,CACL,eAAK,SAAS,EAAE,eAAe,CAAC,IAAI,EAAE,SAAS,CAAC,EAAE,KAAK,EAAE,YAAY,aACnE,cAAK,KAAK,EAAE,QAAQ,CAAC,IAAI,EAAE,QAAQ,EAAE,SAAS,CAAC,YAAG,QAAQ,IAAI,IAAI,GAAO,EACxE,QAAQ,CAAC,CAAC,CAAC,CACV,eAAM,KAAK,EAAE,UAAU,YACrB,KAAC,UAAU,IAAC,OAAO,EAAE,IAAI,EAAE,OAAO,QAAC,KAAK,SAAG,GACtC,CACR,CAAC,CAAC,CAAC,IAAI,IACJ,CACP,CAAC;AACJ,CAAC;AAED,SAAS,eAAe,CAAC,IAAmB,EAAE,SAAkB;IAC9D,MAAM,KAAK,GAAG,CAAC,YAAY,CAAC,CAAC;IAC7B,IAAI,IAAI,KAAK,SAAS;QAAE,KAAK,CAAC,IAAI,CAAC,eAAe,IAAI,EAAE,CAAC,CAAC;IAC1D,IAAI,SAAS,KAAK,SAAS;QAAE,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;IACnD,OAAO,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AACzB,CAAC;AAED,SAAS,QAAQ,CACf,IAAmB,EACnB,QAAiB,EACjB,SAAsC;IAEtC,OAAO;QACL,GAAG,cAAc;QACjB,GAAG,UAAU,CAAC,IAAI,CAAC;QACnB,kEAAkE;QAClE,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,YAAY,EAAE,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACzC,GAAG,CAAC,SAAS,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,EAAE,CAAC;KACrE,CAAC;AACJ,CAAC"}

package/lib/clipboard/ui/CopyButton.d.ts

@@ -0,0 +1,64 @@
+import type { IconName } from '@blueprintjs/core';
+import type { ReactElement } from 'react';
+export interface CopyButtonProps {
+    /**
+     * What to copy. A function is called when the button is pressed, which is
+     * what a whole list has to be: writing ten thousand structures out on every
+     * render, for a button nobody may press, is a page that stutters as it is
+     * scrolled.
+     */
+    content: string | (() => string);
+    /**
+     * Text of the button. Left out for an icon-only button, which is what a
+     * dense row of them needs.
+     * @default undefined — the button is reduced to its icon
+     */
+    label?: string;
+    /**
+     * Text shown while the copy is being confirmed, when there is a label.
+     * @default 'Copied'
+     */
+    copiedLabel?: string;
+    /**
+     * Whether the button drops its background, for a toolbar or a code block.
+     * @default false
+     */
+    minimal?: boolean;
+    /**
+     * Whether the button is the small size.
+     * @default false
+     */
+    small?: boolean;
+    /**
+     * Glyph shown at rest. A tick replaces it while the copy is confirmed.
+     * @default 'duplicate'
+     */
+    icon?: IconName;
+    /**
+     * Whether there is nothing to copy.
+     * @default false
+     */
+    disabled?: boolean;
+    /**
+     * How long the button says it copied, in milliseconds.
+     * @default 1500
+     */
+    resetAfter?: number;
+    /**
+     * What the pointer and a screen reader are told.
+     * @default 'Copy to clipboard'
+     */
+    title?: string;
+    /**
+     * Class the button carries, so a site can reach it from its stylesheet.
+     * @default undefined
+     */
+    className?: string;
+}
+/**
+ * A button that puts a piece of text on the clipboard and says so.
+ * @param props - What to copy, what the button reads, and how it looks.
+ * @returns The copy button.
+ */
+export declare function CopyButton(props: CopyButtonProps): ReactElement;
+//# sourceMappingURL=CopyButton.d.ts.map

package/lib/clipboard/ui/CopyButton.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"CopyButton.d.ts","sourceRoot":"","sources":["../../../src/clipboard/ui/CopyButton.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAElD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,OAAO,CAAC;AAO1C,MAAM,WAAW,eAAe;IAC9B;;;;;OAKG;IACH,OAAO,EAAE,MAAM,GAAG,CAAC,MAAM,MAAM,CAAC,CAAC;IACjC;;;;OAIG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IACf;;;OAGG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB;;;OAGG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB;;;OAGG;IACH,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB;;;OAGG;IACH,IAAI,CAAC,EAAE,QAAQ,CAAC;IAChB;;;OAGG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB;;;OAGG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB;;;OAGG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IACf;;;OAGG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;;;GAIG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE,eAAe,GAAG,YAAY,CA+B/D"}

package/lib/clipboard/ui/CopyButton.js

@@ -0,0 +1,21 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+import { Button } from '@blueprintjs/core';
+import { DEFAULT_COPY_RESET_AFTER, useCopyToClipboard, } from "./useCopyToClipboard.js";
+/**
+ * A button that puts a piece of text on the clipboard and says so.
+ * @param props - What to copy, what the button reads, and how it looks.
+ * @returns The copy button.
+ */
+export function CopyButton(props) {
+    const { content, label, copiedLabel = 'Copied', minimal = false, small = false, icon = 'duplicate', disabled = false, resetAfter = DEFAULT_COPY_RESET_AFTER, title = 'Copy to clipboard', className, } = props;
+    const { copied, copy } = useCopyToClipboard(resetAfter);
+    return (_jsx(Button, { className: className, variant: minimal ? 'minimal' : 'solid', size: small ? 'small' : 'medium', icon: copied ? 'tick' : icon, intent: copied ? 'success' : 'none', text: buttonText(label, copiedLabel, copied), disabled: disabled, title: title, "aria-label": label ?? title, onClick: () => {
+            void copy(typeof content === 'function' ? content() : content);
+        } }));
+}
+function buttonText(label, copiedLabel, copied) {
+    if (label === undefined)
+        return undefined;
+    return copied ? copiedLabel : label;
+}
+//# sourceMappingURL=CopyButton.js.map

package/lib/clipboard/ui/CopyButton.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"CopyButton.js","sourceRoot":"","sources":["../../../src/clipboard/ui/CopyButton.tsx"],"names":[],"mappings":";AACA,OAAO,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAG3C,OAAO,EACL,wBAAwB,EACxB,kBAAkB,GACnB,MAAM,yBAAyB,CAAC;AA0DjC;;;;GAIG;AACH,MAAM,UAAU,UAAU,CAAC,KAAsB;IAC/C,MAAM,EACJ,OAAO,EACP,KAAK,EACL,WAAW,GAAG,QAAQ,EACtB,OAAO,GAAG,KAAK,EACf,KAAK,GAAG,KAAK,EACb,IAAI,GAAG,WAAW,EAClB,QAAQ,GAAG,KAAK,EAChB,UAAU,GAAG,wBAAwB,EACrC,KAAK,GAAG,mBAAmB,EAC3B,SAAS,GACV,GAAG,KAAK,CAAC;IACV,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,GAAG,kBAAkB,CAAC,UAAU,CAAC,CAAC;IAExD,OAAO,CACL,KAAC,MAAM,IACL,SAAS,EAAE,SAAS,EACpB,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,OAAO,EACtC,IAAI,EAAE,KAAK,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,QAAQ,EAChC,IAAI,EAAE,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,EAC5B,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,MAAM,EACnC,IAAI,EAAE,UAAU,CAAC,KAAK,EAAE,WAAW,EAAE,MAAM,CAAC,EAC5C,QAAQ,EAAE,QAAQ,EAClB,KAAK,EAAE,KAAK,gBACA,KAAK,IAAI,KAAK,EAC1B,OAAO,EAAE,GAAG,EAAE;YACZ,KAAK,IAAI,CAAC,OAAO,OAAO,KAAK,UAAU,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC;QACjE,CAAC,GACD,CACH,CAAC;AACJ,CAAC;AAED,SAAS,UAAU,CACjB,KAAyB,EACzB,WAAmB,EACnB,MAAe;IAEf,IAAI,KAAK,KAAK,SAAS;QAAE,OAAO,SAAS,CAAC;IAC1C,OAAO,MAAM,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,KAAK,CAAC;AACtC,CAAC"}

package/lib/clipboard/ui/index.d.ts

@@ -0,0 +1,7 @@
+export type { CodeBlockProps, CodeBlockTone } from './CodeBlock.tsx';
+export { CodeBlock } from './CodeBlock.tsx';
+export type { CopyButtonProps } from './CopyButton.tsx';
+export { CopyButton } from './CopyButton.tsx';
+export type { CopyToClipboard } from './useCopyToClipboard.ts';
+export { DEFAULT_COPY_RESET_AFTER, useCopyToClipboard, } from './useCopyToClipboard.ts';
+//# sourceMappingURL=index.d.ts.map

package/lib/clipboard/ui/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/clipboard/ui/index.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AACrE,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAC5C,YAAY,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AACxD,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,YAAY,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAC/D,OAAO,EACL,wBAAwB,EACxB,kBAAkB,GACnB,MAAM,yBAAyB,CAAC"}

package/lib/clipboard/ui/index.js

@@ -0,0 +1,4 @@
+export { CodeBlock } from "./CodeBlock.js";
+export { CopyButton } from "./CopyButton.js";
+export { DEFAULT_COPY_RESET_AFTER, useCopyToClipboard, } from "./useCopyToClipboard.js";
+//# sourceMappingURL=index.js.map

package/lib/clipboard/ui/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/clipboard/ui/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAiB,CAAC;AAE5C,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAkB,CAAC;AAE9C,OAAO,EACL,wBAAwB,EACxB,kBAAkB,GACnB,MAAM,yBAAyB,CAAC"}

package/lib/clipboard/ui/useCopyToClipboard.d.ts

@@ -0,0 +1,24 @@
+/** How long a copy is confirmed for, in milliseconds, unless asked otherwise. */
+export declare const DEFAULT_COPY_RESET_AFTER = 1500;
+/** A clipboard write and the confirmation it leaves behind for a moment. */
+export interface CopyToClipboard {
+    /** Whether the last copy worked and is still being confirmed. */
+    copied: boolean;
+    /**
+     * Put text on the clipboard and confirm it.
+     * @param text - What to copy.
+     * @returns Whether the clipboard took it.
+     */
+    copy: (text: string) => Promise<boolean>;
+}
+/**
+ * Copy text and say so for a moment afterwards.
+ *
+ * The confirmation timer is cleared when the component goes away, and a copy
+ * that lands after that confirms nothing, so a button unmounted mid-copy — a
+ * row leaving a list, a menu closing — leaves no timer behind.
+ * @param resetAfter - How long the confirmation lasts, in milliseconds.
+ * @returns The confirmation flag and the copy action.
+ */
+export declare function useCopyToClipboard(resetAfter?: number): CopyToClipboard;
+//# sourceMappingURL=useCopyToClipboard.d.ts.map

package/lib/clipboard/ui/useCopyToClipboard.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useCopyToClipboard.d.ts","sourceRoot":"","sources":["../../../src/clipboard/ui/useCopyToClipboard.ts"],"names":[],"mappings":"AAIA,iFAAiF;AACjF,eAAO,MAAM,wBAAwB,OAAO,CAAC;AAE7C,4EAA4E;AAC5E,MAAM,WAAW,eAAe;IAC9B,iEAAiE;IACjE,MAAM,EAAE,OAAO,CAAC;IAChB;;;;OAIG;IACH,IAAI,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;CAC1C;AAED;;;;;;;;GAQG;AACH,wBAAgB,kBAAkB,CAChC,UAAU,SAA2B,GACpC,eAAe,CA0BjB"}

package/lib/clipboard/ui/useCopyToClipboard.js

@@ -0,0 +1,36 @@
+import { useCallback, useEffect, useRef, useState } from 'react';
+import { writeToClipboard } from "../core/writeToClipboard.js";
+/** How long a copy is confirmed for, in milliseconds, unless asked otherwise. */
+export const DEFAULT_COPY_RESET_AFTER = 1500;
+/**
+ * Copy text and say so for a moment afterwards.
+ *
+ * The confirmation timer is cleared when the component goes away, and a copy
+ * that lands after that confirms nothing, so a button unmounted mid-copy — a
+ * row leaving a list, a menu closing — leaves no timer behind.
+ * @param resetAfter - How long the confirmation lasts, in milliseconds.
+ * @returns The confirmation flag and the copy action.
+ */
+export function useCopyToClipboard(resetAfter = DEFAULT_COPY_RESET_AFTER) {
+    const [copied, setCopied] = useState(false);
+    const timer = useRef(undefined);
+    const isMounted = useRef(true);
+    useEffect(() => {
+        isMounted.current = true;
+        return () => {
+            isMounted.current = false;
+            clearTimeout(timer.current);
+        };
+    }, []);
+    const copy = useCallback(async (text) => {
+        const written = await writeToClipboard(text);
+        if (!written || !isMounted.current)
+            return written;
+        setCopied(true);
+        clearTimeout(timer.current);
+        timer.current = setTimeout(() => setCopied(false), resetAfter);
+        return true;
+    }, [resetAfter]);
+    return { copied, copy };
+}
+//# sourceMappingURL=useCopyToClipboard.js.map

package/lib/clipboard/ui/useCopyToClipboard.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useCopyToClipboard.js","sourceRoot":"","sources":["../../../src/clipboard/ui/useCopyToClipboard.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAC;AAEjE,OAAO,EAAE,gBAAgB,EAAE,MAAM,6BAA6B,CAAC;AAE/D,iFAAiF;AACjF,MAAM,CAAC,MAAM,wBAAwB,GAAG,IAAI,CAAC;AAc7C;;;;;;;;GAQG;AACH,MAAM,UAAU,kBAAkB,CAChC,UAAU,GAAG,wBAAwB;IAErC,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC;IAC5C,MAAM,KAAK,GAAG,MAAM,CAA4C,SAAS,CAAC,CAAC;IAC3E,MAAM,SAAS,GAAG,MAAM,CAAC,IAAI,CAAC,CAAC;IAE/B,SAAS,CAAC,GAAG,EAAE;QACb,SAAS,CAAC,OAAO,GAAG,IAAI,CAAC;QACzB,OAAO,GAAG,EAAE;YACV,SAAS,CAAC,OAAO,GAAG,KAAK,CAAC;YAC1B,YAAY,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;QAC9B,CAAC,CAAC;IACJ,CAAC,EAAE,EAAE,CAAC,CAAC;IAEP,MAAM,IAAI,GAAG,WAAW,CACtB,KAAK,EAAE,IAAY,EAAE,EAAE;QACrB,MAAM,OAAO,GAAG,MAAM,gBAAgB,CAAC,IAAI,CAAC,CAAC;QAC7C,IAAI,CAAC,OAAO,IAAI,CAAC,SAAS,CAAC,OAAO;YAAE,OAAO,OAAO,CAAC;QACnD,SAAS,CAAC,IAAI,CAAC,CAAC;QAChB,YAAY,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;QAC5B,KAAK,CAAC,OAAO,GAAG,UAAU,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,KAAK,CAAC,EAAE,UAAU,CAAC,CAAC;QAC/D,OAAO,IAAI,CAAC;IACd,CAAC,EACD,CAAC,UAAU,CAAC,CACb,CAAC;IAEF,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC;AAC1B,CAAC"}

package/lib/color/core/contrast.d.ts

@@ -0,0 +1,43 @@
+/** Which two inks {@link readableInk} chooses between. */
+export interface ReadableInkOptions {
+    /**
+     * The ink for a light background.
+     * @default '#182026'
+     */
+    dark?: string;
+    /**
+     * The ink for a dark background.
+     * @default '#ffffff'
+     */
+    light?: string;
+}
+/**
+ * The relative luminance of a colour, as WCAG 2 defines it.
+ * @param color - A `#rgb` or `#rrggbb` colour.
+ * @returns Its luminance, from 0 for black to 1 for white.
+ * @throws {Error} When the string is not a hex colour.
+ */
+export declare function relativeLuminance(color: string): number;
+/**
+ * The WCAG contrast ratio between two colours, whichever way round they come.
+ *
+ * Body text needs 4.5, large text and interface parts need 3.
+ * @param first - A `#rgb` or `#rrggbb` colour.
+ * @param second - The colour it is read against.
+ * @returns A ratio from 1 for two identical colours to 21 for black on white.
+ * @throws {Error} When either string is not a hex colour.
+ */
+export declare function contrastRatio(first: string, second: string): number;
+/**
+ * The ink that stays readable on a background.
+ *
+ * The two candidates are compared by contrast ratio rather than by a lightness
+ * threshold, so the choice is the one WCAG would make and a mid-tone
+ * background gets the ink it actually reads better against.
+ * @param background - The `#rgb` or `#rrggbb` colour written on.
+ * @param options - See {@link ReadableInkOptions}.
+ * @returns Whichever of the two inks reaches the higher contrast.
+ * @throws {Error} When any of the colours is not a hex colour.
+ */
+export declare function readableInk(background: string, options?: ReadableInkOptions): string;
+//# sourceMappingURL=contrast.d.ts.map

package/lib/color/core/contrast.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"contrast.d.ts","sourceRoot":"","sources":["../../../src/color/core/contrast.ts"],"names":[],"mappings":"AAYA,0DAA0D;AAC1D,MAAM,WAAW,kBAAkB;IACjC;;;OAGG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;IACd;;;OAGG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAOvD;AAED;;;;;;;;GAQG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAMnE;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,WAAW,CACzB,UAAU,EAAE,MAAM,EAClB,OAAO,GAAE,kBAAuB,GAC/B,MAAM,CAKR"}

package/lib/color/core/contrast.js

@@ -0,0 +1,61 @@
+import { parseHexColor } from "./hex.js";
+const RED_WEIGHT = 0.2126;
+const GREEN_WEIGHT = 0.7152;
+const BLUE_WEIGHT = 0.0722;
+const LINEAR_THRESHOLD = 0.039_28;
+/** The ink written on a light background. */
+const DARK_INK = '#182026';
+/** The ink written on a dark background. */
+const LIGHT_INK = '#ffffff';
+/**
+ * The relative luminance of a colour, as WCAG 2 defines it.
+ * @param color - A `#rgb` or `#rrggbb` colour.
+ * @returns Its luminance, from 0 for black to 1 for white.
+ * @throws {Error} When the string is not a hex colour.
+ */
+export function relativeLuminance(color) {
+    const { red, green, blue } = parseHexColor(color);
+    return (RED_WEIGHT * linearize(red) +
+        GREEN_WEIGHT * linearize(green) +
+        BLUE_WEIGHT * linearize(blue));
+}
+/**
+ * The WCAG contrast ratio between two colours, whichever way round they come.
+ *
+ * Body text needs 4.5, large text and interface parts need 3.
+ * @param first - A `#rgb` or `#rrggbb` colour.
+ * @param second - The colour it is read against.
+ * @returns A ratio from 1 for two identical colours to 21 for black on white.
+ * @throws {Error} When either string is not a hex colour.
+ */
+export function contrastRatio(first, second) {
+    const one = relativeLuminance(first);
+    const other = relativeLuminance(second);
+    const lighter = Math.max(one, other);
+    const darker = Math.min(one, other);
+    return (lighter + 0.05) / (darker + 0.05);
+}
+/**
+ * The ink that stays readable on a background.
+ *
+ * The two candidates are compared by contrast ratio rather than by a lightness
+ * threshold, so the choice is the one WCAG would make and a mid-tone
+ * background gets the ink it actually reads better against.
+ * @param background - The `#rgb` or `#rrggbb` colour written on.
+ * @param options - See {@link ReadableInkOptions}.
+ * @returns Whichever of the two inks reaches the higher contrast.
+ * @throws {Error} When any of the colours is not a hex colour.
+ */
+export function readableInk(background, options = {}) {
+    const { dark = DARK_INK, light = LIGHT_INK } = options;
+    return contrastRatio(background, dark) >= contrastRatio(background, light)
+        ? dark
+        : light;
+}
+function linearize(channel) {
+    const value = channel / 255;
+    return value <= LINEAR_THRESHOLD
+        ? value / 12.92
+        : ((value + 0.055) / 1.055) ** 2.4;
+}
+//# sourceMappingURL=contrast.js.map

package/lib/color/core/contrast.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"contrast.js","sourceRoot":"","sources":["../../../src/color/core/contrast.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAEzC,MAAM,UAAU,GAAG,MAAM,CAAC;AAC1B,MAAM,YAAY,GAAG,MAAM,CAAC;AAC5B,MAAM,WAAW,GAAG,MAAM,CAAC;AAC3B,MAAM,gBAAgB,GAAG,QAAQ,CAAC;AAElC,6CAA6C;AAC7C,MAAM,QAAQ,GAAG,SAAS,CAAC;AAC3B,4CAA4C;AAC5C,MAAM,SAAS,GAAG,SAAS,CAAC;AAgB5B;;;;;GAKG;AACH,MAAM,UAAU,iBAAiB,CAAC,KAAa;IAC7C,MAAM,EAAE,GAAG,EAAE,KAAK,EAAE,IAAI,EAAE,GAAG,aAAa,CAAC,KAAK,CAAC,CAAC;IAClD,OAAO,CACL,UAAU,GAAG,SAAS,CAAC,GAAG,CAAC;QAC3B,YAAY,GAAG,SAAS,CAAC,KAAK,CAAC;QAC/B,WAAW,GAAG,SAAS,CAAC,IAAI,CAAC,CAC9B,CAAC;AACJ,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,aAAa,CAAC,KAAa,EAAE,MAAc;IACzD,MAAM,GAAG,GAAG,iBAAiB,CAAC,KAAK,CAAC,CAAC;IACrC,MAAM,KAAK,GAAG,iBAAiB,CAAC,MAAM,CAAC,CAAC;IACxC,MAAM,OAAO,GAAG,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;IACrC,MAAM,MAAM,GAAG,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;IACpC,OAAO,CAAC,OAAO,GAAG,IAAI,CAAC,GAAG,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;AAC5C,CAAC;AAED;;;;;;;;;;GAUG;AACH,MAAM,UAAU,WAAW,CACzB,UAAkB,EAClB,UAA8B,EAAE;IAEhC,MAAM,EAAE,IAAI,GAAG,QAAQ,EAAE,KAAK,GAAG,SAAS,EAAE,GAAG,OAAO,CAAC;IACvD,OAAO,aAAa,CAAC,UAAU,EAAE,IAAI,CAAC,IAAI,aAAa,CAAC,UAAU,EAAE,KAAK,CAAC;QACxE,CAAC,CAAC,IAAI;QACN,CAAC,CAAC,KAAK,CAAC;AACZ,CAAC;AAED,SAAS,SAAS,CAAC,OAAe;IAChC,MAAM,KAAK,GAAG,OAAO,GAAG,GAAG,CAAC;IAC5B,OAAO,KAAK,IAAI,gBAAgB;QAC9B,CAAC,CAAC,KAAK,GAAG,KAAK;QACf,CAAC,CAAC,CAAC,CAAC,KAAK,GAAG,KAAK,CAAC,GAAG,KAAK,CAAC,IAAI,GAAG,CAAC;AACvC,CAAC"}

package/lib/color/core/hex.d.ts

@@ -0,0 +1,26 @@
+/** The three channels of a colour, each from 0 to 255. */
+export interface RgbColor {
+    /** Red channel. */
+    red: number;
+    /** Green channel. */
+    green: number;
+    /** Blue channel. */
+    blue: number;
+}
+/**
+ * Read a `#rgb` or `#rrggbb` colour into its three channels.
+ * @param color - A hex colour with its leading `#`, in either the short or the long form.
+ * @returns The three channels, each from 0 to 255.
+ * @throws {Error} When the string is not a hex colour, naming the value that was read.
+ */
+export declare function parseHexColor(color: string): RgbColor;
+/**
+ * Write three channels back as a `#rrggbb` colour.
+ *
+ * Each channel is rounded and held inside 0..255, so the result of an
+ * interpolation is always a colour a browser accepts.
+ * @param color - The three channels.
+ * @returns The lower-case six-digit hex colour.
+ */
+export declare function toHexColor(color: RgbColor): string;
+//# sourceMappingURL=hex.d.ts.map

package/lib/color/core/hex.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hex.d.ts","sourceRoot":"","sources":["../../../src/color/core/hex.ts"],"names":[],"mappings":"AAIA,0DAA0D;AAC1D,MAAM,WAAW,QAAQ;IACvB,mBAAmB;IACnB,GAAG,EAAE,MAAM,CAAC;IACZ,qBAAqB;IACrB,KAAK,EAAE,MAAM,CAAC;IACd,oBAAoB;IACpB,IAAI,EAAE,MAAM,CAAC;CACd;AAED;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,QAAQ,CAYrD;AAED;;;;;;;GAOG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE,QAAQ,GAAG,MAAM,CAElD"}

package/lib/color/core/hex.js

@@ -0,0 +1,44 @@
+const HEX_COLOR = /^#(?:[\da-f]{3}|[\da-f]{6})$/i;
+const SHORT_LENGTH = 3;
+const MAXIMUM_CHANNEL = 255;
+/**
+ * Read a `#rgb` or `#rrggbb` colour into its three channels.
+ * @param color - A hex colour with its leading `#`, in either the short or the long form.
+ * @returns The three channels, each from 0 to 255.
+ * @throws {Error} When the string is not a hex colour, naming the value that was read.
+ */
+export function parseHexColor(color) {
+    const text = typeof color === 'string' ? color.trim() : '';
+    if (!HEX_COLOR.test(text)) {
+        throw new Error(`not a hex colour: ${color}`);
+    }
+    const digits = text.slice(1);
+    const size = digits.length === SHORT_LENGTH ? 1 : 2;
+    return {
+        red: channelAt(digits, 0, size),
+        green: channelAt(digits, 1, size),
+        blue: channelAt(digits, 2, size),
+    };
+}
+/**
+ * Write three channels back as a `#rrggbb` colour.
+ *
+ * Each channel is rounded and held inside 0..255, so the result of an
+ * interpolation is always a colour a browser accepts.
+ * @param color - The three channels.
+ * @returns The lower-case six-digit hex colour.
+ */
+export function toHexColor(color) {
+    return `#${channelHex(color.red)}${channelHex(color.green)}${channelHex(color.blue)}`;
+}
+function channelAt(digits, index, size) {
+    const part = digits.slice(index * size, index * size + size);
+    return Number.parseInt(size === 1 ? `${part}${part}` : part, 16);
+}
+function channelHex(value) {
+    const safe = Number.isFinite(value)
+        ? Math.min(MAXIMUM_CHANNEL, Math.max(0, Math.round(value)))
+        : 0;
+    return safe.toString(16).padStart(2, '0');
+}
+//# sourceMappingURL=hex.js.map

package/lib/color/core/hex.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hex.js","sourceRoot":"","sources":["../../../src/color/core/hex.ts"],"names":[],"mappings":"AAAA,MAAM,SAAS,GAAG,+BAA+B,CAAC;AAClD,MAAM,YAAY,GAAG,CAAC,CAAC;AACvB,MAAM,eAAe,GAAG,GAAG,CAAC;AAY5B;;;;;GAKG;AACH,MAAM,UAAU,aAAa,CAAC,KAAa;IACzC,MAAM,IAAI,GAAG,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;IAC3D,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;QAC1B,MAAM,IAAI,KAAK,CAAC,qBAAqB,KAAK,EAAE,CAAC,CAAC;IAChD,CAAC;IACD,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;IAC7B,MAAM,IAAI,GAAG,MAAM,CAAC,MAAM,KAAK,YAAY,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IACpD,OAAO;QACL,GAAG,EAAE,SAAS,CAAC,MAAM,EAAE,CAAC,EAAE,IAAI,CAAC;QAC/B,KAAK,EAAE,SAAS,CAAC,MAAM,EAAE,CAAC,EAAE,IAAI,CAAC;QACjC,IAAI,EAAE,SAAS,CAAC,MAAM,EAAE,CAAC,EAAE,IAAI,CAAC;KACjC,CAAC;AACJ,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,UAAU,CAAC,KAAe;IACxC,OAAO,IAAI,UAAU,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,UAAU,CAAC,KAAK,CAAC,KAAK,CAAC,GAAG,UAAU,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC;AACxF,CAAC;AAED,SAAS,SAAS,CAAC,MAAc,EAAE,KAAa,EAAE,IAAY;IAC5D,MAAM,IAAI,GAAG,MAAM,CAAC,KAAK,CAAC,KAAK,GAAG,IAAI,EAAE,KAAK,GAAG,IAAI,GAAG,IAAI,CAAC,CAAC;IAC7D,OAAO,MAAM,CAAC,QAAQ,CAAC,IAAI,KAAK,CAAC,CAAC,CAAC,CAAC,GAAG,IAAI,GAAG,IAAI,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;AACnE,CAAC;AAED,SAAS,UAAU,CAAC,KAAa;IAC/B,MAAM,IAAI,GAAG,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC;QACjC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,eAAe,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC;QAC3D,CAAC,CAAC,CAAC,CAAC;IACN,OAAO,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;AAC5C,CAAC"}

package/lib/color/core/index.d.ts

@@ -0,0 +1,5 @@
+export type { ReadableInkOptions } from './contrast.ts';
+export { contrastRatio, readableInk, relativeLuminance } from './contrast.ts';
+export type { PositionInRangeOptions, Swatch } from './scale.ts';
+export { VIRIDIS_SCALE, positionInRange, swatchFromScale } from './scale.ts';
+//# sourceMappingURL=index.d.ts.map