refactor: Drop hydrate export

Author: rschristian

README.md

@@ -50,6 +50,7 @@ const App = () => (
 Primarily meant for use with prerendering via [`@preact/preset-vite`](https://github.com/preactjs/preset-vite#prerendering-configuration) or other prerendering systems that share the API. If you're server-side rendering your app via any other method, you can use `preact-render-to-string` (specifically `renderToStringAsync()`) directly.
 
 ```js
+import { render, hydrate } from 'preact';
 import { LocationProvider, ErrorBoundary, Router, lazy, prerender as ssr } from 'preact-iso';
 
 // Asynchronous (throws a promise)
@@ -65,7 +66,10 @@ const App = () => (
 	</LocationProvider>
 );
 
-hydrate(<App />);
+if (typeof window !== 'undefined') {
+	const target = document.getElementById('app');
+	import.meta.env.DEV ? render(<App />, target) : hydrate(<App />, target);
+}
 
 export async function prerender(data) {
 	return await ssr(<App />);
@@ -322,31 +326,6 @@ const App = () => (
 );
 ```
 
-### `hydrate`
-
-A thin wrapper around Preact's `hydrate` export, it switches between hydrating and rendering the provided element, depending on whether the current page has been prerendered. Additionally, it checks to ensure it's running in a browser context before attempting any rendering, making it a no-op during SSR.
-
-Pairs with the `prerender()` function.
-
-Params:
-
-  - `jsx: ComponentChild` - The JSX element or component to render
-  - `parent?: Element | Document | ShadowRoot | DocumentFragment` - The parent element to render into. Defaults to `document.body` if not provided.
-
-```js
-import { hydrate } from 'preact-iso';
-
-const App = () => (
-	<div class="app">
-		<h1>Hello World</h1>
-	</div>
-);
-
-hydrate(<App />);
-```
-
-However, it is just a simple utility method. By no means is it essential to use, you can always use Preact's `hydrate` export directly.
-
 ### `prerender`
 
 Renders a Virtual DOM tree to an HTML string using `preact-render-to-string`. The Promise returned from `prerender()` resolves to an Object with `html` and `links[]` properties. The `html` property contains your pre-rendered static HTML markup, and `links` is an Array of any non-external URL strings found in links on the generated page.

src/hydrate.d.ts

@@ -1,3 +1,2 @@
-export * from './router.js';
 export * from './lazy.js';
-export * from './hydrate.js';
+export * from './router.js';

src/hydrate.js

@@ -1,3 +1,2 @@
-export * from './hydrate.js';
 export * from './lazy.js';
 export * from './router.js';

src/index.d.ts

@@ -25,16 +25,15 @@ export async function prerender(vnode, options) {
 		vnode = cloneElement(vnode, props);
 	}
 
-	let links = new Set();
+	const links = new Set();
 	vnodeHook = ({ type, props }) => {
 		if (type === 'a' && props && props.href && (!props.target || props.target === '_self')) {
 			links.add(props.href);
 		}
 	};
 
 	try {
-		let html = await renderToStringAsync(vnode);
-		html += `<script id="isodata"></script>`;
+		const html = await renderToStringAsync(vnode);
 		return { html, links };
 	} finally {
 		vnodeHook = null;

src/index.js

@@ -20,10 +20,4 @@ test('extracts links', async () => {
 	assert.ok(links.has('/baz'), `missing: /baz`);
 });
 
-test('appends iso data script', async () => {
-	const { html: h } = await prerender(html`<div />`);
-	// Empty for now, but used for hydration vs render detection
-	assert.match(h, /<script id="isodata"><\/script>/, 'missing iso data script tag');
-});
-
 test.run();