@memorysmithapp/markdown-renderer 0.3.2 → 0.5.0

package/dist/host.d.ts

@@ -1,5 +1,5 @@
 import { type ReactNode } from 'react';
-import { type NoteStrings } from './strings.js';
+import { type NoteStrings, type NoteStringsInput } from './strings.js';
 import { type Scheme, type Theme } from './theme.js';
 /**
  * The host contract: everything the renderer needs from the notebook a note lives in, given by
@@ -50,10 +50,45 @@ export interface NoteHost {
      * A task box was ticked. The ordinal counts the boxes of the note as the host gave it, frontmatter
      * included; the host applies it with `toggleTaskAt`, a one-character change of its bytes. The
      * package never writes the note.
+     *
+     * Answered with a promise, the item is locked under `strings.updating` until it settles: resolved,
+     * the box is what the host's bytes say; rejected, it returns to the state its source holds and the
+     * item says `strings.notSaved` for a moment. Ticks are queued, so a host is never asked again
+     * before its last save settled, and applies each one to its latest bytes. Answered with anything
+     * but a promise, no lock is drawn.
      */
-    readonly onToggleTask?: (ordinal: number) => void;
+    readonly onToggleTask?: (ordinal: number) => unknown;
     /** Whether the notebook keeps a file under that name. Only an embed reaches a file. */
     readonly keeps?: (name: string) => boolean;
+    /**
+     * The names of notes that start with, or contain, what an author typed after `[[` in edit mode,
+     * best first. Without it, the editor suggests nothing.
+     */
+    readonly suggest?: (query: string) => readonly string[] | PromiseLike<readonly string[]>;
+    /**
+     * Keeps a file the author attached in edit mode — from the attach dialog, pasted or dropped — in
+     * the notebook, under the name and with the description the author gave (a pasted or dropped file
+     * has its own name and none), and answers the name it is kept under, which the editor embeds as
+     * `![[name]]` (#75, #78). The package never stores a file. Without it, the editor offers no file
+     * from the computer.
+     *
+     * While it keeps the file, the host may report each step through `progress`, which the paperclip
+     * shows and announces; a promise rejected with an `AttachRefusal` has the paperclip say why until
+     * the author acts (#88). A host that ignores `progress` and rejects with an error keeps the
+     * paperclip's own words.
+     */
+    readonly attach?: (file: File, attributes: AttachAttributes, progress: (report: AttachProgress) => void) => string | PromiseLike<string>;
+    /**
+     * The files the notebook keeps, with their names, which the attach dialog lists for the author to
+     * embed one (#78). Without it, the dialog offers no file of the notebook.
+     */
+    readonly files?: () => readonly KeptFileEntry[] | PromiseLike<readonly KeptFileEntry[]>;
+    /**
+     * What the notebook knows of a file it keeps (#77): its media type, its size and where its bytes
+     * are. With it, the package draws the file as MemorySmith does, by its type — an image, an audio,
+     * a video, or a card — and `null` is a name it keeps nothing under. `renderAttachment` wins over it.
+     */
+    readonly fileOf?: (name: string) => KeptFile | null | PromiseLike<KeptFile | null>;
     /**
      * Draws a file the notebook keeps where a note embeds it: an image, audio, video, or a card. The
      * dimensions are the ones the embed declared, in CSS pixels, or `null`.
@@ -62,7 +97,7 @@ export interface NoteHost {
     /** Draws a link to an internal address, through the host's router. */
     readonly renderLink?: (link: LinkRequest) => ReactNode;
     /** The words the page shows, in the reader's language; each one left out is MemorySmith's English. */
-    readonly strings?: Partial<NoteStrings>;
+    readonly strings?: NoteStringsInput;
     /**
      * How the note looks: a theme (`defineTheme`), or `light` or `dark`, which are the default
      * theme — MemorySmith's look — in that scheme. Defaults to the default theme.
@@ -108,6 +143,46 @@ export interface EmbeddedNote {
     readonly address: string | null;
 }
 /** A file to draw: its name, and the dimensions the embed declared. */
+/** A file the notebook keeps, as the host describes it to draw it (#77). */
+export interface KeptFile {
+    /** Its media type, which decides how it is drawn; the name decides nothing (§5.8). */
+    readonly mimeType: string;
+    /** Its size, in bytes. */
+    readonly bytes: number;
+    /** Where its bytes are shown: the source of an image or a player, and what a card opens. */
+    readonly url: string;
+    /** Where its bytes are saved from. Defaults to `url`. */
+    readonly downloadUrl?: string;
+    /** What the author said it is: an image's `alt`, a line of its card. */
+    readonly description?: string;
+}
+/** A kept file with the name it is kept under, as `files` lists it (#78). */
+export interface KeptFileEntry extends KeptFile {
+    readonly name: string;
+}
+/** A step of keeping a file, as the host words it (#88). */
+export interface AttachProgress {
+    /** What is happening, in the reader's language: "Sending part 12 of 40". */
+    readonly message: string;
+    /** How much is done, from 0 to 1, when the host knows it: drawn as a determinate indicator. */
+    readonly fraction?: number;
+}
+/**
+ * Why the host would not keep a file, what `attach` rejects with (#88): a plain object, so that an
+ * `Error`, whose message is meant for a developer, keeps the paperclip's own words.
+ */
+export interface AttachRefusal {
+    /** Why, in the reader's language: "An attached file goes up to 100 MB". */
+    readonly message: string;
+}
+/** Whether a rejection is a refusal the host worded for the author, and not an error. */
+export declare function isAttachRefusal(value: unknown): value is AttachRefusal;
+/** What the author said of a file they attach (#78). */
+export interface AttachAttributes {
+    /** The name to keep it under; the host may answer another, when that one is taken. */
+    readonly name: string;
+    readonly description: string;
+}
 export interface AttachmentRequest {
     readonly name: string;
     readonly width: number | null;
@@ -134,6 +209,10 @@ export interface ResolvedHost {
     readonly remoteNotice: boolean;
     readonly loadNote: ((name: string) => Promise<EmbeddedNote | null>) | null;
     readonly keeps: (name: string) => boolean;
+    readonly suggest: ((query: string) => readonly string[] | PromiseLike<readonly string[]>) | null;
+    readonly attach: ((file: File, attributes: AttachAttributes, progress: (report: AttachProgress) => void) => string | PromiseLike<string>) | null;
+    readonly files: (() => readonly KeptFileEntry[] | PromiseLike<readonly KeptFileEntry[]>) | null;
+    readonly fileOf: ((name: string) => KeptFile | null | PromiseLike<KeptFile | null>) | null;
     readonly renderAttachment: ((file: AttachmentRequest) => ReactNode) | null;
     readonly renderLink: (link: LinkRequest) => ReactNode;
     readonly strings: NoteStrings;

package/dist/host.js

@@ -2,6 +2,14 @@ import { jsx as _jsx } from "react/jsx-runtime";
 import { createContext, useContext } from 'react';
 import { withDefaults } from './strings.js';
 import { DEFAULT_THEME, schemeOf } from './theme.js';
+/** Whether a rejection is a refusal the host worded for the author, and not an error. */
+export function isAttachRefusal(value) {
+    return (typeof value === 'object' &&
+        value !== null &&
+        !(value instanceof Error) &&
+        typeof value.message === 'string' &&
+        value.message.length > 0);
+}
 /**
  * Every member of the contract, by name. The `satisfies` is what makes it complete: a member added
  * to `NoteHost` and not listed here does not compile.
@@ -16,6 +24,10 @@ export const HOST_KEYS = Object.keys({
     writable: 1,
     onToggleTask: 1,
     keeps: 1,
+    suggest: 1,
+    attach: 1,
+    files: 1,
+    fileOf: 1,
     renderAttachment: 1,
     renderLink: 1,
     strings: 1,
@@ -43,6 +55,10 @@ export function resolveHost(host) {
         remoteNotice: host.remoteNotice ?? true,
         loadNote: host.loadNote ?? null,
         keeps: host.keeps ?? never,
+        suggest: host.suggest ?? null,
+        attach: host.attach ?? null,
+        files: host.files ?? null,
+        fileOf: host.fileOf ?? null,
         renderAttachment: host.renderAttachment ?? null,
         renderLink: host.renderLink ?? plainLink,
         strings: withDefaults(host.strings),

package/dist/index.d.ts

@@ -1,7 +1,9 @@
-export { NoteBody, type NoteBodyProps } from './NoteBody.js';
-export type { AttachmentRequest, EmbeddedNote, LinkChoiceNote, LinkChoices, LinkRequest, NoteHost } from './host.js';
-export { ENGLISH, type NoteStrings } from './strings.js';
-export { customPropertyOf, DEFAULT_THEME, defineTheme, THEME_PROPERTIES, THEME_SLOTS, type BlockquoteSlotProps, type CalloutSlotProps, type CodeBlockSlotProps, type DiagramSlotProps, type EmbedSlotProps, type FootnotesSlotProps, type HeadingSlotProps, type InlineCodeSlotProps, type PropertiesSlotProps, type Scheme, type TableSlotProps, type TaskBoxSlotProps, type Theme, type ThemeComponents, type ThemeProperties, type WikilinkSlotProps, } from './theme.js';
+export { NoteBody, type NoteBodyProps, type NoteMode } from './NoteBody.js';
+export type { SaveAction, SaveNotice, SaveOutcome, SaveRefusal } from './edit/saves.js';
+export { isAttachRefusal } from './host.js';
+export type { AttachAttributes, AttachmentRequest, AttachProgress, AttachRefusal, EmbeddedNote, KeptFile, KeptFileEntry, LinkChoiceNote, LinkChoices, LinkRequest, NoteHost } from './host.js';
+export { ENGLISH, type EditorWords, type NoteStrings, type NoteStringsInput } from './strings.js';
+export { customPropertyOf, DEFAULT_THEME, defineTheme, THEME_PROPERTIES, THEME_SLOTS, type BlockquoteSlotProps, type CalloutSlotProps, type CodeBlockSlotProps, type DiagramSlotProps, type EmbedSlotProps, type FootnotesSlotProps, type HeadingSlotProps, type InlineCodeSlotProps, type ModeSwitchSlotProps, type AttachmentSlotProps, type PropertiesSlotProps, type Scheme, type TableSlotProps, type TaskBoxSlotProps, type Theme, type ThemeComponents, type ThemeProperties, type WikilinkSlotProps, } from './theme.js';
 export { followable } from './address.js';
 export { readDimensions, readImageAlt, type ImageAlt } from './image-dimensions.js';
 export { codeRegions, fenceRegions, headingKey, remoteImageHosts, resolveWikilinks, splitFrontmatter, tableRegions, toUnixNewlines, type SplitDocument, } from './markdown.js';

package/dist/index.js

@@ -1,5 +1,6 @@
 // The entry point of @memorysmithapp/markdown-renderer.
 export { NoteBody } from './NoteBody.js';
+export { isAttachRefusal } from './host.js';
 export { ENGLISH } from './strings.js';
 export { customPropertyOf, DEFAULT_THEME, defineTheme, THEME_PROPERTIES, THEME_SLOTS, } from './theme.js';
 export { followable } from './address.js';

package/dist/mode-icons.d.ts

@@ -0,0 +1,6 @@
+export declare const ICON_EDIT: import("react").JSX.Element;
+export declare const ICON_VIEW: import("react").JSX.Element;
+export declare const ICON_MARKDOWN: import("react").JSX.Element;
+export declare const ICON_COPY: import("react").JSX.Element;
+export declare const ICON_CHECK: import("react").JSX.Element;
+export declare const ICON_CLOSE: import("react").JSX.Element;

package/dist/mode-icons.js

@@ -0,0 +1,11 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+// The icons of the switch between reading and editing (#51): Lucide's pencil and eye (ISC), drawn
+// in the current colour at the size of the text. Apart from the editor, which loads on demand.
+const svg = (...paths) => (_jsx("svg", { className: "mode-switch-glyph", viewBox: "0 0 24 24", width: "1em", height: "1em", fill: "none", stroke: "currentColor", strokeWidth: "2", strokeLinecap: "round", strokeLinejoin: "round", "aria-hidden": "true", children: paths.map((d) => (_jsx("path", { d: d }, d))) }));
+export const ICON_EDIT = svg('M21.17 6.81a1 1 0 0 0-3.99-3.99L3.84 16.17a2 2 0 0 0-.5.83l-1.32 4.35a.5.5 0 0 0 .62.62l4.35-1.32a2 2 0 0 0 .83-.5z', 'm15 5 4 4');
+export const ICON_VIEW = svg('M2.06 12.35a1 1 0 0 1 0-.7 10.75 10.75 0 0 1 19.88 0 1 1 0 0 1 0 .7 10.75 10.75 0 0 1-19.88 0', 'M12 9a3 3 0 1 0 0 6 3 3 0 0 0 0-6z');
+// The buttons beside the switch (#76): Lucide's file-code, copy, check and x (ISC).
+export const ICON_MARKDOWN = svg('M10 12.5 8 15l2 2.5', 'm14 12.5 2 2.5-2 2.5', 'M14 2v4a2 2 0 0 0 2 2h4', 'M15 2H6a2 2 0 0 0-2 2v16a2 2 0 0 0 2 2h12a2 2 0 0 0 2-2V7z');
+export const ICON_COPY = svg('M10 8h10a2 2 0 0 1 2 2v10a2 2 0 0 1-2 2H10a2 2 0 0 1-2-2V10a2 2 0 0 1 2-2z', 'M4 16c-1.1 0-2-.9-2-2V4c0-1.1.9-2 2-2h10c1.1 0 2 .9 2 2');
+export const ICON_CHECK = svg('M20 6 9 17l-5-5');
+export const ICON_CLOSE = svg('M18 6 6 18', 'm6 6 12 12');

package/dist/prism-grammars.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Every grammar `refractor` 5.0.0 carries — Prism's grammars, as a hast tree — written by
+ * `scripts/prism-grammars.mjs` (#84): its identifier, its aliases, the name a person reads, and the
+ * import that loads it, so a bundler splits each into a chunk a page downloads only when a note
+ * names it. Do not edit by hand: run the script.
+ */
+import type { Syntax } from 'refractor/core';
+export interface Grammar {
+    readonly id: string;
+    readonly title: string;
+    readonly aliases: readonly string[];
+    /** A part of other grammars, or a diagram's: loaded when named, never offered. */
+    readonly part?: true;
+    readonly load: () => Promise<{
+        default: Syntax;
+    }>;
+}
+export declare const GRAMMARS: readonly Grammar[];

package/dist/prism-grammars.js

@@ -0,0 +1,305 @@
+/**
+ * Every grammar `refractor` 5.0.0 carries — Prism's grammars, as a hast tree — written by
+ * `scripts/prism-grammars.mjs` (#84): its identifier, its aliases, the name a person reads, and the
+ * import that loads it, so a bundler splits each into a chunk a page downloads only when a note
+ * names it. Do not edit by hand: run the script.
+ */
+export const GRAMMARS = [
+    { id: "abap", title: "ABAP", aliases: [], load: () => import('refractor/abap') },
+    { id: "abnf", title: "ABNF", aliases: [], load: () => import('refractor/abnf') },
+    { id: "actionscript", title: "ActionScript", aliases: [], load: () => import('refractor/actionscript') },
+    { id: "ada", title: "Ada", aliases: [], load: () => import('refractor/ada') },
+    { id: "agda", title: "Agda", aliases: [], load: () => import('refractor/agda') },
+    { id: "al", title: "AL", aliases: [], load: () => import('refractor/al') },
+    { id: "antlr4", title: "ANTLR4", aliases: ["g4"], load: () => import('refractor/antlr4') },
+    { id: "apacheconf", title: "Apache Configuration", aliases: [], load: () => import('refractor/apacheconf') },
+    { id: "apex", title: "Apex", aliases: [], load: () => import('refractor/apex') },
+    { id: "apl", title: "APL", aliases: [], load: () => import('refractor/apl') },
+    { id: "applescript", title: "AppleScript", aliases: [], load: () => import('refractor/applescript') },
+    { id: "aql", title: "AQL", aliases: [], load: () => import('refractor/aql') },
+    { id: "arduino", title: "Arduino", aliases: ["ino"], load: () => import('refractor/arduino') },
+    { id: "arff", title: "ARFF", aliases: [], load: () => import('refractor/arff') },
+    { id: "armasm", title: "ARM Assembly", aliases: ["arm-asm"], load: () => import('refractor/armasm') },
+    { id: "arturo", title: "Arturo", aliases: ["art"], load: () => import('refractor/arturo') },
+    { id: "asciidoc", title: "AsciiDoc", aliases: ["adoc"], load: () => import('refractor/asciidoc') },
+    { id: "asm6502", title: "6502 Assembly", aliases: [], load: () => import('refractor/asm6502') },
+    { id: "asmatmel", title: "Atmel AVR Assembly", aliases: [], load: () => import('refractor/asmatmel') },
+    { id: "aspnet", title: "ASP.NET (C#)", aliases: [], load: () => import('refractor/aspnet') },
+    { id: "autohotkey", title: "AutoHotkey", aliases: [], load: () => import('refractor/autohotkey') },
+    { id: "autoit", title: "AutoIt", aliases: [], load: () => import('refractor/autoit') },
+    { id: "avisynth", title: "AviSynth", aliases: ["avs"], load: () => import('refractor/avisynth') },
+    { id: "avro-idl", title: "Avro IDL", aliases: ["avdl"], load: () => import('refractor/avro-idl') },
+    { id: "awk", title: "AWK", aliases: ["gawk"], load: () => import('refractor/awk') },
+    { id: "bash", title: "Bash", aliases: ["sh", "shell"], load: () => import('refractor/bash') },
+    { id: "basic", title: "BASIC", aliases: [], load: () => import('refractor/basic') },
+    { id: "batch", title: "Batch", aliases: [], load: () => import('refractor/batch') },
+    { id: "bbcode", title: "BBcode", aliases: ["shortcode"], load: () => import('refractor/bbcode') },
+    { id: "bbj", title: "BBj", aliases: [], load: () => import('refractor/bbj') },
+    { id: "bicep", title: "Bicep", aliases: [], load: () => import('refractor/bicep') },
+    { id: "birb", title: "Birb", aliases: [], load: () => import('refractor/birb') },
+    { id: "bison", title: "Bison", aliases: [], load: () => import('refractor/bison') },
+    { id: "bnf", title: "BNF", aliases: ["rbnf"], load: () => import('refractor/bnf') },
+    { id: "bqn", title: "BQN", aliases: [], load: () => import('refractor/bqn') },
+    { id: "brainfuck", title: "Brainfuck", aliases: [], load: () => import('refractor/brainfuck') },
+    { id: "brightscript", title: "BrightScript", aliases: [], load: () => import('refractor/brightscript') },
+    { id: "bro", title: "Bro", aliases: [], load: () => import('refractor/bro') },
+    { id: "bsl", title: "BSL (1C:Enterprise)", aliases: ["oscript"], load: () => import('refractor/bsl') },
+    { id: "c", title: "C", aliases: [], load: () => import('refractor/c') },
+    { id: "cfscript", title: "CFScript", aliases: ["cfc"], load: () => import('refractor/cfscript') },
+    { id: "chaiscript", title: "ChaiScript", aliases: [], load: () => import('refractor/chaiscript') },
+    { id: "cil", title: "CIL", aliases: [], load: () => import('refractor/cil') },
+    { id: "cilkc", title: "Cilk/C", aliases: ["cilk-c"], load: () => import('refractor/cilkc') },
+    { id: "cilkcpp", title: "Cilk/C++", aliases: ["cilk", "cilk-cpp"], load: () => import('refractor/cilkcpp') },
+    { id: "clike", title: "clike", aliases: [], part: true, load: () => import('refractor/clike') },
+    { id: "clojure", title: "Clojure", aliases: [], load: () => import('refractor/clojure') },
+    { id: "cmake", title: "CMake", aliases: [], load: () => import('refractor/cmake') },
+    { id: "cobol", title: "COBOL", aliases: [], load: () => import('refractor/cobol') },
+    { id: "coffeescript", title: "CoffeeScript", aliases: ["coffee"], load: () => import('refractor/coffeescript') },
+    { id: "concurnas", title: "Concurnas", aliases: ["conc"], load: () => import('refractor/concurnas') },
+    { id: "cooklang", title: "Cooklang", aliases: [], load: () => import('refractor/cooklang') },
+    { id: "coq", title: "Coq", aliases: [], load: () => import('refractor/coq') },
+    { id: "cpp", title: "C++", aliases: [], load: () => import('refractor/cpp') },
+    { id: "crystal", title: "Crystal", aliases: [], load: () => import('refractor/crystal') },
+    { id: "csharp", title: "C#", aliases: ["cs", "dotnet"], load: () => import('refractor/csharp') },
+    { id: "cshtml", title: "Razor C#", aliases: ["razor"], load: () => import('refractor/cshtml') },
+    { id: "csp", title: "Content-Security-Policy", aliases: [], load: () => import('refractor/csp') },
+    { id: "css", title: "CSS", aliases: [], load: () => import('refractor/css') },
+    { id: "css-extras", title: "css-extras", aliases: [], part: true, load: () => import('refractor/css-extras') },
+    { id: "csv", title: "CSV", aliases: [], load: () => import('refractor/csv') },
+    { id: "cue", title: "CUE", aliases: [], load: () => import('refractor/cue') },
+    { id: "cypher", title: "Cypher", aliases: [], load: () => import('refractor/cypher') },
+    { id: "d", title: "D", aliases: [], load: () => import('refractor/d') },
+    { id: "dart", title: "Dart", aliases: [], load: () => import('refractor/dart') },
+    { id: "dataweave", title: "DataWeave", aliases: [], load: () => import('refractor/dataweave') },
+    { id: "dax", title: "DAX", aliases: [], load: () => import('refractor/dax') },
+    { id: "dhall", title: "Dhall", aliases: [], load: () => import('refractor/dhall') },
+    { id: "diff", title: "Diff", aliases: [], load: () => import('refractor/diff') },
+    { id: "django", title: "Django/Jinja2", aliases: ["jinja2"], load: () => import('refractor/django') },
+    { id: "dns-zone-file", title: "DNS zone file", aliases: ["dns-zone"], load: () => import('refractor/dns-zone-file') },
+    { id: "docker", title: "Docker", aliases: ["dockerfile"], load: () => import('refractor/docker') },
+    { id: "dot", title: "DOT (Graphviz)", aliases: ["gv"], load: () => import('refractor/dot') },
+    { id: "ebnf", title: "EBNF", aliases: [], load: () => import('refractor/ebnf') },
+    { id: "editorconfig", title: "EditorConfig", aliases: [], load: () => import('refractor/editorconfig') },
+    { id: "eiffel", title: "Eiffel", aliases: [], load: () => import('refractor/eiffel') },
+    { id: "ejs", title: "EJS", aliases: ["eta"], load: () => import('refractor/ejs') },
+    { id: "elixir", title: "Elixir", aliases: [], load: () => import('refractor/elixir') },
+    { id: "elm", title: "Elm", aliases: [], load: () => import('refractor/elm') },
+    { id: "erb", title: "ERB", aliases: [], load: () => import('refractor/erb') },
+    { id: "erlang", title: "Erlang", aliases: [], load: () => import('refractor/erlang') },
+    { id: "etlua", title: "Embedded Lua templating", aliases: [], load: () => import('refractor/etlua') },
+    { id: "excel-formula", title: "Excel Formula", aliases: ["xls", "xlsx"], load: () => import('refractor/excel-formula') },
+    { id: "factor", title: "Factor", aliases: [], load: () => import('refractor/factor') },
+    { id: "false", title: "False", aliases: [], load: () => import('refractor/false') },
+    { id: "firestore-security-rules", title: "Firestore security rules", aliases: [], load: () => import('refractor/firestore-security-rules') },
+    { id: "flow", title: "Flow", aliases: [], load: () => import('refractor/flow') },
+    { id: "fortran", title: "Fortran", aliases: [], load: () => import('refractor/fortran') },
+    { id: "fsharp", title: "F#", aliases: [], load: () => import('refractor/fsharp') },
+    { id: "ftl", title: "FreeMarker Template Language", aliases: [], load: () => import('refractor/ftl') },
+    { id: "gap", title: "GAP (CAS)", aliases: [], load: () => import('refractor/gap') },
+    { id: "gcode", title: "G-code", aliases: [], load: () => import('refractor/gcode') },
+    { id: "gdscript", title: "GDScript", aliases: [], load: () => import('refractor/gdscript') },
+    { id: "gedcom", title: "GEDCOM", aliases: [], load: () => import('refractor/gedcom') },
+    { id: "gettext", title: "gettext", aliases: ["po"], load: () => import('refractor/gettext') },
+    { id: "gherkin", title: "Gherkin", aliases: [], load: () => import('refractor/gherkin') },
+    { id: "git", title: "Git", aliases: [], load: () => import('refractor/git') },
+    { id: "glsl", title: "GLSL", aliases: [], load: () => import('refractor/glsl') },
+    { id: "gml", title: "GameMaker Language", aliases: ["gamemakerlanguage"], load: () => import('refractor/gml') },
+    { id: "gn", title: "GN", aliases: ["gni"], load: () => import('refractor/gn') },
+    { id: "go", title: "Go", aliases: [], load: () => import('refractor/go') },
+    { id: "go-module", title: "Go module", aliases: ["go-mod"], load: () => import('refractor/go-module') },
+    { id: "gradle", title: "Gradle", aliases: [], load: () => import('refractor/gradle') },
+    { id: "graphql", title: "GraphQL", aliases: [], load: () => import('refractor/graphql') },
+    { id: "groovy", title: "Groovy", aliases: [], load: () => import('refractor/groovy') },
+    { id: "haml", title: "Haml", aliases: [], load: () => import('refractor/haml') },
+    { id: "handlebars", title: "Handlebars", aliases: ["hbs", "mustache"], load: () => import('refractor/handlebars') },
+    { id: "haskell", title: "Haskell", aliases: ["hs"], load: () => import('refractor/haskell') },
+    { id: "haxe", title: "Haxe", aliases: [], load: () => import('refractor/haxe') },
+    { id: "hcl", title: "HCL", aliases: [], load: () => import('refractor/hcl') },
+    { id: "hlsl", title: "HLSL", aliases: [], load: () => import('refractor/hlsl') },
+    { id: "hoon", title: "Hoon", aliases: [], load: () => import('refractor/hoon') },
+    { id: "hpkp", title: "HTTP Public-Key-Pins", aliases: [], load: () => import('refractor/hpkp') },
+    { id: "hsts", title: "HTTP Strict-Transport-Security", aliases: [], load: () => import('refractor/hsts') },
+    { id: "http", title: "HTTP", aliases: [], load: () => import('refractor/http') },
+    { id: "ichigojam", title: "IchigoJam", aliases: [], load: () => import('refractor/ichigojam') },
+    { id: "icon", title: "Icon", aliases: [], load: () => import('refractor/icon') },
+    { id: "icu-message-format", title: "ICU Message Format", aliases: [], load: () => import('refractor/icu-message-format') },
+    { id: "idris", title: "Idris", aliases: ["idr"], load: () => import('refractor/idris') },
+    { id: "iecst", title: "Structured Text (IEC 61131-3)", aliases: [], load: () => import('refractor/iecst') },
+    { id: "ignore", title: ".ignore", aliases: ["gitignore", "hgignore", "npmignore"], load: () => import('refractor/ignore') },
+    { id: "inform7", title: "Inform 7", aliases: [], load: () => import('refractor/inform7') },
+    { id: "ini", title: "INI", aliases: [], load: () => import('refractor/ini') },
+    { id: "io", title: "Io", aliases: [], load: () => import('refractor/io') },
+    { id: "j", title: "J", aliases: [], load: () => import('refractor/j') },
+    { id: "java", title: "Java", aliases: [], load: () => import('refractor/java') },
+    { id: "javadoc", title: "JavaDoc", aliases: [], load: () => import('refractor/javadoc') },
+    { id: "javadoclike", title: "javadoclike", aliases: [], part: true, load: () => import('refractor/javadoclike') },
+    { id: "javascript", title: "JavaScript", aliases: ["js"], load: () => import('refractor/javascript') },
+    { id: "javastacktrace", title: "Java stack trace", aliases: [], load: () => import('refractor/javastacktrace') },
+    { id: "jexl", title: "Jexl", aliases: [], load: () => import('refractor/jexl') },
+    { id: "jolie", title: "Jolie", aliases: [], load: () => import('refractor/jolie') },
+    { id: "jq", title: "JQ", aliases: [], load: () => import('refractor/jq') },
+    { id: "js-extras", title: "js-extras", aliases: [], part: true, load: () => import('refractor/js-extras') },
+    { id: "js-templates", title: "js-templates", aliases: [], part: true, load: () => import('refractor/js-templates') },
+    { id: "jsdoc", title: "JSDoc", aliases: [], load: () => import('refractor/jsdoc') },
+    { id: "json", title: "JSON", aliases: ["webmanifest"], load: () => import('refractor/json') },
+    { id: "json5", title: "JSON5", aliases: [], load: () => import('refractor/json5') },
+    { id: "jsonp", title: "JSONP", aliases: [], load: () => import('refractor/jsonp') },
+    { id: "jsstacktrace", title: "JS stack trace", aliases: [], load: () => import('refractor/jsstacktrace') },
+    { id: "jsx", title: "JSX", aliases: [], load: () => import('refractor/jsx') },
+    { id: "julia", title: "Julia", aliases: [], load: () => import('refractor/julia') },
+    { id: "keepalived", title: "Keepalived Configure", aliases: [], load: () => import('refractor/keepalived') },
+    { id: "keyman", title: "Keyman", aliases: [], load: () => import('refractor/keyman') },
+    { id: "kotlin", title: "Kotlin", aliases: ["kt", "kts"], load: () => import('refractor/kotlin') },
+    { id: "kumir", title: "KuMir", aliases: ["kum"], load: () => import('refractor/kumir') },
+    { id: "kusto", title: "Kusto", aliases: [], load: () => import('refractor/kusto') },
+    { id: "latex", title: "LaTeX", aliases: ["context", "tex"], load: () => import('refractor/latex') },
+    { id: "latte", title: "Latte", aliases: [], load: () => import('refractor/latte') },
+    { id: "less", title: "Less", aliases: [], load: () => import('refractor/less') },
+    { id: "lilypond", title: "LilyPond", aliases: ["ly"], load: () => import('refractor/lilypond') },
+    { id: "linker-script", title: "Linker script", aliases: ["ld"], load: () => import('refractor/linker-script') },
+    { id: "liquid", title: "Liquid", aliases: [], load: () => import('refractor/liquid') },
+    { id: "lisp", title: "Lisp", aliases: ["elisp", "emacs", "emacs-lisp"], load: () => import('refractor/lisp') },
+    { id: "livescript", title: "LiveScript", aliases: [], load: () => import('refractor/livescript') },
+    { id: "llvm", title: "LLVM IR", aliases: [], load: () => import('refractor/llvm') },
+    { id: "log", title: "Log file", aliases: [], load: () => import('refractor/log') },
+    { id: "lolcode", title: "LOLCODE", aliases: [], load: () => import('refractor/lolcode') },
+    { id: "lua", title: "Lua", aliases: [], load: () => import('refractor/lua') },
+    { id: "magma", title: "Magma (CAS)", aliases: [], load: () => import('refractor/magma') },
+    { id: "makefile", title: "Makefile", aliases: [], load: () => import('refractor/makefile') },
+    { id: "markdown", title: "Markdown", aliases: ["md"], load: () => import('refractor/markdown') },
+    { id: "markup", title: "Markup (HTML, XML, SVG)", aliases: ["atom", "html", "mathml", "rss", "ssml", "svg", "xml"], load: () => import('refractor/markup') },
+    { id: "markup-templating", title: "markup-templating", aliases: [], part: true, load: () => import('refractor/markup-templating') },
+    { id: "mata", title: "Mata", aliases: [], load: () => import('refractor/mata') },
+    { id: "matlab", title: "MATLAB", aliases: [], load: () => import('refractor/matlab') },
+    { id: "maxscript", title: "MAXScript", aliases: [], load: () => import('refractor/maxscript') },
+    { id: "mel", title: "MEL", aliases: [], load: () => import('refractor/mel') },
+    { id: "mermaid", title: "mermaid", aliases: [], part: true, load: () => import('refractor/mermaid') },
+    { id: "metafont", title: "METAFONT", aliases: [], load: () => import('refractor/metafont') },
+    { id: "mizar", title: "Mizar", aliases: [], load: () => import('refractor/mizar') },
+    { id: "mongodb", title: "MongoDB", aliases: [], load: () => import('refractor/mongodb') },
+    { id: "monkey", title: "Monkey", aliases: [], load: () => import('refractor/monkey') },
+    { id: "moonscript", title: "MoonScript", aliases: ["moon"], load: () => import('refractor/moonscript') },
+    { id: "n1ql", title: "N1QL", aliases: [], load: () => import('refractor/n1ql') },
+    { id: "n4js", title: "N4JS", aliases: ["n4jsd"], load: () => import('refractor/n4js') },
+    { id: "nand2tetris-hdl", title: "Nand To Tetris HDL", aliases: [], load: () => import('refractor/nand2tetris-hdl') },
+    { id: "naniscript", title: "Naninovel Script", aliases: ["nani"], load: () => import('refractor/naniscript') },
+    { id: "nasm", title: "NASM", aliases: [], load: () => import('refractor/nasm') },
+    { id: "neon", title: "NEON", aliases: [], load: () => import('refractor/neon') },
+    { id: "nevod", title: "Nevod", aliases: [], load: () => import('refractor/nevod') },
+    { id: "nginx", title: "nginx", aliases: [], load: () => import('refractor/nginx') },
+    { id: "nim", title: "Nim", aliases: [], load: () => import('refractor/nim') },
+    { id: "nix", title: "Nix", aliases: [], load: () => import('refractor/nix') },
+    { id: "nsis", title: "NSIS", aliases: [], load: () => import('refractor/nsis') },
+    { id: "objectivec", title: "Objective-C", aliases: ["objc"], load: () => import('refractor/objectivec') },
+    { id: "ocaml", title: "OCaml", aliases: [], load: () => import('refractor/ocaml') },
+    { id: "odin", title: "Odin", aliases: [], load: () => import('refractor/odin') },
+    { id: "opencl", title: "OpenCL", aliases: [], load: () => import('refractor/opencl') },
+    { id: "openqasm", title: "OpenQasm", aliases: ["qasm"], load: () => import('refractor/openqasm') },
+    { id: "oz", title: "Oz", aliases: [], load: () => import('refractor/oz') },
+    { id: "parigp", title: "PARI/GP", aliases: [], load: () => import('refractor/parigp') },
+    { id: "parser", title: "Parser", aliases: [], load: () => import('refractor/parser') },
+    { id: "pascal", title: "Pascal", aliases: ["objectpascal"], load: () => import('refractor/pascal') },
+    { id: "pascaligo", title: "Pascaligo", aliases: [], load: () => import('refractor/pascaligo') },
+    { id: "pcaxis", title: "PC-Axis", aliases: ["px"], load: () => import('refractor/pcaxis') },
+    { id: "peoplecode", title: "PeopleCode", aliases: ["pcode"], load: () => import('refractor/peoplecode') },
+    { id: "perl", title: "Perl", aliases: [], load: () => import('refractor/perl') },
+    { id: "php", title: "PHP", aliases: [], load: () => import('refractor/php') },
+    { id: "php-extras", title: "php-extras", aliases: [], part: true, load: () => import('refractor/php-extras') },
+    { id: "phpdoc", title: "PHPDoc", aliases: [], load: () => import('refractor/phpdoc') },
+    { id: "plant-uml", title: "PlantUML", aliases: ["plantuml"], load: () => import('refractor/plant-uml') },
+    { id: "plsql", title: "PL/SQL", aliases: [], load: () => import('refractor/plsql') },
+    { id: "powerquery", title: "PowerQuery", aliases: ["mscript", "pq"], load: () => import('refractor/powerquery') },
+    { id: "powershell", title: "PowerShell", aliases: [], load: () => import('refractor/powershell') },
+    { id: "processing", title: "Processing", aliases: [], load: () => import('refractor/processing') },
+    { id: "prolog", title: "Prolog", aliases: [], load: () => import('refractor/prolog') },
+    { id: "promql", title: "PromQL", aliases: [], load: () => import('refractor/promql') },
+    { id: "properties", title: ".properties", aliases: [], load: () => import('refractor/properties') },
+    { id: "protobuf", title: "Protocol Buffers", aliases: [], load: () => import('refractor/protobuf') },
+    { id: "psl", title: "PATROL Scripting Language", aliases: [], load: () => import('refractor/psl') },
+    { id: "pug", title: "Pug", aliases: [], load: () => import('refractor/pug') },
+    { id: "puppet", title: "Puppet", aliases: [], load: () => import('refractor/puppet') },
+    { id: "pure", title: "Pure", aliases: [], load: () => import('refractor/pure') },
+    { id: "purebasic", title: "PureBasic", aliases: ["pbfasm"], load: () => import('refractor/purebasic') },
+    { id: "purescript", title: "PureScript", aliases: ["purs"], load: () => import('refractor/purescript') },
+    { id: "python", title: "Python", aliases: ["py"], load: () => import('refractor/python') },
+    { id: "q", title: "Q (kdb+ database)", aliases: [], load: () => import('refractor/q') },
+    { id: "qml", title: "QML", aliases: [], load: () => import('refractor/qml') },
+    { id: "qore", title: "Qore", aliases: [], load: () => import('refractor/qore') },
+    { id: "qsharp", title: "Q#", aliases: ["qs"], load: () => import('refractor/qsharp') },
+    { id: "r", title: "R", aliases: [], load: () => import('refractor/r') },
+    { id: "racket", title: "Racket", aliases: ["rkt"], load: () => import('refractor/racket') },
+    { id: "reason", title: "Reason", aliases: [], load: () => import('refractor/reason') },
+    { id: "regex", title: "Regex", aliases: [], load: () => import('refractor/regex') },
+    { id: "rego", title: "Rego", aliases: [], load: () => import('refractor/rego') },
+    { id: "renpy", title: "Ren'py", aliases: ["rpy"], load: () => import('refractor/renpy') },
+    { id: "rescript", title: "ReScript", aliases: ["res"], load: () => import('refractor/rescript') },
+    { id: "rest", title: "reST (reStructuredText)", aliases: [], load: () => import('refractor/rest') },
+    { id: "rip", title: "Rip", aliases: [], load: () => import('refractor/rip') },
+    { id: "roboconf", title: "Roboconf", aliases: [], load: () => import('refractor/roboconf') },
+    { id: "robotframework", title: "Robot Framework", aliases: ["robot"], load: () => import('refractor/robotframework') },
+    { id: "ruby", title: "Ruby", aliases: ["rb"], load: () => import('refractor/ruby') },
+    { id: "rust", title: "Rust", aliases: [], load: () => import('refractor/rust') },
+    { id: "sas", title: "SAS", aliases: [], load: () => import('refractor/sas') },
+    { id: "sass", title: "Sass (Sass)", aliases: [], load: () => import('refractor/sass') },
+    { id: "scala", title: "Scala", aliases: [], load: () => import('refractor/scala') },
+    { id: "scheme", title: "Scheme", aliases: [], load: () => import('refractor/scheme') },
+    { id: "scss", title: "Sass (SCSS)", aliases: [], load: () => import('refractor/scss') },
+    { id: "shell-session", title: "Shell session", aliases: ["sh-session", "shellsession"], load: () => import('refractor/shell-session') },
+    { id: "smali", title: "Smali", aliases: [], load: () => import('refractor/smali') },
+    { id: "smalltalk", title: "Smalltalk", aliases: [], load: () => import('refractor/smalltalk') },
+    { id: "smarty", title: "Smarty", aliases: [], load: () => import('refractor/smarty') },
+    { id: "sml", title: "SML", aliases: ["smlnj"], load: () => import('refractor/sml') },
+    { id: "solidity", title: "Solidity (Ethereum)", aliases: ["sol"], load: () => import('refractor/solidity') },
+    { id: "solution-file", title: "Solution file", aliases: ["sln"], load: () => import('refractor/solution-file') },
+    { id: "soy", title: "Soy (Closure Template)", aliases: [], load: () => import('refractor/soy') },
+    { id: "sparql", title: "SPARQL", aliases: ["rq"], load: () => import('refractor/sparql') },
+    { id: "splunk-spl", title: "Splunk SPL", aliases: [], load: () => import('refractor/splunk-spl') },
+    { id: "sqf", title: "SQF (Arma 3)", aliases: [], load: () => import('refractor/sqf') },
+    { id: "sql", title: "SQL", aliases: [], load: () => import('refractor/sql') },
+    { id: "squirrel", title: "Squirrel", aliases: [], load: () => import('refractor/squirrel') },
+    { id: "stan", title: "Stan", aliases: [], load: () => import('refractor/stan') },
+    { id: "stata", title: "Stata Ado", aliases: [], load: () => import('refractor/stata') },
+    { id: "stylus", title: "Stylus", aliases: [], load: () => import('refractor/stylus') },
+    { id: "supercollider", title: "SuperCollider", aliases: ["sclang"], load: () => import('refractor/supercollider') },
+    { id: "swift", title: "Swift", aliases: [], load: () => import('refractor/swift') },
+    { id: "systemd", title: "Systemd configuration file", aliases: [], load: () => import('refractor/systemd') },
+    { id: "t4-cs", title: "T4 Text Templates (C#)", aliases: ["t4"], load: () => import('refractor/t4-cs') },
+    { id: "t4-templating", title: "t4-templating", aliases: [], part: true, load: () => import('refractor/t4-templating') },
+    { id: "t4-vb", title: "T4 Text Templates (VB)", aliases: [], load: () => import('refractor/t4-vb') },
+    { id: "tap", title: "TAP", aliases: [], load: () => import('refractor/tap') },
+    { id: "tcl", title: "Tcl", aliases: [], load: () => import('refractor/tcl') },
+    { id: "textile", title: "Textile", aliases: [], load: () => import('refractor/textile') },
+    { id: "toml", title: "TOML", aliases: [], load: () => import('refractor/toml') },
+    { id: "tremor", title: "Tremor", aliases: ["trickle", "troy"], load: () => import('refractor/tremor') },
+    { id: "tsx", title: "TSX", aliases: [], load: () => import('refractor/tsx') },
+    { id: "tt2", title: "Template Toolkit 2", aliases: [], load: () => import('refractor/tt2') },
+    { id: "turtle", title: "Turtle", aliases: ["trig"], load: () => import('refractor/turtle') },
+    { id: "twig", title: "Twig", aliases: [], load: () => import('refractor/twig') },
+    { id: "typescript", title: "TypeScript", aliases: ["ts"], load: () => import('refractor/typescript') },
+    { id: "typoscript", title: "TypoScript", aliases: ["tsconfig"], load: () => import('refractor/typoscript') },
+    { id: "unrealscript", title: "UnrealScript", aliases: ["uc", "uscript"], load: () => import('refractor/unrealscript') },
+    { id: "uorazor", title: "UO Razor Script", aliases: [], load: () => import('refractor/uorazor') },
+    { id: "uri", title: "URI", aliases: ["url"], load: () => import('refractor/uri') },
+    { id: "v", title: "V", aliases: [], load: () => import('refractor/v') },
+    { id: "vala", title: "Vala", aliases: [], load: () => import('refractor/vala') },
+    { id: "vbnet", title: "VB.Net", aliases: [], load: () => import('refractor/vbnet') },
+    { id: "velocity", title: "Velocity", aliases: [], load: () => import('refractor/velocity') },
+    { id: "verilog", title: "Verilog", aliases: [], load: () => import('refractor/verilog') },
+    { id: "vhdl", title: "VHDL", aliases: [], load: () => import('refractor/vhdl') },
+    { id: "vim", title: "Vim", aliases: [], load: () => import('refractor/vim') },
+    { id: "visual-basic", title: "Visual Basic", aliases: ["vb", "vba"], load: () => import('refractor/visual-basic') },
+    { id: "warpscript", title: "WarpScript", aliases: [], load: () => import('refractor/warpscript') },
+    { id: "wasm", title: "WebAssembly", aliases: [], load: () => import('refractor/wasm') },
+    { id: "web-idl", title: "Web IDL", aliases: ["webidl"], load: () => import('refractor/web-idl') },
+    { id: "wgsl", title: "WGSL", aliases: [], load: () => import('refractor/wgsl') },
+    { id: "wiki", title: "Wiki markup", aliases: [], load: () => import('refractor/wiki') },
+    { id: "wolfram", title: "Wolfram language", aliases: ["mathematica", "nb", "wl"], load: () => import('refractor/wolfram') },
+    { id: "wren", title: "Wren", aliases: [], load: () => import('refractor/wren') },
+    { id: "xeora", title: "Xeora", aliases: ["xeoracube"], load: () => import('refractor/xeora') },
+    { id: "xml-doc", title: "XML doc (.net)", aliases: [], load: () => import('refractor/xml-doc') },
+    { id: "xojo", title: "Xojo (REALbasic)", aliases: [], load: () => import('refractor/xojo') },
+    { id: "xquery", title: "XQuery", aliases: [], load: () => import('refractor/xquery') },
+    { id: "yaml", title: "YAML", aliases: ["yml"], load: () => import('refractor/yaml') },
+    { id: "yang", title: "YANG", aliases: [], load: () => import('refractor/yang') },
+    { id: "zig", title: "Zig", aliases: [], load: () => import('refractor/zig') },
+];

package/dist/remark-callouts.d.ts

@@ -27,6 +27,12 @@ interface MdastNode {
         hProperties?: Record<string, unknown>;
     };
 }
+/**
+ * `[!type]`, an optional fold marker, and whatever titles it. The type is a word
+ * in any script (§7.1): it opens with a letter and goes on in letters, marks,
+ * digits, `_` and `-`, so `[!atenção]` is a type as much as `[!warning]` is.
+ */
+export declare const CALLOUT_MARKER: RegExp;
 export interface CalloutOptions {
     /**
      * The title of a callout written without one, in the language of whoever

package/dist/remark-callouts.js

@@ -23,7 +23,7 @@
  * in any script (§7.1): it opens with a letter and goes on in letters, marks,
  * digits, `_` and `-`, so `[!atenção]` is a type as much as `[!warning]` is.
  */
-const MARKER = /^\[!(\p{L}[\p{L}\p{M}\p{N}_-]*)\]([+-]?)[ \t]*(.*)$/u;
+export const CALLOUT_MARKER = /^\[!(\p{L}[\p{L}\p{M}\p{N}_-]*)\]([+-]?)[ \t]*(.*)$/u;
 export function remarkCallouts(options = {}) {
     return (tree) => descend(tree, options);
 }
@@ -42,7 +42,7 @@ function rewrite(quote, options) {
     if (lead?.type !== 'text' || typeof lead.value !== 'string')
         return;
     const broke = lead.value.indexOf('\n');
-    const marker = MARKER.exec(broke === -1 ? lead.value : lead.value.slice(0, broke));
+    const marker = CALLOUT_MARKER.exec(broke === -1 ? lead.value : lead.value.slice(0, broke));
     if (!marker)
         return;
     const kind = (marker[1] ?? '').normalize('NFC').toLowerCase();

package/dist/remark-ring.d.ts

@@ -67,4 +67,9 @@ export declare function remarkBlockIds(): (tree: MdastNode) => void;
 export declare function remarkMathDollarRule(): (tree: MdastNode, file: {
     value?: unknown;
 }) => void;
+/**
+ * Whether the inline formula the source holds between these offsets, delimiters included, breaks
+ * the dollar rule of §7.8 and is text: the reading surface and the editor decide it alike.
+ */
+export declare function breaksDollarRule(source: string, start: number, end: number): boolean;
 export {};