Extract ts-highlight, ts-pagefind plugins.

Author: koculu

frontend/purestack.studio/guides/extending/plugins.mdx

@@ -91,13 +91,15 @@ The badge appears on the page. Change its `tone` in `plugins/site.ts` while the
 
 ## Standard plugins
 
-PureStack includes three plugins automatically in `build`, `serve`, and `publish`:
+PureStack includes five plugins automatically in `build`, `serve`, and `publish`:
 
 | Package | Factory | Provides |
 | --- | --- | --- |
 | `@purestack/ts-components` | `componentsPlugin()` | Standard components, icons, and component styles |
-| `@purestack/ts-theme` | `themePlugin()` | The `doc` and `splash` templates, generated theme CSS, and theme switching |
-| `@purestack/ts-page-scripts` | `pageScriptsPlugin()` | Auth hint, consent and analytics, menus, navigation, code copying, search, and TOC runtimes |
+| `@purestack/ts-theme` | `themePlugin()` | The `doc` and `splash` templates, generated theme CSS, favicons, and theme switching |
+| `@purestack/ts-page-scripts` | `pageScriptsPlugin()` | Auth hint, consent and analytics, menus, navigation, code copying, search, TOC, Tabs, and Modal runtimes |
+| `@purestack/ts-highlight` | `highlightPlugin()` | Shiki or highlight.js code highlighting |
+| `@purestack/ts-pagefind` | `pagefindPlugin()` | Full-build and lazy development search indexing |
 
 The stylesheet provider initializes before component factories, then all config hooks run in plugin order. Names do not affect initialization. Components belong to each build, so hooks can override them through `context.components`. The theme and page runtime plugins supply head templates that run before the selected page template, preserving its ability to inspect or change the completed head. The lifecycle hook set is unchanged.
 
@@ -112,10 +114,14 @@ export default defineConfig({
 })
 ```
 
-This keeps the layouts and components while omitting the page runtimes. Theme switching belongs to the theme plugin; component-specific Tabs and Modal embeds still follow the page's `embed` settings. Without the theme plugin, another plugin must supply your page templates and any CSS output you need.
+This keeps the layouts and components while omitting page runtimes, code highlighting, and search indexing. Theme switching and favicon generation belong to the theme plugin. Tabs and Modal scripts belong to the page scripts plugin, including automatic component embeds and explicit frontmatter settings. Without the theme plugin, another plugin must supply your page templates and any CSS output you need.
 
 An explicitly listed standard plugin replaces the automatic instance by name and keeps its initialization position. You can also use `createDefaultPlugins()` to obtain the complete set. In programmatic builds, use `options.defaultPlugins` alongside `options.plugins`.
 
+The highlighting plugin selects the configured backend. Configure native backend factories through `highlightPlugin({ createShiki, createHighlightJs })`, or supply `markdown.createHighlighter(config)` for a different engine. The generic provider returns `{ codeToHtml(code, lang?) }`. Ordinary providers override the default without constructing it; per-language `markdown.resolveHighlighter` callbacks retain precedence.
+
+The Pagefind plugin supplies a `search` provider. To use another engine, replace `purestack:pagefind` or disable the default set and install your own provider. The builder supplies excluded output paths and the rendered-page list for lazy requests, and manages invalidation on edits and deletions. Sitemap and robots generation remain built in.
+
 ## How the config loads
 
 - **Where it lives.** The CLI looks for `purestack.config.ts` in the folder passed to `--content`. It must default-export `defineConfig({ plugins: [...] })`.

package.json

@@ -1,7 +1,7 @@
 {
   "private": true,
   "name": "purestack-repo",
-  "version": "1.1.14",
+  "version": "1.1.15",
   "packageManager": "yarn@4.18.1",
   "type": "module",
   "sideEffects": false,

packages/purestack/package.json

@@ -1,6 +1,6 @@
 {
   "name": "purestack",
-  "version": "1.1.14",
+  "version": "1.1.15",
   "packageManager": "yarn@4.9.2",
   "module": "./dist/purestack.mjs",
   "types": "./dist/purestack.d.mts",

packages/purestack/src/index.ts

@@ -1,3 +1,3 @@
-export const version: string = '1.1.14'
+export const version: string = '1.1.15'
 
 export * from '@purestack/ts-ssg'

packages/ts-common/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@purestack/ts-common",
-  "version": "1.1.14",
+  "version": "1.1.15",
   "packageManager": "yarn@4.9.2",
   "module": "./dist/ts-common.mjs",
   "types": "./dist/ts-common.d.mts",

packages/ts-common/src/code-highlighter.ts

@@ -0,0 +1,4 @@
+/** Converts source code to highlighted pre/code HTML. */
+export interface MdxCodeHighlighter {
+  codeToHtml: (code: string, lang?: string) => string | Promise<string>
+}

packages/ts-ssg/src/mdx/codeLanguages.ts packages/ts-common/src/codeLanguages.tspackages/ts-ssg/src/mdx/codeLanguages.ts renamed to packages/ts-common/src/codeLanguages.ts

@@ -1,3 +1,9 @@
+export type { MdxCodeHighlighter } from './code-highlighter'
+export {
+  DEFAULT_CODE_LANGUAGES,
+  LANGUAGE_BY_EXTENSION,
+  normalizeCodeLanguage,
+} from './codeLanguages'
 export type {
   ConsentCategory,
   ConsentConfig,
@@ -64,9 +70,12 @@ export type {
   SiteStyleConfig,
   SiteStyleConfigInput,
 } from './site-config-types'
+export type { SiteSearch } from './site-search'
 export type { SiteStyles, WriteStylesResult } from './site-styles'
 export type {
   PageContext,
   PageOutlineItem,
+  RuntimeEmbedPosition,
+  RuntimeEmbeds,
   TsSsgNavigation,
 } from './ts-ssg-context'

packages/ts-common/src/index.ts

@@ -0,0 +1,11 @@
+/** Search output owned by a plugin; the builder manages output invalidation. */
+export interface SiteSearch {
+  /** Whether a decoded, base-path-relative URL belongs to this search provider. */
+  ownsPath(pathname: string): boolean
+  write(input: {
+    outDir: string
+    excludeFiles: Iterable<string>
+    /** Only these rendered pages are available during lazy development. */
+    onlyFiles?: Iterable<string>
+  }): Promise<void>
+}

packages/ts-common/src/site-search.ts

@@ -13,6 +13,9 @@ export interface PageOutlineItem {
   children?: PageOutlineItem[]
 }
 
+export type RuntimeEmbedPosition = 'body' | 'head'
+export type RuntimeEmbeds = ReadonlyMap<string, RuntimeEmbedPosition>
+
 export interface TsSsgNavigation {
   folder?: string
   root?: string
@@ -35,5 +38,5 @@ export interface PageContext {
   resolvePublicHref: (href: string) => string
   recordScriptEntrypoint: (sourceRelPath: string) => void
   resolveScriptPublicPath?: (sourceRelPath: string) => string
-  recordRuntimeEmbed: (name: string, position: 'body' | 'head') => void
+  recordRuntimeEmbed: (name: string, position: RuntimeEmbedPosition) => void
 }