@ox-content/napi 2.63.0 → 2.65.0

package/index.d.ts

@@ -1,5 +1,39 @@
 /* auto-generated by NAPI-RS */
 /* eslint-disable */
+/** Stateful Markdown parser for append-only streams. */
+export declare class IncrementalMarkdownParser {
+  /** Creates an incremental Markdown parser. */
+  constructor(options?: JsParserOptions | undefined | null)
+  /** Appends Markdown and returns committed plus optional provisional AST JSON. */
+  append(chunk: string, options?: JsIncrementalParseOptions | undefined | null): IncrementalMarkdownParseResult
+  /** Finalizes the stream and commits any remaining Markdown. */
+  finish(options?: JsIncrementalParseOptions | undefined | null): IncrementalMarkdownParseResult
+  /** Clears all stream state. */
+  reset(): void
+  /** Returns the current unstable Markdown tail. */
+  get pendingMarkdown(): string
+  /** Returns the number of bytes committed from the stream. */
+  get committedBytes(): number
+  /** Returns the total number of bytes observed from the stream. */
+  get totalBytes(): number
+}
+
+/** Stateful Markdown-to-HTML renderer for append-only streams. */
+export declare class IncrementalMarkdownRenderer {
+  /** Creates an incremental Markdown renderer. */
+  constructor(options?: JsParserOptions | undefined | null)
+  /** Appends Markdown and returns committed delta plus provisional HTML. */
+  append(chunk: string, options?: JsIncrementalRenderOptions | undefined | null): IncrementalMarkdownRenderResult
+  /** Finalizes the stream and commits any remaining Markdown. */
+  finish(): IncrementalMarkdownRenderResult
+  /** Clears parser, renderer, and accumulated HTML state. */
+  reset(): void
+  /** Returns all committed HTML so far. */
+  get committedHtml(): string
+  /** Returns the current unstable Markdown tail. */
+  get pendingMarkdown(): string
+}
+
 /** Builds the public API export graph from entry points. */
 export declare function buildExportGraph(entryPoints: Array<JsEntryPointSpec>, options?: JsGraphOptions | undefined | null): JsExportGraph
 
@@ -199,6 +233,40 @@ export interface I18NLoadResult {
   errors: Array<string>
 }
 
+/** Incremental parser append result. */
+export interface IncrementalMarkdownParseResult {
+  ast: string
+  pendingAst: string
+  markdown: string
+  pendingMarkdown: string
+  committedByteStart: number
+  committedByteEnd: number
+  committedBytes: number
+  pendingBytes: number
+  totalBytes: number
+  didCommit: boolean
+  isFinal: boolean
+  errors: Array<string>
+}
+
+/** Incremental renderer append result. */
+export interface IncrementalMarkdownRenderResult {
+  deltaHtml: string
+  committedHtml: string
+  pendingHtml: string
+  html: string
+  markdown: string
+  pendingMarkdown: string
+  committedByteStart: number
+  committedByteEnd: number
+  committedBytes: number
+  pendingBytes: number
+  totalBytes: number
+  didCommit: boolean
+  isFinal: boolean
+  errors: Array<string>
+}
+
 /** Attribute syntax transform options. */
 export interface JsAttrsOptions {
   /** Enable markdown-it-attrs style `{#id .class key=value}`. */
@@ -406,6 +474,8 @@ export interface JsDocsMarkdownOptions {
    * sort strategy.
    */
   kindSortOrder?: Array<string>
+  /** Single-entry root handling for TypeDoc-style Markdown output. */
+  singleEntryRoot?: 'preserve' | 'flatten'
 }
 
 /** Ordered JSDoc tag used by generated API Markdown. */
@@ -445,6 +515,8 @@ export interface JsDocsNavOptions {
    * `groupOrder`) and the `kind` sort strategy.
    */
   kindSortOrder?: Array<string>
+  /** Single-entry root handling for TypeDoc-style nav. */
+  singleEntryRoot?: 'preserve' | 'flatten'
 }
 
 /** Options for writing generated API documentation files. */
@@ -462,6 +534,8 @@ export interface JsDocsOutputOptions {
   sortEntryPoints?: boolean
   /** TypeDoc-style kind ranking for generated nav groups. */
   kindSortOrder?: Array<string>
+  /** Single-entry root handling for generated nav metadata. */
+  singleEntryRoot?: 'preserve' | 'flatten'
 }
 
 /** Docs-as-tests extraction options. */
@@ -668,6 +742,26 @@ export interface JsI18NRuntimeLocale {
   dir?: string
 }
 
+/** Options for appending to an incremental parser. */
+export interface JsIncrementalParseOptions {
+  /** Treat this append as the final stream chunk. */
+  isFinal?: boolean
+  /** Include a provisional AST for the current unstable tail. */
+  includePendingAst?: boolean
+  /** Temporarily close unmatched inline delimiters in the provisional AST. */
+  completeInline?: boolean
+}
+
+/** Options for appending to an incremental renderer. */
+export interface JsIncrementalRenderOptions {
+  /** Treat this append as the final stream chunk. */
+  isFinal?: boolean
+  /** Render the current unstable tail as replaceable provisional HTML. */
+  renderPending?: boolean
+  /** Temporarily close unmatched inline delimiters in provisional HTML. */
+  completeInline?: boolean
+}
+
 /** Locale information for the locale switcher. */
 export interface JsLocaleInfo {
   /** BCP 47 locale tag. */

package/index.js

@@ -74,6 +74,8 @@ module.exports.parseTransferRaw = binding.parseTransferRaw;
 module.exports.parseMdastRaw = binding.parseMdastRaw;
 module.exports.parseAndRender = binding.parseAndRender;
 module.exports.parseAndRenderAsync = binding.parseAndRenderAsync;
+module.exports.IncrementalMarkdownParser = binding.IncrementalMarkdownParser;
+module.exports.IncrementalMarkdownRenderer = binding.IncrementalMarkdownRenderer;
 module.exports.prepareSource = binding.prepareSource;
 module.exports.prepareSourceRaw = binding.prepareSourceRaw;
 module.exports.lintMarkdown = binding.lintMarkdown;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ox-content/napi",
-  "version": "2.63.0",
+  "version": "2.65.0",
   "description": "Node.js bindings for Ox Content - High-performance Markdown parser",
   "keywords": [
     "markdown",
@@ -45,10 +45,10 @@
     ]
   },
   "optionalDependencies": {
-    "@ox-content/binding-darwin-x64": "2.63.0",
-    "@ox-content/binding-darwin-arm64": "2.63.0",
-    "@ox-content/binding-linux-x64-gnu": "2.63.0",
-    "@ox-content/binding-linux-arm64-gnu": "2.63.0",
-    "@ox-content/binding-win32-x64-msvc": "2.63.0"
+    "@ox-content/binding-darwin-x64": "2.65.0",
+    "@ox-content/binding-darwin-arm64": "2.65.0",
+    "@ox-content/binding-linux-x64-gnu": "2.65.0",
+    "@ox-content/binding-linux-arm64-gnu": "2.65.0",
+    "@ox-content/binding-win32-x64-msvc": "2.65.0"
   }
 }