@ccslabs/xtend 0.1.0-rc.1

package/docs/README.md

@@ -0,0 +1,340 @@
+# XTend Dokumentation – Inhaltsverzeichnis
+
+Willkommen zur offiziellen Dokumentation des XTend Web Frameworks. Dieses Inhaltsverzeichnis bietet einen schnellen Überblick und direkte Links zu allen relevanten Themen und Komponenten.
+
+---
+
+## Einstieg & Grundlagen
+- [Quick Start Guide](./quick-start-guide.md)
+- [XTend Loader](./xtend-loader.md)
+- [XTend-Fabric Runtime](./xtend-fabric.md)
+- [XTend-Fabric RMT Lane Mapping](./xtend-fabric-rmt-lane-mapping.md)
+- [Performance fuer Komponentenautoren](./performance.md)
+- [Performance Measurements](./performance-measurements.md)
+- [Performance Regression](./performance-regression.md)
+- [Hydration Policies](./hydration-policies.md)
+- [A11y Keyboard Smokes](./a11y-keyboard-smokes.md)
+- [Screenreader Signals](./screenreader-signals.md)
+- [Motion und Contrast](./motion-contrast.md)
+- [Manifest Import Policy](./manifest-import-policy.md)
+- [Trusted DOM und Sanitizing](./trusted-dom-sanitizing.md)
+- [Trusted DOM Boundary Browser Proof](./trusted-dom-boundary-browser-proof.md)
+- [Supply-Chain Gates](./supply-chain-gates.md)
+- [Component Catalog Coverage](./component-catalog-coverage.md)
+- [Public Component Types](./public-component-types.md)
+- [Design Tokens](./design-tokens.md)
+- [Drittanbieter Design Authoring](./third-party-design-authoring.md)
+- [Enterprise Component Flex Release Handoff](./enterprise-component-flex-release-handoff.md)
+- [RMT DSL Authoring Polish](./rmt-dsl-authoring-polish.md)
+- [RMT Linter und AI-Agent Repair Report](./rmt-linter.md)
+- [RMT Language Server und Editor Setup](./rmt-language-server.md)
+- [RC0 Gate Matrix](./rc0-gate-matrix.md)
+- [RC0 Adoption Guide](./rc0-adoption-guide.md)
+- [Epic 12 RC0 Handoff](./epic12-rc0-handoff.md)
+- [RC1 Readiness](./rc1-readiness.md)
+- [Release Owner Acceptance](./release-owner-acceptance.md)
+- [Conditional Network Evidence](./conditional-network-evidence.md)
+- [Conditional Network Evidence CI](./conditional-network-evidence-ci.md)
+- [Package Export Lock](./package-export-lock.md)
+- [TypeExports](./type-exports.md)
+- [XTend Loader Types](./xtend-loader-types.md)
+- [XTend API Types](./xtend-api-types.md)
+- [XTend RMT Types](./xtend-rmt-types.md)
+- [XTend Policy Types](./xtend-policy-types.md)
+- [XTend Builder Types](./xtend-builder-types.md)
+- [XTend Catalog Types](./xtend-catalog-types.md)
+- [XTend Vendor and Utility Types](./xtend-vendor-types.md)
+- [Known Residual Triage](./known-residual-triage.md)
+- [Hydration Performance Closure](./hydration-performance-closure.md)
+- [PROD Browser CSP Smokes](./prod-browser-csp-smokes.md)
+- [Visual Owner Artifacts](./visual-owner-artifacts.md)
+- [RMT Production Readiness](./rmt-production-readiness.md)
+- [Docs RMT Production Hardening](./docs-rmt-production-hardening.md)
+- [RC1 Migration Notes](./rc1-migration-notes.md)
+- [RC1 Gate Matrix und CI-Handoff](./rc1-gate-matrix-ci-handoff.md)
+- [Release Report und Pack Dry Run Evidence](./release-report-pack-dry-run-evidence.md)
+- [RMT-first XTend Apps](./rmt-first-xtend-apps.md)
+- [SurfaceManager RMT Authoring](./surface-manager-rmt-authoring.md)
+- [SurfaceManager Controller](./surface-manager-controller.md)
+- [SurfaceManager Window Runtime](./surface-manager-window-runtime.md)
+- [SurfaceManager SidePanel Runtime](./surface-manager-side-panel-runtime.md)
+- [SurfaceManager Workbench Fixture](./surface-manager-workbench-fixture.md)
+- [SurfaceManager Overlay Bridge](./surface-manager-overlay-bridge.md)
+- [SurfaceManager Quality Gates](./surface-manager-quality-gates.md)
+- [SurfaceManager Native RMT Surfaces](./surface-manager-native-rmt-surfaces.md)
+- [SurfaceManager Authoring Guide](./surface-manager-authoring-guide.md)
+- [SurfaceManager Component Lab](./surface-manager-component-lab.md)
+- [SurfaceManager Migration Guide](./surface-manager-migration-guide.md)
+- [SurfaceManager Release Handoff](./surface-manager-release-handoff.md)
+- [Component UX Authoring](./component-ux-authoring.md)
+- [Component UX App Authoring](./component-ux-app-authoring.md)
+- [Component UX Gates](./component-ux-gates.md)
+- [Component Long-Tail Migration](./component-long-tail-migration.md)
+- [Epic 11 Enterprise UX Handoff](./epic11-enterprise-ux-handoff.md)
+- [Component Lab](./component-lab.md)
+- [RMT-first Demo-App](./rmt-first-demo-app.md)
+- [RMT Lifecycle Demo](./rmt-lifecycle-demo.md)
+- [Existing Component Metadata](./existing-component-metadata.md)
+- [Epic 10 Platform Gates](./epic10-platform-gates.md)
+- [Epic 10 Release Handoff](./epic10-release-handoff.md)
+- [Visual Browser Regression](./visual-browser-regression.md)
+- [Visual Snapshot Automation](./visual-snapshot-automation.md)
+- [Enterprise Adoption Guide](./enterprise-adoption.md)
+- [Manifest-Format](./manifest.md)
+- [API-Integration](./api.md)
+- [Komponenten-Entwicklung](./components.md)
+- [Best Practices](./best-practices.md)
+
+---
+
+## XTendRMT
+- [XTendRMT Developer Overview](./xtendrmt-overview.md)
+- [Native RMT Authoring](./xtendrmt-native-authoring.md)
+- [XTendRMT App-DSL Reference](./xtendrmt-app-dsl.md)
+- [XTendRMT Runtime Bridge](./xtendrmt-runtime-bridge.md)
+- [Native RMT Migration Guide](./xtendrmt-migration-guide.md)
+- [XTendRMT Parsedown Scheduling Pilot](./xtendrmt-parsedown-scheduling.md)
+- [RMT Linter und AI-Agent Repair Report](./rmt-linter.md)
+- [RMT Language Server und Editor Setup](./rmt-language-server.md)
+- [RMT Tooling Release Gates](./rmt-tooling-release-gates.md)
+- [RMT vNext Authoring Guide](./rmt-vnext-authoring.md)
+- [RMT vNext Migration Notes](./rmt-vnext-migration-notes.md)
+- [RMT vNext Release Handoff](./rmt-vnext-release-handoff.md)
+- [RMT vNext Remote Surfaces](./rmt-vnext-remote-surfaces.md)
+- [RMT vNext Enterprise Surface Registry](./rmt-vnext-surface-registry-enterprise.md)
+- [RMT vNext Cross Surface Events](./rmt-vnext-cross-surface-events.md)
+- [RMT vNext Enterprise MFE Handoff](./rmt-vnext-enterprise-mfe-handoff.md)
+- [RMT Kernel Security Hardening Migration](./rmt-kernel-security-hardening-migration.md)
+- [RMT Kernel Trusted Output Authoring](./rmt-kernel-trusted-output-authoring.md)
+- [RMT Kernel Panic Recovery Incident Handoff](./rmt-kernel-panic-recovery-incident-handoff.md)
+
+XTendRMT ist nach Epic 05 als produktiver Scheduler-, Runtime- und Templating-Pfad dokumentiert. XTend UI bleibt das Web-Component-Produkt; RMT fuehrt native `adapters`, `components`, `routes`, `schedules` und `templates` als host-neutrale App-DSL. XRouter und XTend Components werden ueber produktive Adapter angebunden, waehrend React-, Vue-, Vanilla- und Custom-Hosts eigene Adapter verwenden koennen.
+
+Die Docs-App selbst nutzt weiterhin PHP/Parsedown fuer Markdown-Rendering und XTend/XRouter fuer die SPA-Oberflaeche. Seit dem Shell-first-Refactor rendert `docs/utils/pageloader.js` die App Shell aber aus `docs/xtendrmt-parsedown-docs.rmt`: `docs.app.shell` erzeugt die sichtbare Route-Shell, `docs.header.search` erzeugt die Header-Suche, und Parsedown fuellt nur noch den RMT-Content-Slot. Das Dokument [XTendRMT Parsedown Scheduling Pilot](./xtendrmt-parsedown-scheduling.md) beschreibt diesen Pfad mit `xtend.docs.parsedown-rmt-pilot.v1` und `npm run test:docs-rmt-pilot`.
+
+[RMT Linter und AI-Agent Repair Report](./rmt-linter.md) dokumentiert ab `WP-E14-14` den Contract `xtend.rmt.tooling-docs.v1`, die lokalen Befehle `xt rmt lint`, `xt rmt lint --json`, `xt rmt lint --agent` und den Gate `node scripts/run_xtend_tests.js rmt-tooling-docs --json`.
+
+[RMT Language Server und Editor Setup](./rmt-language-server.md) dokumentiert ab `WP-E14-14` den LSP-Start ueber `node tools/rmt-language-server/server.js`, die Snippets aus `tools/rmt-language/snippets/`, VS-Code-Bridge, JetBrains, Neovim und Helix Setup. Der Language Server bleibt die einzige fachliche Source of Truth fuer Editor-Integrationen.
+
+[RMT Tooling Release Gates](./rmt-tooling-release-gates.md) dokumentiert ab `WP-E14-15` den Contract `xtend.epic14.rmt-tooling.v1`, die optionalen PR-Befehle `npm run test:pr:rmt` und `npm run test:pr:rmt:report`, den Release-Bundle-Gate `npm run test:rmt-tooling` und den Self-Gate `node scripts/run_xtend_tests.js epic14-rmt-tooling --json`.
+
+Epic 14 ist ab `WP-E14-16` abgeschlossen. Der Handoff `xtend.epic14.lsp-handoff.v1` liegt in [Epic 14 Abschluss und LSP Handoff](../development/XTendRMT-Epic14-Abschluss-und-LSP-Handoff.md) und beschreibt die LSP Capability Matrix, Known Limitations und die Folgepfade fuer RMT DSL Syntax, Formatter und Project Index.
+
+[RMT vNext Authoring Guide](./rmt-vnext-authoring.md), [RMT vNext Migration Notes](./rmt-vnext-migration-notes.md) und [RMT vNext Release Handoff](./rmt-vnext-release-handoff.md) dokumentieren ab `WP-E15-18` den Abschluss `xtend.rmt.vnext-release-handoff.v1`. Die Reference Demo liegt in `xtendrmt/rmt-vnext-reference-demo.rmt`, der stabile Core-Output in `xtendrmt/rmt-vnext-reference-demo.core.json`, und der lokale Gate ist `node scripts/run_xtend_tests.js rmt-vnext-release --json`.
+
+[RMT vNext Remote Surfaces](./rmt-vnext-remote-surfaces.md), [RMT vNext Enterprise Surface Registry](./rmt-vnext-surface-registry-enterprise.md), [RMT vNext Cross Surface Events](./rmt-vnext-cross-surface-events.md) und [RMT vNext Enterprise MFE Handoff](./rmt-vnext-enterprise-mfe-handoff.md) dokumentieren ab `WP-E16-12` den Abschluss `xtend.rmt.vnext-enterprise-release-handoff.v1` mit Zielreife `rmt-vnext-enterprise-mfe-ready`. Die Enterprise Demo liegt in `xtendrmt/rmt-vnext-enterprise-mfe-demo.rmt`, der stabile Core-Output in `xtendrmt/rmt-vnext-enterprise-mfe-demo.core.json`, und der lokale Gate ist `node scripts/run_xtend_tests.js rmt-vnext-enterprise-release --json`.
+
+[RMT Kernel Security Hardening Migration](./rmt-kernel-security-hardening-migration.md), [RMT Kernel Trusted Output Authoring](./rmt-kernel-trusted-output-authoring.md) und [RMT Kernel Panic Recovery Incident Handoff](./rmt-kernel-panic-recovery-incident-handoff.md) dokumentieren ab `RKSH-WP-11` den Contract `xtend.rmt.kernel-migration-authoring-incident-handoff.v1`. Der Gate `node scripts/run_xtend_tests.js rmt-kernel-handoff-docs --json` prueft Migration, sichere Authoring-Muster, Panic-/Recovery-Handoff, Package-Metadaten und Docs-Menue.
+
+## Enterprise Runtime
+
+[XTend-Fabric Runtime](./xtend-fabric.md) dokumentiert den ab `ER-WP-08` produktiven Host-Kern fuer `createXtendFabric`, `runFiber`, `emitDiagnostic`, `wrapComponent`, opt-in Reporter, redigierte Diagnostics, die Runtime Diagnostics Bridge fuer `xstate`, API Compliance und XTendRMT Diagnostics, Component Mount/Hydration Fibers, Route Navigation/Render Fibers, Telemetry Snapshots, Backpressure-Signale und die spaetere Kopplung an XTendRMT Adapter-/Bridge-Signale.
+
+[XTend-Fabric RMT Lane Mapping](./xtend-fabric-rmt-lane-mapping.md) dokumentiert ab `ER-WP-13`, wie Fabric-Lanes auf host-neutrale RMT Schedule Records abgebildet werden. Wichtig: `a11y` bleibt Fabric-semantisch und wird im RMT Schedule als `user-blocking` mit `metadata.fabricLane = "a11y"` gefuehrt.
+
+[Performance fuer Komponentenautoren](./performance.md) dokumentiert ab `ER-WP-21`, wie DOM-Zugriffe, Events, Shadow DOM, Layout, Animation und Hydration aus derselben Scaffold Policy `xtend.scaffold.performance-policy.v1` abgeleitet werden.
+
+[Performance Measurements](./performance-measurements.md) dokumentiert ab `ER-WP-18`, wie Loader, Hydration, Render und Route Render als `xtend.performance.measurement.v1` gemessen und in Fabric Telemetry Snapshots zusammengefuehrt werden.
+
+[Performance Regression](./performance-regression.md) dokumentiert ab `ER-WP-19`, wie lokale deterministische Baselines gegen Budget-Matrix und Fabric Measurements als `xtend.performance.regression-report.v1` ausgewertet werden.
+
+[Hydration Policies](./hydration-policies.md) dokumentiert ab `ER-WP-20`, wie `visible`, `idle` und `lazy` Hydration ueber Fabric und RMT Schedule Delegation geplant werden.
+
+[A11y Keyboard Smokes](./a11y-keyboard-smokes.md) dokumentiert ab `ER-WP-24`, wie Routing, Overlay, Form/Input und Tabs browsernah fuer Fokus, `Tab`, `Enter`, `Space`, `Escape` und Pfeiltasten geprueft werden.
+
+[Screenreader Signals](./screenreader-signals.md) dokumentiert ab `ER-WP-25` den Contract `xtend.a11y.screenreader-signals.v1` fuer `aria-live`, Statusregionen, Errorregionen, Announcements und Fabric-Lane `a11y`.
+
+[Motion und Contrast](./motion-contrast.md) dokumentiert ab `ER-WP-26` den Contract `xtend.a11y.motion-contrast-policy.v1` fuer `prefers-reduced-motion`, `forced-colors`, Fokus, Theme Tokens und Nicht-Farbstatus.
+
+[Manifest Import Policy](./manifest-import-policy.md) dokumentiert ab `ER-WP-28`, wie `data-manifest`, Manifest Records und dynamische Modul-Imports gegen lokale URL-Policy, Allowlist und Security Refusals geprueft werden.
+
+[Trusted DOM und Sanitizing](./trusted-dom-sanitizing.md) dokumentiert ab `ER-WP-29`, wie RMT `html_fragment`, Parsedown HTML, strukturierte Templates und DOM-Sinks klassifiziert werden. `innerHTML`, `insertAdjacentHTML` und `template.innerHTML` bleiben eingeschraenkte Trusted-DOM-Sinks; `dom_descriptor` und Node-basierte Renderer sind bevorzugt.
+
+[Trusted DOM Boundary Browser Proof](./trusted-dom-boundary-browser-proof.md) dokumentiert ab `WP-E13-11` den Contract `xtend.epic13.trusted-dom-boundary.v1`, die Fixture `tests/browser/fixtures/epic13-trusted-dom-boundary-smoke.html`, den Sanitizer `xtend.security.trusted-dom-sanitizer.v1` und den Gate `node scripts/run_xtend_tests.js epic13-trusted-dom-boundary --json`.
+
+[RC1 Migration Notes](./rc1-migration-notes.md) dokumentiert ab `WP-E13-12` den Contract `xtend.epic13.rc1-migration-notes-semver.v1`, die vorgeschlagene Version `0.1.0-rc.1`, Migration Sections fuer Loader, RMT, Docs, Trusted DOM, Fabric, Typing, Visual Owner Artifacts und Supply Chain sowie den Gate `node scripts/run_xtend_tests.js epic13-rc1-migration-notes --json`.
+
+[RC1 Gate Matrix und CI-Handoff](./rc1-gate-matrix-ci-handoff.md) dokumentiert ab `WP-E13-13` den Contract `xtend.epic13.rc1-gate-matrix-ci-handoff.v1`, Source Gates, CI Lanes, Report-Artefakte, Referenzpfade und den Gate `node scripts/run_xtend_tests.js epic13-rc1-gate-matrix-ci-handoff --json`.
+
+[Release Report und Pack Dry Run Evidence](./release-report-pack-dry-run-evidence.md) dokumentiert ab `DPF-WP-02` den Contract `xtend.epic13.release-report-pack-dry-run-evidence.v1`, `npm run release:report`, `npm run pack:dry-run`, reproduzierbare Owner-Artefakte und den Gate `node scripts/run_xtend_tests.js epic13-release-report-pack-dry-run-evidence --json`.
+
+[Supply-Chain Gates](./supply-chain-gates.md) dokumentiert ab `ER-WP-30`, wie Dependency Inventory, License Policy, Vulnerability Policy, SBOM-/Audit-Stufen, Provenance und private Publish Boundary vorbereitet sind. Der lokale Gate bleibt offline; Registry-Audits gehoeren in CI-/Release-Stufen.
+
+[Component Catalog Coverage](./component-catalog-coverage.md) dokumentiert ab `ER-WP-31`, wie Manifest-Komponenten nach Source, Docs, Component-Suite, Fixture, Types, A11y und Performance bewertet werden. `ER-WP-32`, `ER-WP-33`, `ER-WP-34` und `ER-WP-35` sind abgeschlossen; die Matrix ist nun der Handoff fuer CI und Release Readiness.
+
+[Public Component Types](./public-component-types.md) dokumentiert ab `ER-WP-34` die lokalen `.d.ts` Artefakte, Public Event Contracts, Detail-Payloads und typed `addEventListener` Overloads. Nach `WP-E10-11` sind 27 priorisierte Komponenten typisiert; `x-select`, `x-checkbox`, `x-radio`, `x-textarea`, `x-status`, `x-progress`, `x-tooltip`, `x-popover` und `x-drawer` bilden die erste `enterprise-ready` Referenzlinie.
+
+[Design Tokens](./design-tokens.md) dokumentiert ab `WP-E12-12` den Contract `xtend.design-tokens.product-contract.v1`, Theme Packs, Density Packs, High-Contrast/Forced-Colors Tokens, CSS Custom Properties, CSS Parts und den lokalen Gate `node scripts/run_xtend_tests.js design-tokens --json`.
+
+[Drittanbieter Design Authoring](./third-party-design-authoring.md) dokumentiert ab `ECH-WP-11` den Contract `xtend.enterprise.third-party-authoring-guide.v1` fuer Corporate Themes, XTend.css Override Patterns, XTheme Token Bridge, CSS Parts, Icon Pack Registrierung, Layout Modes, A11y-Dos and Donts, P0 Token-/Part-Referenzen und Legacy-Token-Migration. Der lokale Gate `node scripts/run_xtend_tests.js enterprise-third-party-authoring-guide --json` prueft die Guide-Linie.
+
+[Enterprise Component Flex Release Handoff](./enterprise-component-flex-release-handoff.md) dokumentiert ab `ECH-WP-12` den Contract `xtend.enterprise.component-flex-release-handoff.v1` fuer SemVer-Bewertung, Deprecated Aliases, Migration Notes, Release Checklist, Adoption Risiken und den Publish Boundary `private-until-release-owner-acceptance`. Der lokale Gate `node scripts/run_xtend_tests.js enterprise-component-flex-release-handoff --json` prueft den finalen Handoff der Enterprise Component Flexibilitaetswelle.
+
+[RMT DSL Authoring Polish](./rmt-dsl-authoring-polish.md) dokumentiert ab `WP-E12-13` den Contract `xtend.rmt.dsl-authoring-polish.v1` fuer Component-, Shell-, Slot-, Style-, Token-, A11y-, Event-, Command-, Hydration-, Lane-, Route-, Link- und Outlet-Aliase. Der lokale Gate `node scripts/run_xtend_tests.js rmt-dsl-authoring-polish --json` prueft, dass XTendRMT upstream freundlicher authoren kann, ohne XTend-Typen in den RMT Kernel zu importieren.
+
+[RC0 Gate Matrix](./rc0-gate-matrix.md) dokumentiert ab `WP-E12-14` den Contract `xtend.epic12.rc0-gate-matrix.v1` fuer PR Fast, Full Release, Snapshot, RMT Authoring, Conditional Network Gates, Package Dry Run und Known Residual Policy. Der lokale Gate `node scripts/run_xtend_tests.js rc0-gate-matrix --json` prueft die Matrix, waehrend `private-until-release-owner-approval` aktiv bleibt.
+
+[RC0 Adoption Guide](./rc0-adoption-guide.md) dokumentiert ab `WP-E12-15` den Contract `xtend.epic12.docs-adoption.v1` fuer Long-Tail Runtime Closure, DOM-first Visual Snapshots, Design Token Productization, RMT DSL Authoring Polish, RC0 Readiness, Known Residual Policy und Migration Notes. Der lokale Gate `node scripts/run_xtend_tests.js epic12-docs-adoption --json` prueft Docs-App-Menue, Enterprise Adoption Guide, Package, Scaffold, Backlog, RC-Modell und Referenzpfade.
+
+[Epic 12 RC0 Handoff](./epic12-rc0-handoff.md) dokumentiert ab `WP-E12-16` den Contract `xtend.epic12.rc0-handoff.v1` fuer KPI-Abnahme, Long-Tail-Status, Snapshot-Status, RC0 Gate Matrix, Owner Review Inputs, Known Residual Policy und Publish Boundary. Der lokale Gate `node scripts/run_xtend_tests.js epic12-rc0-handoff --json` prueft den finalen Epic-12-Abschluss.
+
+[RC1 Readiness](./rc1-readiness.md) dokumentiert ab `WP-E13-01` den Contract `xtend.epic13.rc1-production-readiness.v1` fuer den RC0-zu-RC1-Transfer, Release Owner Acceptance, Conditional Network Evidence, Package Dry Run Export Lock, Known Residuals, PROD-nahe Browser-/CSP-Smokes, RMT Production Readiness und Feature-Drift-Grenzen. Der lokale Gate `node scripts/run_xtend_tests.js epic13-rc1-readiness --json` prueft den Startschnitt fuer Epic 13.
+
+[Release Owner Acceptance](./release-owner-acceptance.md) dokumentiert ab `WP-E13-02` den Contract `xtend.epic13.release-owner-acceptance.v1` fuer Owner Inputs, `accepted`/`deferred`/`blocked` Entscheidungen, `automatic-publish-approval` als blockierte Entscheidung und den weiterhin geschlossenen Publish Boundary. Der lokale Gate `node scripts/run_xtend_tests.js epic13-release-owner-acceptance --json` prueft den Owner-Acceptance-Schnitt.
+
+[Conditional Network Evidence](./conditional-network-evidence.md) dokumentiert ab `WP-E13-03` den Contract `xtend.epic13.conditional-network-evidence.v1` fuer `npm audit --audit-level=moderate`, `npm sbom --sbom-format=cyclonedx --json`, `.xtend-test-results/` Evidence-Artefakte und strukturierte Offline-/Sandbox-Deferrals. Der lokale Gate `node scripts/run_xtend_tests.js epic13-conditional-network-evidence --json` bleibt netzwerkfrei.
+
+[Conditional Network Evidence CI](./conditional-network-evidence-ci.md) dokumentiert ab `DPF-WP-03` den Contract `xtend.epic13.conditional-network-evidence-ci.v1`, `npm run conditional-network:evidence`, den GitHub-Actions-Job `conditional-network-evidence` und den Gate `node scripts/run_xtend_tests.js epic13-conditional-network-evidence-ci --json`.
+
+[Package Export Lock](./package-export-lock.md) dokumentiert ab `WP-E13-04` den Contract `xtend.epic13.package-export-lock.v1` fuer `npm pack --dry-run --json`, `.xtend-test-results/xtend-pack-dry-run.json`, `.xtend-test-results/xtend-package-export-surface-lock.json`, Loader, Components, Fabric, XTendRMT, Builder, Docs und den lokalen Gate `node scripts/run_xtend_tests.js epic13-package-export-lock --json`.
+
+[TypeExports](./type-exports.md) dokumentiert ab `WP-TypeExports-09` den Contract `xtend.type-exports.plan.v1`, den Drift-Report `xtend.type-exports.drift-report.v1`, die Public Package Export Matrix, Package `types`-Conditions, `types-not-required` Boundaries, den lokalen Gate `node scripts/run_xtend_tests.js type-exports --json` und den Release-Handoff `npm run test:type-exports:release`.
+
+[XTend Loader Types](./xtend-loader-types.md) dokumentiert ab `WP-TypeExports-02` den Contract `xtend.type-exports.loader-declarations.v1` fuer `window.XTendLoader`, `window.XTendStyleRegistry`, `window.XTendSkeletonLoader`, Loader Events, Boot-Promise und den lokalen Drift-Gate `node scripts/run_xtend_tests.js type-exports-loader --json`.
+
+[XTend API Types](./xtend-api-types.md) dokumentiert ab `WP-TypeExports-03` den Contract `xtend.type-exports.api-declarations.v1` fuer `initXTendAPI`, `window.XTend.*`, globale Legacy-Aliase, `xtend-api-ready` und den lokalen Drift-Gate `node scripts/run_xtend_tests.js type-exports-api --json`.
+
+[XTend RMT Types](./xtend-rmt-types.md) dokumentiert ab `WP-TypeExports-04` den Contract `xtend.type-exports.rmt-declarations.v1` fuer `./rmt`, `./rmt/browser`, RMT-Language Tooling, LSP, Linter, Editor-Facades und den lokalen Drift-Gate `node scripts/run_xtend_tests.js type-exports-rmt --json`.
+
+[XTend Policy Types](./xtend-policy-types.md) dokumentiert ab `WP-TypeExports-05` den Contract `xtend.type-exports.policy-declarations.v1` fuer Fabric-, A11y- und Security-Policy-APIs, gemeinsame Diagnostic-/Report-Typen und den lokalen Drift-Gate `node scripts/run_xtend_tests.js type-exports-policy --json`.
+
+[XTend Builder Types](./xtend-builder-types.md) dokumentiert ab `WP-TypeExports-06` den Contract `xtend.type-exports.builder-declarations.v1` fuer Builder-, Scaffold-, Component-Lab-, Blueprint-, Preview-, Workflow- und Typing-Contract APIs sowie den lokalen Drift-Gate `node scripts/run_xtend_tests.js type-exports-builder --json`.
+
+[XTend Catalog Types](./xtend-catalog-types.md) dokumentiert ab `WP-TypeExports-07` den Contract `xtend.type-exports.catalog-declarations.v1` fuer Catalog-Plan-/Report-Facades, SurfaceManager-/Epic-/Release-Catalog-Klassifizierung und den lokalen Drift-Gate `node scripts/run_xtend_tests.js type-exports-catalog --json`.
+
+[XTend Vendor and Utility Types](./xtend-vendor-types.md) dokumentiert ab `WP-TypeExports-08` den Contract `xtend.type-exports.vendor-facades.v1` fuer Prism-, Turndown- und Design-Token-Facades sowie den lokalen Drift-Gate `node scripts/run_xtend_tests.js type-exports-vendor --json`.
+
+[RMT-first XTend Apps](./rmt-first-xtend-apps.md) dokumentiert ab `WP-E10-16`, wie vollstaendige XTend Apps ueber `xtend.rmt.first-class-app-authoring.v1` mit `xtend.component`, `xtend.xrouter`, `dom_descriptor` Templates, Schedules, Fabric-Lanes und Diagnostics beschrieben werden.
+
+[RMT Lifecycle Demo](./rmt-lifecycle-demo.md) zeigt den vollstaendigen lokalen Buildpfad: `xtendrmt/rmt-lifecycle-demo.rmt` wird als RMT vNext Template authored, der Scaffold-Befehl `node xtend-builder/scaffold.js rmt-lifecycle-demo --write --json` erzeugt Core JSON, XTend Custom Element, App-Modul, Host und Browser-Smoke, und `node scripts/run_xtend_tests.js rmt-lifecycle-demo --json` prueft die Artefakte gegen den Build.
+
+[SurfaceManager RMT Authoring](./surface-manager-rmt-authoring.md) dokumentiert ab `WP-SM-01` den Contract `xtend.rmt.surface-authoring.v1` fuer `x-surface-manager`, `x-surface-window`, `x-side-panel`, `metadata.surfaceManager`, `metadata.surface`, Surface-Schedules und die reservierte spaetere `xtend.surface` Adaptergrenze. Der lokale Gate `node scripts/run_xtend_tests.js rmt-surface-authoring --json` prueft Contract, Fixture, Package, Scaffold und RMT-Core-Normalisierung.
+
+[SurfaceManager Controller](./surface-manager-controller.md) dokumentiert ab `WP-SM-02` den Contract `xtend.surface.controller.v1`, die Runtime `components/xsurfacemanager-controller.js`, TypeScript Sources unter `src/components/x-surface-manager/`, xstate Mirror Keys, Fabric Diagnostics und den lokalen Gate `node scripts/run_xtend_tests.js surface-controller --json`.
+
+[SurfaceManager Window Runtime](./surface-manager-window-runtime.md) dokumentiert ab `WP-SM-03` den Contract `xtend.surface.window-runtime.v1`, `x-surface-manager`, `x-surface-window`, den Command-Bridge `surface-window-command`, Snapshot-Spiegelung und den lokalen Gate `node scripts/run_xtend_tests.js surface-manager --json`.
+
+[SurfaceManager SidePanel Runtime](./surface-manager-side-panel-runtime.md) dokumentiert ab `WP-SM-04` den Contract `xtend.surface.side-panel-runtime.v1`, `x-side-panel`, `surface-panel-command`, Docked/Pinned/Overlay/Collapsed Modes, responsive Fullscreen-Verhalten und den lokalen Gate `node scripts/run_xtend_tests.js surface-side-panel --json`.
+
+[SurfaceManager Workbench Fixture](./surface-manager-workbench-fixture.md) dokumentiert ab `WP-SM-05` den Contract `xtend.surface.workbench-fixture.v1`, `xtendrmt/surface-workbench.rmt`, den Host `xtendrmt-surface-workbench.html`, zwei Windows, ein SidePanel, route-bound Content, shared Surface Snapshot und den lokalen Gate `node scripts/run_xtend_tests.js surface-workbench-fixture --json`.
+
+[SurfaceManager Overlay Bridge](./surface-manager-overlay-bridge.md) dokumentiert ab `WP-SM-06` den Contract `xtend.surface.overlay-stack-bridge.v1`, `components/xsurfaceoverlay-bridge.js`, `surface-overlay-command`, die optionale Stack-Anbindung fuer `x-modal`, `x-dialog` und `x-drawer` sowie den lokalen Gate `node scripts/run_xtend_tests.js surface-overlay-bridge --json`.
+
+[SurfaceManager Quality Gates](./surface-manager-quality-gates.md) dokumentiert ab `WP-SM-07` den Contract `xtend.surface.quality-gates.v1`, das Browser-Fixture `tests/browser/fixtures/surface-manager-quality-smoke.html`, die Visual-Baseline `tests/browser/visual-baselines/surface-manager-quality.dom-baseline.json`, A11y-/Performance-/Visual-Domaenen und den lokalen Gate `node scripts/run_xtend_tests.js surface-manager-quality --json`.
+
+[SurfaceManager Native RMT Surfaces](./surface-manager-native-rmt-surfaces.md) dokumentiert ab `WP-SM-08` den Contract `xtend.rmt.surfaces-domain.v1`, den Adapter-Handoff `xtend.surface.adapter.v1`, die Fixture `tests/fixtures/rmt-surface-native-domain.rmt`, Schema-/Typ-/Normalizer-/LSP-Tooling und den lokalen Gate `node scripts/run_xtend_tests.js surface-native-rmt --json`.
+
+[SurfaceManager Authoring Guide](./surface-manager-authoring-guide.md), [SurfaceManager Component Lab](./surface-manager-component-lab.md), [SurfaceManager Migration Guide](./surface-manager-migration-guide.md) und [SurfaceManager Release Handoff](./surface-manager-release-handoff.md) schliessen ab `WP-SM-09` die erste SurfaceManager-Linie. Der lokale Gate `node scripts/run_xtend_tests.js surface-release-handoff --json` prueft Authoring-Modi, Component-Lab-Fixture, Migration von `components[*].metadata.surface` zu `surfaces[*]`, Package-/Scaffold-Metadaten und Referenzpfade.
+
+[SurfaceManager Lazy Hydration](./surface-manager-lazy-hydration.md) dokumentiert ab `WP-SM-13` den Contract `xtend.surface.loading-policy.v1`, die Policies `eager`, `visible`, `open`, `idle` und `route`, SkeletonLoader-basierte Content-Hydration fuer Surface-Scopes, Parsedown-Container und remote-faehige Slots. Der lokale Gate `node scripts/run_xtend_tests.js surface-lazy-hydration --json` prueft den shell-first Pfad ohne Doku-App-Monkeypatch.
+
+[SurfaceManager Route Lifecycle](./surface-manager-route-lifecycle.md) dokumentiert ab `WP-SM-14` den Contract `xtend.surface.route-lifecycle.v1`, route-aware Manager, XRouter-gebundene Surface-Policies, globale Surfaces und die Boundary, dass XRouter Route-State liefert, waehrend SurfaceManager Surface-Lifecycles steuert. Der lokale Gate `node scripts/run_xtend_tests.js surface-route-lifecycle --json` prueft den Pfad ohne konkurrierende Lifecycle-Quellen.
+
+[SurfaceManager Stack Policy](./surface-manager-stack-policy.md) dokumentiert ab `WP-SM-15` den Contract `xtend.surface.stack-policy.v1`, Manager-owned `modal-policy`, Focus Trap/Restore ueber Surface-Grenzen, Inert/`aria-hidden`, Escape-Prioritaet, Scroll Lock und Layer Tokens fuer gemischte Window-/Panel-/Overlay-Stacks. Der lokale Gate `node scripts/run_xtend_tests.js surface-stack-policy --json` prueft den Pfad ohne zweite Registry.
+
+[SurfaceManager Layout Engines](./surface-manager-layout-engines.md) dokumentiert ab `WP-SM-16` den Contract `xtend.surface.layout-engine.v1`, die Engines `freeform`, `docked`, `split`, `tile` und `stacked`, snapshot-kompatible Bounds, sichtbares Docking, `undockSurface`, Viewport-Constraints, Snap-Regeln und responsive Fallbacks. Der lokale Gate `node scripts/run_xtend_tests.js surface-layout-engines --json` prueft den Pfad ohne zweite Registry.
+
+[SurfaceManager Remote Policy Bridge](./surface-manager-remote-policy.md) dokumentiert ab `WP-SM-17` den Contract `xtend.surface.remote-policy-bridge.v1`, E16 Remote-Surface-Records, Owner-/Version-/Origin-/Integrity-/Capability-Pruefung, Enterprise Registry Lookup, Degradation/Fallback, Event-Governance und die Boundary `kein Remote Runtime Loading im RMT Kernel`. Der lokale Gate `node scripts/run_xtend_tests.js surface-remote-policy --json` prueft den Pfad ohne zweite Registry.
+
+[SurfaceManager Browser Lab](./surface-manager-browser-lab.md) dokumentiert ab `WP-SM-18` den Contract `xtend.surface.browser-lab.v1`, Browser-Lab-Fixture, DOM/Pseudo-Pixel-Baselines fuer Kaltstart, Skeleton, Hydration, Route-Change und Modal-Stack sowie Performance-/CLS-/Pop-In-Budgets. Der lokale Gate `node scripts/run_xtend_tests.js surface-browser-lab --json` prueft Docs-App- und Workbench-Proben ohne Doku-App-Monkeypatch.
+
+[SurfaceManager Runtime Release Handoff](./surface-manager-runtime-release-handoff.md) dokumentiert ab `WP-SM-19` den Contract `xtend.surface.runtime-release-handoff.v1`, den produktiven Runtime-Claim fuer native `surfaces[*]`, die finale Release-Gate-Matrix, Migration Notes, Compatibility Notes, SemVer-Hinweise und offene Scopes. Der lokale Gate `node scripts/run_xtend_tests.js surface-runtime-release-handoff --json` prueft, dass die Surface Runtime releasefaehig bleibt, ohne Fabric, RMT-Kernel oder die SurfaceController-Registry zu ersetzen.
+
+[Component UX Authoring](./component-ux-authoring.md), [Component UX App Authoring](./component-ux-app-authoring.md) und [Component UX Gates](./component-ux-gates.md) dokumentieren ab `WP-E11-16`, wie Komponentenautorinnen und App-Autoren Shell, Styling, A11y, Performance, Component Network, RMT Shell Authoring, Browser-Smokes und Component Shell Theme Matrix als zusammenhaengende UX-Reife nutzen. Der Gate `node scripts/run_xtend_tests.js component-ux-authoring-docs --json` prueft diese Doku-Linie.
+
+[Component Long-Tail Migration](./component-long-tail-migration.md) dokumentiert ab `WP-E11-17`, wie die verbleibenden Long-Tail-Komponenten ohne Big-Bang-Refactor in Migrationswellen gehaertet werden. Nach `WP-E12-09` sind `x-tabs`, `x-theme`, `x-button` und `x-menu` geschlossen; seit `WP-E13-05` sind auch `xstate` als Runtime-Boundary und `x-utils` als Utility-Boundary geschlossen. Der Gate `node scripts/run_xtend_tests.js component-long-tail-migration --json` prueft Plan, Package, Scaffold, Referenzen und Handoff.
+
+[Epic 11 Enterprise UX Handoff](./epic11-enterprise-ux-handoff.md) dokumentiert ab `WP-E11-18` den Abschluss `xtend.epic11.enterprise-ux-handoff.v1`, den Modus `completed-with-accepted-long-tail-handoff`, die KPI-Abnahme, historische Accepted Residuals fuer `xstate` und `x-utils`, Release Boundary und Next-Wave Handoff. Der aktuelle RC1-Stand ist in [Known Residual Triage](./known-residual-triage.md) geschlossen.
+
+[Component Lab](./component-lab.md) dokumentiert ab `WP-E10-12` den lokalen Shell-first RMT-Pilot fuer Component Preview, RMT Inspector, Telemetry, A11y-, Performance- und Source-Link-Panels. Der Gate `node scripts/run_xtend_tests.js component-lab-rmt-inspector --json` prueft Plan, RMT-Fixture und Referenzpfade.
+
+[RMT-first Demo-App](./rmt-first-demo-app.md) dokumentiert ab `WP-E10-13`, wie `xtendrmt-rmt-first-demo.html` nur noch einen generischen RMT Root bereitstellt und `xtendrmt/rmt-first-demo-app.rmt` die App Shell, Routen, Templates, Schedules und XTend-Komponentenzuordnung besitzt. Der Gate `node scripts/run_xtend_tests.js rmt-first-demo-app --json` prueft den No-Manual-Shell-Pfad.
+
+[Existing Component Metadata](./existing-component-metadata.md) dokumentiert ab `WP-E10-14`, wie `x-router`, `x-link`, `x-input`, `x-form`, `x-modal`, `x-dialog`, `x-tabs`, `x-toast` und `x-alert` ueber `catalog/epic10-existing-component-metadata.js` als `js-legacy` Contract Overlay RMT/Fabric-kompatibel werden. Der Gate `node scripts/run_xtend_tests.js existing-component-metadata --json` prueft die Metadata-Linie.
+
+[Epic 10 Platform Gates](./epic10-platform-gates.md) dokumentiert ab `WP-E10-15`, wie Browser-Smokes, A11y, Performance, Visual Regression, Existing Component Metadata und RMT-first Demo-App als `xtend.epic10.platform-gates.v1` zusammenhaengen. Der Gate `node scripts/run_xtend_tests.js epic10-platform-gates --json` prueft die Fast-PR- und Release-Handoff-Linie.
+
+[Epic 10 Release Handoff](./epic10-release-handoff.md) dokumentiert ab `WP-E10-16` den Abschluss `xtend.epic10.release-handoff.v1`, die kanonische Guide-Struktur, Migration Notes, Release Candidate Gates, die Fabric Boundary Entscheidung `adapter-injection-via-xtend-component-resolveFabricContext` und den Next-Wave Handoff.
+
+[Visual Browser Regression](./visual-browser-regression.md) dokumentiert ab `ER-WP-35`, wie XTend sichtbare Regression, Browser-Smokes, mobile Viewports, Theme-Varianten, Performance-Profile, A11y-Remediation und Long-Tail-Haertung pro Manifest-Komponente priorisiert.
+
+[Visual Snapshot Automation](./visual-snapshot-automation.md) dokumentiert ab `WP-E12-10` den Contract `xtend.epic12.visual-snapshot-automation-contract.v1` und ab `WP-E12-11` den Runner `xtend.epic12.visual-snapshot-runner.v1`, der Component Shell Theme Matrix, lokale Fixture, JSON DOM-Baseline und DOM-first-Diff zusammenfuehrt.
+
+[Visual Owner Artifacts](./visual-owner-artifacts.md) dokumentiert ab `WP-E13-08` den Contract `xtend.epic13.visual-owner-artifact.v1`, das Manifest `tests/browser/visual-baselines/rc1-visual-owner-artifact.manifest.json` und den lokalen Gate `node scripts/run_xtend_tests.js epic13-visual-owner-artifact --json`. Screenshots und Pixel-Diff bleiben `optional-browser-driver-or-ci-artifact`, waehrend der lokale Gate DOM-first und netzwerkfrei bleibt.
+
+[RMT Production Readiness](./rmt-production-readiness.md) dokumentiert ab `WP-E13-09` den Contract `xtend.epic13.rmt-production-readiness.v1`, der RMT-first App Shell, Routing, Components, Fabric/Lanes, Lifecycle Telemetry, Diagnostics und Artifact Parity als RC1-Buendel zusammenfuehrt. Der lokale Gate `node scripts/run_xtend_tests.js epic13-rmt-production-readiness --json` bleibt statisch, offline und framework-agnostisch.
+
+[Docs RMT Production Hardening](./docs-rmt-production-hardening.md) dokumentiert ab `WP-E13-10` den Contract `xtend.epic13.docs-rmt-production-hardening.v1`. Die Docs-App bleibt Parsedown-basiert, stellt aber stabile RMT Extension-Slots fuer `parsedownHtml`, `richHtml`, `xplayerTutorial` und Diagnostics bereit. Der lokale Gate ist `node scripts/run_xtend_tests.js epic13-docs-rmt-production-hardening --json`.
+
+[Enterprise Adoption Guide](./enterprise-adoption.md) dokumentiert ab `ER-WP-39`, wie Teams Loader, lokalen Dev Server, XTend UI, XTend-Fabric, XTendRMT, Security, A11y, Performance, CI Gates und Release Readiness als zusammenhaengenden Einfuehrungspfad nutzen.
+
+[Known Residual Triage](./known-residual-triage.md) dokumentiert ab `WP-E13-05`, wie `xstate` und `x-utils` fuer RC1 als Boundary-Contracts geschlossen werden und `xtend.component.hydrate` als einziger Watchpoint nach `WP-E13-06` ging.
+
+[Hydration Performance Closure](./hydration-performance-closure.md) dokumentiert ab `WP-E13-06`, wie `xtend.component.hydrate` mit `31ms / 32ms` owner-frei geschlossen wurde. Der Gate `node scripts/run_xtend_tests.js epic13-hydration-performance-closure --json` prueft Contract, Baseline, Package, Scaffold, Registry und Handoff nach `WP-E13-08`.
+
+[PROD Browser CSP Smokes](./prod-browser-csp-smokes.md) dokumentiert ab `WP-E13-07` den Contract `xtend.epic13.prod-browser-csp-smoke.v1`, die Fixture `tests/browser/fixtures/epic13-prod-csp-smoke.html`, Nonce, same-origin Manifest, lokalen CSP Header und `npm run dev:local:csp`.
+
+---
+
+## Komponentenübersicht
+
+> **Tipp:** Jede Komponente ist einzeln dokumentiert und enthält Querverweise zu verwandten Modulen.
+
+| Komponente      | Beschreibung                        |
+|-----------------|-------------------------------------|
+| [xalert](./components/xalert.md)         | Hinweise, Warnungen, Fehleranzeigen      |
+| [xbutton](./components/xbutton.md)       | Flexibler Button                        |
+| [xcalendar](./components/xcalendar.md)   | Kalender & Datumsauswahl                |
+| [xcards](./components/xcards.md)         | Grid-Layout für Cards                    |
+| [xcode](./components/xcode.md)           | Code-Ansicht & Highlighting             |
+| [xdialog](./components/xdialog.md)       | Modale Dialoge & Overlays               |
+| [xmodal](./components/xmodal.md)         | State-getriebene Modals                 |
+| [xfooter](./components/xfooter.md)       | Footer mit Branding                     |
+| [xform](./components/xform.md)           | Flexibles Formular                      |
+| [xheader](./components/xheader.md)       | Header mit Logo & Navigation            |
+| [xhero](./components/xhero.md)           | Hero-Bereich für Landingpages           |
+| [xinput](./components/xinput.md)         | Eingabefeld                             |
+| [xlightbox](./components/xlightbox.md)   | Overlay für Bilder & Medien             |
+| [xmasonry](./components/xmasonry.md)     | Masonry-Grid-Layout                     |
+| [xmenu](./components/xmenu.md)           | Navigation & Menüs                      |
+| [xplayer](./components/xplayer.md)       | Audio/Video-Player                      |
+| [xsection](./components/xsection.md)     | Layout-Abschnitt                        |
+| [xspinner](./components/xspinner.md)     | Ladeanzeige/Spinner                     |
+| [xstate](./components/xstate.md)         | State-Management                        |
+| [xsummary](./components/xsummary.md)     | Ausklappbare Disclosure-Zusammenfassung |
+| [xtabs](./components/xtabs.md)           | Tab-Navigation                          |
+| [xtheme](./components/xtheme.md)         | Theme-Management                        |
+| [xtoast](./components/xtoast.md)         | Toast-Benachrichtigungen                |
+| [xtype](./components/xtype.md)           | Typing-Animation                        |
+| [xutils](./components/xutils.md)         | Utility-Modul fuer DOM, Events und Formate |
+| [xwriter](./components/xwriter.md)       | Rich-Text-Editor                        |
+| [xrouter](./components/xrouter.md)       | SPA-Routing-Komponente                   |
+| [xlink](./components/xlink.md)           | Deklarativer Link für Routing            |
+
+---
+
+## Weitere Ressourcen
+- [XTend-ADR](./XTend-ADR.md)
+- [Core Migration Guide](./core-migration-guide.md)
+- [parsedown.php (Markdown zu HTML)](./utils/parsedown.php)
+
+---
+
+## Testbindung
+
+Priorisierte Dokumentations- und Demo-Referenzen werden im Epic-02-Harness geprueft:
+
+```bash
+node scripts/run_xtend_tests.js references
+node scripts/run_xtend_tests.js rmt-compatibility
+```
+
+Die Referenzliste liegt unter `development/XTend-Dokumentations-und-Demo-Referenzpfade.md`.
+
+Fuer lokale Ausfuehrung, JSON-Reports und spaetere CI-Anbindung siehe `development/XTend-Test-Reporting-und-CI-Vorbereitung.md`.
+
+Neue, modernisierte und ueber `XTend-Scaffold` erzeugte Komponenten muessen ausserdem die Testpflicht aus `development/XTend-Testpflicht-und-Scaffold-Anschluss.md` erfuellen.
+
+---
+
+*Letzte Aktualisierung: 8. Mai 2026*

package/docs/XTend-ADR.md

@@ -0,0 +1,221 @@
+# XTend Architecture Decision Record
+
+- Status: Accepted
+- Datum: 8. Mai 2026
+- Contract: `xtend.docs.architecture-decision-record.v2`
+- Typ: Produktarchitektur-Baseline fuer XTend UI, XTend-Fabric und XTendRMT
+
+## Zweck
+
+Dieses ADR ersetzt die fruehere Architekturaufnahme aus den ersten Epics. Die alte Fassung beschrieb noch eine Plattform im Umbau: Core-Konsolidierung, Loader-Rename, RMT-Fusion, Test-Harness und Component-Coverage waren damals teilweise erst Zielbild.
+
+Die heutige Entscheidung beschreibt den aktuellen Architekturvertrag fuer XTend als Enterprise-Webframework:
+
+- XTend UI ist das Web-Component- und UI-Builder-Produkt.
+- XTendRMT ist Scheduler, Runtime-Kernel, Templating Engine und native `.rmt` Authoring-Sprache.
+- XTend-Fabric ist die host-nahe Schutz-, Telemetry-, Lane- und Reporter-Schicht.
+- Die Docs-App ist eine XTend-App mit RMT-generierter Shell und Parsedown als scheduled Content-Komponente.
+- RMT Tooling, Linter und Language Server sind Teil der Authoring-Plattform.
+
+## Entscheidung
+
+XTend wird als **manifest- und state-zentriertes Web-Components-Framework** mit RMT-first App Authoring, Fabric Boundary und TypeScript-first Component Platform weitergefuehrt.
+
+Dokumentation, Manifest und Laufzeit-APIs muessen kuenftig als zusammengehoerender Vertrag gepflegt werden.
+
+Die Architektur trennt bewusst fuenf Verantwortungen:
+
+| Ebene | Verantwortung | Darf wissen von | Darf nicht tun |
+|-------|---------------|-----------------|----------------|
+| XTend UI | Custom Elements, Shells, Styling, A11y, UX und Host-Komponenten | Manifest, Loader, Component Contracts, Fabric Context | RMT-Kernel-Semantik implementieren |
+| XTend Loader | lokale ESM-Imports, Manifest Policy, Bootstrap, Component Loading | Manifest, Import Policy, Runtime API | CDN-Fallbacks erzwingen oder externe Quellen still laden |
+| XTend-Fabric | Fehlergrenzen, Telemetry, Reporter Adapter, Fibers, Lanes, Backpressure | XTend Runtime, optionale RMT Adapter Results | RMT-Dokumente parsen oder XTendRMT ersetzen |
+| XTendRMT | `.rmt` Source, DSL-Domains, Scheduling, Templates, Routes, Diagnostics | neutrale Adapter Records und Host Capabilities | XTend, XRouter, DOM, React, Vue oder `xstate` direkt importieren |
+| Tooling | Linter, LSP, Snippets, Reports, Editor Bridges | RMT Source Model, Parser, Rule Engine, Schema | eigene Semantik neben dem RMT-Sprachkern pflegen |
+
+## Architekturprinzipien
+
+### 1. Native Web Standards bleiben der Kern
+
+XTend basiert auf Custom Elements, Shadow DOM, Slots, CSS Custom Properties und ES-Modulen. Build- und TypeScript-Artefakte duerfen diese Laufzeit nicht hinter einem proprietaeren Abstraktionsmodell verstecken.
+
+Komponenten sind weiterhin echte Web Components. Framework-Integrationen fuer React, Vue oder Custom Hosts entstehen als Adapter oder Host-Konventionen, nicht als Ersatz fuer die native Oberflaeche.
+
+### 2. State-zentrierte UI
+
+`xstate` bleibt die host-nahe State-Boundary fuer XTend UI. Der State ist die beobachtbare Wahrheit fuer UI-Zustaende, Route-Spiegel, Theme-Kontext, Feedback, Komponentenzustaende und Diagnostics.
+
+Das **Digital Twin Principle** bleibt verbindlich: relevante UI-Aktionen muessen in einen nachvollziehbaren State-, Event- oder Diagnostic-Record zurueckschreiben. Lokale Flags duerfen nur abgeleitete Render-Caches sein.
+
+### 3. RMT-first, aber framework-agnostisch
+
+Neue App-Shells, Routes, Templates und Scheduling-Policies sollen primaer in nativen `.rmt` Dokumenten beschrieben werden. `.rmt.json` bleibt nur ein Edge-Case-Fallback fuer Hosts ohne passenden MIME-Typ oder fuer Legacy-Pfade.
+
+RMT ist trotzdem kein XTend-Untermodul. XTend ist First-Class Host, aber nicht Pflicht-Host. Der RMT-Kernel sieht Adapter-Records wie `xtend.component` oder `xtend.xrouter`, importiert aber keine XTend-Komponenten und fuehrt keine DOM-Arbeit selbst aus.
+
+### 4. Shell-first Rendering
+
+App-Shells sollen zuerst stabil rendern. Content, Markdown, Rich HTML, Medien und schwere Komponenten werden anschliessend scheduled oder lazy nachgeladen.
+
+Die Docs-App ist der Referenzpfad: RMT erzeugt die Shell, Parsedown ist eine scheduled Content-Komponente. Spaetere Inhalte wie XPlayer-Tutorials oder Rich-Content-Bloecke koennen in dieselbe Scheduling-Struktur aufgenommen werden.
+
+### 5. Fabric als Sicherheits- und Telemetry-Schicht
+
+XTend-Fabric ist der globale Host-Sicherheitslayer fuer Fehlergrenzen, Reporter Adapter, Telemetry, Lane/Fiber-Kontext, Backpressure und Qualitaetssignale.
+
+Fabric darf RMT Adapter Results und Scheduler-Signale aufnehmen, aber nicht den RMT-Kernel ersetzen. Dadurch bleibt die Grenze klar:
+
+```text
+RMT Kernel -> Adapter / Bridge Result -> XTend-Fabric -> XTend UI / Reporter
+```
+
+### 6. Performance-by-design
+
+Performance ist kein spaeter Optimierungsschritt. Komponenten muessen ihre Hydration-, Visibility-, Idle-, Busy- und Measurement-Profile deklarieren. Loader, Fabric und RMT duerfen diese Profile fuer Scheduling und Diagnostics verwenden.
+
+Die akzeptierten Baselines sind:
+
+- lokales ESM statt CDN-Abhaengigkeit
+- manifestbasierte Import Policy
+- Lazy, Idle und Visible Hydration Policies
+- Performance Regression Gates
+- Component-level Performance Profiles
+- Shell-first Rendering fuer App-Erstaufbau
+
+### 7. A11y-by-design
+
+A11y ist Teil des Component Contracts. Neue Komponenten muessen Keyboard-Verhalten, Focus, ARIA, Screenreader-Signale, Reduced Motion, Contrast und sichtbare States als Produktoberflaeche behandeln.
+
+RMT darf A11y-relevante Shell- und Component-Metadaten beschreiben. Die konkrete Ausfuehrung bleibt bei XTend UI und den Host-Adaptern.
+
+### 8. Tooling ist Teil des Produkts
+
+RMT ist nicht nur Runtime-Format, sondern Authoring-Sprache. Deshalb gehoeren Linter, AI-Agent Repair Report, Snippets, LSP, Editor Bridges und Release Gates zur Plattform.
+
+Der Language Server nutzt dieselbe Semantik wie `xt rmt lint`; Editor-Integrationen duerfen keine zweite RMT-Regelwelt pflegen.
+
+## Systembild
+
+```text
+App / Host
+  |
+  | local ESM + manifest policy
+  v
+XTend Loader
+  |
+  +-- XTend UI Components
+  |     +-- x-router / x-link
+  |     +-- x-header / x-menu / x-icon / x-hero / ...
+  |     +-- form, feedback, overlay, media and layout components
+  |
+  +-- xstate / xtheme / api.js
+  |
+  +-- XTend-Fabric
+        |
+        +-- telemetry, fibers, lanes, reporter adapters
+        |
+        +-- optional RMT adapter results
+
+XTendRMT
+  |
+  +-- .rmt source model
+  +-- templates, routes, components, schedules, adapters
+  +-- linter, language server, snippets, diagnostics
+  |
+  +-- host adapters: xtend.component, xtend.xrouter, docs.parsedown, custom hosts
+```
+
+## Laufzeitentscheidungen
+
+### Loader und Manifest
+
+Der kanonische Loader ist `xtend-loader.js`. Er arbeitet lokal, ESM-basiert und manifestgesteuert. Externe CDNs sind kein Normalpfad. Manifest-URLs und Component-Imports unterliegen der Import Policy.
+
+### Komponenten
+
+Komponenten folgen dem Component Contract v2 und der Epic-11-UX-Shell-Linie:
+
+- TypeScript-first Source, wenn neue Komponenten entstehen
+- Public Types
+- RMT Metadata
+- Fabric Boundary
+- A11y- und Performance-Profil
+- Component Fixture
+- Component Suite
+- Docs-Seite
+
+`x-icon` ist der Referenzfall fuer eine framework-agnostische Erweiterung: internes Core Icon Pack, lokale Lucide-Erweiterung, Pack Registry und RMT-kompatibler Adapter ohne CDN-Pflicht.
+
+### Routing
+
+`x-router` bleibt die XTend-UI-Routing-Komponente. RMT kann Routes deklarieren und ueber den `xtend.xrouter` Adapter an XRouter uebergeben. Seitentitel, Route-Metadaten und shell-nahe Navigation duerfen in RMT beschrieben werden.
+
+### Docs-App
+
+Die Docs-App ist nicht nur Dokumentation, sondern ein Produktbeispiel. Sie soll zeigen:
+
+- Shell-first Rendering mit RMT
+- Parsedown als scheduled Content-Komponente
+- stabile Navigation mit `x-router`
+- Quick Start, RMT Authoring, Linter und LSP als offizielle Developer Journey
+- keine App-spezifische Parallel-Logik, wenn eine fehlende Faehigkeit in XTend-Komponenten gehoert
+
+## Non-Goals
+
+Diese Entscheidung bedeutet ausdruecklich nicht:
+
+- XTend wird zu einem React-/Vue-Ersatz mit eigenem virtuellen DOM.
+- RMT wird an XTend gebunden.
+- Fabric wird zum Parser, Router oder Scheduler-Kernel.
+- `.rmt.json` wird als bevorzugtes Authoring-Format beworben.
+- Editor-Plugins duerfen eigene RMT-Semantik einfuehren.
+- Komponenten duerfen A11y oder Performance als optionale spaetere Politur behandeln.
+
+## Konsequenzen
+
+1. Neue Architekturarbeit muss zuerst einer Ebene zugeordnet werden: Loader, XTend UI, Fabric, RMT, Tooling oder Docs.
+2. Wenn XTend-spezifisches Verhalten in RMT gebraucht wird, entsteht ein Adapter-Contract, kein Kernel-Sonderfall.
+3. Wenn eine App Sonderlogik braucht, wird zuerst geprueft, ob eine generische Component-, Fabric- oder RMT-Faehigkeit fehlt.
+4. Neue Dokumentation muss native `.rmt` Dateien empfehlen. `.rmt.json` darf nur als Fallback beschrieben werden.
+5. Jede neue First-Class-Komponente braucht RMT-, Fabric-, A11y-, Performance-, Type- und Testabdeckung.
+6. Release- und Reference-Gates bleiben Teil des Architekturvertrags.
+
+## Verbindliche Gates
+
+Die Architektur-Baseline wird durch lokale Gates abgesichert:
+
+```bash
+node scripts/run_xtend_tests.js architecture
+node scripts/run_xtend_tests.js references --json
+node scripts/run_xtend_tests.js rmt-compatibility --json
+node scripts/run_xtend_tests.js epic14-lsp-handoff --json
+npm run test:release:full:report
+```
+
+Fuer gezielte Arbeit bleiben die spezialisierten Gates massgeblich:
+
+| Bereich | Gate |
+|---------|------|
+| Core Architektur | `node scripts/run_xtend_tests.js architecture` |
+| Component Catalog | `npm run test:catalog-coverage` |
+| RMT Tooling | `npm run test:rmt-tooling` |
+| LSP Handoff | `npm run test:epic14-lsp-handoff` |
+| Docs Referenzen | `node scripts/run_xtend_tests.js references --json` |
+
+## Akzeptierte Folgeentscheidungen
+
+Dieses ADR integriert die Ergebnisse der bisherigen Einzelentscheidungen:
+
+- Loader und lokale Entwicklung: `xtend.loader.local-development.adr.v1`
+- XTend-Fabric: `xtend.fabric.adr.v1`
+- Security Trust Boundaries: `xtend.security.trust-boundaries.adr.v1`
+- XTendRMT First-Class Fusion: `development/ADR-XTendRMT-First-Class-Fusion.md`
+- RMT Tooling und LSP Handoff: `xtend.epic14.lsp-handoff.v1`
+
+Die Einzel-ADRs bleiben als Detailquellen gueltig. Dieses Dokument ist die aktuelle Docs-App-Baseline fuer das Gesamtbild.
+
+## Fazit
+
+XTend ist heute kein loses Komponentenpaket mehr, sondern eine gekoppelte Plattform aus Web Components, Loader, State, Fabric, RMT und Authoring Tooling.
+
+Der wichtigste Produktpfad ist jetzt nicht mehr die reine Flaechenerweiterung, sondern die konsequente Reife dieser Plattform: native `.rmt` Authoring-Erfahrung, bessere Editor-Unterstuetzung, stabile Component Shells, A11y, Performance, Security und nachvollziehbare Release Gates.