@oxide/react-asciidoc 2.1.0 → 2.1.1

package/dist/types/inline/index.d.ts

@@ -1,4 +1,4 @@
 export { parseInline, subSpecialchars, subCallouts, subCalloutsRaw } from './parser';
 export type { ParseOptions, ParseState } from './parser';
-export { renderInline, renderInlineAsString } from './renderer';
+export { renderInline, renderInlineAsString, renderInlineAsText } from './renderer';
 export * from './types';

package/dist/types/inline/renderer.d.ts

@@ -1,3 +1,22 @@
 import { InlineNode } from './types';
 export declare function renderInline(nodes: InlineNode[], iconsFont?: boolean): string;
 export declare function renderInlineAsString(nodes: InlineNode[], iconsFont?: boolean): string;
+/**
+ * Render an inline AST back to PLAIN TEXT — the substituted source with no HTML
+ * markup. This is the verbatim-source counterpart to `renderInlineAsString`: it
+ * resolves text-level subs (notably `attributes`) but emits the bare code a
+ * syntax highlighter should tokenize rather than HTML5 elements.
+ *
+ *  - `text` nodes: emitted as-is, with `specialcharacters` entities decoded back
+ *    to literal `< > &` when `decodeEntities` is set (verbatim blocks include
+ *    `specialcharacters` by default, so normally `true`). `raw` passthrough
+ *    nodes (`pass:[]` / `+++`) are already-final author HTML — emitted verbatim,
+ *    never decoded.
+ *  - `quoted` / `anchor` / `footnote` / `button`: flattened to their inner text.
+ *    A highlighter wants the code, not `<em>` / `<a>`; these only appear when the
+ *    author opted into `+quotes` / `+macros` on the block.
+ *  - `callout`: preserved raw as `<N>` — the highlighter resolves callouts itself.
+ *  - `break`: a newline.
+ *  - `image` / `kbd` / `menu` / `indexterm`: no meaningful verbatim text — skipped.
+ */
+export declare function renderInlineAsText(nodes: InlineNode[], decodeEntities?: boolean): string;

package/dist/types/utils/prepareDocument.d.ts

@@ -99,6 +99,13 @@ export interface LiteralBlock extends BaseBlock {
     type: 'listing';
     source: string;
     language: string | undefined;
+    /** `source` with the block's resolved text-level substitutions applied
+     *  (notably `attributes`), un-escaped and un-highlighted — the plain code a
+     *  syntax highlighter should tokenize. Equals `source` when the block's subs
+     *  make no text-level change. Callout markers are preserved in raw `<N>` form
+     *  (resolve them with `subCalloutsRaw`). Quote/macro subs, if enabled, are
+     *  flattened to their text. */
+    subbedSource: string;
 }
 export interface SectionBlock extends BaseBlock {
     type: 'section';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@oxide/react-asciidoc",
-  "version": "2.1.0",
+  "version": "2.1.1",
   "files": [
     "dist"
   ],