meta_mantle_builder library

Static HTML generation APIs for MetaMantle.

Import this entrypoint only from Dart command-line/build scripts. It uses dart:io and is not intended to be imported by a Flutter browser app.

Classes

Alternative language representation for hreflang links.
AlternateUrl
Convenience subclass/alias for AlternateLink.
BootstrapAdapter
Integrates MetaMantle static rendering with Flutter's web bootstrap pipeline.
BuildWebOptions
Options configuring the FlutterWebBuildEngine build process.
CollectionRouteSource<T>
Paginated data source for a route pattern containing exactly one :key.
DirectoryValidationReport
Aggregated report for a directory of HTML documents.
ElementNode
A semantic HTML element node with attributes and child nodes.
ExternalStandardsValidationResult
Result of an external HTML5 standards conformance audit.
FileHtmlArtifactStore
Local HTML artifact store with content-addressed immutable object storage, atomic manifests, path containment, and instant zero-copy publication drafts.
FixedRouteSource
One fixed page rendered through the same artifact and dependency pipeline.
FlutterWebBuildEngine
Production-grade Flutter Web Build Engine.
FlutterWebBuildResult
Result of executing FlutterWebBuildEngine.build.
GarbageCollectionReport
Report summarizing an artifact garbage collection execution.
GeneratedRouteDocument
Complete HTML plus dependency information for one generated page.
H
Factory functions for common semantic HTML tags.
HeadInjector
Clean, deduplicating HTML document head tag injector. Ensures valid HTML5 document structure, unique SEO metadata, and zero malformed tags.
HeadTag
A normalized, platform-neutral representation of one head element.
HreflangFinding
Validation finding for multilingual SEO and hreflang links.
HreflangValidator
Validates multilingual hreflang consistency and reciprocal links across routes.
HtmlDocument
Renders a complete, valid, SEO-ready semantic HTML5 document.
HtmlDocumentValidationReport
Report for a single HTML document validation.
HtmlNode
Base class for all HTML DOM nodes rendered by MetaMantle SSR.
HtmlSanitizer
Allowlist-based HTML sanitizer for rich text content.
HtmlValidationIssue
A specific issue found during HTML validation.
HtmlValidator
Comprehensive HTML5 quality auditor and validator.
HybridGenerationReport
HybridRevalidator
Explicit in-process revalidation. It is not a durable/distributed queue.
HybridStaticGenerator
Generates paginated collections without loading all records at once.
ImageFinding
Represents an individual audit finding for an image.
ImageSeoAnalyzer
Analyzer that evaluates images in HTML for SEO accessibility, Core Web Vitals (CLS), and generates Google Image XML sitemaps.
ImageSeoReport
Aggregate audit report for image SEO and Core Web Vitals optimization.
IncrementalManifest
Records content hashes and output file paths for incremental static builds.
JsonLd
Structured data payload for search crawlers.
MetadataRenderer
Resolves global defaults and page metadata into deterministic head tags.
MetaMantleConfig
Global defaults used to resolve page-level metadata in MetaMantle.
OpenGraph
Convenience subclass for OpenGraphMetadata.
OpenGraphMetadata
Open Graph metadata configuration.
OpenGraphType
Standard Open Graph object types.
PolicyProvenance
Diagnostic provenance record tracking where resolved metadata properties originated.
PublishedHtmlArtifact
Consistent view of an artifact and dependency read from one publication.
RawSafeHtmlNode
A node representing explicitly validated or sanitized raw HTML markup.
ResolvedSeoMetadata
Container for the resolved metadata and its diagnostic provenance trace.
ResourceHint
Resource hints for high-performance resource preloading and connection warmup.
RobotsDirective
Standard robots directive values and custom builders.
RouteArtifactEntry
Metadata record for an immutable content-addressed route artifact.
RouteDependency
RouteDiscoveryPage<T>
SeoPolicy
A policy node declaring SEO rules, defaults, and overrides at a specific tier.
SeoPolicyResolver
Centralized SEO policy resolution engine executing the 7-tier inheritance hierarchy: Global -> Application -> Tenant -> Locale -> Section -> Route -> Page Overrides.
SitemapGenerator
Generates XML sitemaps and sitemap indexes according to the sitemaps.org protocol.
SitemapUrlEntry
Single URL entry for sitemap generation.
StaticBuildResult
Result summary of static generation.
StaticHeadBuilder
Creates route-specific HTML entry documents from an existing Flutter build.
StaticHeadConfig
Configuration for the static route HTML generator.
StaticPageRoute
Represents a route with associated SEO metadata, component tree, and static HTML content.
StaticPatternResolver
Contract for objects that can resolve dynamic route patterns into concrete static routes.
StaticRouteManifest
Registry and resolver for statically buildable routes and dynamic data expansion.
StaticRoutePattern<T>
Dynamic pattern expanding parameterized paths (e.g. /products/:slug) from in-memory collections, async data loaders, or JSON data files.
StorageCapabilities
Declares the operational capabilities of an HTML artifact store backend.
TextNode
A node representing escaped plain text.
TwitterCard
Convenience subclass for TwitterCardMetadata.
TwitterCardMetadata
X/Twitter card metadata configuration.
TwitterCardType
Standard X/Twitter card types.
WebIcon
Icon representation for favicons, touch icons, and web manifests.
Convenience subclass/alias for WebLinkTag.
WebLinkTag
Safe custom link tag representation.
WebMetadata
Page-specific metadata. Unset values inherit from WebHeadConfig.
WebMetaTag
Safe custom metadata. Only standard text attributes are supported.

Enums

BuildMode
Operational mode for the Flutter Web build engine.
ExternalStandardsValidationStatus
Status of optional external HTML5 standards conformance validation (e.g. Nu HTML Checker / W3C v.Nu).
HtmlValidationSeverity
Severity of an HTML validation issue.
ImageIssueSeverity
Severity of an image SEO or performance finding.
InitialGenerationPolicy
One bounded page returned by a dynamic route source.
PolicyTier
Defines the policy tier in the 7-level inheritance hierarchy.
RenderingStrategy
Defines the rendering strategy for MetaMantle web applications.

Functions

runStaticManifest(StaticRouteManifest manifest, List<String> args, {MantleServerRenderer serverRenderer = const MantleServerRenderer(emitHydrationMarkers: false)}) → Future<void>
Runner executed by consumer applications or CLI drivers to evaluate a manifest, render all components to semantic HTML, and write a resolved manifest JSON.

Typedefs

StaticComponentBuilder = MantleComponent Function(MantleContext context)
StaticRoute = StaticPageRoute
Alias for StaticPageRoute for ergonomic route definitions.
WebHeadConfig = MetaMantleConfig
Backward compatibility alias for MetaMantleConfig.

Exceptions / Errors

StaleArtifactVersionException
Thrown when a draft was based on a publication that is no longer active.
StaleFencingEpochException
Thrown when an artifact publication attempt presents an obsolete or lower fencing epoch.
StaleGeneratedDocumentException