@miethe/ui 0.2.0 → 0.6.0

package/CHANGELOG.md

@@ -7,6 +7,71 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [0.6.0] - 2026-06-21
+
+### Added
+
+- **Form Components** — react-hook-form + zod based form primitives (peer dependencies optional)
+  - Schema-driven form builders for rapid CRUD interfaces
+  - Integrated validation and error handling
+  - Requires `react-hook-form` and `zod` as optional peer dependencies
+
+- **ContentPane `codeHighlight` prop** (NEW) — Opt-in syntax highlighting for non-markdown code files
+  - Uses **lowlight** (same optional peer dependency as ArticleViewer's `codeHighlight`)
+  - Single highlighting engine across the package for consistency
+  - Gracefully degrades to plain text when lowlight is not installed
+  - Enable by installing `lowlight` (v2 or v3) and passing `codeHighlight={true}`
+
+- **ContentPane `renderBinaryPreview` render-prop** (NEW) — Consumer-supplied binary/image/PDF preview slot
+  - Signature: `(ext: string, content: string | Uint8Array) => ReactNode | null`
+  - Returning `null` falls through to default text view
+  - Allows consumers to integrate react-pdf, next/image, or custom viewers without adding hard dependencies to @miethe/ui
+
+- **CodeEditor** (NEW export from `@miethe/ui/editor`) — CodeMirror 6 editor for non-markdown files
+  - Accepts `language?: LanguageSupport` prop for syntax highlighting
+  - Lazy-loaded via dynamic import for optimal bundle size
+  - ContentPane now routes editable non-markdown files (.ts, .tsx, .js, .jsx, .py, .json, .css) to CodeEditor when editing
+  - New dependencies: `@codemirror/lang-javascript`, `@codemirror/lang-python`, `@codemirror/lang-json`, `@codemirror/lang-css`, `@codemirror/language`
+
+- **MarkdownEditor reactive dark-mode** (CHANGED/fixed) — Editor now tracks OS `prefers-color-scheme` changes at runtime
+  - Uses CodeMirror Compartment for theme switching without re-initializing editor state
+  - Improved UX when system theme changes during editing session
+
+### Changed
+
+- ArticleViewer now ships in 0.6.0 (documented in 0.5.0 for v0.3.0 → 0.6.0 transitions)
+
+## [0.5.0] - 2026-04-24
+
+### Added
+
+- **ArticleViewer** component — read-only markdown + HTML renderer with callout support, frontmatter display, typography variants, and sanitization
+  - Supports CommonMark + GitHub-Flavored Markdown (tables, task lists, strikethrough, blockquotes, code blocks, links, lists)
+  - Callout directives (`::: note`, `::: reference`, `::: warning`, `::: info`) with customizable components
+  - YAML frontmatter parsing and optional collapsible display via `FrontmatterHeader`
+  - HTML input path with `rehype-sanitize@6` (XSS protection, default ON for HTML input)
+  - Typography variants (`editorial`, `compact`, `technical`) driven by CSS custom properties
+  - Optional syntax highlighting via lowlight (`codeHighlight` prop, opt-in)
+  - Auto-generated heading IDs for anchor navigation
+  - Loading and error states
+  - Fully typed TypeScript exports; zero `any` types at module boundary
+- New dependencies: `gray-matter@4.0.3`, `remark-directive@2.0.1`
+- Comprehensive test suite: 387 content-viewer tests covering all features, callouts, sanitization, variants, frontmatter
+
+## [0.3.0] - 2026-04-17
+
+### Added
+
+- **Planning Primitives** (`@miethe/ui/primitives`) — extracted from CCDash Planning Control Plane (PCP-709)
+  - `StatusChip`: Five-variant status chip (neutral/ok/warn/error/info) with optional tooltip. Pure presentational; accepts `label`, `variant`, `tooltip` props.
+  - `EffectiveStatusChips`: Composes `StatusChip` to render raw + effective status pair with hover provenance tooltip. Shows `eff:` chip only when statuses differ.
+  - `MismatchBadge`: Amber mismatch indicator in two modes — compact inline chip and full banner with evidence chips. Accepts `state`, `reason`, `evidenceLabels`, `compact` props.
+  - `BatchReadinessPill`: Wraps `StatusChip` for batch readiness state (`ready`/`blocked`/`waiting`/`unknown`) with optional blocking node/task ID display.
+  - `PlanningNodeTypeIcon`: Maps `PlanningNodeType` string to a lucide-react icon. Supports 7 node types: `design_spec`, `prd`, `implementation_plan`, `progress`, `context`, `tracker`, `report`.
+  - `variants.ts`: Exported helper types (`StatusChipVariant`, `ReadinessVariant`) and mapping functions (`statusVariant()`, `readinessVariant()`) for domain status → chip variant conversion.
+  - Supporting types: `PlanningStatusProvenance`, `PlanningStatusProvenanceSource`, `PlanningStatusEvidence`, `PlanningPhaseBatchReadinessState`, `PlanningNodeType`.
+  - 43 new unit tests across 5 test files covering all variants, prop forwarding, edge cases, and SVG rendering.
+
 ## [0.2.0] - 2026-04-16
 
 ### Added