@ecopages/react-router 0.2.0-alpha.9 → 0.2.1

package/src/navigation.ts

@@ -1,297 +0,0 @@
-/**
- * Navigation utilities for fetching and parsing page content.
- * @module
- */
-
-/// <reference types="@ecopages/core/declarations" />
-
-import { getEcoDocumentOwner } from '@ecopages/core/router/navigation-coordinator';
-import { type ComponentType } from 'react';
-import type { EcoRouterOptions } from './types.ts';
-
-const ROUTER_PROPS_SCRIPT_ID = '__ECO_PAGE_DATA__';
-
-function isReactPageHydrationAsset(src: string): boolean {
-	return src.includes('ecopages-react-') && src.includes('hydration.js') && !src.includes('ecopages-react-island-');
-}
-
-export type PageState = {
-	Component: ComponentType<any>;
-	props: Record<string, any>;
-};
-
-export type LoadedPageModule = {
-	Component: ComponentType<any>;
-	props: Record<string, any>;
-	doc: Document;
-	finalPath: string;
-	moduleUrl: string;
-};
-
-export type FetchedPageDocument = {
-	doc: Document;
-	finalPath: string;
-	html: string;
-};
-
-type LoadPageModuleOptions = {
-	signal?: AbortSignal;
-};
-
-export type InterceptDecision =
-	| { shouldIntercept: true }
-	| {
-			shouldIntercept: false;
-			reason:
-				| 'modified-click'
-				| 'non-left-click'
-				| 'external-target'
-				| 'explicit-reload'
-				| 'download'
-				| 'invalid-href'
-				| 'cross-origin';
-	  };
-
-/**
- * Determines whether a link click should be intercepted for client-side navigation.
- *
- * Standard SPA navigation rules:
- * - Modified clicks (Cmd/Ctrl/Shift/Alt) open in new tab
- * - Non-left clicks use default browser behavior
- * - External targets, downloads, and cross-origin links navigate normally
- *
- * @returns Object indicating whether to intercept and the reason if not
- */
-export function getInterceptDecision(
-	event: MouseEvent,
-	link: HTMLAnchorElement,
-	options: Required<EcoRouterOptions>,
-): InterceptDecision {
-	if (event.metaKey || event.ctrlKey || event.shiftKey || event.altKey) {
-		return { shouldIntercept: false, reason: 'modified-click' };
-	}
-	if (event.button !== 0) return { shouldIntercept: false, reason: 'non-left-click' };
-
-	const target = link.getAttribute('target');
-	if (target && target !== '_self') return { shouldIntercept: false, reason: 'external-target' };
-
-	if (link.hasAttribute(options.reloadAttribute)) return { shouldIntercept: false, reason: 'explicit-reload' };
-	if (link.hasAttribute('download')) return { shouldIntercept: false, reason: 'download' };
-
-	const href = link.getAttribute('href');
-	if (!href || href.startsWith('#') || href.startsWith('javascript:')) {
-		return { shouldIntercept: false, reason: 'invalid-href' };
-	}
-
-	const url = new URL(href, window.location.origin);
-	if (url.origin !== window.location.origin) return { shouldIntercept: false, reason: 'cross-origin' };
-
-	return { shouldIntercept: true };
-}
-
-/**
- * Extracts component module URL from window.__ECO_PAGES__.page.
- * For current document, returns the module path set by hydration script.
- * For fetched documents, parses the hydration script to extract the module path.
- */
-function extractComponentUrlFromMarker(doc: Document): string | null {
-	if (doc === document && window.__ECO_PAGES__?.page?.module) {
-		return window.__ECO_PAGES__.page.module;
-	}
-	return null;
-}
-
-/**
- * Matches default import: `import Content from './Content'`
- * Used to extract module path from hydration script for fetched documents.
- */
-const DEFAULT_IMPORT_REGEX = /import\s+(\w+)\s+from\s*['"]([^'"]+)['"]/;
-
-/**
- * Matches namespace import: `import * as Content from './Content'`
- * Used for MDX components. Also handles minified: `import*as Content from'./Content'`
- */
-const NAMESPACE_IMPORT_REGEX = /import\s*\*\s*as\s*(\w+)\s*from\s*['"]([^'"]+)['"]/;
-
-/**
- * Extracts import path from hydration script code using regex.
- * Used for fetched documents. Less reliable due to minification.
- */
-function extractModulePathFromCode(code: string): string | null {
-	const defaultMatch = code.match(DEFAULT_IMPORT_REGEX);
-	const namespaceMatch = code.match(NAMESPACE_IMPORT_REGEX);
-	return (defaultMatch || namespaceMatch)?.[2] ?? null;
-}
-
-/**
- * Extracts serialized page props from window.__ECO_PAGES__.page or fetched document.
- * For current document, returns props set by hydration script.
- * For fetched documents, parses the JSON script tag directly.
- */
-export function extractProps(doc: Document): Record<string, any> {
-	if (doc === document && window.__ECO_PAGES__?.page?.props) {
-		return window.__ECO_PAGES__.page.props;
-	}
-
-	const propsScript = doc.getElementById(ROUTER_PROPS_SCRIPT_ID);
-	if (propsScript?.textContent) {
-		try {
-			return JSON.parse(propsScript.textContent);
-		} catch (e) {
-			console.error('[EcoRouter] Failed to parse props:', e);
-			return {};
-		}
-	}
-
-	return {};
-}
-
-function isReactRouteDocument(doc: Document): boolean {
-	return getEcoDocumentOwner(doc) === 'react-router';
-}
-
-/**
- * Adds cache-busting timestamp for HMR in development.
- *
- * Prevents loading stale cached modules when navigating to previously visited pages.
- * Disabled in production where filenames have content hashes.
- */
-function addCacheBuster(url: string): string {
-	if (import.meta.env?.MODE === 'production' || import.meta.env?.PROD) {
-		return url;
-	}
-	const separator = url.includes('?') ? '&' : '?';
-	return `${url}${separator}t=${Date.now()}`;
-}
-
-/**
- * Extracts component module URL using multi-tier strategy.
- *
- * 1. Read from window.__ECO_PAGES__.page.module (for current document)
- * 2. Parse inline hydration script with regex (for fetched documents)
- * 3. Fetch and parse external hydration script (final fallback)
- *
- * Regex parsing is less reliable due to minification.
- */
-export async function extractComponentUrl(doc: Document): Promise<string | null> {
-	const markerUrl = extractComponentUrlFromMarker(doc);
-	if (markerUrl) return markerUrl;
-
-	const scripts = Array.from(doc.querySelectorAll('script'));
-
-	const inlineHydrationScript = scripts.find(
-		(s) =>
-			!s.src &&
-			!!s.textContent &&
-			s.textContent.includes('__ECO_PAGES__') &&
-			s.textContent.includes('hydrateRoot') &&
-			s.textContent.includes('import'),
-	);
-
-	if (inlineHydrationScript?.textContent) {
-		return extractModulePathFromCode(inlineHydrationScript.textContent);
-	}
-
-	const hydrationScript = scripts.find((s) => isReactPageHydrationAsset(s.src ?? ''));
-	if (!hydrationScript?.src) return null;
-
-	try {
-		const scriptUrl = addCacheBuster(hydrationScript.src);
-		const res = await fetch(scriptUrl);
-		const code = await res.text();
-		return extractModulePathFromCode(code);
-	} catch {
-		return null;
-	}
-}
-
-/**
- * Fetches and parses a page, returning its component, props, and document.
- *
- * Flow: Fetch HTML → Parse → Extract props → Extract component URL → Import module
- *
- * Handles multiple export patterns (Content, default.Content, default) for different
- * integration setups. Does NOT update DOM - caller applies changes.
- *
- * @param url - The URL to load
- * @returns Object with Component, props, doc, and finalPath, or null on error
- */
-export async function loadPageModule(
-	url: string,
-	options: LoadPageModuleOptions = {},
-): Promise<LoadedPageModule | null> {
-	const fetchedPage = await fetchPageDocument(url, options);
-	if (!fetchedPage) {
-		return null;
-	}
-
-	return loadPageModuleFromDocument(fetchedPage.doc, fetchedPage.finalPath);
-}
-
-export async function fetchPageDocument(
-	url: string,
-	options: LoadPageModuleOptions = {},
-): Promise<FetchedPageDocument | null> {
-	try {
-		const res = await fetch(url, {
-			signal: options.signal,
-			headers: {
-				Accept: 'text/html',
-			},
-		});
-		const html = await res.text();
-
-		const finalUrl = new URL(res.url || url, window.location.origin);
-		const finalPath = finalUrl.pathname + finalUrl.search;
-
-		const doc = new DOMParser().parseFromString(html, 'text/html');
-
-		return { doc, finalPath, html };
-	} catch (e) {
-		if (e instanceof DOMException && e.name === 'AbortError') {
-			return null;
-		}
-		console.error('[EcoRouter] Navigation failed:', e);
-		return null;
-	}
-}
-
-export async function loadPageModuleFromDocument(doc: Document, finalPath: string): Promise<LoadedPageModule | null> {
-	const props = extractProps(doc);
-	const componentUrl = await extractComponentUrl(doc);
-
-	if (!componentUrl) {
-		if (isReactRouteDocument(doc)) {
-			console.error('[EcoRouter] Could not find component URL');
-		}
-		return null;
-	}
-
-	const moduleUrl = addCacheBuster(componentUrl);
-	const module = await import(/* @vite-ignore */ moduleUrl);
-	const rawComponent = module.Content || module.default?.Content || module.default;
-	const config = module.config || rawComponent?.config;
-
-	if (!rawComponent) {
-		console.error('[EcoRouter] No component found in module');
-		return null;
-	}
-
-	if (config && !rawComponent.config) {
-		rawComponent.config = config;
-	}
-
-	return { Component: rawComponent, props, doc, finalPath, moduleUrl: componentUrl };
-}
-
-/**
- * Convenience wrapper around getInterceptDecision that returns a boolean.
- * Use getInterceptDecision directly when you need the reason for debugging.
- */
-export function shouldInterceptClick(
-	event: MouseEvent,
-	link: HTMLAnchorElement,
-	options: Required<EcoRouterOptions>,
-): boolean {
-	return getInterceptDecision(event, link, options).shouldIntercept;
-}

package/src/props-script.ts

@@ -1,19 +0,0 @@
-import { createElement, type FC } from 'react';
-
-export interface EcoPropsScriptProps {
-	/** The page props to serialize for client-side hydration */
-	data: Record<string, any>;
-}
-
-/**
- * Serializes page props as JSON for SPA navigation.
- * The hydration script reads this and sets window.__ECO_PAGES__.page.
- * Using application/json allows direct parsing without regex.
- */
-export const EcoPropsScript: FC<EcoPropsScriptProps> = ({ data }) => {
-	return createElement('script', {
-		id: '__ECO_PAGE_DATA__',
-		type: 'application/json',
-		dangerouslySetInnerHTML: { __html: JSON.stringify(data || {}) },
-	});
-};