@u1f992/vivliostyle-index 0.2.5 → 0.3.0

package/dist/index-builder.js

@@ -0,0 +1,138 @@
+import { applyPageInstruction, applyRangeInstruction, applyXrefInstruction, } from "./instruction.js";
+import { addMessage, messages } from "./messages.js";
+import { addressKey, createIndexBuilder, finalizeIndex, labelInvalidXrefs, } from "./model.js";
+import { identityTemplate } from "./template.js";
+const attachmentAddressKey = (attachment) => addressKey(attachment.instruction.address);
+function ensurePendingIndex(pendingIndexes, attachment) {
+    const pendingIndex = pendingIndexes.get(attachment.targetKey);
+    if (pendingIndex) {
+        pendingIndex.sourcePaths.add(attachment.sourcePath);
+        pendingIndex.attachments.push(attachment);
+        return pendingIndex;
+    }
+    const created = {
+        target: attachment.target,
+        builder: createIndexBuilder(),
+        sourcePaths: new Set([attachment.sourcePath]),
+        attachments: [attachment],
+        xrefValidations: [],
+    };
+    pendingIndexes.set(attachment.targetKey, created);
+    return created;
+}
+function applyAttachment(builder, attachment, rangePairings) {
+    const { instruction } = attachment;
+    if (instruction.type === "page") {
+        applyPageInstruction(builder, instruction, attachment.locationHref);
+        return undefined;
+    }
+    if (instruction.type === "range-start") {
+        const rangeEnd = rangePairings.endsByStart.get(attachment);
+        if (rangeEnd !== undefined) {
+            applyRangeInstruction(builder, instruction, attachment.locationHref, rangeEnd.locationHref);
+        }
+        else {
+            applyPageInstruction(builder, { type: "page", address: instruction.address, template: instruction.template }, attachment.locationHref, "unmatched-range-start");
+        }
+        return undefined;
+    }
+    if (instruction.type === "range-end") {
+        if (!rangePairings.pairedEnds.has(attachment)) {
+            applyPageInstruction(builder, { type: "page", address: instruction.address, template: identityTemplate }, attachment.locationHref, "unmatched-range-end");
+        }
+        return undefined;
+    }
+    applyXrefInstruction(builder, instruction);
+    return {
+        reportingPath: attachment.sourcePath,
+        target: instruction.target,
+    };
+}
+function validateXrefs(builder, validations, messagesByDocument) {
+    const unresolvedXrefs = labelInvalidXrefs(builder);
+    for (const { reportingPath, target } of validations) {
+        const unresolvedXref = unresolvedXrefs.get(addressKey(target));
+        if (unresolvedXref !== undefined) {
+            addMessage(messagesByDocument, reportingPath, messages.invalidXref(unresolvedXref));
+        }
+    }
+}
+function pairRanges(pendingIndex, messagesByDocument) {
+    const startsByAddress = new Map();
+    const endsByStart = new Map();
+    const pairedEnds = new Set();
+    for (const attachment of pendingIndex.attachments) {
+        if (attachment.instruction.type === "range-start") {
+            const starts = startsByAddress.get(attachmentAddressKey(attachment)) ?? [];
+            starts.push(attachment);
+            startsByAddress.set(attachmentAddressKey(attachment), starts);
+            continue;
+        }
+        if (attachment.instruction.type !== "range-end") {
+            continue;
+        }
+        const starts = startsByAddress.get(attachmentAddressKey(attachment));
+        const start = starts?.pop();
+        if (start === undefined) {
+            addMessage(messagesByDocument, attachment.sourcePath, messages.unmatchedRangeEnd(pendingIndex.target, attachment.instruction.address));
+            continue;
+        }
+        const rangeEnd = attachment;
+        endsByStart.set(start, rangeEnd);
+        pairedEnds.add(rangeEnd);
+    }
+    for (const starts of startsByAddress.values()) {
+        for (const start of starts) {
+            addMessage(messagesByDocument, start.sourcePath, messages.unmatchedRangeStart(pendingIndex.target, start.instruction.address));
+        }
+    }
+    return { endsByStart, pairedEnds };
+}
+export function buildIndexes(entryPaths, sources) {
+    const entryPathSet = new Set(entryPaths);
+    const pendingIndexes = new Map();
+    const messagesByDocument = new Map();
+    for (const [sourcePath, snapshot] of sources) {
+        messagesByDocument.set(sourcePath, [...snapshot.messages]);
+        if (!entryPathSet.has(sourcePath) && snapshot.attachments.length !== 0) {
+            addMessage(messagesByDocument, sourcePath, messages.documentNotInEntries(sourcePath));
+        }
+    }
+    for (const entryPath of entryPaths) {
+        const snapshot = sources.get(entryPath);
+        if (!snapshot) {
+            continue;
+        }
+        for (const attachment of snapshot.attachments) {
+            ensurePendingIndex(pendingIndexes, attachment);
+        }
+    }
+    const indexes = new Map();
+    for (const [targetKey, pendingIndex] of pendingIndexes) {
+        const { target, builder, sourcePaths, attachments, xrefValidations } = pendingIndex;
+        const rangePairings = pairRanges(pendingIndex, messagesByDocument);
+        for (const attachment of attachments) {
+            const validation = applyAttachment(builder, attachment, rangePairings);
+            if (validation) {
+                xrefValidations.push(validation);
+            }
+        }
+        validateXrefs(builder, xrefValidations, messagesByDocument);
+        const builtIndex = {
+            target,
+            index: finalizeIndex(builder),
+            sourcePaths: [...sourcePaths],
+        };
+        indexes.set(targetKey, builtIndex);
+    }
+    for (const { target, sourcePaths } of indexes.values()) {
+        if (entryPathSet.has(target.path)) {
+            continue;
+        }
+        for (const sourcePath of sourcePaths) {
+            addMessage(messagesByDocument, sourcePath, messages.targetNotInEntries(target));
+        }
+    }
+    return { indexes, messages: messagesByDocument };
+}
+//# sourceMappingURL=index-builder.js.map

package/dist/index-builder.js.map

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

package/dist/index-state.d.ts

@@ -0,0 +1,29 @@
+import type * as hast from "hast";
+import type * as unified from "unified";
+import type { FileSystem } from "./file-system.ts";
+import { type BuiltIndex } from "./index-builder.ts";
+import type { MessageArguments } from "./messages.ts";
+import { type SourceSnapshot } from "./source-snapshot.ts";
+import type { TargetKey } from "./target.ts";
+export type EntryProcessorInput = {
+    path: string;
+    contents: string;
+};
+export type CreateEntryProcessor = (input: Readonly<EntryProcessorInput>) => unified.Processor;
+export type IndexState = Readonly<{
+    entryPaths: readonly string[];
+    entryPathSet: ReadonlySet<string>;
+    updatedPaths: ReadonlySet<string>;
+    sources: ReadonlyMap<string, SourceSnapshot>;
+    indexes: ReadonlyMap<TargetKey, BuiltIndex>;
+    messages: ReadonlyMap<string, readonly MessageArguments[]>;
+}>;
+export type UpdateResult = Readonly<{
+    state: IndexState;
+    affectedPaths: ReadonlySet<string>;
+    entryProcessorMismatch: boolean;
+}>;
+export declare function createIndexState(entryPaths: readonly string[], fileSystem: Readonly<FileSystem>, createEntryProcessor: CreateEntryProcessor): IndexState;
+export declare function updateIndexState(state: IndexState, documentPath: string, root: hast.Root): UpdateResult;
+export declare function messagesFor(state: IndexState, documentPath: string): readonly MessageArguments[];
+//# sourceMappingURL=index-state.d.ts.map

package/dist/index-state.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index-state.d.ts","sourceRoot":"","sources":["../src/index-state.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,KAAK,IAAI,MAAM,MAAM,CAAC;AAElC,OAAO,KAAK,KAAK,OAAO,MAAM,SAAS,CAAC;AAGxC,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AACnD,OAAO,EAAgB,KAAK,UAAU,EAAE,MAAM,oBAAoB,CAAC;AACnE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AACtD,OAAO,EAAyB,KAAK,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAClF,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAE7C,MAAM,MAAM,mBAAmB,GAAG;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;CAClB,CAAC;AAEF,MAAM,MAAM,oBAAoB,GAAG,CAAC,KAAK,EAAE,QAAQ,CAAC,mBAAmB,CAAC,KAAK,OAAO,CAAC,SAAS,CAAC;AAE/F,MAAM,MAAM,UAAU,GAAG,QAAQ,CAAC;IAChC,UAAU,EAAE,SAAS,MAAM,EAAE,CAAC;IAC9B,YAAY,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;IAClC,YAAY,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;IAClC,OAAO,EAAE,WAAW,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC;IAC7C,OAAO,EAAE,WAAW,CAAC,SAAS,EAAE,UAAU,CAAC,CAAC;IAC5C,QAAQ,EAAE,WAAW,CAAC,MAAM,EAAE,SAAS,gBAAgB,EAAE,CAAC,CAAC;CAC5D,CAAC,CAAC;AAEH,MAAM,MAAM,YAAY,GAAG,QAAQ,CAAC;IAClC,KAAK,EAAE,UAAU,CAAC;IAClB,aAAa,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;IACnC,sBAAsB,EAAE,OAAO,CAAC;CACjC,CAAC,CAAC;AAwDH,wBAAgB,gBAAgB,CAC9B,UAAU,EAAE,SAAS,MAAM,EAAE,EAC7B,UAAU,EAAE,QAAQ,CAAC,UAAU,CAAC,EAChC,oBAAoB,EAAE,oBAAoB,GACzC,UAAU,CA+BZ;AAED,wBAAgB,gBAAgB,CAC9B,KAAK,EAAE,UAAU,EACjB,YAAY,EAAE,MAAM,EACpB,IAAI,EAAE,IAAI,CAAC,IAAI,GACd,YAAY,CA2Bd;AAED,wBAAgB,WAAW,CAAC,KAAK,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,GAAG,SAAS,gBAAgB,EAAE,CAEhG"}

package/dist/index-state.js

@@ -0,0 +1,95 @@
+import deepEqual from "deep-equal";
+import { fromHtml } from "hast-util-from-html";
+import { buildIndexes } from "./index-builder.js";
+import { collectSourceSnapshot } from "./source-snapshot.js";
+function readEntry(fileSystem, entryPath) {
+    try {
+        return fileSystem.readFileSync(entryPath);
+    }
+    catch (cause) {
+        throw new Error(`cannot read entry ${entryPath}. entry paths resolve against entryContext, which defaults to the current working directory.`, { cause });
+    }
+}
+function sourceSnapshotsEqual(previous, current) {
+    return previous !== undefined && deepEqual(previous, current, { strict: true });
+}
+function affectedDocumentPaths(previous, current) {
+    const targetPaths = new Set([...(previous?.attachments ?? []), ...current.attachments].map((attachment) => attachment.target.path));
+    return targetPaths;
+}
+function documentsWithChangedMessages(previous, current) {
+    const changed = new Set();
+    for (const documentPath of new Set([...previous.keys(), ...current.keys()])) {
+        if (!deepEqual(previous.get(documentPath) ?? [], current.get(documentPath) ?? [], {
+            strict: true,
+        })) {
+            changed.add(documentPath);
+        }
+    }
+    return changed;
+}
+function rebuild(state) {
+    const { indexes, messages } = buildIndexes(state.entryPaths, state.sources);
+    return { ...state, indexes, messages };
+}
+const creatingProcessors = new WeakSet();
+export function createIndexState(entryPaths, fileSystem, createEntryProcessor) {
+    if (creatingProcessors.has(createEntryProcessor)) {
+        throw new Error("the entry processor reached the index plugin that invoked it. createEntryProcessor must return a processor without the index plugin.");
+    }
+    const entryPathSet = new Set(entryPaths);
+    const uniqueEntryPaths = [...entryPathSet];
+    creatingProcessors.add(createEntryProcessor);
+    const sources = new Map();
+    try {
+        for (const entryPath of uniqueEntryPaths) {
+            const contents = readEntry(fileSystem, entryPath);
+            const input = { path: entryPath, contents };
+            const processor = createEntryProcessor(input);
+            const html = processor.processSync(input).toString();
+            sources.set(entryPath, collectSourceSnapshot(fromHtml(html), entryPath));
+        }
+    }
+    finally {
+        creatingProcessors.delete(createEntryProcessor);
+    }
+    return rebuild({
+        entryPaths: uniqueEntryPaths,
+        entryPathSet,
+        updatedPaths: new Set(),
+        sources,
+        indexes: new Map(),
+        messages: new Map(),
+    });
+}
+export function updateIndexState(state, documentPath, root) {
+    const previous = state.sources.get(documentPath);
+    const current = collectSourceSnapshot(root, documentPath);
+    const firstUpdate = !state.updatedPaths.has(documentPath);
+    const visited = firstUpdate
+        ? { ...state, updatedPaths: new Set(state.updatedPaths).add(documentPath) }
+        : state;
+    if (sourceSnapshotsEqual(previous, current)) {
+        return { state: visited, affectedPaths: new Set(), entryProcessorMismatch: false };
+    }
+    const sources = new Map(state.sources).set(documentPath, current);
+    const rebuilt = rebuild({ ...visited, sources });
+    // The host runs the plugin identically with and without a file watcher.
+    // A first update is indistinguishable from the only pass of a one-shot
+    // build, where touching an affected document has no consumer.
+    const affectedPaths = firstUpdate
+        ? new Set()
+        : new Set([
+            ...affectedDocumentPaths(previous, current),
+            ...documentsWithChangedMessages(state.messages, rebuilt.messages),
+        ]);
+    return {
+        state: rebuilt,
+        affectedPaths,
+        entryProcessorMismatch: firstUpdate && previous !== undefined,
+    };
+}
+export function messagesFor(state, documentPath) {
+    return state.messages.get(documentPath) ?? [];
+}
+//# sourceMappingURL=index-state.js.map

package/dist/index-state.js.map

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

package/dist/index.d.ts

@@ -1,19 +1,49 @@
 import type * as unified from "unified";
-import { byLocales, byListedOrder, type Comparators } from "./sort.ts";
-export { byLocales, byListedOrder };
-export declare function defaultComparator(locales?: Intl.LocalesArgument): Comparators[string];
-type Entry = {
-    path: string;
-    ignoreUpdate: boolean;
-};
-export type Config = {
-    entryProcessor: unified.Processor;
+import { type FileSystem } from "./file-system.ts";
+import { type CreateEntryProcessor } from "./index-state.ts";
+import { type Profiles } from "./profile.ts";
+export { nodeFileSystem } from "./file-system.ts";
+export type { FileSystem } from "./file-system.ts";
+export { InstructionSyntaxError, parseInstruction } from "./instruction.ts";
+export type { ParsedInstruction } from "./instruction.ts";
+export type { EntryProcessorInput } from "./index-state.ts";
+export type { Entry, EntryAddress, Group, Index, IndexError, Key, Locator, LocatorError, Subentry, Xref, XrefError, XrefType, } from "./model.ts";
+export type { CreateRenderer, EntryListRenderer, EntryRenderer, GroupListRenderer, GroupRenderer, HeadingRenderer, IndexRenderer, LocationRenderer, LocatorListRenderer, LocatorRenderer, SubentryListRenderer, SubentryRenderer, XrefPreferredListRenderer, XrefPreferredRenderer, XrefPreferredTargetRenderer, XrefRelatedListRenderer, XrefRelatedRenderer, XrefRelatedTargetRenderer, XrefRenderer, XrefTargetRenderer, } from "./render.ts";
+export { defaultRenderer } from "./render.ts";
+export { defaultProfile } from "./profile.ts";
+export type { IndexProfile, Profiles, ResolvedIndexProfile } from "./profile.ts";
+export { byKeys, byListedOrder, byLocales, defaultComparator } from "./sort.ts";
+export type { CreateIndexComparator, CreateKeyComparator, EntryComparator, IndexComparator, KeyComparator, ListedKey, } from "./sort.ts";
+export type { Target } from "./target.ts";
+export type CreateIndexPluginOptions = {
+    entry: readonly string[];
     entryContext?: string;
-    indexEntryMap: Readonly<{
-        [index: string]: readonly (string | Entry)[];
-    }>;
-    comparators: Comparators;
-    log?: (msg: string) => void;
+    profiles?: Profiles;
+    fileSystem?: Readonly<FileSystem>;
+};
+export type IndexPluginOptions = {
+    /**
+     * Creates the processor used to read every configured entry before the host processes it.
+     *
+     * This option exists because of a design limitation: when the host processes an index target,
+     * documents that the host will process after that target have not yet produced their transformed
+     * trees. The plugin needs their index data to render the target, so it processes every configured
+     * entry in advance.
+     *
+     * The returned processor must reproduce the transformation that the host will later apply, but
+     * without this plugin, and must read document metadata in the same way. Including this plugin
+     * would invoke it recursively.
+     *
+     * The plugin obtains this factory while the host is processing one document, then uses it for
+     * every entry. A host may supply different processor options for each entry. The factory must
+     * account for those options or rely only on differences that do not change the collected index
+     * data. For example, Vivliostyle CLI supplies each manuscript with `style`, `title`, and
+     * `language` options.
+     *
+     * @see https://github.com/vivliostyle/vivliostyle-cli/blob/v11.1.0/src/processor/compile.ts#L195-L212
+     */
+    createEntryProcessor: CreateEntryProcessor;
 };
-export declare const index: unified.Plugin<[Readonly<Config>]>;
+export declare function createIndexPlugin({ entry: entries, entryContext, profiles, fileSystem, }: Readonly<CreateIndexPluginOptions>): unified.Plugin<[Readonly<IndexPluginOptions>]>;
+export declare const logMessages: unified.Plugin;
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,KAAK,OAAO,MAAM,SAAS,CAAC;AAWxC,OAAO,EAAQ,SAAS,EAAE,aAAa,EAAE,KAAK,WAAW,EAAE,MAAM,WAAW,CAAC;AAC7E,OAAO,EAAE,SAAS,EAAE,aAAa,EAAE,CAAC;AAEpC,wBAAgB,iBAAiB,CAAC,OAAO,CAAC,EAAE,IAAI,CAAC,eAAe,GAAG,WAAW,CAAC,MAAM,CAAC,CAYrF;AAiCD,KAAK,KAAK,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,YAAY,EAAE,OAAO,CAAA;CAAE,CAAC;AAErD,MAAM,MAAM,MAAM,GAAG;IACnB,cAAc,EAAE,OAAO,CAAC,SAAS,CAAC;IAClC,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,aAAa,EAAE,QAAQ,CAAC;QAAE,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,CAAC,MAAM,GAAG,KAAK,CAAC,EAAE,CAAA;KAAE,CAAC,CAAC;IAC1E,WAAW,EAAE,WAAW,CAAC;IACzB,GAAG,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAC;CAC7B,CAAC;AAEF,eAAO,MAAM,KAAK,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAyHpD,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,KAAK,OAAO,MAAM,SAAS,CAAC;AAIxC,OAAO,EAAkB,KAAK,UAAU,EAAE,MAAM,kBAAkB,CAAC;AACnE,OAAO,EAIL,KAAK,oBAAoB,EAE1B,MAAM,kBAAkB,CAAC;AAG1B,OAAO,EAAmB,KAAK,QAAQ,EAAE,MAAM,cAAc,CAAC;AAE9D,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAClD,YAAY,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AACnD,OAAO,EAAE,sBAAsB,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AAC5E,YAAY,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAC1D,YAAY,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AAC5D,YAAY,EACV,KAAK,EACL,YAAY,EACZ,KAAK,EACL,KAAK,EACL,UAAU,EACV,GAAG,EACH,OAAO,EACP,YAAY,EACZ,QAAQ,EACR,IAAI,EACJ,SAAS,EACT,QAAQ,GACT,MAAM,YAAY,CAAC;AACpB,YAAY,EACV,cAAc,EACd,iBAAiB,EACjB,aAAa,EACb,iBAAiB,EACjB,aAAa,EACb,eAAe,EACf,aAAa,EACb,gBAAgB,EAChB,mBAAmB,EACnB,eAAe,EACf,oBAAoB,EACpB,gBAAgB,EAChB,yBAAyB,EACzB,qBAAqB,EACrB,2BAA2B,EAC3B,uBAAuB,EACvB,mBAAmB,EACnB,yBAAyB,EACzB,YAAY,EACZ,kBAAkB,GACnB,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAC9C,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAC9C,YAAY,EAAE,YAAY,EAAE,QAAQ,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAC;AACjF,OAAO,EAAE,MAAM,EAAE,aAAa,EAAE,SAAS,EAAE,iBAAiB,EAAE,MAAM,WAAW,CAAC;AAChF,YAAY,EACV,qBAAqB,EACrB,mBAAmB,EACnB,eAAe,EACf,eAAe,EACf,aAAa,EACb,SAAS,GACV,MAAM,WAAW,CAAC;AACnB,YAAY,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAE1C,MAAM,MAAM,wBAAwB,GAAG;IACrC,KAAK,EAAE,SAAS,MAAM,EAAE,CAAC;IACzB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,EAAE,QAAQ,CAAC;IACpB,UAAU,CAAC,EAAE,QAAQ,CAAC,UAAU,CAAC,CAAC;CACnC,CAAC;AAEF,MAAM,MAAM,kBAAkB,GAAG;IAC/B;;;;;;;;;;;;;;;;;;;OAmBG;IACH,oBAAoB,EAAE,oBAAoB,CAAC;CAC5C,CAAC;AAEF,wBAAgB,iBAAiB,CAAC,EAChC,KAAK,EAAE,OAAO,EACd,YAAY,EACZ,QAAa,EACb,UAA2B,GAC5B,EAAE,QAAQ,CAAC,wBAAwB,CAAC,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,QAAQ,CAAC,kBAAkB,CAAC,CAAC,CAAC,CAmCrF;AAED,eAAO,MAAM,WAAW,EAAE,OAAO,CAAC,MAgBjC,CAAC"}

package/dist/index.js

@@ -1,127 +1,63 @@
-import { fromHtml } from "hast-util-from-html";
-import { getAttribute } from "hast-util-get-attribute";
-import { selectAll } from "hast-util-select";
-import fs from "node:fs";
 import upath from "upath";
-import { run, test } from "./command.js";
-import { default as insertPage } from "./command/insert-page.js";
-import { insertRangeStart, insertRangeEnd, deleteRangeStore } from "./command/insert-range.js";
-import { default as insertReference } from "./command/insert-reference.js";
-import { default as expand } from "./command/expand.js";
-import { resolve } from "./resolve.js";
-import { throwError, touchSync } from "./util.js";
-import { sort, byLocales, byListedOrder } from "./sort.js";
-export { byLocales, byListedOrder };
-export function defaultComparator(locales) {
-    return {
-        group: byLocales(locales),
-        mainEntry: byLocales(locales),
-        mainEntryLocator: byListedOrder,
-        mainEntrySee: byLocales(locales),
-        mainEntrySeeAlso: byLocales(locales),
-        subentry: byLocales(locales),
-        subentryLocator: byListedOrder,
-        subentrySee: byLocales(locales),
-        subentrySeeAlso: byLocales(locales),
-    };
-}
-function processEntry(root, indexes, relPath) {
-    selectAll("[data-index]", root)
-        .map((elem) => ({
-        elem,
-        data: getAttribute(elem, "data-index") ??
-            throwError([
-                "data === null: won't happen. it's likely a bug in selectAll() or getAttribute()",
-            ]),
-    }))
-        .map(({ elem, data }) => ({
-        elem,
-        data,
-        cmd: [insertPage, insertRangeStart, insertRangeEnd, insertReference].find((cmd) => test(cmd, data)),
-    }))
-        .filter((obj) => !!obj.cmd)
-        .forEach(({ elem, data, cmd }) => run(cmd, 
-    // @ts-expect-error branded
-    data, indexes, root, elem, relPath));
-}
-export const index = ({ entryProcessor, entryContext, indexEntryMap, comparators, log, }) => {
-    log ??= () => { };
-    const ctx = upath.resolve(process.cwd(), entryContext ?? ".");
-    const normalizedIndexEntryMap = new Map(Object.entries(indexEntryMap).map(([index, entries]) => [
-        upath.resolve(ctx, index),
-        entries.map((ent) => typeof ent === "string"
-            ? { entryPath: upath.resolve(ctx, ent), ignoreUpdate: false }
-            : {
-                entryPath: upath.resolve(ctx, ent.path),
-                ignoreUpdate: ent.ignoreUpdate,
-            }),
-    ]));
-    const entryIndexMap = normalizedIndexEntryMap.entries().reduce((map, [indexPath, entries]) => {
-        entries.forEach(({ entryPath, ignoreUpdate }) => {
-            if (!map.has(entryPath)) {
-                map.set(entryPath, []);
-            }
-            map.get(entryPath).push({ indexPath, ignoreUpdate });
-        });
-        return map;
-    }, new Map());
-    return (tree, file) => {
-        const root = tree;
+import { renderDocumentIndexes } from "./document-renderer.js";
+import { nodeFileSystem } from "./file-system.js";
+import { createIndexState, messagesFor, updateIndexState, } from "./index-state.js";
+import { emitMessages, messages } from "./messages.js";
+import { workingDirectory } from "./platform.js";
+import { resolveProfiles } from "./profile.js";
+export { nodeFileSystem } from "./file-system.js";
+export { InstructionSyntaxError, parseInstruction } from "./instruction.js";
+export { defaultRenderer } from "./render.js";
+export { defaultProfile } from "./profile.js";
+export { byKeys, byListedOrder, byLocales, defaultComparator } from "./sort.js";
+export function createIndexPlugin({ entry: entries, entryContext, profiles = {}, fileSystem = nodeFileSystem, }) {
+    const cwd = workingDirectory();
+    // Vivliostyle CLI also resolves an omitted entryContext against the working directory:
+    // https://github.com/vivliostyle/vivliostyle-cli/blob/v11.1.0/src/config/resolve.ts#L627-L632
+    const context = upath.resolve(cwd, entryContext ?? ".");
+    const entryPaths = entries.map((entry) => upath.resolve(context, entry));
+    let state;
+    const profilesByName = resolveProfiles(profiles);
+    return ({ createEntryProcessor }) => (tree, file) => {
         const rawPath = file.path;
         if (typeof rawPath === "undefined") {
-            log("[vivliostyle-index] cannot extract index entries from anonymous files or expand indexes into anonymous files.");
+            file.message(...messages.anonymousFile);
             return;
         }
-        const filePath = upath.resolve(rawPath);
-        const affects = entryIndexMap.get(filePath);
-        if (affects) {
-            processEntry(root, [], null);
-            // trigger hot reload
-            affects
-                .filter(({ indexPath, ignoreUpdate }) => indexPath !== filePath && !ignoreUpdate)
-                .forEach(({ indexPath }) => {
-                log(`[vivliostyle-index] ${upath.relative(ctx, filePath)} affects ${upath.relative(ctx, indexPath)}`);
-                touchSync(indexPath);
-            });
+        const documentPath = upath.resolve(cwd, rawPath);
+        const root = tree;
+        state ??= createIndexState(entryPaths, fileSystem, createEntryProcessor);
+        const updated = updateIndexState(state, documentPath, root);
+        state = updated.state;
+        for (const targetPath of updated.affectedPaths) {
+            if (targetPath !== documentPath && state.entryPathSet.has(targetPath)) {
+                fileSystem.touchSync(targetPath);
+            }
         }
-        const dependsOn = normalizedIndexEntryMap.get(filePath);
-        if (dependsOn) {
-            const indexes = [];
-            const baseDir = upath.dirname(filePath);
-            dependsOn
-                .map(({ entryPath }) => ({
-                entryPath,
-                contents: fs.readFileSync(entryPath, {
-                    encoding: "utf-8",
-                }),
-            }))
-                .map(({ entryPath, contents }) => ({
-                entryPath,
-                root: fromHtml(entryProcessor
-                    .processSync({
-                    contents,
-                    path: entryPath,
-                })
-                    .toString()),
-            }))
-                .forEach(({ entryPath, root }) => processEntry(root, indexes, filePath === entryPath
-                ? null
-                : upath.relative(baseDir, upath.changeExt(entryPath, ".html"))));
-            deleteRangeStore(indexes);
-            const resolved = sort(resolve(indexes), comparators);
-            selectAll("[data-index]", root)
-                .map((elem) => ({
-                elem,
-                data: getAttribute(elem, "data-index") ??
-                    throwError([
-                        "data === null: won't happen. it's likely a bug in selectAll() or getAttribute()",
-                    ]),
-            }))
-                .filter(({ data }) => test(expand, data))
-                .forEach(({ elem, data }) => run(expand, 
-            // @ts-expect-error branded
-            data, resolved, root, elem, null));
+        if (updated.entryProcessorMismatch) {
+            file.message(...messages.entryProcessorMismatch(documentPath));
         }
+        emitMessages(file, messagesFor(state, documentPath));
+        renderDocumentIndexes(root, documentPath, state.indexes, profilesByName, file);
     };
+}
+export const logMessages = () => (_tree, file) => {
+    for (const message of file.messages) {
+        const location = [message.file, message.line ?? 1, message.column ?? 1]
+            .filter((part) => part !== undefined && part !== "")
+            .join(":");
+        const origin = [message.source, message.ruleId].filter(Boolean).join(":");
+        const report = `${location}: ${message.reason}`;
+        const output = origin === "" ? report : `${report} (${origin})`;
+        if (message.fatal === true) {
+            console.error(output);
+        }
+        else if (message.fatal === false) {
+            console.warn(output);
+        }
+        else {
+            console.info(output);
+        }
+    }
 };
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAC/C,OAAO,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AACvD,OAAO,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAC7C,OAAO,EAAE,MAAM,SAAS,CAAC;AAEzB,OAAO,KAAK,MAAM,OAAO,CAAC;AAE1B,OAAO,EAAE,GAAG,EAAE,IAAI,EAAgB,MAAM,cAAc,CAAC;AACvD,OAAO,EAAE,OAAO,IAAI,UAAU,EAAE,MAAM,0BAA0B,CAAC;AACjE,OAAO,EAAE,gBAAgB,EAAE,cAAc,EAAE,gBAAgB,EAAE,MAAM,2BAA2B,CAAC;AAC/F,OAAO,EAAE,OAAO,IAAI,eAAe,EAAE,MAAM,+BAA+B,CAAC;AAC3E,OAAO,EAAE,OAAO,IAAI,MAAM,EAAE,MAAM,qBAAqB,CAAC;AAExD,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AACvC,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AAClD,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,aAAa,EAAoB,MAAM,WAAW,CAAC;AAC7E,OAAO,EAAE,SAAS,EAAE,aAAa,EAAE,CAAC;AAEpC,MAAM,UAAU,iBAAiB,CAAC,OAA8B;IAC9D,OAAO;QACL,KAAK,EAAE,SAAS,CAAC,OAAO,CAAC;QACzB,SAAS,EAAE,SAAS,CAAC,OAAO,CAAC;QAC7B,gBAAgB,EAAE,aAAa;QAC/B,YAAY,EAAE,SAAS,CAAC,OAAO,CAAC;QAChC,gBAAgB,EAAE,SAAS,CAAC,OAAO,CAAC;QACpC,QAAQ,EAAE,SAAS,CAAC,OAAO,CAAC;QAC5B,eAAe,EAAE,aAAa;QAC9B,WAAW,EAAE,SAAS,CAAC,OAAO,CAAC;QAC/B,eAAe,EAAE,SAAS,CAAC,OAAO,CAAC;KACpC,CAAC;AACJ,CAAC;AAED,SAAS,YAAY,CAAC,IAAe,EAAE,OAAqB,EAAE,OAAsB;IAClF,SAAS,CAAC,cAAc,EAAE,IAAI,CAAC;SAC5B,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;QACd,IAAI;QACJ,IAAI,EACF,YAAY,CAAC,IAAI,EAAE,YAAY,CAAC;YAChC,UAAU,CAAC;gBACT,iFAAiF;aAClF,CAAC;KACL,CAAC,CAAC;SACF,GAAG,CAAC,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,EAAE,EAAE,CAAC,CAAC;QACxB,IAAI;QACJ,IAAI;QACJ,GAAG,EACD,CAAC,UAAU,EAAE,gBAAgB,EAAE,cAAc,EAAE,eAAe,CAC/D,CAAC,IAAI,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,IAAI,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;KACjC,CAAC,CAAC;SACF,MAAM,CAAC,CAAC,GAAG,EAAwC,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC;SAChE,OAAO,CAAC,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,GAAG,EAAE,EAAE,EAAE,CAC/B,GAAG,CACD,GAAG;IACH,2BAA2B;IAC3B,IAAI,EACJ,OAAO,EACP,IAAI,EACJ,IAAI,EACJ,OAAO,CACR,CACF,CAAC;AACN,CAAC;AAYD,MAAM,CAAC,MAAM,KAAK,GAAuC,CAAC,EACxD,cAAc,EACd,YAAY,EACZ,aAAa,EACb,WAAW,EACX,GAAG,GACJ,EAAE,EAAE;IACH,GAAG,KAAK,GAAG,EAAE,GAAE,CAAC,CAAC;IACjB,MAAM,GAAG,GAAG,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,YAAY,IAAI,GAAG,CAAC,CAAC;IAC9D,MAAM,uBAAuB,GAAG,IAAI,GAAG,CACrC,MAAM,CAAC,OAAO,CAAC,aAAa,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,KAAK,EAAE,OAAO,CAAC,EAAE,EAAE,CAAC;QACtD,KAAK,CAAC,OAAO,CAAC,GAAG,EAAE,KAAK,CAAC;QACzB,OAAO,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAClB,OAAO,GAAG,KAAK,QAAQ;YACrB,CAAC,CAAC,EAAE,SAAS,EAAE,KAAK,CAAC,OAAO,CAAC,GAAG,EAAE,GAAG,CAAC,EAAE,YAAY,EAAE,KAAK,EAAE;YAC7D,CAAC,CAAC;gBACE,SAAS,EAAE,KAAK,CAAC,OAAO,CAAC,GAAG,EAAE,GAAG,CAAC,IAAI,CAAC;gBACvC,YAAY,EAAE,GAAG,CAAC,YAAY;aAC/B,CACN;KACF,CAAC,CACH,CAAC;IACF,MAAM,aAAa,GAAG,uBAAuB,CAAC,OAAO,EAAE,CAAC,MAAM,CAC5D,CAAC,GAAG,EAAE,CAAC,SAAS,EAAE,OAAO,CAAC,EAAE,EAAE;QAC5B,OAAO,CAAC,OAAO,CAAC,CAAC,EAAE,SAAS,EAAE,YAAY,EAAE,EAAE,EAAE;YAC9C,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,SAAS,CAAC,EAAE,CAAC;gBACxB,GAAG,CAAC,GAAG,CAAC,SAAS,EAAE,EAAE,CAAC,CAAC;YACzB,CAAC;YACD,GAAG,CAAC,GAAG,CAAC,SAAS,CAAE,CAAC,IAAI,CAAC,EAAE,SAAS,EAAE,YAAY,EAAE,CAAC,CAAC;QACxD,CAAC,CAAC,CAAC;QACH,OAAO,GAAG,CAAC;IACb,CAAC,EACD,IAAI,GAAG,EAAiE,CACzE,CAAC;IAEF,OAAO,CAAC,IAAI,EAAE,IAAI,EAAE,EAAE;QACpB,MAAM,IAAI,GAAG,IAAiB,CAAC;QAE/B,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,CAAC;QAC1B,IAAI,OAAO,OAAO,KAAK,WAAW,EAAE,CAAC;YACnC,GAAG,CACD,+GAA+G,CAChH,CAAC;YACF,OAAO;QACT,CAAC;QACD,MAAM,QAAQ,GAAG,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;QAExC,MAAM,OAAO,GAAG,aAAa,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;QAC5C,IAAI,OAAO,EAAE,CAAC;YACZ,YAAY,CAAC,IAAI,EAAE,EAAE,EAAE,IAAI,CAAC,CAAC;YAE7B,qBAAqB;YACrB,OAAO;iBACJ,MAAM,CAAC,CAAC,EAAE,SAAS,EAAE,YAAY,EAAE,EAAE,EAAE,CAAC,SAAS,KAAK,QAAQ,IAAI,CAAC,YAAY,CAAC;iBAChF,OAAO,CAAC,CAAC,EAAE,SAAS,EAAE,EAAE,EAAE;gBACzB,GAAG,CACD,uBAAuB,KAAK,CAAC,QAAQ,CAAC,GAAG,EAAE,QAAQ,CAAC,YAAY,KAAK,CAAC,QAAQ,CAAC,GAAG,EAAE,SAAS,CAAC,EAAE,CACjG,CAAC;gBACF,SAAS,CAAC,SAAS,CAAC,CAAC;YACvB,CAAC,CAAC,CAAC;QACP,CAAC;QAED,MAAM,SAAS,GAAG,uBAAuB,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;QACxD,IAAI,SAAS,EAAE,CAAC;YACd,MAAM,OAAO,GAAiB,EAAE,CAAC;YACjC,MAAM,OAAO,GAAG,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;YAExC,SAAS;iBACN,GAAG,CAAC,CAAC,EAAE,SAAS,EAAE,EAAE,EAAE,CAAC,CAAC;gBACvB,SAAS;gBACT,QAAQ,EAAE,EAAE,CAAC,YAAY,CAAC,SAAS,EAAE;oBACnC,QAAQ,EAAE,OAAO;iBAClB,CAAC;aACH,CAAC,CAAC;iBACF,GAAG,CAAC,CAAC,EAAE,SAAS,EAAE,QAAQ,EAAE,EAAE,EAAE,CAAC,CAAC;gBACjC,SAAS;gBACT,IAAI,EAAE,QAAQ,CACZ,cAAc;qBACX,WAAW,CAAC;oBACX,QAAQ;oBACR,IAAI,EAAE,SAAS;iBAChB,CAAC;qBACD,QAAQ,EAAE,CACd;aACF,CAAC,CAAC;iBACF,OAAO,CAAC,CAAC,EAAE,SAAS,EAAE,IAAI,EAAE,EAAE,EAAE,CAC/B,YAAY,CACV,IAAI,EACJ,OAAO,EACP,QAAQ,KAAK,SAAS;gBACpB,CAAC,CAAC,IAAI;gBACN,CAAC,CAAC,KAAK,CAAC,QAAQ,CAAC,OAAO,EAAE,KAAK,CAAC,SAAS,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC,CACjE,CACF,CAAC;YAEJ,gBAAgB,CAAC,OAAO,CAAC,CAAC;YAC1B,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,WAAW,CAAC,CAAC;YAErD,SAAS,CAAC,cAAc,EAAE,IAAI,CAAC;iBAC5B,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;gBACd,IAAI;gBACJ,IAAI,EACF,YAAY,CAAC,IAAI,EAAE,YAAY,CAAC;oBAChC,UAAU,CAAC;wBACT,iFAAiF;qBAClF,CAAC;aACL,CAAC,CAAC;iBACF,MAAM,CAAC,CAAC,EAAE,IAAI,EAAE,EAAE,EAAE,CAAC,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;iBACxC,OAAO,CAAC,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,EAAE,EAAE,CAC1B,GAAG,CACD,MAAM;YACN,2BAA2B;YAC3B,IAAI,EACJ,QAAQ,EACR,IAAI,EACJ,IAAI,EACJ,IAAI,CACL,CACF,CAAC;QACN,CAAC;IACH,CAAC,CAAC;AACJ,CAAC,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/dist/instruction.d.ts

@@ -0,0 +1,37 @@
+import { type EntryAddress, type IndexBuilder, type LocatorError, type XrefType } from "./model.ts";
+export type ParsedInstruction = Readonly<{
+    type: "page";
+    address: EntryAddress;
+    template: string;
+}> | Readonly<{
+    type: "range-start";
+    address: EntryAddress;
+    template: string;
+}> | Readonly<{
+    type: "range-end";
+    address: EntryAddress;
+}> | Readonly<{
+    type: XrefType;
+    address: EntryAddress;
+    target: EntryAddress;
+    template: string;
+}>;
+export declare class InstructionSyntaxError extends SyntaxError {
+    readonly offset: number;
+    constructor(input: string, offset: number, reason: string);
+}
+export declare function parseInstruction(source: string): ParsedInstruction;
+type PageInstruction = Extract<ParsedInstruction, {
+    type: "page";
+}>;
+type RangeInstruction = Extract<ParsedInstruction, {
+    type: "range-start";
+}>;
+type XrefInstruction = Extract<ParsedInstruction, {
+    type: XrefType;
+}>;
+export declare function applyPageInstruction(builder: IndexBuilder, instruction: PageInstruction, locationHref: string, error?: LocatorError): void;
+export declare function applyRangeInstruction(builder: IndexBuilder, instruction: RangeInstruction, startHref: string, endHref: string): void;
+export declare function applyXrefInstruction(builder: IndexBuilder, instruction: XrefInstruction): void;
+export {};
+//# sourceMappingURL=instruction.d.ts.map

package/dist/instruction.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"instruction.d.ts","sourceRoot":"","sources":["../src/instruction.ts"],"names":[],"mappings":"AAAA,OAAO,EAKL,KAAK,YAAY,EACjB,KAAK,YAAY,EAEjB,KAAK,YAAY,EACjB,KAAK,QAAQ,EACd,MAAM,YAAY,CAAC;AAGpB,MAAM,MAAM,iBAAiB,GACzB,QAAQ,CAAC;IACP,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,YAAY,CAAC;IACtB,QAAQ,EAAE,MAAM,CAAC;CAClB,CAAC,GACF,QAAQ,CAAC;IACP,IAAI,EAAE,aAAa,CAAC;IACpB,OAAO,EAAE,YAAY,CAAC;IACtB,QAAQ,EAAE,MAAM,CAAC;CAClB,CAAC,GACF,QAAQ,CAAC;IACP,IAAI,EAAE,WAAW,CAAC;IAClB,OAAO,EAAE,YAAY,CAAC;CACvB,CAAC,GACF,QAAQ,CAAC;IACP,IAAI,EAAE,QAAQ,CAAC;IACf,OAAO,EAAE,YAAY,CAAC;IACtB,MAAM,EAAE,YAAY,CAAC;IACrB,QAAQ,EAAE,MAAM,CAAC;CAClB,CAAC,CAAC;AAEP,qBAAa,sBAAuB,SAAQ,WAAW;IACrD,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IAExB,YAAY,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAIxD;CACF;AAkSD,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,MAAM,GAAG,iBAAiB,CA8BlE;AAED,KAAK,eAAe,GAAG,OAAO,CAAC,iBAAiB,EAAE;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC,CAAC;AACpE,KAAK,gBAAgB,GAAG,OAAO,CAAC,iBAAiB,EAAE;IAAE,IAAI,EAAE,aAAa,CAAA;CAAE,CAAC,CAAC;AAC5E,KAAK,eAAe,GAAG,OAAO,CAAC,iBAAiB,EAAE;IAAE,IAAI,EAAE,QAAQ,CAAA;CAAE,CAAC,CAAC;AAEtE,wBAAgB,oBAAoB,CAClC,OAAO,EAAE,YAAY,EACrB,WAAW,EAAE,eAAe,EAC5B,YAAY,EAAE,MAAM,EACpB,KAAK,CAAC,EAAE,YAAY,GACnB,IAAI,CAMN;AAED,wBAAgB,qBAAqB,CACnC,OAAO,EAAE,YAAY,EACrB,WAAW,EAAE,gBAAgB,EAC7B,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,MAAM,GACd,IAAI,CAKN;AAED,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,YAAY,EAAE,WAAW,EAAE,eAAe,GAAG,IAAI,CAO9F"}