asciidoc-abundant-tree 0.2.0 → 0.2.2

package/README.md

@@ -274,6 +274,29 @@ const ttl = projection.ttl;
 const jsonLd = projection.jsonLd;
 ```
 
+Book-entry callers can register include resolvers for includes that select by something other than a file path, such as a symbol in a TypeScript file. A resolver claims targets by prefix and returns whole consecutive lines of a source file inside `documentRoot`, plus the line they start at; the lines get coordinates in that file just like a file include:
+
+```ts
+const book = await parseAbundantTree({
+	sourcePath: "bookshelf/books/08-design/book.adoc",
+	mode: "book-entry",
+	documentRoot: ".",
+	includeResolvers: [
+		{
+			// include::docloom:examples/replay.ts[symbol=replay,part=source]
+			prefix: "docloom:",
+			resolve: ({ target, attributes }) => {
+				// Your own selector: find the declaration, widen it to whole lines.
+				const { text, startLine } = selectWholeLines(target, attributes);
+				return { text, origin: { path: target, startLine } };
+			},
+		},
+	],
+});
+```
+
+`attributes` are the include attributes as Asciidoctor parses them, the same an Asciidoctor include processor receives, so the bookshelf build and this parser can register the same selector. A blank positional attribute is `null`: the first one in `[,beta]`, the second one in `[beta,,gamma]`. A resolver that throws fails construction with `include.resolver-failed`; returned text that does not match its source leaves those lines without coordinates and reports `origin-map.selection-mismatch`.
+
 `parseAbundantTree` reads only the supplied source file. Interdocument xrefs keep their raw target and official href when Asciidoctor exposes one, but this package does not open the referenced `.adoc` file.
 
 Browser tools that already hold AsciiDoc source text can use the browser-safe subpath:

package/dist/animation-yaml-export/cli.mjs

@@ -1,5 +1,5 @@
 #!/usr/bin/env node
-import { o as exportAnimationYaml } from "../src-CNTTQlPJ.mjs";
+import { o as exportAnimationYaml } from "../src-DmT-MEPN.mjs";
 import process from "node:process";
 //#region src/animation-yaml-export/cli.ts
 const USAGE = `Usage:

package/dist/browser.d.mts

@@ -154,7 +154,7 @@ type XrefOccurrenceNode = NodeBase & {
 };
 type AnchorOccurrenceNode = NodeBase & {
   kind: "anchor";
-  syntax: "double-bracket" | "macro";
+  syntax: "double-bracket" | "macro" | "bibliography";
   raw: string;
   ids: string[];
   reftext?: string;
@@ -179,6 +179,7 @@ type TargetNode = NodeBase & {
   title?: string;
   idOrigin: "source" | "asciidoctor-generated" | "unknown";
   sourceSpan?: SourceSpan;
+  containingSectionId?: string;
 };
 type TextNode = NodeBase & {
   kind: "text";