npm - sovrium - Versions diffs - 0.0.2 - Mend

sovrium 0.0.2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (527) hide show

package/src/domain/models/app/page/meta/dns-prefetch.ts ADDED Viewed

@@ -0,0 +1,77 @@
+/**
+ * Copyright (c) 2025 ESSENTIAL SERVICES
+ *
+ * This source code is licensed under the Business Source License 1.1
+ * found in the LICENSE.md file in the root directory of this source tree.
+ */
+import { Schema } from 'effect'
+import { HttpUrlSchema } from '../common/url'
+/**
+ * DNS prefetch domain URL
+ *
+ * Absolute URL to external domain for DNS prefetching.
+ * - Pattern: ^https?:// (must start with http:// or https://)
+ * - Examples: https://fonts.googleapis.com, https://www.google-analytics.com
+ * - Format: uri (valid URL)
+ */
+export const DnsPrefetchDomainSchema = HttpUrlSchema.annotations({
+  description: 'Domain to prefetch DNS for',
+})
+/**
+ * DNS prefetch hints for external domains
+ *
+ * Array of external domain URLs to perform DNS resolution early in page load.
+ * Reduces connection latency by resolving domain names before resources are requested.
+ *
+ * How DNS prefetch works:
+ * 1. Browser receives <link rel="dns-prefetch" href="..."> in <head>
+ * 2. Browser resolves domain name to IP address in the background
+ * 3. When resource is later requested, DNS is already resolved (faster connection)
+ * 4. Reduces latency by 20-120ms per domain (DNS lookup time)
+ *
+ * Common use cases:
+ * - **Fonts**: https://fonts.googleapis.com, https://fonts.gstatic.com
+ * - **Analytics**: https://www.google-analytics.com, https://plausible.io
+ * - **CDNs**: https://unpkg.com, https://cdn.jsdelivr.net, https://cdnjs.cloudflare.com
+ * - **Social**: https://www.facebook.com, https://platform.twitter.com
+ * - **APIs**: https://api.example.com (backend API domains)
+ *
+ * Performance impact:
+ * - DNS resolution: typically 20-120ms per domain
+ * - Mobile networks: DNS can take 200-500ms (critical optimization)
+ * - First request: DNS + TCP + TLS handshake (300-1000ms total)
+ * - With DNS prefetch: Only TCP + TLS (100-400ms total)
+ *
+ * Best practices:
+ * - Only prefetch domains with high certainty of use (avoid wasting bandwidth)
+ * - Limit to 4-6 domains (too many = diminishing returns)
+ * - Include domains for critical resources (fonts, analytics, CDN)
+ * - Combine with preconnect for even faster connections (DNS + TCP + TLS)
+ *
+ * @example
+ * ```typescript
+ * const dnsPrefetch = [
+ *   // Google Fonts (most common external resource)
+ *   'https://fonts.googleapis.com',
+ *   'https://fonts.gstatic.com',
+ *   // Analytics
+ *   'https://www.google-analytics.com',
+ *   // CDN
+ *   'https://cdn.example.com',
+ *   // API backend
+ *   'https://api.example.com'
+ * ]
+ * ```
+ *
+ * @see specs/app/pages/meta/performance/dns-prefetch.schema.json
+ */
+export const DnsPrefetchSchema = Schema.Array(DnsPrefetchDomainSchema).annotations({
+  title: 'DNS Prefetch',
+  description: 'DNS prefetch hints for external domains',
+})
+export type DnsPrefetchDomain = Schema.Schema.Type<typeof DnsPrefetchDomainSchema>
+export type DnsPrefetch = Schema.Schema.Type<typeof DnsPrefetchSchema>

package/src/domain/models/app/page/meta/favicon-set.ts ADDED Viewed

@@ -0,0 +1,203 @@
+/**
+ * Copyright (c) 2025 ESSENTIAL SERVICES
+ *
+ * This source code is licensed under the Business Source License 1.1
+ * found in the LICENSE.md file in the root directory of this source tree.
+ */
+import { Schema } from 'effect'
+import { HexColorSchema } from '@/domain/models/app/common/definitions'
+/**
+ * Favicon relationship type
+ *
+ * 4 types of favicons for different contexts:
+ * - icon: Standard browser favicon (most common)
+ * - apple-touch-icon: iOS home screen icon
+ * - manifest: PWA manifest file reference
+ * - mask-icon: Safari pinned tab icon (monochrome SVG)
+ */
+export const FaviconRelSchema = Schema.Literal(
+  'icon',
+  'apple-touch-icon',
+  'manifest',
+  'mask-icon'
+).annotations({
+  description: 'Favicon relationship type',
+})
+/**
+ * Favicon item in a multi-device favicon set
+ *
+ * Defines a single favicon for a specific device or context.
+ *
+ * Required properties:
+ * - rel: Relationship type (icon, apple-touch-icon, manifest, mask-icon)
+ * - href: Path to the favicon file (relative, starts with ./)
+ *
+ * Optional properties:
+ * - type: MIME type (image/png, image/x-icon, image/svg+xml)
+ * - sizes: Icon dimensions (16x16, 32x32, 180x180, 192x192, 512x512)
+ * - color: Hex color for mask-icon (Safari pinned tab)
+ *
+ * Common favicon set:
+ * - 16x16: Browser tab (small)
+ * - 32x32: Browser tab (standard)
+ * - 180x180: Apple touch icon (iOS home screen)
+ * - 192x192: Android icon (home screen)
+ * - 512x512: PWA icon (splash screen)
+ *
+ * @example
+ * ```typescript
+ * const browserIcon = {
+ *   rel: 'icon',
+ *   type: 'image/png',
+ *   sizes: '32x32',
+ *   href: './public/favicon/favicon-32x32.png'
+ * }
+ *
+ * const appleIcon = {
+ *   rel: 'apple-touch-icon',
+ *   sizes: '180x180',
+ *   href: './public/favicon/apple-touch-icon.png'
+ * }
+ *
+ * const safariIcon = {
+ *   rel: 'mask-icon',
+ *   href: './public/favicon/safari-pinned-tab.svg',
+ *   color: '#5BBAD5'
+ * }
+ *
+ * const manifestRef = {
+ *   rel: 'manifest',
+ *   href: './public/favicon/site.webmanifest'
+ * }
+ * ```
+ */
+export const FaviconItemSchema = Schema.Struct({
+  rel: FaviconRelSchema,
+  type: Schema.optional(
+    Schema.String.pipe(
+      Schema.pattern(/^image\//, {
+        message: () => 'MIME type must start with image/ (e.g., image/png, image/x-icon)',
+      })
+    ).annotations({
+      description: 'MIME type',
+      examples: ['image/png', 'image/x-icon', 'image/svg+xml'],
+    })
+  ),
+  sizes: Schema.optional(
+    Schema.String.pipe(
+      Schema.pattern(/^[0-9]+x[0-9]+$/, {
+        message: () => 'Sizes must be in format WIDTHxHEIGHT (e.g., 16x16, 32x32, 180x180)',
+      })
+    ).annotations({
+      description: 'Icon dimensions',
+      examples: ['16x16', '32x32', '180x180', '192x192'],
+    })
+  ),
+  href: Schema.String.pipe(
+    Schema.pattern(/^\.\//, {
+      message: () => 'Favicon path must be relative starting with ./',
+    })
+  ).annotations({
+    description: 'Path to the favicon file',
+  }),
+  color: Schema.optional(
+    HexColorSchema.annotations({
+      description: 'Color for mask-icon (Safari pinned tab)',
+    })
+  ),
+}).annotations({
+  description: 'Favicon item',
+})
+/**
+ * Multiple favicon sizes and types for different devices
+ *
+ * Comprehensive favicon configuration for cross-device compatibility.
+ * Includes icons for browsers, iOS, Android, PWAs, and Safari pinned tabs.
+ *
+ * Recommended favicon set:
+ * 1. Browser tabs:
+ *    - 16x16 (icon, image/png) - small display
+ *    - 32x32 (icon, image/png) - standard display
+ *
+ * 2. iOS devices:
+ *    - 180x180 (apple-touch-icon) - home screen icon
+ *
+ * 3. Android devices:
+ *    - 192x192 (icon, image/png) - home screen icon
+ *    - 512x512 (icon, image/png) - splash screen
+ *
+ * 4. Safari pinned tabs:
+ *    - mask-icon (SVG) with color - monochrome pinned tab icon
+ *
+ * 5. PWA manifest:
+ *    - manifest (site.webmanifest) - PWA configuration
+ *
+ * Browser support:
+ * - icon: All browsers
+ * - apple-touch-icon: Safari (iOS), Chrome (Android add to home screen)
+ * - mask-icon: Safari 9+ (macOS pinned tabs)
+ * - manifest: Chrome, Edge, Firefox, Safari (PWA support)
+ *
+ * @example
+ * ```typescript
+ * const completeFaviconSet = [
+ *   // Browser tabs
+ *   {
+ *     rel: 'icon',
+ *     type: 'image/png',
+ *     sizes: '16x16',
+ *     href: './public/favicon/favicon-16x16.png'
+ *   },
+ *   {
+ *     rel: 'icon',
+ *     type: 'image/png',
+ *     sizes: '32x32',
+ *     href: './public/favicon/favicon-32x32.png'
+ *   },
+ *   // iOS home screen
+ *   {
+ *     rel: 'apple-touch-icon',
+ *     sizes: '180x180',
+ *     href: './public/favicon/apple-touch-icon.png'
+ *   },
+ *   // Android/PWA
+ *   {
+ *     rel: 'icon',
+ *     type: 'image/png',
+ *     sizes: '192x192',
+ *     href: './public/favicon/android-chrome-192x192.png'
+ *   },
+ *   {
+ *     rel: 'icon',
+ *     type: 'image/png',
+ *     sizes: '512x512',
+ *     href: './public/favicon/android-chrome-512x512.png'
+ *   },
+ *   // Safari pinned tabs
+ *   {
+ *     rel: 'mask-icon',
+ *     href: './public/favicon/safari-pinned-tab.svg',
+ *     color: '#5BBAD5'
+ *   },
+ *   // PWA manifest
+ *   {
+ *     rel: 'manifest',
+ *     href: './public/favicon/site.webmanifest'
+ *   }
+ * ]
+ * ```
+ *
+ * @see specs/app/pages/meta/favicons/favicon-set.schema.json
+ */
+export const FaviconSetSchema = Schema.Array(FaviconItemSchema).annotations({
+  title: 'Favicon Set',
+  description: 'Multiple favicon sizes and types for different devices',
+})
+export type FaviconRel = Schema.Schema.Type<typeof FaviconRelSchema>
+export type FaviconItem = Schema.Schema.Type<typeof FaviconItemSchema>
+export type FaviconSet = Schema.Schema.Type<typeof FaviconSetSchema>

package/src/domain/models/app/page/meta/favicon.ts ADDED Viewed

@@ -0,0 +1,50 @@
+/**
+ * Copyright (c) 2025 ESSENTIAL SERVICES
+ *
+ * This source code is licensed under the Business Source License 1.1
+ * found in the LICENSE.md file in the root directory of this source tree.
+ */
+import { Schema } from 'effect'
+/**
+ * Default favicon path
+ *
+ * Simple string pointing to the default favicon file.
+ * Supports 3 formats: .ico (legacy), .png (modern), .svg (scalable).
+ *
+ * Pattern: Must be a relative path starting with ./ and ending with .ico, .png, or .svg
+ *
+ * Common locations:
+ * - ./public/favicon.ico (Next.js, React, standard)
+ * - ./favicon.png (root directory)
+ * - ./assets/favicon.svg (assets folder)
+ *
+ * Format recommendations:
+ * - .ico: Legacy support (IE11, old browsers), 16x16 or 32x32
+ * - .png: Modern standard, 32x32 or 192x192
+ * - .svg: Scalable, best quality, smallest file size
+ *
+ * Use this for simple favicon setup. For multi-device support with
+ * Apple touch icons, Android icons, etc., use FaviconSetSchema instead.
+ *
+ * @example
+ * ```typescript
+ * const icoFavicon = './public/favicon.ico'
+ * const pngFavicon = './favicon.png'
+ * const svgFavicon = './assets/favicon.svg'
+ * ```
+ *
+ * @see specs/app/pages/meta/favicons/favicon.schema.json
+ */
+export const FaviconSchema = Schema.String.pipe(
+  Schema.pattern(/^\.\/.+\.(ico|png|svg)$/, {
+    message: () =>
+      'Favicon must be a relative path starting with ./ and ending with .ico, .png, or .svg (e.g., ./public/favicon.ico)',
+  })
+).annotations({
+  title: 'Favicon',
+  description: 'Default favicon path',
+})
+export type Favicon = Schema.Schema.Type<typeof FaviconSchema>

package/src/domain/models/app/page/meta/favicons-config.ts ADDED Viewed

@@ -0,0 +1,73 @@
+/**
+ * Copyright (c) 2025 ESSENTIAL SERVICES
+ *
+ * This source code is licensed under the Business Source License 1.1
+ * found in the LICENSE.md file in the root directory of this source tree.
+ */
+import { Schema } from 'effect'
+/**
+ * Size specification for favicon
+ */
+export const FaviconSizeItemSchema = Schema.Struct({
+  size: Schema.String.pipe(
+    Schema.pattern(/^[0-9]+x[0-9]+$/, {
+      message: () => 'Size must be in format WIDTHxHEIGHT (e.g., 16x16, 32x32)',
+    })
+  ).annotations({
+    description: 'Icon dimensions (e.g., 32x32, 16x16)',
+  }),
+  href: Schema.String.annotations({
+    description: 'Path to the favicon file',
+  }),
+}).annotations({
+  description: 'Favicon size specification',
+})
+/**
+ * Helper configuration for favicons with named properties
+ *
+ * This is a convenience format that gets transformed into FaviconSet array.
+ * Provides a simpler API for common favicon configurations.
+ *
+ * Properties:
+ * - icon: Default favicon (usually SVG or ICO)
+ * - appleTouchIcon: iOS home screen icon
+ * - sizes: Array of size-specific PNG favicons
+ *
+ * @example
+ * ```typescript
+ * const faviconsConfig = {
+ *   icon: '/icon.svg',
+ *   appleTouchIcon: '/apple-touch-icon.png',
+ *   sizes: [
+ *     { size: '32x32', href: '/favicon-32x32.png' },
+ *     { size: '16x16', href: '/favicon-16x16.png' }
+ *   ]
+ * }
+ * ```
+ */
+export const FaviconsConfigSchema = Schema.Struct({
+  icon: Schema.optional(
+    Schema.String.annotations({
+      description: 'Default icon (SVG or ICO)',
+    })
+  ),
+  appleTouchIcon: Schema.optional(
+    Schema.String.annotations({
+      description: 'iOS home screen icon',
+    })
+  ),
+  sizes: Schema.optional(
+    Schema.Array(FaviconSizeItemSchema).annotations({
+      description: 'Size-specific favicons',
+    })
+  ),
+}).annotations({
+  title: 'Favicons Configuration',
+  description: 'Helper configuration for favicons with named properties',
+})
+export type FaviconSizeItem = Schema.Schema.Type<typeof FaviconSizeItemSchema>
+export type FaviconsConfig = Schema.Schema.Type<typeof FaviconsConfigSchema>

package/src/domain/models/app/page/meta/index.ts ADDED Viewed

@@ -0,0 +1,278 @@
+/**
+ * Copyright (c) 2025 ESSENTIAL SERVICES
+ *
+ * This source code is licensed under the Business Source License 1.1
+ * found in the LICENSE.md file in the root directory of this source tree.
+ */
+import { Schema } from 'effect'
+import { AnalyticsSchema } from './analytics'
+import { CustomElementsSchema } from './custom-elements'
+import { DnsPrefetchSchema } from './dns-prefetch'
+import { FaviconSchema } from './favicon'
+import { FaviconSetSchema } from './favicon-set'
+import { FaviconsConfigSchema } from './favicons-config'
+import { OpenGraphSchema } from './open-graph'
+import { PreloadSchema } from './preload'
+import { TwitterCardSchema } from './twitter-card'
+/**
+ * Language code format
+ *
+ * ISO 639-1 language code with optional ISO 3166-1 country code.
+ * - Pattern: ^[a-z]{2}(-[A-Z]{2})?$ (2 lowercase letters, optional hyphen + 2 uppercase)
+ * - Examples: en, en-US, fr, fr-FR, es-ES, de, de-DE, ja, ja-JP
+ * - Used in <html lang="..."> attribute
+ */
+export const LanguageCodeSchema = Schema.String.pipe(
+  Schema.pattern(/^[a-z]{2}(-[A-Z]{2})?$/, {
+    message: () =>
+      'Language code must be ISO 639-1 format with optional country (e.g., en, en-US, fr-FR, es-ES)',
+  })
+).annotations({
+  description: 'Page language code (ISO 639-1 with optional country)',
+  examples: ['en-US', 'fr-FR', 'es-ES', 'de-DE'],
+})
+/**
+ * Comprehensive page metadata
+ *
+ * Master orchestrator schema that combines all meta categories into a single configuration.
+ * Provides comprehensive SEO, social media, structured data, performance, and analytics
+ * capabilities for optimal web presence.
+ *
+ * Required properties:
+ * - title: Page title for browser tab and SEO (max 60 chars)
+ * - description: Page description for SEO and social sharing (max 160 chars)
+ *
+ * Semi-optional properties:
+ * - lang: Page language code (e.g., "en-US", "fr-FR"). Optional to allow auto-detection
+ *
+ * Optional SEO properties:
+ * - keywords: Comma-separated keywords (limited SEO impact, mostly legacy)
+ * - author: Page author or organization name
+ * - canonical: Canonical URL to prevent duplicate content issues
+ *
+ * Optional resource properties:
+ * - favicon: Simple single favicon path (e.g., "./favicon.ico")
+ * - favicons: Complete favicon set for multi-device support
+ * - stylesheet: Path to main stylesheet (e.g., "./output.css")
+ * - googleFonts: Google Fonts API URL
+ * - socialImage: Default image for social sharing (fallback)
+ *
+ * Optional social media properties:
+ * - openGraph: Open Graph metadata for Facebook/LinkedIn
+ * - twitter: Twitter Card metadata for Twitter/X
+ *
+ * Optional structured data:
+ * - schema: Schema.org structured data for rich results
+ *
+ * Optional performance:
+ * - preload: Resource preloading for faster page load
+ * - dnsPrefetch: DNS prefetch hints for external domains
+ *
+ * Optional analytics:
+ * - analytics: Analytics provider configuration (Google, Plausible, etc.)
+ *
+ * Optional custom:
+ * - customElements: Arbitrary HTML elements for <head> (escape hatch)
+ *
+ * Metadata categories and their purposes:
+ * 1. **SEO basics**: title, description, keywords, canonical, author
+ * 2. **Branding**: favicon/favicons, stylesheet, socialImage
+ * 3. **Social media**: openGraph (Facebook/LinkedIn), twitter (Twitter/X)
+ * 4. **Rich results**: schema (Schema.org structured data)
+ * 5. **Performance**: preload (critical resources), dnsPrefetch (external domains)
+ * 6. **Analytics**: analytics (tracking providers)
+ * 7. **Custom**: customElements (escape hatch for special cases)
+ *
+ * Common page patterns:
+ * - **Homepage**: lang + title + description + openGraph + twitter + schema (organization) + analytics
+ * - **Blog post**: + schema (article + breadcrumb + person) + canonical
+ * - **Product page**: + schema (product + breadcrumb) + preload (hero image)
+ * - **FAQ page**: + schema (faqPage + breadcrumb)
+ * - **Event page**: + schema (educationEvent + breadcrumb)
+ *
+ * @example
+ * ```typescript
+ * const meta = {
+ *   lang: "en-US",
+ *   title: "Complete Page Metadata Example",
+ *   description: "Comprehensive metadata with SEO, social, structured data, performance, and analytics.",
+ *   keywords: "metadata, seo, social media, structured data",
+ *   canonical: "https://example.com/complete",
+ *   favicon: "./favicon.ico",
+ *   stylesheet: "./output.css",
+ *   openGraph: {
+ *     title: "Complete Page Metadata Example",
+ *     description: "Comprehensive metadata...",
+ *     type: "website",
+ *     url: "https://example.com/complete",
+ *     image: "https://example.com/og-image.jpg"
+ *   },
+ *   twitter: {
+ *     card: "summary_large_image",
+ *     title: "Complete Page Metadata Example",
+ *     image: "https://example.com/twitter-image.jpg"
+ *   },
+ *   schema: {
+ *     organization: {
+ *       "@context": "https://schema.org",
+ *       "@type": "Organization",
+ *       name: "Acme Inc"
+ *     }
+ *   },
+ *   dnsPrefetch: ["https://fonts.googleapis.com"],
+ *   analytics: {
+ *     providers: [
+ *       {
+ *         name: "google",
+ *         enabled: true,
+ *         config: { trackingId: "G-XXXXXXXXXX" }
+ *       }
+ *     ]
+ *   }
+ * }
+ * ```
+ *
+ * @see specs/app/pages/meta/meta.schema.json
+ */
+export const MetaSchema = Schema.Struct({
+  lang: Schema.optional(
+    LanguageCodeSchema.annotations({
+      description: 'Page language code (optional - uses auto-detection if not specified)',
+    })
+  ),
+  title: Schema.String.pipe(Schema.maxLength(60)).annotations({
+    description: 'Page title for browser tab and SEO (max 60 characters for optimal display)',
+  }),
+  description: Schema.optional(
+    Schema.String.pipe(Schema.maxLength(160)).annotations({
+      description: 'Page description for SEO and social sharing (max 160 characters)',
+    })
+  ),
+  keywords: Schema.optional(
+    Schema.String.annotations({
+      description: 'Comma-separated keywords for SEO',
+    })
+  ),
+  author: Schema.optional(
+    Schema.String.annotations({
+      description: 'Page author or organization name',
+    })
+  ),
+  canonical: Schema.optional(
+    Schema.String.annotations({
+      description: 'Canonical URL to prevent duplicate content issues',
+      format: 'uri',
+    })
+  ),
+  robots: Schema.optional(
+    Schema.String.annotations({
+      description: 'Robot directives (e.g., noindex, nofollow, noindex, nofollow)',
+    })
+  ),
+  noindex: Schema.optional(
+    Schema.Boolean.annotations({
+      description: 'Prevent indexing by search engines (shorthand for robots: noindex)',
+    })
+  ),
+  priority: Schema.optional(
+    Schema.Number.pipe(Schema.between(0, 1)).annotations({
+      description: 'Sitemap priority (0.0 to 1.0) for search engine crawling hints',
+    })
+  ),
+  changefreq: Schema.optional(
+    Schema.Literal('always', 'hourly', 'daily', 'weekly', 'monthly', 'yearly', 'never').annotations(
+      {
+        description: 'Sitemap change frequency hint for search engines',
+      }
+    )
+  ),
+  favicon: Schema.optional(FaviconSchema),
+  favicons: Schema.optional(Schema.Union(FaviconSetSchema, FaviconsConfigSchema)),
+  stylesheet: Schema.optional(
+    Schema.String.annotations({
+      description: 'Path to the main stylesheet',
+    })
+  ),
+  googleFonts: Schema.optional(
+    Schema.String.annotations({
+      description: 'Google Fonts URL',
+      format: 'uri',
+    })
+  ),
+  socialImage: Schema.optional(
+    Schema.String.annotations({
+      description: 'Default image for social media sharing',
+      format: 'uri',
+    })
+  ),
+  openGraph: Schema.optional(OpenGraphSchema),
+  twitter: Schema.optional(TwitterCardSchema),
+  schema: Schema.optional(
+    Schema.Unknown.annotations({
+      description:
+        'Schema.org structured data - accepts orchestrator format (organization, faqPage, etc.) or direct Schema.org object (@context, @type, ...)',
+    })
+  ),
+  preload: Schema.optional(PreloadSchema),
+  dnsPrefetch: Schema.optional(DnsPrefetchSchema),
+  analytics: Schema.optional(
+    Schema.Union(Schema.Record({ key: Schema.String, value: Schema.Unknown }), AnalyticsSchema)
+  ),
+  customElements: Schema.optional(CustomElementsSchema),
+  viewport: Schema.optional(
+    Schema.String.annotations({
+      description:
+        'Viewport meta tag content (e.g., "width=device-width, initial-scale=1.0") for responsive design',
+    })
+  ),
+  // Aliases for test compatibility
+  twitterCard: Schema.optional(TwitterCardSchema),
+  structuredData: Schema.optional(Schema.Unknown),
+  'og:site_name': Schema.optional(
+    Schema.String.annotations({
+      description: 'OpenGraph site name (shorthand for openGraph.siteName)',
+    })
+  ),
+  // Internationalization for metadata
+  i18n: Schema.optional(
+    Schema.Record({
+      key: LanguageCodeSchema,
+      value: Schema.Struct({
+        title: Schema.optional(
+          Schema.String.pipe(Schema.maxLength(60)).annotations({
+            description: 'Translated page title (max 60 characters)',
+          })
+        ),
+        description: Schema.optional(
+          Schema.String.pipe(Schema.maxLength(160)).annotations({
+            description: 'Translated page description (max 160 characters)',
+          })
+        ),
+      }),
+    }).annotations({
+      description: 'Localized metadata translations per language',
+    })
+  ),
+}).annotations({
+  title: 'Page Metadata',
+  description:
+    'Comprehensive page metadata including SEO, social media, structured data, performance, and analytics',
+})
+export type LanguageCode = Schema.Schema.Type<typeof LanguageCodeSchema>
+export type Meta = Schema.Schema.Type<typeof MetaSchema>
+// Re-export all meta schemas for convenience
+export * from './favicon'
+export * from './favicon-set'
+export * from './favicons-config'
+export * from './open-graph'
+export * from './twitter-card'
+export * from './structured-data'
+export * from './preload'
+export * from './dns-prefetch'
+export * from './analytics'
+export * from './custom-elements'