@ox-content/napi 0.0.1-alpha.0 → 0.3.0-alpha.5

package/index.d.ts

@@ -1,230 +0,0 @@
-/* tslint:disable */
-/* eslint-disable */
-
-/* auto-generated by NAPI-RS */
-
-/** Parse result containing the AST as JSON. */
-export interface ParseResult {
-  /** The AST as a JSON string. */
-  ast: string
-  /** Parse errors, if any. */
-  errors: Array<string>
-}
-/** Render result containing the HTML output. */
-export interface RenderResult {
-  /** The rendered HTML. */
-  html: string
-  /** Render errors, if any. */
-  errors: Array<string>
-}
-/** Table of contents entry. */
-export interface TocEntry {
-  /** Heading depth (1-6). */
-  depth: number
-  /** Heading text. */
-  text: string
-  /** URL-friendly slug. */
-  slug: string
-}
-/** Transform result containing HTML, frontmatter, and TOC. */
-export interface TransformResult {
-  /** The rendered HTML. */
-  html: string
-  /** Parsed frontmatter as JSON string. */
-  frontmatter: string
-  /** Table of contents entries. */
-  toc: Array<TocEntry>
-  /** Parse/render errors, if any. */
-  errors: Array<string>
-}
-/** Transform options for JavaScript. */
-export interface JsTransformOptions {
-  /** Enable GFM extensions. */
-  gfm?: boolean
-  /** Enable footnotes. */
-  footnotes?: boolean
-  /** Enable task lists. */
-  taskLists?: boolean
-  /** Enable tables. */
-  tables?: boolean
-  /** Enable strikethrough. */
-  strikethrough?: boolean
-  /** Enable autolinks. */
-  autolinks?: boolean
-  /** Maximum TOC depth (1-6). */
-  tocMaxDepth?: number
-  /** Convert `.md` links to `.html` links for SSG output. */
-  convertMdLinks?: boolean
-  /** Base URL for absolute link conversion (e.g., "/" or "/docs/"). */
-  baseUrl?: string
-}
-/** Parser options for JavaScript. */
-export interface JsParserOptions {
-  /** Enable GFM extensions. */
-  gfm?: boolean
-  /** Enable footnotes. */
-  footnotes?: boolean
-  /** Enable task lists. */
-  taskLists?: boolean
-  /** Enable tables. */
-  tables?: boolean
-  /** Enable strikethrough. */
-  strikethrough?: boolean
-  /** Enable autolinks. */
-  autolinks?: boolean
-}
-/**
- * Parses Markdown source into an AST.
- *
- * Returns the AST as a JSON string for zero-copy transfer to JavaScript.
- */
-export declare function parse(source: string, options?: JsParserOptions | undefined | null): ParseResult
-/** Parses Markdown and renders to HTML. */
-export declare function parseAndRender(source: string, options?: JsParserOptions | undefined | null): RenderResult
-/** Renders an AST (provided as JSON) to HTML. */
-export declare function render(astJson: string): RenderResult
-/** Returns the version of ox_content_napi. */
-export declare function version(): string
-/**
- * Transforms Markdown source into HTML, frontmatter, and TOC.
- *
- * This is the main entry point for unplugin-ox-content.
- */
-export declare function transform(source: string, options?: JsTransformOptions | undefined | null): TransformResult
-/** Parses Markdown and renders to HTML asynchronously (runs on worker thread). */
-export declare function parseAndRenderAsync(source: string, options?: JsParserOptions | undefined | null): Promise<unknown>
-/** Transforms Markdown source asynchronously (runs on worker thread). */
-export declare function transformAsync(source: string, options?: JsTransformOptions | undefined | null): Promise<unknown>
-/** OG image configuration for JavaScript. */
-export interface JsOgImageConfig {
-  /** Image width in pixels. */
-  width?: number
-  /** Image height in pixels. */
-  height?: number
-  /** Background color (hex). */
-  backgroundColor?: string
-  /** Text color (hex). */
-  textColor?: string
-  /** Title font size. */
-  titleFontSize?: number
-  /** Description font size. */
-  descriptionFontSize?: number
-}
-/** OG image data for JavaScript. */
-export interface JsOgImageData {
-  /** Page title. */
-  title: string
-  /** Page description. */
-  description?: string
-  /** Site name. */
-  siteName?: string
-  /** Author name. */
-  author?: string
-}
-/**
- * Generates an OG image as SVG.
- *
- * This function generates an SVG representation of an OG image
- * that can be used for social media previews.
- */
-export declare function generateOgImageSvg(data: JsOgImageData, config?: JsOgImageConfig | undefined | null): string
-/** Search document for JavaScript. */
-export interface JsSearchDocument {
-  /** Unique document identifier. */
-  id: string
-  /** Document title. */
-  title: string
-  /** Document URL. */
-  url: string
-  /** Document body text. */
-  body: string
-  /** Document headings. */
-  headings: Array<string>
-  /** Code snippets. */
-  code: Array<string>
-}
-/** Search result for JavaScript. */
-export interface JsSearchResult {
-  /** Document ID. */
-  id: string
-  /** Document title. */
-  title: string
-  /** Document URL. */
-  url: string
-  /** Relevance score. */
-  score: number
-  /** Matched terms. */
-  matches: Array<string>
-  /** Content snippet. */
-  snippet: string
-}
-/** Search options for JavaScript. */
-export interface JsSearchOptions {
-  /** Maximum number of results. */
-  limit?: number
-  /** Enable prefix matching. */
-  prefix?: boolean
-  /** Enable fuzzy matching. */
-  fuzzy?: boolean
-  /** Minimum score threshold. */
-  threshold?: number
-}
-/**
- * Builds a search index from documents.
- *
- * Takes an array of documents and returns a serialized search index as JSON.
- */
-export declare function buildSearchIndex(documents: Array<JsSearchDocument>): string
-/**
- * Searches a serialized index.
- *
- * Takes a JSON-serialized index, query string, and options.
- * Returns an array of search results.
- */
-export declare function searchIndex(indexJson: string, query: string, options?: JsSearchOptions | undefined | null): Array<JsSearchResult>
-/** Navigation item for SSG. */
-export interface JsSsgNavItem {
-  /** Display title. */
-  title: string
-  /** URL path. */
-  path: string
-  /** Full href. */
-  href: string
-}
-/** Navigation group for SSG. */
-export interface JsSsgNavGroup {
-  /** Group title. */
-  title: string
-  /** Navigation items. */
-  items: Array<JsSsgNavItem>
-}
-/** Page data for SSG. */
-export interface JsSsgPageData {
-  /** Page title. */
-  title: string
-  /** Page description. */
-  description?: string
-  /** Page content HTML. */
-  content: string
-  /** Table of contents entries. */
-  toc: Array<TocEntry>
-  /** URL path. */
-  path: string
-}
-/** SSG configuration. */
-export interface JsSsgConfig {
-  /** Site name. */
-  siteName: string
-  /** Base URL path. */
-  base: string
-  /** OG image URL. */
-  ogImage?: string
-}
-/** Generates SSG HTML page with navigation and search. */
-export declare function generateSsgHtml(pageData: JsSsgPageData, navGroups: Array<JsSsgNavGroup>, config: JsSsgConfig): string
-/**
- * Extracts searchable content from Markdown source.
- *
- * Parses the Markdown and extracts title, body text, headings, and code.
- */
-export declare function extractSearchContent(source: string, id: string, url: string, options?: JsParserOptions | undefined | null): JsSearchDocument

package/index.js

@@ -1,61 +1,78 @@
-const { existsSync } = require('fs');
-const { join } = require('path');
+const { existsSync } = require("fs")
+const path = require("path")
 
 function loadBinding() {
-  // Try loading the local development binary first (index.node)
-  const localBinary = join(__dirname, 'index.node');
+  // 1. Try loading the local development binary first (index.node)
+  const localBinary = path.join(__dirname, "index.node")
   if (existsSync(localBinary)) {
-    return require(localBinary);
+    return require(localBinary)
   }
 
-  // Try platform-specific binary
-  const platform = process.platform;
-  const arch = process.arch;
+  // 2. Try platform-specific binary in same directory (CI build artifact)
+  const platform = process.platform
+  const arch = process.arch
 
   const platforms = {
-    'darwin-arm64': 'ox-content.darwin-arm64.node',
-    'darwin-x64': 'ox-content.darwin-x64.node',
-    'linux-x64-gnu': 'ox-content.linux-x64-gnu.node',
-    'linux-arm64-gnu': 'ox-content.linux-arm64-gnu.node',
-    'win32-x64-msvc': 'ox-content.win32-x64-msvc.node',
-  };
-
-  let key;
-  if (platform === 'darwin') {
-    key = `darwin-${arch}`;
-  } else if (platform === 'linux') {
-    key = `linux-${arch}-gnu`;
-  } else if (platform === 'win32') {
-    key = `win32-${arch}-msvc`;
+    "darwin-arm64": "ox-content.darwin-arm64.node",
+    "darwin-x64": "ox-content.darwin-x64.node",
+    "linux-x64-gnu": "ox-content.linux-x64-gnu.node",
+    "linux-arm64-gnu": "ox-content.linux-arm64-gnu.node",
+    "win32-x64-msvc": "ox-content.win32-x64-msvc.node",
   }
 
-  const binaryName = platforms[key];
+  let key
+  if (platform === "darwin") {
+    key = `darwin-${arch}`
+  } else if (platform === "linux") {
+    key = `linux-${arch}-gnu`
+  } else if (platform === "win32") {
+    key = `win32-${arch}-msvc`
+  }
+
+  const binaryName = platforms[key]
   if (binaryName) {
-    const binaryPath = join(__dirname, binaryName);
+    const binaryPath = path.join(__dirname, binaryName)
     if (existsSync(binaryPath)) {
-      return require(binaryPath);
+      return require(binaryPath)
     }
   }
 
+  // 3. Try npm sub-packages (@ox-content/binding-darwin-arm64 etc.)
+  const subPackages = {
+    "darwin-arm64": "@ox-content/binding-darwin-arm64",
+    "darwin-x64": "@ox-content/binding-darwin-x64",
+    "linux-x64-gnu": "@ox-content/binding-linux-x64-gnu",
+    "linux-arm64-gnu": "@ox-content/binding-linux-arm64-gnu",
+    "win32-x64-msvc": "@ox-content/binding-win32-x64-msvc",
+  }
+
+  const subPackage = subPackages[key]
+  if (subPackage) {
+    try {
+      return require(subPackage)
+    } catch {}
+  }
+
   throw new Error(
     `@ox-content/napi: No compatible binary found for ${platform}-${arch}. ` +
-    `Please run 'pnpm build' in crates/ox_content_napi.`
-  );
+      `Please run 'pnpm build' in crates/ox_content_napi.`,
+  )
 }
 
-const binding = loadBinding();
+const binding = loadBinding()
 
 // Export individual functions for ESM compatibility
-module.exports = binding;
-module.exports.parse = binding.parse;
-module.exports.parseAndRender = binding.parseAndRender;
-module.exports.parseAndRenderAsync = binding.parseAndRenderAsync;
-module.exports.render = binding.render;
-module.exports.transform = binding.transform;
-module.exports.transformAsync = binding.transformAsync;
-module.exports.version = binding.version;
-module.exports.generateOgImageSvg = binding.generateOgImageSvg;
-module.exports.buildSearchIndex = binding.buildSearchIndex;
-module.exports.searchIndex = binding.searchIndex;
-module.exports.extractSearchContent = binding.extractSearchContent;
-module.exports.generateSsgHtml = binding.generateSsgHtml;
+module.exports = binding
+module.exports.parse = binding.parse
+module.exports.parseAndRender = binding.parseAndRender
+module.exports.parseAndRenderAsync = binding.parseAndRenderAsync
+module.exports.render = binding.render
+module.exports.transform = binding.transform
+module.exports.transformAsync = binding.transformAsync
+module.exports.version = binding.version
+module.exports.generateOgImageSvg = binding.generateOgImageSvg
+module.exports.buildSearchIndex = binding.buildSearchIndex
+module.exports.searchIndex = binding.searchIndex
+module.exports.extractSearchContent = binding.extractSearchContent
+module.exports.generateSsgHtml = binding.generateSsgHtml
+module.exports.transformMermaid = binding.transformMermaid

package/package.json

@@ -1,16 +1,16 @@
 {
   "name": "@ox-content/napi",
-  "version": "0.0.1-alpha.0",
+  "version": "0.3.0-alpha.5",
   "description": "Node.js bindings for Ox Content - High-performance Markdown parser",
   "main": "index.js",
   "types": "index.d.ts",
   "files": [
     "index.js",
-    "index.d.ts",
-    "*.node"
+    "index.d.ts"
   ],
   "napi": {
     "binaryName": "ox-content",
+    "packageName": "@ox-content/binding",
     "targets": [
       "x86_64-apple-darwin",
       "aarch64-apple-darwin",
@@ -19,12 +19,8 @@
       "x86_64-pc-windows-msvc"
     ]
   },
-  "scripts": {
-    "build": "napi build --release",
-    "build:debug": "napi build"
-  },
   "devDependencies": {
-    "@napi-rs/cli": "^2.18.0"
+    "@napi-rs/cli": "^3.0.0"
   },
   "repository": {
     "type": "git",
@@ -32,6 +28,7 @@
     "directory": "crates/ox_content_napi"
   },
   "publishConfig": {
+    "provenance": true,
     "access": "public"
   },
   "keywords": [
@@ -42,5 +39,16 @@
     "oxc"
   ],
   "author": "ubugeeei",
-  "license": "MIT"
-}
+  "license": "MIT",
+  "optionalDependencies": {
+    "@ox-content/binding-darwin-x64": "0.3.0-alpha.5",
+    "@ox-content/binding-darwin-arm64": "0.3.0-alpha.5",
+    "@ox-content/binding-linux-x64-gnu": "0.3.0-alpha.5",
+    "@ox-content/binding-linux-arm64-gnu": "0.3.0-alpha.5",
+    "@ox-content/binding-win32-x64-msvc": "0.3.0-alpha.5"
+  },
+  "scripts": {
+    "build": "napi build --release",
+    "build:debug": "napi build"
+  }
+}