This commit is contained in:
alorig
2025-11-18 05:03:27 +05:00
parent 342d9eab17
commit 40d379dd7e
35 changed files with 2073 additions and 0 deletions

View File

@@ -0,0 +1,119 @@
/**
* File Access Utility
* Phase 5: Sites Renderer & Publishing
*
* Integrates with Phase 3's SiteBuilderFileService for file access.
* Provides utilities to access site assets (images, documents, media).
*/
const SITES_DATA_PATH = import.meta.env.SITES_DATA_PATH || '/sites';
const API_URL = import.meta.env.VITE_API_URL || 'https://api.igny8.com/api';
/**
* Get file URL for a site asset.
*
* @param siteId - Site ID
* @param version - Site version (optional, defaults to 'latest')
* @param filePath - Relative path to file from assets directory
* @returns Full URL to the asset
*/
export function getSiteAssetUrl(
siteId: string | number,
filePath: string,
version: string | number = 'latest'
): string {
// Try filesystem first (for deployed sites)
const fsPath = `${SITES_DATA_PATH}/clients/${siteId}/v${version}/assets/${filePath}`;
// In browser, we need to use API endpoint
// The backend will serve files from the filesystem
return `${API_URL}/v1/site-builder/assets/${siteId}/${version}/${filePath}`;
}
/**
* Get image URL for a site.
*/
export function getSiteImageUrl(
siteId: string | number,
imagePath: string,
version: string | number = 'latest'
): string {
return getSiteAssetUrl(siteId, `images/${imagePath}`, version);
}
/**
* Get document URL for a site.
*/
export function getSiteDocumentUrl(
siteId: string | number,
documentPath: string,
version: string | number = 'latest'
): string {
return getSiteAssetUrl(siteId, `documents/${documentPath}`, version);
}
/**
* Get media URL for a site.
*/
export function getSiteMediaUrl(
siteId: string | number,
mediaPath: string,
version: string | number = 'latest'
): string {
return getSiteAssetUrl(siteId, `media/${mediaPath}`, version);
}
/**
* Check if a file exists.
*
* @param siteId - Site ID
* @param filePath - Relative path to file
* @param version - Site version
* @returns Promise that resolves to true if file exists
*/
export async function fileExists(
siteId: string | number,
filePath: string,
version: string | number = 'latest'
): Promise<boolean> {
try {
const url = getSiteAssetUrl(siteId, filePath, version);
const response = await fetch(url, { method: 'HEAD' });
return response.ok;
} catch {
return false;
}
}
/**
* Load file content as text.
*/
export async function loadFileAsText(
siteId: string | number,
filePath: string,
version: string | number = 'latest'
): Promise<string> {
const url = getSiteAssetUrl(siteId, filePath, version);
const response = await fetch(url);
if (!response.ok) {
throw new Error(`Failed to load file: ${filePath}`);
}
return response.text();
}
/**
* Load file content as blob.
*/
export async function loadFileAsBlob(
siteId: string | number,
filePath: string,
version: string | number = 'latest'
): Promise<Blob> {
const url = getSiteAssetUrl(siteId, filePath, version);
const response = await fetch(url);
if (!response.ok) {
throw new Error(`Failed to load file: ${filePath}`);
}
return response.blob();
}

View File

@@ -0,0 +1,205 @@
/**
* Layout Renderer
* Phase 5: Sites Renderer & Publishing
*
* Renders different layout types for sites.
*/
import React from 'react';
import type { SiteDefinition } from '../types';
import { renderTemplate } from './templateEngine';
export type LayoutType =
| 'default'
| 'centered'
| 'sidebar'
| 'grid'
| 'magazine'
| 'minimal'
| 'fullwidth';
/**
* Render site layout based on site definition.
*/
export function renderLayout(siteDefinition: SiteDefinition): React.ReactElement {
const layoutType = siteDefinition.layout as LayoutType;
switch (layoutType) {
case 'centered':
return renderCenteredLayout(siteDefinition);
case 'sidebar':
return renderSidebarLayout(siteDefinition);
case 'grid':
return renderGridLayout(siteDefinition);
case 'magazine':
return renderMagazineLayout(siteDefinition);
case 'minimal':
return renderMinimalLayout(siteDefinition);
case 'fullwidth':
return renderFullwidthLayout(siteDefinition);
case 'default':
default:
return renderDefaultLayout(siteDefinition);
}
}
/**
* Default layout: Standard header, content, footer.
*/
function renderDefaultLayout(siteDefinition: SiteDefinition): React.ReactElement {
return (
<div className="layout-default">
<header className="site-header">
<nav className="site-navigation">
{renderNavigation(siteDefinition.navigation)}
</nav>
</header>
<main className="site-main">
{renderPages(siteDefinition.pages)}
</main>
<footer className="site-footer">
<p>&copy; {new Date().getFullYear()} {siteDefinition.name}</p>
</footer>
</div>
);
}
/**
* Centered layout: Content centered with max-width.
*/
function renderCenteredLayout(siteDefinition: SiteDefinition): React.ReactElement {
return (
<div className="layout-centered">
<header className="site-header">
<nav className="site-navigation">
{renderNavigation(siteDefinition.navigation)}
</nav>
</header>
<main className="site-main" style={{ maxWidth: '1200px', margin: '0 auto', padding: '2rem' }}>
{renderPages(siteDefinition.pages)}
</main>
<footer className="site-footer">
<p>&copy; {new Date().getFullYear()} {siteDefinition.name}</p>
</footer>
</div>
);
}
/**
* Sidebar layout: Sidebar navigation with main content.
*/
function renderSidebarLayout(siteDefinition: SiteDefinition): React.ReactElement {
return (
<div className="layout-sidebar">
<aside className="site-sidebar">
<nav className="site-navigation">
{renderNavigation(siteDefinition.navigation)}
</nav>
</aside>
<main className="site-main">
{renderPages(siteDefinition.pages)}
</main>
</div>
);
}
/**
* Grid layout: Grid-based page layout.
*/
function renderGridLayout(siteDefinition: SiteDefinition): React.ReactElement {
return (
<div className="layout-grid">
<header className="site-header">
<nav className="site-navigation">
{renderNavigation(siteDefinition.navigation)}
</nav>
</header>
<main className="site-main" style={{ display: 'grid', gridTemplateColumns: 'repeat(auto-fit, minmax(300px, 1fr))', gap: '2rem', padding: '2rem' }}>
{renderPages(siteDefinition.pages)}
</main>
</div>
);
}
/**
* Magazine layout: Multi-column magazine style.
*/
function renderMagazineLayout(siteDefinition: SiteDefinition): React.ReactElement {
return (
<div className="layout-magazine">
<header className="site-header">
<h1>{siteDefinition.name}</h1>
<nav className="site-navigation">
{renderNavigation(siteDefinition.navigation)}
</nav>
</header>
<main className="site-main" style={{ display: 'grid', gridTemplateColumns: '2fr 1fr', gap: '2rem', padding: '2rem' }}>
{renderPages(siteDefinition.pages)}
</main>
</div>
);
}
/**
* Minimal layout: Clean, minimal design.
*/
function renderMinimalLayout(siteDefinition: SiteDefinition): React.ReactElement {
return (
<div className="layout-minimal">
<main className="site-main" style={{ padding: '4rem 2rem', maxWidth: '800px', margin: '0 auto' }}>
{renderPages(siteDefinition.pages)}
</main>
</div>
);
}
/**
* Fullwidth layout: Full-width content.
*/
function renderFullwidthLayout(siteDefinition: SiteDefinition): React.ReactElement {
return (
<div className="layout-fullwidth">
<header className="site-header">
<nav className="site-navigation">
{renderNavigation(siteDefinition.navigation)}
</nav>
</header>
<main className="site-main" style={{ width: '100%' }}>
{renderPages(siteDefinition.pages)}
</main>
</div>
);
}
/**
* Render navigation items.
*/
function renderNavigation(navigation: SiteDefinition['navigation']): React.ReactElement {
return (
<ul style={{ listStyle: 'none', display: 'flex', gap: '1rem', padding: 0 }}>
{navigation.map((item) => (
<li key={item.slug}>
<a href={`/${item.slug}`}>{item.label}</a>
</li>
))}
</ul>
);
}
/**
* Render pages.
*/
function renderPages(pages: SiteDefinition['pages']): React.ReactElement[] {
return pages
.filter((page) => page.status === 'ready')
.map((page) => (
<div key={page.id} className="page" data-page-slug={page.slug}>
<h2>{page.title}</h2>
{page.blocks.map((block, index) => (
<div key={index} className="block" data-block-type={block.type}>
{renderTemplate(block)}
</div>
))}
</div>
));
}

View File

@@ -0,0 +1,245 @@
/**
* Template Engine
* Phase 5: Sites Renderer & Publishing
*
* Renders blocks using shared components from the component library.
*/
import React from 'react';
import type { Block } from '../types';
/**
* Render a block using the template engine.
* Imports shared components dynamically.
*/
export function renderTemplate(block: Block): React.ReactElement {
const { type, data } = block;
try {
// Try to import shared component
// This will be replaced with actual component imports once shared components are available
switch (type) {
case 'hero':
return renderHeroBlock(data);
case 'text':
return renderTextBlock(data);
case 'image':
return renderImageBlock(data);
case 'button':
return renderButtonBlock(data);
case 'section':
return renderSectionBlock(data);
case 'grid':
return renderGridBlock(data);
case 'card':
return renderCardBlock(data);
case 'list':
return renderListBlock(data);
case 'quote':
return renderQuoteBlock(data);
case 'video':
return renderVideoBlock(data);
case 'form':
return renderFormBlock(data);
case 'accordion':
return renderAccordionBlock(data);
default:
return <div className="block-unknown">Unknown block type: {type}</div>;
}
} catch (error) {
console.error(`Error rendering block type ${type}:`, error);
return <div className="block-error">Error rendering block: {type}</div>;
}
}
/**
* Render hero block.
*/
function renderHeroBlock(data: Record<string, any>): React.ReactElement {
return (
<section className="block-hero" style={{ padding: '4rem 2rem', textAlign: 'center', background: data.background || '#f0f0f0' }}>
<h1>{data.title || 'Hero Title'}</h1>
{data.subtitle && <p>{data.subtitle}</p>}
{data.buttonText && (
<a href={data.buttonLink || '#'} className="button">
{data.buttonText}
</a>
)}
</section>
);
}
/**
* Render text block.
*/
function renderTextBlock(data: Record<string, any>): React.ReactElement {
return (
<div className="block-text" style={{ padding: '2rem' }}>
{data.content && <div dangerouslySetInnerHTML={{ __html: data.content }} />}
</div>
);
}
/**
* Render image block.
*/
function renderImageBlock(data: Record<string, any>): React.ReactElement {
return (
<div className="block-image" style={{ padding: '1rem' }}>
{data.src && (
<img
src={data.src}
alt={data.alt || ''}
style={{ maxWidth: '100%', height: 'auto' }}
/>
)}
{data.caption && <p style={{ fontSize: '0.9rem', color: '#666' }}>{data.caption}</p>}
</div>
);
}
/**
* Render button block.
*/
function renderButtonBlock(data: Record<string, any>): React.ReactElement {
return (
<div className="block-button" style={{ padding: '1rem', textAlign: data.align || 'center' }}>
<a
href={data.link || '#'}
className="button"
style={{
display: 'inline-block',
padding: '0.75rem 1.5rem',
background: data.color || '#007bff',
color: 'white',
textDecoration: 'none',
borderRadius: '4px'
}}
>
{data.text || 'Button'}
</a>
</div>
);
}
/**
* Render section block.
*/
function renderSectionBlock(data: Record<string, any>): React.ReactElement {
return (
<section className="block-section" style={{ padding: '3rem 2rem', background: data.background || 'transparent' }}>
{data.title && <h2>{data.title}</h2>}
{data.content && <div dangerouslySetInnerHTML={{ __html: data.content }} />}
</section>
);
}
/**
* Render grid block.
*/
function renderGridBlock(data: Record<string, any>): React.ReactElement {
const columns = data.columns || 3;
return (
<div className="block-grid" style={{ display: 'grid', gridTemplateColumns: `repeat(${columns}, 1fr)`, gap: '2rem', padding: '2rem' }}>
{data.items?.map((item: any, index: number) => (
<div key={index} className="grid-item">
{item.content && <div dangerouslySetInnerHTML={{ __html: item.content }} />}
</div>
))}
</div>
);
}
/**
* Render card block.
*/
function renderCardBlock(data: Record<string, any>): React.ReactElement {
return (
<div className="block-card" style={{ border: '1px solid #ddd', borderRadius: '8px', padding: '1.5rem', margin: '1rem' }}>
{data.title && <h3>{data.title}</h3>}
{data.content && <div dangerouslySetInnerHTML={{ __html: data.content }} />}
</div>
);
}
/**
* Render list block.
*/
function renderListBlock(data: Record<string, any>): React.ReactElement {
const listType = data.ordered ? 'ol' : 'ul';
return React.createElement(
listType,
{ className: 'block-list', style: { padding: '1rem 2rem' } },
data.items?.map((item: string, index: number) => (
<li key={index}>{item}</li>
))
);
}
/**
* Render quote block.
*/
function renderQuoteBlock(data: Record<string, any>): React.ReactElement {
return (
<blockquote className="block-quote" style={{ padding: '2rem', borderLeft: '4px solid #007bff', margin: '2rem 0', fontStyle: 'italic' }}>
{data.quote && <p>{data.quote}</p>}
{data.author && <cite> {data.author}</cite>}
</blockquote>
);
}
/**
* Render video block.
*/
function renderVideoBlock(data: Record<string, any>): React.ReactElement {
return (
<div className="block-video" style={{ padding: '1rem' }}>
{data.src && (
<video controls style={{ maxWidth: '100%' }}>
<source src={data.src} type={data.type || 'video/mp4'} />
</video>
)}
{data.embed && <div dangerouslySetInnerHTML={{ __html: data.embed }} />}
</div>
);
}
/**
* Render form block.
*/
function renderFormBlock(data: Record<string, any>): React.ReactElement {
return (
<form className="block-form" style={{ padding: '2rem', maxWidth: '600px', margin: '0 auto' }}>
{data.fields?.map((field: any, index: number) => (
<div key={index} style={{ marginBottom: '1rem' }}>
<label>{field.label}</label>
<input
type={field.type || 'text'}
name={field.name}
placeholder={field.placeholder}
style={{ width: '100%', padding: '0.5rem' }}
/>
</div>
))}
<button type="submit" style={{ padding: '0.75rem 1.5rem', background: '#007bff', color: 'white', border: 'none', borderRadius: '4px' }}>
{data.submitText || 'Submit'}
</button>
</form>
);
}
/**
* Render accordion block.
*/
function renderAccordionBlock(data: Record<string, any>): React.ReactElement {
return (
<div className="block-accordion" style={{ padding: '1rem' }}>
{data.items?.map((item: any, index: number) => (
<details key={index} style={{ marginBottom: '1rem', border: '1px solid #ddd', borderRadius: '4px', padding: '1rem' }}>
<summary style={{ cursor: 'pointer', fontWeight: 'bold' }}>{item.title}</summary>
<div style={{ marginTop: '1rem' }}>{item.content}</div>
</details>
))}
</div>
);
}