@ox-content/napi 2.69.0 → 2.71.0

package/index.d.ts

@@ -85,6 +85,9 @@ export declare function collectSearchMarkdownFiles(srcDir: string, extensions: A
 /** Collects Markdown files for SSG from a source directory. */
 export declare function collectSsgMarkdownFiles(srcDir: string, extensions: Array<string>): Array<string>
 
+/** Escapes Svelte expression delimiters before emitting static compiled markup. */
+export declare function escapeSvelteMarkup(html: string): string
+
 /** Extracts shared CSS and JavaScript assets from generated SSG pages. */
 export declare function externalizeSsgAssets(pages: Array<JsSsgGeneratedHtmlPage>, outDir: string, base: string): JsSsgExternalizedAssets
 
@@ -737,6 +740,13 @@ export interface JsFeatureConfig {
   linkText?: string
 }
 
+export interface JsFrameworkComponentIsland {
+  name: string
+  props: Record<string, any>
+  id: string
+  content?: string
+}
+
 /** Export graph resolution options. */
 export interface JsGraphOptions {
   root?: string
@@ -998,7 +1008,7 @@ export interface JsParserOptions {
   autolinks?: boolean
 }
 
-/** Options for [`transform_pm_embeds`]. */
+/** Options for [`super::transform_pm_embeds`]. */
 export interface JsPmOptions {
   /**
    * Enable opt-in synced package-manager tab groups. When `true`, a
@@ -1010,7 +1020,7 @@ export interface JsPmOptions {
   sync?: boolean
 }
 
-/** Result of [`transform_pm_embeds`]. */
+/** Result of [`super::transform_pm_embeds`]. */
 export interface JsPmTransformResult {
   /** HTML with every `<pm>` block expanded into a package-manager tab widget. */
   html: string
@@ -1335,7 +1345,7 @@ export interface JsSsgSidebarItem {
   stickyCollapsed?: boolean
 }
 
-/** Result of [`transform_tabs_embeds`]. */
+/** Result of [`super::transform_tabs_embeds`]. */
 export interface JsTabsTransformResult {
   /** HTML with every `<tabs>` block expanded. */
   html: string
@@ -1652,8 +1662,8 @@ export interface JsWikiLinkOptions {
 }
 
 /**
- * Options for [`transform_youtube_embeds`]; all optional, matching the TS
- * `YouTubeOptions` defaults when omitted.
+ * Options for [`super::transform_youtube_embeds`]; all optional, matching the
+ * TS `YouTubeOptions` defaults when omitted.
  */
 export interface JsYouTubeOptions {
   /**
@@ -1791,6 +1801,14 @@ export declare function prepareSourceRaw(source: string, options?: JsSourceOptio
 /** Renders an AST (provided as JSON) to HTML. */
 export declare function render(astJson: string): RenderResult
 
+/**
+ * Renders already-produced Markdown HTML into framework-native component code.
+ *
+ * The `target` argument currently accepts `"react"` and `"vue"`. React output
+ * uses `createElement(...)`; Vue output uses `h(...)`.
+ */
+export declare function renderFrameworkComponentCode(html: string, target: string, islands?: Array<JsFrameworkComponentIsland> | undefined | null): string
+
 /** Render result containing the HTML output. */
 export interface RenderResult {
   /** The rendered HTML. */
@@ -1849,13 +1867,7 @@ export declare function transformMdastRaw(source: string, options?: JsTransformO
 /** Transform opt-in static media embed components in already-rendered HTML. */
 export declare function transformMediaEmbeds(html: string, options?: JsMediaEmbedsOptions | undefined | null): string
 
-/**
- * Transforms mermaid code blocks in HTML to rendered SVG diagrams.
- *
- * Extracts `<pre><code class="language-mermaid">...</code></pre>` blocks,
- * renders each in parallel using the mmdc CLI, and replaces them with
- * `<div class="ox-mermaid">...</div>`.
- */
+/** Transforms mermaid code blocks in HTML to rendered SVG diagrams. */
 export declare function transformMermaid(html: string, mmdcPath: string): MermaidTransformResult
 
 /**
@@ -1881,14 +1893,14 @@ export interface TransformResult {
 }
 
 /**
- * Rewrites `<tabs><tab>…</tab></tabs>` blocks in rendered HTML into the no-JS
+ * Rewrites `<tabs><tab>...</tab></tabs>` blocks in rendered HTML into the no-JS
  * CSS tab widget plus a `<details>` fallback. Rust port of the TS
  * `transformTabs`. Groups are numbered from `start_group`.
  */
 export declare function transformTabsEmbeds(html: string, startGroup: number): JsTabsTransformResult
 
 /**
- * Rewrites `<youtube …>` elements in rendered HTML into responsive,
+ * Rewrites `<youtube ...>` elements in rendered HTML into responsive,
  * privacy-enhanced iframe embeds. Rust port of the TS `transformYouTube`.
  */
 export declare function transformYoutubeEmbeds(html: string, options?: JsYouTubeOptions | undefined | null): string

package/index.js

@@ -162,3 +162,5 @@ module.exports.validateMf2 = binding.validateMf2;
 module.exports.checkI18n = binding.checkI18n;
 module.exports.checkI18nProject = binding.checkI18nProject;
 module.exports.extractTranslationKeys = binding.extractTranslationKeys;
+module.exports.renderFrameworkComponentCode = binding.renderFrameworkComponentCode;
+module.exports.escapeSvelteMarkup = binding.escapeSvelteMarkup;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ox-content/napi",
-  "version": "2.69.0",
+  "version": "2.71.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.69.0",
-    "@ox-content/binding-darwin-arm64": "2.69.0",
-    "@ox-content/binding-linux-x64-gnu": "2.69.0",
-    "@ox-content/binding-linux-arm64-gnu": "2.69.0",
-    "@ox-content/binding-win32-x64-msvc": "2.69.0"
+    "@ox-content/binding-darwin-x64": "2.71.0",
+    "@ox-content/binding-darwin-arm64": "2.71.0",
+    "@ox-content/binding-linux-x64-gnu": "2.71.0",
+    "@ox-content/binding-linux-arm64-gnu": "2.71.0",
+    "@ox-content/binding-win32-x64-msvc": "2.71.0"
   }
 }