Loading content...
) : markdown ? (
diff --git a/src/frontend/src/Header.tsx b/src/frontend/src/Header.tsx
index 953f834..6ab5bf1 100644
--- a/src/frontend/src/Header.tsx
+++ b/src/frontend/src/Header.tsx
@@ -10,21 +10,36 @@ export function Header({ config }: { config: UIConfig }) {
: config.components?.header
const header = (headerComponent?.props || headerSlot?.props) as {
logoText?: string
+ logoImage?: string
links?: { label: string; href: string }[]
cta?: { label: string; href: string }
} | undefined
+ // Get logo configuration - support both header.logoImage and config.logo
+ const logoConfig = config.logo
+ const isDarkMode = document.documentElement.classList.contains('dark')
+ const logoSrc = header?.logoImage || (logoConfig ? (isDarkMode ? (logoConfig.dark || logoConfig.light) : (logoConfig.light || logoConfig.dark)) : null)
+ const logoHref = logoConfig?.href || '/'
+
return (
- {
+ {
e.preventDefault()
- window.history.pushState({}, '', '/')
+ window.history.pushState({}, '', logoHref)
window.location.reload()
}}>
- 
+ ) : (
+
+}
+
+export interface I18nConfig {
+ defaultLocale?: string
+ locales?: string[]
+ rtlLocales?: string[]
+ fallbackLocale?: string
+ translationsDir?: string
+}
+
+export interface A11yConfig {
+ skipToContent?: boolean
+ focusVisible?: boolean
+ reduceMotion?: boolean
+ ariaLabels?: Record
+}
+
+export interface LogoConfig {
+ light?: string
+ dark?: string
+ href?: string
+}
+
export interface WidgetConfig {
type: string
props?: Record
@@ -58,6 +85,10 @@ export interface UIConfig {
widgets?: InputWidget[]
components?: Record }>
templates?: Record
+ seo?: SEOConfig
+ i18n?: I18nConfig
+ a11y?: A11yConfig
+ logo?: LogoConfig
}
export interface DocsNav {
diff --git a/src/praisonaiui/cli.py b/src/praisonaiui/cli.py
index 214a222..1da7fb4 100644
--- a/src/praisonaiui/cli.py
+++ b/src/praisonaiui/cli.py
@@ -220,7 +220,7 @@ def validate(
console.print(f"[red]Error:[/red] Failed to parse configuration: {e}")
raise typer.Exit(code=1)
- result = validate_config(cfg, config.parent)
+ result = validate_config(cfg, config.parent, strict=strict)
if result.valid:
console.print("[green]✓[/green] Configuration is valid")
diff --git a/src/praisonaiui/compiler/compiler.py b/src/praisonaiui/compiler/compiler.py
index eb3c2b7..33a754e 100644
--- a/src/praisonaiui/compiler/compiler.py
+++ b/src/praisonaiui/compiler/compiler.py
@@ -271,6 +271,35 @@ class Compiler:
"provider": self.config.search.provider,
}
+ # ── Enterprise features (partial implementation) ──
+
+ # SEO configuration - basic implementation for static build
+ if self.config.seo:
+ result["seo"] = {
+ "titleTemplate": self.config.seo.title_template,
+ "defaultImage": self.config.seo.default_image,
+ "twitter": self.config.seo.twitter,
+ }
+
+ # A11y configuration - basic implementation for frontend
+ if self.config.a11y:
+ result["a11y"] = {
+ "skipToContent": self.config.a11y.skip_to_content,
+ "focusVisible": self.config.a11y.focus_visible,
+ "reduceMotion": self.config.a11y.reduce_motion,
+ "ariaLabels": self.config.a11y.aria_labels,
+ }
+
+ # I18n configuration - emit for frontend consumption (experimental)
+ if self.config.i18n:
+ result["i18n"] = {
+ "defaultLocale": self.config.i18n.default_locale,
+ "locales": self.config.i18n.locales,
+ "rtlLocales": self.config.i18n.rtl_locales,
+ "fallbackLocale": self.config.i18n.fallback_locale,
+ "translationsDir": self.config.i18n.translations_dir,
+ }
+
return result
def _serialize_template(self, template) -> dict:
@@ -543,18 +572,53 @@ class Compiler:
def _build_seo_tags(self, path: str, title: str, description: str) -> str:
"""Build canonical, OG, and Twitter meta tags."""
- t = self._escape_html(title)
d = self._escape_html(description)
p = self._escape_html(path)
- return (
- f' \n'
- f' \n'
- f' \n'
- f' \n'
- f' \n'
- f' \n'
- f' '
- )
+
+ # Extract original page title by removing the site title suffix if present
+ site_title = self.config.site.title
+ page_title = title
+ suffix = f" | {site_title}"
+ if page_title.endswith(suffix):
+ page_title = page_title[:-len(suffix)]
+
+ # Use configured title template if available
+ if self.config.seo and self.config.seo.title_template:
+ template = self.config.seo.title_template
+ if "%s" in template:
+ parts = template.split("%s")
+ if len(parts) >= 3:
+ t = self._escape_html(f"{parts[0]}{page_title}{parts[1]}{site_title}{''.join(parts[2:])}")
+ else:
+ t = self._escape_html(template.replace("%s", page_title, 1))
+ else:
+ t = self._escape_html(template)
+ else:
+ t = self._escape_html(title)
+
+ tags = [
+ f' ',
+ f' ',
+ f' ',
+ f' ',
+ ]
+
+ # Add default OG image if configured
+ if self.config.seo and self.config.seo.default_image:
+ og_image = self._escape_html(self.config.seo.default_image)
+ tags.append(f' ')
+
+ # Add Twitter card tags
+ tags.append(' ')
+ tags.append(f' ')
+ tags.append(f' ')
+
+ # Add Twitter handle if configured
+ if self.config.seo and self.config.seo.twitter and "handle" in self.config.seo.twitter:
+ handle = self._escape_html(self.config.seo.twitter["handle"])
+ tags.append(f' ')
+
+ return "\n".join(tags)
def _get_noscript_content(self, output_dir: Path, path: str) -> str:
"""Load markdown file and convert to simple HTML for noscript block."""
diff --git a/src/praisonaiui/schema/features.py b/src/praisonaiui/schema/features.py
new file mode 100644
index 0000000..01cfa90
--- /dev/null
+++ b/src/praisonaiui/schema/features.py
@@ -0,0 +1,112 @@
+"""Feature registry for config validation."""
+
+from __future__ import annotations
+
+from dataclasses import dataclass
+from enum import Enum
+from typing import TYPE_CHECKING
+
+if TYPE_CHECKING:
+ from praisonaiui.schema.models import Config
+
+
+class FeatureStatus(Enum):
+ """Status of a configuration feature."""
+
+ IMPLEMENTED = "implemented"
+ EXPERIMENTAL = "experimental"
+ DEPRECATED = "deprecated"
+
+
+@dataclass
+class FeatureInfo:
+ """Information about a configuration feature."""
+
+ name: str
+ status: FeatureStatus
+ since: str | None = None
+ description: str | None = None
+
+
+class ConfigFeatureRegistry:
+ """Registry of configuration features and their implementation status."""
+
+ def __init__(self):
+ self._features = {
+ # Core features - fully implemented
+ "site": FeatureInfo("site", FeatureStatus.IMPLEMENTED, "0.1.0"),
+ "components": FeatureInfo("components", FeatureStatus.IMPLEMENTED, "0.1.0"),
+ "templates": FeatureInfo("templates", FeatureStatus.IMPLEMENTED, "0.1.0"),
+ "routes": FeatureInfo("routes", FeatureStatus.IMPLEMENTED, "0.1.0"),
+ "content": FeatureInfo("content", FeatureStatus.IMPLEMENTED, "0.1.0"),
+ "style": FeatureInfo("style", FeatureStatus.IMPLEMENTED, "0.1.0"),
+ "layout": FeatureInfo("layout", FeatureStatus.IMPLEMENTED, "0.2.0"),
+ "chat": FeatureInfo("chat", FeatureStatus.IMPLEMENTED, "0.2.0"),
+ "auth": FeatureInfo("auth", FeatureStatus.IMPLEMENTED, "0.3.0"),
+ "widgets": FeatureInfo("widgets", FeatureStatus.IMPLEMENTED, "0.3.0"),
+ "dependencies": FeatureInfo("dependencies", FeatureStatus.IMPLEMENTED, "0.3.0"),
+
+ # Mintlify-parity features - implemented
+ "logo": FeatureInfo("logo", FeatureStatus.IMPLEMENTED, "0.4.0"),
+ "navigation": FeatureInfo("navigation", FeatureStatus.IMPLEMENTED, "0.4.0"),
+ "navbar": FeatureInfo("navbar", FeatureStatus.IMPLEMENTED, "0.4.0"),
+ "footer": FeatureInfo("footer", FeatureStatus.IMPLEMENTED, "0.4.0"),
+ "search": FeatureInfo("search", FeatureStatus.IMPLEMENTED, "0.4.0"),
+ "dashboard": FeatureInfo("dashboard", FeatureStatus.IMPLEMENTED, "0.4.0"),
+
+ # Enterprise features - partial implementation
+ "seo": FeatureInfo("seo", FeatureStatus.IMPLEMENTED, "0.5.0",
+ "SEO configuration with title templates, OG tags, Twitter meta - basic implementation"),
+ "a11y": FeatureInfo("a11y", FeatureStatus.IMPLEMENTED, "0.5.0",
+ "Accessibility configuration - basic implementation for skip links and ARIA labels"),
+ "i18n": FeatureInfo("i18n", FeatureStatus.EXPERIMENTAL, None,
+ "Internationalization accepted in schema but content pipeline/routing not implemented"),
+ }
+
+ def get_feature(self, name: str) -> FeatureInfo | None:
+ """Get information about a feature."""
+ return self._features.get(name)
+
+ def is_implemented(self, name: str) -> bool:
+ """Check if a feature is fully implemented."""
+ feature = self._features.get(name)
+ return feature is not None and feature.status == FeatureStatus.IMPLEMENTED
+
+ def is_experimental(self, name: str) -> bool:
+ """Check if a feature is experimental."""
+ feature = self._features.get(name)
+ return feature is not None and feature.status == FeatureStatus.EXPERIMENTAL
+
+ def get_unimplemented_fields(self, config: Config) -> list[str]:
+ """Get list of config fields that are not fully implemented."""
+ unimplemented = []
+
+ # Check top-level config fields
+ config_dict = config.model_dump(exclude_none=True)
+ for field_name in config_dict:
+ if field_name in ("schema_version", "schemaVersion"):
+ continue
+ if not self.is_implemented(field_name):
+ unimplemented.append(field_name)
+
+ return unimplemented
+
+ def get_experimental_fields(self, config: Config) -> list[str]:
+ """Get list of config fields that are experimental."""
+ experimental = []
+
+ config_dict = config.model_dump(exclude_none=True)
+ for field_name in config_dict:
+ if self.is_experimental(field_name):
+ experimental.append(field_name)
+
+ return experimental
+
+
+# Global registry instance
+_registry = ConfigFeatureRegistry()
+
+
+def get_feature_registry() -> ConfigFeatureRegistry:
+ """Get the global feature registry."""
+ return _registry
diff --git a/src/praisonaiui/schema/validators.py b/src/praisonaiui/schema/validators.py
index 834a1aa..3f3fe91 100644
--- a/src/praisonaiui/schema/validators.py
+++ b/src/praisonaiui/schema/validators.py
@@ -2,6 +2,7 @@
from __future__ import annotations
+import warnings
from dataclasses import dataclass
from pathlib import Path
from typing import TYPE_CHECKING
@@ -41,7 +42,7 @@ class ValidationResult:
return cls(valid=False, errors=errors)
-def validate_config(config: Config, base_path: Path | None = None) -> ValidationResult:
+def validate_config(config: Config, base_path: Path | None = None, strict: bool = False) -> ValidationResult:
"""
Validate a configuration object.
@@ -50,10 +51,12 @@ def validate_config(config: Config, base_path: Path | None = None) -> Validation
- All template refs are valid
- Content directories exist
- Route patterns are valid globs
+ - Feature implementation status (if strict=True)
Args:
config: The configuration to validate
base_path: Base path for resolving relative paths
+ strict: If True, warns about unimplemented/experimental features
Returns:
ValidationResult with any errors found
@@ -107,6 +110,31 @@ def validate_config(config: Config, base_path: Path | None = None) -> Validation
)
)
+ # Validate feature implementation status
+ if strict:
+ from praisonaiui.schema.features import get_feature_registry
+
+ registry = get_feature_registry()
+ experimental_fields = registry.get_experimental_fields(config)
+
+ for field in experimental_fields:
+ feature = registry.get_feature(field)
+ if feature:
+ errors.append(
+ ValidationError(
+ code=4001,
+ category="features",
+ message=f"Field '{field}' is experimental and not fully implemented: {feature.description}",
+ suggestion="Remove this field or run validation without the --strict flag",
+ )
+ )
+ # Also emit runtime warning
+ warnings.warn(
+ f"Config field '{field}' is experimental: {feature.description}",
+ UserWarning,
+ stacklevel=2
+ )
+
if errors:
return ValidationResult.failure(errors)
return ValidationResult.success()
diff --git a/test_validation.py b/test_validation.py
new file mode 100644
index 0000000..258c628
--- /dev/null
+++ b/test_validation.py
@@ -0,0 +1,33 @@
+#!/usr/bin/env python3
+"""Test script to demonstrate the new validation functionality."""
+
+import yaml
+from pathlib import Path
+from praisonaiui.schema.models import Config
+from praisonaiui.schema.validators import validate_config
+
+# Test with the 11-full-featured example
+config_path = Path("examples/yaml/11-full-featured/aiui.template.yaml")
+
+if config_path.exists():
+ with open(config_path) as f:
+ data = yaml.safe_load(f)
+
+ cfg = Config.model_validate(data)
+
+ # Test regular validation
+ result = validate_config(cfg, config_path.parent)
+ print(f"Regular validation: {'✓ PASS' if result.valid else '✗ FAIL'}")
+
+ # Test strict validation
+ result_strict = validate_config(cfg, config_path.parent, strict=True)
+ print(f"Strict validation: {'✓ PASS' if result_strict.valid else '✗ FAIL'}")
+
+ if not result_strict.valid:
+ print("\nStrict validation errors:")
+ for error in result_strict.errors:
+ print(f" [{error.category}] {error.message}")
+ if error.suggestion:
+ print(f" 💡 {error.suggestion}")
+else:
+ print(f"Config file not found: {config_path}")
\ No newline at end of file
diff --git a/tests/unit/test_config_feature_registry.py b/tests/unit/test_config_feature_registry.py
new file mode 100644
index 0000000..ec7d3cb
--- /dev/null
+++ b/tests/unit/test_config_feature_registry.py
@@ -0,0 +1,59 @@
+"""Tests for the config feature registry."""
+
+from praisonaiui.schema.features import ConfigFeatureRegistry, FeatureStatus
+from praisonaiui.schema.models import Config, I18nConfig, SEOConfig, SiteConfig
+
+
+def test_feature_registry_basic():
+ """Test basic feature registry functionality."""
+ registry = ConfigFeatureRegistry()
+
+ # Test implemented features
+ assert registry.is_implemented("site")
+ assert registry.is_implemented("seo")
+ assert registry.is_implemented("a11y")
+
+ # Test experimental features
+ assert registry.is_experimental("i18n")
+
+ # Test non-existent features
+ assert not registry.is_implemented("nonexistent")
+ assert not registry.is_experimental("nonexistent")
+
+
+def test_feature_registry_with_config():
+ """Test feature registry with actual config objects."""
+ registry = ConfigFeatureRegistry()
+
+ # Config with only implemented features
+ config = Config(
+ site=SiteConfig(title="Test"),
+ seo=SEOConfig(title_template="%s | Test")
+ )
+
+ experimental = registry.get_experimental_fields(config)
+ assert experimental == []
+
+ # Config with experimental features
+ config_with_experimental = Config(
+ site=SiteConfig(title="Test"),
+ i18n=I18nConfig(locales=["en", "es"])
+ )
+
+ experimental = registry.get_experimental_fields(config_with_experimental)
+ assert "i18n" in experimental
+
+
+def test_feature_info():
+ """Test FeatureInfo structure."""
+ registry = ConfigFeatureRegistry()
+
+ seo_info = registry.get_feature("seo")
+ assert seo_info is not None
+ assert seo_info.status == FeatureStatus.IMPLEMENTED
+ assert seo_info.since == "0.5.0"
+
+ i18n_info = registry.get_feature("i18n")
+ assert i18n_info is not None
+ assert i18n_info.status == FeatureStatus.EXPERIMENTAL
+ assert i18n_info.since is None
- AI
-
+ {logoSrc ? (
+
+ AI
+
+ )}
{header?.logoText || config.site?.title || 'PraisonAIUI'}
diff --git a/src/frontend/src/types.ts b/src/frontend/src/types.ts
index 134c3ff..997247a 100644
--- a/src/frontend/src/types.ts
+++ b/src/frontend/src/types.ts
@@ -20,6 +20,33 @@ export interface SiteConfig {
theme?: ThemeConfig
}
+export interface SEOConfig {
+ titleTemplate?: string
+ defaultImage?: string
+ twitter?: Record