npm - @ontosdk/next - Versions diffs - 1.2.0 → 1.3.1 - Mend

@ontosdk/next 1.2.0 → 1.3.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (53) hide show

package/ONTOROVIDER_USAGE.md ADDED Viewed

@@ -0,0 +1,89 @@
+# OntoProvider Usage Guide
+The `OntoProvider` component is the high-level, "Zero-Config" entry point for AI optimization. It handles both **Auto-Discovery** (link tags) and **Semantic SEO** (JSON-LD schemas) in one wrapper.
+## Features
+- **Automatic Link Tag Injection**: Adds `<link rel="alternate" type="text/markdown">` to every page.
+- **JSON-LD Schema Injection**: Automatically generates structured data (Schema.org) for pages based on your `onto.config.ts`.
+- **Dynamic Path Detection**: Uses `usePathname()` to construct full URLs for AI agents.
+- **AIO Scoring Methodology**: Automatically injects methodology schemas for routes marked as `pageType: 'scoring'`.
+## Installation
+```bash
+npm install @ontosdk/next
+```
+## Usage
+### 1. Basic Setup in Root Layout
+Wrap your application and provide your `baseUrl`. For best results, also pass your `onto.config.ts` object.
+```tsx
+import { OntoProvider } from '@ontosdk/next/provider';
+import config from '../onto.config';
+export default function RootLayout({ children }) {
+  return (
+    <OntoProvider baseUrl="https://example.com" config={config}>
+      <html lang="en">
+        <head />
+        <body>{children}</body>
+      </html>
+    </OntoProvider>
+  );
+}
+```
+### 2. Page Type Configuration
+In your `onto.config.ts`, you can specify `pageType` for automatic schema generation:
+```typescript
+const config: OntoConfig = {
+  // ... basic info
+  routes: [
+    {
+      path: '/pricing',
+      description: 'Pricing & Methodology',
+      pageType: 'scoring' // Triggers AIOMethodologySchema (AIO Scoring)
+    },
+    {
+      path: '/about',
+      description: 'About Us',
+      pageType: 'about'   // Triggers Organization/AboutPage Schema
+    }
+  ]
+};
+```
+## How It Works
+### Auto-Discovery
+For a page at `/docs`, the provider injects:
+```html
+<link rel="alternate" type="text/markdown" href="https://example.com/docs?format=md" />
+```
+### Semantic SEO (JSON-LD)
+If the route matches a `pageType`, it injects a `<script type="application/ld+json">` with highly specific AI-friendly metadata. For example, a `scoring` page receives the **Onto AIO Methodology** schema, explaining your content negotiation and token efficiency weights to LLM crawlers.
+## Comparison with OntoHead
+| Feature | OntoHead | OntoProvider |
+| :--- | :--- | :--- |
+| **Path Pattern** | Static `/.onto/*.md` | Dynamic `?format=md` |
+| **JSON-LD** | No | **Yes** |
+| **Manifests** | Injects `llms.txt` link | No (handled by Middleware) |
+| **Best For** | Static exports (CLI) | Dynamic & Meta-heavy sites |
+## Requirements
+- Next.js ≥14.0.0
+- React ^18.0.0 || ^19.0.0
+## License
+MIT

package/QUICKSTART.md ADDED Viewed

@@ -0,0 +1,71 @@
+# Quick Start: Dynamic llms.txt
+Get AI discovery working in 60 seconds.
+## Step 1: Create Config
+Create `onto.config.ts` in your project root:
+```typescript
+import type { OntoConfig } from '@ontosdk/next';
+const config: OntoConfig = {
+  name: 'My Site',
+  summary: 'Brief description for AI agents',
+  baseUrl: 'https://example.com',
+  routes: [
+    { path: '/', description: 'Homepage' },
+    { path: '/docs', description: 'Documentation' }
+  ]
+};
+export default config;
+```
+## Step 2: Test
+Start your dev server and visit:
+```
+http://localhost:3000/llms.txt
+```
+You should see your dynamically generated llms.txt content!
+## Step 3: Deploy
+Deploy normally—the middleware automatically serves llms.txt to AI agents.
+## What Happens
+1. **AI bot requests `/llms.txt`**
+2. **Middleware detects the request**
+3. **Loads your `onto.config.ts`**
+4. **Generates llms.txt dynamically**
+5. **Returns with proper headers**
+No static files needed—it just works! ✨
+## Example Output
+```markdown
+# My Site
+> Brief description for AI agents
+## Key Routes
+- [/](https://example.com/): Homepage
+- [/docs](https://example.com/docs): Documentation
+```
+## Next Steps
+- [Full Configuration Guide](./LLMS_TXT_GUIDE.md)
+- [Example Config](./onto.config.example.ts)
+- [API Reference](./README.md)
+---
+Need help? Check the [docs](https://buildonto.dev/docs) or [open an issue](https://github.com/anthropics/onto-sdk/issues).

package/README.md ADDED Viewed

@@ -0,0 +1,253 @@
+# @ontosdk/next
+> Optimize your Next.js site for AI agents in 2 minutes
+The Onto SDK automatically converts your Next.js pages into AI-friendly Markdown and intelligently routes bot traffic to optimized endpoints. Reduce token usage by 95% and improve AI agent comprehension.
+## Features
+- 🤖 **AI Bot Detection**: Recognizes 21+ AI crawlers (GPTBot, ClaudeBot, Perplexity, etc.)
+- 📄 **Automatic Extraction**: Converts React/HTML to clean, semantic Markdown
+- 🚀 **Edge Middleware**: Sub-10ms routing on Vercel/Cloudflare Edge
+- 🔍 **AI Discovery**: Auto-generates `llms.txt` from config
+- 📊 **Analytics**: Optional Control Plane for bot tracking (premium)
+- ⚡ **Zero Config**: Works out-of-the-box with sensible defaults
+## Quick Start
+### 1. Install
+```bash
+npm install @ontosdk/next
+```
+### 2. Add Middleware
+Create `middleware.ts` in your project root:
+```typescript
+import { ontoMiddleware as middleware } from '@ontosdk/next/middleware';
+export { middleware };
+export const config = {
+  matcher: ['/((?!api|_next|.*\\..*).*)'],
+};
+```
+### 3. Configure Build
+Update your `package.json`:
+```json
+{
+  "scripts": {
+    "build": "next build && onto-next"
+  }
+}
+```
+### 4. Create `onto.config.ts`
+Create `onto.config.ts` in your project root for dynamic `llms.txt` generation:
+```typescript
+import type { OntoConfig } from '@ontosdk/next';
+const config: OntoConfig = {
+  name: 'My Project',
+  summary: 'A brief description of what your site does',
+  baseUrl: 'https://example.com',
+  routes: [
+    { path: '/', description: 'Homepage' },
+    { path: '/docs', description: 'Documentation' }
+  ]
+};
+export default config;
+```
+That's it! Your site is now optimized for AI agents.
+## How It Works
+### Build Time
+The `onto-next` CLI scans your `.next/server/app/` directory and converts rendered HTML pages to clean Markdown files in `public/.onto/`.
+### Runtime
+The Edge middleware:
+1. Detects AI bots via User-Agent or Accept headers
+2. Rewrites requests to serve pre-generated `.onto/*.md` files
+3. Returns optimized content in <10ms
+### AI Discovery
+When AI agents request `/llms.txt`, the middleware dynamically generates it from your `onto.config.ts` file—no static file needed.
+## Components
+### OntoHead
+Auto-discovery component for AI agents. Injects link tags into your page head.
+```tsx
+import { OntoHead } from '@ontosdk/next/components';
+export default function RootLayout({ children }) {
+  return (
+    <html>
+      <head>
+        <OntoHead />
+      </head>
+      <body>{children}</body>
+    </html>
+  );
+}
+```
+### OntoProvider
+Wraps your app and automatically injects AI discovery tags with dynamic paths.
+```tsx
+import { OntoProvider } from '@ontosdk/next/provider';
+export default function RootLayout({ children }) {
+  return (
+    <OntoProvider baseUrl="https://example.com">
+      <html>
+        <head />
+        <body>{children}</body>
+      </html>
+    </OntoProvider>
+  );
+}
+```
+## Configuration
+### Environment Variables
+```bash
+# Optional: Enable Control Plane analytics
+ONTO_API_KEY=onto_live_xxxx
+ONTO_DASHBOARD_URL=https://app.buildonto.dev
+```
+### onto.config.ts Schema
+```typescript
+interface OntoConfig {
+  name: string;                    // Site name (required)
+  summary: string;                 // Brief description (required)
+  baseUrl: string;                 // Base URL (required)
+  routes?: {                       // Key routes
+    path: string;
+    description: string;
+  }[];
+  externalLinks?: {                // External resources
+    title: string;
+    url: string;
+    description?: string;
+  }[];
+  sections?: {                     // Custom markdown sections
+    heading: string;
+    content: string;
+  }[];
+}
+```
+See [LLMS_TXT_GUIDE.md](./LLMS_TXT_GUIDE.md) for complete configuration documentation.
+## Detected Bots
+| Company | Bots |
+| :--- | :--- |
+| OpenAI | GPTBot, ChatGPT-User, OAI-SearchBot |
+| Anthropic | ClaudeBot, Claude-User, anthropic-ai |
+| Google | Googlebot, Google-CloudVertexBot, Google-Extended |
+| Perplexity | PerplexityBot, Perplexity-User |
+| Meta | Meta-ExternalAgent, Meta-ExternalFetcher |
+| Others | CCBot, Bytespider, Applebot-Extended, cohere-ai, YouBot |
+## Benefits
+### For Your Site
+- **Reduced Load**: AI bots get static Markdown instead of triggering server renders
+- **Better Indexing**: AI agents comprehend your content with 95% fewer tokens
+- **Edge Performance**: Middleware runs in <10ms on the edge
+- **SEO+**: Following emerging "Agent SEO" best practices
+### For AI Agents
+- **Clean Data**: No React boilerplate, Tailwind classes, or layout noise
+- **Structured**: Markdown with proper headings, lists, and links
+- **Fast**: Instant responses from edge cache
+- **Discoverable**: Standard `llms.txt` manifest for site navigation
+## Control Plane (Premium)
+Unlock analytics and dynamic features:
+- **Bot Analytics**: Track which AI agents visit your site
+- **Context Injection**: Append dynamic "hidden prompts" to specific routes
+- **Route Monitoring**: See which pages AI agents access most
+[Sign up at buildonto.dev](https://buildonto.dev)
+## Examples
+- [Demo App](../../apps/demo) - Full working example with config
+- [onto.config.example.ts](./onto.config.example.ts) - Configuration template
+- [LLMS_TXT_GUIDE.md](./LLMS_TXT_GUIDE.md) - Complete llms.txt guide
+## API Reference
+### Middleware
+```typescript
+import { ontoMiddleware } from '@ontosdk/next/middleware';
+// Export as default middleware
+export { ontoMiddleware as middleware };
+```
+### Config Types
+```typescript
+import type { OntoConfig, OntoRoute } from '@ontosdk/next';
+```
+### Utility Functions
+```typescript
+import { loadOntoConfig, generateLlmsTxt } from '@ontosdk/next';
+// Load config from project root
+const config = await loadOntoConfig();
+// Generate llms.txt content
+const llmsTxt = generateLlmsTxt(config);
+```
+## TypeScript Support
+Full TypeScript support with comprehensive type definitions for all exports.
+## Requirements
+- Next.js ≥14.0.0
+- React ^18.0.0 || ^19.0.0
+## License
+MIT
+## Support
+- [Documentation](https://buildonto.dev/docs)
+- [GitHub Issues](https://github.com/anthropics/onto-sdk/issues)
+- [Twitter](https://twitter.com/buildonto)
+---
+Made with ❤️ by the Onto team

package/SCHEMA_QUICKSTART.md ADDED Viewed

@@ -0,0 +1,97 @@
+# Quick Start: Automatic JSON-LD Schemas
+Get AI-friendly structured data in 60 seconds. Zero manual JSON writing required.
+## Step 1: Pass Config to Provider
+```tsx
+// app/layout.tsx
+import { OntoProvider } from '@ontosdk/next/provider';
+import config from '../onto.config'; // ← Import your config
+export default function RootLayout({ children }) {
+  return (
+    <OntoProvider
+      baseUrl="https://example.com"
+      config={config} // ← Pass it here
+    >
+      <html>
+        <head />
+        <body>{children}</body>
+      </html>
+    </OntoProvider>
+  );
+}
+```
+## Step 2: Configure Page Types
+```typescript
+// onto.config.ts
+const config: OntoConfig = {
+  name: 'My Site',
+  summary: 'Description',
+  baseUrl: 'https://example.com',
+  routes: [
+    {
+      path: '/score',
+      description: 'AIO Score Calculator',
+      pageType: 'scoring' // ← Injects Methodology schema
+    },
+    {
+      path: '/about',
+      description: 'About us',
+      pageType: 'about' // ← Injects Organization schema
+    }
+  ],
+  organization: {
+    name: 'My Company',
+    url: 'https://example.com'
+  }
+};
+```
+## Step 3: Verify
+Visit `/score` or `/about` and view page source. You'll see:
+```html
+<script type="application/ld+json">
+{
+  "@context": "https://schema.org",
+  "@type": "HowTo",
+  "name": "AIO Score Calculation Methodology",
+  "step": [...]
+}
+</script>
+```
+## What Gets Injected?
+| Page Type | Schema Type | Use For |
+|-----------|-------------|---------|
+| `scoring` | HowTo | Score calculators, methodology pages |
+| `about` | AboutPage + Organization | Company info, team pages |
+| `default` | None | Everything else (no automatic injection) |
+## AIO Scoring Weights (Included in Schema)
+The `scoring` page type automatically documents:
+- **40%** - Content Negotiation
+- **35%** - Token Efficiency
+- **25%** - Structured Data ← You get these points!
+- **Bonus** - Semantic HTML
+By using this feature, you automatically gain **+25 points** on AIO scoring! 🎉
+## Next Steps
+- [Complete JSON-LD Guide](./JSON_LD_GUIDE.md) - Full documentation
+- [onto.config.example.ts](./onto.config.example.ts) - Example config
+- [Validation Tips](./JSON_LD_GUIDE.md#validation) - Test your schemas
+---
+**Pro Tip**: AI agents can now confidently extract your scoring methodology without hallucinating the weights!

package/dist/OntoHead.d.mts ADDED Viewed

@@ -0,0 +1,27 @@
+import * as react_jsx_runtime from 'react/jsx-runtime';
+/**
+ * OntoHead — Auto-Discovery component for AI agents.
+ *
+ * Injects `<link rel="alternate">` tags into the page `<head>` so AI crawlers
+ * can discover the optimized markdown endpoint for the current route.
+ *
+ * Usage in a Next.js App Router layout:
+ * ```tsx
+ * import { OntoHead } from '@ontosdk/next/components';
+ *
+ * export default function RootLayout({ children }) {
+ *   return (
+ *     <html>
+ *       <head>
+ *         <OntoHead />
+ *       </head>
+ *       <body>{children}</body>
+ *     </html>
+ *   );
+ * }
+ * ```
+ */
+declare function OntoHead(): react_jsx_runtime.JSX.Element;
+export { OntoHead };

package/dist/OntoHead.d.ts ADDED Viewed

@@ -0,0 +1,27 @@
+import * as react_jsx_runtime from 'react/jsx-runtime';
+/**
+ * OntoHead — Auto-Discovery component for AI agents.
+ *
+ * Injects `<link rel="alternate">` tags into the page `<head>` so AI crawlers
+ * can discover the optimized markdown endpoint for the current route.
+ *
+ * Usage in a Next.js App Router layout:
+ * ```tsx
+ * import { OntoHead } from '@ontosdk/next/components';
+ *
+ * export default function RootLayout({ children }) {
+ *   return (
+ *     <html>
+ *       <head>
+ *         <OntoHead />
+ *       </head>
+ *       <body>{children}</body>
+ *     </html>
+ *   );
+ * }
+ * ```
+ */
+declare function OntoHead(): react_jsx_runtime.JSX.Element;
+export { OntoHead };

package/dist/OntoHead.js ADDED Viewed

	@@ -0,0 +1,2 @@
1	+ "use strict";"use client";var l=Object.defineProperty;var d=Object.getOwnPropertyDescriptor;var m=Object.getOwnPropertyNames;var p=Object.prototype.hasOwnProperty;var s=(t,e)=>{for(var a in e)l(t,a,{get:e[a],enumerable:!0})},f=(t,e,a,o)=>{if(e&&typeof e=="object"\|\|typeof e=="function")for(let i of m(e))!p.call(t,i)&&i!==a&&l(t,i,{get:()=>e[i],enumerable:!(o=d(e,i))\|\|o.enumerable});return t};var h=t=>f(l({},"__esModule",{value:!0}),t);var c={};s(c,{OntoHead:()=>k});module.exports=h(c);var r=require("next/navigation"),n=require("react/jsx-runtime");function k(){let e=(0,r.usePathname)();(e==="/"\|\|e==="")&&(e="/index"),e.endsWith("/")&&e!=="/"&&(e=e.slice(0,-1));let a=`/.onto${e}.md`;return(0,n.jsxs)(n.Fragment,{children:[(0,n.jsx)("link",{rel:"alternate",type:"text/markdown",href:a,title:"AI-optimized Markdown version"}),(0,n.jsx)("link",{rel:"alternate",type:"text/plain",href:"/llms.txt",title:"LLM-readable site manifest"})]})}0&&(module.exports={OntoHead});
2	+ //# sourceMappingURL=OntoHead.js.map

package/dist/OntoHead.js.map ADDED Viewed

@@ -0,0 +1 @@

+ {"version":3,"sources":["../src/OntoHead.tsx"],"sourcesContent":["'use client';\n\nimport { usePathname } from 'next/navigation';\n\n/**\n * OntoHead — Auto-Discovery component for AI agents.\n * \n * Injects `<link rel=\"alternate\">` tags into the page `<head>` so AI crawlers\n * can discover the optimized markdown endpoint for the current route.\n * \n * Usage in a Next.js App Router layout:\n * ```tsx\n * import { OntoHead } from '@ontosdk/next/components';\n * \n * export default function RootLayout({ children }) {\n * return (\n * <html>\n * <head>\n * <OntoHead />\n * </head>\n * <body>{children}</body>\n * </html>\n * );\n * }\n * ```\n */\nexport function OntoHead() {\n const pathname = usePathname();\n\n // Map current route to its .onto markdown payload path\n let payloadPath = pathname;\n if (payloadPath === '/' || payloadPath === '') {\n payloadPath = '/index';\n }\n if (payloadPath.endsWith('/') && payloadPath !== '/') {\n payloadPath = payloadPath.slice(0, -1);\n }\n\n const markdownHref = `/.onto${payloadPath}.md`;\n\n return (\n <>\n {/* Per-page markdown alternate for AI agents */}\n <link\n rel=\"alternate\"\n type=\"text/markdown\"\n href={markdownHref}\n title=\"AI-optimized Markdown version\"\n />\n {/* Site-wide llms.txt manifest */}\n <link\n rel=\"alternate\"\n type=\"text/plain\"\n href=\"/llms.txt\"\n title=\"LLM-readable site manifest\"\n />\n </>\n );\n}\n"],"mappings":"sbAAA,IAAAA,EAAA,GAAAC,EAAAD,EAAA,cAAAE,IAAA,eAAAC,EAAAH,GAEA,IAAAI,EAA4B,2BAuCpBC,EAAA,6BAfD,SAASH,GAAW,CAIvB,IAAII,KAHa,eAAY,GAIzBA,IAAgB,KAAOA,IAAgB,MACvCA,EAAc,UAEdA,EAAY,SAAS,GAAG,GAAKA,IAAgB,MAC7CA,EAAcA,EAAY,MAAM,EAAG,EAAE,GAGzC,IAAMC,EAAe,SAASD,CAAW,MAEzC,SACI,oBAEI,oBAAC,QACG,IAAI,YACJ,KAAK,gBACL,KAAMC,EACN,MAAM,gCACV,KAEA,OAAC,QACG,IAAI,YACJ,KAAK,aACL,KAAK,YACL,MAAM,6BACV,GACJ,CAER","names":["OntoHead_exports","__export","OntoHead","__toCommonJS","import_navigation","import_jsx_runtime","payloadPath","markdownHref"]}

package/dist/OntoHead.mjs ADDED Viewed

	@@ -0,0 +1,2 @@
1	+ "use client";import{usePathname as a}from"next/navigation";import{Fragment as i,jsx as t,jsxs as l}from"react/jsx-runtime";function d(){let e=a();(e==="/"\|\|e==="")&&(e="/index"),e.endsWith("/")&&e!=="/"&&(e=e.slice(0,-1));let n=`/.onto${e}.md`;return l(i,{children:[t("link",{rel:"alternate",type:"text/markdown",href:n,title:"AI-optimized Markdown version"}),t("link",{rel:"alternate",type:"text/plain",href:"/llms.txt",title:"LLM-readable site manifest"})]})}export{d as OntoHead};
2	+ //# sourceMappingURL=OntoHead.mjs.map

package/dist/OntoHead.mjs.map ADDED Viewed

@@ -0,0 +1 @@

+ {"version":3,"sources":["../src/OntoHead.tsx"],"sourcesContent":["'use client';\n\nimport { usePathname } from 'next/navigation';\n\n/**\n * OntoHead — Auto-Discovery component for AI agents.\n * \n * Injects `<link rel=\"alternate\">` tags into the page `<head>` so AI crawlers\n * can discover the optimized markdown endpoint for the current route.\n * \n * Usage in a Next.js App Router layout:\n * ```tsx\n * import { OntoHead } from '@ontosdk/next/components';\n * \n * export default function RootLayout({ children }) {\n * return (\n * <html>\n * <head>\n * <OntoHead />\n * </head>\n * <body>{children}</body>\n * </html>\n * );\n * }\n * ```\n */\nexport function OntoHead() {\n const pathname = usePathname();\n\n // Map current route to its .onto markdown payload path\n let payloadPath = pathname;\n if (payloadPath === '/' || payloadPath === '') {\n payloadPath = '/index';\n }\n if (payloadPath.endsWith('/') && payloadPath !== '/') {\n payloadPath = payloadPath.slice(0, -1);\n }\n\n const markdownHref = `/.onto${payloadPath}.md`;\n\n return (\n <>\n {/* Per-page markdown alternate for AI agents */}\n <link\n rel=\"alternate\"\n type=\"text/markdown\"\n href={markdownHref}\n title=\"AI-optimized Markdown version\"\n />\n {/* Site-wide llms.txt manifest */}\n <link\n rel=\"alternate\"\n type=\"text/plain\"\n href=\"/llms.txt\"\n title=\"LLM-readable site manifest\"\n />\n </>\n );\n}\n"],"mappings":"aAEA,OAAS,eAAAA,MAAmB,kBAuCpB,mBAAAC,EAEI,OAAAC,EAFJ,QAAAC,MAAA,oBAfD,SAASC,GAAW,CAIvB,IAAIC,EAHaL,EAAY,GAIzBK,IAAgB,KAAOA,IAAgB,MACvCA,EAAc,UAEdA,EAAY,SAAS,GAAG,GAAKA,IAAgB,MAC7CA,EAAcA,EAAY,MAAM,EAAG,EAAE,GAGzC,IAAMC,EAAe,SAASD,CAAW,MAEzC,OACIF,EAAAF,EAAA,CAEI,UAAAC,EAAC,QACG,IAAI,YACJ,KAAK,gBACL,KAAMI,EACN,MAAM,gCACV,EAEAJ,EAAC,QACG,IAAI,YACJ,KAAK,aACL,KAAK,YACL,MAAM,6BACV,GACJ,CAER","names":["usePathname","Fragment","jsx","jsxs","OntoHead","payloadPath","markdownHref"]}

package/dist/OntoProvider.d.mts ADDED Viewed

@@ -0,0 +1,52 @@
+import * as react_jsx_runtime from 'react/jsx-runtime';
+import { ReactNode } from 'react';
+import { OntoConfig } from './config.mjs';
+interface OntoProviderProps {
+    /**
+     * The base URL of your site (e.g., 'https://example.com')
+     * Used to construct the full href for the AI discovery link tag.
+     */
+    baseUrl: string;
+    /**
+     * Child components to render
+     */
+    children: ReactNode;
+    /**
+     * Optional: Onto configuration for automatic JSON-LD schema injection
+     * If provided, the provider will automatically inject JSON-LD schemas
+     * based on the page type configuration
+     */
+    config?: OntoConfig;
+}
+/**
+ * OntoProvider — Automatic AI Discovery Provider
+ *
+ * Wraps your application and automatically injects:
+ * 1. `<link rel="alternate">` tags for AI discovery
+ * 2. JSON-LD structured data schemas based on page type
+ *
+ * With config, automatically generates JSON-LD schemas:
+ * - 'scoring' pages get Methodology schema with AIO weights (40/35/25)
+ * - 'about' pages get Organization/AboutPage schema
+ *
+ * Usage in a Next.js App Router layout:
+ * ```tsx
+ * import { OntoProvider } from '@ontosdk/next/provider';
+ * import config from '../onto.config';
+ *
+ * export default function RootLayout({ children }) {
+ *   return (
+ *     <OntoProvider baseUrl="https://example.com" config={config}>
+ *       <html>
+ *         <head />
+ *         <body>{children}</body>
+ *       </html>
+ *     </OntoProvider>
+ *   );
+ * }
+ * ```
+ */
+declare function OntoProvider({ baseUrl, children, config }: OntoProviderProps): react_jsx_runtime.JSX.Element;
+export { OntoProvider, type OntoProviderProps };

package/dist/OntoProvider.d.ts ADDED Viewed

@@ -0,0 +1,52 @@
+import * as react_jsx_runtime from 'react/jsx-runtime';
+import { ReactNode } from 'react';
+import { OntoConfig } from './config.js';
+interface OntoProviderProps {
+    /**
+     * The base URL of your site (e.g., 'https://example.com')
+     * Used to construct the full href for the AI discovery link tag.
+     */
+    baseUrl: string;
+    /**
+     * Child components to render
+     */
+    children: ReactNode;
+    /**
+     * Optional: Onto configuration for automatic JSON-LD schema injection
+     * If provided, the provider will automatically inject JSON-LD schemas
+     * based on the page type configuration
+     */
+    config?: OntoConfig;
+}
+/**
+ * OntoProvider — Automatic AI Discovery Provider
+ *
+ * Wraps your application and automatically injects:
+ * 1. `<link rel="alternate">` tags for AI discovery
+ * 2. JSON-LD structured data schemas based on page type
+ *
+ * With config, automatically generates JSON-LD schemas:
+ * - 'scoring' pages get Methodology schema with AIO weights (40/35/25)
+ * - 'about' pages get Organization/AboutPage schema
+ *
+ * Usage in a Next.js App Router layout:
+ * ```tsx
+ * import { OntoProvider } from '@ontosdk/next/provider';
+ * import config from '../onto.config';
+ *
+ * export default function RootLayout({ children }) {
+ *   return (
+ *     <OntoProvider baseUrl="https://example.com" config={config}>
+ *       <html>
+ *         <head />
+ *         <body>{children}</body>
+ *       </html>
+ *     </OntoProvider>
+ *   );
+ * }
+ * ```
+ */
+declare function OntoProvider({ baseUrl, children, config }: OntoProviderProps): react_jsx_runtime.JSX.Element;
+export { OntoProvider, type OntoProviderProps };