@maxhealth.tech/prefab 0.3.0 → 0.3.1

package/CHANGELOG.md

@@ -2,6 +2,20 @@
 
 All notable changes to this project will be documented in this file.
 
+## [0.3.1] — 2026-06-27
+
+Documentation and tooling release. No runtime or API changes: `src/` is unchanged aside from the version bump, so the published bundle is functionally identical to 0.3.0.
+
+### Fixed
+
+- Corrected the wire-protocol version label across the user-facing docs. The README badge and tagline, the skill header, the homepage feature text, and a version-pin example still advertised `0.2`, but the library has shipped protocol `0.3` since 0.3.0 (the renderer still accepts legacy `0.2` payloads).
+
+### Docs
+
+- Deduplicated the Guide and Reference sections. Each reference topic now lives in one place, and the Guide pages are concise conceptual pages that link into the reference, removing a large amount of duplicated content.
+- Single-sourced the example UIs. The demo and playground now load one canonical set of `$prefab` examples from `docs/public/examples/` at runtime instead of embedding their own copies, and the skill bundle's example assets are generated from that same set.
+- The programmatic API reference (actions, rx, mcp, auto, renderer) is now generated from the source TSDoc with TypeDoc, so it stays in sync with the code. The component catalog, wire format, and MCP Apps pages remain hand-written.
+
 ## [0.3.0] — 2026-06-16
 
 ### Wire Format (Breaking) — protocol `0.3`

package/README.md

@@ -3,11 +3,11 @@
 [![CI](https://github.com/Max-Health-Inc/prefab/actions/workflows/ci.yml/badge.svg)](https://github.com/Max-Health-Inc/prefab/actions/workflows/ci.yml)
 [![tests](https://img.shields.io/badge/tests-1077%20passing%20(100%25)-brightgreen)](https://github.com/Max-Health-Inc/prefab/actions/workflows/ci.yml)
 [![@maxhealth.tech/prefab](https://img.shields.io/npm/v/@maxhealth.tech/prefab?label=%40maxhealth.tech%2Fprefab)](https://www.npmjs.com/package/@maxhealth.tech/prefab)
-[![prefab-protocol](https://img.shields.io/badge/prefab--protocol-v0.2-brightgreen)](https://maxhealth.tech/prefab/reference/wire-format.html)
+[![prefab-protocol](https://img.shields.io/badge/prefab--protocol-v0.3-brightgreen)](https://maxhealth.tech/prefab/reference/wire-format.html)
 [![TypeScript](https://img.shields.io/badge/TypeScript-6.0-blue?logo=typescript&logoColor=white)](https://www.typescriptlang.org/)
 [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
 
-TypeScript declarative UI component library for MCP apps. Wire-compatible with PrefectHQ's Python [prefab-ui](https://github.com/PrefectHQ/prefab) — **same `$prefab` v0.2 wire protocol**.
+TypeScript declarative UI component library for MCP apps. Wire-compatible with PrefectHQ's Python [prefab-ui](https://github.com/PrefectHQ/prefab) — **`$prefab` v0.3 wire protocol** (still renders legacy `0.2` payloads).
 
 **[Live Demo](https://maxhealth.tech/prefab/demo/)** · **[Playground](https://maxhealth.tech/prefab/playground/)**
 

package/dist/app.d.ts

@@ -9,7 +9,7 @@ import type { ComponentJSON } from './core/component.js';
 import type { Action, ActionJSON } from './actions/types.js';
 import type { PipeFn } from './rx/pipes.js';
 /** Package version — injected by build script, updated at release time. */
-export declare const VERSION = "0.3.0";
+export declare const VERSION = "0.3.1";
 /**
  * Wire protocol version emitted in `$prefab.version`.
  *

package/dist/app.js

@@ -8,7 +8,7 @@ import {} from './core/component.js';
 import { drainAutoState } from './rx/state-collector.js';
 import { compileThemeCss } from './core/theme-css.js';
 /** Package version — injected by build script, updated at release time. */
-export const VERSION = '0.3.0';
+export const VERSION = '0.3.1';
 /**
  * Wire protocol version emitted in `$prefab.version`.
  *

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@maxhealth.tech/prefab",
-  "version": "0.3.0",
+  "version": "0.3.1",
   "description": "TypeScript declarative UI component library for MCP apps. Wire-compatible with Python prefab-ui.",
   "type": "module",
   "main": "dist/index.js",
@@ -58,7 +58,11 @@
     "lint:fix": "eslint src/ test/ --fix",
     "typecheck": "tsc --noEmit",
     "prepublishOnly": "bun run build",
+    "gen:skill": "bun run scripts/gen-skill-assets.ts",
+    "docs:api": "typedoc && bun run scripts/fix-typedoc-vue.ts",
+    "predocs:dev": "bun run docs:api",
     "docs:dev": "vitepress dev docs",
+    "predocs:build": "bun run docs:api",
     "docs:build": "vitepress build docs",
     "docs:preview": "vitepress preview docs"
   },
@@ -84,6 +88,9 @@
     "eslint": "^10.2.1",
     "happy-dom": "^20.9.0",
     "jiti": "^2.6.1",
+    "typedoc": "^0.28.19",
+    "typedoc-plugin-markdown": "^4.12.0",
+    "typedoc-vitepress-theme": "^1.1.3",
     "typescript": "^6.0.3",
     "typescript-eslint": "^8.58.2",
     "vitepress": "1.6.4",