@useavalon/avalon 0.1.11 → 0.1.13

package/src/build/prop-extractors/index.ts

@@ -1,21 +1,21 @@
-export { type PropExtractionResult, FALLBACK_PROPS, extractVueProps } from "./vue.ts";
-export { extractSvelteProps } from "./svelte.ts";
-export { extractLitProps } from "./lit.ts";
-export { extractSolidProps } from "./solid.ts";
-export { extractQwikProps } from "./qwik.ts";
-
-import type { PropExtractionResult } from "./vue.ts";
-import { extractVueProps } from "./vue.ts";
-import { extractSvelteProps } from "./svelte.ts";
-import { extractLitProps } from "./lit.ts";
-import { extractSolidProps } from "./solid.ts";
-import { extractQwikProps } from "./qwik.ts";
-
-/** Maps framework name to its prop extractor function */
-export const EXTRACTOR_MAP: Record<string, (source: string) => PropExtractionResult> = {
-	vue: extractVueProps,
-	svelte: extractSvelteProps,
-	lit: extractLitProps,
-	solid: extractSolidProps,
-	qwik: extractQwikProps,
-};
+export { type PropExtractionResult, FALLBACK_PROPS, extractVueProps } from "./vue.ts";
+export { extractSvelteProps } from "./svelte.ts";
+export { extractLitProps } from "./lit.ts";
+export { extractSolidProps } from "./solid.ts";
+export { extractQwikProps } from "./qwik.ts";
+
+import type { PropExtractionResult } from "./vue.ts";
+import { extractVueProps } from "./vue.ts";
+import { extractSvelteProps } from "./svelte.ts";
+import { extractLitProps } from "./lit.ts";
+import { extractSolidProps } from "./solid.ts";
+import { extractQwikProps } from "./qwik.ts";
+
+/** Maps framework name to its prop extractor function */
+export const EXTRACTOR_MAP: Record<string, (source: string) => PropExtractionResult> = {
+	vue: extractVueProps,
+	svelte: extractSvelteProps,
+	lit: extractLitProps,
+	solid: extractSolidProps,
+	qwik: extractQwikProps,
+};

package/src/build/prop-extractors/lit.ts

@@ -1,140 +1,140 @@
-import { FALLBACK_PROPS, type PropExtractionResult } from "./vue.ts";
-
-/** Mapping from Lit type constructors to TypeScript type strings */
-const LIT_TYPE_MAP: Record<string, string> = {
-	String: "string",
-	Number: "number",
-	Boolean: "boolean",
-	Array: "unknown[]",
-	Object: "Record<string, unknown>",
-};
-
-/**
- * Extract props from a Lit element source string.
- *
- * Parses `static properties = { ... }` blocks and maps Lit type
- * constructors to TypeScript types. Properties with `state: true`
- * are excluded (internal state, not public props).
- *
- * Never throws — returns fallback on any failure.
- */
-export function extractLitProps(source: string): PropExtractionResult {
-	try {
-		const block = extractStaticPropertiesBlock(source);
-		if (block === null) {
-			return { propsType: FALLBACK_PROPS, fallback: true };
-		}
-
-		const props = parsePropertyEntries(block);
-		if (props.length === 0) {
-			return { propsType: FALLBACK_PROPS, fallback: true };
-		}
-
-		const fields = props.map((p) => p.name + "?: " + p.tsType).join("; ");
-		const propsType = "{ " + fields + " }";
-		return { propsType, fallback: false };
-	} catch {
-		console.warn(
-			"[avalon] Failed to extract Lit props — falling back to Record<string, unknown>",
-		);
-		return { propsType: FALLBACK_PROPS, fallback: true };
-	}
-}
-
-/**
- * Extract the content inside `static properties = { ... }`.
- * Uses brace-counting to handle nested objects.
- * Returns the inner content (without outer braces), or null if not found.
- */
-function extractStaticPropertiesBlock(source: string): string | null {
-	const marker = /static\s+properties\s*=\s*\{/;
-	const match = marker.exec(source);
-	if (!match) {
-		return null;
-	}
-
-	// Position of the opening brace
-	const openBrace = match.index + match[0].length - 1;
-	let depth = 1;
-	let i = openBrace + 1;
-
-	while (i < source.length && depth > 0) {
-		if (source[i] === "{") depth++;
-		else if (source[i] === "}") depth--;
-		i++;
-	}
-
-	if (depth !== 0) {
-		return null;
-	}
-
-	// Return content between the outer braces
-	return source.slice(openBrace + 1, i - 1);
-}
-
-interface ParsedProp {
-	name: string;
-	tsType: string;
-}
-
-/**
- * Parse individual property entries from the static properties block content.
- * Each entry looks like: `propName: { type: Constructor, ... }`
- * Filters out entries with `state: true`.
- */
-function parsePropertyEntries(block: string): ParsedProp[] {
-	const props: ParsedProp[] = [];
-
-	// Match each property entry: name: { ... }
-	// We use a regex to find property names followed by `{`, then brace-count
-	const entryRegex = /(\w+)\s*:\s*\{/g;
-	let entryMatch: RegExpExecArray | null;
-
-	while ((entryMatch = entryRegex.exec(block)) !== null) {
-		const name = entryMatch[1];
-		const openIdx = entryMatch.index + entryMatch[0].length - 1;
-
-		// Extract the balanced { ... } for this entry
-		const entryBody = extractBalancedBraces(block, openIdx);
-		if (entryBody === null) continue;
-
-		// Skip state properties
-		if (/\bstate\s*:\s*true\b/.test(entryBody)) continue;
-
-		// Extract the type constructor
-		const typeMatch = new RegExp(/\btype\s*:\s*(\w+)/).exec(entryBody);
-		const litType = typeMatch ? typeMatch[1] : null;
-		const tsType = litType && litType in LIT_TYPE_MAP
-			? LIT_TYPE_MAP[litType]
-			: "unknown";
-
-		props.push({ name, tsType });
-
-		// Advance regex past this entry to avoid re-matching nested braces
-		entryRegex.lastIndex = openIdx + (entryBody.length);
-	}
-
-	return props;
-}
-
-/**
- * Extract a balanced `{ ... }` block starting at the given index.
- * Returns the content between the braces (excluding outer braces), or null.
- */
-function extractBalancedBraces(source: string, startIdx: number): string | null {
-	if (source[startIdx] !== "{") return null;
-
-	let depth = 0;
-	let i = startIdx;
-
-	while (i < source.length) {
-		if (source[i] === "{") depth++;
-		else if (source[i] === "}") depth--;
-		if (depth === 0) {
-			return source.slice(startIdx + 1, i);
-		}
-		i++;
-	}
-
-	return null;
-}
+import { FALLBACK_PROPS, type PropExtractionResult } from "./vue.ts";
+
+/** Mapping from Lit type constructors to TypeScript type strings */
+const LIT_TYPE_MAP: Record<string, string> = {
+	String: "string",
+	Number: "number",
+	Boolean: "boolean",
+	Array: "unknown[]",
+	Object: "Record<string, unknown>",
+};
+
+/**
+ * Extract props from a Lit element source string.
+ *
+ * Parses `static properties = { ... }` blocks and maps Lit type
+ * constructors to TypeScript types. Properties with `state: true`
+ * are excluded (internal state, not public props).
+ *
+ * Never throws — returns fallback on any failure.
+ */
+export function extractLitProps(source: string): PropExtractionResult {
+	try {
+		const block = extractStaticPropertiesBlock(source);
+		if (block === null) {
+			return { propsType: FALLBACK_PROPS, fallback: true };
+		}
+
+		const props = parsePropertyEntries(block);
+		if (props.length === 0) {
+			return { propsType: FALLBACK_PROPS, fallback: true };
+		}
+
+		const fields = props.map((p) => p.name + "?: " + p.tsType).join("; ");
+		const propsType = "{ " + fields + " }";
+		return { propsType, fallback: false };
+	} catch {
+		console.warn(
+			"[avalon] Failed to extract Lit props — falling back to Record<string, unknown>",
+		);
+		return { propsType: FALLBACK_PROPS, fallback: true };
+	}
+}
+
+/**
+ * Extract the content inside `static properties = { ... }`.
+ * Uses brace-counting to handle nested objects.
+ * Returns the inner content (without outer braces), or null if not found.
+ */
+function extractStaticPropertiesBlock(source: string): string | null {
+	const marker = /static\s+properties\s*=\s*\{/;
+	const match = marker.exec(source);
+	if (!match) {
+		return null;
+	}
+
+	// Position of the opening brace
+	const openBrace = match.index + match[0].length - 1;
+	let depth = 1;
+	let i = openBrace + 1;
+
+	while (i < source.length && depth > 0) {
+		if (source[i] === "{") depth++;
+		else if (source[i] === "}") depth--;
+		i++;
+	}
+
+	if (depth !== 0) {
+		return null;
+	}
+
+	// Return content between the outer braces
+	return source.slice(openBrace + 1, i - 1);
+}
+
+interface ParsedProp {
+	name: string;
+	tsType: string;
+}
+
+/**
+ * Parse individual property entries from the static properties block content.
+ * Each entry looks like: `propName: { type: Constructor, ... }`
+ * Filters out entries with `state: true`.
+ */
+function parsePropertyEntries(block: string): ParsedProp[] {
+	const props: ParsedProp[] = [];
+
+	// Match each property entry: name: { ... }
+	// We use a regex to find property names followed by `{`, then brace-count
+	const entryRegex = /(\w+)\s*:\s*\{/g;
+	let entryMatch: RegExpExecArray | null;
+
+	while ((entryMatch = entryRegex.exec(block)) !== null) {
+		const name = entryMatch[1];
+		const openIdx = entryMatch.index + entryMatch[0].length - 1;
+
+		// Extract the balanced { ... } for this entry
+		const entryBody = extractBalancedBraces(block, openIdx);
+		if (entryBody === null) continue;
+
+		// Skip state properties
+		if (/\bstate\s*:\s*true\b/.test(entryBody)) continue;
+
+		// Extract the type constructor
+		const typeMatch = new RegExp(/\btype\s*:\s*(\w+)/).exec(entryBody);
+		const litType = typeMatch ? typeMatch[1] : null;
+		const tsType = litType && litType in LIT_TYPE_MAP
+			? LIT_TYPE_MAP[litType]
+			: "unknown";
+
+		props.push({ name, tsType });
+
+		// Advance regex past this entry to avoid re-matching nested braces
+		entryRegex.lastIndex = openIdx + (entryBody.length);
+	}
+
+	return props;
+}
+
+/**
+ * Extract a balanced `{ ... }` block starting at the given index.
+ * Returns the content between the braces (excluding outer braces), or null.
+ */
+function extractBalancedBraces(source: string, startIdx: number): string | null {
+	if (source[startIdx] !== "{") return null;
+
+	let depth = 0;
+	let i = startIdx;
+
+	while (i < source.length) {
+		if (source[i] === "{") depth++;
+		else if (source[i] === "}") depth--;
+		if (depth === 0) {
+			return source.slice(startIdx + 1, i);
+		}
+		i++;
+	}
+
+	return null;
+}

package/src/build/prop-extractors/qwik.ts

@@ -1,16 +1,16 @@
-import type { PropExtractionResult } from "./vue.ts";
-import { FALLBACK_PROPS } from "./vue.ts";
-
-/**
- * Extract props type from a Qwik component file.
- * Qwik components use component$(() => ...) — props are typed via the
- * generic parameter or a Props interface. For now we fall back to
- * Record<string, unknown> since Qwik's JSX types aren't Preact-compatible
- * and the sidecar just needs to expose the island prop.
- */
-export function extractQwikProps(_source: string): PropExtractionResult {
-	return {
-    propsType: FALLBACK_PROPS,
-    fallback: false
-};
-}
+import type { PropExtractionResult } from "./vue.ts";
+import { FALLBACK_PROPS } from "./vue.ts";
+
+/**
+ * Extract props type from a Qwik component file.
+ * Qwik components use component$(() => ...) — props are typed via the
+ * generic parameter or a Props interface. For now we fall back to
+ * Record<string, unknown> since Qwik's JSX types aren't Preact-compatible
+ * and the sidecar just needs to expose the island prop.
+ */
+export function extractQwikProps(_source: string): PropExtractionResult {
+	return {
+    propsType: FALLBACK_PROPS,
+    fallback: false
+};
+}

package/src/build/prop-extractors/solid.ts

@@ -1,125 +1,125 @@
-import { FALLBACK_PROPS, type PropExtractionResult } from "./vue.ts";
-
-/**
- * Extract props from a Solid component source string.
- *
- * Supports two patterns:
- *   1. `export default function Name(props: { ... })` — named function export
- *   2. `export default (props: { ... }) =>` — arrow function export
- *
- * Uses brace-counting to handle nested types in the props parameter.
- * Never throws — returns fallback on any failure.
- */
-export function extractSolidProps(source: string): PropExtractionResult {
-	try {
-		// Try named function pattern first
-		const namedResult = extractFromNamedFunction(source);
-		if (namedResult !== null) {
-			return { propsType: namedResult, fallback: false };
-		}
-
-		// Try arrow function pattern
-		const arrowResult = extractFromArrowFunction(source);
-		if (arrowResult !== null) {
-			return { propsType: arrowResult, fallback: false };
-		}
-
-		return { propsType: FALLBACK_PROPS, fallback: true };
-	} catch {
-		console.warn(
-			"[avalon] Failed to extract Solid props — falling back to Record<string, unknown>",
-		);
-		return { propsType: FALLBACK_PROPS, fallback: true };
-	}
-}
-
-/**
- * Extract props type from `export default function Name(props: { ... })`.
- * Returns the type literal string, or null if not found.
- */
-function extractFromNamedFunction(source: string): string | null {
-	// Match: export default function <Name>(props:
-	const regex = /export\s+default\s+function\s+\w+\s*\(\s*props\s*:\s*/;
-	const match = regex.exec(source);
-	if (!match) {
-		return null;
-	}
-
-	const typeStart = match.index + match[0].length;
-	return extractPropsType(source, typeStart);
-}
-
-/**
- * Extract props type from `export default (props: { ... }) =>`.
- * Returns the type literal string, or null if not found.
- */
-function extractFromArrowFunction(source: string): string | null {
-	// Match: export default (props:
-	const regex = /export\s+default\s+\(\s*props\s*:\s*/;
-	const match = regex.exec(source);
-	if (!match) {
-		return null;
-	}
-
-	const typeStart = match.index + match[0].length;
-	return extractPropsType(source, typeStart);
-}
-
-/**
- * Extract a props type starting at the given index in the source.
- * Handles both inline type literals `{ ... }` using brace-counting
- * and simple type references like `Props`.
- * Returns the trimmed type string, or null if extraction fails.
- */
-function extractPropsType(source: string, startIdx: number): string | null {
-	// Skip leading whitespace
-	let i = startIdx;
-	while (i < source.length && /\s/.test(source[i])) {
-		i++;
-	}
-
-	if (i >= source.length) {
-		return null;
-	}
-
-	// If it starts with `{`, use brace-counting for inline type literal
-	if (source[i] === "{") {
-		return extractBalancedBraces(source, i);
-	}
-
-	// Otherwise it's a type reference — read until `)` or `,`
-	const remaining = source.slice(i);
-	const refMatch = new RegExp(/^([A-Za-z_$][\w$]*(?:<[^>]*>)?)/).exec(remaining);
-	if (refMatch) {
-		return refMatch[1].trim();
-	}
-
-	return null;
-}
-
-/**
- * Extract a balanced `{ ... }` block starting at the given index.
- * Returns the full string including the outer braces, or null if unbalanced.
- */
-function extractBalancedBraces(source: string, startIdx: number): string | null {
-	if (source[startIdx] !== "{") {
-		return null;
-	}
-
-	let depth = 0;
-	let i = startIdx;
-
-	while (i < source.length) {
-		if (source[i] === "{") {
-			depth++;
-		} else if (source[i] === "}") {
-			depth--;
-			if (depth === 0) {
-				return source.slice(startIdx, i + 1).trim();
-			}
-		}
-		i++;
-	}
-
-	return null; // unbalanced
-}
+import { FALLBACK_PROPS, type PropExtractionResult } from "./vue.ts";
+
+/**
+ * Extract props from a Solid component source string.
+ *
+ * Supports two patterns:
+ *   1. `export default function Name(props: { ... })` — named function export
+ *   2. `export default (props: { ... }) =>` — arrow function export
+ *
+ * Uses brace-counting to handle nested types in the props parameter.
+ * Never throws — returns fallback on any failure.
+ */
+export function extractSolidProps(source: string): PropExtractionResult {
+	try {
+		// Try named function pattern first
+		const namedResult = extractFromNamedFunction(source);
+		if (namedResult !== null) {
+			return { propsType: namedResult, fallback: false };
+		}
+
+		// Try arrow function pattern
+		const arrowResult = extractFromArrowFunction(source);
+		if (arrowResult !== null) {
+			return { propsType: arrowResult, fallback: false };
+		}
+
+		return { propsType: FALLBACK_PROPS, fallback: true };
+	} catch {
+		console.warn(
+			"[avalon] Failed to extract Solid props — falling back to Record<string, unknown>",
+		);
+		return { propsType: FALLBACK_PROPS, fallback: true };
+	}
+}
+
+/**
+ * Extract props type from `export default function Name(props: { ... })`.
+ * Returns the type literal string, or null if not found.
+ */
+function extractFromNamedFunction(source: string): string | null {
+	// Match: export default function <Name>(props:
+	const regex = /export\s+default\s+function\s+\w+\s*\(\s*props\s*:\s*/;
+	const match = regex.exec(source);
+	if (!match) {
+		return null;
+	}
+
+	const typeStart = match.index + match[0].length;
+	return extractPropsType(source, typeStart);
+}
+
+/**
+ * Extract props type from `export default (props: { ... }) =>`.
+ * Returns the type literal string, or null if not found.
+ */
+function extractFromArrowFunction(source: string): string | null {
+	// Match: export default (props:
+	const regex = /export\s+default\s+\(\s*props\s*:\s*/;
+	const match = regex.exec(source);
+	if (!match) {
+		return null;
+	}
+
+	const typeStart = match.index + match[0].length;
+	return extractPropsType(source, typeStart);
+}
+
+/**
+ * Extract a props type starting at the given index in the source.
+ * Handles both inline type literals `{ ... }` using brace-counting
+ * and simple type references like `Props`.
+ * Returns the trimmed type string, or null if extraction fails.
+ */
+function extractPropsType(source: string, startIdx: number): string | null {
+	// Skip leading whitespace
+	let i = startIdx;
+	while (i < source.length && /\s/.test(source[i])) {
+		i++;
+	}
+
+	if (i >= source.length) {
+		return null;
+	}
+
+	// If it starts with `{`, use brace-counting for inline type literal
+	if (source[i] === "{") {
+		return extractBalancedBraces(source, i);
+	}
+
+	// Otherwise it's a type reference — read until `)` or `,`
+	const remaining = source.slice(i);
+	const refMatch = new RegExp(/^([A-Za-z_$][\w$]*(?:<[^>]*>)?)/).exec(remaining);
+	if (refMatch) {
+		return refMatch[1].trim();
+	}
+
+	return null;
+}
+
+/**
+ * Extract a balanced `{ ... }` block starting at the given index.
+ * Returns the full string including the outer braces, or null if unbalanced.
+ */
+function extractBalancedBraces(source: string, startIdx: number): string | null {
+	if (source[startIdx] !== "{") {
+		return null;
+	}
+
+	let depth = 0;
+	let i = startIdx;
+
+	while (i < source.length) {
+		if (source[i] === "{") {
+			depth++;
+		} else if (source[i] === "}") {
+			depth--;
+			if (depth === 0) {
+				return source.slice(startIdx, i + 1).trim();
+			}
+		}
+		i++;
+	}
+
+	return null; // unbalanced
+}