@void/solid 0.0.0

package/README.md

@@ -0,0 +1,116 @@
+# @void/solid
+
+Solid adapter for Void Pages mode.
+
+## Setup
+
+```ts
+import { defineConfig } from 'vite';
+import { voidPlugin } from 'void';
+import { voidSolid } from '@void/solid/plugin';
+
+export default defineConfig({
+  plugins: [voidPlugin(), voidSolid()],
+});
+```
+
+## Plugin
+
+`voidSolid(options?)` returns:
+
+- `vite-plugin-solid`
+- the Solid pages plugin
+- the Solid islands plugin
+
+Options:
+
+- `solid?` — forwarded to `vite-plugin-solid`
+- `viewTransitions?` — enable View Transitions for SPA navigation
+- `prefetch?` — link prefetch behavior
+
+## Runtime
+
+Main runtime APIs live at `@void/solid`:
+
+- `Link`
+- `useRouter()`
+- `useNavigation()`
+- `useShared()`
+- `useForm()`
+- `useIslandForm()`
+- `action()`
+
+### Link
+
+`Link` renders an `<a>` for GET navigation and a `<button>` for mutation methods:
+
+```tsx
+<Link href="/users" data={{ page: 2, tag: ['active', 'new'] }}>Filtered users</Link>
+<Link href="/users" replace>Users</Link>
+<Link href="/logout" reloadDocument>Sign out</Link>
+```
+
+GET `data` is merged into the rendered `href` query string. Primitive values are serialized with `String(value)`, arrays become repeated keys, `null` and `undefined` are omitted, and nested objects throw.
+
+`prefetch` and `reloadDocument` are GET-only and throw for mutation links. `onNavigate` can cancel client-side navigation by calling `event.preventDefault()`.
+
+### Forms
+
+`useForm()` tracks form state for Pages actions. Use `pending` for in-flight
+state, `errors` for field validation, and `error` for non-validation call-site
+failures. The submit helpers return promises so boundary-class failures can
+propagate through Solid async error handling or explicit `catch` handlers.
+
+```tsx
+import { useForm } from '@void/solid';
+
+export default function CreateUser() {
+  const form = useForm('/users', { name: '', email: '' });
+
+  return (
+    <form
+      onSubmit={(event) => {
+        event.preventDefault();
+        return form.post();
+      }}
+    >
+      <input
+        name="name"
+        value={form.data.name}
+        onInput={(event) => form.setData('name', event.currentTarget.value)}
+      />
+      {form.errors.name && <p>{form.errors.name}</p>}
+      {form.error && <p>{form.error.message}</p>}
+      <button disabled={form.pending}>Save</button>
+    </form>
+  );
+}
+```
+
+Use `action()` for the awaitable imperative escape hatch. It returns
+`{ ok: true, pageData }` or `{ ok: false, error }` for call-site action errors,
+while boundary-class failures are thrown. `action()` uses `POST` by default and
+accepts `{ method: "PUT" | "PATCH" | "DELETE" }`.
+
+## Pages
+
+Pages are `.tsx` files in `pages/` with companion `.server.ts` files:
+
+```tsx
+export default function Home(props: { title: string }) {
+  return <h1>{props.title}</h1>;
+}
+```
+
+```ts
+import { defineHandler } from 'void';
+
+export const loader = defineHandler(() => ({ title: 'Home' }));
+```
+
+## Tests
+
+- `test/unit/use-form.test.ts`
+- `test/integration/solid-pages-playground.test.ts`
+
+The Solid integration test covers both SSR output and browser-side navigation/forms.

package/dist/plugin.d.mts

@@ -0,0 +1,16 @@
+import solid from "vite-plugin-solid";
+import { Plugin } from "vite";
+
+//#region src/plugin.d.ts
+interface PrefetchConfig {
+  hoverDelay?: number;
+  cacheFor?: number | string | [string, string];
+}
+interface VoidSolidOptions {
+  solid?: Parameters<typeof solid>[0];
+  viewTransitions?: boolean;
+  prefetch?: PrefetchConfig;
+}
+declare function voidSolid(options?: VoidSolidOptions): Array<Plugin>;
+//#endregion
+export { VoidSolidOptions, voidSolid };