@ox-content/napi 3.0.0-alpha.5 → 3.0.0-alpha.6

package/index.d.ts

@@ -1118,6 +1118,52 @@ export interface JsLocalePath {
   root?: string
 }
 
+/** One configured magic-link alias. */
+export interface JsMagicLinkAlias {
+  /** Absolute `http:` / `https:` URL. */
+  href: string
+  /** Optional display label. Defaults to the alias key. */
+  label?: string
+  /** Optional avatar or favicon URL. */
+  image?: string
+}
+
+/** Replace the resolved image for matching hrefs. */
+export interface JsMagicLinkImageOverride {
+  /** Exact href to replace. */
+  href?: string
+  /** Href prefix to replace. */
+  prefix?: string
+  /** Replacement image URL. Must be `http:` or `https:`. */
+  image: string
+}
+
+/** Opt-in `{link:...}` rich magic links. */
+export interface JsMagicLinkOptions {
+  /**
+   * Enable `{link:@user}`, `{link:alias}`, and `{link:label|url}`.
+   *
+   * Default: `false`.
+   */
+  enabled?: boolean
+  /** Named aliases mapped to href / label / image. */
+  aliases?: Record<string, JsMagicLinkAlias>
+  /**
+   * Emit a favicon URL for explicit links that have no image.
+   *
+   * Default: `false`. No transform-time network request.
+   */
+  favicon?: boolean
+  /**
+   * Favicon URL template with a `{host}` placeholder.
+   *
+   * Default: `https://{host}/favicon.ico` when `favicon` is true.
+   */
+  faviconTemplate?: string
+  /** Image replacements applied after alias / GitHub / favicon resolution. */
+  imageOverrides?: Array<JsMagicLinkImageOverride>
+}
+
 export interface JsMarkdownLintDiagnostic {
   ruleId: string
   severity: string
@@ -1866,15 +1912,15 @@ export interface JsThemeConfig {
   aside?: boolean
   /** Breadcrumb trail from the site root through sidebar ancestors. */
   breadcrumbs?: boolean
+  /** Heading permalink visibility. `"hover"` or `"always"`. CSS only. */
+  headingPermalink?: string
   /** Light mode colors. */
   colors?: JsThemeColors
   /** Dark mode colors. */
   darkColors?: JsThemeColors
-  /** Font configuration. */
   fonts?: JsThemeFonts
   /** Entry page configuration. */
   entryPage?: JsThemeEntryPage
-  /** Layout configuration. */
   layout?: JsThemeLayout
   /** Header configuration. */
   header?: JsThemeHeader
@@ -1989,6 +2035,12 @@ export interface JsTransformOptions {
    * Default: `false`, or `true` when `gfm` is `true`.
    */
   footnotes?: boolean
+  /**
+   * Render footnotes as a semantic ordered section with numeric markers.
+   *
+   * Default: `false`.
+   */
+  semanticFootnotes?: boolean
   /**
    * Enable GFM task-list item markers.
    *
@@ -2088,6 +2140,12 @@ export interface JsTransformOptions {
    * Default: `true`; ignored when [`Self::autolink_urls`] is off.
    */
   autolinkTargetBlank?: boolean
+  /**
+   * Opt-in visible heading permalinks (`<a class="header-anchor" href="#id">`).
+   *
+   * Default: disabled. Existing HTML stays unchanged until this is enabled.
+   */
+  headingPermalinks?: boolean
   /**
    * Opt-in Obsidian-style wiki links.
    *
@@ -2168,6 +2226,12 @@ export interface JsTransformOptions {
    * Default: disabled.
    */
   badges?: JsBadgeOptions
+  /**
+   * Opt-in `{link:...}` rich magic links.
+   *
+   * Default: disabled.
+   */
+  magicLinks?: JsMagicLinkOptions
   /**
    * Opt-in figures, captions, and lazy images.
    *

package/package.json

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