react-cheminfo 0.10.0 → 0.12.0

package/README.md

@@ -45,7 +45,10 @@ A backend serving an RIS endpoint, a prerender script writing a sitemap, and
 every unit test of that logic therefore load no React at all — and a worker
 sampling an orbital loads neither React nor molstar. **Every peer is optional**,
 so a site that only wants the Tools menu downloads none of them, and a project
-that only prerenders installs neither React nor Vite.
+that only prerenders installs neither React nor Vite. The Markdown stack of the
+slides (`react-markdown`, `rehype-raw`, `rehype-sanitize`, about 9 MB installed)
+is a regular dependency instead: it is small enough to always install, and a
+site that never imports `react-cheminfo/slides` bundles none of it.
 
 `react-cheminfo/vite` is the one door with a split bill: `cheminfoPrerender`
 needs nothing beyond Vite's own plugin type, while `ogCardHtml` renders a mark
@@ -57,27 +60,27 @@ through a wildcard subpath exactly as `react-science` serves its own.
 
 ## What is in it
 
-| Area                    | `…/core`                                                                                                                                                                                                                      | `…/ui`                                                                                                                                                                                  |
-| ----------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
-| **Site identity**       | `siteById`, `findSiteByHost`, `siteTokensCss`, `siteThemeColor`, `renderEcosystemLinksHtml`                                                                                                                                   | `SiteMark`, `Wordmark`, `SiteTheme`, `SiteTile`, `EcosystemButton`, `EcosystemLinks`                                                                                                    |
-| **Chrome**              | —                                                                                                                                                                                                                             | `SiteHeader`, `SiteFooter`, `NavLink`, `NavMenuButton`, `MenuButton`, `useCompactHeader`                                                                                                |
-| **Citation**            | `formatCitation`, `formatCitations`, `citationSegments`, `downloadCitation`, `citedReferences`, `doiUrl`                                                                                                                      | `CiteButton`, `CitationMenu`, `CitationPreview`                                                                                                                                         |
-| **Share & embed**       | `parseShareConfig`, `applyShareConfig`, `buildShareUrl`, `buildEmbedCode`, `isHidden`, the param codecs                                                                                                                       | `ShareDialog`, `ShareButton`, `HiddenPartsProvider`, `PagePart`, `useIsHidden`                                                                                                          |
-| **Routing & head**      | `createTabRouter`, `createPageAddresses`, `adoptLegacyHashAddress`, `writeDocumentMeta`, `canonicalLink`                                                                                                                      | —                                                                                                                                                                                       |
-| **Indexing**            | `injectPageMeta`, `pageHeadTags`, `pageDocumentMeta`, `fill`, `PAGE_HEAD_MARKER`, `PAGE_BODY_MARKER`, `robotsTxt`, `sitemapXml`, `noscriptIndex`, `structuredDataScript`, `assertRoutes`, `routeFor`, `homeRoute`             | `cheminfoPrerender`, `ogCardHtml`, `OG_WIDTH`, `OG_HEIGHT` (all `/vite`)                                                                                                                |
-| **Pedagogy**            | `parseGlossaryMarkers`, `localStorageProgressStore`, `progressSummary`, `finishValidation`                                                                                                                                    | `GlossaryText`, `SyntaxTooltip`, `HintLadder`, `ExerciseActions`, `ExerciseProgressHeader`, `TutorialStepStrip`, `ReferenceGrid`, `TestCaseList`                                        |
-| **Clipboard & files**   | `writeToClipboard`, `downloadBlob`, `downloadText`, `sanitizeFileName`, `toDelimited`, `readDelimited`, `downloadFigure`, `figureSvg`, `figurePng`, `figureSize`                                                              | `CopyButton`, `CodeBlock`, `DelimitedTextDialog`, `FigureDownload`                                                                                                                      |
-| **Formatting & colour** | `formatInteger`, `formatDecimal`, `formatBytes`, `pluralize`, `readableInk`, `contrastRatio`, `COLOR_SCALES`, `resolveColorScale`, `formatColorScale`, `colorAt`, `swatchAt`, `sampleScale`, `colorScaleGradient`, `rgbToHsv` | `ColorScaleLegend`, `ColorScaleSelect`, `ColorScaleEditor`, `ColorScaleBar`                                                                                                             |
-| **Widgets**             | `CREDITS`, `credits`                                                                                                                                                                                                          | `ErrorBoundary`, `CollapsibleSection`, `CapsuleFilter`, `HelpTooltip`, `CreditsList`                                                                                                    |
-| **Hooks & state**       | `createWorkerChannel`                                                                                                                                                                                                         | `persistBucket`, `useDebouncedValue`, `useContainerSize`, `useListKeyboardNavigation`, `useDisclosure`                                                                                  |
-| **Chemistry**           | `atomicOrbitalsOf`, `configurationOf`, `classifyMolfile`, `readStructure`                                                                                                                                                     | `AtomicOrbitalViewer` (`/orbital`), `StructureEditor`, `Structure` (`/structure`)                                                                                                       |
-| **Spectra**             | `FILTER_CATALOG`, `filterMenu`, `settingsProblems`, `normalizationFilters`, `addFilter`, `moveFilter`, `setFilterOption`, `principalComponentChoices`, `clampPrincipalComponents`, `EMPTY_SETTINGS`                           | `SpectraSettingsEditor`, `FilterChainEditor`, `PrincipalComponentSelect`                                                                                                                |
-| **About**               | `resolveAbout`, `aboutProblems`                                                                                                                                                                                               | `AboutPage`                                                                                                                                                                             |
-| **Slideshows**          | `parseTalk`, `splitDemoLinks`, `slideActionForKey`, `parseTalkOrigin`, `buildTalkManifest` (all `/slides`)                                                                                                                    | `Slideshow`, `SlideView`, `TalkList`, `BackToSlides` (all `/slides`), `cheminfoTalks` (`/vite`)                                                                                         |
-| **Token guard**         | `findTokenViolations`                                                                                                                                                                                                         | `cheminfo-check-tokens` (the bin)                                                                                                                                                       |
-| **Figures**             | `chartScale`, `chartAxisScale`, `chartAxisTitle`, `chartShare`, `chartColumnExtent`, `chartBinCounts`, `chartSeriesColor`, `rowMatrix`, `stackedMatrix`, `emptiestCorner`, `placeOverlayCard`, `overlayMetrics`               | `ChartFrame`, `ChartAxis`, `TrackedLineChart`, `OverlayBar`, `OverlaySelect`, `OverlaySegmented`, `OverlayToggle`, `OverlayNumber`, `OverlayLegend`, `OverlayCaption`, `OverlayReadout` |
-| **Projections**         | `pcaResult`, `embeddingResult`, `projectionTabs`, `loadingProfiles`, `explainedShares`, `confidenceEllipse`, `projectEllipse`, `pointsInPolygon`, `resolveProjectionGroups`, `PROJECTION_COPY`                                | `PcaViewer`, `ProjectionViewer`, `ScatterPlot`, `ScatterMatrix`                                                                                                                         |
-| **Periodic table**      | `PERIODIC_ELEMENTS`, `elementBySymbol`, `elementByAtomicNumber`, `cellOf`, `placedElements`, `elementByArrowKey`, `categorySwatch`, `CATEGORY_LABELS`                                                                         | `PeriodicTable`, `ElementCell`, `CategoryLegend`                                                                                                                                        |
+| Area                    | `…/core`                                                                                                                                                                                                                                                | `…/ui`                                                                                                                                                                                  |
+| ----------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| **Site identity**       | `siteById`, `findSiteByHost`, `siteTokensCss`, `siteThemeColor`, `renderEcosystemLinksHtml`                                                                                                                                                             | `SiteMark`, `Wordmark`, `SiteTheme`, `SiteTile`, `EcosystemButton`, `EcosystemLinks`                                                                                                    |
+| **Chrome**              | —                                                                                                                                                                                                                                                       | `SiteHeader`, `SiteFooter`, `NavLink`, `NavMenuButton`, `MenuButton`, `useCompactHeader`                                                                                                |
+| **Citation**            | `formatCitation`, `formatCitations`, `citationSegments`, `downloadCitation`, `citedReferences`, `doiUrl`                                                                                                                                                | `CiteButton`, `CitationMenu`, `CitationPreview`                                                                                                                                         |
+| **Share & embed**       | `parseShareConfig`, `applyShareConfig`, `buildShareUrl`, `buildEmbedCode`, `isHidden`, `visibleShareParts`, `applySharePreset`, `findSharePreset`, the param codecs, `syncPreferencesWithUrl`, `applyPreferencesFromSearch`, `writePreferencesToSearch` | `ShareDialog`, `ShareButton`, `HiddenPartsProvider`, `PagePart`, `useIsHidden`                                                                                                          |
+| **Routing & head**      | `createTabRouter`, `createPageAddresses`, `adoptLegacyHashAddress`, `writeDocumentMeta`, `canonicalLink`                                                                                                                                                | —                                                                                                                                                                                       |
+| **Indexing**            | `injectPageMeta`, `pageHeadTags`, `pageDocumentMeta`, `fill`, `PAGE_HEAD_MARKER`, `PAGE_BODY_MARKER`, `robotsTxt`, `sitemapXml`, `noscriptIndex`, `structuredDataScript`, `assertRoutes`, `routeFor`, `homeRoute`                                       | `cheminfoPrerender`, `ogCardHtml`, `OG_WIDTH`, `OG_HEIGHT` (all `/vite`)                                                                                                                |
+| **Pedagogy**            | `parseGlossaryMarkers`, `localStorageProgressStore`, `progressSummary`, `finishValidation`                                                                                                                                                              | `GlossaryText`, `SyntaxTooltip`, `HintLadder`, `ExerciseActions`, `ExerciseProgressHeader`, `TutorialStepStrip`, `ReferenceGrid`, `TestCaseList`                                        |
+| **Clipboard & files**   | `writeToClipboard`, `downloadBlob`, `downloadText`, `sanitizeFileName`, `toDelimited`, `readDelimited`, `downloadFigure`, `figureSvg`, `figurePng`, `figureSize`                                                                                        | `CopyButton`, `CodeBlock`, `DelimitedTextDialog`, `FigureDownload`                                                                                                                      |
+| **Formatting & colour** | `formatInteger`, `formatDecimal`, `formatBytes`, `pluralize`, `readableInk`, `contrastRatio`, `COLOR_SCALES`, `resolveColorScale`, `formatColorScale`, `colorAt`, `swatchAt`, `sampleScale`, `colorScaleGradient`, `rgbToHsv`                           | `ColorScaleLegend`, `ColorScaleSelect`, `ColorScaleEditor`, `ColorScaleBar`                                                                                                             |
+| **Widgets**             | `CREDITS`, `credits`                                                                                                                                                                                                                                    | `ErrorBoundary`, `CollapsibleSection`, `CapsuleFilter`, `HelpTooltip`, `CreditsList`                                                                                                    |
+| **Hooks & state**       | `createWorkerChannel`                                                                                                                                                                                                                                   | `persistBucket`, `useDebouncedValue`, `useContainerSize`, `useListKeyboardNavigation`, `useDisclosure`                                                                                  |
+| **Chemistry**           | `atomicOrbitalsOf`, `configurationOf`, `classifyMolfile`, `readStructure`                                                                                                                                                                               | `AtomicOrbitalViewer` (`/orbital`), `StructureEditor`, `Structure` (`/structure`)                                                                                                       |
+| **Spectra**             | `FILTER_CATALOG`, `filterMenu`, `settingsProblems`, `normalizationFilters`, `addFilter`, `moveFilter`, `setFilterOption`, `principalComponentChoices`, `clampPrincipalComponents`, `EMPTY_SETTINGS`                                                     | `SpectraSettingsEditor`, `FilterChainEditor`, `PrincipalComponentSelect`                                                                                                                |
+| **About**               | `resolveAbout`, `aboutProblems`                                                                                                                                                                                                                         | `AboutPage`                                                                                                                                                                             |
+| **Slideshows**          | `parseTalk`, `splitDemoLinks`, `slideActionForKey`, `parseTalkOrigin`, `buildTalkManifest` (all `/slides`)                                                                                                                                              | `Slideshow`, `SlideView`, `TalkList`, `BackToSlides` (all `/slides`), `cheminfoTalks` (`/vite`)                                                                                         |
+| **Token guard**         | `findTokenViolations`                                                                                                                                                                                                                                   | `cheminfo-check-tokens` (the bin)                                                                                                                                                       |
+| **Figures**             | `chartScale`, `chartAxisScale`, `chartAxisTitle`, `chartShare`, `chartColumnExtent`, `chartBinCounts`, `chartSeriesColor`, `rowMatrix`, `stackedMatrix`, `emptiestCorner`, `placeOverlayCard`, `overlayMetrics`                                         | `ChartFrame`, `ChartAxis`, `TrackedLineChart`, `OverlayBar`, `OverlaySelect`, `OverlaySegmented`, `OverlayToggle`, `OverlayNumber`, `OverlayLegend`, `OverlayCaption`, `OverlayReadout` |
+| **Projections**         | `pcaResult`, `embeddingResult`, `projectionTabs`, `loadingProfiles`, `explainedShares`, `confidenceEllipse`, `projectEllipse`, `pointsInPolygon`, `resolveProjectionGroups`, `PROJECTION_COPY`                                                          | `PcaViewer`, `ProjectionViewer`, `ScatterPlot`, `ScatterMatrix`                                                                                                                         |
+| **Periodic table**      | `PERIODIC_ELEMENTS`, `elementBySymbol`, `elementByAtomicNumber`, `cellOf`, `placedElements`, `elementByArrowKey`, `categorySwatch`, `CATEGORY_LABELS`                                                                                                   | `PeriodicTable`, `ElementCell`, `CategoryLegend`                                                                                                                                        |
 
 Everything in that table is exported from `./core`, `./ui`, `./slides`,
 `./vite` or `./structure` and nothing else is: the sub-components a component is built

package/bin/check-deploy.mjs

@@ -0,0 +1,132 @@
+#!/usr/bin/env node
+/*
+ * Report every way a repository would break, or silently mis-deploy, under the
+ * server's global deploy script: a compose file it would not find, an image with
+ * no selectable tag, an `IMAGE_NAME` naming a package this repository never
+ * publishes, an `env_file` that fails on a checkout with no `.env` yet, a
+ * service with no health probe to read, an `.env.example` that hides a mode.
+ *
+ * Wire it as an npm script, next to check-tokens:
+ *   "check-deploy": "cheminfo-check-deploy"
+ *
+ * Usage: check-deploy.mjs [--image-name=ghcr.io/owner/repo] [--compose=a,b]
+ *                         [--foreign=prefix,prefix] [--no-healthcheck] [--quiet]
+ *   --image-name    the package this repo publishes; read from `git remote` when omitted
+ *   --compose       the compose files it ships, when not the three every site ships
+ *   --foreign       image prefixes built elsewhere, exempt from the tag rule
+ *   --no-healthcheck  the services are not expected to declare a healthcheck
+ *   --quiet         say nothing when the scan is clean
+ *
+ * Exits 1 when anything is reported, 2 when it was called wrongly, 0 otherwise.
+ */
+import { execFileSync } from 'node:child_process';
+import { readFileSync } from 'node:fs';
+import process from 'node:process';
+
+import {
+  DEPLOY_COMPOSE_FILES,
+  findDeployProblems,
+} from '../lib/deploy/core/index.js';
+
+import { countOf, listOption, usageError } from './cli.mjs';
+
+const TOOL = 'check-deploy';
+
+let imageName;
+let composeFiles;
+let foreignImages;
+let requireHealthcheck = true;
+let quiet = false;
+
+for (const argument of process.argv.slice(2)) {
+  if (argument.startsWith('--image-name=')) {
+    imageName = argument.slice('--image-name='.length);
+  } else if (argument.startsWith('--compose=')) {
+    composeFiles = listOption(argument.slice('--compose='.length));
+  } else if (argument.startsWith('--foreign=')) {
+    foreignImages = listOption(argument.slice('--foreign='.length));
+  } else if (argument === '--no-healthcheck') {
+    requireHealthcheck = false;
+  } else if (argument === '--quiet') {
+    quiet = true;
+  } else {
+    process.exit(usageError(TOOL, `unknown option: ${argument}`));
+  }
+}
+
+imageName ??= publishedImageName();
+if (imageName === undefined) {
+  process.exit(
+    usageError(
+      TOOL,
+      'no --image-name given and no github.com origin to read one from',
+    ),
+  );
+}
+
+// Every mode is read, present or not: a missing one is itself a problem.
+const expected = composeFiles ?? DEPLOY_COMPOSE_FILES;
+const files = [];
+for (const path of [...expected, '.env.example', '.gitignore']) {
+  const text = read(path);
+  if (text !== undefined) files.push({ path, text });
+}
+
+const problems = findDeployProblems(files, {
+  imageName,
+  composeFiles: expected,
+  foreignImages: foreignImages ?? ['cloudflare/cloudflared'],
+  requireHealthcheck,
+});
+
+if (problems.length > 0) {
+  let report = '';
+  for (const problem of problems) {
+    const where =
+      problem.line === 0 ? problem.file : `${problem.file}:${problem.line}`;
+    report += `${where}  ${problem.kind}  ${problem.message}\n    -> ${problem.hint}\n`;
+  }
+  report += `${countOf(problems.length, 'problem')} against the deployment contract\n`;
+  process.stdout.write(report);
+  process.exit(1);
+}
+if (!quiet) {
+  process.stdout.write(`the deployment contract holds for ${imageName}\n`);
+}
+
+/**
+ * The package this repository's own workflow publishes, read from the origin it
+ * was cloned from — the one thing a compose file cannot be checked against from
+ * inside itself.
+ * @returns {string | undefined} `ghcr.io/<owner>/<repo>`, or undefined when there is no origin.
+ */
+function publishedImageName() {
+  let url;
+  try {
+    url = execFileSync('git', ['remote', 'get-url', 'origin'], {
+      encoding: 'utf8',
+      stdio: ['ignore', 'pipe', 'ignore'],
+    }).trim();
+  } catch {
+    return undefined;
+  }
+  const match = /github\.com[:/](?<owner>[^/]+)\/(?<repo>.+?)(?:\.git)?$/.exec(
+    url,
+  );
+  if (match?.groups === undefined) return undefined;
+  return `ghcr.io/${match.groups.owner}/${match.groups.repo}`;
+}
+
+/**
+ * Read a file the repository may not have, because its absence is itself one of
+ * the things being reported.
+ * @param {string} path - What to read.
+ * @returns {string | undefined} Its text, or undefined when it is not there.
+ */
+function read(path) {
+  try {
+    return readFileSync(path, 'utf8');
+  } catch {
+    return undefined;
+  }
+}

package/bin/check-tokens.mjs

@@ -8,9 +8,10 @@
  * Wire it as an npm script:
  *   "check-tokens": "node node_modules/react-cheminfo/bin/check-tokens.mjs src"
  *
- * Usage: check-tokens.mjs [directory...] [--allow=#aabbcc,#ddeeff] [--quiet]
+ * Usage: check-tokens.mjs [directory...] [--allow=#aabbcc,#ddeeff] [--fallbacks] [--quiet]
  *   directory   what to walk, `src` when none is given
  *   --allow     colours the project legitimately owns
+ *   --fallbacks also read the fallback inside var(): a family token's must be its value
  *   --quiet     say nothing when the scan is clean
  *
  * Exits 1 when anything is reported, 2 when it was called wrongly, 0 otherwise.
@@ -21,23 +22,27 @@ import process from 'node:process';
 
 import { findTokenViolations } from '../lib/core.js';
 
+import { countOf, listOption, usageError } from './cli.mjs';
+
 const EXTENSIONS = new Set(['.css', '.ts', '.tsx', '.jsx', '.js']);
 const SKIPPED = new Set(['node_modules', 'dist', 'lib', 'coverage']);
 const ALLOW_PREFIX = '--allow=';
+const TOOL = 'check-tokens';
 
 const roots = [];
 const allow = [];
 let quiet = false;
+let fallbacks = false;
 
 for (const argument of process.argv.slice(2)) {
   if (argument.startsWith(ALLOW_PREFIX)) {
-    for (const colour of argument.slice(ALLOW_PREFIX.length).split(',')) {
-      if (colour.trim() !== '') allow.push(colour.trim());
-    }
+    allow.push(...listOption(argument.slice(ALLOW_PREFIX.length)));
   } else if (argument === '--quiet') {
     quiet = true;
+  } else if (argument === '--fallbacks') {
+    fallbacks = true;
   } else if (argument.startsWith('-')) {
-    fail(`unknown option: ${argument}`);
+    process.exit(usageError(TOOL, `unknown option: ${argument}`));
   } else {
     roots.push(argument);
   }
@@ -47,20 +52,20 @@ if (roots.length === 0) roots.push('src');
 const files = [];
 for (const root of roots) collect(root, files);
 
-const violations = findTokenViolations(files, { allow });
+const violations = findTokenViolations(files, { allow, fallbacks });
 let report = '';
 for (const violation of violations) {
   report += `${violation.file}:${violation.line}:${violation.column}  ${violation.kind}  ${violation.text}  -> ${violation.hint}\n`;
 }
 
 if (violations.length > 0) {
-  report += `${count(violations.length, 'violation')} in ${count(files.length, 'file')}\n`;
+  report += `${countOf(violations.length, 'violation')} in ${countOf(files.length, 'file')}\n`;
   process.stdout.write(report);
   process.exit(1);
 }
 if (!quiet) {
   process.stdout.write(
-    `no token violation in ${count(files.length, 'file')}\n`,
+    `no token violation in ${countOf(files.length, 'file')}\n`,
   );
 }
 
@@ -72,7 +77,9 @@ if (!quiet) {
  */
 function collect(path, files) {
   const stats = statSync(path, { throwIfNoEntry: false });
-  if (stats === undefined) fail(`no such path: ${path}`);
+  if (stats === undefined) {
+    process.exit(usageError(TOOL, `no such path: ${path}`));
+  }
   if (stats.isDirectory()) {
     for (const entry of readdirSync(path, { withFileTypes: true })) {
       if (entry.name.startsWith('.') || SKIPPED.has(entry.name)) continue;
@@ -83,23 +90,3 @@ function collect(path, files) {
   if (!EXTENSIONS.has(extname(path))) return;
   files.push({ path, text: readFileSync(path, 'utf8') });
 }
-
-/**
- * A count with its noun, so a summary line reads as a sentence.
- * @param {number} total - How many.
- * @param {string} noun - What of, in the singular.
- * @returns {string} The two, with the plural `s` when it is needed.
- */
-function count(total, noun) {
-  return `${total} ${noun}${total === 1 ? '' : 's'}`;
-}
-
-/**
- * Stop on a call the script cannot honour, which is not a clean scan.
- * @param {string} message - What was wrong with it.
- * @returns {never} It never comes back: the process ends here.
- */
-function fail(message) {
-  process.stderr.write(`check-tokens: ${message}\n`);
-  process.exit(2);
-}

package/bin/cli.mjs

@@ -0,0 +1,43 @@
+/*
+ * The plumbing every checker of this package shares: how a comma-separated
+ * option is read, how a count is written in the summary line, and how a call
+ * the script cannot honour is reported. A checker only has to say what it
+ * checks, and stays the one place that ends the process.
+ */
+import process from 'node:process';
+
+import { formatInteger, pluralize } from '../lib/core.js';
+
+/**
+ * A comma-separated option, without the empty entries a trailing comma leaves.
+ * @param {string} value - What was written after the `=`.
+ * @returns {string[]} The entries, trimmed.
+ */
+export function listOption(value) {
+  const entries = [];
+  for (const entry of value.split(',')) {
+    if (entry.trim() !== '') entries.push(entry.trim());
+  }
+  return entries;
+}
+
+/**
+ * A count with its noun, so a summary line reads as a sentence.
+ * @param {number} total - How many.
+ * @param {string} noun - What of, in the singular.
+ * @returns {string} The grouped count and the noun that agrees with it.
+ */
+export function countOf(total, noun) {
+  return `${formatInteger(total)} ${pluralize(total, noun)}`;
+}
+
+/**
+ * Report a call the script cannot honour, which is not a clean scan.
+ * @param {string} tool - The checker's name, as the message is prefixed.
+ * @param {string} message - What was wrong with the call.
+ * @returns {number} The status a wrong call exits with, for `process.exit`.
+ */
+export function usageError(tool, message) {
+  process.stderr.write(`${tool}: ${message}\n`);
+  return 2;
+}

package/lib/about/core/about.d.ts

@@ -1,6 +1,7 @@
 import type { CitedWork } from '../../citation/core/works.ts';
 import type { CreditEntry, CreditId } from '../../credits/core/credits.ts';
 import type { EcosystemSite, SiteId } from '../../ecosystem/core/sites.ts';
+import type { ProviderEntry, ProviderId } from './providers.ts';
 /**
  * What a site says about itself: the one page a visitor opens to find out what
  * the tool is, what it stands on, and who to tell when it breaks.
@@ -30,6 +31,18 @@ export interface AboutContent {
      * @default undefined — the site asks for no citation of its own
      */
     cite?: readonly CitedWork[];
+    /**
+     * Who provides the site, named under "Provided by"; a role, when given,
+     * is listed under the names.
+     * @default undefined
+     */
+    people?: readonly AboutPerson[];
+    /**
+     * Ids into the provider registry: the institutions that provide the site,
+     * drawn as logos under "Provided by".
+     * @default undefined
+     */
+    providedBy?: readonly ProviderId[];
     /**
      * Licence the site itself is published under.
      * @default 'MIT'
@@ -51,6 +64,16 @@ export interface AboutContent {
      */
     issues?: string;
 }
+/** One person who made a site. */
+export interface AboutPerson {
+    /** Their name, as they write it. */
+    name: string;
+    /**
+     * What they contributed, in one line.
+     * @default undefined
+     */
+    role?: string;
+}
 /**
  * The same record with nothing left to look up: every default filled in, and
  * every credit id replaced by the entry it names.
@@ -66,6 +89,10 @@ export interface ResolvedAbout {
     credits: CreditEntry[];
     /** The works to cite, empty when the site asks for none. */
     cite: readonly CitedWork[];
+    /** Who made the site, empty when the site names nobody. */
+    people: readonly AboutPerson[];
+    /** The institutions providing the site, empty when the site names none. */
+    providedBy: ProviderEntry[];
     license: string;
     repository: string;
     /** The running version, or `undefined` when the site does not know it. */

package/lib/about/core/about.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"about.d.ts","sourceRoot":"","sources":["../../../src/about/core/about.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,8BAA8B,CAAC;AAC9D,OAAO,KAAK,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,+BAA+B,CAAC;AAG3E,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,EAAE,MAAM,+BAA+B,CAAC;AAE3E;;;;;;;;GAQG;AACH,MAAM,WAAW,YAAY;IAC3B,oCAAoC;IACpC,MAAM,EAAE,MAAM,CAAC;IACf,uCAAuC;IACvC,IAAI,EAAE,MAAM,CAAC;IACb;;;;OAIG;IACH,UAAU,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAC/B,iEAAiE;IACjE,GAAG,EAAE,SAAS,MAAM,EAAE,CAAC;IACvB,8DAA8D;IAC9D,OAAO,EAAE,SAAS,QAAQ,EAAE,CAAC;IAC7B;;;OAGG;IACH,IAAI,CAAC,EAAE,SAAS,SAAS,EAAE,CAAC;IAC5B;;;OAGG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB;;;OAGG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB;;;OAGG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB;;;OAGG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED;;;GAGG;AACH,MAAM,WAAW,aAAa;IAC5B,0EAA0E;IAC1E,IAAI,EAAE,aAAa,CAAC;IACpB,IAAI,EAAE,MAAM,CAAC;IACb,+DAA+D;IAC/D,UAAU,EAAE,SAAS,MAAM,EAAE,CAAC;IAC9B,GAAG,EAAE,SAAS,MAAM,EAAE,CAAC;IACvB,uEAAuE;IACvE,OAAO,EAAE,WAAW,EAAE,CAAC;IACvB,4DAA4D;IAC5D,IAAI,EAAE,SAAS,SAAS,EAAE,CAAC;IAC3B,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,0EAA0E;IAC1E,OAAO,EAAE,MAAM,GAAG,SAAS,CAAC;IAC5B,MAAM,EAAE,MAAM,CAAC;CAChB;AAED;;;;;;;GAOG;AACH,wBAAgB,YAAY,CAAC,OAAO,EAAE,YAAY,GAAG,aAAa,CAgBjE;AAED;;;;;;;;;GASG;AACH,wBAAgB,aAAa,CAAC,OAAO,EAAE,YAAY,GAAG,MAAM,EAAE,CA8C7D"}
+{"version":3,"file":"about.d.ts","sourceRoot":"","sources":["../../../src/about/core/about.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,8BAA8B,CAAC;AAC9D,OAAO,KAAK,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,+BAA+B,CAAC;AAG3E,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,EAAE,MAAM,+BAA+B,CAAC;AAE3E,OAAO,KAAK,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAGhE;;;;;;;;GAQG;AACH,MAAM,WAAW,YAAY;IAC3B,oCAAoC;IACpC,MAAM,EAAE,MAAM,CAAC;IACf,uCAAuC;IACvC,IAAI,EAAE,MAAM,CAAC;IACb;;;;OAIG;IACH,UAAU,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAC/B,iEAAiE;IACjE,GAAG,EAAE,SAAS,MAAM,EAAE,CAAC;IACvB,8DAA8D;IAC9D,OAAO,EAAE,SAAS,QAAQ,EAAE,CAAC;IAC7B;;;OAGG;IACH,IAAI,CAAC,EAAE,SAAS,SAAS,EAAE,CAAC;IAC5B;;;;OAIG;IACH,MAAM,CAAC,EAAE,SAAS,WAAW,EAAE,CAAC;IAChC;;;;OAIG;IACH,UAAU,CAAC,EAAE,SAAS,UAAU,EAAE,CAAC;IACnC;;;OAGG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB;;;OAGG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB;;;OAGG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB;;;OAGG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,kCAAkC;AAClC,MAAM,WAAW,WAAW;IAC1B,oCAAoC;IACpC,IAAI,EAAE,MAAM,CAAC;IACb;;;OAGG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED;;;GAGG;AACH,MAAM,WAAW,aAAa;IAC5B,0EAA0E;IAC1E,IAAI,EAAE,aAAa,CAAC;IACpB,IAAI,EAAE,MAAM,CAAC;IACb,+DAA+D;IAC/D,UAAU,EAAE,SAAS,MAAM,EAAE,CAAC;IAC9B,GAAG,EAAE,SAAS,MAAM,EAAE,CAAC;IACvB,uEAAuE;IACvE,OAAO,EAAE,WAAW,EAAE,CAAC;IACvB,4DAA4D;IAC5D,IAAI,EAAE,SAAS,SAAS,EAAE,CAAC;IAC3B,2DAA2D;IAC3D,MAAM,EAAE,SAAS,WAAW,EAAE,CAAC;IAC/B,2EAA2E;IAC3E,UAAU,EAAE,aAAa,EAAE,CAAC;IAC5B,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,0EAA0E;IAC1E,OAAO,EAAE,MAAM,GAAG,SAAS,CAAC;IAC5B,MAAM,EAAE,MAAM,CAAC;CAChB;AAED;;;;;;;GAOG;AACH,wBAAgB,YAAY,CAAC,OAAO,EAAE,YAAY,GAAG,aAAa,CAkBjE;AAED;;;;;;;;;GASG;AACH,wBAAgB,aAAa,CAAC,OAAO,EAAE,YAAY,GAAG,MAAM,EAAE,CA8C7D"}

package/lib/about/core/about.js

@@ -1,5 +1,6 @@
 import { credits } from "../../credits/core/credits.js";
 import { siteById } from "../../ecosystem/core/lookup.js";
+import { providers } from "./providers.js";
 /**
  * Fill in what a site left to the family, and resolve what it named.
  * @param content - What the site wrote about itself.
@@ -18,6 +19,8 @@ export function resolveAbout(content) {
         can: content.can,
         credits: credits(content.credits),
         cite: content.cite ?? [],
+        people: content.people ?? [],
+        providedBy: providers(content.providedBy ?? []),
         license: content.license ?? DEFAULT_LICENSE,
         repository,
         version: content.version,

package/lib/about/core/about.js.map

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

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

@@ -1,3 +1,5 @@
-export type { AboutContent, ResolvedAbout } from './about.ts';
+export type { AboutContent, AboutPerson, ResolvedAbout } from './about.ts';
 export { aboutProblems, resolveAbout } from './about.ts';
+export type { ProviderEntry, ProviderId } from './providers.ts';
+export { PROVIDERS, providers } from './providers.ts';
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/about/core/index.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAC9D,OAAO,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/about/core/index.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,YAAY,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAC3E,OAAO,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AACzD,YAAY,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAChE,OAAO,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC"}

package/lib/about/core/index.js

@@ -1,2 +1,3 @@
 export { aboutProblems, resolveAbout } from "./about.js";
+export { PROVIDERS, providers } from "./providers.js";
 //# sourceMappingURL=index.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/about/core/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/about/core/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAEzD,OAAO,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC"}

package/lib/about/core/providers.d.ts

@@ -0,0 +1,31 @@
+/** An institution that provides a site: hosts it, pays for it, employs who writes it. */
+export interface ProviderEntry {
+    /** How a site names the institution in its record. */
+    id: string;
+    /** The short name, spelled the way the institution spells it. */
+    name: string;
+    /** The full name, read by a screen reader and shown on hover. */
+    fullName: string;
+    /** Where the institution lives. */
+    href: string;
+    /** City and country, as written under the institution's name. */
+    location: string;
+}
+/** An id the provider registry answers to. */
+export type ProviderId = (typeof PROVIDERS)[number]['id'];
+/**
+ * The institutions a site names as its providers, in the order it names them.
+ * @param ids - Which institutions, in display order.
+ * @returns The entries, in that order.
+ * @throws {Error} When an id is not in the registry.
+ */
+export declare function providers(ids: readonly ProviderId[]): ProviderEntry[];
+/** Every institution a site of the family may name as its provider. */
+export declare const PROVIDERS: readonly [{
+    readonly id: "epfl";
+    readonly name: "EPFL";
+    readonly fullName: "École polytechnique fédérale de Lausanne";
+    readonly href: "https://www.epfl.ch";
+    readonly location: "Lausanne, Switzerland";
+}];
+//# sourceMappingURL=providers.d.ts.map

package/lib/about/core/providers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"providers.d.ts","sourceRoot":"","sources":["../../../src/about/core/providers.ts"],"names":[],"mappings":"AAAA,yFAAyF;AACzF,MAAM,WAAW,aAAa;IAC5B,sDAAsD;IACtD,EAAE,EAAE,MAAM,CAAC;IACX,iEAAiE;IACjE,IAAI,EAAE,MAAM,CAAC;IACb,iEAAiE;IACjE,QAAQ,EAAE,MAAM,CAAC;IACjB,mCAAmC;IACnC,IAAI,EAAE,MAAM,CAAC;IACb,iEAAiE;IACjE,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,8CAA8C;AAC9C,MAAM,MAAM,UAAU,GAAG,CAAC,OAAO,SAAS,CAAC,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,CAAC;AAE1D;;;;;GAKG;AACH,wBAAgB,SAAS,CAAC,GAAG,EAAE,SAAS,UAAU,EAAE,GAAG,aAAa,EAAE,CAUrE;AAED,uEAAuE;AACvE,eAAO,MAAM,SAAS;;;;;;EAQuB,CAAC"}

package/lib/about/core/providers.js

@@ -0,0 +1,28 @@
+/**
+ * The institutions a site names as its providers, in the order it names them.
+ * @param ids - Which institutions, in display order.
+ * @returns The entries, in that order.
+ * @throws {Error} When an id is not in the registry.
+ */
+export function providers(ids) {
+    const listed = [];
+    for (const id of ids) {
+        const entry = PROVIDERS.find((candidate) => candidate.id === id);
+        if (entry === undefined) {
+            throw new Error(`unknown provider: ${id}`);
+        }
+        listed.push(entry);
+    }
+    return listed;
+}
+/** Every institution a site of the family may name as its provider. */
+export const PROVIDERS = [
+    {
+        id: 'epfl',
+        name: 'EPFL',
+        fullName: 'École polytechnique fédérale de Lausanne',
+        href: 'https://www.epfl.ch',
+        location: 'Lausanne, Switzerland',
+    },
+];
+//# sourceMappingURL=providers.js.map

package/lib/about/core/providers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"providers.js","sourceRoot":"","sources":["../../../src/about/core/providers.ts"],"names":[],"mappings":"AAiBA;;;;;GAKG;AACH,MAAM,UAAU,SAAS,CAAC,GAA0B;IAClD,MAAM,MAAM,GAAoB,EAAE,CAAC;IACnC,KAAK,MAAM,EAAE,IAAI,GAAG,EAAE,CAAC;QACrB,MAAM,KAAK,GAAG,SAAS,CAAC,IAAI,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,SAAS,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC;QACjE,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;YACxB,MAAM,IAAI,KAAK,CAAC,qBAAqB,EAAE,EAAE,CAAC,CAAC;QAC7C,CAAC;QACD,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IACrB,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,uEAAuE;AACvE,MAAM,CAAC,MAAM,SAAS,GAAG;IACvB;QACE,EAAE,EAAE,MAAM;QACV,IAAI,EAAE,MAAM;QACZ,QAAQ,EAAE,0CAA0C;QACpD,IAAI,EAAE,qBAAqB;QAC3B,QAAQ,EAAE,uBAAuB;KAClC;CAC0C,CAAC"}

package/lib/about/ui/AboutCitations.d.ts

@@ -6,9 +6,11 @@ export interface AboutCitationsProps {
 }
 /**
  * What to cite, and what citing each work credits: a reader handed two
- * references has to be told which is which before they can pick one.
+ * references has to be told which is which before they can pick one. Each
+ * work is cited through the shared Cite button, so the page offers the same
+ * article link, styles and reference-manager files as the header does.
  * @param props - See {@link AboutCitationsProps}.
- * @returns The works, each with its reference and its DOI.
+ * @returns The works, each with its Cite button.
  */
 export declare function AboutCitations(props: AboutCitationsProps): ReactElement;
 //# sourceMappingURL=AboutCitations.d.ts.map

package/lib/about/ui/AboutCitations.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"AboutCitations.d.ts","sourceRoot":"","sources":["../../../src/about/ui/AboutCitations.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAiB,YAAY,EAAE,MAAM,OAAO,CAAC;AAIzD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,8BAA8B,CAAC;AAG9D,MAAM,WAAW,mBAAmB;IAClC,+DAA+D;IAC/D,KAAK,EAAE,SAAS,SAAS,EAAE,CAAC;CAC7B;AAED;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,mBAAmB,GAAG,YAAY,CA8BvE"}
+{"version":3,"file":"AboutCitations.d.ts","sourceRoot":"","sources":["../../../src/about/ui/AboutCitations.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAiB,YAAY,EAAE,MAAM,OAAO,CAAC;AAEzD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,8BAA8B,CAAC;AAG9D,MAAM,WAAW,mBAAmB;IAClC,+DAA+D;IAC/D,KAAK,EAAE,SAAS,SAAS,EAAE,CAAC;CAC7B;AAED;;;;;;;GAOG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,mBAAmB,GAAG,YAAY,CAoBvE"}

package/lib/about/ui/AboutCitations.js

@@ -1,16 +1,16 @@
 import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
-import { DEFAULT_CITATION_STYLE } from "../../citation/core/formats.js";
-import { doiUrl } from "../../citation/core/reference.js";
-import { CitationPreview } from "../../citation/ui/CitationPreview.js";
+import { CiteButton } from "../../citation/ui/CiteButton.js";
 /**
  * What to cite, and what citing each work credits: a reader handed two
- * references has to be told which is which before they can pick one.
+ * references has to be told which is which before they can pick one. Each
+ * work is cited through the shared Cite button, so the page offers the same
+ * article link, styles and reference-manager files as the header does.
  * @param props - See {@link AboutCitationsProps}.
- * @returns The works, each with its reference and its DOI.
+ * @returns The works, each with its Cite button.
  */
 export function AboutCitations(props) {
     const { works } = props;
-    return (_jsx("div", { className: "about-citations", style: LIST_STYLE, children: works.map((work) => (_jsxs("div", { className: "about-citation", children: [_jsx("div", { style: WHAT_STYLE, children: work.what }), work.note === undefined ? null : (_jsx("p", { style: NOTE_STYLE, children: work.note })), _jsx("div", { style: PLATE_STYLE, children: _jsx(CitationPreview, { reference: work.reference, format: "text", style: DEFAULT_CITATION_STYLE }) }), _jsxs("a", { href: doiUrl(work.reference), target: "_blank", rel: "noopener noreferrer", style: DOI_STYLE, children: ["doi:", work.reference.doi] })] }, work.reference.doi))) }));
+    return (_jsx("div", { className: "about-citations", style: LIST_STYLE, children: works.map((work) => (_jsxs("div", { className: "about-citation", children: [_jsx("div", { style: WHAT_STYLE, children: work.what }), work.note === undefined ? null : (_jsx("p", { style: NOTE_STYLE, children: work.note })), _jsx(CiteButton, { reference: work.reference, label: `Cite ${work.what}`, placement: "bottom-start" })] }, work.reference.doi))) }));
 }
 const LIST_STYLE = {
     display: 'flex',
@@ -23,18 +23,4 @@ const NOTE_STYLE = {
     color: 'var(--text-muted)',
     fontSize: 13,
 };
-// The preview is set in the light ink of the tooltip it was drawn for, so it
-// is given the dark plate that ink is legible on.
-const PLATE_STYLE = {
-    padding: '8px 10px',
-    borderRadius: 'var(--radius)',
-    background: 'var(--text)',
-    overflow: 'auto',
-};
-const DOI_STYLE = {
-    display: 'inline-block',
-    marginTop: 6,
-    color: 'var(--accent)',
-    fontSize: 12,
-};
 //# sourceMappingURL=AboutCitations.js.map

package/lib/about/ui/AboutCitations.js.map

@@ -1 +1 @@
-{"version":3,"file":"AboutCitations.js","sourceRoot":"","sources":["../../../src/about/ui/AboutCitations.tsx"],"names":[],"mappings":";AAEA,OAAO,EAAE,sBAAsB,EAAE,MAAM,gCAAgC,CAAC;AACxE,OAAO,EAAE,MAAM,EAAE,MAAM,kCAAkC,CAAC;AAE1D,OAAO,EAAE,eAAe,EAAE,MAAM,sCAAuC,CAAC;AAOxE;;;;;GAKG;AACH,MAAM,UAAU,cAAc,CAAC,KAA0B;IACvD,MAAM,EAAE,KAAK,EAAE,GAAG,KAAK,CAAC;IAExB,OAAO,CACL,cAAK,SAAS,EAAC,iBAAiB,EAAC,KAAK,EAAE,UAAU,YAC/C,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CACnB,eAA8B,SAAS,EAAC,gBAAgB,aACtD,cAAK,KAAK,EAAE,UAAU,YAAG,IAAI,CAAC,IAAI,GAAO,EACxC,IAAI,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAChC,YAAG,KAAK,EAAE,UAAU,YAAG,IAAI,CAAC,IAAI,GAAK,CACtC,EACD,cAAK,KAAK,EAAE,WAAW,YACrB,KAAC,eAAe,IACd,SAAS,EAAE,IAAI,CAAC,SAAS,EACzB,MAAM,EAAC,MAAM,EACb,KAAK,EAAE,sBAAsB,GAC7B,GACE,EACN,aACE,IAAI,EAAE,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,EAC5B,MAAM,EAAC,QAAQ,EACf,GAAG,EAAC,qBAAqB,EACzB,KAAK,EAAE,SAAS,qBAEX,IAAI,CAAC,SAAS,CAAC,GAAG,IACrB,KAnBI,IAAI,CAAC,SAAS,CAAC,GAAG,CAoBtB,CACP,CAAC,GACE,CACP,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,GAAG;IACjB,OAAO,EAAE,MAAM;IACf,aAAa,EAAE,QAAQ;IACvB,GAAG,EAAE,EAAE;CACyB,CAAC;AAEnC,MAAM,UAAU,GAAG,EAAE,UAAU,EAAE,GAAG,EAAmC,CAAC;AAExE,MAAM,UAAU,GAAG;IACjB,MAAM,EAAE,WAAW;IACnB,KAAK,EAAE,mBAAmB;IAC1B,QAAQ,EAAE,EAAE;CACoB,CAAC;AAEnC,6EAA6E;AAC7E,kDAAkD;AAClD,MAAM,WAAW,GAAG;IAClB,OAAO,EAAE,UAAU;IACnB,YAAY,EAAE,eAAe;IAC7B,UAAU,EAAE,aAAa;IACzB,QAAQ,EAAE,MAAM;CACgB,CAAC;AAEnC,MAAM,SAAS,GAAG;IAChB,OAAO,EAAE,cAAc;IACvB,SAAS,EAAE,CAAC;IACZ,KAAK,EAAE,eAAe;IACtB,QAAQ,EAAE,EAAE;CACoB,CAAC"}
+{"version":3,"file":"AboutCitations.js","sourceRoot":"","sources":["../../../src/about/ui/AboutCitations.tsx"],"names":[],"mappings":";AAGA,OAAO,EAAE,UAAU,EAAE,MAAM,iCAAkC,CAAC;AAO9D;;;;;;;GAOG;AACH,MAAM,UAAU,cAAc,CAAC,KAA0B;IACvD,MAAM,EAAE,KAAK,EAAE,GAAG,KAAK,CAAC;IAExB,OAAO,CACL,cAAK,SAAS,EAAC,iBAAiB,EAAC,KAAK,EAAE,UAAU,YAC/C,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CACnB,eAA8B,SAAS,EAAC,gBAAgB,aACtD,cAAK,KAAK,EAAE,UAAU,YAAG,IAAI,CAAC,IAAI,GAAO,EACxC,IAAI,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAChC,YAAG,KAAK,EAAE,UAAU,YAAG,IAAI,CAAC,IAAI,GAAK,CACtC,EACD,KAAC,UAAU,IACT,SAAS,EAAE,IAAI,CAAC,SAAS,EACzB,KAAK,EAAE,QAAQ,IAAI,CAAC,IAAI,EAAE,EAC1B,SAAS,EAAC,cAAc,GACxB,KATM,IAAI,CAAC,SAAS,CAAC,GAAG,CAUtB,CACP,CAAC,GACE,CACP,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,GAAG;IACjB,OAAO,EAAE,MAAM;IACf,aAAa,EAAE,QAAQ;IACvB,GAAG,EAAE,EAAE;CACyB,CAAC;AAEnC,MAAM,UAAU,GAAG,EAAE,UAAU,EAAE,GAAG,EAAmC,CAAC;AAExE,MAAM,UAAU,GAAG;IACjB,MAAM,EAAE,WAAW;IACnB,KAAK,EAAE,mBAAmB;IAC1B,QAAQ,EAAE,EAAE;CACoB,CAAC"}