@ox-content/napi 2.64.0 → 2.66.0

package/index.d.ts

@@ -474,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. */
@@ -513,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. */
@@ -530,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. */

package/index.js

@@ -1,7 +1,28 @@
 const { existsSync } = require("fs");
 const path = require("path");
 
+function getErrorCode(error) {
+  if (error && typeof error === "object" && "code" in error) {
+    return error.code;
+  }
+}
+
+function getErrorMessage(error) {
+  if (error && typeof error === "object" && "message" in error) {
+    return error.message;
+  }
+  return String(error);
+}
+
+function formatLoadError(target, error) {
+  const code = getErrorCode(error);
+  const suffix = code ? ` [${code}]` : "";
+  return `  - ${target}${suffix}: ${getErrorMessage(error)}`;
+}
+
 function loadBinding() {
+  const loadErrors = [];
+
   // 1. Try loading the local binary (napi build output)
   const napiOutput = path.join(__dirname, "ox-content.node");
   if (existsSync(napiOutput)) {
@@ -56,12 +77,19 @@ function loadBinding() {
   if (subPackage) {
     try {
       return require(subPackage);
-    } catch {}
+    } catch (error) {
+      loadErrors.push(formatLoadError(subPackage, error));
+    }
   }
 
+  const details = loadErrors.length
+    ? `\n\nNative load attempts failed:\n${loadErrors.join("\n")}`
+    : "";
+
   throw new Error(
     `@ox-content/napi: No compatible binary found for ${platform}-${arch}. ` +
-      `If you're working from the repository, run 'nix develop -c vp run build:napi' from the repository root.`,
+      `If you're working from the repository, run 'nix develop -c vp run build:napi' from the repository root.` +
+      details,
   );
 }
 

package/package.json

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