@ontosdk/next 1.1.0 → 1.3.0

package/dist/schemas.d.ts

@@ -0,0 +1,73 @@
+import { OntoConfig } from './config.js';
+
+/**
+ * JSON-LD Schema generators for automatic structured data injection
+ * Follows Schema.org standards for AI-friendly metadata
+ */
+
+/**
+ * Standard AIO (AI Optimization) scoring methodology
+ * Based on the Onto scoring algorithm:
+ * - Content Negotiation: 40% (30 points)
+ * - React Tax / Token Efficiency: 35% (30 points)
+ * - Structured Data: 25% (25 points)
+ * - Semantic HTML: Bonus (15 points)
+ */
+interface AIOMethodologySchema {
+    '@context': 'https://schema.org';
+    '@type': 'HowTo';
+    name: string;
+    description: string;
+    step: Array<{
+        '@type': 'HowToStep';
+        name: string;
+        text: string;
+        position: number;
+    }>;
+}
+/**
+ * Generate AIO Scoring Methodology JSON-LD schema
+ * This explains to AI agents how the scoring system works
+ */
+declare function generateAIOMethodologySchema(config: OntoConfig, pageUrl: string): AIOMethodologySchema;
+/**
+ * Organization schema for About pages
+ */
+interface OrganizationSchema {
+    '@context': 'https://schema.org';
+    '@type': 'Organization';
+    name: string;
+    url?: string;
+    description?: string;
+    logo?: string;
+    foundingDate?: string;
+}
+/**
+ * Generate Organization JSON-LD schema for About pages
+ */
+declare function generateOrganizationSchema(config: OntoConfig, pageUrl: string): OrganizationSchema | null;
+/**
+ * AboutPage schema combining Organization and WebPage
+ */
+interface AboutPageSchema {
+    '@context': 'https://schema.org';
+    '@type': 'AboutPage';
+    name: string;
+    url: string;
+    description?: string;
+    mainEntity?: OrganizationSchema;
+}
+/**
+ * Generate AboutPage JSON-LD schema
+ */
+declare function generateAboutPageSchema(config: OntoConfig, pageUrl: string): AboutPageSchema;
+/**
+ * Determine which schema to generate based on page type
+ */
+declare function generateSchemaForPageType(pageType: 'scoring' | 'about' | 'default', config: OntoConfig, pageUrl: string): any | null;
+/**
+ * Serialize schema to JSON-LD script tag content
+ */
+declare function serializeSchema(schema: any | null): string | null;
+
+export { type AIOMethodologySchema, type AboutPageSchema, type OrganizationSchema, generateAIOMethodologySchema, generateAboutPageSchema, generateOrganizationSchema, generateSchemaForPageType, serializeSchema };

package/dist/schemas.js

@@ -0,0 +1,2 @@
+"use strict";var a=Object.defineProperty;var g=Object.getOwnPropertyDescriptor;var p=Object.getOwnPropertyNames;var u=Object.prototype.hasOwnProperty;var m=(t,e)=>{for(var n in e)a(t,n,{get:e[n],enumerable:!0})},l=(t,e,n,o)=>{if(e&&typeof e=="object"||typeof e=="function")for(let i of p(e))!u.call(t,i)&&i!==n&&a(t,i,{get:()=>e[i],enumerable:!(o=g(e,i))||o.enumerable});return t};var h=t=>l(a({},"__esModule",{value:!0}),t);var y={};m(y,{generateAIOMethodologySchema:()=>r,generateAboutPageSchema:()=>c,generateOrganizationSchema:()=>s,generateSchemaForPageType:()=>f,serializeSchema:()=>d});module.exports=h(y);function r(t,e){return{"@context":"https://schema.org","@type":"HowTo",name:"AIO Score Calculation Methodology",description:"AI Optimization (AIO) Score measures how well a website is optimized for AI agents and LLM crawlers. Scored out of 100 points based on four key metrics.",step:[{"@type":"HowToStep",name:"Content Negotiation",text:"Check if the site responds to Accept: text/markdown header. Weight: 40%. Penalty: -30 points if missing. This ensures AI bots receive optimized content instead of heavy HTML.",position:1},{"@type":"HowToStep",name:"Token Efficiency (React Tax)",text:"Measure the ratio of visible text to total HTML size. Weight: 35%. Penalty: -30 points if HTML > 100KB but text < 1KB. Detects JavaScript-heavy sites that are difficult for AI to parse.",position:2},{"@type":"HowToStep",name:"Structured Data",text:"Verify presence of JSON-LD structured data (Schema.org). Weight: 25%. Penalty: -25 points if missing. Enables AI to confidently extract pricing, products, and entities.",position:3},{"@type":"HowToStep",name:"Semantic HTML",text:"Check for semantic tags like <main> and <article>. Bonus: +15 points if present. Helps AI agents separate navigation from core content.",position:4}]}}function s(t,e){if(!t.organization)return null;let n={"@context":"https://schema.org","@type":"Organization",name:t.organization.name};return t.organization.url&&(n.url=t.organization.url),t.organization.description&&(n.description=t.organization.description),t.organization.logo&&(n.logo=t.organization.logo),t.organization.foundingDate&&(n.foundingDate=t.organization.foundingDate),n}function c(t,e){let n=s(t,e),o={"@context":"https://schema.org","@type":"AboutPage",name:`About ${t.name}`,url:e};return t.summary&&(o.description=t.summary),n&&(o.mainEntity=n),o}function f(t,e,n){switch(t){case"scoring":return r(e,n);case"about":return c(e,n);default:return null}}function d(t){return t?JSON.stringify(t,null,2):null}0&&(module.exports={generateAIOMethodologySchema,generateAboutPageSchema,generateOrganizationSchema,generateSchemaForPageType,serializeSchema});
+//# sourceMappingURL=schemas.js.map

package/dist/schemas.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/schemas.ts"],"sourcesContent":["/**\r\n * JSON-LD Schema generators for automatic structured data injection\r\n * Follows Schema.org standards for AI-friendly metadata\r\n */\r\n\r\nimport { OntoConfig } from './config';\r\n\r\n/**\r\n * Standard AIO (AI Optimization) scoring methodology\r\n * Based on the Onto scoring algorithm:\r\n * - Content Negotiation: 40% (30 points)\r\n * - React Tax / Token Efficiency: 35% (30 points)\r\n * - Structured Data: 25% (25 points)\r\n * - Semantic HTML: Bonus (15 points)\r\n */\r\nexport interface AIOMethodologySchema {\r\n  '@context': 'https://schema.org';\r\n  '@type': 'HowTo';\r\n  name: string;\r\n  description: string;\r\n  step: Array<{\r\n    '@type': 'HowToStep';\r\n    name: string;\r\n    text: string;\r\n    position: number;\r\n  }>;\r\n}\r\n\r\n/**\r\n * Generate AIO Scoring Methodology JSON-LD schema\r\n * This explains to AI agents how the scoring system works\r\n */\r\nexport function generateAIOMethodologySchema(\r\n  config: OntoConfig,\r\n  pageUrl: string\r\n): AIOMethodologySchema {\r\n  return {\r\n    '@context': 'https://schema.org',\r\n    '@type': 'HowTo',\r\n    name: 'AIO Score Calculation Methodology',\r\n    description: 'AI Optimization (AIO) Score measures how well a website is optimized for AI agents and LLM crawlers. Scored out of 100 points based on four key metrics.',\r\n    step: [\r\n      {\r\n        '@type': 'HowToStep',\r\n        name: 'Content Negotiation',\r\n        text: 'Check if the site responds to Accept: text/markdown header. Weight: 40%. Penalty: -30 points if missing. This ensures AI bots receive optimized content instead of heavy HTML.',\r\n        position: 1\r\n      },\r\n      {\r\n        '@type': 'HowToStep',\r\n        name: 'Token Efficiency (React Tax)',\r\n        text: 'Measure the ratio of visible text to total HTML size. Weight: 35%. Penalty: -30 points if HTML > 100KB but text < 1KB. Detects JavaScript-heavy sites that are difficult for AI to parse.',\r\n        position: 2\r\n      },\r\n      {\r\n        '@type': 'HowToStep',\r\n        name: 'Structured Data',\r\n        text: 'Verify presence of JSON-LD structured data (Schema.org). Weight: 25%. Penalty: -25 points if missing. Enables AI to confidently extract pricing, products, and entities.',\r\n        position: 3\r\n      },\r\n      {\r\n        '@type': 'HowToStep',\r\n        name: 'Semantic HTML',\r\n        text: 'Check for semantic tags like <main> and <article>. Bonus: +15 points if present. Helps AI agents separate navigation from core content.',\r\n        position: 4\r\n      }\r\n    ]\r\n  };\r\n}\r\n\r\n/**\r\n * Organization schema for About pages\r\n */\r\nexport interface OrganizationSchema {\r\n  '@context': 'https://schema.org';\r\n  '@type': 'Organization';\r\n  name: string;\r\n  url?: string;\r\n  description?: string;\r\n  logo?: string;\r\n  foundingDate?: string;\r\n}\r\n\r\n/**\r\n * Generate Organization JSON-LD schema for About pages\r\n */\r\nexport function generateOrganizationSchema(\r\n  config: OntoConfig,\r\n  pageUrl: string\r\n): OrganizationSchema | null {\r\n  if (!config.organization) {\r\n    return null;\r\n  }\r\n\r\n  const schema: OrganizationSchema = {\r\n    '@context': 'https://schema.org',\r\n    '@type': 'Organization',\r\n    name: config.organization.name\r\n  };\r\n\r\n  if (config.organization.url) {\r\n    schema.url = config.organization.url;\r\n  }\r\n\r\n  if (config.organization.description) {\r\n    schema.description = config.organization.description;\r\n  }\r\n\r\n  if (config.organization.logo) {\r\n    schema.logo = config.organization.logo;\r\n  }\r\n\r\n  if (config.organization.foundingDate) {\r\n    schema.foundingDate = config.organization.foundingDate;\r\n  }\r\n\r\n  return schema;\r\n}\r\n\r\n/**\r\n * AboutPage schema combining Organization and WebPage\r\n */\r\nexport interface AboutPageSchema {\r\n  '@context': 'https://schema.org';\r\n  '@type': 'AboutPage';\r\n  name: string;\r\n  url: string;\r\n  description?: string;\r\n  mainEntity?: OrganizationSchema;\r\n}\r\n\r\n/**\r\n * Generate AboutPage JSON-LD schema\r\n */\r\nexport function generateAboutPageSchema(\r\n  config: OntoConfig,\r\n  pageUrl: string\r\n): AboutPageSchema {\r\n  const orgSchema = generateOrganizationSchema(config, pageUrl);\r\n\r\n  const schema: AboutPageSchema = {\r\n    '@context': 'https://schema.org',\r\n    '@type': 'AboutPage',\r\n    name: `About ${config.name}`,\r\n    url: pageUrl\r\n  };\r\n\r\n  if (config.summary) {\r\n    schema.description = config.summary;\r\n  }\r\n\r\n  if (orgSchema) {\r\n    schema.mainEntity = orgSchema;\r\n  }\r\n\r\n  return schema;\r\n}\r\n\r\n/**\r\n * Determine which schema to generate based on page type\r\n */\r\nexport function generateSchemaForPageType(\r\n  pageType: 'scoring' | 'about' | 'default',\r\n  config: OntoConfig,\r\n  pageUrl: string\r\n): any | null {\r\n  switch (pageType) {\r\n    case 'scoring':\r\n      return generateAIOMethodologySchema(config, pageUrl);\r\n    case 'about':\r\n      return generateAboutPageSchema(config, pageUrl);\r\n    case 'default':\r\n    default:\r\n      return null;\r\n  }\r\n}\r\n\r\n/**\r\n * Serialize schema to JSON-LD script tag content\r\n */\r\nexport function serializeSchema(schema: any | null): string | null {\r\n  if (!schema) {\r\n    return null;\r\n  }\r\n  return JSON.stringify(schema, null, 2);\r\n}\r\n"],"mappings":"yaAAA,IAAAA,EAAA,GAAAC,EAAAD,EAAA,kCAAAE,EAAA,4BAAAC,EAAA,+BAAAC,EAAA,8BAAAC,EAAA,oBAAAC,IAAA,eAAAC,EAAAP,GAgCO,SAASE,EACdM,EACAC,EACsB,CACtB,MAAO,CACL,WAAY,qBACZ,QAAS,QACT,KAAM,oCACN,YAAa,2JACb,KAAM,CACJ,CACE,QAAS,YACT,KAAM,sBACN,KAAM,iLACN,SAAU,CACZ,EACA,CACE,QAAS,YACT,KAAM,+BACN,KAAM,4LACN,SAAU,CACZ,EACA,CACE,QAAS,YACT,KAAM,kBACN,KAAM,2KACN,SAAU,CACZ,EACA,CACE,QAAS,YACT,KAAM,gBACN,KAAM,0IACN,SAAU,CACZ,CACF,CACF,CACF,CAkBO,SAASL,EACdI,EACAC,EAC2B,CAC3B,GAAI,CAACD,EAAO,aACV,OAAO,KAGT,IAAME,EAA6B,CACjC,WAAY,qBACZ,QAAS,eACT,KAAMF,EAAO,aAAa,IAC5B,EAEA,OAAIA,EAAO,aAAa,MACtBE,EAAO,IAAMF,EAAO,aAAa,KAG/BA,EAAO,aAAa,cACtBE,EAAO,YAAcF,EAAO,aAAa,aAGvCA,EAAO,aAAa,OACtBE,EAAO,KAAOF,EAAO,aAAa,MAGhCA,EAAO,aAAa,eACtBE,EAAO,aAAeF,EAAO,aAAa,cAGrCE,CACT,CAiBO,SAASP,EACdK,EACAC,EACiB,CACjB,IAAME,EAAYP,EAA2BI,EAAQC,CAAO,EAEtDC,EAA0B,CAC9B,WAAY,qBACZ,QAAS,YACT,KAAM,SAASF,EAAO,IAAI,GAC1B,IAAKC,CACP,EAEA,OAAID,EAAO,UACTE,EAAO,YAAcF,EAAO,SAG1BG,IACFD,EAAO,WAAaC,GAGfD,CACT,CAKO,SAASL,EACdO,EACAJ,EACAC,EACY,CACZ,OAAQG,EAAU,CAChB,IAAK,UACH,OAAOV,EAA6BM,EAAQC,CAAO,EACrD,IAAK,QACH,OAAON,EAAwBK,EAAQC,CAAO,EAEhD,QACE,OAAO,IACX,CACF,CAKO,SAASH,EAAgBI,EAAmC,CACjE,OAAKA,EAGE,KAAK,UAAUA,EAAQ,KAAM,CAAC,EAF5B,IAGX","names":["schemas_exports","__export","generateAIOMethodologySchema","generateAboutPageSchema","generateOrganizationSchema","generateSchemaForPageType","serializeSchema","__toCommonJS","config","pageUrl","schema","orgSchema","pageType"]}

package/dist/schemas.mjs

@@ -0,0 +1,2 @@
+function i(t,n){return{"@context":"https://schema.org","@type":"HowTo",name:"AIO Score Calculation Methodology",description:"AI Optimization (AIO) Score measures how well a website is optimized for AI agents and LLM crawlers. Scored out of 100 points based on four key metrics.",step:[{"@type":"HowToStep",name:"Content Negotiation",text:"Check if the site responds to Accept: text/markdown header. Weight: 40%. Penalty: -30 points if missing. This ensures AI bots receive optimized content instead of heavy HTML.",position:1},{"@type":"HowToStep",name:"Token Efficiency (React Tax)",text:"Measure the ratio of visible text to total HTML size. Weight: 35%. Penalty: -30 points if HTML > 100KB but text < 1KB. Detects JavaScript-heavy sites that are difficult for AI to parse.",position:2},{"@type":"HowToStep",name:"Structured Data",text:"Verify presence of JSON-LD structured data (Schema.org). Weight: 25%. Penalty: -25 points if missing. Enables AI to confidently extract pricing, products, and entities.",position:3},{"@type":"HowToStep",name:"Semantic HTML",text:"Check for semantic tags like <main> and <article>. Bonus: +15 points if present. Helps AI agents separate navigation from core content.",position:4}]}}function a(t,n){if(!t.organization)return null;let e={"@context":"https://schema.org","@type":"Organization",name:t.organization.name};return t.organization.url&&(e.url=t.organization.url),t.organization.description&&(e.description=t.organization.description),t.organization.logo&&(e.logo=t.organization.logo),t.organization.foundingDate&&(e.foundingDate=t.organization.foundingDate),e}function r(t,n){let e=a(t,n),o={"@context":"https://schema.org","@type":"AboutPage",name:`About ${t.name}`,url:n};return t.summary&&(o.description=t.summary),e&&(o.mainEntity=e),o}function s(t,n,e){switch(t){case"scoring":return i(n,e);case"about":return r(n,e);default:return null}}function c(t){return t?JSON.stringify(t,null,2):null}export{i as generateAIOMethodologySchema,r as generateAboutPageSchema,a as generateOrganizationSchema,s as generateSchemaForPageType,c as serializeSchema};
+//# sourceMappingURL=schemas.mjs.map

package/dist/schemas.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/schemas.ts"],"sourcesContent":["/**\r\n * JSON-LD Schema generators for automatic structured data injection\r\n * Follows Schema.org standards for AI-friendly metadata\r\n */\r\n\r\nimport { OntoConfig } from './config';\r\n\r\n/**\r\n * Standard AIO (AI Optimization) scoring methodology\r\n * Based on the Onto scoring algorithm:\r\n * - Content Negotiation: 40% (30 points)\r\n * - React Tax / Token Efficiency: 35% (30 points)\r\n * - Structured Data: 25% (25 points)\r\n * - Semantic HTML: Bonus (15 points)\r\n */\r\nexport interface AIOMethodologySchema {\r\n  '@context': 'https://schema.org';\r\n  '@type': 'HowTo';\r\n  name: string;\r\n  description: string;\r\n  step: Array<{\r\n    '@type': 'HowToStep';\r\n    name: string;\r\n    text: string;\r\n    position: number;\r\n  }>;\r\n}\r\n\r\n/**\r\n * Generate AIO Scoring Methodology JSON-LD schema\r\n * This explains to AI agents how the scoring system works\r\n */\r\nexport function generateAIOMethodologySchema(\r\n  config: OntoConfig,\r\n  pageUrl: string\r\n): AIOMethodologySchema {\r\n  return {\r\n    '@context': 'https://schema.org',\r\n    '@type': 'HowTo',\r\n    name: 'AIO Score Calculation Methodology',\r\n    description: 'AI Optimization (AIO) Score measures how well a website is optimized for AI agents and LLM crawlers. Scored out of 100 points based on four key metrics.',\r\n    step: [\r\n      {\r\n        '@type': 'HowToStep',\r\n        name: 'Content Negotiation',\r\n        text: 'Check if the site responds to Accept: text/markdown header. Weight: 40%. Penalty: -30 points if missing. This ensures AI bots receive optimized content instead of heavy HTML.',\r\n        position: 1\r\n      },\r\n      {\r\n        '@type': 'HowToStep',\r\n        name: 'Token Efficiency (React Tax)',\r\n        text: 'Measure the ratio of visible text to total HTML size. Weight: 35%. Penalty: -30 points if HTML > 100KB but text < 1KB. Detects JavaScript-heavy sites that are difficult for AI to parse.',\r\n        position: 2\r\n      },\r\n      {\r\n        '@type': 'HowToStep',\r\n        name: 'Structured Data',\r\n        text: 'Verify presence of JSON-LD structured data (Schema.org). Weight: 25%. Penalty: -25 points if missing. Enables AI to confidently extract pricing, products, and entities.',\r\n        position: 3\r\n      },\r\n      {\r\n        '@type': 'HowToStep',\r\n        name: 'Semantic HTML',\r\n        text: 'Check for semantic tags like <main> and <article>. Bonus: +15 points if present. Helps AI agents separate navigation from core content.',\r\n        position: 4\r\n      }\r\n    ]\r\n  };\r\n}\r\n\r\n/**\r\n * Organization schema for About pages\r\n */\r\nexport interface OrganizationSchema {\r\n  '@context': 'https://schema.org';\r\n  '@type': 'Organization';\r\n  name: string;\r\n  url?: string;\r\n  description?: string;\r\n  logo?: string;\r\n  foundingDate?: string;\r\n}\r\n\r\n/**\r\n * Generate Organization JSON-LD schema for About pages\r\n */\r\nexport function generateOrganizationSchema(\r\n  config: OntoConfig,\r\n  pageUrl: string\r\n): OrganizationSchema | null {\r\n  if (!config.organization) {\r\n    return null;\r\n  }\r\n\r\n  const schema: OrganizationSchema = {\r\n    '@context': 'https://schema.org',\r\n    '@type': 'Organization',\r\n    name: config.organization.name\r\n  };\r\n\r\n  if (config.organization.url) {\r\n    schema.url = config.organization.url;\r\n  }\r\n\r\n  if (config.organization.description) {\r\n    schema.description = config.organization.description;\r\n  }\r\n\r\n  if (config.organization.logo) {\r\n    schema.logo = config.organization.logo;\r\n  }\r\n\r\n  if (config.organization.foundingDate) {\r\n    schema.foundingDate = config.organization.foundingDate;\r\n  }\r\n\r\n  return schema;\r\n}\r\n\r\n/**\r\n * AboutPage schema combining Organization and WebPage\r\n */\r\nexport interface AboutPageSchema {\r\n  '@context': 'https://schema.org';\r\n  '@type': 'AboutPage';\r\n  name: string;\r\n  url: string;\r\n  description?: string;\r\n  mainEntity?: OrganizationSchema;\r\n}\r\n\r\n/**\r\n * Generate AboutPage JSON-LD schema\r\n */\r\nexport function generateAboutPageSchema(\r\n  config: OntoConfig,\r\n  pageUrl: string\r\n): AboutPageSchema {\r\n  const orgSchema = generateOrganizationSchema(config, pageUrl);\r\n\r\n  const schema: AboutPageSchema = {\r\n    '@context': 'https://schema.org',\r\n    '@type': 'AboutPage',\r\n    name: `About ${config.name}`,\r\n    url: pageUrl\r\n  };\r\n\r\n  if (config.summary) {\r\n    schema.description = config.summary;\r\n  }\r\n\r\n  if (orgSchema) {\r\n    schema.mainEntity = orgSchema;\r\n  }\r\n\r\n  return schema;\r\n}\r\n\r\n/**\r\n * Determine which schema to generate based on page type\r\n */\r\nexport function generateSchemaForPageType(\r\n  pageType: 'scoring' | 'about' | 'default',\r\n  config: OntoConfig,\r\n  pageUrl: string\r\n): any | null {\r\n  switch (pageType) {\r\n    case 'scoring':\r\n      return generateAIOMethodologySchema(config, pageUrl);\r\n    case 'about':\r\n      return generateAboutPageSchema(config, pageUrl);\r\n    case 'default':\r\n    default:\r\n      return null;\r\n  }\r\n}\r\n\r\n/**\r\n * Serialize schema to JSON-LD script tag content\r\n */\r\nexport function serializeSchema(schema: any | null): string | null {\r\n  if (!schema) {\r\n    return null;\r\n  }\r\n  return JSON.stringify(schema, null, 2);\r\n}\r\n"],"mappings":"AAgCO,SAASA,EACdC,EACAC,EACsB,CACtB,MAAO,CACL,WAAY,qBACZ,QAAS,QACT,KAAM,oCACN,YAAa,2JACb,KAAM,CACJ,CACE,QAAS,YACT,KAAM,sBACN,KAAM,iLACN,SAAU,CACZ,EACA,CACE,QAAS,YACT,KAAM,+BACN,KAAM,4LACN,SAAU,CACZ,EACA,CACE,QAAS,YACT,KAAM,kBACN,KAAM,2KACN,SAAU,CACZ,EACA,CACE,QAAS,YACT,KAAM,gBACN,KAAM,0IACN,SAAU,CACZ,CACF,CACF,CACF,CAkBO,SAASC,EACdF,EACAC,EAC2B,CAC3B,GAAI,CAACD,EAAO,aACV,OAAO,KAGT,IAAMG,EAA6B,CACjC,WAAY,qBACZ,QAAS,eACT,KAAMH,EAAO,aAAa,IAC5B,EAEA,OAAIA,EAAO,aAAa,MACtBG,EAAO,IAAMH,EAAO,aAAa,KAG/BA,EAAO,aAAa,cACtBG,EAAO,YAAcH,EAAO,aAAa,aAGvCA,EAAO,aAAa,OACtBG,EAAO,KAAOH,EAAO,aAAa,MAGhCA,EAAO,aAAa,eACtBG,EAAO,aAAeH,EAAO,aAAa,cAGrCG,CACT,CAiBO,SAASC,EACdJ,EACAC,EACiB,CACjB,IAAMI,EAAYH,EAA2BF,EAAQC,CAAO,EAEtDE,EAA0B,CAC9B,WAAY,qBACZ,QAAS,YACT,KAAM,SAASH,EAAO,IAAI,GAC1B,IAAKC,CACP,EAEA,OAAID,EAAO,UACTG,EAAO,YAAcH,EAAO,SAG1BK,IACFF,EAAO,WAAaE,GAGfF,CACT,CAKO,SAASG,EACdC,EACAP,EACAC,EACY,CACZ,OAAQM,EAAU,CAChB,IAAK,UACH,OAAOR,EAA6BC,EAAQC,CAAO,EACrD,IAAK,QACH,OAAOG,EAAwBJ,EAAQC,CAAO,EAEhD,QACE,OAAO,IACX,CACF,CAKO,SAASO,EAAgBL,EAAmC,CACjE,OAAKA,EAGE,KAAK,UAAUA,EAAQ,KAAM,CAAC,EAF5B,IAGX","names":["generateAIOMethodologySchema","config","pageUrl","generateOrganizationSchema","schema","generateAboutPageSchema","orgSchema","generateSchemaForPageType","pageType","serializeSchema"]}

package/onto.config.example.ts

@@ -0,0 +1,111 @@
+import { OntoConfig } from './src/config';
+
+/**
+ * Example onto.config.ts file
+ *
+ * Place this file in your project root as `onto.config.ts` to enable
+ * dynamic llms.txt generation.
+ *
+ * The middleware will automatically read this config and generate
+ * /llms.txt on the fly when AI agents request it.
+ */
+const config: OntoConfig = {
+  // Required: The name of your project/site
+  name: 'My Awesome Project',
+
+  // Required: A concise summary for AI agents
+  summary: 'A modern web application for managing tasks and projects. Built with Next.js, TypeScript, and React. Provides a RESTful API and interactive UI.',
+
+  // Required: Base URL of your site
+  baseUrl: 'https://example.com',
+
+  // Optional: Key routes that AI agents should know about
+  routes: [
+    {
+      path: '/',
+      description: 'Homepage with product overview and key features',
+      pageType: 'default'
+    },
+    {
+      path: '/score',
+      description: 'AIO Score Calculator - check your AI optimization score',
+      pageType: 'scoring' // Automatically injects Methodology JSON-LD schema
+    },
+    {
+      path: '/about',
+      description: 'About our company and mission',
+      pageType: 'about' // Automatically injects Organization/AboutPage JSON-LD schema
+    },
+    {
+      path: '/docs',
+      description: 'Complete API documentation and integration guides'
+    },
+    {
+      path: '/docs/getting-started',
+      description: 'Quick start guide for new users'
+    },
+    {
+      path: '/api/reference',
+      description: 'REST API reference with all endpoints and schemas'
+    },
+    {
+      path: '/blog',
+      description: 'Technical blog posts and product updates'
+    },
+    {
+      path: '/pricing',
+      description: 'Pricing plans and feature comparison'
+    }
+  ],
+
+  // Optional: External resources
+  externalLinks: [
+    {
+      title: 'GitHub Repository',
+      url: 'https://github.com/example/project',
+      description: 'Open-source code and issue tracker'
+    },
+    {
+      title: 'API Status',
+      url: 'https://status.example.com',
+      description: 'Real-time API status and incident reports'
+    }
+  ],
+
+  // Optional: Organization info for JSON-LD schemas (used on 'about' pages)
+  organization: {
+    name: 'Example Corp',
+    description: 'Building the future of AI-optimized web applications',
+    url: 'https://example.com',
+    logo: 'https://example.com/logo.png',
+    foundingDate: '2024-01-01'
+  },
+
+  // Optional: Custom sections with any markdown content
+  sections: [
+    {
+      heading: 'About',
+      content: `This project helps teams collaborate more effectively by providing
+a unified workspace for tasks, projects, and documentation. It integrates with
+popular tools like GitHub, Slack, and Jira.`
+    },
+    {
+      heading: 'Key Features',
+      content: `- **Task Management**: Create, assign, and track tasks across teams
+- **Real-time Collaboration**: WebSocket-based updates for instant sync
+- **Rich API**: RESTful API with comprehensive documentation
+- **Integrations**: Connect with 50+ external services
+- **Security**: SOC 2 Type II certified with end-to-end encryption`
+    },
+    {
+      heading: 'Use Cases',
+      content: `**For Development Teams**: Track sprints, manage backlogs, and integrate with CI/CD pipelines.
+
+**For Content Teams**: Plan editorial calendars, collaborate on drafts, and publish content.
+
+**For Product Teams**: Gather feedback, prioritize features, and communicate roadmaps.`
+    }
+  ]
+};
+
+export default config;

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@ontosdk/next",
-    "version": "1.1.0",
+    "version": "1.3.0",
     "description": "Extracts semantic Markdown from React/Next.js pages for AI Agents",
     "main": "dist/index.js",
     "module": "dist/index.mjs",
@@ -18,6 +18,21 @@
             "require": "./dist/middleware.js",
             "import": "./dist/middleware.mjs",
             "types": "./dist/middleware.d.ts"
+        },
+        "./components": {
+            "require": "./dist/OntoHead.js",
+            "import": "./dist/OntoHead.mjs",
+            "types": "./dist/OntoHead.d.ts"
+        },
+        "./provider": {
+            "require": "./dist/OntoProvider.js",
+            "import": "./dist/OntoProvider.mjs",
+            "types": "./dist/OntoProvider.d.ts"
+        },
+        "./config": {
+            "require": "./dist/config.js",
+            "import": "./dist/config.mjs",
+            "types": "./dist/config.d.ts"
         }
     },
     "bin": {
@@ -43,11 +58,22 @@
         "picocolors": "^1.0.0",
         "turndown": "^7.1.3"
     },
+    "peerDependencies": {
+        "next": ">=14.0.0",
+        "react": "^18.0.0 || ^19.0.0"
+    },
+    "peerDependenciesMeta": {
+        "react": {
+            "optional": true
+        }
+    },
     "devDependencies": {
         "@types/node": "^20.11.24",
+        "@types/react": "^19.2.14",
         "@types/turndown": "^5.0.4",
         "next": "^16.1.6",
+        "react": "^19.2.4",
         "tsup": "^8.0.2",
         "typescript": "^5.3.3"
     }
-}
+}

package/src/OntoHead.tsx

@@ -0,0 +1,59 @@
+'use client';
+
+import { usePathname } from 'next/navigation';
+
+/**
+ * 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>
+ *   );
+ * }
+ * ```
+ */
+export function OntoHead() {
+    const pathname = usePathname();
+
+    // Map current route to its .onto markdown payload path
+    let payloadPath = pathname;
+    if (payloadPath === '/' || payloadPath === '') {
+        payloadPath = '/index';
+    }
+    if (payloadPath.endsWith('/') && payloadPath !== '/') {
+        payloadPath = payloadPath.slice(0, -1);
+    }
+
+    const markdownHref = `/.onto${payloadPath}.md`;
+
+    return (
+        <>
+            {/* Per-page markdown alternate for AI agents */}
+            <link
+                rel="alternate"
+                type="text/markdown"
+                href={markdownHref}
+                title="AI-optimized Markdown version"
+            />
+            {/* Site-wide llms.txt manifest */}
+            <link
+                rel="alternate"
+                type="text/plain"
+                href="/llms.txt"
+                title="LLM-readable site manifest"
+            />
+        </>
+    );
+}

package/src/OntoProvider.tsx

@@ -0,0 +1,95 @@
+'use client';
+
+import { usePathname } from 'next/navigation';
+import { ReactNode, useMemo } from 'react';
+import type { OntoConfig, PageType } from './config';
+import { generateSchemaForPageType, serializeSchema } from './schemas';
+
+export 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>
+ *   );
+ * }
+ * ```
+ */
+export function OntoProvider({ baseUrl, children, config }: OntoProviderProps) {
+  const pathname = usePathname();
+
+  // Construct the full URL with the current path and ?format=md query string
+  const cleanBaseUrl = baseUrl.endsWith('/') ? baseUrl.slice(0, -1) : baseUrl;
+  const markdownHref = `${cleanBaseUrl}${pathname}?format=md`;
+  const fullPageUrl = `${cleanBaseUrl}${pathname}`;
+
+  // Determine page type from config routes
+  const pageType: PageType = useMemo(() => {
+    if (!config?.routes) return 'default';
+
+    const matchingRoute = config.routes.find(route => route.path === pathname);
+    return matchingRoute?.pageType || 'default';
+  }, [config, pathname]);
+
+  // Generate JSON-LD schema based on page type
+  const jsonLdSchema = useMemo(() => {
+    if (!config || pageType === 'default') return null;
+
+    const schema = generateSchemaForPageType(pageType, config, fullPageUrl);
+    return serializeSchema(schema);
+  }, [config, pageType, fullPageUrl]);
+
+  return (
+    <>
+      <link
+        rel="alternate"
+        type="text/markdown"
+        href={markdownHref}
+        title="AI-optimized Markdown version"
+      />
+      {jsonLdSchema && (
+        <script
+          type="application/ld+json"
+          dangerouslySetInnerHTML={{ __html: jsonLdSchema }}
+        />
+      )}
+      {children}
+    </>
+  );
+}

package/src/bots.ts

@@ -0,0 +1,68 @@
+/**
+ * Comprehensive registry of AI bot user-agent strings.
+ * The middleware uses this list to detect AI crawlers and serve optimized markdown.
+ */
+
+export interface AiBot {
+    /** The user-agent substring to match against */
+    name: string;
+    /** The company operating this bot */
+    company: string;
+}
+
+/**
+ * Structured registry of all known AI bots, grouped by company.
+ * Useful for analytics and the Control Plane dashboard.
+ */
+export const AI_BOTS: AiBot[] = [
+    // OpenAI
+    { name: 'GPTBot',            company: 'OpenAI' },
+    { name: 'ChatGPT-User',     company: 'OpenAI' },
+    { name: 'OAI-SearchBot',    company: 'OpenAI' },
+
+    // Google
+    { name: 'Googlebot',              company: 'Google' },
+    { name: 'Google-CloudVertexBot',   company: 'Google' },
+    { name: 'Google-Extended',         company: 'Google' },
+    { name: 'GoogleOther',             company: 'Google' },
+
+    // Anthropic
+    { name: 'ClaudeBot',       company: 'Anthropic' },
+    { name: 'Claude-User',    company: 'Anthropic' },
+    { name: 'anthropic-ai',   company: 'Anthropic' },
+
+    // Perplexity
+    { name: 'PerplexityBot',   company: 'Perplexity' },
+    { name: 'Perplexity-User', company: 'Perplexity' },
+
+    // Meta
+    { name: 'Meta-ExternalAgent',   company: 'Meta' },
+    { name: 'Meta-ExternalFetcher', company: 'Meta' },
+    { name: 'FacebookBot',         company: 'Meta' },
+
+    // Common Crawl (used by most smaller AI companies)
+    { name: 'CCBot', company: 'Common Crawl' },
+
+    // Other notable AI crawlers
+    { name: 'Bytespider',        company: 'ByteDance' },
+    { name: 'Applebot-Extended', company: 'Apple' },
+    { name: 'cohere-ai',        company: 'Cohere' },
+    { name: 'YouBot',           company: 'You.com' },
+];
+
+/**
+ * Flat list of user-agent substrings for fast matching in the middleware.
+ */
+export const AI_BOT_USER_AGENTS: string[] = AI_BOTS.map(bot => bot.name);
+
+/**
+ * Given a raw user-agent string, returns the matched AiBot entry or undefined.
+ * Comparison is case-insensitive to handle inconsistent agent casing.
+ */
+export function matchBot(userAgent: string | null): AiBot | undefined {
+    if (!userAgent) return undefined;
+    const lowerUA = userAgent.toLowerCase();
+    return AI_BOTS.find(bot => 
+        lowerUA.includes(bot.name.toLowerCase())
+    );
+}

package/src/cli.ts

@@ -5,7 +5,24 @@ import path from 'path';
 import pc from 'picocolors';
 import { extractContent } from './extractor';
 
+// Simple helper to load .env.local from the current working directory
+function loadEnv() {
+    const envPath = path.join(process.cwd(), '.env.local');
+    if (fs.existsSync(envPath)) {
+        const envContent = fs.readFileSync(envPath, 'utf8');
+        envContent.split(/\r?\n/).forEach(line => {
+            const trimmedLine = line.trim();
+            if (!trimmedLine || trimmedLine.startsWith('#')) return;
+            const [key, ...valueParts] = trimmedLine.split('=');
+            if (key && valueParts.length > 0) {
+                process.env[key.trim()] = valueParts.join('=').trim().replace(/^["']|["']$/g, '');
+            }
+        });
+    }
+}
+
 async function main() {
+    loadEnv();
     console.log(pc.cyan('\n[Onto] Starting Semantic Output Generation...'));
 
     const cwd = process.cwd();
@@ -89,7 +106,7 @@ async function main() {
     const DASHBOARD_URL = process.env.ONTO_DASHBOARD_URL || 'https://app.buildonto.dev';
 
     if (ONTO_API_KEY && totalFilesProcessed > 0) {
-        console.log(pc.cyan('[Onto] Syncing manifest with Control Plane...'));
+        console.log(pc.cyan(`[Onto] Syncing manifest with Control Plane [${DASHBOARD_URL}]...`));
         try {
             const manifest = files.map(file => {
                 const routeName = file.replace(/\.html$/, '');