@asymmetric-effort/specifyjs 0.1.0 → 0.1.3

package/dist/specifyjs-build.cjs.js

@@ -0,0 +1,2 @@
+"use strict";var s=require("fs"),e=require("path");exports.specifyJsSeoPlugin=function(t){return{name:"specifyjs-seo",closeBundle(){const i=e.resolve(process.cwd(),"dist"),o=(new Date).toISOString().split("T")[0]??"",n=[...t.routes??["/"]],r=[];if(t.docsDir&&s.existsSync(t.docsDir)){!function(t,i){const o=[{dir:t,prefix:""}];for(;o.length>0;){const{dir:t,prefix:n}=o.pop(),r=s.readdirSync(t,{withFileTypes:!0});for(const s of r)s.isDirectory()?o.push({dir:e.join(t,s.name),prefix:n+s.name+"/"}):s.name.endsWith(".md")&&i.push(n+s.name.replace(".md",""))}}(t.docsDir,r);for(const s of r)n.push(`/#/docs/${s}`)}const p=function(s,e,t){return['<?xml version="1.0" encoding="UTF-8"?>','<urlset xmlns="http://www.sitemaps.org/schemas/sitemap/0.9">',...e.map(e=>`  <url><loc>${s}${e}</loc><lastmod>${t}</lastmod></url>`),"</urlset>"].join("\n")}(t.siteUrl,n,o);s.writeFileSync(e.join(i,"sitemap.xml"),p);const c=function(s,e){const t=["User-agent: *","Allow: /"];return e&&t.push(...e),t.push("",`Sitemap: ${s}/sitemap.xml`),t.join("\n")}(t.siteUrl,t.robotsRules);s.writeFileSync(e.join(i,"robots.txt"),c);const l=function(s,e){const t=[`# ${s.title??"Site"}`];if(s.description){t.push("");const e=s.description.split("\n");for(const s of e)t.push(`> ${s}`)}t.push(""),t.push(`## Website: ${s.siteUrl}`),s.repository&&t.push(`## Repository: ${s.repository}`),s.npmPackage&&t.push(`## npm: https://www.npmjs.com/package/${s.npmPackage}`);const i=e.filter(s=>s.startsWith("guides/")).map(s=>s.replace("guides/","")),o=e.filter(s=>s.startsWith("api/")).map(s=>s.replace("api/",""));if(i.length>0){t.push("","## Documentation","");for(const e of i)t.push(`- ${e}: ${s.siteUrl}/#/docs/guides/${e}`)}if(o.length>0){t.push("","## API Reference","");for(const e of o)t.push(`- ${e}: ${s.siteUrl}/#/docs/api/${e}`)}return s.npmPackage&&t.push("","## Install","","```",`npm install ${s.npmPackage}`,"```"),s.license&&t.push("",`## License: ${s.license}`),s.author&&t.push(`## Author: ${s.author}`),t.join("\n")}(t,r);s.writeFileSync(e.join(i,"llms.txt"),l),console.log(`Generated: sitemap.xml (${n.length} URLs), robots.txt, llms.txt`)}}};
+//# sourceMappingURL=specifyjs-build.cjs.js.map

package/dist/specifyjs-build.cjs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"specifyjs-build.cjs.js","sources":["../../src/build/seo-plugin.ts"],"sourcesContent":[null],"names":["config","name","closeBundle","distDir","path","resolve","process","cwd","today","Date","toISOString","split","routes","docPaths","docsDir","fs","existsSync","rootDir","results","stack","dir","prefix","length","pop","entries","readdirSync","withFileTypes","entry","isDirectory","push","join","endsWith","replace","walkDocs","dp","sitemap","siteUrl","map","r","generateSitemap","writeFileSync","robots","extraRules","lines","generateRobots","robotsRules","llmsTxt","title","description","descLines","dl","repository","npmPackage","guideNames","filter","p","startsWith","apiNames","g","a","license","author","generateLlmsTxt","console","log"],"mappings":"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"}

package/dist/specifyjs-build.d.ts

@@ -0,0 +1,43 @@
+import { Plugin } from 'vite';
+
+/**
+ * SpecifyJS SEO Plugin for Vite
+ * Auto-generates sitemap.xml, robots.txt, and llms.txt at build time.
+ *
+ * Usage in vite.config.ts:
+ *   import { specifyJsSeoPlugin } from '@asymmetric-effort/specifyjs/build';
+ *   export default defineConfig({ plugins: [specifyJsSeoPlugin({ ... })] });
+ */
+
+interface SeoPluginConfig {
+    /** Base URL of the site (e.g., 'https://example.com') */
+    siteUrl: string;
+    /** Site title for llms.txt */
+    title?: string;
+    /** Site description for llms.txt */
+    description?: string;
+    /** Hash-based routes to include in sitemap */
+    routes?: string[];
+    /** Path to docs directory (generates doc routes in sitemap) */
+    docsDir?: string;
+    /** npm package name for llms.txt install instructions */
+    npmPackage?: string;
+    /** Author name for llms.txt */
+    author?: string;
+    /** License for llms.txt */
+    license?: string;
+    /** Additional robots.txt rules */
+    robotsRules?: string[];
+    /** Repository URL for llms.txt */
+    repository?: string;
+}
+/**
+ * Create the SpecifyJS SEO Vite plugin.
+ *
+ * Generates sitemap.xml, robots.txt, and llms.txt in the build output directory
+ * during the closeBundle hook.
+ */
+declare function specifyJsSeoPlugin(config: SeoPluginConfig): Plugin;
+
+export { specifyJsSeoPlugin };
+export type { SeoPluginConfig };

package/dist/specifyjs-build.esm.js

@@ -0,0 +1,2 @@
+import s from"fs";import t from"path";function e(e){return{name:"specifyjs-seo",closeBundle(){const o=t.resolve(process.cwd(),"dist"),i=(new Date).toISOString().split("T")[0]??"",n=[...e.routes??["/"]],r=[];if(e.docsDir&&s.existsSync(e.docsDir)){!function(e,o){const i=[{dir:e,prefix:""}];for(;i.length>0;){const{dir:e,prefix:n}=i.pop(),r=s.readdirSync(e,{withFileTypes:!0});for(const s of r)s.isDirectory()?i.push({dir:t.join(e,s.name),prefix:n+s.name+"/"}):s.name.endsWith(".md")&&o.push(n+s.name.replace(".md",""))}}(e.docsDir,r);for(const s of r)n.push(`/#/docs/${s}`)}const p=function(s,t,e){return['<?xml version="1.0" encoding="UTF-8"?>','<urlset xmlns="http://www.sitemaps.org/schemas/sitemap/0.9">',...t.map(t=>`  <url><loc>${s}${t}</loc><lastmod>${e}</lastmod></url>`),"</urlset>"].join("\n")}(e.siteUrl,n,i);s.writeFileSync(t.join(o,"sitemap.xml"),p);const c=function(s,t){const e=["User-agent: *","Allow: /"];return t&&e.push(...t),e.push("",`Sitemap: ${s}/sitemap.xml`),e.join("\n")}(e.siteUrl,e.robotsRules);s.writeFileSync(t.join(o,"robots.txt"),c);const l=function(s,t){const e=[`# ${s.title??"Site"}`];if(s.description){e.push("");const t=s.description.split("\n");for(const s of t)e.push(`> ${s}`)}e.push(""),e.push(`## Website: ${s.siteUrl}`),s.repository&&e.push(`## Repository: ${s.repository}`),s.npmPackage&&e.push(`## npm: https://www.npmjs.com/package/${s.npmPackage}`);const o=t.filter(s=>s.startsWith("guides/")).map(s=>s.replace("guides/","")),i=t.filter(s=>s.startsWith("api/")).map(s=>s.replace("api/",""));if(o.length>0){e.push("","## Documentation","");for(const t of o)e.push(`- ${t}: ${s.siteUrl}/#/docs/guides/${t}`)}if(i.length>0){e.push("","## API Reference","");for(const t of i)e.push(`- ${t}: ${s.siteUrl}/#/docs/api/${t}`)}return s.npmPackage&&e.push("","## Install","","```",`npm install ${s.npmPackage}`,"```"),s.license&&e.push("",`## License: ${s.license}`),s.author&&e.push(`## Author: ${s.author}`),e.join("\n")}(e,r);s.writeFileSync(t.join(o,"llms.txt"),l),console.log(`Generated: sitemap.xml (${n.length} URLs), robots.txt, llms.txt`)}}}export{e as specifyJsSeoPlugin};
+//# sourceMappingURL=specifyjs-build.esm.js.map

package/dist/specifyjs-build.esm.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"specifyjs-build.esm.js","sources":["../../src/build/seo-plugin.ts"],"sourcesContent":[null],"names":["specifyJsSeoPlugin","config","name","closeBundle","distDir","path","resolve","process","cwd","today","Date","toISOString","split","routes","docPaths","docsDir","fs","existsSync","rootDir","results","stack","dir","prefix","length","pop","entries","readdirSync","withFileTypes","entry","isDirectory","push","join","endsWith","replace","walkDocs","dp","sitemap","siteUrl","map","r","generateSitemap","writeFileSync","robots","extraRules","lines","generateRobots","robotsRules","llmsTxt","title","description","descLines","dl","repository","npmPackage","guideNames","filter","p","startsWith","apiNames","g","a","license","author","generateLlmsTxt","console","log"],"mappings":"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"}