@useavalon/avalon 0.1.22 → 0.1.24

package/dist/src/islands/types.d.ts

@@ -0,0 +1,63 @@
+import type { JSX } from "preact";
+import type { AnalyzerOptions } from "../core/components/component-analyzer.ts";
+/**
+ * Framework type for island components
+ * Represents the supported UI frameworks for island architecture
+ */
+export type Framework = "solid" | "vue" | "svelte" | "preact" | "react" | "lit" | "qwik" | "unknown";
+/**
+ * Props for the Island component
+ * Defines the configuration for rendering an interactive island component
+ */
+export interface IslandProps {
+    /** Path to the island component (e.g., "/islands/Counter.tsx") */
+    src: string;
+    /** Hydration condition */
+    condition?: "on:visible" | "on:interaction" | "on:idle" | "on:client" | `media:${string}`;
+    /** Props to pass to the island component */
+    props?: Record<string, unknown>;
+    /** Children to render inside the island (for SSR) */
+    children?: JSX.Element | JSX.Element[] | string;
+    /** Whether to render server-side (default: true unless condition is 'on:client') */
+    ssr?: boolean;
+    /** Framework hint for client hydration */
+    framework?: "solid" | "vue" | "preact" | "react" | "svelte" | "lit" | "qwik";
+    /** Force SSR-only rendering without hydration */
+    ssrOnly?: boolean;
+    /** Component render options for intelligent detection */
+    renderOptions?: AnalyzerOptions;
+}
+/**
+ * Parameters for framework-specific render functions
+ * Used by all framework renderers to maintain consistent interface
+ */
+export interface RenderParams {
+    /** Path to the island component */
+    src: string;
+    /** Hydration condition */
+    condition: IslandProps["condition"];
+    /** Props to pass to the component */
+    props: Record<string, unknown>;
+    /** Whether to render server-side */
+    ssr: boolean;
+    /** Component render options for intelligent detection */
+    renderOptions?: AnalyzerOptions;
+    /** Force SSR-only rendering without hydration */
+    ssrOnly?: boolean;
+}
+/**
+ * Entry in the Svelte SSR CSS collection
+ * Tracks CSS for Svelte components during server-side rendering
+ */
+export interface SvelteSSRCSSEntry {
+    /** The CSS content */
+    css: string;
+    /** Unique scope identifier for the component */
+    scopeId: string;
+    /** Source path of the component */
+    src: string;
+    /** Whether this is global CSS */
+    isGlobal: boolean;
+    /** Timestamp when the CSS was added */
+    timestamp: number;
+}

package/dist/src/islands/universal-css-collector.d.ts

@@ -0,0 +1,41 @@
+/**
+ * Universal CSS Collector
+ *
+ * Collects and manages CSS from all framework integrations (Vue, Svelte, Solid, Preact)
+ * during SSR rendering. Provides a unified interface for CSS injection into the document head.
+ */
+declare global {
+    var __universalSSRCSS: Map<string, UniversalCSSEntry> | undefined;
+}
+export interface UniversalCSSEntry {
+    css: string;
+    scopeId: string;
+    src: string;
+    framework: string;
+    timestamp: number;
+}
+/**
+ * Add CSS from any framework integration to the global collection
+ */
+export declare function addUniversalCSS(css: string, src: string, framework: string, scopeId?: string): void;
+/**
+ * Get all collected CSS from all frameworks
+ */
+export declare function getUniversalCSS(clear?: boolean): string;
+/**
+ * Get CSS formatted for document head injection
+ */
+export declare function getUniversalCSSForHead(clear?: boolean): string;
+/**
+ * Clear all collected CSS
+ */
+export declare function clearUniversalCSS(): void;
+/**
+ * Get CSS statistics
+ */
+export declare function getUniversalCSSStats(): {
+    totalComponents: number;
+    byFramework: Record<string, number>;
+    totalCSSSize: number;
+    averageCSSSize: number;
+};

package/dist/src/islands/universal-head-collector.d.ts

@@ -0,0 +1,42 @@
+/**
+ * Universal Head Content Collector for SSR
+ *
+ * Collects head content (scripts, meta tags, etc.) from framework integrations
+ * during SSR and injects them into the HTML head.
+ *
+ * Similar to universal-css-collector.ts but for head content.
+ */
+interface HeadEntry {
+    content: string;
+    src: string;
+    framework: string;
+    type: 'script' | 'meta' | 'link' | 'other';
+}
+declare global {
+    var __universalSSRHead: Map<string, HeadEntry>;
+}
+/**
+ * Add head content to the universal collector
+ *
+ * @param content - The head content (script, meta tag, etc.)
+ * @param src - Source component path
+ * @param framework - Framework name
+ * @param type - Type of head content
+ */
+export declare function addUniversalHead(content: string, src: string, framework: string, type?: 'script' | 'meta' | 'link' | 'other'): void;
+/**
+ * Get all collected head content formatted for injection into HTML head
+ *
+ * @param clear - Whether to clear the collector after getting content
+ * @returns Formatted head content string
+ */
+export declare function getUniversalHeadForInjection(clear?: boolean): string;
+/**
+ * Clear all collected head content
+ */
+export declare function clearUniversalHead(): void;
+/**
+ * Get the current size of the head collector
+ */
+export declare function getHeadCollectorSize(): number;
+export {};