@pagesmith/core 0.3.0 → 0.4.0

package/README.md

@@ -29,6 +29,8 @@ const rendered = await entries[0]?.render()
 // rendered.html, rendered.headings, rendered.readTime
 ```
 
+For pre-1.0 upgrade notes, see `docs/agents/migration.md`.
+
 ### Vite Integration
 
 ```ts
@@ -147,11 +149,12 @@ The pipeline is built with unified and processes markdown through these stages:
 ```
 remark-parse → remark-gfm → remark-math → remark-frontmatter
   → remark-github-alerts → remark-smartypants → [user remark plugins]
-  → remark-rehype
+  → lang-alias transform → remark-rehype
+  → rehype-mathjax (must run before Expressive Code)
   → rehype-expressive-code (syntax highlighting)
-  → rehype-mathjax → rehype-slug → rehype-autolink-headings
-  → heading extraction → [user rehype plugins]
-  → rehype-external-links → rehype-accessible-emojis → rehype-stringify
+  → rehype-slug → rehype-autolink-headings
+  → rehype-external-links → rehype-accessible-emojis
+  → heading extraction → [user rehype plugins] → rehype-stringify
 ```
 
 ### Markdown Features
@@ -474,7 +477,9 @@ Generates: `CLAUDE.md`, `AGENTS.md`, `GEMINI.md`, skills, `llms.txt`, `llms-full
 | `@pagesmith/core/runtime` | Pre-built CSS/JS accessors |
 | `@pagesmith/core/ai` | AI assistant artifact generator |
 | `@pagesmith/core/vite` | Vite plugins (pagesmithContent, pagesmithSsg, sharedAssetsPlugin) |
+| `@pagesmith/core/ssg-utils` | Shared SSG utility helpers |
 | `@pagesmith/core/create` | Project scaffolding utilities |
+| `@pagesmith/core/mcp` | Core MCP server and helper utilities |
 
 ## License
 

package/REFERENCE.md

@@ -158,9 +158,10 @@ Serves shared font assets (Open Sans, JetBrains Mono) bundled with `@pagesmith/c
 ```
 remark-parse → remark-gfm → remark-math → remark-frontmatter
   → remark-github-alerts → remark-smartypants → [user remark plugins]
-  → remark-rehype
+  → lang-alias transform → remark-rehype
+  → rehype-mathjax (must run before Expressive Code so math is rendered to SVG first)
   → rehype-expressive-code (dual themes, line numbers, titles, copy, collapse, mark/ins/del)
-  → rehype-mathjax → rehype-slug → rehype-autolink-headings
+  → rehype-slug → rehype-autolink-headings
   → rehype-external-links → rehype-accessible-emojis
   → heading extraction → [user rehype plugins] → rehype-stringify
 ```
@@ -267,8 +268,10 @@ Two tiers:
 | `@pagesmith/core/assets` | Asset copying and hashing |
 | `@pagesmith/core/runtime` | Pre-built CSS/JS accessors |
 | `@pagesmith/core/vite` | Vite plugins |
+| `@pagesmith/core/ssg-utils` | Shared SSG utility helpers |
 | `@pagesmith/core/ai` | AI assistant artifact generator |
 | `@pagesmith/core/create` | Project scaffolding |
+| `@pagesmith/core/mcp` | Core MCP server and helper utilities |
 
 ## Key Rules
 

package/dist/ai/index.d.mts

@@ -1,8 +1,8 @@
-//#region src/ai/index.d.ts
+//#region src/ai/types.d.ts
 type AiAssistant = 'claude' | 'codex' | 'gemini';
 type AiInstallScope = 'project' | 'user';
 type AiInstallProfile = 'default' | 'docs';
-type AiArtifactKind = 'memory' | 'skill' | 'llms' | 'llms-full' | 'markdown-guidelines' | 'update-docs';
+type AiArtifactKind = 'memory' | 'skill' | 'llms' | 'llms-full' | 'markdown-guidelines' | 'update-docs' | 'update-all-docs';
 type AiWriteMode = 'merge' | 'replace';
 type AiInstallStatus = 'written' | 'merged' | 'replaced' | 'unchanged';
 type AiArtifact = {
@@ -31,6 +31,8 @@ type AiInstallOptions = {
   skillName?: string; /** When true, return planned writes without actually writing files. */
   dryRun?: boolean;
 };
+//#endregion
+//#region src/ai/index.d.ts
 declare function getAiArtifactContent(assistant: AiAssistant | 'shared', kind: AiArtifactKind, options?: {
   profile?: AiInstallProfile;
   skillName?: string;
@@ -38,5 +40,5 @@ declare function getAiArtifactContent(assistant: AiAssistant | 'shared', kind: A
 declare function getAiArtifacts(options?: AiInstallOptions): AiArtifact[];
 declare function installAiArtifacts(options?: AiInstallOptions): AiInstallResult[];
 //#endregion
-export { AiArtifact, AiArtifactKind, AiAssistant, AiInstallOptions, AiInstallProfile, AiInstallResult, AiInstallScope, AiInstallStatus, AiWriteMode, getAiArtifactContent, getAiArtifacts, installAiArtifacts };
+export { type AiArtifact, type AiArtifactKind, type AiAssistant, type AiInstallOptions, type AiInstallProfile, type AiInstallResult, type AiInstallScope, type AiInstallStatus, type AiWriteMode, getAiArtifactContent, getAiArtifacts, installAiArtifacts };
 //# sourceMappingURL=index.d.mts.map

package/dist/ai/index.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.mts","names":[],"sources":["../../src/ai/index.ts"],"mappings":";KAIY,WAAA;AAAA,KACA,cAAA;AAAA,KACA,gBAAA;AAAA,KACA,cAAA;AAAA,KAOA,WAAA;AAAA,KACA,eAAA;AAAA,KAEA,UAAA;EACV,SAAA,GAAY,WAAA;EACZ,IAAA,EAAM,cAAA;EACN,IAAA;EACA,OAAA;EACA,IAAA,EAAM,WAAA;EACN,KAAA;AAAA;AAAA,KAGU,eAAA;EACV,SAAA,GAAY,WAAA;EACZ,IAAA,EAAM,cAAA;EACN,IAAA;EACA,MAAA,EAAQ,eAAA;EACR,KAAA;AAAA;AAAA,KAGU,gBAAA;EACV,UAAA,GAAa,WAAA;EACb,KAAA,GAAQ,cAAA;EACR,OAAA,GAAU,gBAAA;EACV,GAAA;EACA,OAAA;EACA,WAAA;EACA,KAAA;EACA,SAAA,WA3ByB;EA6BzB,MAAA;AAAA;AAAA,iBA8sBc,oBAAA,CACd,SAAA,EAAW,WAAA,aACX,IAAA,EAAM,cAAA,EACN,OAAA;EAAW,OAAA,GAAU,gBAAA;EAAkB,SAAA;AAAA;AAAA,iBAuCzB,cAAA,CAAe,OAAA,GAAS,gBAAA,GAAwB,UAAA;AAAA,iBAiIhD,kBAAA,CAAmB,OAAA,GAAS,gBAAA,GAAwB,eAAA"}
+{"version":3,"file":"index.d.mts","names":[],"sources":["../../src/ai/types.ts","../../src/ai/index.ts"],"mappings":";KAAY,WAAA;AAAA,KACA,cAAA;AAAA,KACA,gBAAA;AAAA,KACA,cAAA;AAAA,KAQA,WAAA;AAAA,KACA,eAAA;AAAA,KAEA,UAAA;EACV,SAAA,GAAY,WAAA;EACZ,IAAA,EAAM,cAAA;EACN,IAAA;EACA,OAAA;EACA,IAAA,EAAM,WAAA;EACN,KAAA;AAAA;AAAA,KAGU,eAAA;EACV,SAAA,GAAY,WAAA;EACZ,IAAA,EAAM,cAAA;EACN,IAAA;EACA,MAAA,EAAQ,eAAA;EACR,KAAA;AAAA;AAAA,KAGU,gBAAA;EACV,UAAA,GAAa,WAAA;EACb,KAAA,GAAQ,cAAA;EACR,OAAA,GAAU,gBAAA;EACV,GAAA;EACA,OAAA;EACA,WAAA;EACA,KAAA;EACA,SAAA,WA3ByB;EA6BzB,MAAA;AAAA;;;iBCwBc,oBAAA,CACd,SAAA,EAAW,WAAA,aACX,IAAA,EAAM,cAAA,EACN,OAAA;EAAW,OAAA,GAAU,gBAAA;EAAkB,SAAA;AAAA;AAAA,iBA0CzB,cAAA,CAAe,OAAA,GAAS,gBAAA,GAAwB,UAAA;AAAA,iBAyIhD,kBAAA,CAAmB,OAAA,GAAS,gBAAA,GAAwB,eAAA"}