react-cheminfo 0.2.0 → 0.4.0

package/lib/chrome/ui/index.js

@@ -0,0 +1,6 @@
+export { NavLink } from "./NavLink.js";
+export { NavMenuButton } from "./NavMenuButton.js";
+export { SiteFooter } from "./SiteFooter.js";
+export { SiteHeader } from "./SiteHeader.js";
+export { useCompactHeader } from "./useCompactHeader.js";
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/chrome/ui/index.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,OAAO,EAAE,MAAM,cAAe,CAAC;AAExC,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAqB,CAAC;AAEpD,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAkB,CAAC;AAE9C,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAkB,CAAC;AAE9C,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC"}

package/lib/chrome/ui/navItem.d.ts

@@ -0,0 +1,57 @@
+import type { IconName } from '@blueprintjs/core';
+import type { MouseEvent, ReactNode } from 'react';
+/**
+ * One entry of a site's chrome: a page in the bar, a utility beside it, or a
+ * line of a header menu. It is a plain description, so the same array feeds the
+ * bar, the menu it overflows into, and a site's own renderer.
+ */
+export interface NavItem {
+    /** What tells this entry apart, and what the active entry is named by. */
+    id: string;
+    /** What the entry reads. */
+    label: ReactNode;
+    /**
+     * The address the entry opens. Writing it keeps the entry a real link, so a
+     * crawler walks the site and a middle click opens a tab of its own, even when
+     * the plain click is taken over by `onSelect`.
+     * @default undefined
+     */
+    href?: string;
+    /**
+     * Glyph before the label, drawn at 14 px.
+     * @default undefined
+     */
+    icon?: IconName;
+    /**
+     * What the pointer is told, and what names the entry to a screen reader when
+     * the label is not text.
+     * @default undefined
+     */
+    title?: string;
+    /**
+     * Whether the address leaves the site, in which case it opens in a tab of its
+     * own.
+     * @default false
+     */
+    external?: boolean;
+    /**
+     * What the site does when the entry is picked. An entry that also carries an
+     * `href` takes over the plain click only — a modified one is left to the
+     * browser.
+     * @default undefined
+     */
+    onSelect?: () => void;
+    /**
+     * What follows the label: a count, a tag, anything the entry reports.
+     * @default undefined
+     */
+    after?: ReactNode;
+}
+/**
+ * Whether a click asked the browser for something other than following the link
+ * in place — a tab of its own, a window, a download.
+ * @param event - The click on the entry.
+ * @returns True when the browser is to be left alone.
+ */
+export declare function isModifiedClick(event: MouseEvent): boolean;
+//# sourceMappingURL=navItem.d.ts.map

package/lib/chrome/ui/navItem.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"navItem.d.ts","sourceRoot":"","sources":["../../../src/chrome/ui/navItem.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAClD,OAAO,KAAK,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAEnD;;;;GAIG;AACH,MAAM,WAAW,OAAO;IACtB,0EAA0E;IAC1E,EAAE,EAAE,MAAM,CAAC;IACX,4BAA4B;IAC5B,KAAK,EAAE,SAAS,CAAC;IACjB;;;;;OAKG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;IACd;;;OAGG;IACH,IAAI,CAAC,EAAE,QAAQ,CAAC;IAChB;;;;OAIG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IACf;;;;OAIG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB;;;;;OAKG;IACH,QAAQ,CAAC,EAAE,MAAM,IAAI,CAAC;IACtB;;;OAGG;IACH,KAAK,CAAC,EAAE,SAAS,CAAC;CACnB;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,UAAU,GAAG,OAAO,CAE1D"}

package/lib/chrome/ui/navItem.js

@@ -0,0 +1,10 @@
+/**
+ * Whether a click asked the browser for something other than following the link
+ * in place — a tab of its own, a window, a download.
+ * @param event - The click on the entry.
+ * @returns True when the browser is to be left alone.
+ */
+export function isModifiedClick(event) {
+    return event.metaKey || event.ctrlKey || event.shiftKey || event.altKey;
+}
+//# sourceMappingURL=navItem.js.map

package/lib/chrome/ui/navItem.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"navItem.js","sourceRoot":"","sources":["../../../src/chrome/ui/navItem.ts"],"names":[],"mappings":"AAmDA;;;;;GAKG;AACH,MAAM,UAAU,eAAe,CAAC,KAAiB;IAC/C,OAAO,KAAK,CAAC,OAAO,IAAI,KAAK,CAAC,OAAO,IAAI,KAAK,CAAC,QAAQ,IAAI,KAAK,CAAC,MAAM,CAAC;AAC1E,CAAC"}

package/lib/chrome/ui/useCompactHeader.d.ts

@@ -0,0 +1,31 @@
+import type { RefObject } from 'react';
+export interface UseCompactHeaderOptions {
+    /**
+     * Width in pixels at or below which the bar counts as narrow.
+     * @default 1000
+     */
+    maxWidth?: number;
+}
+/**
+ * Whether the bar has run out of room, so its utilities should be reduced to
+ * their icons and its page list allowed to fold away.
+ *
+ * The bar is measured rather than the window whenever a reference to it is
+ * given, so a tool sitting beside a panel folds on its own width; with no
+ * reference, or before the first paint, the window is what is read.
+ * @param ref - The bar itself, usually the `app-header__inner` element.
+ * @param options - The width at which the bar counts as narrow.
+ * @returns True while the bar is too narrow to write every label.
+ */
+export declare function useCompactHeader(ref?: RefObject<HTMLElement | null>, options?: UseCompactHeaderOptions): boolean;
+/**
+ * Whether a bar of this width has run out of room. An element that has not been
+ * laid out yet, and a page with no window to measure, are both taken as roomy:
+ * a bar that flashes its icons before its labels is worse than one that never
+ * folds.
+ * @param element - The bar, when there is one to measure.
+ * @param maxWidth - Width at or below which it counts as narrow.
+ * @returns True when the bar is narrow.
+ */
+export declare function isCompactBar(element: HTMLElement | null, maxWidth?: number): boolean;
+//# sourceMappingURL=useCompactHeader.d.ts.map

package/lib/chrome/ui/useCompactHeader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useCompactHeader.d.ts","sourceRoot":"","sources":["../../../src/chrome/ui/useCompactHeader.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAOvC,MAAM,WAAW,uBAAuB;IACtC;;;OAGG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,gBAAgB,CAC9B,GAAG,CAAC,EAAE,SAAS,CAAC,WAAW,GAAG,IAAI,CAAC,EACnC,OAAO,GAAE,uBAA4B,GACpC,OAAO,CAaT;AAED;;;;;;;;GAQG;AACH,wBAAgB,YAAY,CAC1B,OAAO,EAAE,WAAW,GAAG,IAAI,EAC3B,QAAQ,SAAoB,GAC3B,OAAO,CAMT"}

package/lib/chrome/ui/useCompactHeader.js

@@ -0,0 +1,50 @@
+import { useCallback, useSyncExternalStore } from 'react';
+// Below this the bar has run out of room: the utilities keep their icons and
+// give up their labels rather than pushing the pages off the edge.
+const COMPACT_MAX_WIDTH = 1000;
+/**
+ * Whether the bar has run out of room, so its utilities should be reduced to
+ * their icons and its page list allowed to fold away.
+ *
+ * The bar is measured rather than the window whenever a reference to it is
+ * given, so a tool sitting beside a panel folds on its own width; with no
+ * reference, or before the first paint, the window is what is read.
+ * @param ref - The bar itself, usually the `app-header__inner` element.
+ * @param options - The width at which the bar counts as narrow.
+ * @returns True while the bar is too narrow to write every label.
+ */
+export function useCompactHeader(ref, options = {}) {
+    const { maxWidth = COMPACT_MAX_WIDTH } = options;
+    const subscribe = useCallback((onChange) => watchWidth(ref?.current ?? null, onChange), [ref]);
+    const getSnapshot = useCallback(() => isCompactBar(ref?.current ?? null, maxWidth), [ref, maxWidth]);
+    return useSyncExternalStore(subscribe, getSnapshot, notCompact);
+}
+/**
+ * Whether a bar of this width has run out of room. An element that has not been
+ * laid out yet, and a page with no window to measure, are both taken as roomy:
+ * a bar that flashes its icons before its labels is worse than one that never
+ * folds.
+ * @param element - The bar, when there is one to measure.
+ * @param maxWidth - Width at or below which it counts as narrow.
+ * @returns True when the bar is narrow.
+ */
+export function isCompactBar(element, maxWidth = COMPACT_MAX_WIDTH) {
+    const measured = element === null ? 0 : element.clientWidth;
+    const width = measured > 0 ? measured : globalThis.innerWidth;
+    if (!Number.isFinite(width) || width <= 0)
+        return false;
+    return width <= maxWidth;
+}
+function watchWidth(element, onChange) {
+    if (element !== null && typeof ResizeObserver === 'function') {
+        const observer = new ResizeObserver(onChange);
+        observer.observe(element);
+        return () => observer.disconnect();
+    }
+    globalThis.addEventListener('resize', onChange);
+    return () => globalThis.removeEventListener('resize', onChange);
+}
+function notCompact() {
+    return false;
+}
+//# sourceMappingURL=useCompactHeader.js.map

package/lib/chrome/ui/useCompactHeader.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useCompactHeader.js","sourceRoot":"","sources":["../../../src/chrome/ui/useCompactHeader.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,EAAE,oBAAoB,EAAE,MAAM,OAAO,CAAC;AAE1D,6EAA6E;AAC7E,mEAAmE;AACnE,MAAM,iBAAiB,GAAG,IAAI,CAAC;AAU/B;;;;;;;;;;GAUG;AACH,MAAM,UAAU,gBAAgB,CAC9B,GAAmC,EACnC,UAAmC,EAAE;IAErC,MAAM,EAAE,QAAQ,GAAG,iBAAiB,EAAE,GAAG,OAAO,CAAC;IAEjD,MAAM,SAAS,GAAG,WAAW,CAC3B,CAAC,QAAoB,EAAE,EAAE,CAAC,UAAU,CAAC,GAAG,EAAE,OAAO,IAAI,IAAI,EAAE,QAAQ,CAAC,EACpE,CAAC,GAAG,CAAC,CACN,CAAC;IACF,MAAM,WAAW,GAAG,WAAW,CAC7B,GAAG,EAAE,CAAC,YAAY,CAAC,GAAG,EAAE,OAAO,IAAI,IAAI,EAAE,QAAQ,CAAC,EAClD,CAAC,GAAG,EAAE,QAAQ,CAAC,CAChB,CAAC;IAEF,OAAO,oBAAoB,CAAC,SAAS,EAAE,WAAW,EAAE,UAAU,CAAC,CAAC;AAClE,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,YAAY,CAC1B,OAA2B,EAC3B,QAAQ,GAAG,iBAAiB;IAE5B,MAAM,QAAQ,GAAG,OAAO,KAAK,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,WAAW,CAAC;IAC5D,MAAM,KAAK,GAAG,QAAQ,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,UAAU,CAAC,UAAU,CAAC;IAE9D,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,KAAK,IAAI,CAAC;QAAE,OAAO,KAAK,CAAC;IACxD,OAAO,KAAK,IAAI,QAAQ,CAAC;AAC3B,CAAC;AAED,SAAS,UAAU,CACjB,OAA2B,EAC3B,QAAoB;IAEpB,IAAI,OAAO,KAAK,IAAI,IAAI,OAAO,cAAc,KAAK,UAAU,EAAE,CAAC;QAC7D,MAAM,QAAQ,GAAG,IAAI,cAAc,CAAC,QAAQ,CAAC,CAAC;QAC9C,QAAQ,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;QAC1B,OAAO,GAAG,EAAE,CAAC,QAAQ,CAAC,UAAU,EAAE,CAAC;IACrC,CAAC;IAED,UAAU,CAAC,gBAAgB,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC;IAChD,OAAO,GAAG,EAAE,CAAC,UAAU,CAAC,mBAAmB,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC;AAClE,CAAC;AAED,SAAS,UAAU;IACjB,OAAO,KAAK,CAAC;AACf,CAAC"}

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

@@ -2,9 +2,18 @@ import type { CitationFormatId } from './formats.ts';
 import type { Reference } from './reference.ts';
 import type { CitationStyleId } from './segments.ts';
 /**
- * Put a reference on the clipboard. HTML goes on in both flavours, so a paste
- * into Word or Google Docs keeps the emphasis of the style while a plain text
- * editor still receives a readable line rather than the markup.
+ * Put every reference a site asks for on the clipboard, in one value. HTML goes
+ * on in both flavours, so a paste into Word or Google Docs keeps the emphasis of
+ * the style while a plain text editor still receives readable lines rather than
+ * the markup.
+ * @param references - References to copy, in reading order.
+ * @param format - Format to copy them in.
+ * @param style - Journal style, for the formats that have one.
+ * @returns Resolves once the clipboard holds the citations.
+ */
+export declare function copyCitations(references: readonly Reference[], format: CitationFormatId, style?: CitationStyleId): Promise<void>;
+/**
+ * Put one reference on the clipboard.
  * @param reference - Reference to copy.
  * @param format - Format to copy it in.
  * @param style - Journal style, for the formats that have one.

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

@@ -1 +1 @@
-{"version":3,"file":"clipboard.d.ts","sourceRoot":"","sources":["../../../src/citation/core/clipboard.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAErD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAChD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAErD;;;;;;;;GAQG;AACH,wBAAgB,YAAY,CAC1B,SAAS,EAAE,SAAS,EACpB,MAAM,EAAE,gBAAgB,EACxB,KAAK,CAAC,EAAE,eAAe,GACtB,OAAO,CAAC,IAAI,CAAC,CAaf"}
+{"version":3,"file":"clipboard.d.ts","sourceRoot":"","sources":["../../../src/citation/core/clipboard.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AACrD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAChD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAGrD;;;;;;;;;GASG;AACH,wBAAgB,aAAa,CAC3B,UAAU,EAAE,SAAS,SAAS,EAAE,EAChC,MAAM,EAAE,gBAAgB,EACxB,KAAK,CAAC,EAAE,eAAe,GACtB,OAAO,CAAC,IAAI,CAAC,CAaf;AAED;;;;;;GAMG;AACH,wBAAgB,YAAY,CAC1B,SAAS,EAAE,SAAS,EACpB,MAAM,EAAE,gBAAgB,EACxB,KAAK,CAAC,EAAE,eAAe,GACtB,OAAO,CAAC,IAAI,CAAC,CAEf"}

package/lib/citation/core/clipboard.js

@@ -1,25 +1,36 @@
-import { formatCitation } from "./formats.js";
+import { formatCitations } from "./works.js";
 /**
- * Put a reference on the clipboard. HTML goes on in both flavours, so a paste
- * into Word or Google Docs keeps the emphasis of the style while a plain text
- * editor still receives a readable line rather than the markup.
- * @param reference - Reference to copy.
- * @param format - Format to copy it in.
+ * Put every reference a site asks for on the clipboard, in one value. HTML goes
+ * on in both flavours, so a paste into Word or Google Docs keeps the emphasis of
+ * the style while a plain text editor still receives readable lines rather than
+ * the markup.
+ * @param references - References to copy, in reading order.
+ * @param format - Format to copy them in.
  * @param style - Journal style, for the formats that have one.
- * @returns Resolves once the clipboard holds the citation.
+ * @returns Resolves once the clipboard holds the citations.
  */
-export function copyCitation(reference, format, style) {
-    const value = formatCitation(reference, format, style);
+export function copyCitations(references, format, style) {
+    const value = formatCitations(references, format, style);
     if (format !== 'html' || typeof ClipboardItem === 'undefined') {
         return navigator.clipboard.writeText(value);
     }
     return navigator.clipboard.write([
         new ClipboardItem({
             'text/html': new Blob([value], { type: 'text/html' }),
-            'text/plain': new Blob([formatCitation(reference, 'text', style)], {
+            'text/plain': new Blob([formatCitations(references, 'text', style)], {
                 type: 'text/plain',
             }),
         }),
     ]);
 }
+/**
+ * Put one reference on the clipboard.
+ * @param reference - Reference to copy.
+ * @param format - Format to copy it in.
+ * @param style - Journal style, for the formats that have one.
+ * @returns Resolves once the clipboard holds the citation.
+ */
+export function copyCitation(reference, format, style) {
+    return copyCitations([reference], format, style);
+}
 //# sourceMappingURL=clipboard.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"clipboard.js","sourceRoot":"","sources":["../../../src/citation/core/clipboard.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAI9C;;;;;;;;GAQG;AACH,MAAM,UAAU,YAAY,CAC1B,SAAoB,EACpB,MAAwB,EACxB,KAAuB;IAEvB,MAAM,KAAK,GAAG,cAAc,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,CAAC,CAAC;IACvD,IAAI,MAAM,KAAK,MAAM,IAAI,OAAO,aAAa,KAAK,WAAW,EAAE,CAAC;QAC9D,OAAO,SAAS,CAAC,SAAS,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;IAC9C,CAAC;IACD,OAAO,SAAS,CAAC,SAAS,CAAC,KAAK,CAAC;QAC/B,IAAI,aAAa,CAAC;YAChB,WAAW,EAAE,IAAI,IAAI,CAAC,CAAC,KAAK,CAAC,EAAE,EAAE,IAAI,EAAE,WAAW,EAAE,CAAC;YACrD,YAAY,EAAE,IAAI,IAAI,CAAC,CAAC,cAAc,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,CAAC,CAAC,EAAE;gBACjE,IAAI,EAAE,YAAY;aACnB,CAAC;SACH,CAAC;KACH,CAAC,CAAC;AACL,CAAC"}
+{"version":3,"file":"clipboard.js","sourceRoot":"","sources":["../../../src/citation/core/clipboard.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAE7C;;;;;;;;;GASG;AACH,MAAM,UAAU,aAAa,CAC3B,UAAgC,EAChC,MAAwB,EACxB,KAAuB;IAEvB,MAAM,KAAK,GAAG,eAAe,CAAC,UAAU,EAAE,MAAM,EAAE,KAAK,CAAC,CAAC;IACzD,IAAI,MAAM,KAAK,MAAM,IAAI,OAAO,aAAa,KAAK,WAAW,EAAE,CAAC;QAC9D,OAAO,SAAS,CAAC,SAAS,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;IAC9C,CAAC;IACD,OAAO,SAAS,CAAC,SAAS,CAAC,KAAK,CAAC;QAC/B,IAAI,aAAa,CAAC;YAChB,WAAW,EAAE,IAAI,IAAI,CAAC,CAAC,KAAK,CAAC,EAAE,EAAE,IAAI,EAAE,WAAW,EAAE,CAAC;YACrD,YAAY,EAAE,IAAI,IAAI,CAAC,CAAC,eAAe,CAAC,UAAU,EAAE,MAAM,EAAE,KAAK,CAAC,CAAC,EAAE;gBACnE,IAAI,EAAE,YAAY;aACnB,CAAC;SACH,CAAC;KACH,CAAC,CAAC;AACL,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,YAAY,CAC1B,SAAoB,EACpB,MAAwB,EACxB,KAAuB;IAEvB,OAAO,aAAa,CAAC,CAAC,SAAS,CAAC,EAAE,MAAM,EAAE,KAAK,CAAC,CAAC;AACnD,CAAC"}

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

@@ -1,9 +1,17 @@
 import type { CitationDownload } from './formats.ts';
 import type { Reference } from './reference.ts';
 /**
- * Save the reference as the file a reference manager imports. The MIME type
- * is the one Zotero, Mendeley and EndNote recognise, so opening the saved
- * file hands it to whichever of them is installed.
+ * Save every reference a site asks for as the one file a reference manager
+ * imports — both formats hold several entries, so a site asking for two works
+ * hands out one file with both. The MIME type is the one Zotero, Mendeley and
+ * EndNote recognise, so opening the saved file hands it to whichever of them is
+ * installed.
+ * @param references - References to save, in reading order.
+ * @param download - File to write, from `CITATION_DOWNLOADS`.
+ */
+export declare function downloadCitations(references: readonly Reference[], download: CitationDownload): void;
+/**
+ * Save one reference as the file a reference manager imports.
  * @param reference - Reference to save.
  * @param download - File to write, from `CITATION_DOWNLOADS`.
  */

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

@@ -1 +1 @@
-{"version":3,"file":"download.d.ts","sourceRoot":"","sources":["../../../src/citation/core/download.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAErD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAEhD;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAC9B,SAAS,EAAE,SAAS,EACpB,QAAQ,EAAE,gBAAgB,GACzB,IAAI,CAYN"}
+{"version":3,"file":"download.d.ts","sourceRoot":"","sources":["../../../src/citation/core/download.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AACrD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAGhD;;;;;;;;GAQG;AACH,wBAAgB,iBAAiB,CAC/B,UAAU,EAAE,SAAS,SAAS,EAAE,EAChC,QAAQ,EAAE,gBAAgB,GACzB,IAAI,CAMN;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAC9B,SAAS,EAAE,SAAS,EACpB,QAAQ,EAAE,gBAAgB,GACzB,IAAI,CAEN"}

package/lib/citation/core/download.js

@@ -1,20 +1,24 @@
-import { citationFilename, formatCitation } from "./formats.js";
+import { downloadBlob } from "../../download/core/downloadBlob.js";
+import { citationsFilename, formatCitations } from "./works.js";
 /**
- * Save the reference as the file a reference manager imports. The MIME type
- * is the one Zotero, Mendeley and EndNote recognise, so opening the saved
- * file hands it to whichever of them is installed.
+ * Save every reference a site asks for as the one file a reference manager
+ * imports — both formats hold several entries, so a site asking for two works
+ * hands out one file with both. The MIME type is the one Zotero, Mendeley and
+ * EndNote recognise, so opening the saved file hands it to whichever of them is
+ * installed.
+ * @param references - References to save, in reading order.
+ * @param download - File to write, from `CITATION_DOWNLOADS`.
+ */
+export function downloadCitations(references, download) {
+    const content = formatCitations(references, download.format);
+    downloadBlob(new Blob([content], { type: download.mimeType }), citationsFilename(references, download.extension));
+}
+/**
+ * Save one reference as the file a reference manager imports.
  * @param reference - Reference to save.
  * @param download - File to write, from `CITATION_DOWNLOADS`.
  */
 export function downloadCitation(reference, download) {
-    const content = formatCitation(reference, download.format);
-    const url = URL.createObjectURL(new Blob([content], { type: download.mimeType }));
-    const anchor = document.createElement('a');
-    anchor.href = url;
-    anchor.download = citationFilename(reference, download.extension);
-    document.body.append(anchor);
-    anchor.click();
-    anchor.remove();
-    URL.revokeObjectURL(url);
+    downloadCitations([reference], download);
 }
 //# sourceMappingURL=download.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"download.js","sourceRoot":"","sources":["../../../src/citation/core/download.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,gBAAgB,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAGhE;;;;;;GAMG;AACH,MAAM,UAAU,gBAAgB,CAC9B,SAAoB,EACpB,QAA0B;IAE1B,MAAM,OAAO,GAAG,cAAc,CAAC,SAAS,EAAE,QAAQ,CAAC,MAAM,CAAC,CAAC;IAC3D,MAAM,GAAG,GAAG,GAAG,CAAC,eAAe,CAC7B,IAAI,IAAI,CAAC,CAAC,OAAO,CAAC,EAAE,EAAE,IAAI,EAAE,QAAQ,CAAC,QAAQ,EAAE,CAAC,CACjD,CAAC;IACF,MAAM,MAAM,GAAG,QAAQ,CAAC,aAAa,CAAC,GAAG,CAAC,CAAC;IAC3C,MAAM,CAAC,IAAI,GAAG,GAAG,CAAC;IAClB,MAAM,CAAC,QAAQ,GAAG,gBAAgB,CAAC,SAAS,EAAE,QAAQ,CAAC,SAAS,CAAC,CAAC;IAClE,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;IAC7B,MAAM,CAAC,KAAK,EAAE,CAAC;IACf,MAAM,CAAC,MAAM,EAAE,CAAC;IAChB,GAAG,CAAC,eAAe,CAAC,GAAG,CAAC,CAAC;AAC3B,CAAC"}
+{"version":3,"file":"download.js","sourceRoot":"","sources":["../../../src/citation/core/download.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,qCAAqC,CAAC;AAInE,OAAO,EAAE,iBAAiB,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAEhE;;;;;;;;GAQG;AACH,MAAM,UAAU,iBAAiB,CAC/B,UAAgC,EAChC,QAA0B;IAE1B,MAAM,OAAO,GAAG,eAAe,CAAC,UAAU,EAAE,QAAQ,CAAC,MAAM,CAAC,CAAC;IAC7D,YAAY,CACV,IAAI,IAAI,CAAC,CAAC,OAAO,CAAC,EAAE,EAAE,IAAI,EAAE,QAAQ,CAAC,QAAQ,EAAE,CAAC,EAChD,iBAAiB,CAAC,UAAU,EAAE,QAAQ,CAAC,SAAS,CAAC,CAClD,CAAC;AACJ,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,gBAAgB,CAC9B,SAAoB,EACpB,QAA0B;IAE1B,iBAAiB,CAAC,CAAC,SAAS,CAAC,EAAE,QAAQ,CAAC,CAAC;AAC3C,CAAC"}

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

@@ -1,10 +1,11 @@
-export { copyCitation } from './clipboard.ts';
-export { downloadCitation } from './download.ts';
+export { copyCitation, copyCitations } from './clipboard.ts';
+export { downloadCitation, downloadCitations } from './download.ts';
 export type { CitationDownload, CitationFormat, CitationFormatId, } from './formats.ts';
 export { CITATION_DOWNLOADS, CITATION_FORMATS, DEFAULT_CITATION_STYLE, citationFilename, formatCitation, } from './formats.ts';
 export type { Reference, ReferenceAuthor } from './reference.ts';
 export { doiUrl } from './reference.ts';
-export { renderHtml, renderMarkdown, renderText } from './render.ts';
 export type { CitationSegment, CitationStyle, CitationStyleId, } from './segments.ts';
 export { CITATION_STYLES, citationSegments } from './segments.ts';
+export type { CitedWork } from './works.ts';
+export { citationsFilename, citedReferences, formatCitations, } from './works.ts';
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/citation/core/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC9C,OAAO,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AACjD,YAAY,EACV,gBAAgB,EAChB,cAAc,EACd,gBAAgB,GACjB,MAAM,cAAc,CAAC;AACtB,OAAO,EACL,kBAAkB,EAClB,gBAAgB,EAChB,sBAAsB,EACtB,gBAAgB,EAChB,cAAc,GACf,MAAM,cAAc,CAAC;AACtB,YAAY,EAAE,SAAS,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AACjE,OAAO,EAAE,MAAM,EAAE,MAAM,gBAAgB,CAAC;AACxC,OAAO,EAAE,UAAU,EAAE,cAAc,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACrE,YAAY,EACV,eAAe,EACf,aAAa,EACb,eAAe,GAChB,MAAM,eAAe,CAAC;AACvB,OAAO,EAAE,eAAe,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/citation/core/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAC7D,OAAO,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AACpE,YAAY,EACV,gBAAgB,EAChB,cAAc,EACd,gBAAgB,GACjB,MAAM,cAAc,CAAC;AACtB,OAAO,EACL,kBAAkB,EAClB,gBAAgB,EAChB,sBAAsB,EACtB,gBAAgB,EAChB,cAAc,GACf,MAAM,cAAc,CAAC;AACtB,YAAY,EAAE,SAAS,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AACjE,OAAO,EAAE,MAAM,EAAE,MAAM,gBAAgB,CAAC;AACxC,YAAY,EACV,eAAe,EACf,aAAa,EACb,eAAe,GAChB,MAAM,eAAe,CAAC;AACvB,OAAO,EAAE,eAAe,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AAClE,YAAY,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAC5C,OAAO,EACL,iBAAiB,EACjB,eAAe,EACf,eAAe,GAChB,MAAM,YAAY,CAAC"}

package/lib/citation/core/index.js

@@ -1,7 +1,7 @@
-export { copyCitation } from "./clipboard.js";
-export { downloadCitation } from "./download.js";
+export { copyCitation, copyCitations } from "./clipboard.js";
+export { downloadCitation, downloadCitations } from "./download.js";
 export { CITATION_DOWNLOADS, CITATION_FORMATS, DEFAULT_CITATION_STYLE, citationFilename, formatCitation, } from "./formats.js";
 export { doiUrl } from "./reference.js";
-export { renderHtml, renderMarkdown, renderText } from "./render.js";
 export { CITATION_STYLES, citationSegments } from "./segments.js";
+export { citationsFilename, citedReferences, formatCitations, } from "./works.js";
 //# sourceMappingURL=index.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/citation/core/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC9C,OAAO,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AAMjD,OAAO,EACL,kBAAkB,EAClB,gBAAgB,EAChB,sBAAsB,EACtB,gBAAgB,EAChB,cAAc,GACf,MAAM,cAAc,CAAC;AAEtB,OAAO,EAAE,MAAM,EAAE,MAAM,gBAAgB,CAAC;AACxC,OAAO,EAAE,UAAU,EAAE,cAAc,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAMrE,OAAO,EAAE,eAAe,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/citation/core/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAC7D,OAAO,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAMpE,OAAO,EACL,kBAAkB,EAClB,gBAAgB,EAChB,sBAAsB,EACtB,gBAAgB,EAChB,cAAc,GACf,MAAM,cAAc,CAAC;AAEtB,OAAO,EAAE,MAAM,EAAE,MAAM,gBAAgB,CAAC;AAMxC,OAAO,EAAE,eAAe,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AAElE,OAAO,EACL,iBAAiB,EACjB,eAAe,EACf,eAAe,GAChB,MAAM,YAAY,CAAC"}

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

@@ -0,0 +1,44 @@
+import type { CitationFormatId } from './formats.ts';
+import type { Reference } from './reference.ts';
+import type { CitationStyleId } from './segments.ts';
+/**
+ * One of the works a site asks to be cited, with the words that say which part
+ * of the site it covers: a reader handed two references has to be told what is
+ * what before they can pick one.
+ */
+export interface CitedWork {
+    /** The bibliographic record. */
+    reference: Reference;
+    /** What the work is, in a few words, e.g. `The isomer generator`. */
+    what: string;
+    /**
+     * One sentence saying what citing it credits, read under `what`.
+     * @default undefined
+     */
+    note?: string;
+}
+/**
+ * The references of a list of works, in the order the site names them.
+ * @param works - The works being cited.
+ * @returns Their bibliographic records.
+ */
+export declare function citedReferences(works: readonly CitedWork[]): Reference[];
+/**
+ * Render several references in one of the citation formats, as the one value a
+ * paste or a saved file holds: an RIS or BibTeX file takes every entry, and a
+ * written citation takes one reference per line.
+ * @param references - References to render, in reading order.
+ * @param format - Format to render them in.
+ * @param style - Journal style, for the formats that have one.
+ * @returns The citations, ready to be copied to the clipboard or saved.
+ */
+export declare function formatCitations(references: readonly Reference[], format: CitationFormatId, style?: CitationStyleId): string;
+/**
+ * Name the saved file carries: the author and the year of the work when there
+ * is one, and a plain `references` when the site asks for several.
+ * @param references - References the file holds.
+ * @param extension - Extension of the file, without its dot.
+ * @returns The file name.
+ */
+export declare function citationsFilename(references: readonly Reference[], extension: string): string;
+//# sourceMappingURL=works.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"works.d.ts","sourceRoot":"","sources":["../../../src/citation/core/works.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAErD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAChD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAErD;;;;GAIG;AACH,MAAM,WAAW,SAAS;IACxB,gCAAgC;IAChC,SAAS,EAAE,SAAS,CAAC;IACrB,qEAAqE;IACrE,IAAI,EAAE,MAAM,CAAC;IACb;;;OAGG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAkBD;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,SAAS,SAAS,EAAE,GAAG,SAAS,EAAE,CAExE;AAED;;;;;;;;GAQG;AACH,wBAAgB,eAAe,CAC7B,UAAU,EAAE,SAAS,SAAS,EAAE,EAChC,MAAM,EAAE,gBAAgB,EACxB,KAAK,CAAC,EAAE,eAAe,GACtB,MAAM,CAIR;AAED;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAC/B,UAAU,EAAE,SAAS,SAAS,EAAE,EAChC,SAAS,EAAE,MAAM,GAChB,MAAM,CAIR"}

package/lib/citation/core/works.js

@@ -0,0 +1,51 @@
+import { citationFilename, formatCitation } from "./formats.js";
+/**
+ * What separates two citations written at once: a line for the formats that
+ * read as a list, a blank line for the ones whose entries are paragraphs.
+ */
+const SEPARATORS = {
+    text: '\n',
+    html: '<br>',
+    markdown: '\n\n',
+    bibtex: '\n\n',
+    ris: '\n',
+    doi: '\n',
+};
+/** What the file holding several references is called, before its extension. */
+const SET_FILENAME = 'references';
+/**
+ * The references of a list of works, in the order the site names them.
+ * @param works - The works being cited.
+ * @returns Their bibliographic records.
+ */
+export function citedReferences(works) {
+    return works.map((work) => work.reference);
+}
+/**
+ * Render several references in one of the citation formats, as the one value a
+ * paste or a saved file holds: an RIS or BibTeX file takes every entry, and a
+ * written citation takes one reference per line.
+ * @param references - References to render, in reading order.
+ * @param format - Format to render them in.
+ * @param style - Journal style, for the formats that have one.
+ * @returns The citations, ready to be copied to the clipboard or saved.
+ */
+export function formatCitations(references, format, style) {
+    return references
+        .map((reference) => formatCitation(reference, format, style))
+        .join(SEPARATORS[format]);
+}
+/**
+ * Name the saved file carries: the author and the year of the work when there
+ * is one, and a plain `references` when the site asks for several.
+ * @param references - References the file holds.
+ * @param extension - Extension of the file, without its dot.
+ * @returns The file name.
+ */
+export function citationsFilename(references, extension) {
+    const only = references.length === 1 ? references[0] : undefined;
+    if (only === undefined)
+        return `${SET_FILENAME}.${extension}`;
+    return citationFilename(only, extension);
+}
+//# sourceMappingURL=works.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"works.js","sourceRoot":"","sources":["../../../src/citation/core/works.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,gBAAgB,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAqBhE;;;GAGG;AACH,MAAM,UAAU,GAAqC;IACnD,IAAI,EAAE,IAAI;IACV,IAAI,EAAE,MAAM;IACZ,QAAQ,EAAE,MAAM;IAChB,MAAM,EAAE,MAAM;IACd,GAAG,EAAE,IAAI;IACT,GAAG,EAAE,IAAI;CACV,CAAC;AAEF,gFAAgF;AAChF,MAAM,YAAY,GAAG,YAAY,CAAC;AAElC;;;;GAIG;AACH,MAAM,UAAU,eAAe,CAAC,KAA2B;IACzD,OAAO,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;AAC7C,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,eAAe,CAC7B,UAAgC,EAChC,MAAwB,EACxB,KAAuB;IAEvB,OAAO,UAAU;SACd,GAAG,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,cAAc,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,CAAC,CAAC;SAC5D,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC;AAC9B,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,iBAAiB,CAC/B,UAAgC,EAChC,SAAiB;IAEjB,MAAM,IAAI,GAAG,UAAU,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;IACjE,IAAI,IAAI,KAAK,SAAS;QAAE,OAAO,GAAG,YAAY,IAAI,SAAS,EAAE,CAAC;IAC9D,OAAO,gBAAgB,CAAC,IAAI,EAAE,SAAS,CAAC,CAAC;AAC3C,CAAC"}

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

@@ -1,13 +1,30 @@
 import type { ReactElement } from 'react';
 import type { Reference } from '../core/reference.ts';
-export interface CitationMenuProps {
+import type { CitedWork } from '../core/works.ts';
+/** What a site asks to be cited when it is one work. */
+export interface CitedReferenceProps {
     /** The work being cited. */
     reference: Reference;
 }
+/** What a site asks to be cited when it is built on several works. */
+export interface CitedWorksProps {
+    /** The works being cited, in the order the site names them. */
+    works: readonly CitedWork[];
+    /**
+     * The line heading the menu, saying which of the works a reader is expected
+     * to cite.
+     * @default 'Please cite both works', or 'Please cite every work' past two
+     */
+    guidance?: string;
+}
+export type CitationMenuProps = CitedReferenceProps | CitedWorksProps;
 /**
  * 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.
+ * the style a journal asks for, and the files a reference manager imports. A
+ * site built on several works lists them all, each behind what citing it
+ * credits, and the copy and download entries then carry every reference at
+ * once.
+ * @param props - The work, or the works, being cited.
  * @returns The citation menu.
  */
 export declare function CitationMenu(props: CitationMenuProps): ReactElement;

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

@@ -1 +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"}
+{"version":3,"file":"CitationMenu.d.ts","sourceRoot":"","sources":["../../../src/citation/ui/CitationMenu.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAiB,YAAY,EAAE,MAAM,OAAO,CAAC;AAGzD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AAEtD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAalD,wDAAwD;AACxD,MAAM,WAAW,mBAAmB;IAClC,4BAA4B;IAC5B,SAAS,EAAE,SAAS,CAAC;CACtB;AAED,sEAAsE;AACtE,MAAM,WAAW,eAAe;IAC9B,+DAA+D;IAC/D,KAAK,EAAE,SAAS,SAAS,EAAE,CAAC;IAC5B;;;;OAIG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,MAAM,iBAAiB,GAAG,mBAAmB,GAAG,eAAe,CAAC;AAEtE;;;;;;;;GAQG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,iBAAiB,GAAG,YAAY,CAYnE"}