@ox-content/napi 2.27.0 → 2.28.0

package/index.d.ts

@@ -575,6 +575,29 @@ export interface JsParserOptions {
   autolinks?: boolean
 }
 
+/** Options for [`transform_pm_embeds`]. */
+export interface JsPmOptions {
+  /**
+   * Enable opt-in synced package-manager tab groups. When `true`, a
+   * `data-ox-tab-group="pkg-manager"` attribute is emitted so the client
+   * runtime keeps every pm tab group on the page in sync via `localStorage`.
+   * Off by default; when omitted/`false` the output has no group attribute
+   * and behaves exactly like a standalone tab group.
+   */
+  sync?: boolean
+}
+
+/** Result of [`transform_pm_embeds`]. */
+export interface JsPmTransformResult {
+  /** HTML with every `<pm>` block expanded into a package-manager tab widget. */
+  html: string
+  /**
+   * Number of tab groups expanded; the caller advances its shared tab-group
+   * counter by this amount.
+   */
+  groupCount: number
+}
+
 /** Public export metadata. */
 export interface JsPublicExport {
   name: string
@@ -1211,6 +1234,16 @@ export declare function transformMdastRaw(source: string, options?: JsTransformO
  */
 export declare function transformMermaid(html: string, mmdcPath: string): MermaidTransformResult
 
+/**
+ * Expand `<pm>` blocks in rendered HTML into npm/pnpm/yarn/bun install tabs.
+ *
+ * The single npm-style command inside each `<pm>` element is converted to the
+ * equivalent command for every package manager and rendered into the shared
+ * `ox-tabs` widget. Groups are numbered from `start_group`. Syncing is opt-in
+ * via `options.sync` and off by default.
+ */
+export declare function transformPmEmbeds(html: string, startGroup: number, options?: JsPmOptions | undefined | null): JsPmTransformResult
+
 /** Transform result containing HTML, frontmatter, and TOC. */
 export interface TransformResult {
   /** The rendered HTML. */

package/package.json

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