react-cheminfo 0.1.0

package/lib/citation/core/render.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"render.d.ts","sourceRoot":"","sources":["../../../src/citation/core/render.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAErD;;;;GAIG;AACH,wBAAgB,UAAU,CAAC,QAAQ,EAAE,SAAS,eAAe,EAAE,GAAG,MAAM,CAMvE;AAED;;;;;GAKG;AACH,wBAAgB,UAAU,CAAC,QAAQ,EAAE,SAAS,eAAe,EAAE,GAAG,MAAM,CAqBvE;AAED;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,QAAQ,EAAE,SAAS,eAAe,EAAE,GAAG,MAAM,CAqB3E"}

package/lib/citation/core/render.js

@@ -0,0 +1,74 @@
+/**
+ * Write the segments as they read in an email or a manuscript.
+ * @param segments - Segments of the citation.
+ * @returns The citation, with no markup at all.
+ */
+export function renderText(segments) {
+    let result = '';
+    for (const segment of segments) {
+        result += segment.kind === 'link' ? segment.href : segment.text;
+    }
+    return result;
+}
+/**
+ * Write the segments as HTML, so a paste into Word or a web page keeps the
+ * italics and the bold the style asks for.
+ * @param segments - Segments of the citation.
+ * @returns The citation as one line of HTML.
+ */
+export function renderHtml(segments) {
+    let result = '';
+    for (const segment of segments) {
+        switch (segment.kind) {
+            case 'italic':
+                result += `<em>${escapeHtml(segment.text)}</em>`;
+                break;
+            case 'bold':
+                result += `<strong>${escapeHtml(segment.text)}</strong>`;
+                break;
+            case 'link':
+                result += `<a href="${escapeHtml(segment.href)}">${escapeHtml(segment.text)}</a>`;
+                break;
+            case 'text':
+                result += escapeHtml(segment.text);
+                break;
+            default:
+                break;
+        }
+    }
+    return result;
+}
+/**
+ * Write the segments as Markdown, for a README or an issue.
+ * @param segments - Segments of the citation.
+ * @returns The citation as one line of Markdown.
+ */
+export function renderMarkdown(segments) {
+    let result = '';
+    for (const segment of segments) {
+        switch (segment.kind) {
+            case 'italic':
+                result += `*${segment.text}*`;
+                break;
+            case 'bold':
+                result += `**${segment.text}**`;
+                break;
+            case 'link':
+                result += `[${segment.text}](${segment.href})`;
+                break;
+            case 'text':
+                result += segment.text;
+                break;
+            default:
+                break;
+        }
+    }
+    return result;
+}
+function escapeHtml(value) {
+    return value
+        .replaceAll('&', '&amp;')
+        .replaceAll('<', '&lt;')
+        .replaceAll('>', '&gt;');
+}
+//# sourceMappingURL=render.js.map

package/lib/citation/core/render.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"render.js","sourceRoot":"","sources":["../../../src/citation/core/render.ts"],"names":[],"mappings":"AAEA;;;;GAIG;AACH,MAAM,UAAU,UAAU,CAAC,QAAoC;IAC7D,IAAI,MAAM,GAAG,EAAE,CAAC;IAChB,KAAK,MAAM,OAAO,IAAI,QAAQ,EAAE,CAAC;QAC/B,MAAM,IAAI,OAAO,CAAC,IAAI,KAAK,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC;IAClE,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,UAAU,CAAC,QAAoC;IAC7D,IAAI,MAAM,GAAG,EAAE,CAAC;IAChB,KAAK,MAAM,OAAO,IAAI,QAAQ,EAAE,CAAC;QAC/B,QAAQ,OAAO,CAAC,IAAI,EAAE,CAAC;YACrB,KAAK,QAAQ;gBACX,MAAM,IAAI,OAAO,UAAU,CAAC,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC;gBACjD,MAAM;YACR,KAAK,MAAM;gBACT,MAAM,IAAI,WAAW,UAAU,CAAC,OAAO,CAAC,IAAI,CAAC,WAAW,CAAC;gBACzD,MAAM;YACR,KAAK,MAAM;gBACT,MAAM,IAAI,YAAY,UAAU,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,UAAU,CAAC,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC;gBAClF,MAAM;YACR,KAAK,MAAM;gBACT,MAAM,IAAI,UAAU,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;gBACnC,MAAM;YACR;gBACE,MAAM;QACV,CAAC;IACH,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,cAAc,CAAC,QAAoC;IACjE,IAAI,MAAM,GAAG,EAAE,CAAC;IAChB,KAAK,MAAM,OAAO,IAAI,QAAQ,EAAE,CAAC;QAC/B,QAAQ,OAAO,CAAC,IAAI,EAAE,CAAC;YACrB,KAAK,QAAQ;gBACX,MAAM,IAAI,IAAI,OAAO,CAAC,IAAI,GAAG,CAAC;gBAC9B,MAAM;YACR,KAAK,MAAM;gBACT,MAAM,IAAI,KAAK,OAAO,CAAC,IAAI,IAAI,CAAC;gBAChC,MAAM;YACR,KAAK,MAAM;gBACT,MAAM,IAAI,IAAI,OAAO,CAAC,IAAI,KAAK,OAAO,CAAC,IAAI,GAAG,CAAC;gBAC/C,MAAM;YACR,KAAK,MAAM;gBACT,MAAM,IAAI,OAAO,CAAC,IAAI,CAAC;gBACvB,MAAM;YACR;gBACE,MAAM;QACV,CAAC;IACH,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,SAAS,UAAU,CAAC,KAAa;IAC/B,OAAO,KAAK;SACT,UAAU,CAAC,GAAG,EAAE,OAAO,CAAC;SACxB,UAAU,CAAC,GAAG,EAAE,MAAM,CAAC;SACvB,UAAU,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC;AAC7B,CAAC"}

package/lib/citation/core/segments.d.ts

@@ -0,0 +1,47 @@
+import type { Reference } from './reference.ts';
+/** One piece of a written reference, with the emphasis its style asks for. */
+export type CitationSegment = {
+    kind: 'text' | 'italic' | 'bold';
+    text: string;
+} | {
+    kind: 'link';
+    text: string;
+    href: string;
+};
+/** The journal styles the reference can be written in. */
+export type CitationStyleId = 'acs' | 'nature' | 'rsc' | 'wiley';
+/** One entry of the style submenu. */
+export interface CitationStyle {
+    id: CitationStyleId;
+    /** Name of the style. */
+    label: string;
+    /** Journals that ask for it, shown on the right of the entry. */
+    hint: string;
+}
+/** Every style offered, in the order the menu lists them. */
+export declare const CITATION_STYLES: readonly [{
+    readonly id: "acs";
+    readonly label: "ACS";
+    readonly hint: "JACS, Org. Lett.";
+}, {
+    readonly id: "nature";
+    readonly label: "Nature";
+    readonly hint: "Nature, Nat. Chem.";
+}, {
+    readonly id: "rsc";
+    readonly label: "RSC";
+    readonly hint: "Chem. Sci., Green Chem.";
+}, {
+    readonly id: "wiley";
+    readonly label: "Wiley";
+    readonly hint: "Angew. Chem., Chem. Eur. J.";
+}];
+/**
+ * Write a reference in one journal style, as the pieces every output format
+ * then renders with its own emphasis.
+ * @param reference - Reference to write.
+ * @param style - Style to write it in.
+ * @returns The segments of the citation, in reading order.
+ */
+export declare function citationSegments(reference: Reference, style: CitationStyleId): CitationSegment[];
+//# sourceMappingURL=segments.d.ts.map

package/lib/citation/core/segments.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"segments.d.ts","sourceRoot":"","sources":["../../../src/citation/core/segments.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAGhD,8EAA8E;AAC9E,MAAM,MAAM,eAAe,GACvB;IAAE,IAAI,EAAE,MAAM,GAAG,QAAQ,GAAG,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GAClD;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC;AAEjD,0DAA0D;AAC1D,MAAM,MAAM,eAAe,GAAG,KAAK,GAAG,QAAQ,GAAG,KAAK,GAAG,OAAO,CAAC;AAEjE,sCAAsC;AACtC,MAAM,WAAW,aAAa;IAC5B,EAAE,EAAE,eAAe,CAAC;IACpB,yBAAyB;IACzB,KAAK,EAAE,MAAM,CAAC;IACd,iEAAiE;IACjE,IAAI,EAAE,MAAM,CAAC;CACd;AAED,6DAA6D;AAC7D,eAAO,MAAM,eAAe;;;;;;;;;;;;;;;;EAKiB,CAAC;AAE9C;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAC9B,SAAS,EAAE,SAAS,EACpB,KAAK,EAAE,eAAe,GACrB,eAAe,EAAE,CAanB"}

package/lib/citation/core/segments.js

@@ -0,0 +1,134 @@
+import { doiUrl } from "./reference.js";
+/** Every style offered, in the order the menu lists them. */
+export const CITATION_STYLES = [
+    { id: 'acs', label: 'ACS', hint: 'JACS, Org. Lett.' },
+    { id: 'nature', label: 'Nature', hint: 'Nature, Nat. Chem.' },
+    { id: 'rsc', label: 'RSC', hint: 'Chem. Sci., Green Chem.' },
+    { id: 'wiley', label: 'Wiley', hint: 'Angew. Chem., Chem. Eur. J.' },
+];
+/**
+ * Write a reference in one journal style, as the pieces every output format
+ * then renders with its own emphasis.
+ * @param reference - Reference to write.
+ * @param style - Style to write it in.
+ * @returns The segments of the citation, in reading order.
+ */
+export function citationSegments(reference, style) {
+    switch (style) {
+        case 'acs':
+            return acs(reference);
+        case 'nature':
+            return nature(reference);
+        case 'rsc':
+            return rsc(reference);
+        case 'wiley':
+            return wiley(reference);
+        default:
+            throw new Error(`unknown citation style: ${String(style)}`);
+    }
+}
+function acs(reference) {
+    const { title, journalAbbreviation, year, volume } = reference;
+    return [
+        text(`${familyFirst(reference, '; ')} ${title}. `),
+        italic(journalAbbreviation),
+        text(' '),
+        bold(String(year)),
+        text(', '),
+        italic(volume),
+        text(`, ${pageRange(reference)}. `),
+        doiLink(reference),
+    ];
+}
+function nature(reference) {
+    const { title, journalAbbreviation, year, volume } = reference;
+    return [
+        text(`${familyFirstAmpersand(reference)} ${title}. `),
+        italic(journalAbbreviation),
+        text(' '),
+        bold(volume),
+        text(`, ${pageRange(reference)} (${year}). `),
+        doiLink(reference),
+    ];
+}
+function rsc(reference) {
+    const { journalAbbreviation, year, volume } = reference;
+    return [
+        text(`${initialsFirst(reference, ' and ')}, `),
+        italic(journalAbbreviation),
+        text(`, ${year}, `),
+        bold(volume),
+        text(`, ${pageRange(reference)}. `),
+        doiLink(reference),
+    ];
+}
+function wiley(reference) {
+    const { journalAbbreviation, year, volume } = reference;
+    return [
+        text(`${initialsFirst(reference, ', ')}, `),
+        italic(journalAbbreviation),
+        text(' '),
+        bold(String(year)),
+        text(', '),
+        italic(volume),
+        text(`, ${pageRange(reference)}. `),
+        doiLink(reference),
+    ];
+}
+function text(value) {
+    return { kind: 'text', text: value };
+}
+function italic(value) {
+    return { kind: 'italic', text: value };
+}
+function bold(value) {
+    return { kind: 'bold', text: value };
+}
+function doiLink(reference) {
+    return {
+        kind: 'link',
+        text: `doi:${reference.doi}`,
+        href: doiUrl(reference),
+    };
+}
+/**
+ * `Vanderveen, J. R.; Patiny, L.` — the family name leads.
+ * @param reference - The work being written.
+ * @param separator - What goes between two authors.
+ * @returns The authors, as one string.
+ */
+function familyFirst(reference, separator) {
+    return reference.authors
+        .map((author) => `${author.family}, ${author.given}`)
+        .join(separator);
+}
+/**
+ * The same, with the last author introduced by an ampersand.
+ * @param reference - The work being written.
+ * @returns The authors, as one string.
+ */
+function familyFirstAmpersand(reference) {
+    const names = reference.authors.map((author) => `${author.family}, ${author.given}`);
+    const last = names.at(-1);
+    if (names.length < 2 || last === undefined)
+        return names.join(', ');
+    return `${names.slice(0, -1).join(', ')} & ${last}`;
+}
+/**
+ * `J. R. Vanderveen, L. Patiny` — the initials lead.
+ * @param reference - The work being written.
+ * @param lastSeparator - What introduces the last author.
+ * @returns The authors, as one string.
+ */
+function initialsFirst(reference, lastSeparator) {
+    const names = reference.authors.map((author) => `${author.given} ${author.family}`);
+    const last = names.at(-1);
+    if (names.length < 2 || last === undefined)
+        return names.join(', ');
+    return `${names.slice(0, -1).join(', ')}${lastSeparator}${last}`;
+}
+function pageRange(reference) {
+    // En dash: what every style asks for in a page range.
+    return `${reference.firstPage}–${reference.lastPage}`;
+}
+//# sourceMappingURL=segments.js.map

package/lib/citation/core/segments.js.map

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

package/lib/citation/ui/CitationMenu.d.ts

@@ -0,0 +1,14 @@
+import type { ReactElement } from 'react';
+import type { Reference } from '../core/reference.ts';
+export interface CitationMenuProps {
+    /** The work being cited. */
+    reference: Reference;
+}
+/**
+ * What the Cite button opens: the article at its DOI, the reference copied in
+ * the style a journal asks for, and the files a reference manager imports.
+ * @param props - The work being cited.
+ * @returns The citation menu.
+ */
+export declare function CitationMenu(props: CitationMenuProps): ReactElement;
+//# sourceMappingURL=CitationMenu.d.ts.map

package/lib/citation/ui/CitationMenu.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"CitationMenu.d.ts","sourceRoot":"","sources":["../../../src/citation/ui/CitationMenu.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAiB,YAAY,EAAE,MAAM,OAAO,CAAC;AAMzD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AActD,MAAM,WAAW,iBAAiB;IAChC,4BAA4B;IAC5B,SAAS,EAAE,SAAS,CAAC;CACtB;AAED;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,iBAAiB,GAAG,YAAY,CA2FnE"}

package/lib/citation/ui/CitationMenu.js

@@ -0,0 +1,63 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { Menu, MenuDivider, MenuItem } from '@blueprintjs/core';
+import { SvgLogoDoi } from 'cheminfo-font';
+import { useEffect, useRef, useState } from 'react';
+import { copyCitation } from "../core/clipboard.js";
+import { CITATION_DOWNLOADS, CITATION_FORMATS } from "../core/formats.js";
+import { doiUrl } from "../core/reference.js";
+import { CITATION_STYLES } from "../core/segments.js";
+import { CopyEntry, DownloadEntry } from "./entries.js";
+// How long the tick replaces the clipboard glyph of an entry after a copy.
+const FEEDBACK_MS = 1500;
+const MENU_STYLE = { minWidth: 240 };
+const DOI_ICON_STYLE = { width: 16, height: 16 };
+/**
+ * What the Cite button opens: the article at its DOI, the reference copied in
+ * the style a journal asks for, and the files a reference manager imports.
+ * @param props - The work being cited.
+ * @returns The citation menu.
+ */
+export function CitationMenu(props) {
+    const { reference } = props;
+    // Which entry showed feedback last, keyed `format` or `format:style`.
+    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);
+    }
+    function copy(format, style) {
+        const key = style === undefined ? format.id : `${format.id}:${style.id}`;
+        copyCitation(reference, format.id, style?.id).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 stateOf(key) {
+        return copied === key ? feedback(hasFailed) : null;
+    }
+    return (_jsxs(Menu, { className: "citation-menu", style: MENU_STYLE, children: [_jsx(MenuItem, { icon: _jsx(SvgLogoDoi, { style: DOI_ICON_STYLE }), text: `${reference.journalAbbreviation} ${reference.year}`, label: reference.doi, href: doiUrl(reference), target: "_blank", rel: "noreferrer" }), _jsx(MenuDivider, { title: "Copy the reference as" }), CITATION_FORMATS.map((format) => format.styled ? (_jsx(MenuItem, { icon: "clipboard", text: format.label, label: format.hint, children: CITATION_STYLES.map((style) => (_jsx(CopyEntry, { reference: reference, format: format, style: style, state: stateOf(`${format.id}:${style.id}`), onCopy: copy }, style.id))) }, format.id)) : (_jsx(CopyEntry, { reference: reference, format: format, state: stateOf(format.id), onCopy: copy }, format.id))), _jsx(MenuDivider, { title: "Import into a reference manager" }), CITATION_DOWNLOADS.map((download) => (_jsx(DownloadEntry, { reference: reference, download: download }, download.format)))] }));
+}
+function feedback(failed) {
+    if (failed) {
+        return { icon: 'cross', intent: 'danger', label: 'copy failed' };
+    }
+    return { icon: 'tick', intent: 'success', label: 'copied' };
+}
+//# sourceMappingURL=CitationMenu.js.map

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

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

package/lib/citation/ui/CitationPreview.d.ts

@@ -0,0 +1,18 @@
+import type { ReactElement } from 'react';
+import type { CitationFormatId } from '../core/formats.ts';
+import type { Reference } from '../core/reference.ts';
+import type { CitationStyleId } from '../core/segments.ts';
+export interface CitationPreviewProps {
+    reference: Reference;
+    format: CitationFormatId;
+    /** Journal style, for the formats that have one. */
+    style?: CitationStyleId;
+}
+/**
+ * What a copy of the reference puts on the clipboard, as it will read once
+ * pasted: the emphasis of the style for HTML, the source itself otherwise.
+ * @param props - Reference, format and style to preview.
+ * @returns The body of the preview tooltip.
+ */
+export declare function CitationPreview(props: CitationPreviewProps): ReactElement;
+//# sourceMappingURL=CitationPreview.d.ts.map

package/lib/citation/ui/CitationPreview.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"CitationPreview.d.ts","sourceRoot":"","sources":["../../../src/citation/ui/CitationPreview.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAiB,YAAY,EAAE,MAAM,OAAO,CAAC;AAEzD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAE3D,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AACtD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AA2B3D,MAAM,WAAW,oBAAoB;IACnC,SAAS,EAAE,SAAS,CAAC;IACrB,MAAM,EAAE,gBAAgB,CAAC;IACzB,oDAAoD;IACpD,KAAK,CAAC,EAAE,eAAe,CAAC;CACzB;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,oBAAoB,GAAG,YAAY,CAoBzE"}

package/lib/citation/ui/CitationPreview.js

@@ -0,0 +1,55 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+import { formatCitation } from "../core/formats.js";
+import { citationSegments } from "../core/segments.js";
+// A BibTeX entry and a one-line citation share this box, so the text wraps and
+// the box never grows past what a tooltip can hold. The height is the last
+// resort, for a window too short to show an entry whole.
+const PREVIEW_STYLE = {
+    maxWidth: 440,
+    maxHeight: '70vh',
+    overflow: 'auto',
+    margin: 0,
+    color: '#e5e8eb',
+    fontFamily: 'ui-monospace, SFMono-Regular, Menlo, monospace',
+    fontSize: 11.5,
+    lineHeight: 1.45,
+    whiteSpace: 'pre-wrap',
+    overflowWrap: 'anywhere',
+};
+// HTML is previewed as it reads once pasted, so it takes the reading font.
+const RICH_STYLE = {
+    maxWidth: 440,
+    color: '#e5e8eb',
+    fontSize: 12,
+    lineHeight: 1.45,
+};
+const LINK_STYLE = { color: '#8abbff' };
+/**
+ * What a copy of the reference puts on the clipboard, as it will read once
+ * pasted: the emphasis of the style for HTML, the source itself otherwise.
+ * @param props - Reference, format and style to preview.
+ * @returns The body of the preview tooltip.
+ */
+export function CitationPreview(props) {
+    const { reference, format, style } = props;
+    if (format === 'html' && style !== undefined) {
+        return (_jsx("div", { className: "citation-preview", style: RICH_STYLE, children: citationSegments(reference, style).map((segment, index) => (_jsx(Segment, { segment: segment }, index))) }));
+    }
+    return (_jsx("pre", { className: "citation-preview", style: PREVIEW_STYLE, children: formatCitation(reference, format, style) }));
+}
+function Segment(props) {
+    const { segment } = props;
+    switch (segment.kind) {
+        case 'italic':
+            return _jsx("em", { children: segment.text });
+        case 'bold':
+            return _jsx("strong", { children: segment.text });
+        case 'link':
+            return _jsx("span", { style: LINK_STYLE, children: segment.text });
+        case 'text':
+            return _jsx("span", { children: segment.text });
+        default:
+            return _jsx("span", {});
+    }
+}
+//# sourceMappingURL=CitationPreview.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"CitationPreview.js","sourceRoot":"","sources":["../../../src/citation/ui/CitationPreview.tsx"],"names":[],"mappings":";AAGA,OAAO,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAGpD,OAAO,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AAEvD,+EAA+E;AAC/E,2EAA2E;AAC3E,yDAAyD;AACzD,MAAM,aAAa,GAAkB;IACnC,QAAQ,EAAE,GAAG;IACb,SAAS,EAAE,MAAM;IACjB,QAAQ,EAAE,MAAM;IAChB,MAAM,EAAE,CAAC;IACT,KAAK,EAAE,SAAS;IAChB,UAAU,EAAE,gDAAgD;IAC5D,QAAQ,EAAE,IAAI;IACd,UAAU,EAAE,IAAI;IAChB,UAAU,EAAE,UAAU;IACtB,YAAY,EAAE,UAAU;CACzB,CAAC;AACF,2EAA2E;AAC3E,MAAM,UAAU,GAAkB;IAChC,QAAQ,EAAE,GAAG;IACb,KAAK,EAAE,SAAS;IAChB,QAAQ,EAAE,EAAE;IACZ,UAAU,EAAE,IAAI;CACjB,CAAC;AACF,MAAM,UAAU,GAAkB,EAAE,KAAK,EAAE,SAAS,EAAE,CAAC;AASvD;;;;;GAKG;AACH,MAAM,UAAU,eAAe,CAAC,KAA2B;IACzD,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,GAAG,KAAK,CAAC;IAE3C,IAAI,MAAM,KAAK,MAAM,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;QAC7C,OAAO,CACL,cAAK,SAAS,EAAC,kBAAkB,EAAC,KAAK,EAAE,UAAU,YAChD,gBAAgB,CAAC,SAAS,EAAE,KAAK,CAAC,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,KAAK,EAAE,EAAE,CAAC,CAG1D,KAAC,OAAO,IAAa,OAAO,EAAE,OAAO,IAAvB,KAAK,CAAsB,CAC1C,CAAC,GACE,CACP,CAAC;IACJ,CAAC;IAED,OAAO,CACL,cAAK,SAAS,EAAC,kBAAkB,EAAC,KAAK,EAAE,aAAa,YACnD,cAAc,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,CAAC,GACrC,CACP,CAAC;AACJ,CAAC;AAED,SAAS,OAAO,CAAC,KAEhB;IACC,MAAM,EAAE,OAAO,EAAE,GAAG,KAAK,CAAC;IAC1B,QAAQ,OAAO,CAAC,IAAI,EAAE,CAAC;QACrB,KAAK,QAAQ;YACX,OAAO,uBAAK,OAAO,CAAC,IAAI,GAAM,CAAC;QACjC,KAAK,MAAM;YACT,OAAO,2BAAS,OAAO,CAAC,IAAI,GAAU,CAAC;QACzC,KAAK,MAAM;YACT,OAAO,eAAM,KAAK,EAAE,UAAU,YAAG,OAAO,CAAC,IAAI,GAAQ,CAAC;QACxD,KAAK,MAAM;YACT,OAAO,yBAAO,OAAO,CAAC,IAAI,GAAQ,CAAC;QACrC;YACE,OAAO,gBAAQ,CAAC;IACpB,CAAC;AACH,CAAC"}

package/lib/citation/ui/CiteButton.d.ts

@@ -0,0 +1,22 @@
+import type { ReactElement } from 'react';
+import type { HeaderButtonProps } from '../../shared/ui/MenuButton.tsx';
+import type { Reference } from '../core/reference.ts';
+export interface CiteButtonProps extends HeaderButtonProps {
+    /** The work the site asks to be cited. */
+    reference: Reference;
+    /**
+     * Text of the button. In a compact bar it is not written, but it stays what
+     * the pointer and a screen reader are told.
+     * @default 'Cite'
+     */
+    label?: string;
+}
+/**
+ * The Cite entry of a site header: one button opening the article at its DOI,
+ * the reference in the style a journal asks for, and the files a reference
+ * manager imports.
+ * @param props - The work being cited, and how the menu opens.
+ * @returns The button and its menu.
+ */
+export declare function CiteButton(props: CiteButtonProps): ReactElement;
+//# sourceMappingURL=CiteButton.d.ts.map

package/lib/citation/ui/CiteButton.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"CiteButton.d.ts","sourceRoot":"","sources":["../../../src/citation/ui/CiteButton.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,OAAO,CAAC;AAE1C,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,gCAAgC,CAAC;AAExE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AAItD,MAAM,WAAW,eAAgB,SAAQ,iBAAiB;IACxD,0CAA0C;IAC1C,SAAS,EAAE,SAAS,CAAC;IACrB;;;;OAIG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;;;;;GAMG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE,eAAe,GAAG,YAAY,CAY/D"}

package/lib/citation/ui/CiteButton.js

@@ -0,0 +1,15 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+import { MenuButton } from "../../shared/ui/MenuButton.js";
+import { CitationMenu } from "./CitationMenu.js";
+/**
+ * The Cite entry of a site header: one button opening the article at its DOI,
+ * the reference in the style a journal asks for, and the files a reference
+ * manager imports.
+ * @param props - The work being cited, and how the menu opens.
+ * @returns The button and its menu.
+ */
+export function CiteButton(props) {
+    const { reference, label = 'Cite', ...rest } = props;
+    return (_jsx(MenuButton, { ...rest, className: "citation-button", icon: "citation", label: label, menu: _jsx(CitationMenu, { reference: reference }) }));
+}
+//# sourceMappingURL=CiteButton.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"CiteButton.js","sourceRoot":"","sources":["../../../src/citation/ui/CiteButton.tsx"],"names":[],"mappings":";AAGA,OAAO,EAAE,UAAU,EAAE,MAAM,+BAAgC,CAAC;AAG5D,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAoB,CAAC;AAalD;;;;;;GAMG;AACH,MAAM,UAAU,UAAU,CAAC,KAAsB;IAC/C,MAAM,EAAE,SAAS,EAAE,KAAK,GAAG,MAAM,EAAE,GAAG,IAAI,EAAE,GAAG,KAAK,CAAC;IAErD,OAAO,CACL,KAAC,UAAU,OACL,IAAI,EACR,SAAS,EAAC,iBAAiB,EAC3B,IAAI,EAAC,UAAU,EACf,KAAK,EAAE,KAAK,EACZ,IAAI,EAAE,KAAC,YAAY,IAAC,SAAS,EAAE,SAAS,GAAI,GAC5C,CACH,CAAC;AACJ,CAAC"}

package/lib/citation/ui/entries.d.ts

@@ -0,0 +1,45 @@
+import type { IconName, Intent } from '@blueprintjs/core';
+import type { ReactElement } from 'react';
+import type { CitationDownload, CitationFormat } from '../core/formats.ts';
+import type { Reference } from '../core/reference.ts';
+import type { CitationStyle } from '../core/segments.ts';
+/** Feedback shown on an entry just after it was clicked. */
+export interface CopyState {
+    icon: IconName;
+    intent: Intent;
+    label: string;
+}
+export interface CopyEntryProps {
+    /** The work being cited. */
+    reference: Reference;
+    /** The format the entry copies. */
+    format: CitationFormat;
+    /**
+     * Style of the entry, when it sits in the submenu of a styled format.
+     * @default undefined
+     */
+    style?: CitationStyle;
+    /** Feedback of the last copy, while it is showing. */
+    state: CopyState | null;
+    /** Called with what the entry copies. */
+    onCopy: (format: CitationFormat, style?: CitationStyle) => void;
+}
+/**
+ * One entry that copies, previewing on hover what it puts on the clipboard.
+ * @param props - The reference, the format, and the feedback showing.
+ * @returns The menu entry.
+ */
+export declare function CopyEntry(props: CopyEntryProps): ReactElement;
+export interface DownloadEntryProps {
+    /** The work being saved. */
+    reference: Reference;
+    /** The file to write, from `CITATION_DOWNLOADS`. */
+    download: CitationDownload;
+}
+/**
+ * One entry saving the file a reference manager imports.
+ * @param props - The entry options.
+ * @returns The menu entry.
+ */
+export declare function DownloadEntry(props: DownloadEntryProps): ReactElement;
+//# sourceMappingURL=entries.d.ts.map

package/lib/citation/ui/entries.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"entries.d.ts","sourceRoot":"","sources":["../../../src/citation/ui/entries.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAE1D,OAAO,KAAK,EAAiB,YAAY,EAAE,MAAM,OAAO,CAAC;AAGzD,OAAO,KAAK,EAAE,gBAAgB,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAC3E,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AACtD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAczD,4DAA4D;AAC5D,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,QAAQ,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,cAAc;IAC7B,4BAA4B;IAC5B,SAAS,EAAE,SAAS,CAAC;IACrB,mCAAmC;IACnC,MAAM,EAAE,cAAc,CAAC;IACvB;;;OAGG;IACH,KAAK,CAAC,EAAE,aAAa,CAAC;IACtB,sDAAsD;IACtD,KAAK,EAAE,SAAS,GAAG,IAAI,CAAC;IACxB,yCAAyC;IACzC,MAAM,EAAE,CAAC,MAAM,EAAE,cAAc,EAAE,KAAK,CAAC,EAAE,aAAa,KAAK,IAAI,CAAC;CACjE;AAED;;;;GAIG;AACH,wBAAgB,SAAS,CAAC,KAAK,EAAE,cAAc,GAAG,YAAY,CA6B7D;AAED,MAAM,WAAW,kBAAkB;IACjC,4BAA4B;IAC5B,SAAS,EAAE,SAAS,CAAC;IACrB,oDAAoD;IACpD,QAAQ,EAAE,gBAAgB,CAAC;CAC5B;AAED;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,kBAAkB,GAAG,YAAY,CAkBrE"}

package/lib/citation/ui/entries.js

@@ -0,0 +1,52 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+import { MenuItem, Tooltip } from '@blueprintjs/core';
+import { downloadCitation } from "../core/download.js";
+import { CitationPreview } from "./CitationPreview.js";
+// An entry carrying its preview tooltip is also a popover target, and
+// Blueprint's `.bp6-submenu .bp6-popover-target` then turns the row into a
+// block, stacking the icon, the name and the journals. An inline rule outranks
+// any selector, so the row survives wherever the entry is used.
+const ENTRY_STYLE = { display: 'flex' };
+// Journal names are set in italic, as every one of these styles asks for.
+const JOURNALS_STYLE = { fontStyle: 'italic' };
+// Long enough that running the pointer down the menu opens no preview.
+const PREVIEW_OPEN_DELAY = 400;
+/**
+ * One entry that copies, previewing on hover what it puts on the clipboard.
+ * @param props - The reference, the format, and the feedback showing.
+ * @returns The menu entry.
+ */
+export function CopyEntry(props) {
+    const { reference, format, style, state, onCopy } = props;
+    const entry = style ?? format;
+    return (_jsx(PreviewTooltip, { reference: reference, format: format.id, style: style, children: (targetProps) => (_jsx(MenuItem, { ...targetProps, style: ENTRY_STYLE, icon: state?.icon ?? 'clipboard', intent: state?.intent, text: entry.label, labelElement: 
+            // The hint of a style entry is a list of journals, in italic.
+            style !== undefined && state === null ? (_jsx("span", { style: JOURNALS_STYLE, children: entry.hint })) : ((state?.label ?? entry.hint)), shouldDismissPopover: false, onClick: () => {
+                onCopy(format, style);
+            } })) }));
+}
+/**
+ * One entry saving the file a reference manager imports.
+ * @param props - The entry options.
+ * @returns The menu entry.
+ */
+export function DownloadEntry(props) {
+    const { reference, download } = props;
+    return (_jsx(PreviewTooltip, { reference: reference, format: download.format, children: (targetProps) => (_jsx(MenuItem, { ...targetProps, style: ENTRY_STYLE, icon: "download", text: download.label, labelElement: download.hint, onClick: () => {
+                downloadCitation(reference, download);
+            } })) }));
+}
+/**
+ * The hover preview of what an entry copies or saves.
+ * @param props - The preview options.
+ * @param props.reference - The work being written.
+ * @param props.format - The format the entry produces.
+ * @param props.style - The journal style, for a format that has one.
+ * @param props.children - The entry the preview is anchored on.
+ * @returns The entry, wrapped in its preview tooltip.
+ */
+function PreviewTooltip(props) {
+    const { reference, format, style, children } = props;
+    return (_jsx(Tooltip, { placement: "left", popoverClassName: "citation-tooltip", hoverOpenDelay: PREVIEW_OPEN_DELAY, content: _jsx(CitationPreview, { reference: reference, format: format, style: style?.id }), renderTarget: ({ isOpen, ...targetProps }) => children(targetProps) }));
+}
+//# sourceMappingURL=entries.js.map

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

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

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

@@ -0,0 +1,7 @@
+export type { CitationMenuProps } from './CitationMenu.tsx';
+export { CitationMenu } from './CitationMenu.tsx';
+export type { CitationPreviewProps } from './CitationPreview.tsx';
+export { CitationPreview } from './CitationPreview.tsx';
+export type { CiteButtonProps } from './CiteButton.tsx';
+export { CiteButton } from './CiteButton.tsx';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/citation/ui/index.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAC5D,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,YAAY,EAAE,oBAAoB,EAAE,MAAM,uBAAuB,CAAC;AAClE,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AACxD,YAAY,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AACxD,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC"}

package/lib/citation/ui/index.js

@@ -0,0 +1,4 @@
+export { CitationMenu } from "./CitationMenu.js";
+export { CitationPreview } from "./CitationPreview.js";
+export { CiteButton } from "./CiteButton.js";
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/citation/ui/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAoB,CAAC;AAElD,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAuB,CAAC;AAExD,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAkB,CAAC"}

package/lib/core.d.ts

@@ -0,0 +1,3 @@
+export * from './citation/core/index.ts';
+export * from './ecosystem/core/index.ts';
+//# sourceMappingURL=core.d.ts.map