asciidoctor 4.0.0-alpha.1 → 4.0.0-alpha.2

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "asciidoctor",
-  "version": "4.0.0-alpha.1",
+  "version": "4.0.0-alpha.2",
   "description": "A JavaScript AsciiDoc processor powered by Asciidoctor",
   "type": "module",
   "main": "index.js",
@@ -53,7 +53,7 @@
   },
   "homepage": "https://github.com/asciidoctor/asciidoctor.js",
   "dependencies": {
-    "@asciidoctor/core": "4.0.0-alpha.1"
+    "@asciidoctor/core": "4.0.0-alpha.2"
   },
   "devDependencies": {
     "@biomejs/biome": "^2.4.13",

package/types/abstract_block.d.ts

@@ -201,7 +201,7 @@ export abstract class AbstractBlock<TContent extends string | any[] = string> ex
      * - `'reject'` → skip the node and its children
      * - `'stop'` → include the node (if it matched) and stop the entire traversal
      *
-     * @param {Object} [selector={}] - Selector criteria object.
+     * @param {Object|Function} [selector={}] - Selector criteria object, or a filter callback when called as `findBy(callback)`.
      * @param {Function|null} [filter=null] - Per-node filter callback.
      * @returns {AbstractBlock[]} array of matching block-level nodes.
      *
@@ -216,8 +216,11 @@ export abstract class AbstractBlock<TContent extends string | any[] = string> ex
      *
      * @example <caption>All image blocks including those inside AsciiDoc table cells</caption>
      * const images = doc.findBy({ context: 'image', traverseDocuments: true })
+     *
+     * @example <caption>Filter-only shorthand (no selector)</caption>
+     * const verbatim = doc.findBy((b) => b.contentModel === ContentModel.VERBATIM)
      */
-    findBy(selector?: any, filter?: Function | null): AbstractBlock[];
+    findBy(selector?: any | Function, filter?: Function | null): AbstractBlock[];
     /** Alias for {@link findBy}. */
     query(selector?: {}, filter?: any): AbstractBlock<string>[];
     /**

package/types/index.d.cts

@@ -0,0 +1,75 @@
+/// <reference types="node" />
+/**
+ * Get the version of Asciidoctor.js.
+ *
+ * @returns {string} - the version of Asciidoctor.js
+ */
+export function getVersion(): string;
+/**
+ * Get Asciidoctor core version number.
+ *
+ * @returns {string} - the version of Asciidoctor core (Ruby)
+ */
+export function getCoreVersion(): string;
+/**
+ * Parse the AsciiDoc source input into a Document.
+ *
+ * @param {string|string[]|Buffer} input - the AsciiDoc source as a String, String Array, or Buffer
+ * @param {Object} [options={}] - a plain object of options to control processing
+ * @returns {Promise<Document>} - the parsed Document
+ */
+export function load(input: string | string[] | Buffer, options?: any): Promise<Document>;
+/**
+ * Parse the contents of the AsciiDoc source file into a Document.
+ *
+ * @param {string} filename - the path to the AsciiDoc source file
+ * @param {Object} [options={}] - a plain object of options to control processing
+ * @returns {Promise<Document>} - the parsed Document
+ */
+export function loadFile(filename: string, options?: any): Promise<Document>;
+import { Document } from './document.js';
+import { convert } from './convert.js';
+import { convertFile } from './convert.js';
+import { DocumentTitle } from './document.js';
+import { Author } from './document.js';
+import { Footnote } from './document.js';
+import { ImageReference } from './document.js';
+import { RevisionInfo } from './document.js';
+import { Logger } from './logging.js';
+import { AbstractNode } from './abstract_node.js';
+import { AbstractBlock } from './abstract_block.js';
+import { Inline } from './inline.js';
+import { Block } from './block.js';
+import { List } from './list.js';
+import { ListItem } from './list.js';
+import { Section } from './section.js';
+import { Reader } from './reader.js';
+import { SyntaxHighlighterBase } from './syntax_highlighter.js';
+import { LoggerManager } from './logging.js';
+import { MemoryLogger } from './logging.js';
+import { NullLogger } from './logging.js';
+import { SafeMode } from './constants.js';
+import { ContentModel } from './constants.js';
+import { Timings } from './timings.js';
+import { Registry } from './extensions.js';
+import { Processor } from './extensions.js';
+import { ProcessorExtension } from './extensions.js';
+import { Preprocessor } from './extensions.js';
+import { TreeProcessor } from './extensions.js';
+import { Postprocessor } from './extensions.js';
+import { IncludeProcessor } from './extensions.js';
+import { DocinfoProcessor } from './extensions.js';
+import { BlockProcessor } from './extensions.js';
+import { InlineMacroProcessor } from './extensions.js';
+import { BlockMacroProcessor } from './extensions.js';
+import { Extensions } from './extensions.js';
+import { Cursor } from './reader.js';
+import { Converter } from './converter.js';
+import { ConverterBase } from './converter.js';
+import { CustomFactory } from './converter.js';
+import { DefaultFactory as DefaultConverterFactory } from './converter.js';
+import { deriveBackendTraits } from './converter.js';
+import { DefaultFactory as DefaultSyntaxHighlighterFactory } from './syntax_highlighter.js';
+import Html5Converter from './converter/html5.js';
+import { SyntaxHighlighter } from './syntax_highlighter.js';
+export { convert, convertFile, Document, DocumentTitle, Author, Footnote, ImageReference, RevisionInfo, Logger, AbstractNode, AbstractBlock, Inline, Block, List, ListItem, Section, Reader, SyntaxHighlighterBase, LoggerManager, MemoryLogger, NullLogger, SafeMode, ContentModel, Timings, Registry, Processor, ProcessorExtension, Preprocessor, TreeProcessor, Postprocessor, IncludeProcessor, DocinfoProcessor, BlockProcessor, InlineMacroProcessor, BlockMacroProcessor, Extensions, Cursor, Converter as ConverterFactory, ConverterBase, CustomFactory as ConverterCustomFactory, DefaultConverterFactory, deriveBackendTraits, DefaultSyntaxHighlighterFactory, Html5Converter, SyntaxHighlighter };