@ccslabs/xtend 0.1.0-rc.1

package/xtend-builder/scaffold.d.ts

@@ -0,0 +1,3 @@
+import type { XtendBuilderCliIo } from './builder-public-types';
+
+export declare function runCli(args?: string[], io?: XtendBuilderCliIo): number;

package/xtend-builder/scaffold.js

@@ -0,0 +1,11 @@
+#!/usr/bin/env node
+
+const { runCli } = require('./lib/cli');
+
+if (require.main === module) {
+  process.exitCode = runCli(process.argv.slice(2));
+}
+
+module.exports = {
+  runCli
+};

package/xtend-builder/templates/README.md

@@ -0,0 +1,33 @@
+# XTend-Scaffold Templates
+
+Dieser Bereich enthaelt ab `WP-E03-04` den Template-Ladepfad fuer `XTend-Scaffold`.
+
+`xtend-builder/templates/registry.js` stellt die Template-Registry mit Schema `xtend.scaffold.template-registry.v1` bereit.
+
+```bash
+node xtend-builder/scaffold.js templates --json
+```
+
+Die Registry fuehrt Template-IDs fuer `component`, `docs`, `tests`, `fixtures`, `types`, `manifest` und `demo`. Seit `WP-E03-05` sind die Pflichtartefakt-Templates fuer `component`, `docs`, `tests`, `fixtures`, `types` und `manifest` konkret vorhanden. Seit `WP-E03-06` werden Manifest- und Hydration-Werte aus `xtend-builder/wiring/` in diese Templates eingespeist. Seit `WP-E03-07` werden profilbasierte State-, Event- und API-Patterns ebenfalls ueber `xtend-builder/wiring/` gerendert. Seit `WP-E03-09` enthaelt das Types-Template den Typing-Contract und die vorbereitete XTendRMT-Adapter-Anbindung aus `xtend-builder/typing/`. Seit `WP-E03-10` ist das `demo` Template als Preview-Reference-Plan implementiert. Seit `WP-E03-11` tragen Source-, Docs-, Types- und Manifest-Templates die Extension-Point-Metadaten aus `xtend-builder/extensions/`. Seit Epic 04 / `WP-E04-08` muessen RMT-kompatible Template-Ausgaben den Gate `node scripts/run_xtend_tests.js rmt-compatibility --json` referenzieren. Seit `ER-WP-21` tragen neue Component-Dry-Runs das Performance-Profil `xtend.performance.component-profile.v1` in Source, Docs, Tests, Types und Manifest. Seit `ER-WP-23` tragen neue Component-Dry-Runs das A11y-Profil `xtend.a11y.profile.v1` in Source, Docs, Tests, Fixtures, Types und Manifest. Seit `WP-E10-07` gibt es zusaetzliche TypeScript-first Templates fuer `ts-source`, `ts-contract`, `ts-rmt`, `ts-a11y`, `ts-performance` und `ts-fixture`.
+
+Spaetere Templates muessen die Epic-02-Testpflicht und die in `xtend-builder/scaffold.config.js` definierten Pflichtartefakte respektieren.
+
+## Pflichtartefakt-Templates
+
+| Artefakt | Template |
+|----------|----------|
+| `component` | `xtend-builder/templates/component/source.template.js` |
+| `docs` | `xtend-builder/templates/component/docs.template.md` |
+| `tests` | `xtend-builder/templates/component/component-suite.template.js` |
+| `fixtures` | `xtend-builder/templates/component/fixture.template.html` |
+| `types` | `xtend-builder/templates/component/types.template.d.ts` |
+| `manifest` | `xtend-builder/templates/component/manifest-plan.template.json` |
+| `demo` | `xtend-builder/templates/component/demo-plan.template.md` |
+| `ts-source` | `xtend-builder/templates/component/source.template.ts` |
+| `ts-contract` | `xtend-builder/templates/component/contract.template.ts` |
+| `ts-rmt` | `xtend-builder/templates/component/rmt.template.ts` |
+| `ts-a11y` | `xtend-builder/templates/component/a11y.template.ts` |
+| `ts-performance` | `xtend-builder/templates/component/performance.template.ts` |
+| `ts-fixture` | `xtend-builder/templates/component/fixture-data.template.ts` |
+
+Der Template-Loader `xtend-builder/templates/loader.js` rendert Platzhalter wie `{{tag}}`, `{{name}}`, `{{className}}`, `{{profilesCsv}}`, `{{stateKeyPrefix}}`, `{{manifestSource}}`, `{{fixtureScriptPath}}`, `{{hydrationStateAttribute}}`, `{{featureStatePrefix}}`, `{{featureEventRows}}`, `{{featureReviewRules}}`, `{{typeContractSchema}}`, `{{typeRmtAdapter}}`, `{{typeRmtComponentContractVersion}}`, `{{typeRmtTemplateAuthoringContractVersion}}`, `{{typeRmtTemplateAdapter}}`, `{{typeRmtTemplateRef}}`, `{{typeRmtRootHandshakeContractVersion}}`, `{{typeRmtRootRef}}`, `{{typeRmtHostCapabilitiesContractVersion}}`, `{{typeRmtHostCapabilityNameUnion}}`, `{{rmtCompatibilitySchema}}`, `{{rmtCompatibilityContractRefsCsv}}`, `{{typeRmtRouterAdapter}}`, `{{previewContractSchema}}`, `{{previewTargetPath}}`, `{{extensionContractSchema}}`, `{{extensionSourceGetter}}`, `{{extensionScheduleHint}}`, `{{performanceProfileSchema}}`, `{{performancePolicySchema}}`, `{{performanceBudgetClass}}`, `{{performanceLane}}`, `{{performanceHydrationPolicy}}`, `{{performanceReviewRules}}`, `{{performanceProfileJson}}`, `{{a11yProfileSchema}}`, `{{a11yRole}}`, `{{a11yAccessibleNameDefault}}`, `{{a11yKeyboardRows}}`, `{{a11yAriaStateRows}}`, `{{a11yProfileJson}}`, `{{componentContractV2Json}}`, `{{rmtComponentMetadataJson}}`, `{{componentLifecycleTelemetrySchema}}`, `{{componentFabricLaneIngestionSchema}}`, `{{tsSourcePath}}` und `{{tsRuntimeArtifactPath}}`.

package/xtend-builder/templates/component/a11y.template.ts

@@ -0,0 +1,11 @@
+export const {{className}}A11yProfile = {{a11yProfileJson}} as const;
+
+export const {{className}}A11yScaffoldContract = {
+  componentContract: '{{a11yComponentContractSchema}}',
+  profile: '{{a11yProfileSchema}}',
+  screenreaderSignals: '{{a11yScreenreaderContractSchema}}',
+  motionContrast: '{{a11yMotionContrastContractSchema}}',
+  requiredFixtureAttributes: ['aria-label']
+} as const;
+
+export default {{className}}A11yProfile;

package/xtend-builder/templates/component/component-suite.template.d.ts

@@ -0,0 +1,2 @@
+export declare function printComponentReport(result?: unknown): void;
+export declare function runComponentSuite(options?: Record<string, unknown>): unknown;

package/xtend-builder/templates/component/component-suite.template.js

@@ -0,0 +1,108 @@
+const path = require('path');
+const {
+  createSuiteContext,
+  printSuiteReport
+} = require('../utils/assertions');
+const {
+  readJson,
+  readText,
+  resolveRootDir
+} = require('../utils/files');
+const {
+  syntaxCheckFile
+} = require('../utils/process');
+
+function run{{className}}ComponentSuite(options = {}) {
+  const rootDir = resolveRootDir(options.rootDir || path.resolve(__dirname, '..', '..'));
+  const context = createSuiteContext({
+    id: 'component:{{tag}}',
+    label: '{{tag}} component contract'
+  });
+
+  const source = readText('components/{{tag}}.js', rootDir);
+  const fixture = readText('tests/components/fixtures/{{tag}}.component.html', rootDir);
+  const docs = readText('docs/components/{{name}}.md', rootDir);
+  const manifest = readJson('components/manifest.json', rootDir);
+  const syntax = syntaxCheckFile('components/{{tag}}.js', { rootDir });
+
+  context.assert(syntax.ok, '{{tag}} source passes syntax check');
+  context.assert(source.includes("customElements.define('{{tag}}'") || source.includes('customElements.define("{{tag}}"'), '{{tag}} registers its Custom Element');
+  context.assert(source.includes('attachShadow') && (source.includes("mode: 'open'") || source.includes('mode: "open"')), '{{tag}} creates open shadow DOM');
+  context.assert(source.includes('observedAttributes'), '{{tag}} declares observed attributes');
+  context.assert(source.includes('variant'), '{{tag}} handles variant attribute');
+  context.assert(source.includes('hydrate()'), '{{tag}} exposes explicit hydration path');
+  context.assert(source.includes('disconnectedCallback'), '{{tag}} exposes disconnect cleanup path');
+  context.assert(source.includes('{{hydrationStateAttribute}}'), '{{tag}} marks hydrated instances');
+  context.assert(source.includes('xtendScaffoldWiring'), '{{tag}} exposes scaffold feature wiring metadata');
+  context.assert(source.includes('{{featureWiringSchema}}'), '{{tag}} exposes stable feature wiring schema');
+  context.assert(source.includes('{{featureStatePrefix}}'), '{{tag}} exposes canonical state prefix');
+  context.assert(source.includes('xtendScaffoldA11yProfile'), '{{tag}} exposes scaffold A11y profile metadata');
+  context.assert(source.includes('{{a11yProfileSchema}}'), '{{tag}} exposes stable A11y profile schema');
+  context.assert(source.includes('{{a11yTestContractSchema}}'), '{{tag}} exposes stable A11y test contract');
+  context.assert(source.includes('{{a11yScreenreaderContractSchema}}'), '{{tag}} exposes stable screenreader signal contract');
+  context.assert(source.includes('{{a11yMotionContrastContractSchema}}'), '{{tag}} exposes stable motion/contrast contract');
+  context.assert(source.includes('prefers-reduced-motion'), '{{tag}} respects reduced-motion users');
+  context.assert(source.includes('forced-colors'), '{{tag}} respects forced-colors users');
+  context.assert(source.includes('xtendScaffoldPerformanceProfile'), '{{tag}} exposes scaffold Performance profile metadata');
+  context.assert(source.includes('{{performanceProfileSchema}}'), '{{tag}} exposes stable Performance profile schema');
+  context.assert(source.includes('{{performancePolicySchema}}'), '{{tag}} exposes stable Performance policy schema');
+  context.assert(source.includes("aria-label") || source.includes('aria-label'), '{{tag}} supports accessible name attribute');
+  context.assert(source.includes('role="${role}"') || source.includes('role='), '{{tag}} renders explicit role semantics');
+  context.assert(!source.includes('xstate.on(') && !source.includes('xstate.off('), '{{tag}} avoids legacy xstate listener facades');
+  context.assert(!source.includes('window.show'), '{{tag}} avoids unnamespaced global helper APIs');
+  context.assert(source.includes('<slot'), '{{tag}} renders default slot content');
+  context.assert(fixture.includes('<{{tag}}'), '{{tag}} fixture contains component markup');
+  context.assert(fixture.includes('aria-label="{{a11yAccessibleNameDefault}}"'), '{{tag}} fixture sets accessible name');
+  context.assert(fixture.includes('../../components/{{tag}}.js') || fixture.includes('../../../components/{{tag}}.js'), '{{tag}} fixture uses repo-local component import');
+  context.assert(!fixture.includes('https://') && !fixture.includes('http://'), '{{tag}} fixture avoids external component imports');
+  context.assert(fixture.includes('window.{{fixtureResultName}}'), '{{tag}} fixture exposes hydration result object');
+  context.assert(fixture.includes('hydrated:'), '{{tag}} fixture reports hydration status');
+  context.assert(fixture.includes('a11yProfile:') && fixture.includes('accessibleName:'), '{{tag}} fixture reports A11y hydration result');
+  context.assert(fixture.includes('screenreaderSignals:') && fixture.includes('{{a11yScreenreaderContractSchema}}'), '{{tag}} fixture reports screenreader signal result');
+  context.assert(fixture.includes('motionContrastPolicy:') && fixture.includes('{{a11yMotionContrastContractSchema}}'), '{{tag}} fixture reports motion/contrast policy result');
+  context.assert(docs.includes('{{tag}}'), '{{tag}} docs contain component tag');
+  context.assert(docs.includes('variant'), '{{tag}} docs describe variant attribute');
+  context.assert(docs.includes('API- und Feature-Wiring'), '{{tag}} docs describe feature wiring');
+  context.assert(docs.includes('{{featureWiringSchema}}'), '{{tag}} docs include feature wiring schema');
+  context.assert(docs.includes('{{featureStatePrefix}}'), '{{tag}} docs include canonical state prefix');
+  context.assert(docs.includes('A11y-Profil'), '{{tag}} docs include A11y profile section');
+  context.assert(docs.includes('{{a11yProfileSchema}}'), '{{tag}} docs include A11y profile schema');
+  context.assert(docs.includes('{{a11yTestContractSchema}}'), '{{tag}} docs include A11y test contract');
+  context.assert(docs.includes('Screenreader-Signale'), '{{tag}} docs include screenreader signal section');
+  context.assert(docs.includes('{{a11yScreenreaderContractSchema}}'), '{{tag}} docs include screenreader signal contract');
+  context.assert(docs.includes('Motion-und-Contrast-Policy'), '{{tag}} docs include motion/contrast section');
+  context.assert(docs.includes('{{a11yMotionContrastContractSchema}}'), '{{tag}} docs include motion/contrast contract');
+  context.assert(docs.includes('node scripts/run_xtend_tests.js a11y-hydration'), '{{tag}} docs include A11y hydration gate');
+  context.assert(docs.includes('node scripts/run_xtend_tests.js screenreader-signals'), '{{tag}} docs include Screenreader signal gate');
+  context.assert(docs.includes('node scripts/run_xtend_tests.js motion-contrast'), '{{tag}} docs include Motion/Contrast gate');
+  context.assert(docs.includes('Performance-Profil'), '{{tag}} docs include Performance profile section');
+  context.assert(docs.includes('{{performancePolicySchema}}'), '{{tag}} docs include Performance policy schema');
+  context.assert(docs.includes('{{performanceAuthorGuide}}'), '{{tag}} docs link Performance author guide');
+  context.assert(docs.includes('node scripts/run_xtend_tests.js performance-regression'), '{{tag}} docs include Performance regression gate');
+  context.assert(Array.isArray(manifest) || typeof manifest === 'object', '{{tag}} manifest file is parseable');
+
+  return context.result({
+    component: '{{tag}}',
+    profiles: '{{profilesCsv}}'
+  });
+}
+
+function print{{className}}ComponentReport(result) {
+  printSuiteReport(result, {
+    successTitle: '{{tag}} Component Contract erfolgreich.',
+    failureTitle: '{{tag}} Component Contract fehlgeschlagen:'
+  });
+}
+
+if (require.main === module) {
+  const result = run{{className}}ComponentSuite();
+  print{{className}}ComponentReport(result);
+  if (!result.ok) {
+    process.exit(1);
+  }
+}
+
+module.exports = {
+  print{{className}}ComponentReport,
+  run{{className}}ComponentSuite
+};

package/xtend-builder/templates/component/contract.template.ts

@@ -0,0 +1,10 @@
+export const {{className}}ComponentContract = {{componentContractV2Json}} as const;
+
+export const {{className}}ComponentContractValidation = {
+  schema: '{{componentContractV2ReportSchema}}',
+  ok: {{componentContractV2Valid}},
+  sourceStrategy: '{{tsSourceStrategySchema}}',
+  localGate: 'node scripts/run_xtend_tests.js builder-typescript-blueprint --json'
+} as const;
+
+export default {{className}}ComponentContract;

package/xtend-builder/templates/component/demo-plan.template.md

@@ -0,0 +1,73 @@
+# {{tag}} Preview Reference Plan
+
+- Status: scaffolded preview candidate
+- Schema: `{{previewContractSchema}}`
+- Preview path: `{{previewTargetPath}}`
+- Registry: `{{previewRegistryPath}}`
+- Component: `components/{{tag}}.js`
+- Docs: `docs/components/{{name}}.md`
+- Fixture: `{{previewFixtureDocument}}`
+- Types: `components/{{tag}}.d.ts`
+- Manifest source: `{{manifestSource}}`
+- External network allowed: `{{previewExternalNetworkAllowed}}`
+
+## Purpose
+
+This preview plan makes the scaffolded component visible to the documentation and demo reference gate before productive file writes are introduced.
+
+## Reference Registry Entry
+
+| Path | Status | Purpose |
+|------|--------|---------|
+| `{{previewTargetPath}}` | {{previewRegistryStatus}} | {{previewRegistryPurpose}} |
+
+## Local Assets
+
+| Asset | Path |
+|-------|------|
+| component | `components/{{tag}}.js` |
+| docs | `docs/components/{{name}}.md` |
+| fixture | `{{previewFixtureDocument}}` |
+| types | `components/{{tag}}.d.ts` |
+| manifest | `components/manifest.json` |
+
+## Feature Signals
+
+| Signal | Contract |
+|--------|----------|
+{{previewSignalRows}}
+
+## XTendRMT Attachment
+
+- Component adapter: `{{typeRmtAdapter}}`
+- Router adapter: `{{typeRmtRouterAdapter}}`
+- Kernel boundary: {{typeRmtKernelBoundary}}
+
+## RMT Compatibility Binding
+
+- Schema: `{{rmtCompatibilitySchema}}`
+- Contract refs: `{{rmtCompatibilityContractRefsCsv}}`
+- Dry-run surfaces: `{{rmtCompatibilityDryRunSurfacesCsv}}`
+- Minimum gate: `{{rmtCompatibilityMinimumGate}}`
+- Boundary: {{rmtCompatibilityBoundary}}
+
+## Extension Points
+
+- Schema: `{{extensionContractSchema}}`
+- Root lifecycle schema: `{{extensionRootLifecycleSchema}}`
+- Template adapter: `{{extensionTemplateAdapter}}`
+- Rendering mode: `{{extensionRenderingMode}}`
+- Schedule hint: `{{extensionScheduleHint}}`
+
+## Local Verification
+
+```bash
+node scripts/run_xtend_tests.js rmt-compatibility --json
+node scripts/run_xtend_tests.js references --json
+node scripts/run_xtend_tests.js components a11y-hydration
+npm test
+```
+
+## Boundary
+
+This is a dry-run preview reference plan. It does not write files, does not patch the reference registry, does not start browser automation and does not implement XTendRMT bridge runtime.

package/xtend-builder/templates/component/docs.template.md

@@ -0,0 +1,301 @@
+# {{tag}}
+
+- Status: scaffolded draft
+- Profile: {{profilesCsv}}
+- Source: `components/{{tag}}.js`
+- Fixture: `tests/components/fixtures/{{tag}}.component.html`
+- Types: `components/{{tag}}.d.ts`
+
+## Zweck
+
+`{{tag}}` ist eine scaffolded XTend-Komponente nach dem Component-Level-Teststandard.
+
+## Attribute
+
+| Attribut | Typ | Default | Beschreibung |
+|----------|-----|---------|--------------|
+| `variant` | string | `default` | Steuert die visuelle Variante des Root-Elements. |
+
+## Slots
+
+| Slot | Beschreibung |
+|------|--------------|
+| default | sichtbarer Inhalt der Komponente |
+
+## Events
+
+Die Scaffold-Ausgabe bereitet profilbasierte Events vor. Die Basiskomponente emittiert sie erst, wenn die jeweilige Feature-Implementierung ergaenzt wird.
+
+| Event | Contract |
+|-------|----------|
+{{featureEventRows}}
+
+## State
+
+Kanonischer State-Prefix: `{{featureStatePrefix}}`
+
+Der Basistemplate schreibt keinen State. Feature-Implementierungen muessen die folgenden Keys als SSOT-Ziele nutzen und duerfen lokale UI-Felder nur als abgeleitete Render-Caches fuehren.
+
+| Key | Contract |
+|-----|----------|
+{{featureStateRows}}
+
+## API- und Feature-Wiring
+
+Schema: `{{featureWiringSchema}}`
+
+| Namespace | Contract |
+|-----------|----------|
+{{featureApiRows}}
+
+Review-Regeln:
+
+{{featureReviewRules}}
+
+Verbotene State-Fassaden: `{{featureStateForbiddenCsv}}`
+
+Verbotene globale Helper: `{{featureForbiddenGlobalsCsv}}`
+
+## Typisierung und RMT-Anschluss
+
+Typing-Schema: `{{typeContractSchema}}`
+
+Runtime-Grenze: `{{typeRuntimeBoundary}}`
+
+| Attribut | Typ | Contract |
+|----------|-----|----------|
+{{typeAttributeRows}}
+
+| Property | Typ | Contract |
+|----------|-----|----------|
+{{typePropertyRows}}
+
+Review-Regeln fuer Typ-Artefakte:
+
+{{typeReviewRules}}
+
+Typ-Ausnahmeprozess: `{{typeExceptionPolicy}}`
+
+## A11y-Profil
+
+Profil-Schema: `{{a11yProfileSchema}}`
+
+Komponenten-Contract: `{{a11yComponentContractSchema}}`
+
+Test-Contract: `{{a11yTestContractSchema}}`
+
+Das Scaffold erzeugt fuer jede neue Komponente ein A11y-Profil. Dieses Profil ist keine optionale Checkliste, sondern ein Bestandteil des Component Contracts und muss in Reviews, Fixtures und Tests sichtbar bleiben.
+
+- Primaeres Profil: `{{a11yPrimaryProfile}}`
+- Rolle/Semantik: `{{a11yRole}}`
+- Zugaenglicher Name: `{{a11yAccessibleNameSource}}`, erforderlich: `{{a11yAccessibleNameRequired}}`
+- Default-Name: `{{a11yAccessibleNameDefault}}`
+- Fokusstrategie: `{{a11yFocusMode}}`, Initialfokus: `{{a11yFocusInitial}}`, Trap: `{{a11yFocusTrap}}`, Restore: `{{a11yFocusRestore}}`
+- Screenreader: Live Region `{{a11yScreenreaderLiveRegion}}`, Signale `{{a11yScreenreaderSignalsCsv}}`
+- Screenreader-Contract: `{{a11yScreenreaderContractSchema}}`
+- Reduced Motion: `{{a11yMotionReducedMotion}}`
+- Kontrast/Fokus: `{{a11yContrastFocusVisible}}`, Nicht-Farbstatus: `{{a11yContrastNonColorStatus}}`
+- Motion/Contrast-Contract: `{{a11yMotionContrastContractSchema}}`
+- Pflicht-Gates: `{{a11yTestRefsCsv}}`
+- Fixture-Pflichtattribute: `{{a11yRequiredFixtureAttributesCsv}}`
+
+Keyboard Contract:
+
+| Taste | Pflicht |
+|-------|---------|
+{{a11yKeyboardRows}}
+
+ARIA-State-Liste:
+
+| State | Pflicht |
+|-------|---------|
+{{a11yAriaStateRows}}
+
+Review-Regeln fuer A11y:
+
+{{a11yReviewRules}}
+
+## Screenreader-Signale
+
+Contract: `{{a11yScreenreaderContractSchema}}`
+
+Signal-Record-Contract: `{{a11yScreenreaderSignalRecordSchema}}`
+
+| Signal | Live Region | Art |
+|--------|-------------|-----|
+{{a11yScreenreaderSignalRows}}
+
+- Statusregionen: `{{a11yScreenreaderStatusRegionsCsv}}`
+- Errorregionen: `{{a11yScreenreaderErrorRegionsCsv}}`
+- Fabric-Lane: `{{a11yScreenreaderFabricLane}}`
+- Fabric-Fiber: `{{a11yScreenreaderFabricFiberKind}}`
+- Schedule: `{{a11yScreenreaderFabricScheduleRef}}`
+
+## Motion-und-Contrast-Policy
+
+Contract: `{{a11yMotionContrastContractSchema}}`
+
+Motion-Contract: `{{a11yMotionContractSchema}}`
+
+Contrast-Contract: `{{a11yContrastContractSchema}}`
+
+- Reduced-Motion Media Query: `{{a11yMotionMediaQuery}}`
+- Motion Policy: `{{a11yMotionAnimationPolicy}}`
+- Motion CSS-Pflichten: `{{a11yMotionRequiredCssCsv}}`
+- High-Contrast Media Query: `{{a11yContrastMediaQuery}}`
+- Contrast Policy: `{{a11yContrastPolicy}}`
+- Forced Color Adjust: `{{a11yContrastForcedColorAdjust}}`
+- Contrast CSS-Pflichten: `{{a11yContrastRequiredCssCsv}}`
+- Fabric-Lane: `{{a11yMotionContrastFabricLane}}`
+- Fabric-Fiber: `{{a11yMotionContrastFabricFiberKind}}`
+- Schedule: `{{a11yMotionContrastFabricScheduleRef}}`
+
+## Performance-Profil
+
+Profil-Schema: `{{performanceProfileSchema}}`
+
+Performance Policy: `{{performancePolicySchema}}`
+
+Budget-Matrix: `{{performanceBudgetMatrixSchema}}` in `{{performanceBudgetMatrixPath}}`
+
+Measurement Contract: `{{performanceMeasurementContract}}`
+
+Regression Gate: `{{performanceRegressionGate}}`
+
+Hydration Policy Contract: `{{performanceHydrationPolicyContract}}`
+
+Das Scaffold erzeugt fuer jede neue Komponente ein Performance-Profil. Dieses Profil ist Teil des Component Contracts und nutzt dieselbe Policy wie die offizielle Autorendokumentation unter `{{performanceAuthorGuide}}`.
+
+- Primaeres Performance-Profil: `{{performancePrimaryProfile}}`
+- Budgetklasse: `{{performanceBudgetClass}}`
+- Fabric-Lane: `{{performanceLane}}`
+- Hydration Policy: `{{performanceHydrationPolicy}}`
+- Idle/Background erlaubt: `{{performanceIdleOrBackgroundAllowed}}`
+- Eigene A11y-Fiber erwartet: `{{performanceRequiresA11yFiber}}`
+- Pflicht-Gates: `{{performanceRequiredGatesCsv}}`
+
+Kritische Messpunkte:
+
+| Messpunkt | Pflicht |
+|-----------|---------|
+{{performanceCriticalMeasurementsRows}}
+
+## Performance-Regeln
+
+{{performanceReviewRules}}
+
+Der vorbereitete RMT-Anschluss bleibt adapterbasiert:
+
+- Component-Adapter: `{{typeRmtAdapter}}`
+- Component-Contract: `{{typeRmtComponentContractVersion}}`
+- Router-Adapter: `{{typeRmtRouterAdapter}}`
+- RMT-Domains: `{{typeRmtDomainsCsv}}`
+- Manifest Lookup: XTend Host Adapter, nicht RMT Kernel
+- Hydration: Custom Element Lifecycle mit `{{hydrationStateAttribute}}`
+- Kernel-Grenze: {{typeRmtKernelBoundary}}
+
+## RMT Template Authoring
+
+Template-Authoring nutzt RMT als XTend-Templating-DSL und fuehrt keine zweite XTend-Syntax ein.
+
+- Template-Contract: `{{typeRmtTemplateAuthoringContractVersion}}`
+- Template-Adapter: `{{typeRmtTemplateAdapter}}`
+- Template-Ref: `{{typeRmtTemplateRef}}`
+- Component-Ref: `{{typeRmtTemplateComponentRef}}`
+- Erlaubte Modi: `{{typeRmtTemplateAllowedModesUnion}}`
+- Kernel-Grenze: {{typeRmtTemplateKernelBoundary}}
+
+Slots, Props, Attributes und Events bleiben RMT Records. Der XTend Host Adapter materialisiert daraus Custom Elements, Slot-Projektion und Event-Command-Bindings.
+
+## Extension-Punkte
+
+Extension-Schema: `{{extensionContractSchema}}`
+
+Status: `{{extensionStatus}}`
+
+Root-Lifecycle:
+
+| Hook | Phase | Default |
+|------|-------|---------|
+{{extensionHookRows}}
+
+Template-Anschluss:
+
+- Adapter: `{{extensionTemplateAdapter}}`
+- Template-Ref: `{{extensionTemplateRef}}`
+- Grenze: `{{extensionTemplateBoundary}}`
+
+Rendering-Anschluss:
+
+- Modus: `{{extensionRenderingMode}}`
+- Ziel: `{{extensionRenderTarget}}`
+- Schedule-Hint: `{{extensionScheduleHint}}`
+
+Root-Lifecycle- und Scheduler-Handschlag:
+
+- Contract: `{{typeRmtRootHandshakeContractVersion}}`
+- Root-Ref: `{{typeRmtRootRef}}`
+- Phasen: `{{typeRmtRootPhasesUnion}}`
+- Kernel-Grenze: {{typeRmtRootKernelBoundary}}
+
+## XTend Host Capabilities
+
+Host-Capabilities beschreiben, welche XTend-Faehigkeiten ein RMT-Dokument ueber Adapterdaten nutzen darf. Der RMT Kernel darf daraus keine XTend-Imports oder direkte `window.XTend` Aufrufe ableiten.
+
+- Contract: `{{typeRmtHostCapabilitiesContractVersion}}`
+- Erforderlich: `{{typeRmtHostRequiredCapabilitiesCsv}}`
+- Optional: `{{typeRmtHostOptionalCapabilitiesCsv}}`
+- Manifest: `{{typeRmtHostManifestSource}}`
+- State-Bridge: `{{typeRmtHostStateBridge}}`
+- API-Root: `{{typeRmtHostApiNamespaceRoot}}`
+- Kernel-Grenze: {{typeRmtHostKernelBoundary}}
+
+## RMT-Kompatibilitaets-Binding
+
+Das Binding verbindet Typing, Manifest-Plan, Preview-Plan und Extension-Punkte zu einem reviewbaren RMT-Kompatibilitaetscontract. Es erzeugt keine Bridge-Runtime und fuehrt keine RMT Scheduler Jobs aus.
+
+- Schema: `{{rmtCompatibilitySchema}}`
+- Contract-Refs: `{{rmtCompatibilityContractRefsCsv}}`
+- Artefakte: `{{rmtCompatibilityArtifactsCsv}}`
+- Dry-Run-Oberflaechen: `{{rmtCompatibilityDryRunSurfacesCsv}}`
+- Mindestgate: `{{rmtCompatibilityMinimumGate}}`
+- Vollgate: `{{rmtCompatibilityFullGate}}`
+- Grenze: {{rmtCompatibilityBoundary}}
+
+Review-Regeln fuer Extension-Punkte:
+
+{{extensionReviewRules}}
+
+## Accessibility und Hydration
+
+- Die Komponente rendert repo-lokal ohne CDN-Abhaengigkeit.
+- `xtendScaffoldA11yProfile` macht `{{a11yProfileSchema}}` im Component Source statisch pruefbar.
+- Die Fixture setzt `{{a11yAccessibleNameSource}}` und meldet Rolle, zugaenglichen Namen und A11y-Profil im Hydration-Ergebnis.
+- Die Fixture meldet den Screenreader-Signal-Contract `{{a11yScreenreaderContractSchema}}` und dessen Status-/Errorregionen.
+- Die Komponente deklariert `{{a11yMotionContrastContractSchema}}` fuer `prefers-reduced-motion`, `forced-colors`, Fokus und Nicht-Farbstatus.
+- `connectedCallback`, `attributeChangedCallback` und `disconnectedCallback` bilden den Hydration-Mindestcontract.
+- `hydrate()` ist der explizite Rehydration-Pfad und markiert Instanzen mit `{{hydrationStateAttribute}}`.
+- Die Fixture legt ein Ergebnisobjekt fuer Hydration-Smokes offen und dokumentiert den lokalen Scriptpfad `{{fixtureScriptPath}}`.
+
+## Manifest-Wiring
+
+- Patch-Plan: `{{manifestPatchSchema}}`
+- Quelle: `{{manifestSource}}`
+- Importmodus: `{{manifestImportMode}}`
+- Hydration: `{{manifestHydrationMode}}`
+- CDN erlaubt: `{{manifestCdnAllowed}}`
+- Feature-Wiring: `{{featureWiringSchema}}`
+
+## Lokale Verifikation
+
+```bash
+node scripts/run_xtend_tests.js components
+node scripts/run_xtend_tests.js a11y-hydration
+node scripts/run_xtend_tests.js screenreader-signals
+node scripts/run_xtend_tests.js motion-contrast
+node scripts/run_xtend_tests.js fabric-performance-measurements
+node scripts/run_xtend_tests.js performance-regression
+node scripts/run_xtend_tests.js hydration-policy
+node scripts/run_xtend_tests.js references
+node scripts/run_xtend_tests.js rmt-compatibility
+```

package/xtend-builder/templates/component/fixture-data.template.ts

@@ -0,0 +1,28 @@
+export const {{className}}FixtureData = {
+  schema: 'xtend.scaffold.typescript-component-fixture.v1',
+  tag: '{{tag}}',
+  className: '{{className}}',
+  attributes: {
+    'aria-label': '{{className}} component',
+    variant: 'default'
+  },
+  slots: {
+    default: '{{className}} fixture content'
+  },
+  rmt: {{rmtComponentMetadataJson}},
+  expectedTelemetry: {
+    schema: '{{componentLifecycleTelemetrySchema}}',
+    operations: [{{componentTelemetryOperationsJson}}],
+    lane: '{{performanceLane}}'
+  },
+  expectedA11y: {
+    role: '{{a11yRole}}',
+    accessibleName: '{{a11yAccessibleNameDefault}}'
+  },
+  expectedPerformance: {
+    budgetClass: '{{performanceBudgetClass}}',
+    hydrationPolicy: '{{performanceHydrationPolicy}}'
+  }
+} as const;
+
+export default {{className}}FixtureData;

package/xtend-builder/templates/component/fixture.template.html

@@ -0,0 +1,37 @@
+<!doctype html>
+<html lang="en">
+  <head>
+    <meta charset="utf-8">
+    <title>{{tag}} component fixture</title>
+    <script src="{{fixtureScriptPath}}"></script>
+  </head>
+  <body>
+    <{{tag}} id="{{name}}-fixture" variant="default" aria-label="{{a11yAccessibleNameDefault}}">Fixture content for {{tag}}</{{tag}}>
+    <script>
+      customElements.whenDefined('{{tag}}').then(function () {
+        var element = document.getElementById('{{name}}-fixture');
+        var root = element && element.shadowRoot ? element.shadowRoot.querySelector('[part="root"]') : null;
+	        window.{{fixtureResultName}} = {
+	          defined: customElements.get('{{tag}}') !== undefined,
+	          hasElement: Boolean(element),
+	          hasShadowRoot: Boolean(element && element.shadowRoot),
+	          hydrated: Boolean(element && element.hasAttribute('{{hydrationStateAttribute}}')),
+	          a11yProfile: customElements.get('{{tag}}').xtendScaffoldA11yProfile.schema,
+	          screenreaderSignals: customElements.get('{{tag}}').xtendScaffoldA11yProfile.screenreader.signalContract.schema,
+	          screenreaderSignalCount: customElements.get('{{tag}}').xtendScaffoldA11yProfile.screenreader.signalContract.signals.length,
+	          screenreaderStatusRegions: customElements.get('{{tag}}').xtendScaffoldA11yProfile.screenreader.signalContract.statusRegions.length,
+	          screenreaderErrorRegions: customElements.get('{{tag}}').xtendScaffoldA11yProfile.screenreader.signalContract.errorRegions.length,
+	          motionContrastPolicy: customElements.get('{{tag}}').xtendScaffoldA11yProfile.motionContrast.policy.schema,
+	          motionMediaQuery: customElements.get('{{tag}}').xtendScaffoldA11yProfile.motionContrast.policy.motion.mediaQuery,
+	          contrastMediaQuery: customElements.get('{{tag}}').xtendScaffoldA11yProfile.motionContrast.policy.contrast.mediaQuery,
+	          role: root ? root.getAttribute('role') : null,
+	          accessibleName: root ? root.getAttribute('aria-label') : null,
+          localImport: true,
+          cdnFree: true,
+          scriptPath: '{{fixtureScriptPath}}',
+          text: element ? element.textContent.trim() : ''
+        };
+      });
+    </script>
+  </body>
+</html>

package/xtend-builder/templates/component/manifest-plan.template.json

@@ -0,0 +1,22 @@
+{
+  "schema": "{{manifestPatchSchema}}",
+  "operation": "{{manifestOperation}}",
+  "tag": "{{tag}}",
+  "source": "{{manifestSource}}",
+  "profiles": [{{profilesJson}}],
+  "importMode": "{{manifestImportMode}}",
+  "loaderMode": "{{manifestLoaderMode}}",
+  "hydrationMode": "{{manifestHydrationMode}}",
+  "localImportOnly": {{manifestLocalImportOnly}},
+  "cdnAllowed": {{manifestCdnAllowed}},
+  "featureWiring": {{featureManifestJson}},
+  "a11yProfile": {{a11yManifestJson}},
+  "screenreaderSignals": {{a11yScreenreaderManifestJson}},
+  "motionContrastPolicy": {{a11yMotionContrastManifestJson}},
+  "performanceProfile": {{performanceManifestJson}},
+  "typing": {{typeManifestJson}},
+  "preview": {{previewManifestJson}},
+  "rmtCompatibility": {{rmtCompatibilityManifestJson}},
+  "{{extensionManifestKey}}": {{extensionManifestJson}},
+  "requiresReview": true
+}

package/xtend-builder/templates/component/performance.template.ts

@@ -0,0 +1,13 @@
+export const {{className}}PerformanceProfile = {{performanceProfileJson}} as const;
+
+export const {{className}}PerformanceScaffoldContract = {
+  componentProfile: '{{performanceProfileSchema}}',
+  policy: '{{performancePolicySchema}}',
+  budgetMatrix: '{{performanceBudgetMatrixSchema}}',
+  measurement: '{{performanceMeasurementContract}}',
+  regressionGate: '{{performanceRegressionGate}}',
+  hydrationPolicy: '{{performanceHydrationPolicyContract}}',
+  lane: '{{performanceLane}}'
+} as const;
+
+export default {{className}}PerformanceProfile;