bookish-press 0.5.25 → 0.5.32

package/dist/components/page/Edition.svelte

@@ -2,9 +2,10 @@
 import { goto } from '$app/navigation';
 import { onMount, setContext, tick } from 'svelte';
 import { writable } from 'svelte/store';
-import { BASE, DARK_MODE, } from './Contexts';
+import { BASE, DARK_MODE, getBook, } from './Contexts';
 import { BookishTheme } from '../../models/book/Theme';
 import { isDark, setDark } from '../../util/dark';
+import { page } from '$app/stores';
 // Poly fill smooth scrolling for Safari.
 onMount(() => smoothscroll.polyfill());
 // The book edition to render.
@@ -14,6 +15,7 @@ export let edition;
 // but when the book is being viewed or edited in the Bookish app, it needs a prefix for the
 // route in the app.
 export let base = '';
+let book = getBook();
 // When the base changes, update the context.
 let baseStore = writable(base);
 $: setContext(BASE, baseStore);
@@ -84,10 +86,15 @@ function toRules(set) {
     <meta property="og:title" content={edition.getTitle()} />
     <meta property="og:image" content={edition.getImage('cover')} />
     <meta property="og:description" content={edition.getDescription()} />
-    <!-- <meta
+    <meta property="og:type" content="book" />
+    <meta property="og:author" content={edition.getAuthorsText()} />
+    <meta
         property="og:url"
-        content="https://criticallyconsciouscomputing.org"
-    /> -->
+        content={edition.base ??
+            `https://bookish.press/${
+                $book && $book.domain ? $book.domain : $page.params.bookid
+            }`}
+    />
 </svelte:head>
 
 <main class="bookish {$darkMode ? ' dark' : ''}">

package/dist/components/page/EditionLoader.svelte

@@ -4,7 +4,7 @@ import Feedback from '../app/Feedback.svelte';
 import { getBook, getEdition, getUser, getChapterText, } from './Contexts';
 import { onDestroy } from 'svelte';
 import { page } from '$app/stores';
-import { listenToChapters, listenToEdition } from '../../models/CRUD';
+import { deleteChapterText, listenToChapters, listenToEdition, } from '../../models/CRUD';
 export let write;
 let auth = getUser();
 let book = getBook();
@@ -67,8 +67,17 @@ function listen() {
                 // Update the chapter text store.
                 chapterText.set(chapters);
                 // Update the chapter text in the current edition.
-                if ($edition)
-                    edition.set($edition.withChapterText(chapters));
+                if ($edition) {
+                    const newEdition = $edition.withChapterText(chapters);
+                    if (newEdition !== $edition)
+                        edition.set(newEdition);
+                    // Get all the chapters in the updated chapter list and
+                    // delete the ones not referenced by the edition.
+                    chapters
+                        .filter(([ref]) => $edition &&
+                        !$edition.hasChapterRefID(ref.id))
+                        .forEach(([ref]) => deleteChapterText(ref));
+                }
             });
         }
     }

package/dist/components/page/Editions.svelte

@@ -84,7 +84,7 @@ async function handleDraftEdition() {
                                 undefined,
                                 edition.summary
                             )}
-                        />{:else}&mdash{/if}</p
+                        />{:else}&mdash;{/if}</p
                 >
             </section>
         {/if}

package/dist/components/page/Header.svelte

@@ -54,80 +54,84 @@ let embed;
 $: embed = getImage();
 </script>
 
-<header class="bookish-chapter-header">
-    {#if embed}
-        <div class="bookish-figure-full">
-            {#if $edition && editable}
-                <BookishEditor
-                    text={embed}
-                    parser={(text) => Parser.parseEmbed($edition, text)}
-                    save={(node) =>
-                        setImage ? setImage(node.toBookdown()) : undefined}
-                    chapter={false}
-                    component={Embed}
-                    placeholder=""
-                    leasee={getLeasee(auth, edition, `embed-${id}`)}
-                    lease={(lock) => lease(auth, edition, `embed-${id}`, lock)}
-                />
-            {:else}
-                <Embed
-                    node={Parser.parseEmbed($edition, embed)}
-                    editable={false}
-                />
-            {/if}
-            {#if !print && showReminder}
-                <div class="bookish-scroll-reminder" />
-            {/if}
-        </div>
-    {:else}
-        <!-- Add a bit of space to account for the lack of an image. -->
-        <p>&nbsp;</p>
-    {/if}
-    {#if !print}
-        <slot name="outline" />
-    {/if}
-    {#if editable}
-        {#if embed === null}
-            <Button tooltip="add cover image" command={addCover}
-                >+ cover image</Button
-            >
+<!-- We key on the chapter ID to avoid laggy updates from image loading -->
+{#key id}
+    <header class="bookish-chapter-header">
+        {#if embed}
+            <div class="bookish-figure-full">
+                {#if $edition && editable}
+                    <BookishEditor
+                        text={embed}
+                        parser={(text) => Parser.parseEmbed($edition, text)}
+                        save={(node) =>
+                            setImage ? setImage(node.toBookdown()) : undefined}
+                        chapter={false}
+                        component={Embed}
+                        placeholder=""
+                        leasee={getLeasee(auth, edition, `embed-${id}`)}
+                        lease={(lock) =>
+                            lease(auth, edition, `embed-${id}`, lock)}
+                    />
+                {:else}
+                    <Embed
+                        node={Parser.parseEmbed($edition, embed)}
+                        editable={false}
+                    />
+                {/if}
+                {#if !print && showReminder}
+                    <div class="bookish-scroll-reminder" />
+                {/if}
+            </div>
         {:else}
-            <ConfirmButton
-                confirm="remove image?"
-                tooltip="remove cover image"
-                command={removeCover}>- cover image</ConfirmButton
-            >
+            <!-- Add a bit of space to account for the lack of an image. -->
+            <p>&nbsp;</p>
         {/if}
-    {/if}
-    <div bind:this={title} class="bookish-chapter-header-text">
-        <slot name="before" />
-        <Title>
-            {#if editable && save}
-                <TextEditor
-                    {label}
-                    text={header + (subtitle ? ': ' + subtitle : '')}
-                    placeholder="title"
-                    valid={(text) =>
-                        text.length === 0
-                            ? 'Titles have to be at least one character long.'
-                            : undefined}
-                    {save}
-                />
+        {#if !print}
+            <slot name="outline" />
+        {/if}
+        {#if editable}
+            {#if embed === null}
+                <Button tooltip="add cover image" command={addCover}
+                    >+ cover image</Button
+                >
             {:else}
-                {header}
-                {#if subtitle}<div class="bookish-subtitle">{subtitle}</div
-                    >{/if}
+                <ConfirmButton
+                    confirm="delete image"
+                    tooltip="delete cover image"
+                    command={removeCover}>- cover image</ConfirmButton
+                >
             {/if}
-        </Title>
-        <slot name="after" />
-        {#if tags}
-            <div
-                >{#each tags as tag}<span class="bookish-tag">{tag}</span
-                    >{/each}</div
-            >
         {/if}
-    </div>
-</header>
+        <div bind:this={title} class="bookish-chapter-header-text">
+            <slot name="before" />
+            <Title>
+                {#if editable && save}
+                    <TextEditor
+                        {label}
+                        text={header + (subtitle ? ': ' + subtitle : '')}
+                        placeholder="title"
+                        valid={(text) =>
+                            text.length === 0
+                                ? 'Titles have to be at least one character long.'
+                                : undefined}
+                        {save}
+                    />
+                {:else}
+                    {header}
+                    {#if subtitle}<div class="bookish-subtitle">{subtitle}</div
+                        >{/if}
+                {/if}
+            </Title>
+            <slot name="after" />
+            {#if tags}
+                <div
+                    >{#each tags as tag}<span class="bookish-tag">{tag}</span
+                        >{/each}</div
+                >
+            {/if}
+        </div>
+    </header>
+{/key}
 
 <style>
     .bookish-subtitle {

package/dist/components/page/Media.svelte

@@ -24,7 +24,7 @@ onMount(() => {
     media?.notify(updateImages);
     return () => media?.stopNotifying(updateImages);
 });
-$: unused = images?.filter((image) => embeds.find((embed) => embed.getURL() === image.url) === undefined);
+$: unused = images?.filter((image) => !embeds.some((embed) => image.url.includes(embed.embed.getURL())));
 </script>
 
 {#if $edition}
@@ -59,9 +59,10 @@ $: unused = images?.filter((image) => embeds.find((embed) => embed.getURL() ===
         {:else}
             <p>These are the images in the book:</p>
         {/if}
-        {#each embeds as embed}
+        {#each embeds as { embed, chapterID }}
             {#if !embed.isVideo()}
                 <MediaPreview
+                    {chapterID}
                     url={embed.isLocal()
                         ? `${$base}/${embed.getSmallURL()}`
                         : embed.getSmallURL()}
@@ -89,10 +90,10 @@ $: unused = images?.filter((image) => embeds.find((embed) => embed.getURL() ===
                 be used in other editions of this book.
             </Instructions>
             {#each unused as image}
-                <MediaPreview url={image.url} alt={''}>
+                <MediaPreview chapterID={undefined} url={image.url} alt={''}>
                     <ConfirmButton
                         tooltip="delete unused image"
-                        confirm="delete image?"
+                        confirm="delete image"
                         command={() =>
                             media
                                 ?.remove(image)

package/dist/components/page/MediaPreview.svelte

@@ -1,5 +1,9 @@
-<script>export let url;
+<script>import Link from '../Link.svelte';
+import { getBase } from './Contexts';
+export let url;
 export let alt;
+export let chapterID;
+let base = getBase();
 let loaded;
 let urlChecked;
 $: {
@@ -18,7 +22,9 @@ $: {
 
 <figure class={'media-preview'}>
     {#if loaded}
-        <img src={url.startsWith('http') ? url : `${url}`} {alt} />
+        <Link to={`${$base}/${chapterID}`} linked={chapterID !== undefined}
+            ><img src={url.startsWith('http') ? url : `${url}`} {alt} /></Link
+        >
     {:else if loaded === null}
         <div class="missing">missing image</div>
     {/if}

package/dist/components/page/MediaPreview.svelte.d.ts

@@ -3,6 +3,7 @@ declare const __propDef: {
     props: {
         url: string;
         alt: string;
+        chapterID: string | undefined;
     };
     events: {
         [evt: string]: CustomEvent<any>;

package/dist/components/page/Outline.svelte

@@ -129,7 +129,7 @@ let expandLabel = '\u2630';
             aria-label={expanded
                 ? 'Collapse navigation menu'
                 : 'Expand navigation menu'}
-            tabIndex="0"
+            tabindex="0"
             on:click={headers.length > 0 ? toggleExpanded : undefined}
             on:keydown={(event) => {
                 if (event.key === 'Enter' || event.key === ' ')

package/dist/components/page/Page.svelte

@@ -2,10 +2,12 @@
 import Loading from './Loading.svelte';
 export let title;
 export let afterLoaded = undefined;
-let loaded = false;
+let fontsLoaded = false;
+let imagesLoaded = false;
 let lastHeight = 0;
 let intervalID = null;
 let mountTime = Date.now();
+$: loaded = fontsLoaded && imagesLoaded;
 function watchLoading() {
     const bodyHeight = document.body.clientHeight;
     // If the height hasn't changed and images are loaded OR it's been 2 seconds, load.
@@ -14,7 +16,7 @@ function watchLoading() {
         // Stop watching the images
         stopWatching();
         // Set to loaded to hide the overlay and notify callback if there is one.
-        loaded = true;
+        imagesLoaded = true;
         if (afterLoaded)
             afterLoaded();
     }
@@ -29,6 +31,7 @@ onMount(() => {
     // Watch the height of the document and wait until it's been stable for a while before scrolling
     // to any targets. We use the data below to monitor the document height over time.
     intervalID = setInterval(() => watchLoading(), 50);
+    document.fonts.ready.then(() => (fontsLoaded = true));
     return () => stopWatching();
 });
 function imagesAreLoaded() {
@@ -45,7 +48,7 @@ function imagesAreLoaded() {
     <meta name="description" content={title} />
 </svelte:head>
 
-<section class={'bookish-page' + (loaded ? ' loaded' : '')}>
+<section class={'bookish-page' + (imagesLoaded ? ' loaded' : '')}>
     <slot />
 </section>
 <!-- Overlay loading feedback if loading, but still render the page. -->

package/dist/components/page/Reference.svelte

@@ -249,7 +249,7 @@ function move(field, direction) {
 {#if edit && editable && !reference.short}
     <ConfirmButton
         tooltip="delete reference {reference.title}"
-        confirm="delete reference..."
+        confirm="delete reference"
         command={() =>
             $edition
                 ? edition.set($edition.withoutReference(reference.citationID))

package/dist/components/page/Search.svelte

@@ -83,7 +83,7 @@ $: {
 
         <p>
             Type a word—just a single word—and we'll show its occurrences in
-            this book:
+            this book's chapters:
         </p>
 
         <input

package/dist/components/page/TableOfContents.svelte

@@ -138,7 +138,7 @@ onMount(() => {
         </Instructions>
 
         <PageHeader id="chapters"
-            >Chapters {#if editable}<Button
+            >Chapters{#if editable}&nbsp;<Button
                     tooltip="add empty chapter"
                     disabled={waitingForChapter}
                     command={addChapter}>+ chapter</Button
@@ -273,10 +273,7 @@ onMount(() => {
 
         <!-- Book citation -->
         <PageParagraph>
-            {$edition
-                .getAuthors()
-                .map((author) => Parser.parseFormat($edition, author).toText())
-                .join(', ')} ({new Date().getFullYear()}).
+            {$edition.getAuthorsText()} ({new Date().getFullYear()}).
             <em>{$edition.getTitle()}</em>. {bookURL},
             <em>retrieved {new Date().toLocaleDateString('en-US')}</em>.
         </PageParagraph>
@@ -292,7 +289,7 @@ onMount(() => {
         {/if}
 
         {#if $book && (editable || isEditionPartiallyEditable())}
-            <PageHeader>Editors</PageHeader>
+            <PageHeader id="editors">Editors</PageHeader>
             <Instructions {editable}>
                 These authors can edit this edition and its chapters. To give
                 book-level permissions, edit the book editors on the <Link

package/dist/components/page/TableOfContentsRow.svelte

@@ -76,7 +76,7 @@ $: chapterURL =
                 >
                 <ConfirmButton
                     tooltip="delete chapter {title}"
-                    confirm="delete?"
+                    confirm="delete chapter"
                     command={() =>
                         chapter && $edition
                             ? edition.set(

package/dist/components/page/ThemeEditor.svelte

@@ -87,7 +87,7 @@ function getEmptyGroup(group) {
         {:else}
             <ConfirmButton
                 tooltip="change theme to the default"
-                confirm="delete your theme?"
+                confirm="delete theme"
                 command={() =>
                     $edition
                         ? edition.set($edition.withTheme(null))

package/dist/models/CRUD.d.ts

@@ -20,6 +20,7 @@ export declare function updateLock(edition: Edition, uid: string, content: strin
  * returns a map of DocumentReferences for new chapters so they can be persisted client side.
  */
 export declare function updateEdition(book: Book, previousEdition: Edition | undefined, newEdition: Edition): Promise<Map<string, DocumentReference>>;
+export declare function deleteChapterText(ref: DocumentReference): Promise<void>;
 export declare function updateBook(book: Book): Promise<void>;
 export declare function isSubdomainAvailable(subdomain: string, book: Book): Promise<boolean>;
 export declare function getBookIDWithSubdomain(subdomain: string): Promise<string | null>;

package/dist/models/CRUD.js

@@ -60,8 +60,12 @@ export function listenToChapters(bookID, editionID, react) {
         throw NO_DATABASE_CONNECTION;
     return onSnapshot(collection(db, 'books', bookID, 'editions', editionID, 'chapters'), (docs) => {
         const chapters = [];
+        // For each chapter in the book, if the doc exists and it's not a pending local write, send updated chapters to the front end.
         docs.forEach((doc) => {
-            chapters.push([doc.ref, doc.data().text]);
+            if (doc.exists() && !doc.metadata.hasPendingWrites)
+                // If the chapter text is somehow null, set it to an empty string.
+                // This accounts for previous defects that could lead to null.
+                chapters.push([doc.ref, doc.data().text ?? '']);
         });
         react(chapters);
     });
@@ -182,7 +186,9 @@ export async function updateEdition(book, previousEdition, newEdition) {
     for (const newChapter of newEdition.chapters) {
         if (newChapter.ref === undefined) {
             // Make the new chapter's text.
-            const newChapterRef = await addDoc(collection(db, editionPath(newEdition.bookRef.id, editionRef.id), 'chapters'), { text: newChapter.text });
+            const newChapterRef = await addDoc(collection(db, editionPath(newEdition.bookRef.id, editionRef.id), 'chapters'), 
+            // If the new chapter has null text, set it to empty string
+            { text: newChapter.text ?? '' });
             // Add the ref of the new chapter to the revised chapter.
             newEdition = newEdition.withRevisedChapter(newChapter, newChapter.withRef(newChapterRef));
             // Map the chapter ref to it's id.
@@ -193,8 +199,12 @@ export async function updateEdition(book, previousEdition, newEdition) {
             const previousChapter = previousEdition === undefined
                 ? undefined
                 : previousEdition.getChapterByRef(newChapter.ref);
-            if (previousChapter === undefined ||
-                newChapter.text !== previousChapter.text) {
+            if (
+            // A null chapter text means that we haven't loaded it yet from the database, so we
+            // only set it if it's not null.
+            newChapter.text !== null &&
+                (previousChapter === undefined ||
+                    newChapter.text !== previousChapter.text)) {
                 await setDoc(doc(db, editionPath(newEdition.bookRef.id, editionRef.id), 'chapters', newChapter.ref.id), { text: newChapter.text });
             }
         }
@@ -225,6 +235,9 @@ export async function updateEdition(book, previousEdition, newEdition) {
     await setDoc(doc(db, editionPath(newEdition.bookRef.id, editionRef.id)), newEdition.toObject());
     return newChapterRefs;
 }
+export async function deleteChapterText(ref) {
+    deleteDoc(ref);
+}
 export async function updateBook(book) {
     if (!db)
         throw Error("Can't update book, not connected to Firebase.");

package/dist/models/book/BookMedia.d.ts

@@ -2,6 +2,7 @@ import type { StorageReference } from 'firebase/storage';
 import type Book from './Book';
 export type Image = {
     url: string;
+    thumb: string;
     ref: StorageReference;
 };
 export default class BookMedia {
@@ -17,6 +18,8 @@ export default class BookMedia {
     /** Get a listing of all of the images for the book. */
     cacheImages(): Promise<Image[]>;
     retrieveImages(): Promise<(Image | undefined)[]>;
+    stripTokenFromURL(url: string): string;
+    makeThumbnailURL(url: string): string;
     getThumbnailURL(url: string, thumbnailRef: StorageReference, error: (message: string) => void, finished: (url: string, thumbnailURL: string) => void, attempt?: number): void;
     upload(file: File, _: (progress: number) => void, errorHandler: (message: string) => void, finishedHandler: (url: string, thumbnailURL: string) => void): void;
     remove(image: Image): Promise<Image[] | undefined>;

package/dist/models/book/BookMedia.js

@@ -1,5 +1,4 @@
 import { deleteObject, getDownloadURL, listAll, ref, uploadBytes, } from 'firebase/storage';
-import { v4 as uuidv4 } from 'uuid';
 import { storage } from '../Firebase';
 export default class BookMedia {
     book;
@@ -43,7 +42,8 @@ export default class BookMedia {
         // Find all the prefixes and items.
         return listAll(listRef).then((res) => Promise.all(res.items.map((itemRef) => getDownloadURL(itemRef).then((url) => {
             const image = {
-                url: url,
+                url,
+                thumb: this.makeThumbnailURL(url),
                 description: '',
                 ref: itemRef,
             };
@@ -53,6 +53,22 @@ export default class BookMedia {
             return image;
         }))));
     }
+    stripTokenFromURL(url) {
+        const tokenIndex = url.indexOf('&token=');
+        return tokenIndex >= 0 ? (url = url.substring(0, tokenIndex)) : url;
+    }
+    // Construct a thumbnail URL from the base URL.
+    makeThumbnailURL(url) {
+        // The structure of the URL is
+        // https://[firebase-domain]/v0/b/[projectid].appspot.com/o/images%2F[bookID]%2F[imagename]?alt=media
+        // And we want
+        // https://[firebase-domain]/v0/b/[projectid].appspot.com/o/images%2F[bookID]%2Fthumbnails%2F[imagename]?alt=media
+        const bookID = this.book.getID();
+        const bookIDIndex = url.indexOf(bookID);
+        return bookIDIndex >= 0
+            ? `${url.substring(0, bookIDIndex)}${bookID}%2Fthumbnails${url.substring(bookIDIndex + bookID.length)}`
+            : url;
+    }
     getThumbnailURL(url, thumbnailRef, error, finished, attempt = 0) {
         getDownloadURL(thumbnailRef)
             .then((thumbnail) => finished(url, thumbnail))
@@ -64,9 +80,10 @@ export default class BookMedia {
     upload(file, _, errorHandler, finishedHandler) {
         if (storage === undefined)
             return;
+        // We use the file name given, but append a unique string to avoid collisions.
+        const imageName = file.name;
         // The canonical path format for Bookish images in the store is image/{bookid}/{imageid}
-        // where {bookid} is the Firestore ID of the book being edited and {imageid} is just a random id.
-        const imageName = `image-${uuidv4()}`;
+        // where {bookid} is the Firestore document ID of the book being edited and {imageid} is just a random id.
         const imageRef = ref(storage, `${this.getImagePath()}/${imageName}`);
         const thumbnailRef = ref(storage, `${this.getImagePath()}/thumbnails/${imageName}`);
         uploadBytes(imageRef, file)
@@ -74,7 +91,7 @@ export default class BookMedia {
             getDownloadURL(snapshot.ref)
                 // After we get the download URL for the uploaded image,
                 // try to get the thumbnail URL for the resized image on the server.
-                .then((url) => this.getThumbnailURL(url, thumbnailRef, errorHandler, finishedHandler))
+                .then((url) => finishedHandler(this.stripTokenFromURL(url), this.makeThumbnailURL(this.stripTokenFromURL(url))))
                 .catch(() => errorHandler('Unable to get image URL.'));
         })
             .then(() => this.cacheImages())

package/dist/models/book/Chapter.d.ts

@@ -10,7 +10,8 @@ export type ChapterSpecification = {
     numbered: boolean;
     forthcoming: boolean;
     section?: string;
-    text?: string;
+    /** A string means that we know the chapter's text; null means we haven't loaded it yet from the database and should not be editing or saving it. */
+    text?: string | null;
     uids: string[];
 };
 export type ChapterContent = {
@@ -30,7 +31,7 @@ export default class Chapter {
     readonly numbered: boolean;
     readonly forthcoming: boolean;
     readonly section: string | undefined;
-    readonly text: string;
+    readonly text: string | null;
     readonly uids: string[];
     _ast: ChapterNode | undefined;
     _index: Record<string, Array<Match>> | undefined;
@@ -41,15 +42,16 @@ export default class Chapter {
     }[];
     lastEdit: number;
     listeners: Set<(text: string) => void>;
-    constructor(ref: DocumentReference | undefined, id: string, title: string, authors: string[], image: string | null, numbered: boolean, forthcoming: boolean, section: string | undefined, text: string, uids: string[]);
+    constructor(ref: DocumentReference | undefined, id: string, title: string, authors: string[], image: string | null, numbered: boolean, forthcoming: boolean, section: string | undefined, text: string | null, uids: string[]);
     /**
      * Convert a chapter spec and it's text into a chapter object.
      * The spec may contain the text itself, but it may not, so we require it to be
      * repeated here to guarantee its provided.
      */
-    static fromJSON(spec: ChapterSpecification, text: string): Chapter;
+    static fromJSON(spec: ChapterSpecification): Chapter;
     toJSON(): ChapterSpecification;
     getRef(): DocumentReference<import("@firebase/firestore").DocumentData> | undefined;
+    hasRefID(id: string): boolean;
     withEditors(uids: string[]): Chapter;
     withRef(ref: DocumentReference): Chapter;
     withoutRef(): Chapter;
@@ -62,7 +64,7 @@ export default class Chapter {
     isNumbered(): boolean;
     asNumbered(numbered: boolean): Chapter;
     isEditor(uid: string): boolean;
-    getText(): string;
+    getText(): string | null;
     withText(text: string): Chapter;
     withAST(ast: ChapterNode): Chapter;
     getAuthors(): string[];
@@ -73,8 +75,8 @@ export default class Chapter {
     withTitle(title: string): Chapter;
     getImage(): string | null;
     withImage(image: string | null): Chapter;
-    getAST(edition: Edition): ChapterNode;
-    getWordCount(edition: Edition): number;
+    getAST(edition: Edition): ChapterNode | undefined;
+    getWordCount(edition: Edition): number | undefined;
     getReadingTime(edition: Edition): number | undefined;
     getIndex(edition: Edition): Record<string, Match[]>;
     toString(): string;