@ccslabs/xtend 0.1.0-rc.1 → 0.1.2

package/docs/de/enterprise-component-flex-release-handoff.md

@@ -0,0 +1,129 @@
+# Enterprise Component Flex Release Handoff
+
+- Contract: `xtend.enterprise.component-flex-release-handoff.v1`
+- Workpackage: `ECH-WP-12`
+- Status: `accepted-enterprise-design-system-ready-handoff`
+- Target: `enterprise-design-system-ready-release-candidate`
+- Current Version: `0.1.0-rc.1`
+- Proposed Version: `0.1.0-enterprise-design-system-rc.1`
+- Publish Boundary: `private-until-release-owner-acceptance`
+- Local Gate: `node scripts/run_xtend_tests.js enterprise-component-flex-release-handoff --json`
+- Package Script: `npm run test:enterprise-component-flex-release-handoff`
+
+## Zweck
+
+Dieses Handoff schliesst die Enterprise Component Flexibilitaets- und Theme-Hardening-Welle ab. Es bewertet die SemVer-Auswirkung der neuen Attribute, Tokens, Parts und Doku-Oberflaechen, dokumentiert Deprecated Aliases, beschreibt die Migration fuer bestehende Apps und benennt die letzten Adoption Risiken vor einem Release Owner Review.
+
+Das Paket ist release-ready, aber nicht automatisch published. `package.json` ist fuer RC1-Publish-Prep inzwischen auf `private: false` gesetzt; ein Publish braucht weiterhin den manuellen Release-Owner-Befehl und bei Bedarf Conditional Network Evidence.
+
+## SemVer-Bewertung
+
+Die Haertungswelle wird als `minor-pre-1.0-additive-public-api-hardening` bewertet.
+
+| Bereich | Klassifizierung | Default kompatibel | Migration Pflicht | Notiz |
+|---------|-----------------|--------------------|-------------------|-------|
+| `x-header-menu-presentation-modes` | `minor-additive-public-api` | ja | nein | `menu-mode`, Placement, Modalitaet und Sizing sind additiv; der Default bleibt `drawer`. |
+| `xtheme-token-alias-layer` | `minor-additive-token-api` | ja | nein | Normalisierte `--xtend-*` Aliases werden addiert, waehrend Legacy-Namen gebridged bleiben. |
+| `icon-control-hardening` | `patch-compatible-a11y-hardening` | ja | nein | Sichtbare Textglyphen wurden durch echte Icon Controls ersetzt, ohne Host-Command-Intent zu brechen. |
+| `overlay-layout-form-navigation-parts` | `minor-additive-css-parts-and-tokens` | ja | nein | Neue Parts und Component Tokens erweitern Skinning-Flaechen ohne dokumentierte Defaults zu entfernen. |
+| `visual-dom-snapshot-matrix` | `test-artifact-only` | ja | nein | DOM-Baselines und Visual Quality Reports sind lokale Gates, keine Runtime-Breaking-Changes. |
+| `third-party-authoring-guide` | `docs-only-adoption-handoff` | ja | nein | Corporate Design Authoring wird als unterstuetzter Override-Pfad dokumentiert. |
+
+SemVer-Entscheidung:
+
+- Bestehende Defaults bleiben kompatibel.
+- Neue Modi sind additive Features.
+- Breaking Changes: keine.
+- Public Surface Aenderungen sind erwuenscht und dokumentiert: Attribute, Tokens, CSS Parts, Slots, XTheme-Bruecken und Docs-Gates.
+- Vorgeschlagene Version: `0.1.0-enterprise-design-system-rc.1`.
+
+## Deprecated Aliases
+
+Deprecated Aliases bleiben fuer bestehende Apps gebridged. Entfernen oder Umbenennen ist erst in einem naechsten Major oder in einem expliziten Migration Window erlaubt.
+
+| Typ | Deprecated | Replacement | Entfernung |
+|-----|------------|-------------|------------|
+| CSS Token | `--xtend-glass-bg` | `--xtend-surface-overlay` | `not-before-next-major-or-explicit-migration-window` |
+| CSS Token | `--xtend-shadow` | `--xtend-elevation-2` | `not-before-next-major-or-explicit-migration-window` |
+| CSS Token | `--xtend-radius` | `--xtend-radius-md` | `not-before-next-major-or-explicit-migration-window` |
+| CSS Token | `--xtend-font-family` | `--xtend-font-family-body` | `not-before-next-major-or-explicit-migration-window` |
+| CSS Token | `--xtend-overlay-bg` | `--xtend-surface-overlay` | `not-before-next-major-or-explicit-migration-window` |
+| CSS Token | `--xtend-border-color` | `--xtend-border-subtle` | `not-before-next-major-or-explicit-migration-window` |
+| CSS Token | `--header-bg` | `--xtend-header-surface` | `not-before-next-major-or-explicit-migration-window` |
+| CSS Token | `--header-fg` | `--xtend-header-text` | `not-before-next-major-or-explicit-migration-window` |
+| CSS Token | `--drawer-bg` | `--xtend-drawer-surface` | `not-before-next-major-or-explicit-migration-window` |
+| CSS Token | `--drawer-color` | `--xtend-drawer-text` | `not-before-next-major-or-explicit-migration-window` |
+| CSS Token | `--button-text-color` | `--xtend-button-text` | `not-before-next-major-or-explicit-migration-window` |
+| CSS Part | `drawer` | `menu` | `not-before-next-major-or-explicit-migration-window` |
+| CSS Part | `drawer-surface` | `menu-surface` | `not-before-next-major-or-explicit-migration-window` |
+| Slot | `utility` | `actions` | `not-before-next-major-or-explicit-migration-window` |
+| Density | `spacious` | `comfortable` | `normalized-at-runtime` |
+
+## Migration Notes
+
+| ID | Owner | Aktion | Risiko |
+|----|-------|--------|--------|
+| `adopt-token-alias-layer` | Design System | Corporate Tokens zuerst auf `--xtend-*` Aliases mappen, bevor Component Internals ueberschrieben werden. | Legacy Token Overrides koennen von XTheme und Forced Colors abdriften. |
+| `replace-glyph-controls-with-icons` | Component Authors | `x-icon`, Inline-SVG oder registrierte Icon Packs fuer Close, Menu, Disclosure und Status Controls verwenden. | Textglyph Controls sind in enterprise-ready Komponenten nicht mehr akzeptiert. |
+| `choose-xheader-menu-mode` | App Shell | Default `drawer` behalten oder explizit `side-panel`, `popover`, `fullscreen` oder `inline-main` waehlen. | Custom CSS, das einen fest verdrahteten Full-Width Drawer annimmt, muss auf Tokens und Parts wechseln. |
+| `map-overlay-form-nav-parts` | Component Authors | `surface`, `backdrop`, `close`, `content`, `control`, `label`, `icon` und `nav` Parts zum Skinning verwenden. | Shadow-DOM Deep Selectors bleiben unsupported und koennen bei Updates brechen. |
+| `run-visual-dom-matrix` | Quality | WP-10 DOM Snapshot Matrix fuer Header-Modi, Themes, Densities, Motion und Typografie laufen lassen. | Corporate Themes koennen statische Token Checks bestehen und trotzdem Kontrast, Fokus oder Layout verlieren. |
+| `publish-third-party-guide` | Docs | WP-11 Authoring Guide als Standard-Onboarding fuer externe Designsysteme nutzen. | Teams koennen sonst Komponenten forken, statt XTheme, XTend.css, Parts, Slots und Icon Packs zu nutzen. |
+| `keep-release-owner-boundary` | Release Owner | Publishing blockiert halten, bis Owner Review Gates, Migration Notes und optionale Artefakte akzeptiert. | Dieses Handoff macht die Welle release-ready, nicht automatisch published. |
+
+## Release Checklist
+
+- `package-private`
+- `all-ech-gates-green`
+- `semver-classification-recorded`
+- `deprecated-aliases-documented`
+- `migration-notes-complete`
+- `third-party-authoring-guide-linked`
+- `visual-dom-matrix-clean`
+- `references-clean`
+- `release-owner-review-required`
+- `conditional-network-evidence-if-publish`
+
+## Adoption Risiken
+
+| ID | Severity | Mitigation |
+|----|----------|------------|
+| `shadow-dom-deep-selector-risk` | medium | CSS Parts und Custom Properties statt privater Shadow DOM Selectors nutzen. |
+| `legacy-token-drift-risk` | medium | Legacy Tokens auf normalisierte Aliases mappen und XTheme sowie XTend.css synchron halten. |
+| `forced-colors-brand-risk` | high | Forced-Colors-Pfade mit `Canvas`, `CanvasText`, `Highlight` und `HighlightText` betreiben. |
+| `visual-signature-generic-risk` | medium | Signature UI und Visual DOM Matrix Gates laufen lassen, wenn Corporate Palettes angewendet werden. |
+| `publish-boundary-risk` | high | Private Package Boundary bis zur Release Owner Acceptance halten. |
+
+## Gate Matrix
+
+Source Gates:
+
+```bash
+node scripts/run_xtend_tests.js signature-ui-visual-quality --json
+node scripts/run_xtend_tests.js enterprise-component-flex-hardening-contract --json
+node scripts/run_xtend_tests.js enterprise-component-style-audit --json
+node scripts/run_xtend_tests.js xtheme-token-alias-layer --json
+node scripts/run_xtend_tests.js enterprise-icon-control-audit --json
+node scripts/run_xtend_tests.js xheader-menu-modes --json
+node scripts/run_xtend_tests.js enterprise-overlay-mode-token-parity --json
+node scripts/run_xtend_tests.js enterprise-layout-display-media-tokenization --json
+node scripts/run_xtend_tests.js enterprise-form-control-theme-a11y --json
+node scripts/run_xtend_tests.js enterprise-navigation-routing-state-hardening --json
+node scripts/run_xtend_tests.js enterprise-visual-dom-snapshot-matrix --json
+node scripts/run_xtend_tests.js enterprise-third-party-authoring-guide --json
+```
+
+Release Handoff Gates:
+
+```bash
+node scripts/run_xtend_tests.js enterprise-component-flex-release-handoff --json
+node scripts/run_xtend_tests.js component-shell-theme-matrix --json
+node scripts/run_xtend_tests.js references --json
+node scripts/run_xtend_tests.js design-tokens --json
+```
+
+## Handoff Entscheidung
+
+Decision: `enterprise-design-system-ready-release-owner-review`
+
+Naechster Schritt ist kein weiteres Workpackage in diesem Backlogpaket, sondern Release Owner Review. Der Publish Boundary `private-until-release-owner-acceptance` bleibt aktiv, bis die Checkliste angenommen wurde und optionale Netzwerk-Artefakte fuer einen echten Publish bereitstehen.

package/docs/de/epic10-platform-gates.md

@@ -0,0 +1,62 @@
+# Epic 10 Platform Gates
+
+Contract: `xtend.epic10.platform-gates.v1`
+
+Dieses Dokument beschreibt die Gate-Kette aus `WP-E10-15`. Sie buendelt Browser-, A11y-, Performance- und Visual-Gates fuer die Epic-10 Component Platform.
+
+## Lokaler Gate
+
+```bash
+node scripts/run_xtend_tests.js epic10-platform-gates --json
+npm run test:epic10-platform-gates
+```
+
+## Gate-Domains
+
+- `component-contract`: Component Contract v2 und Existing Component Metadata
+- `rmt-first-app`: RMT-first Demo-App ohne manuelle Shell
+- `browser-smoke`: lokale Browser-nahe Fixtures
+- `a11y`: Keyboard, Screenreader, Reduced Motion und Contrast
+- `performance`: Measurements, Regression und Hydration Policies
+- `visual-browser-regression`: Viewports, Theme-Varianten und Visual States
+- `ci-handoff`: Fast-PR- und Release-Komposition
+
+## Fast PR
+
+Der Fast PR Gate enthaelt die neuen Epic-10 Plattformregeln, bleibt aber ohne release-only Performance Regression:
+
+```bash
+node scripts/run_xtend_tests.js component-contract-v2 epic10-p0-component-wave component-lab-rmt-inspector rmt-first-demo-app existing-component-metadata browser a11y-hydration screenreader-signals motion-contrast regression-priority references --json
+```
+
+`npm run test:pr` fuehrt diese Linie zusammen mit Core-, Fabric-, Security- und Docs-RMT-Gates aus.
+
+## Release
+
+Release-Gates fuehren zusaetzlich aus:
+
+- `fabric-performance-measurements`
+- `performance-regression`
+- `hydration-policy`
+
+Der vollstaendige Release-Pfad bleibt:
+
+```bash
+npm run test:release:full
+```
+
+## Browser-Smokes
+
+Die Gate-Kette erwartet folgende lokale Fixtures:
+
+- `tests/browser/fixtures/custom-elements-smoke.html`
+- `tests/browser/fixtures/core-flows-smoke.html`
+- `tests/browser/fixtures/rmt-xrouter-xtend-smoke.html`
+- `tests/browser/fixtures/rmt-first-demo-app-smoke.html`
+- `tests/browser/fixtures/a11y-focus-keyboard-smoke.html`
+
+CDN-Ladungen sind in dieser Linie nicht erlaubt.
+
+## Handoff
+
+`WP-E10-15` schliesst die Testbarkeit der Epic-10-Plattformlinie ab. Seit `WP-E10-16` ist der Abschlussgate `epic10-release-handoff` Teil der Fast-PR-/Release-Handoff-Sicht, damit Dokumentation, Guide-Struktur und Publish Boundary zusammen mit den Plattformgates geprueft werden.

package/docs/de/epic10-release-handoff.md

@@ -0,0 +1,81 @@
+# Epic 10 Release Handoff
+
+Contract: `xtend.epic10.release-handoff.v1`
+
+Dieses Dokument ist der offizielle Abschluss- und Handoff-Punkt fuer Epic 10.
+
+## Status
+
+Epic 10 ist abgeschlossen. Alle 16 Workpackages sind `completed`.
+
+Der lokale Gate lautet:
+
+```bash
+node scripts/run_xtend_tests.js epic10-release-handoff --json
+npm run test:epic10-release-handoff
+```
+
+## Kanonische Guides
+
+| Thema | Guide |
+|-------|-------|
+| Component Platform | [Component Platform](./component-platform.md) |
+| TypeScript-first Komponenten | [TypeScript Components](./typescript-components.md) |
+| RMT-first XTend Apps | [RMT-first XTend Apps](./rmt-first-xtend-apps.md) |
+| Component Lab | [Component Lab](./component-lab.md) |
+| Existing Component Metadata | [Existing Component Metadata](./existing-component-metadata.md) |
+| Platform Gates | [Epic 10 Platform Gates](./epic10-platform-gates.md) |
+| Enterprise Adoption | [Enterprise Adoption](./enterprise-adoption.md) |
+
+## Fabric Boundary
+
+Die kanonische Component-Fabric-Boundary ist:
+
+```text
+adapter-injection-via-xtend-component-resolveFabricContext
+```
+
+Komponenten erhalten Fabric-, Lane- und Fiber-Kontext ueber den `xtend.component` Adapter. `window.XTendFabric` bleibt fuer Hosts und Enterprise-Integration nutzbar, ist aber nicht der Component-Contract. Die RMT Boundary bleibt `no-rmt-kernel-import-of-xtend-types`.
+
+## Migration Notes
+
+Fuer Apps und Komponenten aus dem Stand vor Epic 10 gilt:
+
+- Neue Komponenten werden TypeScript-first unter `src/components/<tag>/` geplant.
+- Runtime-Artefakte bleiben lokale ES Modules unter `components/`.
+- `xtend-loader.js` ist kanonisch; `xtend-dev.js` bleibt Legacy Boundary.
+- Vollstaendige XTend Apps werden in RMT beschrieben.
+- Existing JS Components werden zuerst ueber RMT/Fabric Metadata Overlays angebunden.
+- Big-Bang-TypeScript-Migrationen sind nicht Teil des Zielpfads.
+- Performance-, A11y- und Visual-Gates sind Teil der Component-Definition.
+- CDN-Pfade bleiben aus Default-, Demo- und Testpfaden entfernt.
+
+## Release Candidate Gate
+
+Vor einem Release Candidate:
+
+```bash
+npm run test:pr:report
+npm run test:release:full:report
+npm run release:report
+npm run pack:dry-run
+```
+
+Conditional Network Gates:
+
+```bash
+npm audit --audit-level=moderate
+npm sbom --sbom-format=cyclonedx --json
+```
+
+Publishing bleibt blockiert, bis ein Release Owner `private-until-release-owner-acceptance` explizit freigibt.
+
+## Next-Wave Handoff
+
+Die naechste Produktwelle sollte folgende Themen aufnehmen:
+
+- Long-Tail Component Runtime Migration
+- Remaining Performance Profile Authoring
+- Component Catalog Completion
+- Release Candidate Packaging
+- XTendRMT Upstream DSL Polish

package/docs/de/epic11-enterprise-ux-handoff.md

@@ -0,0 +1,70 @@
+# Epic 11 Enterprise UX Handoff
+
+Docs Contract: `xtend.epic11.enterprise-ux-handoff.v1`
+
+Epic 11 schliesst die sichtbare Enterprise-UX-Reife der XTend-Komponenten ab. Shell, Styling, Runtime-A11y, Performance, Component Network, RMT Shell Authoring, Component Lab, Browser-Smokes, Theme-Matrix, Authoring Guides und Long-Tail-Migration sind nun als lokale Gates verbunden.
+
+## Abschlussmodus
+
+```text
+completed-with-accepted-long-tail-handoff
+```
+
+Das bedeutet: Die zentrale Component-UX-Plattform ist akzeptiert. Offene Long-Tail-Punkte werden als Produkt-Handoff weitergefuehrt, nicht als unerkannte Restarbeit.
+
+## Lokaler Gate
+
+```bash
+node scripts/run_xtend_tests.js epic11-enterprise-ux-handoff --json
+```
+
+## Historische Accepted Residuals
+
+Diese Tabelle beschreibt den Stand des Epic-11-Handoffs. Der aktuelle RC1-Stand wird durch [Known Residual Triage](./known-residual-triage.md) fortgeschrieben.
+
+| Komponente | Prio | Ziel | Restdimension |
+|------------|------|------|---------------|
+| `xstate` | P1 | `ux-baseline-probe` | historisch: A11y, Performance |
+| `x-utils` | P2 | `ux-baseline-probe` | historisch: Suite, Fixture, Types, Performance |
+
+`x-tabs` ist durch `WP-E12-02`/`WP-E12-03` geschlossen. `x-theme` ist durch `WP-E12-04`/`WP-E12-05` geschlossen. `x-button` ist durch `WP-E12-06` geschlossen. `x-menu` ist durch `WP-E12-07` geschlossen und nun `enterprise-ready`. `xstate` besitzt seit `WP-E12-08` Suite, Fixture, Public Types, Lifecycle Events, Fabric Diagnostics und RMT State Adapter. `x-utils` besitzt seit `WP-E12-09` Utility Contract, Import Policy, Fixture und Public Types. Die spaetere [Known Residual Triage](./known-residual-triage.md) schliesst beide Scopes fuer RC1 als Runtime- beziehungsweise Utility-Boundary.
+
+## Gate-Kette
+
+- `component-shell-contract`
+- `component-styling-contract`
+- `runtime-a11y-contract`
+- `component-ux-performance`
+- `component-network-contract`
+- `rmt-shell-authoring-ux`
+- `form-controls-ux`
+- `feedback-status-ux`
+- `navigation-routing-ux`
+- `overlay-interaction-ux`
+- `layout-display-media-ux`
+- `component-lab-ux-inspector`
+- `component-ux-browser-smokes`
+- `component-shell-theme-matrix`
+- `component-ux-authoring-docs`
+- `component-long-tail-migration`
+- `catalog-coverage`
+- `regression-priority`
+- `references`
+
+## Release Boundary
+
+`package.json` bleibt `private: true`. Publishing bleibt bis Release Owner Acceptance gesperrt:
+
+```text
+private-until-release-owner-acceptance
+```
+
+## Next-Wave Handoff
+
+- Long-Tail Runtime Implementation
+- Visual Snapshot Automation
+- Enterprise Design System Token Productization
+- RMT DSL Authoring Polish
+- Release Candidate Owner Acceptance
+
+Die RMT-Kernel-Grenze bleibt `no-rmt-kernel-import-of-xtend-types`.

package/docs/de/epic12-rc0-handoff.md

@@ -0,0 +1,61 @@
+# Epic 12 RC0 Handoff
+
+- Contract: `xtend.epic12.rc0-handoff.v1`
+- Report: `xtend.epic12.rc0-handoff-report.v1`
+- Workpackage: `WP-E12-16`
+- Lokaler Gate: `node scripts/run_xtend_tests.js epic12-rc0-handoff --json`
+- Entscheidung: `ready-for-release-owner-review-not-publish`
+
+Epic 12 ist abgeschlossen. XTend besitzt nun einen konkreten RC0-Pfad fuer Release Owner Review, ohne die Publish Boundary zu oeffnen.
+
+## Was RC0 enthaelt
+
+| Bereich | Stand |
+|---------|-------|
+| Long-Tail | `x-tabs`, `x-theme`, `x-button`, `x-menu` geschlossen |
+| Boundary Residuals | `xstate`, `x-utils`, `xtend.component.hydrate` akzeptiert und sichtbar |
+| Visual Snapshot | DOM-first Runner mit JSON-Baseline |
+| Design Tokens | `--xtend-*` Produkt-Tokenlinie |
+| RMT DSL | Authoring Polish fuer Shells, Routes, Links, Slots, Commands, Hydration und Lanes |
+| Docs | RC0 Adoption Guide und Migration Notes aktuell |
+| Release Gate | RC0 Gate Matrix lokal ausfuehrbar |
+
+## Owner Review
+
+Vor einer Publish-Entscheidung braucht der Release Owner:
+
+- Full Release Gate Report
+- RC0 Gate Matrix Report
+- Epic 12 RC0 Handoff Report
+- Package Dry Run Ausgabe
+- Conditional Network Gate Status
+- Known Residual Policy
+- Migration Notes
+- Publish Boundary Entscheidung
+
+## Lokale Gates
+
+```bash
+node scripts/run_xtend_tests.js epic12-rc0-handoff --json
+node scripts/run_xtend_tests.js epic12-docs-adoption --json
+node scripts/run_xtend_tests.js rc0-gate-matrix --json
+npm run test:release:full:report
+npm run pack:dry-run
+```
+
+Conditional Network Gates:
+
+```bash
+npm audit --audit-level=moderate
+npm sbom --sbom-format=cyclonedx --json
+```
+
+## Publish Boundary
+
+`private-until-release-owner-approval` bleibt aktiv. Ein gruener RC0-Handoff bedeutet:
+
+```text
+ready-for-release-owner-review-not-publish
+```
+
+Die naechste Entscheidung ist `release-owner-acceptance`.