sanity-plugin-seofields 1.9.0 → 1.10.0

package/dist/cli.js

@@ -61,7 +61,7 @@ ${e}`}function xt(e,t,o,n){a.success(`Updated ${e}`),a.dim(""),a.dim("  What was
     title,
     slug,
     seo
-  } | order(_updatedAt desc)`;n.text="Fetching documents...";let l;try{l=await s.fetch(f);}catch(g){n.fail(`Failed to fetch: ${g.message}`),process.exit(1);}if(n.succeed(`Analysed ${l.length} document(s)`),l.length===0){a.warn("No documents with SEO fields found."),o&&$e(i);return}let u=l.map(g=>({doc:g,health:U(g)}));await kt(u,l,e),o&&$e(i);}async function kt(e,t,o){let n={excellent:0,good:0,fair:0,poor:0,missing:0},s=0;for(let{health:l}of e)n[l.status]=(n[l.status]||0)+1,s+=l.score;let i=Math.round(s/e.length);if(vt(t,i,n),o.format==="summary")return;o.format!=="table"&&(a.info(""),a.warn(`Unknown format "${o.format}", defaulting to table output.`)),It(e);let r={};for(let{health:l}of e)for(let u of l.issues)r[u]=(r[u]||0)+1;let f=Object.entries(r).sort(([,l],[,u])=>u-l).slice(0,10);f.length>0&&jt(f,t.length),a.info("");}function vt(e,t,o){a.heading("\u{1F4CA} Summary"),a.info(""),a.info(`  Total documents:  ${c.bold(String(e.length))}`),a.info(`  Average score:    ${c.bold(Te(t))}%`),a.info(""),a.info(`  ${R.excellent} Excellent (80+):  ${o.excellent}`),a.info(`  ${R.good} Good (60-79):      ${o.good}`),a.info(`  ${R.fair} Fair (40-59):      ${o.fair}`),a.info(`  ${R.poor} Poor (1-39):       ${o.poor}`),a.info(`  ${R.missing} Missing (0):       ${o.missing}`);}var Tt={excellent:"Excellent",good:"Good",fair:"Fair",poor:"Poor",missing:"Missing"},Ct={excellent:c.green,good:c.blue,fair:c.yellow,poor:c.red,missing:c.dim};function Ot(e,t=11){var s,i;let o=((s=Tt[e])!=null?s:e).padEnd(t);return ((i=Ct[e])!=null?i:(r=>r))(o)}function It(e){a.heading("\u{1F4CB} Documents"),a.info("");let t=Math.min(44,Math.max(5,...e.map(({doc:r})=>(r.title||r._id).length))),o=11,n=14,s=5,i=c.dim("\u2500".repeat(s+2+o+2+n+2+t));a.info(`  ${c.dim("Score".padEnd(s))}  ${c.dim("Status".padEnd(o))}  ${c.dim("Type".padEnd(n))}  ${c.dim("Title")}`),a.info(`  ${i}`);for(let{doc:r,health:f}of e){let l=ke(r.title||r._id,t),u=String(f.score).padStart(s),d=Ot(f.status,o),g=c.dim(ke(r._type,n).padEnd(n));a.info(`  ${Te(f.score,u)}  ${d}  ${g}  ${l}`);}}function jt(e,t){a.heading("\u{1F50D} Top Issues"),a.info("");for(let[o,n]of e){let s=Math.round(n/t*100);a.info(`  ${c.red(String(n).padStart(4))} docs (${s}%)  ${o}`);}}function $e(e){a.info(""),a.info(`  ${c.dim("\u2500".repeat(52))}`),a.info(`  ${c.dim("Connection info")}`),a.info(`  ${c.dim("Project ID:")}  ${c.white(e.projectId)}  ${c.dim(`\u2190 ${e.sources.projectId}`)}`),a.info(`  ${c.dim("Dataset:   ")}  ${c.white(e.dataset)}  ${c.dim(`\u2190 ${e.sources.dataset}`)}`),a.info(`  ${c.dim("Token:     ")}  ${c.dim(e.sources.token)}`),a.info("");}function Te(e,t){let o=t!=null?t:String(e);return e>=80?c.green(o):e>=60?c.blue(o):e>=40?c.yellow(o):e>0?c.red(o):c.dim(o)}function ke(e,t){return e.length>t?`${e.slice(0,t-1)}\u2026`:e}H();var oe="1.9.0",Ce=[c.cyan,e=>c.bold(c.blue(e)),c.blue,c.magenta,c.red,c.yellow],x=Ce[Math.floor(Math.random()*Ce.length)],Oe=["Run `seofields doctor` first to verify your setup is correct.","Use `seofields report --format summary` for a quick overview.","Export your SEO data before making bulk changes: `seofields export -o backup.json`.","Add `seoFields` type to every document schema to track SEO health.","A meta title between 50\u201360 characters gets the best click-through rate.","Meta descriptions should be 140\u2013160 characters for optimal display.","Open Graph images should be 1200\xD7630px for best social sharing.","Use `seofields config --baseUrl=https://yoursite.com` to enable canonical URLs.","Twitter Card images require a separate `twitterImage` field for best results.","Schema.org markup helps search engines understand your content structure.","Use `seofields report --types post,page` to filter by document type.","The `healthDashboard` tool gives a live view of SEO scores inside Sanity Studio.","Keywords should appear naturally \u2014 avoid keyword stuffing.","Every page needs a unique meta title. Duplicates hurt rankings.","Use `seofields export --format csv` to open SEO data in a spreadsheet.","Set `noIndex: true`, `noFollow: true`, `noTranslate: true`, or `noImageIndex: true` when a page needs stricter crawler directives.","OG title and meta title can differ \u2014 OG is optimised for social, meta for search.","Run `seofields report` after content migrations to catch regressions.","Use `seofields init --schema-org` to add structured data support.","Structured data (Schema.org) can unlock rich results in Google Search.","A score of 80+ is excellent. Aim to get all key pages there.","The `seoPreview` option shows a live Google-style preview inside the editor.","Use `seofields report` in CI to catch SEO regressions before they ship.","Use `--dataset staging` to run reports against your staging dataset.","Keep your license key private \u2014 never commit it to version control.","Use `seofields config --healthDashboard.showDocumentId=true` for easier debugging.","Use `seofields export --format json --output report.json` to save SEO data to a file.","Alt text on images improves both accessibility and image search ranking.","Canonical URLs prevent duplicate content penalties from search engines.","A missing OG image means social shares show a blank card \u2014 always add one.","Use descriptive slugs: `/blog/seo-tips` ranks better than `/blog/post-123`.","Re-run `seofields report` monthly to track your SEO health over time.","The `types` filter helps you focus reports on high-priority content.","Use `seofields export` to back up SEO data before schema migrations.","Short meta titles (under 30 chars) waste valuable search result space.","Long meta descriptions get truncated \u2014 stay under 160 characters.","Twitter Cards need `twitter:card`, `twitter:title`, and `twitter:image` at minimum.","Use `seofields doctor` after upgrading the plugin to catch breaking changes.","JSON export includes health scores \u2014 pipe it into your analytics pipeline.","Set a `defaultHiddenFields` list to keep the SEO panel focused.","Internal links pass authority \u2014 make sure important pages are well-linked.","Page speed is a ranking factor \u2014 optimise images referenced in SEO fields.","Use consistent brand phrasing in meta titles across your site.","Structured data errors can be tested at schema.org/validator.","Focus first on pages with the most traffic, not just the lowest scores.","Add SEO review to your content publishing checklist.","Use `seofields config --healthDashboard.licenseKey=KEY` to unlock premium features.","The CSV export makes it easy to share SEO audits with non-technical stakeholders.","Every image on your page should have descriptive alt text.","Avoid duplicate meta descriptions \u2014 each page needs its own."];function Et(){return Oe[Math.floor(Math.random()*Oe.length)]}var Rt=62,q=Rt-2;function Ft(e,t){let o=e.split(" "),n=[],s="";for(let i of o)s.length+(s?1:0)+i.length>t?(s&&n.push(s),s=i):s=s?`${s} ${i}`:i;return s&&n.push(s),n}function D(e,t){let o=q-3,n=" ".repeat(Math.max(0,o-t));return ` ${x("\u2502")}  ${e}${n} ${x("\u2502")}`}function P(){return D("",0)}function Ie(){let e="\u2500".repeat(q),t=Et(),o=q-3-5,n=Ft(t,o);console.log(),console.log(` ${x(`\u256D${e}\u256E`)}`),console.log(P()),console.log(D(`${c.bold(c.green("seofields"))}${c.dim(` v${oe}`)}`,`seofields v${oe}`.length)),console.log(D(c.dim("SEO tooling for Sanity CMS \u2014 manage from your terminal"),54)),console.log(P());for(let i=0;i<n.length;i++){let r=i===0?`${c.dim("Tip: ")}${c.white(n[i])}`:`     ${c.white(n[i])}`,f=5+n[i].length;console.log(D(r,f));}console.log(P()),console.log(` ${x(`\u2570${e}\u256F`)}`),console.log(),console.log(`  ${c.bold("Commands")}`),console.log();let s=[["init          ","Add seofields() to sanity.config"],["config        ","Update plugin configuration options"],["create-config ","Create seofields.cli.ts / .js interactively"],["report        ","SEO health report across all documents"],["export        ","Export SEO fields as JSON or CSV"],["doctor        ","Check setup, deps & config"]];for(let[i,r]of s)console.log(`  ${x(i)}  ${c.dim(r)}`);console.log(),console.log(`  ${c.dim("Run ")}${c.white("seofields <command> --help")}${c.dim(" for details")}`),console.log();}function _(e,t){let o="\u2500".repeat(q),n=`seofields \u203A ${e}`;return ["",` ${x(`\u256D${o}\u256E`)}`,P(),D(`${c.bold(c.green("seofields"))}${x(" \u203A ")}${c.bold(x(e))}`,n.length),D(c.dim(t),t.length),P(),` ${x(`\u2570${o}\u256F`)}`].join(`
+  } | order(_updatedAt desc)`;n.text="Fetching documents...";let l;try{l=await s.fetch(f);}catch(g){n.fail(`Failed to fetch: ${g.message}`),process.exit(1);}if(n.succeed(`Analysed ${l.length} document(s)`),l.length===0){a.warn("No documents with SEO fields found."),o&&$e(i);return}let u=l.map(g=>({doc:g,health:U(g)}));await kt(u,l,e),o&&$e(i);}async function kt(e,t,o){let n={excellent:0,good:0,fair:0,poor:0,missing:0},s=0;for(let{health:l}of e)n[l.status]=(n[l.status]||0)+1,s+=l.score;let i=Math.round(s/e.length);if(vt(t,i,n),o.format==="summary")return;o.format!=="table"&&(a.info(""),a.warn(`Unknown format "${o.format}", defaulting to table output.`)),It(e);let r={};for(let{health:l}of e)for(let u of l.issues)r[u]=(r[u]||0)+1;let f=Object.entries(r).sort(([,l],[,u])=>u-l).slice(0,10);f.length>0&&jt(f,t.length),a.info("");}function vt(e,t,o){a.heading("\u{1F4CA} Summary"),a.info(""),a.info(`  Total documents:  ${c.bold(String(e.length))}`),a.info(`  Average score:    ${c.bold(Te(t))}%`),a.info(""),a.info(`  ${R.excellent} Excellent (80+):  ${o.excellent}`),a.info(`  ${R.good} Good (60-79):      ${o.good}`),a.info(`  ${R.fair} Fair (40-59):      ${o.fair}`),a.info(`  ${R.poor} Poor (1-39):       ${o.poor}`),a.info(`  ${R.missing} Missing (0):       ${o.missing}`);}var Tt={excellent:"Excellent",good:"Good",fair:"Fair",poor:"Poor",missing:"Missing"},Ct={excellent:c.green,good:c.blue,fair:c.yellow,poor:c.red,missing:c.dim};function Ot(e,t=11){var s,i;let o=((s=Tt[e])!=null?s:e).padEnd(t);return ((i=Ct[e])!=null?i:(r=>r))(o)}function It(e){a.heading("\u{1F4CB} Documents"),a.info("");let t=Math.min(44,Math.max(5,...e.map(({doc:r})=>(r.title||r._id).length))),o=11,n=14,s=5,i=c.dim("\u2500".repeat(s+2+o+2+n+2+t));a.info(`  ${c.dim("Score".padEnd(s))}  ${c.dim("Status".padEnd(o))}  ${c.dim("Type".padEnd(n))}  ${c.dim("Title")}`),a.info(`  ${i}`);for(let{doc:r,health:f}of e){let l=ke(r.title||r._id,t),u=String(f.score).padStart(s),d=Ot(f.status,o),g=c.dim(ke(r._type,n).padEnd(n));a.info(`  ${Te(f.score,u)}  ${d}  ${g}  ${l}`);}}function jt(e,t){a.heading("\u{1F50D} Top Issues"),a.info("");for(let[o,n]of e){let s=Math.round(n/t*100);a.info(`  ${c.red(String(n).padStart(4))} docs (${s}%)  ${o}`);}}function $e(e){a.info(""),a.info(`  ${c.dim("\u2500".repeat(52))}`),a.info(`  ${c.dim("Connection info")}`),a.info(`  ${c.dim("Project ID:")}  ${c.white(e.projectId)}  ${c.dim(`\u2190 ${e.sources.projectId}`)}`),a.info(`  ${c.dim("Dataset:   ")}  ${c.white(e.dataset)}  ${c.dim(`\u2190 ${e.sources.dataset}`)}`),a.info(`  ${c.dim("Token:     ")}  ${c.dim(e.sources.token)}`),a.info("");}function Te(e,t){let o=t!=null?t:String(e);return e>=80?c.green(o):e>=60?c.blue(o):e>=40?c.yellow(o):e>0?c.red(o):c.dim(o)}function ke(e,t){return e.length>t?`${e.slice(0,t-1)}\u2026`:e}H();var oe="1.10.0",Ce=[c.cyan,e=>c.bold(c.blue(e)),c.blue,c.magenta,c.red,c.yellow],x=Ce[Math.floor(Math.random()*Ce.length)],Oe=["Run `seofields doctor` first to verify your setup is correct.","Use `seofields report --format summary` for a quick overview.","Export your SEO data before making bulk changes: `seofields export -o backup.json`.","Add `seoFields` type to every document schema to track SEO health.","A meta title between 50\u201360 characters gets the best click-through rate.","Meta descriptions should be 140\u2013160 characters for optimal display.","Open Graph images should be 1200\xD7630px for best social sharing.","Use `seofields config --baseUrl=https://yoursite.com` to enable canonical URLs.","Twitter Card images require a separate `twitterImage` field for best results.","Schema.org markup helps search engines understand your content structure.","Use `seofields report --types post,page` to filter by document type.","The `healthDashboard` tool gives a live view of SEO scores inside Sanity Studio.","Keywords should appear naturally \u2014 avoid keyword stuffing.","Every page needs a unique meta title. Duplicates hurt rankings.","Use `seofields export --format csv` to open SEO data in a spreadsheet.","Set `noIndex: true`, `noFollow: true`, `noTranslate: true`, or `noImageIndex: true` when a page needs stricter crawler directives.","OG title and meta title can differ \u2014 OG is optimised for social, meta for search.","Run `seofields report` after content migrations to catch regressions.","Use `seofields init --schema-org` to add structured data support.","Structured data (Schema.org) can unlock rich results in Google Search.","A score of 80+ is excellent. Aim to get all key pages there.","The `seoPreview` option shows a live Google-style preview inside the editor.","Use `seofields report` in CI to catch SEO regressions before they ship.","Use `--dataset staging` to run reports against your staging dataset.","Keep your license key private \u2014 never commit it to version control.","Use `seofields config --healthDashboard.showDocumentId=true` for easier debugging.","Use `seofields export --format json --output report.json` to save SEO data to a file.","Alt text on images improves both accessibility and image search ranking.","Canonical URLs prevent duplicate content penalties from search engines.","A missing OG image means social shares show a blank card \u2014 always add one.","Use descriptive slugs: `/blog/seo-tips` ranks better than `/blog/post-123`.","Re-run `seofields report` monthly to track your SEO health over time.","The `types` filter helps you focus reports on high-priority content.","Use `seofields export` to back up SEO data before schema migrations.","Short meta titles (under 30 chars) waste valuable search result space.","Long meta descriptions get truncated \u2014 stay under 160 characters.","Twitter Cards need `twitter:card`, `twitter:title`, and `twitter:image` at minimum.","Use `seofields doctor` after upgrading the plugin to catch breaking changes.","JSON export includes health scores \u2014 pipe it into your analytics pipeline.","Set a `defaultHiddenFields` list to keep the SEO panel focused.","Internal links pass authority \u2014 make sure important pages are well-linked.","Page speed is a ranking factor \u2014 optimise images referenced in SEO fields.","Use consistent brand phrasing in meta titles across your site.","Structured data errors can be tested at schema.org/validator.","Focus first on pages with the most traffic, not just the lowest scores.","Add SEO review to your content publishing checklist.","Use `seofields config --healthDashboard.licenseKey=KEY` to unlock premium features.","The CSV export makes it easy to share SEO audits with non-technical stakeholders.","Every image on your page should have descriptive alt text.","Avoid duplicate meta descriptions \u2014 each page needs its own."];function Et(){return Oe[Math.floor(Math.random()*Oe.length)]}var Rt=62,q=Rt-2;function Ft(e,t){let o=e.split(" "),n=[],s="";for(let i of o)s.length+(s?1:0)+i.length>t?(s&&n.push(s),s=i):s=s?`${s} ${i}`:i;return s&&n.push(s),n}function D(e,t){let o=q-3,n=" ".repeat(Math.max(0,o-t));return ` ${x("\u2502")}  ${e}${n} ${x("\u2502")}`}function P(){return D("",0)}function Ie(){let e="\u2500".repeat(q),t=Et(),o=q-3-5,n=Ft(t,o);console.log(),console.log(` ${x(`\u256D${e}\u256E`)}`),console.log(P()),console.log(D(`${c.bold(c.green("seofields"))}${c.dim(` v${oe}`)}`,`seofields v${oe}`.length)),console.log(D(c.dim("SEO tooling for Sanity CMS \u2014 manage from your terminal"),54)),console.log(P());for(let i=0;i<n.length;i++){let r=i===0?`${c.dim("Tip: ")}${c.white(n[i])}`:`     ${c.white(n[i])}`,f=5+n[i].length;console.log(D(r,f));}console.log(P()),console.log(` ${x(`\u2570${e}\u256F`)}`),console.log(),console.log(`  ${c.bold("Commands")}`),console.log();let s=[["init          ","Add seofields() to sanity.config"],["config        ","Update plugin configuration options"],["create-config ","Create seofields.cli.ts / .js interactively"],["report        ","SEO health report across all documents"],["export        ","Export SEO fields as JSON or CSV"],["doctor        ","Check setup, deps & config"]];for(let[i,r]of s)console.log(`  ${x(i)}  ${c.dim(r)}`);console.log(),console.log(`  ${c.dim("Run ")}${c.white("seofields <command> --help")}${c.dim(" for details")}`),console.log();}function _(e,t){let o="\u2500".repeat(q),n=`seofields \u203A ${e}`;return ["",` ${x(`\u256D${o}\u256E`)}`,P(),D(`${c.bold(c.green("seofields"))}${x(" \u203A ")}${c.bold(x(e))}`,n.length),D(c.dim(t),t.length),P(),` ${x(`\u2570${o}\u256F`)}`].join(`
 `)}program.name("seofields").description("CLI for sanity-plugin-seofields \u2014 manage SEO from your terminal").version(oe).action(Ie);program.command("config",{isDefault:false}).description("Update seofields() configuration in your sanity.config file").addHelpText("before",_("config","Update seofields() configuration in your sanity.config file")).allowUnknownOption().allowExcessArguments().helpOption("-h, --help","Show help and all available options").addHelpText("after",["",`  ${c.bold("Usage")}`,`  ${c.dim("Pass any option as")} ${c.white("--key=value")}${c.dim(". Nested keys use dot notation.")}`,"",`  ${c.bold("Top-level options")}`,`  ${x("--baseUrl")}${c.dim("=<url>").padEnd(38)}  ${c.dim("Canonical base URL")}`,`  ${x("--seoPreview")}${c.dim("=<bool>").padEnd(36)}  ${c.dim("Enable live Google-style preview")}`,`  ${x("--defaultHiddenFields")}${c.dim("=<f1,f2>").padEnd(28)}  ${c.dim("Comma-separated fields to hide")}`,`  ${x("--types")}${c.dim("=<t1,t2>").padEnd(40)}  ${c.dim("Document types that have SEO fields")}`,"",`  ${c.bold("healthDashboard options")}  ${c.dim("(prefix: --healthDashboard.<key>)")}`,`  ${x("--healthDashboard.licenseKey")}${c.dim("=<key>").padEnd(22)}  ${c.dim("License key for premium features")}`,`  ${x("--healthDashboard.toolTitle")}${c.dim("=<str>").padEnd(23)}  ${c.dim("Custom title shown in Studio")}`,`  ${x("--healthDashboard.showDocumentId")}${c.dim("=<bool>").padEnd(17)}  ${c.dim("Show document _id in dashboard")}`,`  ${x("--healthDashboard.showHealthScore")}${c.dim("=<bool>").padEnd(16)}  ${c.dim("Show score badge per document")}`,`  ${x("--healthDashboard.query.types")}${c.dim("=<t1,t2>").padEnd(21)}  ${c.dim("Filter dashboard by document types")}`,"",`  ${c.bold("Examples")}`,`  ${c.white("seofields config --baseUrl=https://mysite.com")}`,`  ${c.white("seofields config --healthDashboard.licenseKey=SEOF-1234")}`,`  ${c.white("seofields config --healthDashboard.showDocumentId=true --seoPreview=true")}`,`  ${c.white("seofields config --healthDashboard.query.types=post,page")}`,`  ${c.white("seofields config --defaultHiddenFields=metaImage,openGraphUrl")}`,""].join(`
 `)).action(()=>{let e=process.argv.indexOf("config"),t=e>=0?process.argv.slice(e+1):[];ge(t);});program.command("create-config").description("Interactively create a seofields.cli.ts / .js config file").addHelpText("before",_("create-config","Interactively create a seofields.cli.ts / .js config file")).action(me);program.command("init").description("Add seofields() plugin to your sanity.config file").addHelpText("before",_("init","Add seofields() plugin to your sanity.config file")).option("--preview","Enable SEO preview in the plugin config").option("--dashboard","Explicitly enable the SEO Health Dashboard").option("--no-dashboard","Disable the SEO Health Dashboard").option("--schema-org","Also add schemaOrg() plugin registration").addHelpText("after",["",`  ${c.dim("Note: ")}${c.yellow("--preview")}${c.dim(", ")}${c.yellow("--dashboard")}${c.dim(", and ")}${c.yellow("--no-dashboard")}${c.dim(" only apply during initial setup.")}`,`  ${c.dim("      If seofields() is already in your config, use:")}`,"",`  ${c.dim("      ")}${c.white("seofields config --healthDashboard=true --seoPreview=true")}`,""].join(`
 `)).action(xe);program.command("export").description("Export all documents with SEO fields as JSON or CSV").addHelpText("before",_("export","Export all documents with SEO fields as JSON or CSV")).option("-p, --project-id <id>","Sanity project ID").option("-d, --dataset <name>","Sanity dataset name").option("-t, --token <token>","Sanity API token").option("--types <types>","Comma-separated document types to export (e.g. post,page)").option("-f, --format <format>","Output format: json or csv","json").option("-o, --output <path>","Output file path (defaults to stdout)").action(Se);program.command("report").description("Generate an SEO health report for all documents").addHelpText("before",_("report","Generate an SEO health report for all documents")).option("-p, --project-id <id>","Sanity project ID").option("-d, --dataset <name>","Sanity dataset name").option("-t, --token <token>","Sanity API token").option("--types <types>","Comma-separated document types to include").option("--format <format>",'Output format: table or summary (default: "table")',"table").action(ve);program.command("doctor").description("Check plugin configuration, dependencies, and setup").addHelpText("before",_("doctor","Check plugin configuration, dependencies, and setup")).option("--cwd <path>","Working directory to check",process.cwd()).action(he);var E=process.argv.slice(2);E.length===1&&(E[0]==="--help"||E[0]==="-h")&&(Ie(),process.exit(0));if(E.length>=2&&E[E.length-1]==="help"){let e=program.commands.find(t=>t.name()===E[0]);e&&(e.help(),process.exit(0));}program.parse();

package/dist/head.cjs

@@ -3,12 +3,20 @@
 
 
 
-var _chunkFUUWBQE2cjs = require('./chunk-FUUWBQE2.cjs');
+
+
+var _chunkOULUDJPIcjs = require('./chunk-OULUDJPI.cjs');
+
+
+var _chunkXYAZJ3WXcjs = require('./chunk-XYAZJ3WX.cjs');
 require('./chunk-A57XNQC7.cjs');
 
 
 
 
 
-exports.buildSeoHead = _chunkFUUWBQE2cjs.buildSeoHead; exports.buildSeoMeta = _chunkFUUWBQE2cjs.buildSeoMeta; exports.sanitizeOGType = _chunkFUUWBQE2cjs.sanitizeOGType; exports.sanitizeTwitterCard = _chunkFUUWBQE2cjs.sanitizeTwitterCard;
+
+
+
+exports.buildHreflangs = _chunkXYAZJ3WXcjs.buildHreflangs; exports.buildLlmsTxt = _chunkOULUDJPIcjs.buildLlmsTxt; exports.buildSeoHead = _chunkOULUDJPIcjs.buildSeoHead; exports.buildSeoMeta = _chunkOULUDJPIcjs.buildSeoMeta; exports.docsToLlmsSection = _chunkOULUDJPIcjs.docsToLlmsSection; exports.sanitizeOGType = _chunkOULUDJPIcjs.sanitizeOGType; exports.sanitizeTwitterCard = _chunkOULUDJPIcjs.sanitizeTwitterCard;
 //# sourceMappingURL=head.cjs.map

package/dist/head.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["/Users/hardik/GITHUB/sanity-plugin-seofields/npm/dist/head.cjs"],"names":[],"mappings":"AAAA;AACE;AACA;AACA;AACA;AACF,wDAA6B;AAC7B,gCAA6B;AAC7B;AACE;AACA;AACA;AACA;AACF,6OAAC","file":"/Users/hardik/GITHUB/sanity-plugin-seofields/npm/dist/head.cjs"}
+{"version":3,"sources":["/Users/hardik/GITHUB/sanity-plugin-seofields/npm/dist/head.cjs"],"names":[],"mappings":"AAAA;AACE;AACA;AACA;AACA;AACA;AACA;AACF,wDAA6B;AAC7B;AACE;AACF,wDAA6B;AAC7B,gCAA6B;AAC7B;AACE;AACA;AACA;AACA;AACA;AACA;AACA;AACF,gaAAC","file":"/Users/hardik/GITHUB/sanity-plugin-seofields/npm/dist/head.cjs"}

package/dist/head.d.cts

@@ -1,4 +1,5 @@
 import { a as SanityImage, b as SanityImageWithAlt } from './types-DxlPXihz.cjs';
+export { B as BuildHreflangsOptions, H as HreflangLinkEntry, a as HreflangTranslation, b as buildHreflangs } from './hreflang-_VbSuWYD.cjs';
 
 /**
  * Headless CMS integration helpers for sanity-plugin-seofields
@@ -190,6 +191,17 @@ interface BuildSeoMetaOptions {
      * imageUrlResolver: (img) => urlFor(img).width(1200).url()
      */
     imageUrlResolver?: (image: SanityImage | SanityImageWithAlt) => string | null | undefined;
+    /**
+     * Override the hreflang alternates. When provided, this supersedes `seo.hreflangs` — pair it with
+     * `buildHreflangs()` to derive alternates from `@sanity/document-internationalization` translations.
+     *
+     * @example
+     * hreflangs: buildHreflangs(data._translations, { baseUrl })
+     */
+    hreflangs?: Array<{
+        locale?: string | null;
+        url?: string | null;
+    }> | null;
 }
 declare const VALID_OG_TYPES: readonly ["website", "article", "profile", "book", "music", "video", "product"];
 type OGType = (typeof VALID_OG_TYPES)[number];
@@ -251,4 +263,52 @@ declare function buildSeoMeta(options: BuildSeoMetaOptions): SeoMetadata;
  */
 declare function buildSeoHead(options: BuildSeoMetaOptions): SeoHead;
 
-export { type BuildSeoMetaOptions, type SeoFieldsInput, type SeoHead, type SeoHeadLinkTag, type SeoHeadMetaTag, type SeoMetaDefaults, type SeoMetadata, buildSeoHead, buildSeoMeta, sanitizeOGType, sanitizeTwitterCard };
+interface LlmsLink {
+    title: string;
+    url: string;
+    description?: string;
+}
+interface LlmsSection {
+    title: string;
+    links: LlmsLink[];
+}
+interface BuildLlmsTxtOptions {
+    /** H1 title, e.g. the site name. */
+    title: string;
+    /** One-line blockquote summary rendered directly under the title. */
+    summary?: string;
+    /** Free-form Markdown prose rendered after the summary. */
+    details?: string;
+    /** Link sections rendered as `## {title}` + a bullet list. Empty sections are omitted. */
+    sections?: LlmsSection[];
+    /** Optional version, rendered in a leading `> Version: … | Updated: …` line. */
+    version?: string;
+    /** Optional "updated" label, rendered alongside `version`. */
+    updated?: string;
+    /** Prepended to any relative link URL. */
+    baseUrl?: string;
+}
+declare function buildLlmsTxt(options: BuildLlmsTxtOptions): string;
+interface LlmsDoc {
+    title?: string | null;
+    slug?: {
+        current?: string | null;
+    } | string | null;
+    description?: string | null;
+    [key: string]: unknown;
+}
+interface DocsToLlmsSectionOptions {
+    /** Section heading. */
+    title: string;
+    /** Prepended to each document's path. */
+    baseUrl?: string;
+    /** Build the path for a document. Defaults to `/${slug}`. */
+    resolvePath?: (doc: LlmsDoc) => string | null | undefined;
+    /** Override the link title. Defaults to `doc.title`. */
+    resolveTitle?: (doc: LlmsDoc) => string | null | undefined;
+    /** Override the link description. Defaults to `doc.description`. */
+    resolveDescription?: (doc: LlmsDoc) => string | null | undefined;
+}
+declare function docsToLlmsSection(docs: LlmsDoc[] | null | undefined, options: DocsToLlmsSectionOptions): LlmsSection;
+
+export { type BuildLlmsTxtOptions, type BuildSeoMetaOptions, type DocsToLlmsSectionOptions, type LlmsDoc, type LlmsLink, type LlmsSection, type SeoFieldsInput, type SeoHead, type SeoHeadLinkTag, type SeoHeadMetaTag, type SeoMetaDefaults, type SeoMetadata, buildLlmsTxt, buildSeoHead, buildSeoMeta, docsToLlmsSection, sanitizeOGType, sanitizeTwitterCard };

package/dist/head.d.ts

@@ -1,4 +1,5 @@
 import { a as SanityImage, b as SanityImageWithAlt } from './types-DxlPXihz.js';
+export { B as BuildHreflangsOptions, H as HreflangLinkEntry, a as HreflangTranslation, b as buildHreflangs } from './hreflang-_VbSuWYD.js';
 
 /**
  * Headless CMS integration helpers for sanity-plugin-seofields
@@ -190,6 +191,17 @@ interface BuildSeoMetaOptions {
      * imageUrlResolver: (img) => urlFor(img).width(1200).url()
      */
     imageUrlResolver?: (image: SanityImage | SanityImageWithAlt) => string | null | undefined;
+    /**
+     * Override the hreflang alternates. When provided, this supersedes `seo.hreflangs` — pair it with
+     * `buildHreflangs()` to derive alternates from `@sanity/document-internationalization` translations.
+     *
+     * @example
+     * hreflangs: buildHreflangs(data._translations, { baseUrl })
+     */
+    hreflangs?: Array<{
+        locale?: string | null;
+        url?: string | null;
+    }> | null;
 }
 declare const VALID_OG_TYPES: readonly ["website", "article", "profile", "book", "music", "video", "product"];
 type OGType = (typeof VALID_OG_TYPES)[number];
@@ -251,4 +263,52 @@ declare function buildSeoMeta(options: BuildSeoMetaOptions): SeoMetadata;
  */
 declare function buildSeoHead(options: BuildSeoMetaOptions): SeoHead;
 
-export { type BuildSeoMetaOptions, type SeoFieldsInput, type SeoHead, type SeoHeadLinkTag, type SeoHeadMetaTag, type SeoMetaDefaults, type SeoMetadata, buildSeoHead, buildSeoMeta, sanitizeOGType, sanitizeTwitterCard };
+interface LlmsLink {
+    title: string;
+    url: string;
+    description?: string;
+}
+interface LlmsSection {
+    title: string;
+    links: LlmsLink[];
+}
+interface BuildLlmsTxtOptions {
+    /** H1 title, e.g. the site name. */
+    title: string;
+    /** One-line blockquote summary rendered directly under the title. */
+    summary?: string;
+    /** Free-form Markdown prose rendered after the summary. */
+    details?: string;
+    /** Link sections rendered as `## {title}` + a bullet list. Empty sections are omitted. */
+    sections?: LlmsSection[];
+    /** Optional version, rendered in a leading `> Version: … | Updated: …` line. */
+    version?: string;
+    /** Optional "updated" label, rendered alongside `version`. */
+    updated?: string;
+    /** Prepended to any relative link URL. */
+    baseUrl?: string;
+}
+declare function buildLlmsTxt(options: BuildLlmsTxtOptions): string;
+interface LlmsDoc {
+    title?: string | null;
+    slug?: {
+        current?: string | null;
+    } | string | null;
+    description?: string | null;
+    [key: string]: unknown;
+}
+interface DocsToLlmsSectionOptions {
+    /** Section heading. */
+    title: string;
+    /** Prepended to each document's path. */
+    baseUrl?: string;
+    /** Build the path for a document. Defaults to `/${slug}`. */
+    resolvePath?: (doc: LlmsDoc) => string | null | undefined;
+    /** Override the link title. Defaults to `doc.title`. */
+    resolveTitle?: (doc: LlmsDoc) => string | null | undefined;
+    /** Override the link description. Defaults to `doc.description`. */
+    resolveDescription?: (doc: LlmsDoc) => string | null | undefined;
+}
+declare function docsToLlmsSection(docs: LlmsDoc[] | null | undefined, options: DocsToLlmsSectionOptions): LlmsSection;
+
+export { type BuildLlmsTxtOptions, type BuildSeoMetaOptions, type DocsToLlmsSectionOptions, type LlmsDoc, type LlmsLink, type LlmsSection, type SeoFieldsInput, type SeoHead, type SeoHeadLinkTag, type SeoHeadMetaTag, type SeoMetaDefaults, type SeoMetadata, buildLlmsTxt, buildSeoHead, buildSeoMeta, docsToLlmsSection, sanitizeOGType, sanitizeTwitterCard };

package/dist/head.js

@@ -1,13 +1,21 @@
 import {
+  buildLlmsTxt,
   buildSeoHead,
   buildSeoMeta,
+  docsToLlmsSection,
   sanitizeOGType,
   sanitizeTwitterCard
-} from "./chunk-KIEO6QG3.js";
+} from "./chunk-XD4HKLEA.js";
+import {
+  buildHreflangs
+} from "./chunk-CRCXC45D.js";
 import "./chunk-7N4MLTMR.js";
 export {
+  buildHreflangs,
+  buildLlmsTxt,
   buildSeoHead,
   buildSeoMeta,
+  docsToLlmsSection,
   sanitizeOGType,
   sanitizeTwitterCard
 };

package/dist/hreflang-_VbSuWYD.d.cts

@@ -0,0 +1,29 @@
+interface HreflangTranslation {
+    /** BCP 47 language/region tag, e.g. "en", "fr-FR". */
+    language?: string | null;
+    /** Sanity slug — either the raw string or the `{ current }` object. */
+    slug?: {
+        current?: string | null;
+    } | string | null;
+    /** Pre-built path (e.g. "/fr/about"). Wins over `slug`. */
+    path?: string | null;
+    /** Absolute URL. Wins over `baseUrl` + path. */
+    url?: string | null;
+}
+interface BuildHreflangsOptions {
+    /** Site origin, e.g. "https://example.com". Prepended to each translation's path. */
+    baseUrl?: string;
+    /** Build the path for a translation. Defaults to `/${slug}`. Return null/undefined to skip. */
+    resolvePath?: (t: HreflangTranslation) => string | null | undefined;
+    /** Language tag to also emit as an `x-default` entry (pointing at that language's URL). */
+    xDefault?: string;
+    /** Include the current document itself in the set. */
+    current?: HreflangTranslation;
+}
+interface HreflangLinkEntry {
+    locale: string;
+    url: string;
+}
+declare function buildHreflangs(translations: HreflangTranslation[] | null | undefined, options?: BuildHreflangsOptions): HreflangLinkEntry[];
+
+export { type BuildHreflangsOptions as B, type HreflangLinkEntry as H, type HreflangTranslation as a, buildHreflangs as b };

package/dist/hreflang-_VbSuWYD.d.ts

@@ -0,0 +1,29 @@
+interface HreflangTranslation {
+    /** BCP 47 language/region tag, e.g. "en", "fr-FR". */
+    language?: string | null;
+    /** Sanity slug — either the raw string or the `{ current }` object. */
+    slug?: {
+        current?: string | null;
+    } | string | null;
+    /** Pre-built path (e.g. "/fr/about"). Wins over `slug`. */
+    path?: string | null;
+    /** Absolute URL. Wins over `baseUrl` + path. */
+    url?: string | null;
+}
+interface BuildHreflangsOptions {
+    /** Site origin, e.g. "https://example.com". Prepended to each translation's path. */
+    baseUrl?: string;
+    /** Build the path for a translation. Defaults to `/${slug}`. Return null/undefined to skip. */
+    resolvePath?: (t: HreflangTranslation) => string | null | undefined;
+    /** Language tag to also emit as an `x-default` entry (pointing at that language's URL). */
+    xDefault?: string;
+    /** Include the current document itself in the set. */
+    current?: HreflangTranslation;
+}
+interface HreflangLinkEntry {
+    locale: string;
+    url: string;
+}
+declare function buildHreflangs(translations: HreflangTranslation[] | null | undefined, options?: BuildHreflangsOptions): HreflangLinkEntry[];
+
+export { type BuildHreflangsOptions as B, type HreflangLinkEntry as H, type HreflangTranslation as a, buildHreflangs as b };

package/dist/index.cjs

@@ -1,8 +1,11 @@
 "use strict";Object.defineProperty(exports, "__esModule", {value: true}); function _interopRequireWildcard(obj) { if (obj && obj.__esModule) { return obj; } else { var newObj = {}; if (obj != null) { for (var key in obj) { if (Object.prototype.hasOwnProperty.call(obj, key)) { newObj[key] = obj[key]; } } } newObj.default = obj; return newObj; } }
 
+var _chunkXYAZJ3WXcjs = require('./chunk-XYAZJ3WX.cjs');
 
 
-var _chunk3OK3S2F7cjs = require('./chunk-3OK3S2F7.cjs');
+
+
+var _chunkEUG4MNRCcjs = require('./chunk-EUG4MNRC.cjs');
 
 
 
@@ -465,11 +468,11 @@ function SeoGenButton({
       let result;
       if (ai.testMode) {
         await new Promise((r) => setTimeout(r, 400));
-        result = _chunk3OK3S2F7cjs.pickTestOutput.call(void 0, field);
+        result = _chunkEUG4MNRCcjs.pickTestOutput.call(void 0, field);
       } else {
         const controller = new AbortController();
         abortRef.current = controller;
-        result = await _chunk3OK3S2F7cjs.generateSeoText.call(void 0, field, content, focusKeyword, keywords, {
+        result = await _chunkEUG4MNRCcjs.generateSeoText.call(void 0, field, content, focusKeyword, keywords, {
           config: _chunkA57XNQC7cjs.__spreadProps.call(void 0, _chunkA57XNQC7cjs.__spreadValues.call(void 0, {}, ai), { _projectId: workspace.projectId }),
           signal: controller.signal,
           meta
@@ -611,6 +614,87 @@ var FocusKeywordInput = (props) => {
 };
 var FocusKeywordInput_default = FocusKeywordInput;
 
+// src/components/meta/HreflangInput.tsx
+
+
+
+
+
+var DEFAULT_LOCALE_FIELD = "language";
+var DEFAULT_API_VERSION = "2024-01-01";
+function safeField(name) {
+  return name && /^[A-Za-z_][A-Za-z0-9_]*$/.test(name) ? name : DEFAULT_LOCALE_FIELD;
+}
+var HreflangInput = (props) => {
+  const { schemaType, onChange, renderDefault } = props;
+  const { options } = schemaType;
+  const { hreflang, baseUrl, apiVersion } = options != null ? options : {};
+  const rootDoc = _sanity.useFormValue.call(void 0, []);
+  const client = _sanity.useClient.call(void 0, { apiVersion: apiVersion != null ? apiVersion : DEFAULT_API_VERSION });
+  const [state, setState] = _react.useState.call(void 0, "idle");
+  const [message, setMessage] = _react.useState.call(void 0, null);
+  const localeField = safeField(hreflang == null ? void 0 : hreflang.localeField);
+  const handleSync = _react.useCallback.call(void 0, async () => {
+    var _a;
+    const rawId = rootDoc == null ? void 0 : rootDoc._id;
+    if (!rawId) {
+      setState("error");
+      setMessage("Save the document once before syncing translations.");
+      return;
+    }
+    setState("loading");
+    setMessage(null);
+    try {
+      const publishedId = rawId.replace(/^drafts\./, "");
+      const query = `*[_type == "translation.metadata" && references($id)][0].translations[].value->{
+        "language": ${localeField},
+        "slug": slug.current
+      }`;
+      const translations = (_a = await client.fetch(query, { id: publishedId })) != null ? _a : [];
+      const entries = _chunkXYAZJ3WXcjs.buildHreflangs.call(void 0, translations, {
+        baseUrl,
+        resolvePath: hreflang == null ? void 0 : hreflang.resolvePath
+      });
+      if (entries.length === 0) {
+        setState("error");
+        setMessage("No translations with a resolvable URL were found for this document.");
+        return;
+      }
+      const items = entries.map((e) => ({
+        _type: "hreflangEntry",
+        _key: e.locale,
+        locale: e.locale,
+        url: e.url
+      }));
+      onChange(_sanity.PatchEvent.from(_sanity.set.call(void 0, items)));
+      setState("done");
+      setMessage(
+        `Synced ${items.length} alternate${items.length === 1 ? "" : "s"} from translations.`
+      );
+    } catch (err) {
+      setState("error");
+      setMessage(err instanceof Error ? err.message : "Failed to sync translations.");
+    }
+  }, [rootDoc == null ? void 0 : rootDoc._id, client, localeField, baseUrl, hreflang, onChange]);
+  return /* @__PURE__ */ _jsxruntime.jsxs.call(void 0, _ui.Stack, { space: 3, children: [
+    /* @__PURE__ */ _jsxruntime.jsx.call(void 0, _ui.Flex, { children: /* @__PURE__ */ _jsxruntime.jsx.call(void 0, 
+      _ui.Button,
+      {
+        mode: "ghost",
+        tone: "primary",
+        fontSize: 1,
+        icon: _icons.TranslateIcon,
+        text: state === "loading" ? "Syncing\u2026" : "Sync from translations",
+        onClick: handleSync,
+        disabled: state === "loading"
+      }
+    ) }),
+    message && /* @__PURE__ */ _jsxruntime.jsx.call(void 0, _ui.Card, { padding: 2, radius: 2, tone: state === "error" ? "critical" : "positive", children: /* @__PURE__ */ _jsxruntime.jsx.call(void 0, _ui.Text, { size: 1, children: message }) }),
+    renderDefault(props)
+  ] });
+};
+var HreflangInput_default = HreflangInput;
+
 // src/components/meta/KeywordsInput.tsx
 
 
@@ -651,9 +735,9 @@ function KeywordSuggestions({
       let csv;
       if (ai.testMode) {
         await new Promise((r) => setTimeout(r, 400));
-        csv = _chunk3OK3S2F7cjs.pickTestOutput.call(void 0, "keywords");
+        csv = _chunkEUG4MNRCcjs.pickTestOutput.call(void 0, "keywords");
       } else {
-        csv = await _chunk3OK3S2F7cjs.generateSeoText.call(void 0, "keywords", content, focusKeyword, existing, {
+        csv = await _chunkEUG4MNRCcjs.generateSeoText.call(void 0, "keywords", content, focusKeyword, existing, {
           config: _chunkA57XNQC7cjs.__spreadProps.call(void 0, _chunkA57XNQC7cjs.__spreadValues.call(void 0, {}, ai), { _projectId: workspace.projectId }),
           signal: abortRef.current.signal
         });
@@ -852,7 +936,7 @@ var MetaDescription = (props) => {
     () => _chunkY46ACXM4cjs.getMetaDescriptionValidationMessages.call(void 0, value || "", keywords, isParentseoField),
     [value, keywords, isParentseoField]
   );
-  const readability = _react.useMemo.call(void 0, () => _chunk3OK3S2F7cjs.analyzeReadability.call(void 0, value || ""), [value]);
+  const readability = _react.useMemo.call(void 0, () => _chunkEUG4MNRCcjs.analyzeReadability.call(void 0, value || ""), [value]);
   return /* @__PURE__ */ _jsxruntime.jsxs.call(void 0, _ui.Stack, { space: 3, children: [
     renderDefault(props),
     /* @__PURE__ */ _jsxruntime.jsx.call(void 0, 
@@ -2023,6 +2107,7 @@ function buildMetaTagsPreviewField(config, fieldGroupMap) {
   ];
 }
 function seoFieldsSchema(config = {}) {
+  var _a;
   const groupsCfg = config.fieldGroups;
   const fieldGroupMap = (groupsCfg == null ? void 0 : groupsCfg.length) ? buildFieldGroupMap(groupsCfg) : void 0;
   const sanityGroups = (groupsCfg == null ? void 0 : groupsCfg.length) ? toSanityGroups(groupsCfg) : void 0;
@@ -2147,12 +2232,20 @@ function seoFieldsSchema(config = {}) {
         fieldGroupMap
       ),
       withGroup(
-        _sanity.defineField.call(void 0, _chunkA57XNQC7cjs.__spreadProps.call(void 0, _chunkA57XNQC7cjs.__spreadValues.call(void 0, {
+        _sanity.defineField.call(void 0, _chunkA57XNQC7cjs.__spreadProps.call(void 0, _chunkA57XNQC7cjs.__spreadValues.call(void 0, _chunkA57XNQC7cjs.__spreadProps.call(void 0, _chunkA57XNQC7cjs.__spreadValues.call(void 0, {
           name: "hreflangs"
         }, getFieldInfo("hreflangs", config.fieldOverrides)), {
           type: "array",
           of: [{ type: "hreflangEntry" }],
-          description: "Add alternate language/region versions. Include x-default for the fallback URL.",
+          description: "Add alternate language/region versions. Include x-default for the fallback URL."
+        }), ((_a = config.hreflang) == null ? void 0 : _a.autoFill) ? {
+          components: { input: HreflangInput_default },
+          options: {
+            hreflang: config.hreflang,
+            baseUrl: config.baseUrl,
+            apiVersion: config.apiVersion
+          }
+        } : {}), {
           hidden: getFieldHiddenFunction("hreflangs", config)
         })),
         fieldGroupMap