@useavalon/avalon 0.1.11 → 0.1.13

package/src/build/sidecar-file-manager.ts

@@ -1,104 +1,104 @@
-import path from "node:path";
-import { readFile, writeFile, unlink, stat } from "node:fs/promises";
-
-/**
- * Supported compound extensions for island files, ordered longest-first
- * so that `.solid.tsx` matches before `.tsx`.
- *
- * Sidecar naming strategy per extension type:
- * - `.vue`, `.svelte`  → `Name.d.vue.ts`, `Name.d.svelte.ts`
- *   (foreign extensions — allowArbitraryExtensions picks these up)
- * - `.lit.ts`          → `Name.lit.d.ts`
- *   (TypeScript declaration file lookup: for `Name.lit.ts` TS looks for `Name.lit.d.ts`)
- * - `.solid.tsx`       → `Name.solid.d.ts`
- *   (TypeScript declaration file lookup: for `Name.solid.tsx` TS looks for `Name.solid.d.ts`)
- * - `.qwik.tsx`        → `Name.qwik.d.ts`
- *   (same as solid.tsx)
- */
-const COMPOUND_EXTENSIONS = [".solid.tsx", ".qwik.tsx", ".lit.ts", ".svelte", ".vue"];
-
-/**
- * Extensions where TypeScript's native `.d.ts` declaration lookup applies.
- * For `Name.lit.ts`, TS looks for `Name.lit.d.ts`.
- * For `Name.solid.tsx` / `Name.qwik.tsx`, TS looks for `Name.solid.d.ts` / `Name.qwik.d.ts`.
- */
-const NATIVE_DECL_EXTENSIONS = new Set([".lit.ts", ".solid.tsx", ".qwik.tsx"]);
-
-/**
- * Compute the sidecar declaration file path for a given island file path.
- *
- * For simple extensions like `.vue`, the sidecar is `Name.d.vue.ts`.
- * For compound extensions like `.lit.ts`, the sidecar is `Name.d.lit.ts`.
- * For `.solid.tsx`, the sidecar is `Name.d.solid.tsx.ts`.
- */
-export function getSidecarPath(islandFilePath: string): string {
-	const dir = path.dirname(islandFilePath);
-	const basename = path.basename(islandFilePath);
-
-	for (const ext of COMPOUND_EXTENSIONS) {
-		if (basename.endsWith(ext)) {
-			const name = basename.slice(0, -ext.length);
-			if (NATIVE_DECL_EXTENSIONS.has(ext)) {
-				// For .lit.ts → Name.lit.d.ts  (TS declaration file lookup)
-				// For .solid.tsx / .qwik.tsx → Name.solid.d.ts / Name.qwik.d.ts
-				const innerExt = ext.endsWith(".ts") ? ext.slice(0, -3) : ext.slice(0, -4); // strip .ts or .tsx
-				return path.join(dir, `${name}${innerExt}.d.ts`);
-			}
-			// For .vue/.svelte → Name.d.vue.ts / Name.d.svelte.ts (allowArbitraryExtensions)
-			return path.join(dir, `${name}.d${ext}.ts`);
-		}
-	}
-
-	// Fallback
-	const ext = path.extname(islandFilePath);
-	const name = basename.slice(0, -ext.length);
-	return path.join(dir, `${name}.d${ext}.ts`);
-}
-
-/**
- * Check if a sidecar file is up-to-date by comparing mtimes.
- * Returns `true` if the sidecar exists and is newer than the source file.
- */
-export async function isSidecarFresh(sourcePath: string, sidecarPath: string): Promise<boolean> {
-	try {
-		const [sourceStat, sidecarStat] = await Promise.all([
-			stat(sourcePath),
-			stat(sidecarPath),
-		]);
-		return sidecarStat.mtimeMs >= sourceStat.mtimeMs;
-	} catch {
-		return false;
-	}
-}
-
-/**
- * Write sidecar content only if it differs from the existing file.
- * Returns `true` if a write was performed, `false` if content was already up-to-date.
- */
-export async function writeSidecarIfChanged(sidecarPath: string, content: string): Promise<boolean> {
-	try {
-		const existing = await readFile(sidecarPath, "utf-8");
-		if (existing === content) {
-			return false;
-		}
-	} catch {
-		// File doesn't exist yet — that's fine, we'll write it
-	}
-
-	await writeFile(sidecarPath, content, "utf-8");
-	return true;
-}
-
-/**
- * Delete a sidecar file if it exists.
- * Returns `true` if a file was deleted, `false` if it didn't exist.
- */
-export async function deleteSidecar(sidecarPath: string): Promise<boolean> {
-	try {
-		await unlink(sidecarPath);
-		return true;
-	} catch {
-		return false;
-	}
-}
-
+import path from "node:path";
+import { readFile, writeFile, unlink, stat } from "node:fs/promises";
+
+/**
+ * Supported compound extensions for island files, ordered longest-first
+ * so that `.solid.tsx` matches before `.tsx`.
+ *
+ * Sidecar naming strategy per extension type:
+ * - `.vue`, `.svelte`  → `Name.d.vue.ts`, `Name.d.svelte.ts`
+ *   (foreign extensions — allowArbitraryExtensions picks these up)
+ * - `.lit.ts`          → `Name.lit.d.ts`
+ *   (TypeScript declaration file lookup: for `Name.lit.ts` TS looks for `Name.lit.d.ts`)
+ * - `.solid.tsx`       → `Name.solid.d.ts`
+ *   (TypeScript declaration file lookup: for `Name.solid.tsx` TS looks for `Name.solid.d.ts`)
+ * - `.qwik.tsx`        → `Name.qwik.d.ts`
+ *   (same as solid.tsx)
+ */
+const COMPOUND_EXTENSIONS = [".solid.tsx", ".qwik.tsx", ".lit.ts", ".svelte", ".vue"];
+
+/**
+ * Extensions where TypeScript's native `.d.ts` declaration lookup applies.
+ * For `Name.lit.ts`, TS looks for `Name.lit.d.ts`.
+ * For `Name.solid.tsx` / `Name.qwik.tsx`, TS looks for `Name.solid.d.ts` / `Name.qwik.d.ts`.
+ */
+const NATIVE_DECL_EXTENSIONS = new Set([".lit.ts", ".solid.tsx", ".qwik.tsx"]);
+
+/**
+ * Compute the sidecar declaration file path for a given island file path.
+ *
+ * For simple extensions like `.vue`, the sidecar is `Name.d.vue.ts`.
+ * For compound extensions like `.lit.ts`, the sidecar is `Name.d.lit.ts`.
+ * For `.solid.tsx`, the sidecar is `Name.d.solid.tsx.ts`.
+ */
+export function getSidecarPath(islandFilePath: string): string {
+	const dir = path.dirname(islandFilePath);
+	const basename = path.basename(islandFilePath);
+
+	for (const ext of COMPOUND_EXTENSIONS) {
+		if (basename.endsWith(ext)) {
+			const name = basename.slice(0, -ext.length);
+			if (NATIVE_DECL_EXTENSIONS.has(ext)) {
+				// For .lit.ts → Name.lit.d.ts  (TS declaration file lookup)
+				// For .solid.tsx / .qwik.tsx → Name.solid.d.ts / Name.qwik.d.ts
+				const innerExt = ext.endsWith(".ts") ? ext.slice(0, -3) : ext.slice(0, -4); // strip .ts or .tsx
+				return path.join(dir, `${name}${innerExt}.d.ts`);
+			}
+			// For .vue/.svelte → Name.d.vue.ts / Name.d.svelte.ts (allowArbitraryExtensions)
+			return path.join(dir, `${name}.d${ext}.ts`);
+		}
+	}
+
+	// Fallback
+	const ext = path.extname(islandFilePath);
+	const name = basename.slice(0, -ext.length);
+	return path.join(dir, `${name}.d${ext}.ts`);
+}
+
+/**
+ * Check if a sidecar file is up-to-date by comparing mtimes.
+ * Returns `true` if the sidecar exists and is newer than the source file.
+ */
+export async function isSidecarFresh(sourcePath: string, sidecarPath: string): Promise<boolean> {
+	try {
+		const [sourceStat, sidecarStat] = await Promise.all([
+			stat(sourcePath),
+			stat(sidecarPath),
+		]);
+		return sidecarStat.mtimeMs >= sourceStat.mtimeMs;
+	} catch {
+		return false;
+	}
+}
+
+/**
+ * Write sidecar content only if it differs from the existing file.
+ * Returns `true` if a write was performed, `false` if content was already up-to-date.
+ */
+export async function writeSidecarIfChanged(sidecarPath: string, content: string): Promise<boolean> {
+	try {
+		const existing = await readFile(sidecarPath, "utf-8");
+		if (existing === content) {
+			return false;
+		}
+	} catch {
+		// File doesn't exist yet — that's fine, we'll write it
+	}
+
+	await writeFile(sidecarPath, content, "utf-8");
+	return true;
+}
+
+/**
+ * Delete a sidecar file if it exists.
+ * Returns `true` if a file was deleted, `false` if it didn't exist.
+ */
+export async function deleteSidecar(sidecarPath: string): Promise<boolean> {
+	try {
+		await unlink(sidecarPath);
+		return true;
+	} catch {
+		return false;
+	}
+}
+

package/src/build/sidecar-renderer.ts

@@ -1,30 +1,30 @@
-/** Header comment placed at the top of every generated sidecar file. */
-export const SIDECAR_HEADER = "// Auto-generated by avalon — do not edit";
-
-/**
- * Render the full content of a sidecar declaration file.
- *
- * Pure function: takes a props type string (e.g. `"{ count: number }"` or
- * `"Record<string, unknown>"`) and returns the complete file content.
- *
- * The `island` prop is always included so the component can be used with
- * `<Component island={{ condition: 'on:interaction' }} />` in page files.
- * The Vite page-island-transform strips it at build time.
- *
- * The output follows this exact template:
- * ```
- * // Auto-generated by avalon — do not edit
- * import type { ComponentType } from 'preact';
- * import type { IslandDirective } from '@useavalon/avalon';
- * declare const component: ComponentType<PROPS & { island?: IslandDirective }>;
- * export default component;
- * ```
- */
-export function renderSidecarContent(propsType: string): string {
-	return `${SIDECAR_HEADER}
-import type { ComponentType } from 'preact';
-import type { IslandDirective } from '@useavalon/avalon';
-declare const component: ComponentType<${propsType} & { island?: IslandDirective }>;
-export default component;
-`;
-}
+/** Header comment placed at the top of every generated sidecar file. */
+export const SIDECAR_HEADER = "// Auto-generated by avalon — do not edit";
+
+/**
+ * Render the full content of a sidecar declaration file.
+ *
+ * Pure function: takes a props type string (e.g. `"{ count: number }"` or
+ * `"Record<string, unknown>"`) and returns the complete file content.
+ *
+ * The `island` prop is always included so the component can be used with
+ * `<Component island={{ condition: 'on:interaction' }} />` in page files.
+ * The Vite page-island-transform strips it at build time.
+ *
+ * The output follows this exact template:
+ * ```
+ * // Auto-generated by avalon — do not edit
+ * import type { ComponentType } from 'preact';
+ * import type { IslandDirective } from '@useavalon/avalon';
+ * declare const component: ComponentType<PROPS & { island?: IslandDirective }>;
+ * export default component;
+ * ```
+ */
+export function renderSidecarContent(propsType: string): string {
+	return `${SIDECAR_HEADER}
+import type { ComponentType } from 'preact';
+import type { IslandDirective } from '@useavalon/avalon';
+declare const component: ComponentType<${propsType} & { island?: IslandDirective }>;
+export default component;
+`;
+}

package/src/client/adapters/index.ts

@@ -1,13 +1,21 @@
-/**
- * Framework HMR Adapters
- * 
- * Exports all framework-specific HMR adapters for easy registration
- */
-
-export { ReactHMRAdapter, reactAdapter } from './react-adapter.ts';
-export { PreactHMRAdapter, preactAdapter } from './preact-adapter.ts';
-export { VueHMRAdapter, vueAdapter } from './vue-adapter.ts';
-export { SvelteHMRAdapter, svelteAdapter } from './svelte-adapter.ts';
-export { SolidHMRAdapter, solidAdapter } from './solid-adapter.ts';
-export { LitHMRAdapter, litAdapter } from './lit-adapter.ts';
-export { QwikHMRAdapter, qwikAdapter } from './qwik-adapter.ts';
+/**
+ * Framework HMR Adapters
+ *
+ * HMR adapters have been moved to their respective integration packages:
+ * - @useavalon/react/client/hmr
+ * - @useavalon/preact/client/hmr
+ * - @useavalon/vue/client/hmr
+ * - @useavalon/svelte/client/hmr
+ * - @useavalon/solid/client/hmr
+ * - @useavalon/lit/client/hmr
+ * - @useavalon/qwik/client/hmr
+ *
+ * This barrel re-exports from the base framework adapter for backward compatibility.
+ */
+
+export {
+	BaseFrameworkAdapter,
+	AdapterRegistry,
+	type FrameworkHMRAdapter,
+	type StateSnapshot,
+} from '../framework-adapter.ts';

package/src/client/components.ts

@@ -1,35 +1,35 @@
-/**
- * Client-safe component exports for use in island components.
- *
- * Import from '@useavalon/avalon/client' instead of '@useavalon/avalon' when
- * you need framework components inside islands. The main entry point
- * re-exports server-only code (nitro, h3, vite plugins) that can't
- * be bundled for the browser.
- */
-
-// Persistent islands
-export { PersistentIsland } from '../components/PersistentIsland.tsx';
-export {
-	usePersistentIslandContext,
-	PersistentIslandProvider,
-	createPersistentIslandContext,
-} from '../core/islands/persistent-island-context.tsx';
-export { usePersistentState } from '../core/islands/use-persistent-state.ts';
-export { IslandPersistence, defaultIslandPersistence } from '../core/islands/island-persistence.ts';
-export { IslandStateSerializer } from '../core/islands/island-state-serializer.ts';
-
-// Error boundaries
-export { IslandErrorBoundary, withIslandErrorBoundary } from '../components/IslandErrorBoundary.tsx';
-export { LayoutErrorBoundary } from '../components/LayoutErrorBoundary.tsx';
-export { LayoutDataErrorBoundary } from '../components/LayoutDataErrorBoundary.tsx';
-export { StreamingErrorBoundary, withStreamingErrorBoundary } from '../components/StreamingErrorBoundary.tsx';
-
-// Streaming
-export { StreamingLayout, StreamingSuspense, withStreaming, useStreamingState } from '../components/StreamingLayout.tsx';
-
-// Image optimization
-export { Image } from '../components/Image.tsx';
-export type { ImageProps } from '../components/Image.tsx';
-
-// Types
-export type { IslandState } from '../schemas/layout.ts';
+/**
+ * Client-safe component exports for use in island components.
+ *
+ * Import from '@useavalon/avalon/client' instead of '@useavalon/avalon' when
+ * you need framework components inside islands. The main entry point
+ * re-exports server-only code (nitro, h3, vite plugins) that can't
+ * be bundled for the browser.
+ */
+
+// Persistent islands
+export { PersistentIsland } from '../components/PersistentIsland.tsx';
+export {
+	usePersistentIslandContext,
+	PersistentIslandProvider,
+	createPersistentIslandContext,
+} from '../core/islands/persistent-island-context.tsx';
+export { usePersistentState } from '../core/islands/use-persistent-state.ts';
+export { IslandPersistence, defaultIslandPersistence } from '../core/islands/island-persistence.ts';
+export { IslandStateSerializer } from '../core/islands/island-state-serializer.ts';
+
+// Error boundaries
+export { IslandErrorBoundary, withIslandErrorBoundary } from '../components/IslandErrorBoundary.tsx';
+export { LayoutErrorBoundary } from '../components/LayoutErrorBoundary.tsx';
+export { LayoutDataErrorBoundary } from '../components/LayoutDataErrorBoundary.tsx';
+export { StreamingErrorBoundary, withStreamingErrorBoundary } from '../components/StreamingErrorBoundary.tsx';
+
+// Streaming
+export { StreamingLayout, StreamingSuspense, withStreaming, useStreamingState } from '../components/StreamingLayout.tsx';
+
+// Image optimization
+export { Image } from '../components/Image.tsx';
+export type { ImageProps } from '../components/Image.tsx';
+
+// Types
+export type { IslandState } from '../schemas/layout.ts';