@ccslabs/xtend 0.1.0-rc.1

package/xtend-builder/templates/loader.js

@@ -0,0 +1,51 @@
+const fs = require('fs');
+const path = require('path');
+const {
+  getTemplateForArtifact
+} = require('./registry');
+
+const rootDir = path.resolve(__dirname, '..', '..');
+
+function getTemplateAbsolutePath(template) {
+  return path.join(rootDir, template.path);
+}
+
+function renderTemplateString(template, values) {
+  return String(template).replace(/\{\{([a-zA-Z0-9_]+)\}\}/g, (match, key) => {
+    if (Object.prototype.hasOwnProperty.call(values, key)) {
+      return String(values[key]);
+    }
+
+    return match;
+  });
+}
+
+function renderTemplateForArtifact(artifact, values) {
+  const template = getTemplateForArtifact(artifact);
+  if (!template) {
+    return {
+      ok: false,
+      error: `No template registered for artifact "${artifact}".`
+    };
+  }
+
+  const absolutePath = getTemplateAbsolutePath(template);
+  if (!fs.existsSync(absolutePath)) {
+    return {
+      ok: false,
+      error: `Template file missing: ${template.path}`,
+      template
+    };
+  }
+
+  return {
+    ok: true,
+    template,
+    content: renderTemplateString(fs.readFileSync(absolutePath, 'utf8'), values)
+  };
+}
+
+module.exports = {
+  renderTemplateForArtifact,
+  renderTemplateString
+};

package/xtend-builder/templates/registry.d.ts

@@ -0,0 +1,6 @@
+import type { XtendBuilderTemplateDefinition, XtendBuilderTemplateRegistry } from '../builder-public-types';
+
+export declare const TEMPLATE_REGISTRY: XtendBuilderTemplateDefinition[];
+export declare const TEMPLATE_REGISTRY_SCHEMA: string;
+export declare function getTemplateForArtifact(artifactId: string): XtendBuilderTemplateDefinition | null;
+export declare function getTemplateRegistry(): XtendBuilderTemplateRegistry;

package/xtend-builder/templates/registry.js

@@ -0,0 +1,119 @@
+const TEMPLATE_REGISTRY_SCHEMA = 'xtend.scaffold.template-registry.v1';
+
+const TEMPLATE_REGISTRY = [
+  {
+    id: 'component.source',
+    artifact: 'component',
+    path: 'xtend-builder/templates/component/source.template.js',
+    status: 'implemented-WP-E03-07',
+    purpose: 'Productive component source template for scaffold previews.'
+  },
+  {
+    id: 'component.docs',
+    artifact: 'docs',
+    path: 'xtend-builder/templates/component/docs.template.md',
+    status: 'implemented-WP-E03-07',
+    purpose: 'Public component documentation template.'
+  },
+  {
+    id: 'component.tests',
+    artifact: 'tests',
+    path: 'xtend-builder/templates/component/component-suite.template.js',
+    status: 'implemented-WP-E03-07',
+    purpose: 'Component-level test suite template with real assertions.'
+  },
+  {
+    id: 'component.fixture',
+    artifact: 'fixtures',
+    path: 'xtend-builder/templates/component/fixture.template.html',
+    status: 'implemented-WP-E03-07',
+    purpose: 'Repo-local component fixture template.'
+  },
+  {
+    id: 'component.types',
+    artifact: 'types',
+    path: 'xtend-builder/templates/component/types.template.d.ts',
+    status: 'implemented-WP-E03-09',
+    purpose: 'TypeScript public API and XTendRMT adapter attachment template.'
+  },
+  {
+    id: 'component.manifest-plan',
+    artifact: 'manifest',
+    path: 'xtend-builder/templates/component/manifest-plan.template.json',
+    status: 'implemented-WP-E03-07',
+    purpose: 'Manifest patch-plan template.'
+  },
+  {
+    id: 'component.demo-plan',
+    artifact: 'demo',
+    path: 'xtend-builder/templates/component/demo-plan.template.md',
+    status: 'implemented-WP-E03-10',
+    purpose: 'Preview reference-plan template for local reference-gate registration.'
+  },
+  {
+    id: 'component.ts-source',
+    artifact: 'ts-source',
+    path: 'xtend-builder/templates/component/source.template.ts',
+    status: 'implemented-WP-E10-07',
+    purpose: 'TypeScript-first component source template with RMT, Fabric, A11y and Performance metadata.'
+  },
+  {
+    id: 'component.ts-contract',
+    artifact: 'ts-contract',
+    path: 'xtend-builder/templates/component/contract.template.ts',
+    status: 'implemented-WP-E10-07',
+    purpose: 'Component Contract v2 source template.'
+  },
+  {
+    id: 'component.ts-rmt',
+    artifact: 'ts-rmt',
+    path: 'xtend-builder/templates/component/rmt.template.ts',
+    status: 'implemented-WP-E10-07',
+    purpose: 'RMT component metadata template for xtend.component adapter authoring.'
+  },
+  {
+    id: 'component.ts-a11y',
+    artifact: 'ts-a11y',
+    path: 'xtend-builder/templates/component/a11y.template.ts',
+    status: 'implemented-WP-E10-07',
+    purpose: 'Typed A11y profile template for new TypeScript components.'
+  },
+  {
+    id: 'component.ts-performance',
+    artifact: 'ts-performance',
+    path: 'xtend-builder/templates/component/performance.template.ts',
+    status: 'implemented-WP-E10-07',
+    purpose: 'Typed Performance profile template for new TypeScript components.'
+  },
+  {
+    id: 'component.ts-fixture',
+    artifact: 'ts-fixture',
+    path: 'xtend-builder/templates/component/fixture-data.template.ts',
+    status: 'implemented-WP-E10-07',
+    purpose: 'Typed fixture-data template for Component Lab, tests and RMT previews.'
+  }
+];
+
+function clone(value) {
+  return JSON.parse(JSON.stringify(value));
+}
+
+function getTemplateRegistry() {
+  return {
+    schema: TEMPLATE_REGISTRY_SCHEMA,
+    root: 'xtend-builder/templates/',
+    templates: clone(TEMPLATE_REGISTRY)
+  };
+}
+
+function getTemplateForArtifact(artifact) {
+  const template = TEMPLATE_REGISTRY.find((entry) => entry.artifact === artifact);
+  return template ? clone(template) : null;
+}
+
+module.exports = {
+  TEMPLATE_REGISTRY,
+  TEMPLATE_REGISTRY_SCHEMA,
+  getTemplateForArtifact,
+  getTemplateRegistry
+};

package/xtend-builder/typing/README.md

@@ -0,0 +1,130 @@
+# XTend-Scaffold Typing
+
+Dieser Bereich enthaelt ab `WP-E03-09` den Typisierungs-Contract fuer scaffolded Komponenten.
+
+`xtend-builder/typing/component-types.js` stellt das Schema `xtend.scaffold.component-typing.v1` bereit. Das Modul erzeugt keine Runtime und schreibt keine Dateien. Es leitet aus Component-Plan und Feature-Wiring einen reviewbaren Contract fuer `.d.ts`-Artefakte ab.
+
+```bash
+node xtend-builder/scaffold.js typing --tag x-example --profile display --feature state --json
+```
+
+## Contract
+
+Der Typing-Contract umfasst:
+
+- Zielpfad `components/<tag>.d.ts`
+- Event-Name-Union und Event-Detail-Interface
+- Attribute-Map fuer oeffentliche Attribute
+- Property-Map fuer spaetere explizite Properties
+- HTMLElementTagNameMap-Erweiterung
+- ab Epic 10 / `WP-E10-03` den Component Contract v2 `xtend.component.contract.v2` fuer TypeScript Source, Public API, RMT, Fabric, Telemetry, Lanes, A11y, Performance, Tests, Docs und Maturity
+- Scaffold-Wiring-Interface fuer State-, Event- und API-Signale
+- vorbereitete XTendRMT-Anschluss-Typen fuer `xtend.component` und `xtend.xrouter`
+- ab Epic 04 / `WP-E04-03` den Component Contract `xtend.rmt.component-contract.v1` mit Manifest Lookup, Attributes, Hydration, Diagnostics und Kernel-Grenzen
+- ab Epic 04 / `WP-E04-04` den Template Authoring Contract `xtend.rmt.template-authoring.v1` mit Template-Refs, Component-Refs, Slots, Events, Hydration und Adapter-Grenzen
+- ab Epic 04 / `WP-E04-05` den Root Handshake Contract `xtend.rmt.root-handshake.v1` mit Root-Refs, Lifecycle-Phasen, Scheduler-Endpoint-Hints und Digital-Twin-State-Policy
+- ab Epic 04 / `WP-E04-06` den Host Capability Contract `xtend.rmt.host-capabilities.v1` fuer Manifest, Custom Elements, `xstate`, Hydration, Scheduler-Endpoints, Theme, API, Router und Diagnostics
+- ab Epic 04 / `WP-E04-07` das RMT Compatibility Binding `xtend.scaffold.rmt-compatibility-binding.v1`, das Typing, Manifest-Plan, Preview-Plan und Extension-Punkte zusammenfuehrt
+- ab Epic 04 / `WP-E04-08` den dedizierten Gate `node scripts/run_xtend_tests.js rmt-compatibility --json`
+
+## XTendRMT-Grenze
+
+Der RMT-Anschluss ist ein Typ- und Adapter-Contract. Er implementiert keine Bridge, erweitert keinen RMT-Kernel und schreibt keine `.rmt` Dateien. Ab `WP-E04-03` beschreibt er explizit, welche Felder der neutrale RMT Component Record besitzt und welche Arbeit beim XTend Host Adapter bleibt. Ab `WP-E04-04` beschreibt er zusaetzlich, wie RMT Templates XTend-Komponenten ueber `xtend.template`, `componentRef`, `slots` und `events` authoren koennen. Ab `WP-E04-05` beschreibt er, wie der RMT Scheduler Root-Phasen plant, ohne Custom-Element-Lifecycle, `xstate` oder Host Cleanup selbst auszufuehren. Ab `WP-E04-06` beschreibt er, welche XTend Host Capabilities als Adapterdaten verhandelbar sind. Ab `WP-E04-07` bindet er diese Vertrage in einen gemeinsamen Dry-Run-Contract fuer Typing, Manifest, Preview und Extensions. Ab `WP-E04-08` prueft `rmt-compatibility` diesen Contract als eigenen Runner-Gate. Die produktive Bridge bleibt Epic 05 vorbehalten.
+
+## Component Contract v2
+
+`component-contract-v2.js` stellt ab `WP-E10-03` den Contract `xtend.component.contract.v2` bereit. Das Modul erzeugt einen reviewbaren Contract fuer neue TypeScript-first Komponenten und bietet einen Validator fuer Pflichtdomains, ESM-Runtime, RMT-Kernel-Boundary und Public-API-Form.
+
+```bash
+node scripts/run_xtend_tests.js component-contract-v2 --json
+```
+
+Der Contract ist generator-only. Er fuehrt keine Runtime-Imports, keine XTendRMT-Kernel-Imports und keine produktiven Writes aus.
+
+## Component Network Contract
+
+`component-network-contract.js` stellt ab `WP-E11-06` den Contract `xtend.component.network.v1` bereit. Das Modul modelliert Events, Commands, Contexts, Forms, Validation, Feedback, Overlays, Routing, Theme, State, RMT Authoring und Fabric Diagnostics fuer vernetzbare Enterprise-Komponenten.
+
+```bash
+node scripts/run_xtend_tests.js component-network-contract --json
+```
+
+Der Contract ist generator-only. Er beschreibt Adapterdaten fuer RMT ueber `xtend.rmt.component-network-authoring.v1`, importiert aber keine XTend-Typen in den RMT Kernel.
+
+## RMT Shell Authoring Contract
+
+`rmt-shell-authoring-contract.js` stellt ab `WP-E11-07` den Contract `xtend.rmt.shell-authoring.v1` bereit. Das Modul fuehrt Shell, Styling, Runtime-A11y, UX-Performance und Component Network in ein RMT-first Authoring-Modell fuer sichtbare Component UX zusammen.
+
+```bash
+node scripts/run_xtend_tests.js rmt-shell-authoring-ux --json
+```
+
+Der Contract ist generator-only. RMT deklariert `shell`, `style`, `a11y`, `commands`, `events`, `variants`, `density`, `hydration`, `schedule` und `fabric`; XTend-Komponentenausfuehrung, XRouter, Fabric und DOM-Materialisierung bleiben Host-Adapterarbeit.
+
+## RMT DSL Authoring Polish
+
+`rmt-dsl-authoring-polish.js` stellt ab `WP-E12-13` den Contract `xtend.rmt.dsl-authoring-polish.v1` bereit. Das Modul beschreibt Alias-Sugar, Diagnostik, Token Bridge und XRouter-/XLink-Routing-Sugar fuer Component Shells, damit XTendRMT upstream die DSL benutzerfreundlicher machen kann.
+
+```bash
+node scripts/run_xtend_tests.js rmt-dsl-authoring-polish --json
+```
+
+Der Contract ist generator-only und upstream-orientiert. Er normalisiert keine produktiven `.rmt` Dateien selbst und haelt `no-rmt-kernel-import-of-xtend-types` als harte Grenze sichtbar.
+
+## Form Controls UX Contract
+
+`form-controls-ux-contract.js` stellt ab `WP-E11-08` den Contract `xtend.component.form-controls-ux.v1` bereit. Das Modul beschreibt die UX-Reife der Form-Control-Familie, das Runtime-Profil `xtendFormControlUxProfile`, RMT Shell-first Authoring, Validation, A11y, Fabric-Lanes und die Zielkomponenten `x-input`, `x-select`, `x-checkbox`, `x-radio`, `x-textarea`, `x-calendar`, `x-form` und `x-writer`.
+
+```bash
+node scripts/run_xtend_tests.js form-controls-ux --json
+```
+
+Der Contract ist generator-only. Die produktive UI bleibt in den Komponenten; RMT beschreibt Shell, Events, Commands und Schedules ueber `xtend.component`.
+
+## Feedback Status UX Contract
+
+`feedback-status-ux-contract.js` stellt ab `WP-E11-09` den Contract `xtend.component.feedback-status-ux.v1` bereit. Das Modul beschreibt die UX-Reife der Feedback- und Status-Familie, das Runtime-Profil `xtendFeedbackStatusUxProfile`, RMT Shell-first Authoring, Live Regions, Dismiss/Timeout, Motion Safety, Fabric-Lanes und die Zielkomponenten `x-alert`, `x-toast`, `x-status`, `x-progress` und `x-spinner`.
+
+```bash
+node scripts/run_xtend_tests.js feedback-status-ux --json
+```
+
+Der Contract ist generator-only. RMT beschreibt Shell, A11y, Events, Commands und Schedules ueber `xtend.component`; XTend rendert und hydriert die Custom Elements im Host.
+
+## Navigation Routing UX Contract
+
+`navigation-routing-ux-contract.js` stellt ab `WP-E11-10` den Contract `xtend.component.navigation-routing-ux.v1` bereit. Das Modul beschreibt die UX-Reife der Navigation- und Routing-Familie, das Runtime-Profil `xtendNavigationRoutingUxProfile`, RMT Shell-first Authoring, Active State, Focus Restore, Route Announcements, Keyboard Navigation, Fabric-Lanes und die Zielkomponenten `x-router` und `x-link`.
+
+```bash
+node scripts/run_xtend_tests.js navigation-routing-ux --json
+```
+
+Der Contract ist generator-only. RMT beschreibt Route Context, Links, Events, Commands und Schedules ueber `xtend.xrouter` und `xtend.component`; XTend rendert, fokussiert, announced und hydriert die Custom Elements im Host.
+
+## Overlay Interaction UX Contract
+
+`overlay-interaction-ux-contract.js` stellt ab `WP-E11-11` den Contract `xtend.component.overlay-interaction-ux.v1` bereit. Das Modul beschreibt die UX-Reife der Overlay- und Interaction-Familie, das Runtime-Profil `xtendOverlayInteractionUxProfile`, RMT Shell-first Authoring, Overlay Stack, Focus Trap, Inert, Scroll Lock, Escape, Portal-Semantik, Fabric-Lanes und die Zielkomponenten `x-modal`, `x-dialog`, `x-popover`, `x-tooltip` und `x-drawer`.
+
+```bash
+node scripts/run_xtend_tests.js overlay-interaction-ux --json
+```
+
+Der Contract ist generator-only. RMT beschreibt Overlay-Shells, Events, Commands und Schedules ueber `xtend.component` und `rmt.overlay-stack`; XTend rendert, trappt Fokus, verwaltet Rueckfokus und DOM-nahe Inert-/Scroll-Lock-Regeln im Host.
+
+## Layout Display Media UX Contract
+
+`layout-display-media-ux-contract.js` stellt ab `WP-E11-12` den Contract `xtend.component.layout-display-media-ux.v1` bereit. Das Modul beschreibt die UX-Reife der Layout-, Display- und Media-Familie, das Runtime-Profil `xtendLayoutDisplayMediaUxProfile`, RMT Shell-first Authoring, Responsive Slots, CSS Parts, Lazy Media, Fabric-Lanes und die Zielkomponenten `x-section`, `x-cards`, `x-header`, `x-footer`, `x-hero`, `x-type`, `x-code`, `x-masonry`, `x-summary`, `x-player` und `x-lightbox`.
+
+```bash
+node scripts/run_xtend_tests.js layout-display-media-ux --json
+```
+
+Der Contract ist generator-only. RMT beschreibt Shell, Layout, Media-Lifecycle, Events, Commands und Schedules ueber `xtend.component`, `rmt.layout-host` und `rmt.media-host`; XTend rendert, misst, hydriert und bedient Media im Host.
+
+## Ausnahmeprozess
+
+Typfreie Komponenten sind nur mit dokumentierter Ausnahme erlaubt. Verboten bleiben:
+
+- undokumentierte Typ-Luecken
+- implizites `any` fuer oeffentliche APIs
+- Runtime-Imports aus `.d.ts` Artefakten

package/xtend-builder/typing/component-contract-v2.d.ts

@@ -0,0 +1,15 @@
+import type { XtendBuilderComponentInput, XtendBuilderOptions, XtendBuilderRecord, XtendBuilderReport } from '../builder-public-types';
+
+export declare const COMPONENT_CONTRACT_V2_SCHEMA: string;
+export declare const COMPONENT_CONTRACT_REPORT_V2_SCHEMA: string;
+export declare const COMPONENT_CONTRACT_V2_WORKPACKAGE: string;
+export declare const COMPONENT_CONTRACT_V2_DOC: string;
+export declare const TYPESCRIPT_SOURCE_STRATEGY_SCHEMA: string;
+export declare const RMT_COMPONENT_CONTRACT_SCHEMA: string;
+export declare const FABRIC_BOUNDARY_SCHEMA: string;
+export declare const TELEMETRY_SNAPSHOT_SCHEMA: string;
+export declare const CONTRACT_V2_REQUIRED_DOMAINS: string[];
+export declare const CONTRACT_V2_LIFECYCLE_OPERATIONS: string[];
+export declare const CONTRACT_V2_LANE_PRECEDENCE: string[];
+export declare function createComponentContractV2(input?: XtendBuilderComponentInput, options?: XtendBuilderOptions): XtendBuilderRecord;
+export declare function validateComponentContractV2(contract: unknown): XtendBuilderReport<XtendBuilderRecord>;

package/xtend-builder/typing/component-contract-v2.js

@@ -0,0 +1,248 @@
+const COMPONENT_CONTRACT_V2_SCHEMA = 'xtend.component.contract.v2';
+const COMPONENT_CONTRACT_REPORT_V2_SCHEMA = 'xtend.component.contract-report.v2';
+const COMPONENT_CONTRACT_V2_WORKPACKAGE = 'WP-E10-03';
+const COMPONENT_CONTRACT_V2_DOC = 'development/XTend-Component-Contract-v2.md';
+const TYPESCRIPT_SOURCE_STRATEGY_SCHEMA = 'xtend.typescript.component-source-strategy.v1';
+const RMT_COMPONENT_CONTRACT_SCHEMA = 'xtend.rmt.component-contract.v1';
+const FABRIC_BOUNDARY_SCHEMA = 'xtend.component.fabric-boundary.v2';
+const A11Y_COMPONENT_CONTRACT_SCHEMA = 'xtend.a11y.component-contract.v1';
+const PERFORMANCE_COMPONENT_PROFILE_SCHEMA = 'xtend.performance.component-profile.v1';
+const TELEMETRY_SNAPSHOT_SCHEMA = 'xtend.fabric.telemetry-snapshot.v1';
+
+const CONTRACT_V2_REQUIRED_DOMAINS = [
+  'source',
+  'runtime',
+  'publicApi',
+  'rmt',
+  'fabric',
+  'telemetry',
+  'lanes',
+  'a11y',
+  'performance',
+  'tests',
+  'docs',
+  'maturity'
+];
+
+const CONTRACT_V2_LIFECYCLE_OPERATIONS = [
+  'mount',
+  'hydrate',
+  'render',
+  'update',
+  'event',
+  'error',
+  'unmount'
+];
+
+const CONTRACT_V2_LANE_PRECEDENCE = [
+  'rmt.schedule-record',
+  'rmt.component-metadata',
+  'fabric.runtime-override',
+  'component.static-contract',
+  'scaffold.blueprint-default'
+];
+
+function toBasename(tag) {
+  return String(tag || 'x-example').replace(/-/g, '');
+}
+
+function toClassName(tag) {
+  return String(tag || 'x-example')
+    .split('-')
+    .filter(Boolean)
+    .map((part) => part.charAt(0).toUpperCase() + part.slice(1))
+    .join('');
+}
+
+function normalizeArray(value) {
+  return Array.isArray(value) ? value.slice() : [];
+}
+
+function createAttributeContract(attributes = []) {
+  const normalized = attributes.length > 0 ? attributes : ['variant'];
+  return normalized.map((name) => ({
+    name,
+    type: 'string | null',
+    reflects: true,
+    required: false,
+    source: 'observedAttributes'
+  }));
+}
+
+function createEventContract(events = [], className) {
+  return normalizeArray(events).map((name) => ({
+    name,
+    typeName: `${className}EventDetail`,
+    eventType: `CustomEvent<${className}EventDetail>`,
+    bubbles: true,
+    composed: true,
+    detailShape: {
+      id: 'string',
+      source: 'string',
+      value: 'unknown'
+    }
+  }));
+}
+
+function createComponentContractV2(input = {}, options = {}) {
+  const tag = input.tag || 'x-example';
+  const basename = input.basename || toBasename(tag);
+  const className = input.className || toClassName(tag);
+  const sourceRoot = options.sourceRoot || 'src/components/';
+  const runtimeOutputRoot = options.runtimeOutputRoot || 'components/';
+  const declarationOutputRoot = options.declarationOutputRoot || 'components/';
+  const maturity = input.maturity || 'preview';
+  const sourceState = input.sourceState || (input.typescript === false ? 'js-legacy' : 'ts-source');
+  const attributes = createAttributeContract(normalizeArray(input.attributes));
+  const events = createEventContract(normalizeArray(input.events), className);
+  const slots = normalizeArray(input.slots).length > 0
+    ? normalizeArray(input.slots).map((name) => ({ name, required: false, content: 'RmtTemplateRef | string | HTMLElement' }))
+    : [{ name: 'default', required: false, content: 'RmtTemplateRef | string | HTMLElement' }];
+
+  return {
+    schema: COMPONENT_CONTRACT_V2_SCHEMA,
+    status: 'contract-draft',
+    workpackage: COMPONENT_CONTRACT_V2_WORKPACKAGE,
+    tag,
+    className,
+    maturity,
+    source: {
+      strategy: TYPESCRIPT_SOURCE_STRATEGY_SCHEMA,
+      state: sourceState,
+      sourceRoot,
+      sourcePath: `${sourceRoot}${tag}/${tag}.ts`,
+      contractPath: `${sourceRoot}${tag}/${tag}.contract.ts`,
+      rmtMetadataPath: `${sourceRoot}${tag}/${tag}.rmt.ts`,
+      a11yProfilePath: `${sourceRoot}${tag}/${tag}.a11y.ts`,
+      performanceProfilePath: `${sourceRoot}${tag}/${tag}.performance.ts`,
+      fixtureDataPath: `${sourceRoot}${tag}/${tag}.fixture.ts`,
+      migrationAllowedStates: ['js-legacy', 'ts-planned', 'ts-source', 'ts-generated-esm', 'contract-only']
+    },
+    runtime: {
+      format: 'esm',
+      loader: 'xtend-loader.js',
+      manifest: 'components/manifest.json',
+      artifact: `${runtimeOutputRoot}${basename}.js`,
+      declaration: `${declarationOutputRoot}${basename}.d.ts`,
+      localOnly: true,
+      cdnAllowed: false,
+      newRuntimeDependenciesAllowed: false
+    },
+    publicApi: {
+      attributes,
+      properties: normalizeArray(input.properties),
+      slots,
+      events,
+      methods: normalizeArray(input.methods),
+      state: normalizeArray(input.state),
+      theme: normalizeArray(input.theme),
+      typeExports: [`${className}Element`, `${className}EventName`, `${className}EventDetail`]
+    },
+    rmt: {
+      schema: RMT_COMPONENT_CONTRACT_SCHEMA,
+      adapter: 'xtend.component',
+      componentRecordKind: 'custom_element',
+      fields: ['id', 'kind', 'adapter', 'tag', 'props', 'attributes', 'slots', 'events', 'schedule', 'hydration', 'fabric', 'a11y', 'performance'],
+      routeAdapter: input.routeAdapter || null,
+      kernelBoundary: 'no-rmt-kernel-import-of-xtend-types'
+    },
+    fabric: {
+      schema: FABRIC_BOUNDARY_SCHEMA,
+      api: '@xtend-fabric',
+      operations: CONTRACT_V2_LIFECYCLE_OPERATIONS.slice(),
+      boundaryRequired: true,
+      diagnosticFields: ['component', 'phase', 'fiberId', 'lane', 'severity', 'cause']
+    },
+    telemetry: {
+      schema: TELEMETRY_SNAPSHOT_SCHEMA,
+      requiredOperations: CONTRACT_V2_LIFECYCLE_OPERATIONS.slice(),
+      requiredFields: ['componentId', 'routeId', 'rmtId', 'scheduleId', 'fiberId', 'lane', 'durationMs', 'status'],
+      backpressureAware: true
+    },
+    lanes: {
+      precedence: CONTRACT_V2_LANE_PRECEDENCE.slice(),
+      defaultLane: input.defaultLane || 'visible',
+      diagnosticsOnConflict: true
+    },
+    a11y: {
+      schema: A11Y_COMPONENT_CONTRACT_SCHEMA,
+      requiredProfile: true,
+      requiredFields: ['role', 'accessibleName', 'focusStrategy', 'keyboard', 'ariaStates', 'screenreader', 'motion', 'contrast']
+    },
+    performance: {
+      schema: PERFORMANCE_COMPONENT_PROFILE_SCHEMA,
+      budgetMatrix: 'development/XTend-Performance-Budget-Matrix.md',
+      requiredProfile: true,
+      requiredFields: ['budgetClass', 'lane', 'hydrationPolicy', 'criticalMeasurements', 'cleanup']
+    },
+    tests: {
+      requiredSuites: ['components', 'a11y-hydration', 'rmt-compatibility', 'references'],
+      futureSuites: ['component-contract-v2', 'performance-regression', 'browser'],
+      fixtureRequired: true
+    },
+    docs: {
+      componentGuide: `docs/components/${tag.replace(/^x-/, '')}.md`,
+      requiredSections: ['API', 'Events', 'RMT Authoring', 'Fabric', 'A11y', 'Performance']
+    },
+    maturity: {
+      model: 'xtend.component.maturity-model.v2',
+      target: maturity,
+      stableRequires: ['publicApi', 'rmt', 'fabric', 'telemetry', 'lanes', 'a11y', 'performance', 'tests', 'docs']
+    }
+  };
+}
+
+function validateComponentContractV2(contract = {}) {
+  const errors = [];
+
+  if (contract.schema !== COMPONENT_CONTRACT_V2_SCHEMA) {
+    errors.push(`schema must be ${COMPONENT_CONTRACT_V2_SCHEMA}`);
+  }
+  if (!/^x-[a-z0-9]+(?:-[a-z0-9]+)*$/.test(String(contract.tag || ''))) {
+    errors.push('tag must be a valid XTend custom element tag');
+  }
+
+  CONTRACT_V2_REQUIRED_DOMAINS.forEach((domain) => {
+    if (!contract[domain]) {
+      errors.push(`missing domain: ${domain}`);
+    }
+  });
+
+  if (contract.runtime && contract.runtime.format !== 'esm') {
+    errors.push('runtime.format must be esm');
+  }
+  if (contract.runtime && contract.runtime.cdnAllowed !== false) {
+    errors.push('runtime.cdnAllowed must be false');
+  }
+  if (contract.rmt && contract.rmt.kernelBoundary !== 'no-rmt-kernel-import-of-xtend-types') {
+    errors.push('rmt.kernelBoundary must keep the RMT kernel decoupled from XTend types');
+  }
+  if (contract.fabric && !Array.isArray(contract.fabric.operations)) {
+    errors.push('fabric.operations must be an array');
+  }
+  if (contract.publicApi && !Array.isArray(contract.publicApi.events)) {
+    errors.push('publicApi.events must be an array');
+  }
+
+  return {
+    schema: COMPONENT_CONTRACT_REPORT_V2_SCHEMA,
+    ok: errors.length === 0,
+    errors
+  };
+}
+
+module.exports = {
+  COMPONENT_CONTRACT_V2_SCHEMA,
+  COMPONENT_CONTRACT_REPORT_V2_SCHEMA,
+  COMPONENT_CONTRACT_V2_WORKPACKAGE,
+  COMPONENT_CONTRACT_V2_DOC,
+  TYPESCRIPT_SOURCE_STRATEGY_SCHEMA,
+  RMT_COMPONENT_CONTRACT_SCHEMA,
+  FABRIC_BOUNDARY_SCHEMA,
+  TELEMETRY_SNAPSHOT_SCHEMA,
+  CONTRACT_V2_REQUIRED_DOMAINS,
+  CONTRACT_V2_LIFECYCLE_OPERATIONS,
+  CONTRACT_V2_LANE_PRECEDENCE,
+  createComponentContractV2,
+  validateComponentContractV2
+};

package/xtend-builder/typing/component-network-contract.d.ts

@@ -0,0 +1,22 @@
+import type { XtendBuilderComponentInput, XtendBuilderOptions, XtendBuilderRecord, XtendBuilderReport } from '../builder-public-types';
+
+export declare const COMPONENT_CONTRACT_V2_SCHEMA: string;
+export declare const COMPONENT_NETWORK_ASSERTIONS: string[];
+export declare const COMPONENT_NETWORK_CONTEXTS: string[];
+export declare const COMPONENT_NETWORK_CONTRACT_DOC: string;
+export declare const COMPONENT_NETWORK_CONTRACT_SCHEMA: string;
+export declare const COMPONENT_NETWORK_PROFILES: string[];
+export declare const COMPONENT_NETWORK_REPORT_SCHEMA: string;
+export declare const COMPONENT_NETWORK_REQUIRED_COMMANDS: string[];
+export declare const COMPONENT_NETWORK_REQUIRED_DOMAINS: string[];
+export declare const COMPONENT_NETWORK_REQUIRED_EVENTS: string[];
+export declare const COMPONENT_NETWORK_WORKPACKAGE: string;
+export declare const COMPONENT_SHELL_CONTRACT_SCHEMA: string;
+export declare const COMPONENT_STYLING_CONTRACT_SCHEMA: string;
+export declare const COMPONENT_UX_PERFORMANCE_CONTRACT_SCHEMA: string;
+export declare const FABRIC_BOUNDARY_SCHEMA: string;
+export declare const KERNEL_BOUNDARY: string;
+export declare const RMT_NETWORK_AUTHORING_SCHEMA: string;
+export declare const RUNTIME_A11Y_CONTRACT_SCHEMA: string;
+export declare function createComponentNetworkContract(input?: XtendBuilderComponentInput, options?: XtendBuilderOptions): XtendBuilderRecord;
+export declare function validateComponentNetworkContract(contract: unknown): XtendBuilderReport<XtendBuilderRecord>;