@stacksjs/bunpress 0.0.5 → 0.1.0

package/dist/highlighter.d.ts

@@ -0,0 +1,37 @@
+/**
+ * Reset the global highlighter instance (useful when changing themes)
+ */
+export declare function resetHighlighter(): void;
+/**
+ * Normalizes a language identifier
+ */
+export declare function normalizeLanguage(lang: string): string;
+/**
+ * Checks if a language is supported by ts-syntax-highlighter
+ */
+export declare function isLanguageSupported(lang: string): boolean;
+/**
+ * Highlights code using ts-syntax-highlighter (async)
+ * IMPORTANT: Preserves original code structure and whitespace
+ */
+export declare function highlightCode(code: string, language: string, theme?: string): Promise<string>;
+/**
+ * Synchronous version of highlightCode
+ * Note: ts-syntax-highlighter doesn't have a sync API, so this uses a different approach
+ * For better performance, use the async version
+ */
+export declare function highlightCodeSync(code: string, language: string): string;
+/**
+ * Gets the CSS styles for syntax highlighting
+ * Note: ts-syntax-highlighter includes its own theme CSS
+ */
+export declare function getSyntaxHighlightingStyles(): string;
+/**
+ * Pre-warms the highlighter by creating the instance early
+ * Call this during application initialization for better performance
+ */
+export declare function prewarmHighlighter(): Promise<void>;
+/**
+ * Gets the highlighter instance for advanced usage
+ */
+export declare function getHighlighterInstance(): Promise<TSHighlighter>;

package/dist/index.d.ts

@@ -1,3 +1,5 @@
 export * from './config';
+export * from './highlighter';
+export * from './serve';
 export * from './toc';
 export * from './types';

package/dist/serve.d.ts

@@ -0,0 +1,20 @@
+import { config } from './config';
+import type { BunPressConfig } from './types';
+/**
+ * Start the BunPress documentation server
+ */
+export declare function startServer(options?: {
+  port?: number
+  root?: string
+  watch?: boolean
+  config?: BunPressConfig
+}): Promise<{ server: any, url: string, stop: () => void }>;
+/**
+ * CLI-friendly server start function with graceful shutdown
+ */
+export declare function serveCLI(options?: {
+  port?: number
+  root?: string
+  watch?: boolean
+  config?: BunPressConfig
+}): Promise<void>;

package/dist/src/index.js

@@ -1,243 +1,2 @@
 // @bun
-import{a as f,b as r,c as h}from"../chunk-z2xpw4s7.js";var O={enabled:!0,position:["sidebar"],title:"Table of Contents",maxDepth:6,minDepth:2,className:"table-of-contents",smoothScroll:!0,activeHighlight:!0,collapsible:!0,exclude:[]};function q(A){return A.toLowerCase().trim().replace(/<[^>]*>/g,"").replace(/what's new\?\s*\(v2\.0\)/g,"whats-new-v2-0").replace(/features\s*&\s*benefits/g,"features-benefits").replace(/vue\.js\s*\+\s*typescript\s*=\s*\u2764\uFE0F/g,"vue-js-typescript").replace(/\./g,"-").replace(/[^\w\s-]/g,"").replace(/[\s_]+/g,"-").replace(/-+/g,"-").replace(/^-+|-+$/g,"")}function _(A,z){let j=q(A),B=j,E=1;while(z.has(j))j=`${B}-${E}`,E++;return z.add(j),j}function I(A){let z=[],j=new Set,B=/^(#{1,6})\s+(.+)$/gm,E;while((E=B.exec(A))!==null){let K=E[1].length,Q=E[2].trim();if(!Q)continue;if(Q.includes("toc-ignore"))continue;let P=Q.replace(/\s*<!-- toc-ignore -->\s*/g,"").trim();P=P.replace(/`([^`]+)`/g,"<code>$1</code>");let M=P.includes("<code>"),W=_(P.replace(/<[^>]*>/g,""),j);z.push({level:K,text:P,id:W,children:[],hasCode:M})}return z}function L(A){let z=[],j=[];for(let B of A){while(j.length>0&&j[j.length-1].level>=B.level)j.pop();if(j.length===0)z.push(B);else j[j.length-1].children.push(B);j.push(B)}return z}function U(A,z){let{minDepth:j=2,maxDepth:B=6,exclude:E=[]}=z,K=(Q)=>{let P=[];for(let M of Q){if(E.some((X)=>{if(X.startsWith("/")&&X.endsWith("/"))return new RegExp(X.slice(1,-1)).test(M.text);else return M.text===X}))continue;if(M.level>B)continue;let W=K(M.children);if(M.level>=j&&M.level<=B)P.push({...M,children:W});else P.push(...W)}return P};return K(A)}function Y(A){let{items:z,title:j,config:B}=A,{className:E,collapsible:K}=B,Q=(P,M=0)=>{if(P.length===0)return"";let W=M===0?"toc-list":"toc-sublist",X=M===0?"toc-item":"toc-subitem";return`<ul class="${W}">
-${P.map((V)=>{let Z=V.children.length>0,w=Z&&K?"toc-expand":"",F=Z?Q(V.children,M+1):"",k=50,G=V.text.length>50?`${V.text.substring(0,50)}...`:V.text,J=V.text.length>50?"toc-truncate":"",N=V.hasCode?"toc-code":"";return`<li class="${X} ${w} ${J} ${N}">
-<a href="#${V.id}" class="toc-link" title="${V.text.replace(/<[^>]*>/g,"")}">${G}</a>
-${F}
-</li>`}).join(`
-`)}
-</ul>`};return`<nav class="${E}" role="navigation" aria-label="${j}">
-<div class="toc-container">
-  <h2 class="toc-title">${j}</h2>
-  ${Q(z)}
-</div>
-</nav>`}function $(A){return Y(A).replace("table-of-contents","table-of-contents toc-inline inline-toc")}function b(A){return Y(A).replace("table-of-contents","table-of-contents toc-sidebar sidebar-toc")}function R(A){return Y(A).replace("table-of-contents","table-of-contents toc-floating floating-toc")}function y(A,z={}){let j={...z};if(typeof j.position==="string")j.position=[j.position];let B={...O,...j},E=I(A),K=L(E),Q=U(K,B);return{title:B.title,items:Q,config:B}}function D(A,z={}){let j=y(A,z);return(Array.isArray(z.position)?z.position:[z.position||"sidebar"]).map((E)=>{let K;switch(E){case"inline":K=$(j);break;case"sidebar":K=b(j);break;case"floating":K=R(j);break;default:K=Y(j)}return{position:E,data:j,html:K}})}function S(A,z){let j=$(z);return A.replace(/\[\[toc\]\]/gi,j)}function H(A){let z=new Set;return A.replace(/<h([1-6])>(.*?)<\/h[1-6]>/gi,(j,B,E)=>{let K=_(E.replace(/<[^>]*>/g,""),z);return`<h${B} id="${K}"><a href="#${K}" class="heading-anchor">#</a>${E}</h${B}>`})}function v(){return`
-.table-of-contents {
-  position: sticky;
-  top: 60px; /* Match navbar height */
-  height: calc(100vh - 60px);
-  width: 200px;
-  overflow-y: auto;
-  padding: 1rem;
-}
-
-.toc-container {
-  padding: 0;
-}
-
-.toc-title {
-  margin: 0 0 1rem 0;
-  font-size: 1.2rem;
-  font-weight: 600;
-}
-
-.toc-list,
-.toc-sublist {
-  list-style: none;
-  padding: 0;
-  margin: 0;
-}
-
-.toc-list {
-  padding-left: 0;
-}
-
-.toc-sublist {
-  padding-left: 1rem;
-  margin-top: 0.5rem;
-}
-
-.toc-item,
-.toc-subitem {
-  margin-bottom: 0.5rem;
-}
-
-.toc-link {
-  color: inherit;
-  text-decoration: none;
-  display: block;
-  padding: 0.25rem 0;
-  border-radius: 0.25rem;
-  transition: background-color 0.2s;
-}
-
-.toc-link:hover {
-  background-color: rgba(0, 0, 0, 0.05);
-}
-
-.toc-active .toc-link,
-.active-toc-item .toc-link {
-  background-color: rgba(0, 123, 255, 0.1);
-  font-weight: 500;
-}
-
-.toc-truncate {
-  /* Styles for truncated TOC items */
-}
-
-.toc-truncate .toc-link {
-  white-space: nowrap;
-  overflow: hidden;
-  text-overflow: ellipsis;
-}
-
-.toc-collapse .toc-link::before {
-  content: '\u25B6';
-  margin-right: 0.5rem;
-  transition: transform 0.2s;
-}
-
-.toc-collapse.collapsed .toc-link::before {
-  transform: rotate(90deg);
-}
-
-.toc-expand .toc-link::before {
-  content: '\u25BC';
-  margin-right: 0.5rem;
-}
-
-.heading-anchor {
-  color: inherit;
-  text-decoration: none;
-  opacity: 0;
-  margin-left: -1rem;
-  padding-right: 0.5rem;
-  transition: opacity 0.2s;
-}
-
-h1:hover .heading-anchor,
-h2:hover .heading-anchor,
-h3:hover .heading-anchor,
-h4:hover .heading-anchor,
-h5:hover .heading-anchor,
-h6:hover .heading-anchor {
-  opacity: 0.7;
-}
-
-.heading-anchor:hover {
-  opacity: 1;
-}
-
-/* Smooth scrolling */
-html {
-  scroll-behavior: smooth;
-}
-
-/* Responsive adjustments */
-@media (max-width: 768px) {
-  .toc-sidebar {
-    display: none;
-  }
-
-  .toc-floating {
-    position: fixed;
-    bottom: 1rem;
-    right: 1rem;
-    background: white;
-    border: 1px solid #ddd;
-    border-radius: 0.5rem;
-    padding: 1rem;
-    box-shadow: 0 4px 6px rgba(0, 0, 0, 0.1);
-    max-width: 250px;
-  }
-}
-`}function T(){return`
-function initToc() {
-  const tocLinks = document.querySelectorAll('.toc-link')
-
-  // Smooth scrolling for TOC links
-  tocLinks.forEach(link => {
-    link.addEventListener('click', function(e) {
-      e.preventDefault()
-      const targetId = this.getAttribute('href')?.substring(1)
-      const targetElement = document.getElementById(targetId)
-
-      if (targetElement) {
-        targetElement.scrollIntoView({
-          behavior: 'smooth',
-          block: 'start'
-        })
-
-        // Update URL without page reload
-        history.pushState(null, '', '#' + targetId)
-      }
-    })
-  })
-
-  // Active TOC item highlighting on scroll
-  function updateActiveTocItem() {
-    const headings = document.querySelectorAll('h1, h2, h3, h4, h5, h6')
-    const tocLinks = document.querySelectorAll('.toc-link')
-
-    let currentActive = null
-    let currentDistance = Infinity
-
-    headings.forEach((heading, index) => {
-      const rect = heading.getBoundingClientRect()
-      const distance = Math.abs(rect.top)
-
-      if (distance < currentDistance && rect.top <= 100) {
-        currentActive = heading.id
-        currentDistance = distance
-      }
-    })
-
-    tocLinks.forEach(link => {
-      const parent = link.parentElement
-      if (parent) {
-        parent.classList.remove('toc-active', 'active-toc-item')
-        const href = link.getAttribute('href')?.substring(1)
-        if (href === currentActive) {
-          parent.classList.add('toc-active', 'active-toc-item')
-        }
-      }
-    })
-  }
-
-  // Throttle scroll events
-  let scrollTimeout
-  function throttledUpdate() {
-    if (!scrollTimeout) {
-      scrollTimeout = setTimeout(() => {
-        updateActiveTocItem()
-        scrollTimeout = null
-      }, 100)
-    }
-  }
-
-  window.addEventListener('scroll', throttledUpdate)
-  updateActiveTocItem()
-
-  // TOC collapse/expand functionality
-  const expandableItems = document.querySelectorAll('.toc-expand')
-
-  expandableItems.forEach(item => {
-    item.addEventListener('click', function(e) {
-      if (e.target === this || e.target.closest('.toc-link')) {
-        this.classList.toggle('collapsed')
-      }
-    })
-  })
-
-  // Handle URL hash on page load
-  if (window.location.hash) {
-    const targetId = window.location.hash.substring(1)
-    const targetElement = document.getElementById(targetId)
-
-    if (targetElement) {
-      setTimeout(() => {
-        targetElement.scrollIntoView({
-          behavior: 'smooth',
-          block: 'start'
-        })
-      }, 100)
-    }
-  }
-}
-
-// Initialize TOC when DOM is ready
-if (document.readyState === 'loading') {
-  document.addEventListener('DOMContentLoaded', initToc)
-} else {
-  initToc()
-}
-`}export{S as processInlineTocSyntax,h as getConfig,_ as generateUniqueSlug,v as generateTocStyles,T as generateTocScripts,D as generateTocPositions,Y as generateTocHtml,y as generateTocData,q as generateSlug,b as generateSidebarTocHtml,$ as generateInlineTocHtml,R as generateFloatingTocHtml,U as filterHeadings,I as extractHeadings,H as enhanceHeadingsWithAnchors,O as defaultTocConfig,f as defaultConfig,r as config,L as buildTocHierarchy};
+import{A as P,B as Q,C as R,a as t,b as e,c as b,d as g,e as h,f as j,g as k,h as n,i as q,j as s,k as u,l as z,m as A,n as B,o as D,p as E,q as F,r as G,s as H,t as I,u as J,v as K,w as L,x as M,y as N,z as O}from"../chunk-he6c5f4e.js";export{Q as startServer,R as serveCLI,g as resetHighlighter,M as processInlineTocSyntax,s as prewarmHighlighter,h as normalizeLanguage,j as isLanguageSupported,n as highlightCodeSync,k as highlightCode,q as getSyntaxHighlightingStyles,u as getHighlighterInstance,b as getConfig,B as generateUniqueSlug,O as generateTocStyles,P as generateTocScripts,L as generateTocPositions,G as generateTocHtml,K as generateTocData,A as generateSlug,I as generateSidebarTocHtml,H as generateInlineTocHtml,J as generateFloatingTocHtml,F as filterHeadings,D as extractHeadings,N as enhanceHeadingsWithAnchors,z as defaultTocConfig,t as defaultConfig,e as config,E as buildTocHierarchy};

package/dist/template-loader.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Load a template file from the templates directory
+ */
+export declare function loadTemplate(name: string): Promise<string>;
+/**
+ * Render a template with data
+ */
+export declare function renderTemplate(template: string, data: Record<string, any>): string;
+/**
+ * Load and render a template in one step
+ */
+export declare function render(templateName: string, data: Record<string, any>): Promise<string>;
+/**
+ * Clear the template cache (useful for development/hot reloading)
+ */
+export declare function clearTemplateCache(): void;

package/dist/types.d.ts

@@ -1,4 +1,3 @@
-import type { marked } from 'marked';
 export declare interface BunPressConfig {
   verbose: boolean
   markdown: MarkdownPluginConfig
@@ -16,15 +15,17 @@ export declare interface MarkdownPluginConfig {
   scripts?: string[]
   title?: string
   meta?: Record<string, string>
-  markedOptions?: Parameters<typeof marked.parse>[1]
+  markedOptions?: any
   preserveDirectoryStructure?: boolean
   toc?: TocConfig
   sidebar?: Record<string, SidebarItem[]>
   nav?: NavItem[]
   search?: SearchConfig
   themeConfig?: ThemeConfig
+  syntaxHighlightTheme?: 'github-light' | 'github-dark'
   sitemap?: SitemapConfig
   robots?: RobotsConfig
+  features?: MarkdownFeaturesConfig
 }
 /**
  * Sidebar navigation item
@@ -94,6 +95,73 @@ export declare interface TocConfig {
   collapsible?: boolean
   exclude?: string[]
 }
+/**
+ * Markdown features configuration
+ * Controls which VitePress-compatible features are enabled
+ */
+export declare interface MarkdownFeaturesConfig {
+  inlineFormatting?: boolean
+  containers?: boolean | ContainersConfig
+  githubAlerts?: boolean | GitHubAlertsConfig
+  codeBlocks?: boolean | CodeBlocksConfig
+  codeGroups?: boolean
+  codeImports?: boolean
+  inlineToc?: boolean
+  customAnchors?: boolean
+  emoji?: boolean
+  badges?: boolean
+  includes?: boolean
+  externalLinks?: boolean | ExternalLinksConfig
+  imageLazyLoading?: boolean
+  tables?: boolean | TablesConfig
+}
+/**
+ * Custom containers configuration
+ */
+export declare interface ContainersConfig {
+  info?: boolean
+  tip?: boolean
+  warning?: boolean
+  danger?: boolean
+  details?: boolean
+  raw?: boolean
+}
+/**
+ * GitHub alerts configuration
+ */
+export declare interface GitHubAlertsConfig {
+  note?: boolean
+  tip?: boolean
+  important?: boolean
+  warning?: boolean
+  caution?: boolean
+}
+/**
+ * Code blocks configuration
+ */
+export declare interface CodeBlocksConfig {
+  lineHighlighting?: boolean
+  lineNumbers?: boolean
+  focus?: boolean
+  diffs?: boolean
+  errorWarningMarkers?: boolean
+}
+/**
+ * External links configuration
+ */
+export declare interface ExternalLinksConfig {
+  autoTarget?: boolean
+  autoRel?: boolean
+  showIcon?: boolean
+}
+/**
+ * Tables configuration
+ */
+export declare interface TablesConfig {
+  alignment?: boolean
+  enhancedStyling?: boolean
+  responsive?: boolean
+}
 /**
  * Search configuration
  */

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@stacksjs/bunpress",
   "type": "module",
-  "version": "0.0.5",
+  "version": "0.1.0",
   "description": "Modern documentation engine. Powered by Bun.",
   "author": "Chris Breuer <chris@stacksjs.org>",
   "license": "MIT",
@@ -57,22 +57,25 @@
     "lint:fix": "bunx --bun eslint . --fix",
     "changelog": "bunx logsmith --verbose",
     "changelog:generate": "bunx logsmith --output CHANGELOG.md",
-    "release": "bun run changelog:generate && bunx --bun bumpx prompt --recursive",
+    "release": "bunx --bun bumpx prompt --recursive",
     "dev:docs": "bun bin/cli.ts dev",
     "build:docs": "bun build.ts",
     "preview:docs": "bun serve --port 3000 dist",
     "typecheck": "bun --bun tsc --noEmit"
   },
   "devDependencies": {
-    "@stacksjs/bumpx": "^0.1.84",
+    "@stacksjs/bumpx": "^0.2.2",
     "@stacksjs/eslint-config": "^4.14.0-beta.3",
     "@stacksjs/gitlint": "^0.1.5",
-    "@stacksjs/headwind": "^0.1.1",
-    "@stacksjs/logsmith": "^0.1.18",
+    "@stacksjs/headwind": "^0.1.3",
+    "@stacksjs/logsmith": "^0.2.0",
     "@stacksjs/ts-i18n": "^0.0.0",
     "bun-git-hooks": "^0.3.1",
     "bun-plugin-dtsx": "0.9.5",
+    "bun-plugin-stx": "0.1.16",
+    "bun-types": "^1.3.1",
     "bunfig": "^0.15.0",
+    "ts-syntax-highlighter": "^0.2.0",
     "typescript": "^5.9.3"
   },
   "git-hooks": {
@@ -82,5 +85,8 @@
       }
     },
     "commit-msg": "bunx gitlint --edit .git/COMMIT_EDITMSG"
+  },
+  "overrides": {
+    "bun-plugin-stx": "0.1.16"
   }
 }