react-cheminfo 0.34.0 → 0.36.0

package/src/seo/core/pageProse.ts

@@ -0,0 +1,146 @@
+/**
+ * The text a page is indexed on, written into the HTML before anything runs.
+ *
+ * A prerendered site writes one file per address, and each of them carried the
+ * same body: the site's crawl path, and nothing else. A search engine clusters
+ * pages by the text it is handed, so a hundred and eighteen element pages
+ * differing only in their title are a hundred and seventeen duplicates — and
+ * which one it keeps is not ours to choose. A page heavy enough that the
+ * renderer never gets to it is indexed on that body alone.
+ *
+ * So what a site writes here is the text its running app already shows, drawn
+ * from the same data: the prose is not written twice, it is written where the
+ * build can reach it. Text only, and escaped — the addresses a reader follows
+ * are the crawl path's business.
+ */
+
+import { escapeText } from '../../share/core/escape.ts';
+
+/** A table of facts under the prose: the rows a page would show anyway. */
+export interface PageTable {
+  /** Header cells, left to right. */
+  columns: readonly string[];
+  /** Body rows, each as many cells as there are columns. */
+  rows: ReadonlyArray<readonly string[]>;
+  /**
+   * The sentence under the table, saying where the numbers come from.
+   * @default undefined — the table stands on its own
+   */
+  caption?: string;
+}
+
+/** One run of the page's text: a heading, prose, and the facts under it. */
+export interface PageSection {
+  /**
+   * The heading it opens with, as an `h2`.
+   * @default undefined — the run carries no heading
+   */
+  heading?: string;
+  /**
+   * The paragraphs under it, each taken as written.
+   * @default undefined — no prose
+   */
+  paragraphs?: readonly string[];
+  /**
+   * A list under the prose, one item per line.
+   * @default undefined — no list
+   */
+  list?: readonly string[];
+  /**
+   * A table under the prose.
+   * @default undefined — no table
+   */
+  table?: PageTable;
+}
+
+/** The whole of one page's text, as the page itself would say it. */
+export interface PageContent extends PageSection {
+  /**
+   * The page's own name, written as its `h1`. It answers the title the page is
+   * indexed under, so a reader who searched for it reads the same words again.
+   */
+  heading: string;
+  /**
+   * The runs under the opening prose, in reading order.
+   * @default undefined — the page is its opening prose
+   */
+  sections?: readonly PageSection[];
+}
+
+/**
+ * The page's text as HTML, everything below its heading.
+ *
+ * The heading itself is left to the caller, which already writes the one `h1`
+ * the page carries — `noscriptIndex` does.
+ * @param content - What the page says.
+ * @param indent - The indentation every line is written at.
+ * @default '  '
+ * @returns The HTML, opening with a newline, or `''` when the page says nothing
+ * below its heading.
+ */
+export function pageProseHtml(content: PageContent, indent = '  '): string {
+  // The page's own heading is the caller's `h1`; what is left of its opening run
+  // is prose like any section's.
+  const opening: PageSection = {
+    paragraphs: content.paragraphs,
+    list: content.list,
+    table: content.table,
+  };
+  const parts = [
+    sectionHtml(opening, indent),
+    ...(content.sections ?? []).map((section) => sectionHtml(section, indent)),
+  ];
+  return parts.join('');
+}
+
+function sectionHtml(section: PageSection, indent: string): string {
+  const lines: string[] = [];
+  if (section.heading !== undefined && section.heading.trim() !== '') {
+    lines.push(`${indent}<h2>${escapeText(section.heading)}</h2>`);
+  }
+  for (const paragraph of section.paragraphs ?? []) {
+    if (paragraph.trim() === '') continue;
+    lines.push(`${indent}<p>${escapeText(paragraph)}</p>`);
+  }
+  const list = listHtml(section.list, indent);
+  if (list !== '') lines.push(list);
+  const table = tableHtml(section.table, indent);
+  if (table !== '') lines.push(table);
+  return lines.length === 0 ? '' : `\n${lines.join('\n')}`;
+}
+
+function listHtml(list: readonly string[] | undefined, indent: string): string {
+  // A list with no item is not a list: `<ul>` holds at least one `<li>`.
+  if (list === undefined || list.length === 0) return '';
+  const items = list
+    .map((item) => `${indent}  <li>${escapeText(item)}</li>`)
+    .join('\n');
+  return `${indent}<ul>\n${items}\n${indent}</ul>`;
+}
+
+function tableHtml(table: PageTable | undefined, indent: string): string {
+  // A table with no row says nothing, and an empty `<tbody>` is not markup a
+  // crawler is owed.
+  if (table === undefined || table.rows.length === 0) return '';
+  const caption =
+    table.caption === undefined || table.caption.trim() === ''
+      ? ''
+      : `\n${indent}  <caption>${escapeText(table.caption)}</caption>`;
+  const head = table.columns
+    .map((column) => `<th>${escapeText(column)}</th>`)
+    .join('');
+  const body = table.rows
+    .map(
+      (row) =>
+        `${indent}    <tr>${row.map((cell) => `<td>${escapeText(cell)}</td>`).join('')}</tr>`,
+    )
+    .join('\n');
+  return `${indent}<table>${caption}
+${indent}  <thead>
+${indent}    <tr>${head}</tr>
+${indent}  </thead>
+${indent}  <tbody>
+${body}
+${indent}  </tbody>
+${indent}</table>`;
+}

package/src/seo/core/routeProblems.ts

@@ -0,0 +1,111 @@
+/**
+ * What is wrong with the prose a site is indexed under.
+ *
+ * A route table is the only place a search result is written, and it is written
+ * once and read for years, so the limits that decide whether a result is
+ * readable are checked rather than trusted: a title Google cuts in half, a
+ * description too short to say anything or long enough to be clipped, two pages
+ * sharing a sentence — which is how a site asks to be deduplicated down to one
+ * result — and a snippet promising something the page does not carry.
+ *
+ * The paths are `assertRoutes`' business; this is about the words.
+ */
+
+import type { RouteMeta } from './routes.ts';
+
+/** The longest title that survives a search result whole. */
+const TITLE_LIMIT = 60;
+/** The shortest description that says anything. */
+const DESCRIPTION_MIN = 110;
+/** The longest description a result shows without clipping it. */
+const DESCRIPTION_MAX = 160;
+
+/**
+ * What a site never says about itself, in the words it would say it in. A
+ * snippet naming a repository, a tracker or a licence is both a promise the
+ * page does not keep and a thing we do not publish.
+ */
+const WITHHELD =
+  /\b(?:licence|license|licensing|open[ -]source|repositor(?:y|ies)|issue tracker|source code|report a (?:problem|bug|issue))\b/i;
+
+/**
+ * The phrase in a snippet that names something a site does not publish.
+ *
+ * Shared with the build-time checker, which reads the same sentences back out
+ * of the pages they were written into: one list of words, checked where they
+ * are authored and again where they landed.
+ * @param text - A title or a description.
+ * @returns The phrase, or `undefined` when there is none.
+ */
+export function withheldPhrase(text: string): string | undefined {
+  return WITHHELD.exec(text)?.[0];
+}
+
+/**
+ * Check the table a site is indexed under, before a build reads it.
+ *
+ * Returns the problems rather than throwing, so a site asserts an empty list in
+ * its own test and reads every one of them at once.
+ * @param routes - Every address the site answers.
+ * @returns One line per problem, empty when the table is fit to ship.
+ */
+export function routeProblems(routes: readonly RouteMeta[]): string[] {
+  const problems: string[] = [];
+
+  if (routes.length === 0) {
+    problems.push('the table is empty: a site answers at least one route.');
+    return problems;
+  }
+
+  const titles = new Map<string, string>();
+  const descriptions = new Map<string, string>();
+
+  for (const route of routes) {
+    const at = route.path;
+
+    if (route.title.trim() === '') {
+      problems.push(`${at}: the title is empty.`);
+    } else if (route.title.length > TITLE_LIMIT) {
+      problems.push(
+        `${at}: the title is ${route.title.length} characters, and the site name is appended to it — at most ${TITLE_LIMIT} survives a result whole.`,
+      );
+    }
+
+    const length = route.description.length;
+    if (length < DESCRIPTION_MIN) {
+      problems.push(
+        `${at}: the description is ${length} characters — at least ${DESCRIPTION_MIN}, or the result says half of what the page is.`,
+      );
+    } else if (length > DESCRIPTION_MAX) {
+      problems.push(
+        `${at}: the description is ${length} characters — at most ${DESCRIPTION_MAX}, or the sentence is cut off in the result itself.`,
+      );
+    }
+
+    const titleFirst = titles.get(route.title);
+    if (titleFirst === undefined) {
+      titles.set(route.title, at);
+    } else {
+      problems.push(`${at}: the title repeats the one at ${titleFirst}.`);
+    }
+
+    const descriptionFirst = descriptions.get(route.description);
+    if (descriptionFirst === undefined) {
+      descriptions.set(route.description, at);
+    } else {
+      problems.push(
+        `${at}: the description repeats the one at ${descriptionFirst}.`,
+      );
+    }
+
+    const withheld =
+      withheldPhrase(route.title) ?? withheldPhrase(route.description);
+    if (withheld !== undefined) {
+      problems.push(
+        `${at}: the snippet says "${withheld}" — a site names no repository, tracker or licence of ours.`,
+      );
+    }
+  }
+
+  return problems;
+}

package/src/seo/core/routes.ts

@@ -42,6 +42,20 @@ export interface RouteMeta {
    * @default undefined — the link stands on its own
    */
   note?: string;
+  /**
+   * Whether a search engine is meant to list the page.
+   *
+   * A maintenance screen — a curation queue, an import run, an admin table — is
+   * a real address a signed-in person opens, so it belongs in the table the
+   * router and the tab title read. It is not a result anybody wants: it says
+   * nothing a visitor searched for, and a chemist who lands on it has been sent
+   * to the wrong place. Such a route is left out of the sitemap and the page
+   * answers `noindex`, which is how a page is kept out of the index — never a
+   * `Disallow`, which only stops the crawl and still lets the address be listed
+   * from a link somewhere else.
+   * @default true
+   */
+  indexed?: boolean;
   /**
    * Whether the route also answers every address beneath it, so a section
    * carrying more pages than a table can hold — an entry per structure, per

package/src/seo/core/siteFiles.ts

@@ -50,10 +50,11 @@ export interface SiteFilesOptions {
  */
 export function sitemapXml(options: SiteFilesOptions): string {
   const origin = originOf(options);
-  if (options.routes.length === 0) {
+  if (options.routes.every((route) => route.indexed === false)) {
     throw new Error('a sitemap lists at least one address');
   }
   const entries = options.routes
+    .filter((route) => route.indexed !== false)
     .map(
       (route) =>
         `  <url><loc>${escapeText(`${origin}${route.path}`)}</loc></url>`,

package/src/seo/vite/prerender.ts

@@ -27,6 +27,7 @@ import { trimTrailingSlash } from '../../router/core/address.ts';
 import type { NoscriptText } from '../core/noscript.ts';
 import { noscriptIndex } from '../core/noscript.ts';
 import { pageHeadTags } from '../core/pageMeta.ts';
+import type { PageContent } from '../core/pageProse.ts';
 import type { RobotsDisallow } from '../core/robots.ts';
 import { robotsTxt } from '../core/robots.ts';
 import type { RouteMeta } from '../core/routes.ts';
@@ -91,6 +92,18 @@ export interface PrerenderOptions {
    * @default true
    */
   noscript?: boolean | NoscriptText;
+  /**
+   * What each page says for itself, above the crawl path: its own heading, its
+   * prose and the facts it would show anyway, read from the same data the app
+   * renders from.
+   *
+   * Without it every address ships the same body — the site's menu — and a
+   * search engine handed a hundred identical bodies keeps one of them. It is a
+   * function of the route rather than a field of it, so the prose stays out of
+   * the bundle the browser downloads: only the build ever calls it.
+   * @default undefined — every page carries the menu alone
+   */
+  content?: (route: RouteMeta) => PageContent | undefined;
 }
 
 /**
@@ -104,18 +117,18 @@ export function cheminfoPrerender(options: PrerenderOptions): Plugin {
   const { site, routes, origin, robots = [] } = options;
   assertRoutes(routes);
   const structuredData = structuredDataOf(options);
-  const crawlPath = crawlPathOf(options);
 
   let out = 'dist';
   let serve = false;
   let logger: Logger | null = null;
 
-  const page = (template: string, url: string) => {
+  const page = (template: string, route: RouteMeta) => {
     const head = fill(
       template,
       PAGE_HEAD_MARKER,
-      `${pageHeadTags({ site, routes, origin, url })}${structuredData}`,
+      `${pageHeadTags({ site, routes, origin, url: route.path })}${structuredData}`,
     );
+    const crawlPath = crawlPathOf(options, route);
     return crawlPath === '' ? head : fill(head, PAGE_BODY_MARKER, crawlPath);
   };
 
@@ -132,17 +145,16 @@ export function cheminfoPrerender(options: PrerenderOptions): Plugin {
     // from the home route rather than shipped with its markers showing.
     transformIndexHtml: {
       order: 'post',
-      handler: (html: string) =>
-        serve ? page(html, homeRoute(routes).path) : html,
+      handler: (html: string) => (serve ? page(html, homeRoute(routes)) : html),
     },
 
     closeBundle() {
       if (serve) return;
       const template = readFileSync(join(out, 'index.html'), 'utf8');
 
-      const write = (url: string, file: string) => {
+      const write = (route: RouteMeta, file: string) => {
         mkdirSync(dirname(file), { recursive: true });
-        writeFileSync(file, page(template, url));
+        writeFileSync(file, page(template, route));
       };
 
       let root = false;
@@ -150,7 +162,7 @@ export function cheminfoPrerender(options: PrerenderOptions): Plugin {
         const address = trimTrailingSlash(route.path);
         if (address === '/') root = true;
         write(
-          route.path,
+          route,
           address === '/'
             ? join(out, 'index.html')
             : join(out, address.slice(1), 'index.html'),
@@ -159,7 +171,7 @@ export function cheminfoPrerender(options: PrerenderOptions): Plugin {
       // The file a static server hands out for the mount itself. A table naming
       // no root would otherwise leave the template vite built, and ship a site
       // whose front page carries its markers instead of a head.
-      if (!root) write(homeRoute(routes).path, join(out, 'index.html'));
+      if (!root) write(homeRoute(routes), join(out, 'index.html'));
 
       writeFileSync(
         join(out, 'sitemap.xml'),
@@ -196,9 +208,16 @@ function structuredDataOf(options: PrerenderOptions): string {
   })}`;
 }
 
-function crawlPathOf(options: PrerenderOptions): string {
+function crawlPathOf(options: PrerenderOptions, route: RouteMeta): string {
   const { site, routes, origin, noscript = true } = options;
   if (noscript === false) return '';
+  const content = options.content?.(route);
   const { routes: listed, ...prose } = noscript === true ? {} : noscript;
-  return noscriptIndex({ site, origin, ...prose, routes: listed ?? routes });
+  return noscriptIndex({
+    site,
+    origin,
+    ...prose,
+    routes: listed ?? routes,
+    content,
+  });
 }

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

@@ -1,14 +0,0 @@
-/**
- * What can be linked to inside a repository, and when.
- *
- * Only GitHub has the addresses the About page builds — a release tag, a
- * commit — and only a repository a visitor can open is worth pointing them at.
- */
-/**
- * The sources as a base a release or a commit can be appended to.
- * @param repository - Where the sources live.
- * @returns The address without its trailing slash, or `undefined` when it is
- * not a GitHub repository and nothing inside it can be addressed.
- */
-export declare function githubSources(repository: string): string | undefined;
-//# sourceMappingURL=repository.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"repository.d.ts","sourceRoot":"","sources":["../../../src/about/core/repository.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAKH;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAKpE"}

package/lib/about/core/repository.js

@@ -1,21 +0,0 @@
-/**
- * What can be linked to inside a repository, and when.
- *
- * Only GitHub has the addresses the About page builds — a release tag, a
- * commit — and only a repository a visitor can open is worth pointing them at.
- */
-/** Where our repositories live, and the only host whose paths we know. */
-const GITHUB = 'https://github.com/';
-/**
- * The sources as a base a release or a commit can be appended to.
- * @param repository - Where the sources live.
- * @returns The address without its trailing slash, or `undefined` when it is
- * not a GitHub repository and nothing inside it can be addressed.
- */
-export function githubSources(repository) {
-    const sources = repository.endsWith('/')
-        ? repository.slice(0, -1)
-        : repository;
-    return sources.startsWith(GITHUB) ? sources : undefined;
-}
-//# sourceMappingURL=repository.js.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"repository.js","sourceRoot":"","sources":["../../../src/about/core/repository.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,0EAA0E;AAC1E,MAAM,MAAM,GAAG,qBAAqB,CAAC;AAErC;;;;;GAKG;AACH,MAAM,UAAU,aAAa,CAAC,UAAkB;IAC9C,MAAM,OAAO,GAAG,UAAU,CAAC,QAAQ,CAAC,GAAG,CAAC;QACtC,CAAC,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;QACzB,CAAC,CAAC,UAAU,CAAC;IACf,OAAO,OAAO,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS,CAAC;AAC1D,CAAC"}

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

@@ -1,22 +0,0 @@
-/**
- * A row of buttons with the name box among them, wrapping when the dialog is
- * too narrow for them.
- */
-export declare const exportButtonsStyle: {
-    readonly display: "flex";
-    readonly flexWrap: "wrap";
-    readonly alignItems: "center";
-    readonly gap: 6;
-};
-/** One group of an export dialog: what it offers, in a column. */
-export declare const exportSectionStyle: {
-    readonly display: "flex";
-    readonly flexDirection: "column";
-    readonly gap: 8;
-};
-/** Text that says something about a control rather than being one. */
-export declare const exportNoteStyle: {
-    readonly fontSize: 12;
-    readonly opacity: 0.7;
-};
-//# sourceMappingURL=exportStyles.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"exportStyles.d.ts","sourceRoot":"","sources":["../../../src/download/core/exportStyles.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,eAAO,MAAM,kBAAkB;;;;;CAKrB,CAAC;AAEX,kEAAkE;AAClE,eAAO,MAAM,kBAAkB;;;;CAIrB,CAAC;AAEX,sEAAsE;AACtE,eAAO,MAAM,eAAe;;;CAA0C,CAAC"}

package/lib/download/core/exportStyles.js

@@ -1,19 +0,0 @@
-/**
- * A row of buttons with the name box among them, wrapping when the dialog is
- * too narrow for them.
- */
-export const exportButtonsStyle = {
-    display: 'flex',
-    flexWrap: 'wrap',
-    alignItems: 'center',
-    gap: 6,
-};
-/** One group of an export dialog: what it offers, in a column. */
-export const exportSectionStyle = {
-    display: 'flex',
-    flexDirection: 'column',
-    gap: 8,
-};
-/** Text that says something about a control rather than being one. */
-export const exportNoteStyle = { fontSize: 12, opacity: 0.7 };
-//# sourceMappingURL=exportStyles.js.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"exportStyles.js","sourceRoot":"","sources":["../../../src/download/core/exportStyles.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAG;IAChC,OAAO,EAAE,MAAM;IACf,QAAQ,EAAE,MAAM;IAChB,UAAU,EAAE,QAAQ;IACpB,GAAG,EAAE,CAAC;CACE,CAAC;AAEX,kEAAkE;AAClE,MAAM,CAAC,MAAM,kBAAkB,GAAG;IAChC,OAAO,EAAE,MAAM;IACf,aAAa,EAAE,QAAQ;IACvB,GAAG,EAAE,CAAC;CACE,CAAC;AAEX,sEAAsE;AACtE,MAAM,CAAC,MAAM,eAAe,GAAG,EAAE,QAAQ,EAAE,EAAE,EAAE,OAAO,EAAE,GAAG,EAAW,CAAC"}

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

@@ -1,88 +0,0 @@
-/** How big a picture is written out, as a multiple of the size it is drawn at. */
-export interface ImageResolution {
-    /** Identifies the resolution in a picker. */
-    id: string;
-    /** What the option reads. */
-    label: string;
-    /** How many pixels each drawing unit becomes. */
-    scale: number;
-}
-/**
- * The sizes a picture leaves the editor at.
- *
- * A drawing unit is about a screen pixel, so the multipliers read as what the
- * picture is for rather than as numbers: what is on screen, the same again on a
- * retina display, and the two steps up a figure needs to survive being printed
- * or thrown on a wall.
- */
-export declare const IMAGE_RESOLUTIONS: readonly [{
-    readonly id: "screen";
-    readonly label: "Screen (1×)";
-    readonly scale: 1;
-}, {
-    readonly id: "retina";
-    readonly label: "Retina (2×)";
-    readonly scale: 2;
-}, {
-    readonly id: "print";
-    readonly label: "Print (4×)";
-    readonly scale: 4;
-}, {
-    readonly id: "poster";
-    readonly label: "Poster (8×)";
-    readonly scale: 8;
-}];
-/** One of the resolutions offered. */
-export type ImageResolutionId = (typeof IMAGE_RESOLUTIONS)[number]['id'];
-/**
- * The resolution a picture is written out at unless another is picked: what is
- * on screen, doubled, which is what a picture pasted into a document wants.
- */
-export declare const DEFAULT_IMAGE_RESOLUTION: {
-    readonly id: "retina";
-    readonly label: "Retina (2×)";
-    readonly scale: 2;
-};
-/** How big a picture comes out, in pixels. */
-export interface ImageSize {
-    /** Width of the picture, in pixels. */
-    width: number;
-    /** Height of the picture, in pixels. */
-    height: number;
-    /**
-     * What each drawing unit was actually worth. Below the resolution that was
-     * asked for when it would have made a picture too big to rasterize.
-     */
-    scale: number;
-}
-/**
- * How big a rectangle of the drawing comes out at a given resolution.
- *
- * The resolution is a wish rather than an instruction: a wide glycan asked for
- * at 8× would run past what a browser can rasterize and come back blank, so the
- * scale is brought down until the picture fits instead. The scale it settled on
- * comes back with the size, so what will actually be written can be shown
- * before it is.
- * @param box - The rectangle being written out.
- * @param box.width - How wide it is, in drawing units.
- * @param box.height - How tall it is, in drawing units.
- * @param scale - How many pixels each drawing unit should become.
- * @returns The size, and the scale it was reached at.
- */
-export declare function imageSize(box: {
-    width: number;
-    height: number;
-}, scale: number): ImageSize;
-/**
- * The resolution an identifier stands for.
- * @param id - What was picked.
- * @returns The resolution, falling back to the default one.
- */
-export declare function imageResolution(id: string): ImageResolution;
-/**
- * A size, written the way it is shown next to the resolution it comes from.
- * @param size - The size to write, `null` when nothing is drawn.
- * @returns The text, e.g. `1440 × 620 px`.
- */
-export declare function formatImageSize(size: ImageSize | null): string;
-//# sourceMappingURL=imageResolution.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"imageResolution.d.ts","sourceRoot":"","sources":["../../../src/download/core/imageResolution.ts"],"names":[],"mappings":"AAAA,kFAAkF;AAClF,MAAM,WAAW,eAAe;IAC9B,6CAA6C;IAC7C,EAAE,EAAE,MAAM,CAAC;IACX,6BAA6B;IAC7B,KAAK,EAAE,MAAM,CAAC;IACd,iDAAiD;IACjD,KAAK,EAAE,MAAM,CAAC;CACf;AAED;;;;;;;GAOG;AACH,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;;;EAKiB,CAAC;AAEhD,sCAAsC;AACtC,MAAM,MAAM,iBAAiB,GAAG,CAAC,OAAO,iBAAiB,CAAC,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,CAAC;AAEzE;;;GAGG;AACH,eAAO,MAAM,wBAAwB;;;;CAAuB,CAAC;AAa7D,8CAA8C;AAC9C,MAAM,WAAW,SAAS;IACxB,uCAAuC;IACvC,KAAK,EAAE,MAAM,CAAC;IACd,wCAAwC;IACxC,MAAM,EAAE,MAAM,CAAC;IACf;;;OAGG;IACH,KAAK,EAAE,MAAM,CAAC;CACf;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,SAAS,CACvB,GAAG,EAAE;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,EACtC,KAAK,EAAE,MAAM,GACZ,SAAS,CAoBX;AAED;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,EAAE,EAAE,MAAM,GAAG,eAAe,CAK3D;AAED;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,SAAS,GAAG,IAAI,GAAG,MAAM,CAG9D"}

package/lib/download/core/imageResolution.js

@@ -1,77 +0,0 @@
-/**
- * The sizes a picture leaves the editor at.
- *
- * A drawing unit is about a screen pixel, so the multipliers read as what the
- * picture is for rather than as numbers: what is on screen, the same again on a
- * retina display, and the two steps up a figure needs to survive being printed
- * or thrown on a wall.
- */
-export const IMAGE_RESOLUTIONS = [
-    { id: 'screen', label: 'Screen (1×)', scale: 1 },
-    { id: 'retina', label: 'Retina (2×)', scale: 2 },
-    { id: 'print', label: 'Print (4×)', scale: 4 },
-    { id: 'poster', label: 'Poster (8×)', scale: 8 },
-];
-/**
- * The resolution a picture is written out at unless another is picked: what is
- * on screen, doubled, which is what a picture pasted into a document wants.
- */
-export const DEFAULT_IMAGE_RESOLUTION = IMAGE_RESOLUTIONS[1];
-/**
- * Longest side a browser rasterizes reliably.
- *
- * Above roughly this, Safari and Chrome quietly hand back an empty canvas
- * instead of refusing, so the picture would be saved blank.
- */
-const MAXIMUM_SIDE = 8192;
-/** Most pixels a rasterized picture is allowed to hold. */
-const MAXIMUM_PIXELS = 32 * 1024 * 1024;
-/**
- * How big a rectangle of the drawing comes out at a given resolution.
- *
- * The resolution is a wish rather than an instruction: a wide glycan asked for
- * at 8× would run past what a browser can rasterize and come back blank, so the
- * scale is brought down until the picture fits instead. The scale it settled on
- * comes back with the size, so what will actually be written can be shown
- * before it is.
- * @param box - The rectangle being written out.
- * @param box.width - How wide it is, in drawing units.
- * @param box.height - How tall it is, in drawing units.
- * @param scale - How many pixels each drawing unit should become.
- * @returns The size, and the scale it was reached at.
- */
-export function imageSize(box, scale) {
-    const wanted = Number.isFinite(scale) && scale > 0 ? scale : 1;
-    const width = Math.max(box.width, 1);
-    const height = Math.max(box.height, 1);
-    const limit = Math.min(MAXIMUM_SIDE / width, MAXIMUM_SIDE / height, Math.sqrt(MAXIMUM_PIXELS / (width * height)));
-    const used = Math.min(wanted, limit);
-    // A picture held back by the limit is rounded down rather than to the nearest
-    // pixel, so rounding cannot put it back over what it was held to.
-    const toPixels = used < wanted ? Math.floor : Math.round;
-    return {
-        width: Math.max(1, toPixels(width * used)),
-        height: Math.max(1, toPixels(height * used)),
-        scale: used,
-    };
-}
-/**
- * The resolution an identifier stands for.
- * @param id - What was picked.
- * @returns The resolution, falling back to the default one.
- */
-export function imageResolution(id) {
-    return (IMAGE_RESOLUTIONS.find((resolution) => resolution.id === id) ??
-        DEFAULT_IMAGE_RESOLUTION);
-}
-/**
- * A size, written the way it is shown next to the resolution it comes from.
- * @param size - The size to write, `null` when nothing is drawn.
- * @returns The text, e.g. `1440 × 620 px`.
- */
-export function formatImageSize(size) {
-    if (!size)
-        return 'nothing to export';
-    return `${size.width} × ${size.height} px`;
-}
-//# sourceMappingURL=imageResolution.js.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"imageResolution.js","sourceRoot":"","sources":["../../../src/download/core/imageResolution.ts"],"names":[],"mappings":"AAUA;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAG;IAC/B,EAAE,EAAE,EAAE,QAAQ,EAAE,KAAK,EAAE,aAAa,EAAE,KAAK,EAAE,CAAC,EAAE;IAChD,EAAE,EAAE,EAAE,QAAQ,EAAE,KAAK,EAAE,aAAa,EAAE,KAAK,EAAE,CAAC,EAAE;IAChD,EAAE,EAAE,EAAE,OAAO,EAAE,KAAK,EAAE,YAAY,EAAE,KAAK,EAAE,CAAC,EAAE;IAC9C,EAAE,EAAE,EAAE,QAAQ,EAAE,KAAK,EAAE,aAAa,EAAE,KAAK,EAAE,CAAC,EAAE;CACH,CAAC;AAKhD;;;GAGG;AACH,MAAM,CAAC,MAAM,wBAAwB,GAAG,iBAAiB,CAAC,CAAC,CAAC,CAAC;AAE7D;;;;;GAKG;AACH,MAAM,YAAY,GAAG,IAAI,CAAC;AAE1B,2DAA2D;AAC3D,MAAM,cAAc,GAAG,EAAE,GAAG,IAAI,GAAG,IAAI,CAAC;AAexC;;;;;;;;;;;;;GAaG;AACH,MAAM,UAAU,SAAS,CACvB,GAAsC,EACtC,KAAa;IAEb,MAAM,MAAM,GAAG,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;IAC/D,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC;IACrC,MAAM,MAAM,GAAG,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC;IAEvC,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CACpB,YAAY,GAAG,KAAK,EACpB,YAAY,GAAG,MAAM,EACrB,IAAI,CAAC,IAAI,CAAC,cAAc,GAAG,CAAC,KAAK,GAAG,MAAM,CAAC,CAAC,CAC7C,CAAC;IACF,MAAM,IAAI,GAAG,IAAI,CAAC,GAAG,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;IACrC,8EAA8E;IAC9E,kEAAkE;IAClE,MAAM,QAAQ,GAAG,IAAI,GAAG,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC;IAEzD,OAAO;QACL,KAAK,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,QAAQ,CAAC,KAAK,GAAG,IAAI,CAAC,CAAC;QAC1C,MAAM,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,QAAQ,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;QAC5C,KAAK,EAAE,IAAI;KACZ,CAAC;AACJ,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,eAAe,CAAC,EAAU;IACxC,OAAO,CACL,iBAAiB,CAAC,IAAI,CAAC,CAAC,UAAU,EAAE,EAAE,CAAC,UAAU,CAAC,EAAE,KAAK,EAAE,CAAC;QAC5D,wBAAwB,CACzB,CAAC;AACJ,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,eAAe,CAAC,IAAsB;IACpD,IAAI,CAAC,IAAI;QAAE,OAAO,mBAAmB,CAAC;IACtC,OAAO,GAAG,IAAI,CAAC,KAAK,MAAM,IAAI,CAAC,MAAM,KAAK,CAAC;AAC7C,CAAC"}