# preactjs/preact · RepoSense Release & Migration Intelligence

> Adds scoped custom element registries and event bubbling fixes. Drop-in upgrade. Migration: None.

## Metadata
- **Repository URL**: https://github.com/preactjs/preact
- **Primary Package**: `preact` (NPM)
- **Categories**: `FRAMEWORK`
- **Latest Version**: `v11.2.0`
- **Semantic Status**: `COMPATIBLE`
- **Bundle Size Impact (unavailable)**: `Size Unavailable`
- **Atom Ingestion Feed**: https://github.com/preactjs/preact/releases.atom

## The Human Context (Plain-English Pitch)
Preact is an ultra-lightweight virtual DOM framework that provides a modern component-driven development model using the same familiar API as React. It solves the performance and bandwidth problem of shipping heavy JavaScript bundles to client browsers by condensing the core UI runtime down to roughly 3kB. Teams use Preact to build interactive web apps with minimal overhead.

## Stage 1 Executive Summary ([Core Change] + [Required Action] + [Migration Effort])
Adds scoped custom element registries and event bubbling fixes. Drop-in upgrade. Migration: None.

## Breaking Changes & Required Actions
- Added support for scoped custom element registries when mounting or rendering components into Shadow DOM roots via `#5342`.
- Safeguarded `on*` event props by ignoring non-function values instead of binding invalid event handlers.
- Retained event handlers on unmounted nodes temporarily to allow in-flight bubbling events to complete dispatch.
- Passed thrown `null` or `undefined` primitives directly to error boundaries rather than synthesizing a `TypeError`.

## Migration Snippet
```ts
npm install preact@^11.2.0
```

## Ecosystem Compatibility Matrix & Graph Warnings
- **TypeScript >=4.8** [`COMPATIBLE`]: Existing JSX definitions and component prop interfaces remain fully compatible without type changes.
- **Vite >=4.0** [`COMPATIBLE`]: Integrates cleanly with standard Preact Vite plugins without configuration modifications.
- **Node.js >=18** [`COMPATIBLE`]: Node.js runtime support and SSR pipelines through `preact-render-to-string` remain stable.

## Zero-Noise Release Timeline
- **v11.2.0** (2026-11-06) [COMPATIBLE]: Adds scoped custom element registries and event bubbling fixes. Drop-in upgrade. Migration: None.
- **v11.1.1** (2026-10-31) [COMPATIBLE]: Fix rendering, updating, and hydrating `<template>`. Drop-in upgrade. Migration: None.

## Upgrade & Migration Q&A (GEO Direct Answers)
### Is preactjs/preact v11.2.0 safe to upgrade in production?
preactjs/preact v11.2.0 is classified as COMPATIBLE (MINOR release). Adds scoped custom element registries and event bubbling fixes. Drop-in upgrade. Migration: None.

### What breaking changes or compatibility risks exist in preactjs/preact v11.2.0?
No breaking API changes or peer dependency conflicts are recorded for preactjs/preact v11.2.0 in the RepoSense compatibility graph.

### What is the bundle size impact of preact v11.2.0?
Measured bundle size telemetry is currently unavailable for preact v11.2.0; verify build output locally before deploying.

### How do I upgrade preact to v11.2.0?
Upgrade preact to v11.2.0 by running "npm install preact@11.2.0" and applying the migration steps: npm install preact@^11.2.0