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

package/index.d.ts

@@ -196,7 +196,7 @@ export declare function generateSsgBareHtml(content: string, title: string): str
 export declare function generateSsgBarePage(page: JsSsgBarePage): string
 
 /** Generates SSG HTML page with navigation and search. */
-export declare function generateSsgHtml(pageData: JsSsgPageData, navGroups: Array<JsSsgNavGroup>, config: JsSsgConfig): string
+export declare function generateSsgHtml(pageData: JsSsgPageData, navGroups: Array<JsSsgNavGroup>, config: JsSsgConfig): JsSsgHtmlResult
 
 /** Returns unique git authors for a file. Empty when git is missing or fails. */
 export declare function getGitContributors(filePath: string, root?: string | undefined | null): Array<JsGitContributor>
@@ -922,6 +922,12 @@ export interface JsGraphOptions {
   externalPackageSources?: Array<JsExternalPackageSource>
 }
 
+/** One page-head validation finding. */
+export interface JsHeadDiagnostic {
+  strict: boolean
+  message: string
+}
+
 /** Header nav link or dropdown. */
 export interface JsHeaderNavItem {
   /** Display label. */
@@ -1080,6 +1086,8 @@ export interface JsJsonLd {
   publisher?: JsJsonLdPublisher
   /** Site origin used for `@id` / `url`. */
   siteUrl?: string
+  pageType?: string
+  graph?: Array<string>
 }
 
 /** Optional JSON-LD publisher. Only configured fields are emitted. */
@@ -1600,14 +1608,12 @@ export interface JsSsgBarePage {
 
 /** SSG configuration. */
 export interface JsSsgConfig {
-  /** Site name. */
   siteName: string
-  /** Base URL path. */
   base: string
-  /** Optional site-root href for breadcrumbs. */
   breadcrumbRootHref?: string
-  /** OG image URL. */
   ogImage?: string
+  siteUrl?: string
+  headValidation?: string
   /** Theme configuration. */
   theme?: JsThemeConfig
   /** Current locale for this page. */
@@ -1660,6 +1666,12 @@ export interface JsSsgGeneratedHtmlPage {
   html: string
 }
 
+/** Themed SSG HTML plus page-head diagnostics. */
+export interface JsSsgHtmlResult {
+  html: string
+  diagnostics: Array<JsHeadDiagnostic>
+}
+
 /** Navigation group for SSG. */
 export interface JsSsgNavGroup {
   /** Group title. */
@@ -1724,6 +1736,10 @@ export interface JsSsgPageData {
   layout?: string
   /** Per-page chrome flags. Honored only when page chrome is enabled. */
   chrome?: JsPageChromeFlags
+  /** Frontmatter `robots`. */
+  robots?: string
+  /** Frontmatter `canonical`. */
+  canonical?: string
 }
 
 /** Resolved SSG output and public route paths. */
@@ -2371,6 +2387,9 @@ export declare function render(astJson: string): RenderResult
  */
 export declare function renderFrameworkComponentCode(html: string, target: string, islands?: Array<JsFrameworkComponentIsland> | undefined | null, mode?: string | undefined | null): string
 
+/** Resolve Unhead-compatible page-head descriptors to HTML. */
+export declare function renderHead(inputJson: string): JsSsgHtmlResult
+
 /** Render result containing the HTML output. */
 export interface RenderResult {
   /** The rendered HTML. */

package/index.js

@@ -209,6 +209,7 @@ module.exports.generateSearchModuleFromOptions = binding.generateSearchModuleFro
 module.exports.collectSearchMarkdownFiles = binding.collectSearchMarkdownFiles;
 module.exports.normalizeVitePressFrontmatter = binding.normalizeVitePressFrontmatter;
 module.exports.generateSsgHtml = binding.generateSsgHtml;
+module.exports.renderHead = binding.renderHead;
 module.exports.generateSsgBareHtml = binding.generateSsgBareHtml;
 module.exports.highlightCodeBlock = binding.highlightCodeBlock;
 module.exports.applyPendingHighlights = binding.applyPendingHighlights;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ox-content/napi",
-  "version": "3.0.0-alpha.4",
+  "version": "3.0.0-alpha.5",
   "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.4",
-    "@ox-content/binding-darwin-arm64": "3.0.0-alpha.4",
-    "@ox-content/binding-linux-x64-gnu": "3.0.0-alpha.4",
-    "@ox-content/binding-linux-x64-musl": "3.0.0-alpha.4",
-    "@ox-content/binding-linux-arm64-gnu": "3.0.0-alpha.4",
-    "@ox-content/binding-linux-arm64-musl": "3.0.0-alpha.4",
-    "@ox-content/binding-win32-x64-msvc": "3.0.0-alpha.4"
+    "@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"
   }
 }