@ecopages/react 0.2.0-alpha.9 → 0.2.0-beta.0

package/src/utils/client-only.ts

@@ -1,27 +0,0 @@
-import type { ReactNode } from 'react';
-import { useEffect, useState } from 'react';
-
-type ClientOnlyProps = {
-	children: ReactNode;
-	fallback?: ReactNode;
-};
-
-export const useIsClient = (): boolean => {
-	const [isClient, setIsClient] = useState(false);
-
-	useEffect(() => {
-		setIsClient(true);
-	}, []);
-
-	return isClient;
-};
-
-export const ClientOnly = ({ children, fallback = null }: ClientOnlyProps): ReactNode => {
-	const isClient = useIsClient();
-
-	if (!isClient) {
-		return fallback;
-	}
-
-	return children;
-};

package/src/utils/declared-modules.ts

@@ -1,99 +0,0 @@
-/**
- * Shared utilities for collecting declared module sources from component configs.
- * Used by both the production ReactRenderer and the HMR strategy to ensure
- * the client-graph-boundary plugin receives a consistent set of allowed modules.
- *
- * @module
- */
-
-import type { EcoComponentConfig } from '@ecopages/core';
-
-type PageConfigModule = {
-	default?: { config?: EcoComponentConfig };
-	config?: EcoComponentConfig;
-};
-
-/**
- * Extracts the module source (package name) from a declared module string,
- * stripping any `{namedImport,...}` grammar.
- *
- * @example
- * parseDeclaredModuleSource('@ecopages/image-processor/component/react{EcoImage}')
- * // → '@ecopages/image-processor/component/react'
- */
-export function parseDeclaredModuleSource(value: string): string | undefined {
-	const source = value.trim();
-	if (source.length === 0) return undefined;
-	const openBraceIndex = source.indexOf('{');
-	if (openBraceIndex < 0) return source;
-	const from = source.slice(0, openBraceIndex).trim();
-	return from.length > 0 ? from : undefined;
-}
-
-/**
- * Normalizes an array of declared module strings into unique source paths.
- */
-export function normalizeDeclaredModuleSources(modules?: string[]): string[] {
-	const seen = new Set<string>();
-	for (const declaration of modules ?? []) {
-		const from = parseDeclaredModuleSource(declaration);
-		if (from) {
-			seen.add(from);
-		}
-	}
-	return Array.from(seen);
-}
-
-/**
- * Recursively walks a component config tree (including layouts and nested
- * `dependencies.components`) to collect all declared module sources.
- */
-export function collectDeclaredModulesInConfig(
-	config: EcoComponentConfig | undefined,
-	visited = new Set<EcoComponentConfig>(),
-): string[] {
-	if (!config || visited.has(config)) {
-		return [];
-	}
-
-	visited.add(config);
-
-	const declarations = normalizeDeclaredModuleSources(config.dependencies?.modules);
-
-	if (config.layout?.config) {
-		declarations.push(...collectDeclaredModulesInConfig(config.layout.config, visited));
-	}
-
-	for (const component of config.dependencies?.components ?? []) {
-		if (component.config) {
-			declarations.push(...collectDeclaredModulesInConfig(component.config, visited));
-		}
-	}
-
-	return declarations;
-}
-
-/**
- * Collects declared module sources from an already imported page module.
- */
-export function collectPageDeclaredModulesFromModule(pageModule: PageConfigModule): string[] {
-	const declarations = [
-		...collectDeclaredModulesInConfig(pageModule.default?.config),
-		...collectDeclaredModulesInConfig(pageModule.config),
-	];
-
-	return Array.from(new Set(declarations));
-}
-
-/**
- * Imports a page entrypoint and collects all transitively declared module sources
- * from its config, layout config, and nested component configs.
- */
-export async function collectPageDeclaredModules(pagePath: string): Promise<string[]> {
-	try {
-		const pageModule = (await import(pagePath)) as PageConfigModule;
-		return collectPageDeclaredModulesFromModule(pageModule);
-	} catch {
-		return [];
-	}
-}

package/src/utils/dynamic.ts

@@ -1,27 +0,0 @@
-import { type ComponentType, type LazyExoticComponent, lazy } from 'react';
-
-/**
- * Dynamically loads a React component with optional SSR support.
- *
- * @param importFn - Function returning a promise that resolves to a React component.
- * @param options - Options for SSR behavior.
- * @returns Lazy loaded component or a null fallback for non-client environments.
- */
-type DynamicLoaderOptions = {
-	ssr?: boolean;
-};
-
-const NullComponent: ComponentType = () => null;
-
-export function dynamic(
-	importFn: () => Promise<{ default: ComponentType<any> }>,
-	options: DynamicLoaderOptions = {},
-): LazyExoticComponent<ComponentType<any>> | ComponentType {
-	const { ssr = false } = options;
-
-	if (ssr || typeof window !== 'undefined') {
-		return lazy(importFn);
-	}
-
-	return NullComponent;
-}

package/src/utils/hmr-scripts.ts

@@ -1,47 +0,0 @@
-/**
- * HMR script utilities for React components.
- * @module
- */
-
-/** Marker comment to identify already-processed HMR code */
-const HMR_MARKER = '/* [ecopages] react-hmr */';
-
-/**
- * Checks if code has already been processed with HMR marker.
- * @param code - The bundled code to check
- * @returns True if the code already contains the HMR marker
- */
-export function hasHmrMarker(code: string): boolean {
-	return code.includes(HMR_MARKER);
-}
-
-/**
- * Injects HMR acceptance handler into bundled code.
- * When a module with React exports changes, it triggers a full invalidation
- * to ensure the parent module re-imports and re-renders with the updated component.
- * @param code - The bundled code to wrap
- * @returns Code with HMR handler injected
- */
-export function injectHmrHandler(code: string): string {
-	return `${HMR_MARKER}
-${code}
-if (import.meta.hot) {
-  import.meta.hot.accept((newModule) => {
-    if (newModule) {
-      const exports = Object.keys(newModule);
-      const hasReactExport = exports.some(key => {
-        const value = newModule[key];
-        return value && (
-          typeof value === 'function' ||
-          (typeof value === 'object' && value.$$typeof)
-        );
-      });
-      
-      if (hasReactExport) {
-        import.meta.hot.invalidate();
-      }
-    }
-  });
-}
-`;
-}

package/src/utils/html-boundary.ts

@@ -1,66 +0,0 @@
-const VOID_TAGS = new Set([
-	'area',
-	'base',
-	'br',
-	'col',
-	'embed',
-	'hr',
-	'img',
-	'input',
-	'link',
-	'meta',
-	'param',
-	'source',
-	'track',
-	'wbr',
-]);
-
-/**
- * Returns true when HTML contains exactly one root element node.
- *
- * Used by component-level React rendering to decide whether root attributes can
- * be attached safely without introducing synthetic wrapper nodes.
- */
-export function hasSingleRootElement(html: string): boolean {
-	const firstTagMatch = html.match(/^\s*<([a-zA-Z][a-zA-Z0-9:-]*)\b[^>]*>/);
-	if (!firstTagMatch) {
-		return false;
-	}
-
-	const firstTag = firstTagMatch[1].toLowerCase();
-	const firstTagText = firstTagMatch[0];
-	const firstTagStart = firstTagMatch.index ?? 0;
-	const firstTagEnd = firstTagStart + firstTagText.length;
-	const isSelfClosing = /\/\s*>$/.test(firstTagText);
-
-	if (isSelfClosing || VOID_TAGS.has(firstTag)) {
-		return html.slice(firstTagEnd).trim().length === 0;
-	}
-
-	const tokenRegex = /<\/?([a-zA-Z][a-zA-Z0-9:-]*)\b[^>]*>/g;
-	tokenRegex.lastIndex = firstTagEnd;
-	let depth = 1;
-
-	for (let token = tokenRegex.exec(html); token; token = tokenRegex.exec(html)) {
-		const tagText = token[0];
-		const tagName = token[1].toLowerCase();
-		const isClosing = tagText.startsWith('</');
-		const tokenSelfClosing = /\/\s*>$/.test(tagText);
-
-		if (VOID_TAGS.has(tagName) || tokenSelfClosing) {
-			continue;
-		}
-
-		if (isClosing) {
-			depth--;
-			if (depth === 0) {
-				const afterRoot = html.slice(token.index + token[0].length).trim();
-				return afterRoot.length === 0;
-			}
-		} else {
-			depth++;
-		}
-	}
-
-	return false;
-}