@vidact/start 0.2.0-beta.0 → 0.2.0-beta.10

package/CHANGELOG.md

@@ -1,5 +1,114 @@
 # @vidact/start
 
+## 0.2.0-beta.10
+
+### Patch Changes
+
+- c2c7f1d: Prefetch routes on intent. `Link` now fetches the destination's snapshot and route modules when the pointer rests on it for 50 ms, when it receives focus, or when it is pressed, and the following click reuses that snapshot for up to 30 seconds. Hover and focus prefetching pause while the browser's data saver is on. Opt a link out with `prefetch="none"`, or prefetch from code with `client.prefetch(to)`. Navigations also start downloading route modules alongside the snapshot request instead of after it.
+- @vidact/runtime@0.2.0-beta.10
+  - @vidact/vite@0.2.0-beta.10
+
+## 0.2.0-beta.9
+
+### Patch Changes
+
+- @vidact/vite@0.2.0-beta.9
+  - @vidact/runtime@0.2.0-beta.9
+
+## 0.2.0-beta.8
+
+### Patch Changes
+
+- Updated dependencies [e480658]
+  - @vidact/runtime@0.2.0-beta.8
+  - @vidact/vite@0.2.0-beta.8
+
+## 0.2.0-beta.7
+
+### Patch Changes
+
+- 5d2dd5d: Preserve destination fragments through successful client navigation and redirects.
+- 977b90f: Retain unchanged Start route owners and update their loader, parameter, URL, and child props during client navigation.
+- d35d98f: Stream the Start document shell before pending application resources and support streaming custom document shells.
+- 8ce4ca8: Separate cached document and client-navigation responses with a Vary header.
+- Updated dependencies [ed60a1c]
+- Updated dependencies [977b90f]
+- Updated dependencies [9581420]
+  - @vidact/runtime@0.2.0-beta.7
+  - @vidact/vite@0.2.0-beta.7
+
+## 0.2.0-beta.6
+
+### Patch Changes
+
+- @vidact/vite@0.2.0-beta.6
+  - @vidact/runtime@0.2.0-beta.6
+
+## 0.2.0-beta.5
+
+### Patch Changes
+
+- f7fe490: Hydration fixes for server-rendered content the client cannot reproduce immediately.
+
+  - Keep hydration markers out of raw-text elements. The server no longer emits `<!--vidact:v1:*-->` comments inside `<textarea>`, `<title>`, `<script>` and `<style>`, where the HTML parser turned them into literal text that stayed visible until hydration recovered from the mismatch. The hydrator synthesizes those markers around the element's parsed text node instead, so such elements hydrate in place.
+  - Dehydrated Suspense boundaries. When a Suspense child suspends while hydrating server-rendered content — a `lazy` chunk that has not loaded yet, for example — the boundary now keeps the server DOM on screen and swaps in the client render once the resource resolves, instead of publishing the fallback over it, mismatching, and re-mounting the whole root.
+  - `@vidact/start` renders the route tree inside a root component on the server. The client mounts the application under a compiled root of its own, which claims a component marker range; without a matching server root every client component claimed the range of the _next_ server component, which surfaced as a hydration mismatch (and a visible fallback flash) on any route whose component has more than one return.
+  - `hydrateStart` accepts `onRecoverableError`, and warns on the console by default when hydration has to recover by re-rendering. A silent recovery looks like a working page that merely flashes.
+  - Hydration mismatch messages describe the element (`DIV.class[data-x]`) instead of just its tag.
+  - Element claiming no longer prefers a candidate that contains an array marker unless the pending structural child is a list. A conditional or Suspense child triggered the same bias, so a class-less wrapper `<div>{cond ? <A/> : <B/>}</div>` could claim an unrelated sibling that happened to hold a keyed list.
+
+  - Hydration marker protocol `v2`. The server no longer wraps intrinsic elements (`s`) or scalar text (`t`) in marker comments — inside a child slot an element can only be the intrinsic child and a text node the scalar, so the hydrator infers them, splitting a text node that adjacent scalars parsed into. A scalar binding borrows its child-slot markers as its range (no DOM writes) and only creates anchor comments where there is nothing to borrow, such as inside `<textarea>`. The prefix shrank from `vidact:v1` to `v2`; together this removes about 40% of markers and 60% of marker bytes from server HTML. A `v1` render is rejected by a `v2` client and re-rendered, and vice versa.
+
+- Updated dependencies [f7fe490]
+  - @vidact/runtime@0.2.0-beta.5
+  - @vidact/vite@0.2.0-beta.5
+
+## 0.2.0-beta.4
+
+### Patch Changes
+
+- 917f0be: Re-release CLI
+- Updated dependencies [917f0be]
+  - @vidact/runtime@0.2.0-beta.4
+  - @vidact/vite@0.2.0-beta.4
+
+## 0.2.0-beta.3
+
+### Patch Changes
+
+- 917f0be: Release vidact CLI
+- Updated dependencies [917f0be]
+  - @vidact/runtime@0.2.0-beta.3
+  - @vidact/vite@0.2.0-beta.3
+
+## 0.2.0-beta.2
+
+### Patch Changes
+
+- 9b7d659: Build every package with `tsdown` in unbundle mode instead of `tsc` plus two
+  repository scripts. `dist` still mirrors `src` file for file, with the same entry
+  points, ESM output, declarations, declaration maps, and source maps, and the
+  runtime's tree-shaking budgets are unchanged. The Vidact Start ambient route
+  module ships as written so it stays an ambient declaration rather than a module
+  augmentation.
+
+  Packages now publish their `src` directory, so the shipped source maps and
+  declaration maps resolve. Vite no longer reports "points to missing source
+  files" for Vidact modules, debugging steps into real TypeScript, and go-to-
+  definition lands on the source rather than the declaration.
+
+- Updated dependencies [9b7d659]
+  - @vidact/runtime@0.2.0-beta.2
+  - @vidact/vite@0.2.0-beta.2
+
+## 0.2.0-beta.1
+
+### Patch Changes
+
+- Updated dependencies [7765e99]
+  - @vidact/runtime@0.2.0-beta.1
+  - @vidact/vite@0.2.0-beta.1
+
 ## 0.2.0-beta.0
 
 ### Minor Changes

package/README.md

@@ -45,8 +45,8 @@ application. Route components must be named functions so the Vidact compiler
 can identify and lower them.
 
 `Link` renders an ordinary anchor during SSR. After hydration, unmodified clicks
-on same-origin Start routes request a server loader snapshot, replace the owned
-route root, and update browser history without loading another document.
+on same-origin Start routes request a server loader snapshot, update the retained
+route chain, and update browser history without loading another document.
 External URLs, downloads, modified clicks, `target` links, hash-only links, and
 links with `reloadDocument` retain native browser behavior. Use `replace` to
 replace the current history entry.
@@ -60,6 +60,27 @@ replace the current history entry.
 `hydrateStart()` returns a `StartClient` whose `navigate()` method provides the
 same behavior for programmatic navigation.
 
-This first navigation contract replaces the owned route root atomically, so
-component-local state in shared layouts resets. Retaining unchanged layout
-owners is a follow-up routing contract.
+Links prefetch their route on intent: after the pointer rests on them for 50 ms,
+on focus, or on press. The next navigation to that path and search reuses the
+prefetched snapshot for up to 30 seconds. Use `prefetch="none"` to opt a link
+out, or `client.prefetch(to)` to prefetch from code. Hover and focus prefetching
+pause while the browser's data saver is on.
+
+Document HTML and client-navigation snapshots share the same route URL. Start
+marks both successful representations with `Vary: x-vidact-start-navigation`,
+so HTTP caches that honor `Vary` keep them separate. Deployments must preserve
+that response header when adding their own caching rules.
+
+The built-in document streams its opening shell as soon as loaders settle. The
+marker-complete application follows after its async resources settle, then the
+snapshot and client script close the document. `renderDocumentShell` customizes
+the strings before and after the application while preserving this behavior.
+The older `renderDocument` callback still receives one `applicationHtml` string
+and therefore buffers the application before returning a response.
+
+Start retains the longest common prefix of component-bearing route entries.
+Those components keep their DOM, local state, refs, and effects while their
+`loaderData`, `params`, `requestUrl`, and `children` props update. The first
+changed route entry and all descendants are staged as a new owned suffix, then
+the previous suffix is disposed. Routes without a component do not establish a
+DOM owner.

package/dist/client.d.ts

@@ -1,20 +1,33 @@
-import { type CompiledRoot } from '@vidact/runtime';
-import { type RouteManifest, type StartComponent } from './router.js';
-export interface HydrateStartOptions {
-    readonly fetch?: typeof globalThis.fetch;
-    readonly manifest: RouteManifest;
-    readonly root?: ParentNode;
-    readonly rootId?: string;
-    readonly snapshot?: string;
-    readonly snapshotId?: string;
+import { RouteManifest, StartComponent } from "./router.js";
+import { CompiledRoot } from "@vidact/runtime";
+//#region src/client.d.ts
+interface HydrateStartOptions {
+  readonly fetch?: typeof globalThis.fetch;
+  readonly manifest: RouteManifest;
+  /**
+   * Called when hydration could not attach to the server DOM and the root was rendered
+   * client-side instead. Defaults to a console warning: a silent recovery looks like a
+   * working page that merely flashes, and is far harder to notice than a warning.
+   */
+  readonly onRecoverableError?: (error: unknown) => void;
+  readonly root?: ParentNode;
+  readonly rootId?: string;
+  readonly snapshot?: string;
+  readonly snapshotId?: string;
 }
-export interface StartNavigateOptions {
-    readonly replace?: boolean;
-    readonly scroll?: boolean;
+interface StartNavigateOptions {
+  readonly replace?: boolean;
+  readonly scroll?: boolean;
 }
-export interface StartClient extends CompiledRoot {
-    readonly navigate: (to: string | URL, options?: StartNavigateOptions) => Promise<boolean>;
+interface StartClient extends CompiledRoot {
+  readonly navigate: (to: string | URL, options?: StartNavigateOptions) => Promise<boolean>;
+  /**
+   * Fetches the route's snapshot and code ahead of a navigation. A navigation to the same
+   * path and search within 30 seconds uses the prefetched snapshot instead of a new request.
+   */
+  readonly prefetch: (to: string | URL) => Promise<void>;
 }
-export declare function hydrateStart(options: HydrateStartOptions): Promise<StartClient>;
-export type { StartComponent };
+declare function hydrateStart(options: HydrateStartOptions): Promise<StartClient>;
+//#endregion
+export { HydrateStartOptions, StartClient, type StartComponent, StartNavigateOptions, hydrateStart };
 //# sourceMappingURL=client.d.ts.map

package/dist/client.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAAA,OAAO,EAKL,KAAK,YAAY,EAClB,MAAM,iBAAiB,CAAA;AAGxB,OAAO,EAKL,KAAK,aAAa,EAClB,KAAK,cAAc,EACpB,MAAM,aAAa,CAAA;AAUpB,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,UAAU,CAAC,KAAK,CAAA;IACxC,QAAQ,CAAC,QAAQ,EAAE,aAAa,CAAA;IAChC,QAAQ,CAAC,IAAI,CAAC,EAAE,UAAU,CAAA;IAC1B,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAA;IACxB,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;IAC1B,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAA;CAC7B;AAED,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,CAAA;IAC1B,QAAQ,CAAC,MAAM,CAAC,EAAE,OAAO,CAAA;CAC1B;AAED,MAAM,WAAW,WAAY,SAAQ,YAAY;IAC/C,QAAQ,CAAC,QAAQ,EAAE,CAAC,EAAE,EAAE,MAAM,GAAG,GAAG,EAAE,OAAO,CAAC,EAAE,oBAAoB,KAAK,OAAO,CAAC,OAAO,CAAC,CAAA;CAC1F;AAID,wBAAsB,YAAY,CAAC,OAAO,EAAE,mBAAmB,GAAG,OAAO,CAAC,WAAW,CAAC,CAqIrF;AAkFD,YAAY,EAAE,cAAc,EAAE,CAAA"}
+{"version":3,"file":"client.d.ts","names":[],"sources":["../src/client.ts"],"mappings":";;;UAqCiB;WACN,eAAe,WAAW;WAC1B,UAAU;;;;;;WAMV,sBAAsB;WACtB,OAAO;WACP;WACA;WACA;;UAGM;WACN;WACA;;UAGM,oBAAoB;WAC1B,WAAW,aAAa,KAAK,UAAU,yBAAyB;;;;;WAKhE,WAAW,aAAa,QAAQ;;iBAkCrB,aAAa,SAAS,sBAAsB,QAAQ"}