hono-svelte 0.5.0 → 0.6.2

package/CHANGELOG.md

@@ -1,143 +1,299 @@
-# Changelog
-
-## 0.5.0
-
-- **Per-page data typing (opt-in, `pages({ dts: true })`)**: declare
-  `export type Data` (or `interface Data`) in a page's `<script module>` and
-  the generated `.d.ts` adds a typed overload per page —
-  `c.render("dashboard", { data })` is checked by `tsc` (a missing/mistyped
-  field fails the typecheck instead of shipping `undefined`). The declaration
-  is inlined verbatim, so it must be self-contained; types that reference
-  imports are skipped with a one-time warning and keep
-  `Record<string, unknown>` data. `RenderProps` is now generic
-  (`RenderProps<TData = Record<string, unknown>>`) and `pages().dataTypes()`
-  exposes the extractions. The dts also regenerates when a page's `Data`
-  type changes (dev watcher + `buildStart`).
-- **Neutral `<body>`**: the shell no longer hardcodes DaisyUI classes
-  (`bg-base-200 min-h-screen text-base-content`) — it emits a plain,
-  CSS-framework-agnostic document. Style `body`/`html` from your global
-  stylesheet instead (`body { background: var(--color-base-200); ... }`, or
-  `@apply` with Tailwind — the playground does exactly that in
-  `styles.css`). **Breaking** for apps relying on the hardcoded classes.
-- **`shell({ ssrFallback })`**: when SSR of a page throws at request time,
-  log the error and fall back to client rendering (entry script) instead of
-  a 500. Default `false` keeps the previous behavior.
-- `prefetch: "all"` / `"hover"` now emit `rel="modulepreload"` (prefetch on a
-  module URL could double-fetch in some browsers; modulepreload also warms
-  the entry's import graph).
-- `dataLimit` warning fires once per **(page, limit)** instead of once per
-  process — a second oversized page is reported too, with the entry name in
-  the message.
-- **Removed dead stubs**: `versionsMatch()` (always returned `true`), the
-  unused `hasClient` export from the ssr-manifest stub/virtual manifest, and
-  the no-op `checkPagesDir`. **Breaking: `versionsMatch` is no longer
-  exported.**
-- Fully typed handlers/middleware: `notFoundHandler()` / `errorHandler()`
-  match Hono's `NotFoundHandler`/`ErrorHandler` signatures and `shell()` no
-  longer uses `any` internally.
-- **CLI: `hono-svelte add page <name>`** — scaffolds
-  `src/pages/<name>.svelte` (static by default, skip-if-exists, traversal
-  refused). `isValidPageName()` / `newPageFile()` exported for tests.
-- Metadata: `engines` now declares `bun >= 1.4` and `node >= 26`, the
-  `./package.json` export subpath was added, and TypeScript 7 builds the
-  package.
-- **Security floors in `peerDependencies`**: `hono ^4.13.8`, `svelte ^5.57.0`,
-  `vite ^8.3.0` — every published advisory sits outside these floors
-  (hono < 4.12.12 and 4.12.0–4.12.33, patched in 4.12.34; svelte ≤ 5.55.6,
-  patched in 5.55.7; vite ≤ 8.0.15, patched in 8.0.16; transitive `devalue`
-  resolves to the patched 5.9.2, which also closes CVE-2026-81176). The
-  versions installed in the repo and in the example are the latest published
-  and none is affected by a known advisory — the ranges just avoid
-  advertising vulnerable versions to consumers and scanners.
-- CI: ubuntu + windows runners (Windows-only regressions like the old
-  `isSafeAppPath` bug are caught now), coverage via `@vitest/coverage-v8`
-  with thresholds (`npm test` runs it), all on the officially supported
-  runtimes (Node 26, TS 7, Vite 8, Bun 1.4+).
-- `hono-svelte init` now scaffolds TypeScript 7 + `@types/node` 26 in the
-  generated app.
-
-## 0.4.2
-
-- `hono-svelte init` now scaffolds a complete runnable app (works with
-  `npx`, `bunx` and `pnpm dlx` — writes text files only, no install/network).
-  Minimal flavor (default): `package.json`, `tsconfig.json`, `.gitignore`,
-  `vite.config.ts` (with `pages({ dts: true })`), two pages (`index` zero-JS,
-  `hello` with `data`), `src/routes/index.ts`, `src/styles.css`.
-  `init --full` adds auth (cookie session), dashboard with nested layout,
-  and typed RPC (`hc<AppType>`) — `/auth` → login → `/dashboard`.
-  Generated scripts (`dev`/`build`/`typecheck`/`start`) run under npm and bun.
-  `InitFlavor` type exported.
-
-## 0.4.1
-
-- Fix `hono-svelte init` refusing every file on Windows: `isSafeAppPath()`
-  now normalizes `\` vs `/` and compares case-insensitively on win32
-  (path traversal still blocked).
-- Fix `bin` path without `./` prefix — npm was silently stripping the CLI
-  from the published tarball.
-
-## 0.4.0
-
-- **Typed `c.render` entries (opt-in)**: `pages({ dts })` writes a `.d.ts` file
-  with the entry union (`HonoSvelteEntries`) + `declare module "hono"`
-  augmentation. `true` writes `src/hono-svelte-entries.d.ts` (relative to the
-  Vite root); a string sets a custom path. Regenerated on `buildStart` and by
-  the dev watcher when entries change. `dtsPath()` / `writeDts()` exposed on
-  the plugin. The playground wires it (`pages({ dts: true })` +
-  `/// <reference path="./hono-svelte-entries.d.ts" />` in `env.d.ts`), so a
-  typo in `c.render("...")` fails `tsc` instead of 500ing at runtime.
-  `data` stays `Record<string, unknown>` (per-page payload types are a future
-  feature).
-- **Layouts, single source of truth**: `<dir>/layout.svelte` wraps pages
-  automatically (SSR inside-out + client hydrate, `layouts()` /
-  `layoutChain()` to inspect, `layouts: false` = legacy ignore). Pages must
-  NOT import their layout manually — the plugin fails fast at build time
-  (`manually imports ... but the layout is applied automatically`) instead of
-  rendering the layout twice. Layout props (`title`, `description`) come from
-  the route via `c.render(entry, { data })`, with `title = "Dashboard"`
-  fallback in the layout. Rule shared by plugin and shell: static means
-  "no `<script>`", layouts don't matter; `__clientEntries` travels in the
-  virtual manifest so the shell picks the SSR branch for static+layouts pages.
-- **Runtime fixes**: static `import.meta.env.PROD/DEV` access (Vite module
-  runner forbids dynamic access — dev 500 fixed); static
-  `createRawSnippet` import in layout entries (no duplicated Svelte runtime —
-  `Illegal invocation` fixed); layout children snippet renders `<div>` wrapper
-  (empty render broke hydration — `Cannot set properties of null` fixed);
-  bundled server defaults to prod so plain `node ./dist/index.js` works on
-  Windows with no `NODE_ENV` prefix.
-- `c.render(entry, { status, headers, head })`: per-render status/headers
-  (merged over shell defaults) and CSP-safe per-page head tags
-  (`description`, `canonical`, `og`, `twitter`, `meta`, `extra`).
-- SSR static pages now receive `data` as component props (plus the embedded JSON).
-- Strict entries: unknown entryNames throw a dev-friendly error (`Available pages: ...`, generic in prod); `shell({ strict: false })` disables; `availableEntries()` exposes the list.
-- `pages().types()` / `typeDeclarations()` generate the entry union + hono module snippet.
-- Nested layouts: `<dir>/layout.svelte` wraps pages (SSR inside-out, `layouts()`/`layoutChain()`, `layouts: false` = legacy).
-- `notFoundHandler()` / `errorHandler()` for conventional `404.svelte` / `500.svelte` pages.
-- `hono-svelte init|doctor` CLI (`bin`) with `--app` flag.
-- `pages().validateConfig()` fails fast on missing svelte plugin / pagesDir.
-- `shell({ assets })` accepts a Vite manifest (hashed URLs, CSS, shared-chunk preload) with fallback; `preload`/`prefetch` controls; `styles` extra CSS.
-- `shell({ nonce })` CSP support on shell tags; `svelte/server` CSP passthrough for SSR.
-- Cache helpers: `immutableHeaders()`, `CACHE_IMMUTABLE`, `CACHE_NO_STORE`.
-- `data` size one-time warning (`shell({ dataLimit })`, default 100KB).
-
-## 0.3.1
-
-- Package metadata: repository/homepage/author, publishConfig, LICENSE + CHANGELOG in files.
-- No code changes since 0.3.0.
-
-## 0.3.0
-
-- Fully in-memory package: entries and manifest are virtual modules (no files written to disk).
-- Automatic zero-JS: `.svelte` pages without `<script>` render on the server (`svelte/server`)
-  and download no JS on the client.
-- Deterministic opaque IDs derived from the entryName (no salt, no env, no disk).
-- Zero config: the shell resolves the SSR map on its own (relative import redirected by the plugin).
-- Test suite (vitest) and CI (typecheck + tests + build + publint).
-
-## 0.2.0
-
-- Opaque IDs (`r-` + hash) replace configurable `rootId`/`dataId`.
-
-## 0.1.0
-
+# Changelog
+
+## 0.6.2
+
+- **fix(shell): unknown-entry errors never list the app's pages in
+  production** (as documented for `knownEntries`); dev keeps the list.
+- **refactor:** the layout chain lives in one module (`src/layouts.ts`)
+  shared by the Vite plugin and the shell — the 0.6.1 nesting bug came from
+  two diverging copies. Removed dead code (`isDev`, an unused prefetch
+  parameter).
+- **perf(shell):** the Vite manifest is resolved once per shell and its
+  per-entry CSS/preload lists are cached, instead of walking the chunk graph
+  on every request.
+- **getPage().route** keeps reading the request's own `routePath`: the
+  `hono/route` helper breaks with duplicate hono copies (found by the new
+  playground e2e run). A test guards against runtime hono imports.
+- **Node 24 (LTS) supported**: `engines.node` is `>=24` (package and
+  `init` template); CI runs Node 24 and 26.
+- **CI/release:** `release.yml` publishes tags with npm trusted publishing
+  (OIDC, provenance) and creates the GitHub release from this file;
+  Dependabot for npm and actions; coverage floors raised to the measured
+  level; e2e adds `vite` dev and the playground app (sign-in, session,
+  dashboard).
+
+## 0.6.1
+
+- **fix(shell): nested layouts nest outermost first.** With a root
+  `layout.svelte` plus `<dir>/layout.svelte`, the server wrapped the page in
+  the root layout first, so the directory layout ended up outside.
+- **fix(vite): client pages mount the whole layout chain.** The client entry
+  imported every layout but only mounted `Layout0`; inner layouts vanished.
+  Client entries are never server-rendered, so the chain is now mounted
+  (no hydration of an empty root).
+- **fix(vite): components imported by static pages and layouts keep their
+  `<style>`.** Only the page/layout files were compiled with
+  `css: "injected"` for the server; a layout's nav or a component-library
+  component lost its CSS on zero-JS pages.
+- **fix(handlers): `errorHandler` keeps the headers of `HTTPException`
+  responses** — `basicAuth`/`bearerAuth` 401s now carry `WWW-Authenticate`.
+- **fix(shell): prefetch.** `prefetch: "all"` no longer preloads static pages
+  (no JS chunk → 404); `"hover"` dedupes its links (it looked for
+  `rel="prefetch"` but created `modulepreload`) and maps `/` → `index` and
+  `/dir` → `dir/index`.
+- **fix(shell):** the global stylesheet fallback follows `assetsBase`; a
+  throwing `nonce()` is logged instead of silently dropping the CSP nonce.
+- **fix(vite):** `pagesDir` outside the Vite root (including another drive
+  on Windows) fails with a clear English error.
+- **test:** `test/regressions.test.ts` (one test per fix) and a Playwright
+  contract suite in `e2e/` that runs the same browser tests against
+  hono-svelte on Node, on Bun, and against SvelteKit as the reference. CI
+  adds the e2e job and a peer-dependency matrix (declared minimums and
+  latest within the majors).
+
+## 0.6.0
+
+- **feat(shell): `htmlAttributes` option.** Only `lang` could be set on
+  `<html>`, so themes driven by a root attribute (DaisyUI `data-theme`,
+  `class="dark"`) needed CSS workarounds. `htmlAttributes` takes a record
+  or `(c) => record` (per-request, e.g. from a cookie); values are escaped,
+  invalid names (and `lang`, which has its own option) throw.
+
+- **feat(handlers): error pages get `{ status, message }`; JSON for API
+  paths.** `notFoundHandler`/`errorHandler` rendered the page without any
+  data, always with 404/500, and had no way to keep API routes on JSON.
+  Now: pages receive `{ status, message }` (merged under `opts.data`);
+  `errorHandler` uses the status carried by the error (`HTTPException`
+  and friends), exposes the error message only for 4xx (`expose` to
+  customize, `message` for the generic text) and logs only 5xx; new
+  `json: (c) => boolean` answers `{ message }` JSON with the same status.
+  `notFoundHandler` takes a `message`. `ErrorPageData` type exported.
+
+- **feat: `getPage()` from `hono-svelte/page`.** Layouts had no way to
+  know which route rendered them (active-link logic needed the route
+  threaded through every page's `data`). `getPage()` returns `{ path,
+  route }` (request pathname + Hono route pattern, e.g. `/users/:id`) in
+  server-rendered components and client pages alike: the shell provides it
+  as Svelte context on SSR and writes `data-hs-path`/`data-hs-route` on the
+  root element, which the generated client entry passes as `context` to
+  `mount`/`hydrate`. New `./page` export; `PageInfo` type exported from the
+  main entry.
+
+- **feat(shell): global stylesheet resolved from the manifest
+  (`stylesEntry`).** With `assets: manifest`, the global CSS kept pointing at
+  the unhashed `/static/styles.css`, so hashed client builds needed a
+  hand-written `stylesHref: "/" + manifest["src/styles.css"].file`. The
+  shell now resolves it from the manifest. New `stylesEntry` option
+  (default `"src/styles.css"`) names the source file for both modes: dev
+  links `/<stylesEntry>`, prod the hashed file (fallback
+  `/static/styles.css`). `stylesHref` still wins when set.
+
+- **feat(types): `Entry` type exported from `hono-svelte`.** The generated
+  `.d.ts` now also augments the package (`interface Register { entries }`),
+  so helpers that forward an entry to `c.render` can be typed with
+  `import type { Entry } from "hono-svelte"` instead of importing the
+  generated file by relative path. Without the `.d.ts`, `Entry` is
+  `string`. A new `test/types.test.ts` runs `tsc` against the generated
+  declarations.
+
+- **fix(shell): the page's `<svelte:head>` title and description win.**
+  The shell always emitted its default `<title>` first and browsers use the
+  first one, so a static page's `<svelte:head><title>` was ignored (and
+  `shell({ head })` descriptions were duplicated). The document now keeps a
+  single title — `c.render(entry, { title })` > page/layout `<svelte:head>`
+  > `shell({ title })` — and a page description (`<svelte:head>` or
+  `head.description`) removes the one from `shell({ head })`.
+
+- **fix(assets): CSS of shared chunks is linked in production.** Vite
+  attaches a module's CSS to the chunk that owns it, so a layout or
+  component shared by several pages gets its own chunk + CSS file.
+  `manifestCssFor`/`manifestImportsFor` (and therefore `shell({ assets:
+  manifest })`) only read the entry chunk: pages rendered without their
+  layout's styles. Both now walk the static `imports` graph (shared chunks
+  first, cycles handled, `dynamicImports` skipped). `ViteManifestChunk`
+  gains the optional `src`, `name` and `dynamicImports` fields.
+- **fix(vite): static pages and layouts keep their `<style>` after `vite
+  build`.** Server-rendered components have no client bundle, but with
+  vite-plugin-svelte's default `emitCss: true` the compiler emits their CSS
+  as an import that SSR drops — zero-JS pages shipped unstyled. `pages()`
+  now loads static pages and layouts for the server with
+  `css: "injected"` (merged into an existing `<svelte:options>`, explicit
+  `css` respected), so `render()` returns the styles in `head`. New
+  `test/build.test.ts` exercises the real `vite build --ssr` pipeline.
+
+- **fix(scaffold): `isSafeAppPath` normalizes absolute targets.** An
+  absolute path such as `/app/../evil.ts` passed the in-root prefix check
+  on POSIX (only relative targets went through `resolve()`). Every target is
+  now resolved before the comparison.
+- **CI green on main**: the Windows-only `isSafeAppPath` assertions run only
+  on win32 (drive letters are relative segments on POSIX); the nested-layout
+  test uses its temp dir as the Vite root (it only passed on Windows because
+  tmpdir sits on another drive); the `example` job installs Bun, which its
+  build script calls.
+
+## 0.5.1
+
+- **Scaffold hardening** (`hono-svelte init`):
+  - the generated `package.json` pins the security floors
+    (`hono ^4.13.8`, `svelte ^5.57.0`, `vite ^8.3.0`) — the previous
+    `^4`/`^5`/`^8` ranges resolved versions with known advisories; a
+    regression test keeps the floors in sync with the package peers.
+  - `init` writes an initial `src/hono-svelte-entries.d.ts` stub
+    (plain-string renderer): `tsc` right after `init` used to fail on
+    `c.render(entry, props)` (2 args vs hono's 1-arg default renderer)
+    because the typed dts only exists after the first vite run;
+    `pages({ dts: true })` replaces the stub with the typed union on the
+    first `dev`/`build`.
+- **`c.render()` coexistence contract**: 6 tests pin the shell against
+  hono's renderer semantics — `c.render(string)` (default renderer) is
+  reinterpreted as an entry name under the shell (strict 500); renderer
+  middlewares on the same path pattern are last-registered-wins; and
+  **path-scoped coexistence works**: default-render routes and
+  jsxRenderer-style middlewares keep working next to a `shell()` mounted on
+  its own path (`app.use("/pages/*", shell())`). Documented in the README
+  ("Coexistence with other renderers").
+- **CI**: new `scaffold` job smoke-tests `init --full` end to end (install
+  with the local package via `file:` → typecheck → build), guarding the
+  inline templates against drift from the (unpublished) playground example.
+
+## 0.5.0
+
+- **Per-page data typing (opt-in, `pages({ dts: true })`)**: declare
+  `export type Data` (or `interface Data`) in a page's `<script module>` and
+  the generated `.d.ts` adds a typed overload per page —
+  `c.render("dashboard", { data })` is checked by `tsc` (a missing/mistyped
+  field fails the typecheck instead of shipping `undefined`). The declaration
+  is inlined verbatim, so it must be self-contained; types that reference
+  imports are skipped with a one-time warning and keep
+  `Record<string, unknown>` data. `RenderProps` is now generic
+  (`RenderProps<TData = Record<string, unknown>>`) and `pages().dataTypes()`
+  exposes the extractions. The dts also regenerates when a page's `Data`
+  type changes (dev watcher + `buildStart`).
+- **Neutral `<body>`**: the shell no longer hardcodes DaisyUI classes
+  (`bg-base-200 min-h-screen text-base-content`) — it emits a plain,
+  CSS-framework-agnostic document. Style `body`/`html` from your global
+  stylesheet instead (`body { background: var(--color-base-200); ... }`, or
+  `@apply` with Tailwind — the playground does exactly that in
+  `styles.css`). **Breaking** for apps relying on the hardcoded classes.
+- **`shell({ ssrFallback })`**: when SSR of a page throws at request time,
+  log the error and fall back to client rendering (entry script) instead of
+  a 500. Default `false` keeps the previous behavior.
+- `prefetch: "all"` / `"hover"` now emit `rel="modulepreload"` (prefetch on a
+  module URL could double-fetch in some browsers; modulepreload also warms
+  the entry's import graph).
+- `dataLimit` warning fires once per **(page, limit)** instead of once per
+  process — a second oversized page is reported too, with the entry name in
+  the message.
+- **Removed dead stubs**: `versionsMatch()` (always returned `true`), the
+  unused `hasClient` export from the ssr-manifest stub/virtual manifest, and
+  the no-op `checkPagesDir`. **Breaking: `versionsMatch` is no longer
+  exported.**
+- Fully typed handlers/middleware: `notFoundHandler()` / `errorHandler()`
+  match Hono's `NotFoundHandler`/`ErrorHandler` signatures and `shell()` no
+  longer uses `any` internally.
+- **CLI: `hono-svelte add page <name>`** — scaffolds
+  `src/pages/<name>.svelte` (static by default, skip-if-exists, traversal
+  refused). `isValidPageName()` / `newPageFile()` exported for tests.
+- Metadata: `engines` now declares `bun >= 1.4` and `node >= 26`, the
+  `./package.json` export subpath was added, and TypeScript 7 builds the
+  package.
+- **Security floors in `peerDependencies`**: `hono ^4.13.8`, `svelte ^5.57.0`,
+  `vite ^8.3.0` — every published advisory sits outside these floors
+  (hono < 4.12.12 and 4.12.0–4.12.33, patched in 4.12.34; svelte ≤ 5.55.6,
+  patched in 5.55.7; vite ≤ 8.0.15, patched in 8.0.16; transitive `devalue`
+  resolves to the patched 5.9.2, which also closes CVE-2026-81176). The
+  versions installed in the repo and in the example are the latest published
+  and none is affected by a known advisory — the ranges just avoid
+  advertising vulnerable versions to consumers and scanners.
+- CI: ubuntu + windows runners (Windows-only regressions like the old
+  `isSafeAppPath` bug are caught now), coverage via `@vitest/coverage-v8`
+  with thresholds (`npm test` runs it), all on the officially supported
+  runtimes (Node 26, TS 7, Vite 8, Bun 1.4+).
+- `hono-svelte init` now scaffolds TypeScript 7 + `@types/node` 26 in the
+  generated app.
+
+## 0.4.2
+
+- `hono-svelte init` now scaffolds a complete runnable app (works with
+  `npx`, `bunx` and `pnpm dlx` — writes text files only, no install/network).
+  Minimal flavor (default): `package.json`, `tsconfig.json`, `.gitignore`,
+  `vite.config.ts` (with `pages({ dts: true })`), two pages (`index` zero-JS,
+  `hello` with `data`), `src/routes/index.ts`, `src/styles.css`.
+  `init --full` adds auth (cookie session), dashboard with nested layout,
+  and typed RPC (`hc<AppType>`) — `/auth` → login → `/dashboard`.
+  Generated scripts (`dev`/`build`/`typecheck`/`start`) run under npm and bun.
+  `InitFlavor` type exported.
+
+## 0.4.1
+
+- Fix `hono-svelte init` refusing every file on Windows: `isSafeAppPath()`
+  now normalizes `\` vs `/` and compares case-insensitively on win32
+  (path traversal still blocked).
+- Fix `bin` path without `./` prefix — npm was silently stripping the CLI
+  from the published tarball.
+
+## 0.4.0
+
+- **Typed `c.render` entries (opt-in)**: `pages({ dts })` writes a `.d.ts` file
+  with the entry union (`HonoSvelteEntries`) + `declare module "hono"`
+  augmentation. `true` writes `src/hono-svelte-entries.d.ts` (relative to the
+  Vite root); a string sets a custom path. Regenerated on `buildStart` and by
+  the dev watcher when entries change. `dtsPath()` / `writeDts()` exposed on
+  the plugin. The playground wires it (`pages({ dts: true })` +
+  `/// <reference path="./hono-svelte-entries.d.ts" />` in `env.d.ts`), so a
+  typo in `c.render("...")` fails `tsc` instead of 500ing at runtime.
+  `data` stays `Record<string, unknown>` (per-page payload types are a future
+  feature).
+- **Layouts, single source of truth**: `<dir>/layout.svelte` wraps pages
+  automatically (SSR inside-out + client hydrate, `layouts()` /
+  `layoutChain()` to inspect, `layouts: false` = legacy ignore). Pages must
+  NOT import their layout manually — the plugin fails fast at build time
+  (`manually imports ... but the layout is applied automatically`) instead of
+  rendering the layout twice. Layout props (`title`, `description`) come from
+  the route via `c.render(entry, { data })`, with `title = "Dashboard"`
+  fallback in the layout. Rule shared by plugin and shell: static means
+  "no `<script>`", layouts don't matter; `__clientEntries` travels in the
+  virtual manifest so the shell picks the SSR branch for static+layouts pages.
+- **Runtime fixes**: static `import.meta.env.PROD/DEV` access (Vite module
+  runner forbids dynamic access — dev 500 fixed); static
+  `createRawSnippet` import in layout entries (no duplicated Svelte runtime —
+  `Illegal invocation` fixed); layout children snippet renders `<div>` wrapper
+  (empty render broke hydration — `Cannot set properties of null` fixed);
+  bundled server defaults to prod so plain `node ./dist/index.js` works on
+  Windows with no `NODE_ENV` prefix.
+- `c.render(entry, { status, headers, head })`: per-render status/headers
+  (merged over shell defaults) and CSP-safe per-page head tags
+  (`description`, `canonical`, `og`, `twitter`, `meta`, `extra`).
+- SSR static pages now receive `data` as component props (plus the embedded JSON).
+- Strict entries: unknown entryNames throw a dev-friendly error (`Available pages: ...`, generic in prod); `shell({ strict: false })` disables; `availableEntries()` exposes the list.
+- `pages().types()` / `typeDeclarations()` generate the entry union + hono module snippet.
+- Nested layouts: `<dir>/layout.svelte` wraps pages (SSR inside-out, `layouts()`/`layoutChain()`, `layouts: false` = legacy).
+- `notFoundHandler()` / `errorHandler()` for conventional `404.svelte` / `500.svelte` pages.
+- `hono-svelte init|doctor` CLI (`bin`) with `--app` flag.
+- `pages().validateConfig()` fails fast on missing svelte plugin / pagesDir.
+- `shell({ assets })` accepts a Vite manifest (hashed URLs, CSS, shared-chunk preload) with fallback; `preload`/`prefetch` controls; `styles` extra CSS.
+- `shell({ nonce })` CSP support on shell tags; `svelte/server` CSP passthrough for SSR.
+- Cache helpers: `immutableHeaders()`, `CACHE_IMMUTABLE`, `CACHE_NO_STORE`.
+- `data` size one-time warning (`shell({ dataLimit })`, default 100KB).
+
+## 0.3.1
+
+- Package metadata: repository/homepage/author, publishConfig, LICENSE + CHANGELOG in files.
+- No code changes since 0.3.0.
+
+## 0.3.0
+
+- Fully in-memory package: entries and manifest are virtual modules (no files written to disk).
+- Automatic zero-JS: `.svelte` pages without `<script>` render on the server (`svelte/server`)
+  and download no JS on the client.
+- Deterministic opaque IDs derived from the entryName (no salt, no env, no disk).
+- Zero config: the shell resolves the SSR map on its own (relative import redirected by the plugin).
+- Test suite (vitest) and CI (typecheck + tests + build + publint).
+
+## 0.2.0
+
+- Opaque IDs (`r-` + hash) replace configurable `rootId`/`dataId`.
+
+## 0.1.0
+
 - First version: `shell()` middleware + `pages()` plugin with disk-generated entries.