@ccslabs/xtend 0.1.0-rc.1

package/xtend-builder/blueprints/component-blueprint.contract.js

@@ -0,0 +1,343 @@
+const COMPONENT_BLUEPRINT_SCHEMA = 'xtend.scaffold.component-blueprint.v1';
+const TYPESCRIPT_COMPONENT_BLUEPRINT_SCHEMA = 'xtend.scaffold.typescript-component-blueprint.v1';
+const {
+  A11Y_COMPONENT_CONTRACT_SCHEMA,
+  A11Y_CONTRAST_POLICY_SCHEMA,
+  A11Y_MOTION_CONTRAST_POLICY_SCHEMA,
+  A11Y_MOTION_POLICY_SCHEMA,
+  A11Y_PROFILE_SCHEMA,
+  A11Y_SCREENREADER_SIGNALS_SCHEMA,
+  A11Y_TEST_CONTRACT_SCHEMA,
+  PROFILE_A11Y_RULES,
+  SCAFFOLD_A11Y_PROFILE_PLAN_SCHEMA
+} = require('../a11y/component-a11y-profile');
+const {
+  PERFORMANCE_BUDGET_MATRIX_SCHEMA,
+  PERFORMANCE_COMPONENT_PROFILE_SCHEMA,
+  PERFORMANCE_MEASUREMENT_SCHEMA,
+  PERFORMANCE_POLICY_SCHEMA,
+  PERFORMANCE_REGRESSION_GATE_SCHEMA,
+  HYDRATION_POLICY_SCHEMA,
+  PROFILE_PERFORMANCE_RULES
+} = require('../performance/component-performance-profile');
+const {
+  COMPONENT_CONTRACT_V2_SCHEMA,
+  TYPESCRIPT_SOURCE_STRATEGY_SCHEMA,
+  RMT_COMPONENT_CONTRACT_SCHEMA,
+  FABRIC_BOUNDARY_SCHEMA,
+  TELEMETRY_SNAPSHOT_SCHEMA,
+  CONTRACT_V2_LIFECYCLE_OPERATIONS,
+  CONTRACT_V2_LANE_PRECEDENCE
+} = require('../typing/component-contract-v2');
+
+const COMPONENT_LIFECYCLE_TELEMETRY_SCHEMA = 'xtend.component.lifecycle-telemetry.v1';
+const COMPONENT_FABRIC_LANE_INGESTION_SCHEMA = 'xtend.component.fabric-lane-ingestion.v2';
+
+const NAMING_CONTRACT = {
+  tagPattern: '^x-[a-z0-9]+(?:-[a-z0-9]+)*$',
+  fileNameRule: 'tag without hyphens after x-prefix for current legacy-compatible component paths',
+  docsNameRule: 'tag without x- prefix',
+  stateKeyPrefix: 'xtend.component.<tag>.',
+  eventNameRule: '<component-domain>-<past-tense-action>'
+};
+
+const ARTIFACT_MATRIX = [
+  {
+    id: 'component',
+    pathTemplate: 'components/<tag>.js',
+    required: true,
+    mode: 'write-new',
+    purpose: 'Productive Custom Element or XTend-near module source.',
+    minimumContract: ['syntax-check', 'registration-or-module-export', 'lifecycle-boundary', 'static-a11y-profile', 'static-performance-profile']
+  },
+  {
+    id: 'docs',
+    pathTemplate: 'docs/components/<name>.md',
+    required: true,
+    mode: 'write-new',
+    purpose: 'Public component contract with attributes, slots, events, state and examples.',
+    minimumContract: ['public-contract', 'usage-example', 'a11y-profile', 'screenreader-signal-contract', 'motion-contrast-policy', 'performance-profile', 'accessibility-and-hydration-notes']
+  },
+  {
+    id: 'tests',
+    pathTemplate: 'tests/components/<tag>.component_suite.js',
+    required: true,
+    mode: 'write-new',
+    purpose: 'Component-level suite with real assertions for the selected profiles.',
+    minimumContract: ['source-contract', 'profile-checks', 'a11y-profile-contract', 'screenreader-signal-contract', 'motion-contrast-policy-contract', 'performance-profile-contract', 'no-placeholder-tests']
+  },
+  {
+    id: 'fixtures',
+    pathTemplate: 'tests/components/fixtures/<tag>.component.html',
+    required: true,
+    mode: 'write-new-or-documented-exception',
+    purpose: 'Repo-local DOM and hydration fixture for visible Custom Elements.',
+    minimumContract: ['repo-local-imports', 'component-markup', 'hydration-result-object', 'a11y-fixture-attributes', 'screenreader-signal-result', 'motion-contrast-result']
+  },
+  {
+    id: 'types',
+    pathTemplate: 'components/<tag>.d.ts',
+    required: true,
+    mode: 'write-new-or-documented-exception',
+    purpose: 'Public TypeScript contract for JS API, attributes and Custom Events.',
+    minimumContract: ['public-api-types', 'event-detail-types', 'a11y-profile-types', 'screenreader-signal-types', 'motion-contrast-policy-types', 'performance-profile-types']
+  },
+  {
+    id: 'manifest',
+    pathTemplate: 'components/manifest.json',
+    required: true,
+    mode: 'patch-plan',
+    purpose: 'Loader and hydration participation as deterministic manifest patch plan.',
+    minimumContract: ['tag-entry', 'repo-local-source', 'a11y-profile-plan', 'screenreader-signals-plan', 'motion-contrast-policy-plan', 'performance-profile-plan', 'manifest-review-step']
+  },
+  {
+    id: 'demo',
+    pathTemplate: 'docs/previews/<name>.preview.md',
+    required: 'conditional',
+    mode: 'reference-plan',
+    purpose: 'Visible or workflow-relevant reference path once the component has a bestcase.',
+    minimumContract: ['reference-registry-entry', 'local-assets-or-documented-exception']
+  },
+  {
+    id: 'ts-source',
+    pathTemplate: 'src/components/<tag>/<tag>.ts',
+    required: true,
+    mode: 'write-new',
+    purpose: 'TypeScript-first Custom Element source for new components.',
+    minimumContract: ['typescript-source', 'component-contract-v2', 'esm-output-plan', 'static-rmt-metadata', 'fabric-lifecycle-boundary', 'lifecycle-telemetry', 'static-a11y-profile', 'static-performance-profile']
+  },
+  {
+    id: 'ts-contract',
+    pathTemplate: 'src/components/<tag>/<tag>.contract.ts',
+    required: true,
+    mode: 'write-new',
+    purpose: 'Machine-readable Component Contract v2 source artifact.',
+    minimumContract: ['xtend.component.contract.v2', 'public-api', 'rmt-adapter-metadata', 'fabric-boundary', 'telemetry-contract', 'lane-precedence', 'a11y-performance-contracts']
+  },
+  {
+    id: 'ts-rmt',
+    pathTemplate: 'src/components/<tag>/<tag>.rmt.ts',
+    required: true,
+    mode: 'write-new',
+    purpose: 'RMT component metadata without importing XTend into the RMT kernel.',
+    minimumContract: ['xtend.rmt.component-contract.v1', 'xtend.component-adapter-ref', 'schedule-hints', 'hydration-policy', 'fabric-lane-ingestion', 'no-rmt-kernel-import-of-xtend-types']
+  },
+  {
+    id: 'ts-a11y',
+    pathTemplate: 'src/components/<tag>/<tag>.a11y.ts',
+    required: true,
+    mode: 'write-new',
+    purpose: 'A11y profile source artifact for screenreader, keyboard, motion and contrast defaults.',
+    minimumContract: ['xtend.a11y.component-contract.v1', 'xtend.a11y.profile.v1', 'screenreader-signals', 'motion-contrast-policy', 'fixture-attributes']
+  },
+  {
+    id: 'ts-performance',
+    pathTemplate: 'src/components/<tag>/<tag>.performance.ts',
+    required: true,
+    mode: 'write-new',
+    purpose: 'Performance profile source artifact with budget, lane and hydration policy.',
+    minimumContract: ['xtend.performance.component-profile.v1', 'budget-class', 'lane', 'hydration-policy', 'critical-measurements', 'cleanup-policy']
+  },
+  {
+    id: 'ts-fixture',
+    pathTemplate: 'src/components/<tag>/<tag>.fixture.ts',
+    required: true,
+    mode: 'write-new',
+    purpose: 'Typed fixture data for component suites, RMT previews and Component Lab imports.',
+    minimumContract: ['typed-fixture-data', 'repo-local-imports', 'rmt-metadata-fixture', 'a11y-fixture-attributes', 'telemetry-expectations']
+  }
+];
+
+const PROFILE_CHECKS = [
+  {
+    profile: 'display',
+    requiredChecks: ['registration', 'manifest', 'attributes', 'slots', 'visible-dom', 'hydration-baseline'],
+    a11y: PROFILE_A11Y_RULES.display,
+    performance: PROFILE_PERFORMANCE_RULES.display
+  },
+  {
+    profile: 'interactive',
+    requiredChecks: ['display-baseline', 'events', 'keyboard', 'focus', 'labels', 'rehydration-listeners'],
+    a11y: PROFILE_A11Y_RULES.interactive,
+    performance: PROFILE_PERFORMANCE_RULES.interactive
+  },
+  {
+    profile: 'stateful',
+    requiredChecks: ['canonical-xstate-key', 'external-state-change', 'cleanup', 'ssot-boundary'],
+    a11y: PROFILE_A11Y_RULES.stateful,
+    performance: PROFILE_PERFORMANCE_RULES.stateful
+  },
+  {
+    profile: 'feedback',
+    requiredChecks: ['live-region', 'dismissal', 'event-contract', 'timer-cleanup', 'reduced-motion'],
+    a11y: PROFILE_A11Y_RULES.feedback,
+    performance: PROFILE_PERFORMANCE_RULES.feedback
+  },
+  {
+    profile: 'overlay',
+    requiredChecks: ['open-state', 'focus-target', 'escape-close', 'focus-return', 'aria-modal'],
+    a11y: PROFILE_A11Y_RULES.overlay,
+    performance: PROFILE_PERFORMANCE_RULES.overlay
+  },
+  {
+    profile: 'routing',
+    requiredChecks: ['navigation', 'params-query', 'xstate-bridge', 'route-events', 'local-link-contract'],
+    a11y: PROFILE_A11Y_RULES.routing,
+    performance: PROFILE_PERFORMANCE_RULES.routing
+  },
+  {
+    profile: 'theme',
+    requiredChecks: ['theme-state', 'css-custom-properties', 'theme-event', 'legacy-facade-boundary'],
+    a11y: PROFILE_A11Y_RULES.theme,
+    performance: PROFILE_PERFORMANCE_RULES.theme
+  },
+  {
+    profile: 'form',
+    requiredChecks: ['value-contract', 'validation', 'labels', 'error-message', 'submit-change-events'],
+    a11y: PROFILE_A11Y_RULES.form,
+    performance: PROFILE_PERFORMANCE_RULES.form
+  },
+  {
+    profile: 'media',
+    requiredChecks: ['loading-state', 'controls', 'keyboard', 'fallbacks', 'reduced-motion'],
+    a11y: PROFILE_A11Y_RULES.media,
+    performance: PROFILE_PERFORMANCE_RULES.media
+  }
+];
+
+const A11Y_PROFILE_REQUIREMENTS = {
+  componentContract: A11Y_COMPONENT_CONTRACT_SCHEMA,
+  profileContract: A11Y_PROFILE_SCHEMA,
+  screenreaderSignalsContract: A11Y_SCREENREADER_SIGNALS_SCHEMA,
+  motionContrastContract: A11Y_MOTION_CONTRAST_POLICY_SCHEMA,
+  motionPolicyContract: A11Y_MOTION_POLICY_SCHEMA,
+  contrastPolicyContract: A11Y_CONTRAST_POLICY_SCHEMA,
+  testContract: A11Y_TEST_CONTRACT_SCHEMA,
+  scaffoldPlan: SCAFFOLD_A11Y_PROFILE_PLAN_SCHEMA,
+  sourceStaticGetter: 'xtendScaffoldA11yProfile',
+  manifestKey: 'a11yProfile',
+  requiredFixtureAttributes: ['aria-label'],
+  requiredDocsSections: ['A11y-Profil', 'Screenreader-Signale', 'Motion-und-Contrast-Policy', 'Accessibility und Hydration'],
+  requiredGates: ['components', 'a11y-hydration', 'screenreader-signals', 'motion-contrast', 'references'],
+  requiredFields: [
+    'role',
+    'accessibleName',
+    'focusStrategy',
+    'keyboard',
+    'ariaStates',
+    'screenreader',
+    'motion',
+    'contrast',
+    'motionContrast',
+    'testPlan'
+  ]
+};
+
+const PERFORMANCE_POLICY_REQUIREMENTS = {
+  policyContract: PERFORMANCE_POLICY_SCHEMA,
+  componentProfileContract: PERFORMANCE_COMPONENT_PROFILE_SCHEMA,
+  budgetMatrix: PERFORMANCE_BUDGET_MATRIX_SCHEMA,
+  measurementContract: PERFORMANCE_MEASUREMENT_SCHEMA,
+  regressionGate: PERFORMANCE_REGRESSION_GATE_SCHEMA,
+  hydrationPolicyContract: HYDRATION_POLICY_SCHEMA,
+  sourceStaticGetter: 'xtendScaffoldPerformanceProfile',
+  manifestKey: 'performanceProfile',
+  authorGuide: 'docs/performance.md',
+  requiredDocsSections: ['Performance-Profil', 'Performance-Regeln'],
+  requiredGates: ['fabric-performance-measurements', 'performance-regression', 'hydration-policy', 'references'],
+  requiredFields: [
+    'performanceProfile',
+    'budgetClass',
+    'lane',
+    'hydrationPolicy',
+    'criticalMeasurements',
+    'idleOrBackgroundAllowed'
+  ]
+};
+
+const TYPESCRIPT_BLUEPRINT_REQUIREMENTS = {
+  schema: TYPESCRIPT_COMPONENT_BLUEPRINT_SCHEMA,
+  status: 'accepted-WP-E10-07',
+  workpackage: 'development/WP-E10-07-xtend-builder-TypeScript-Blueprint-vorbereiten.md',
+  contract: 'development/XTend-TypeScript-Component-Blueprint.md',
+  localGate: 'node scripts/run_xtend_tests.js builder-typescript-blueprint --json',
+  sourceStrategy: TYPESCRIPT_SOURCE_STRATEGY_SCHEMA,
+  componentContract: COMPONENT_CONTRACT_V2_SCHEMA,
+  rmtComponentContract: RMT_COMPONENT_CONTRACT_SCHEMA,
+  fabricBoundary: FABRIC_BOUNDARY_SCHEMA,
+  fabricLaneIngestion: COMPONENT_FABRIC_LANE_INGESTION_SCHEMA,
+  lifecycleTelemetry: COMPONENT_LIFECYCLE_TELEMETRY_SCHEMA,
+  telemetrySnapshot: TELEMETRY_SNAPSHOT_SCHEMA,
+  sourceRoot: 'src/components/',
+  runtimeOutputRoot: 'components/',
+  declarationOutputRoot: 'components/',
+  requiredArtifacts: ['ts-source', 'ts-contract', 'ts-rmt', 'ts-a11y', 'ts-performance', 'ts-fixture'],
+  runtimeArtifacts: ['component', 'types', 'manifest'],
+  companionArtifacts: ['docs', 'tests', 'fixtures', 'demo'],
+  lifecycleOperations: CONTRACT_V2_LIFECYCLE_OPERATIONS,
+  lanePrecedence: CONTRACT_V2_LANE_PRECEDENCE,
+  kernelBoundary: 'no-rmt-kernel-import-of-xtend-types',
+  noRuntimeImports: true,
+  noProductiveWrites: true,
+  compilerIntroduced: false,
+  templateIds: [
+    'component.ts-source',
+    'component.ts-contract',
+    'component.ts-rmt',
+    'component.ts-a11y',
+    'component.ts-performance',
+    'component.ts-fixture'
+  ]
+};
+
+const EXCEPTION_POLICY = {
+  mode: 'documented-exception-required',
+  allowedFor: ['fixtures', 'types', 'manifest', 'demo'],
+  minimumReason: 'The generated worklog, component docs or test suite must name why the artifact is not applicable.',
+  forbidden: ['empty-test-file', 'silent-manifest-skip', 'undocumented-type-gap']
+};
+
+function clone(value) {
+  return JSON.parse(JSON.stringify(value));
+}
+
+function getComponentBlueprintContract() {
+  return clone({
+    schema: COMPONENT_BLUEPRINT_SCHEMA,
+    status: 'binding-from-WP-E03-03',
+    naming: NAMING_CONTRACT,
+    artifacts: ARTIFACT_MATRIX,
+    profiles: PROFILE_CHECKS,
+    typescriptBlueprint: TYPESCRIPT_BLUEPRINT_REQUIREMENTS,
+    a11yProfile: A11Y_PROFILE_REQUIREMENTS,
+    performancePolicy: PERFORMANCE_POLICY_REQUIREMENTS,
+    exceptionPolicy: EXCEPTION_POLICY
+  });
+}
+
+function getArtifactContract(id) {
+  const artifact = ARTIFACT_MATRIX.find((entry) => entry.id === id);
+  return artifact ? clone(artifact) : null;
+}
+
+function getProfileContract(profile) {
+  const contract = PROFILE_CHECKS.find((entry) => entry.profile === profile);
+  return contract ? clone(contract) : null;
+}
+
+module.exports = {
+  ARTIFACT_MATRIX,
+  A11Y_PROFILE_REQUIREMENTS,
+  COMPONENT_BLUEPRINT_SCHEMA,
+  TYPESCRIPT_BLUEPRINT_REQUIREMENTS,
+  TYPESCRIPT_COMPONENT_BLUEPRINT_SCHEMA,
+  COMPONENT_FABRIC_LANE_INGESTION_SCHEMA,
+  COMPONENT_LIFECYCLE_TELEMETRY_SCHEMA,
+  EXCEPTION_POLICY,
+  NAMING_CONTRACT,
+  PERFORMANCE_POLICY_REQUIREMENTS,
+  PROFILE_CHECKS,
+  getArtifactContract,
+  getComponentBlueprintContract,
+  getProfileContract
+};

package/xtend-builder/builder-public-types.d.ts

@@ -0,0 +1,234 @@
+export type XtendBuilderJsonPrimitive = string | number | boolean | null;
+export type XtendBuilderJsonValue = XtendBuilderJsonPrimitive | XtendBuilderJsonValue[] | { [key: string]: XtendBuilderJsonValue };
+export type XtendBuilderRecord<TValue = unknown> = Record<string, TValue>;
+export type XtendBuilderStatus = 'accepted' | 'planned' | 'pilot' | 'dry-run-contract-binding' | 'prepared-contract-only' | string;
+export type XtendBuilderOutputMode = 'text' | 'json' | 'json-file' | string;
+export type XtendBuilderConstant<TValue = unknown> = TValue;
+export type XtendBuilderFunction<TReturn = unknown> = (...args: unknown[]) => TReturn;
+export type XtendBuilderFactory<TReturn = unknown, TInput = XtendBuilderComponentInput> = (input?: TInput, options?: XtendBuilderOptions) => TReturn;
+
+export interface XtendBuilderOptions {
+  rootDir?: string;
+  config?: XtendBuilderRecord;
+  blueprint?: XtendBuilderBlueprintContract;
+  plan?: XtendBuilderComponentPlan;
+  [key: string]: unknown;
+}
+
+export interface XtendBuilderDiagnostic {
+  code?: string;
+  message: string;
+  severity?: 'debug' | 'info' | 'warn' | 'error' | string;
+  path?: string;
+  details?: unknown;
+}
+
+export interface XtendBuilderReport<TPlan = unknown> {
+  schema: string;
+  ok: boolean;
+  errors: string[];
+  warnings?: string[];
+  plan?: TPlan;
+  [key: string]: unknown;
+}
+
+export interface XtendBuilderCommand {
+  id: string;
+  command: string;
+  argv: string[];
+  purpose: string;
+  output?: XtendBuilderOutputMode;
+}
+
+export interface XtendBuilderCliIo {
+  stdout?: { write(value: string): unknown };
+  stderr?: { write(value: string): unknown };
+  [key: string]: unknown;
+}
+
+export interface XtendBuilderCliArgs {
+  command: string | null;
+  help: boolean;
+  json: boolean;
+  rest: string[];
+}
+
+export interface XtendBuilderFlagArgs {
+  _: string[];
+  [key: string]: unknown;
+}
+
+export interface XtendBuilderComponentInput {
+  tag?: string;
+  name?: string;
+  profile?: string | string[];
+  profiles?: string | string[];
+  feature?: string | string[];
+  features?: string | string[];
+  suite?: string | string[];
+  suites?: string | string[];
+  [key: string]: unknown;
+}
+
+export interface XtendBuilderArtifactContract {
+  id: string;
+  pathTemplate: string;
+  required: boolean | 'conditional' | string;
+  mode: string;
+  purpose: string;
+  minimumContract: string[];
+}
+
+export interface XtendBuilderArtifactPlan {
+  id: string;
+  required: boolean | 'conditional' | string;
+  mode: string;
+  action: string;
+  targetPath: string;
+  templateId: string | null;
+  templateStatus: string;
+  purpose: string;
+  minimumContract: string[];
+}
+
+export interface XtendBuilderComponentPlan {
+  schema: string;
+  ok: boolean;
+  mode: string;
+  generator?: string;
+  writeStrategy?: string;
+  input?: XtendBuilderRecord;
+  a11yProfile?: XtendBuilderRecord;
+  performanceProfile?: XtendBuilderRecord;
+  artifacts: XtendBuilderArtifactPlan[];
+  errors?: string[];
+  nextStep?: string;
+  [key: string]: unknown;
+}
+
+export interface XtendBuilderRenderedFile {
+  id: string;
+  targetPath: string;
+  action: string;
+  templateId: string;
+  templatePath: string;
+  content: string;
+}
+
+export interface XtendBuilderComponentFilesResult {
+  schema: string;
+  ok: boolean;
+  mode: string;
+  generator?: string;
+  writeStrategy?: string;
+  input?: XtendBuilderRecord;
+  wiring?: XtendBuilderRecord;
+  rmtCompatibility?: XtendBuilderRecord;
+  files: XtendBuilderRenderedFile[];
+  errors?: string[];
+  exceptions: string[];
+  nextStep?: string;
+  [key: string]: unknown;
+}
+
+export interface XtendBuilderBlueprintContract {
+  schema: string;
+  status: XtendBuilderStatus;
+  naming: XtendBuilderRecord;
+  artifacts: XtendBuilderArtifactContract[];
+  profiles: XtendBuilderRecord[];
+  typescriptBlueprint?: XtendBuilderRecord;
+  a11yProfile?: XtendBuilderRecord;
+  performancePolicy?: XtendBuilderRecord;
+  exceptionPolicy?: XtendBuilderRecord;
+}
+
+export interface XtendBuilderGeneratorDefinition {
+  id: string;
+  command: string;
+  status: XtendBuilderStatus;
+  description: string;
+  module: string;
+  schema: string;
+  [key: string]: unknown;
+}
+
+export interface XtendBuilderGeneratorRegistry {
+  schema: string;
+  generators: XtendBuilderGeneratorDefinition[];
+  [key: string]: unknown;
+}
+
+export interface XtendBuilderTemplateDefinition {
+  id: string;
+  artifact: string;
+  status: XtendBuilderStatus;
+  path: string;
+  [key: string]: unknown;
+}
+
+export interface XtendBuilderTemplateRegistry {
+  schema: string;
+  templates: XtendBuilderTemplateDefinition[];
+  [key: string]: unknown;
+}
+
+export interface XtendBuilderTemplateRenderResult {
+  ok: boolean;
+  content?: string;
+  template?: XtendBuilderTemplateDefinition;
+  error?: string;
+}
+
+export interface XtendBuilderWorkflow {
+  schema: string;
+  ok: boolean;
+  mode: string;
+  writePolicy?: string;
+  entryPoints?: XtendBuilderCommand[];
+  commands?: XtendBuilderCommand[];
+  npmScripts?: XtendBuilderRecord<string>;
+  selectedSuites?: string[];
+  reviewChecklist?: string[];
+  nextStep?: string;
+  [key: string]: unknown;
+}
+
+export interface XtendBuilderContractPlan extends XtendBuilderRecord {
+  schema: string;
+  status?: XtendBuilderStatus;
+  workpackage?: string;
+  localGate?: string;
+}
+
+export interface XtendBuilderPreviewTarget {
+  schema: string;
+  tag: string;
+  title: string;
+  family: string;
+  maturity: string;
+  priority: string;
+  profiles: string[];
+  paths: XtendBuilderRecord<string>;
+  rmt: XtendBuilderRecord;
+  fabric: XtendBuilderRecord;
+  telemetry: XtendBuilderRecord;
+  a11y: XtendBuilderRecord;
+  performance: XtendBuilderRecord;
+}
+
+export interface XtendBuilderComponentLabPlan extends XtendBuilderContractPlan {
+  renderMode: string;
+  localOnly: boolean;
+  externalNetworkAllowed: boolean;
+  kernelBoundary: string;
+  lab: {
+    previewTargets: XtendBuilderPreviewTarget[];
+    requiredPanels: string[];
+    panels: XtendBuilderRecord[];
+    [key: string]: unknown;
+  };
+  inspector: XtendBuilderRecord;
+  gates: string[];
+  handoff: XtendBuilderRecord;
+}

package/xtend-builder/extensions/README.md

@@ -0,0 +1,26 @@
+# XTend-Scaffold Extensions
+
+Dieser Bereich enthaelt ab `WP-E03-11` die vorbereiteten Extension-Point-Contracts fuer Templating, Rendering und Root-Lifecycle.
+
+## Contract
+
+`xtend-builder/extensions/component-extension-points.js` erzeugt einen Dry-Run-Contract mit Schema `xtend.scaffold.component-extension-points.v1`.
+
+Der Contract beschreibt:
+
+- Root-Lifecycle-Hooks wie `beforeHydrate`, `afterHydrate`, `beforeRender`, `afterRender` und `onDisconnect`
+- ab Epic 04 / `WP-E04-05` den Root-Handschlag `xtend.rmt.root-handshake.v1` mit Phasen `create`, `mount`, `hydrate`, `activate`, `update`, `unmount` und `diagnostics`
+- ab Epic 04 / `WP-E04-06` Host Capabilities ueber `xtend.rmt.host-capabilities.v1` fuer Manifest, `xstate`, Theme, API, Hydration, Router und Diagnostics
+- Template-Anschluss ueber adapterbasierte Template-Referenzen
+- ab Epic 04 / `WP-E04-04` das Authoring-Modell `xtend.rmt.template-authoring.v1` fuer Template-Refs, Component-Refs, Slots und Event-Command-Bindings
+- Rendering-Hints fuer `shadowRoot`, sichtbare Aktivierung und spaetere Schedule Policies
+- XTendRMT Bridge-Punkte fuer `xtend.component` und `xtend.xrouter`
+- ab Epic 04 / `WP-E04-07` das Binding `xtend.scaffold.rmt-compatibility-binding.v1`, das Typing, Manifest-Plan, Preview-Plan und Extension-Punkte synchron haelt
+- ab Epic 04 / `WP-E04-08` den dedizierten Gate `node scripts/run_xtend_tests.js rmt-compatibility --json`
+- Grenzen gegen Runtime-Imports, Router-Registrierung und produktive Schreiblogik
+
+## Grenze
+
+Die Extension-Module sind reine Builder-Contracts. Sie duerfen keine RMT Schedules ausfuehren, keine `.rmt` Dateien parsen, keine Routes registrieren und keine Rendering-Runtime bereitstellen. Scheduler-Handshakes bleiben Endpoint-Hints: RMT plant, der XTend Host Adapter fuehrt Root-Lifecycle, Custom-Element-Hydration, Cleanup und Diagnostics aus. Host Capabilities bleiben verhandelbare Adapterdaten; der RMT Kernel darf daraus keine XTend Runtime-Imports oder `window.XTend` Aufrufe ableiten. RMT-Kompatibilitaets-Bindings duerfen nur Dry-Run-Artefakte zusammenfuehren und keine produktive Bridge starten.
+
+Produktive Templating-, Rendering- und Bridge-Entscheidungen bleiben Epic 04 und Epic 05 vorbehalten.

package/xtend-builder/extensions/component-extension-points.d.ts

@@ -0,0 +1,11 @@
+import type { XtendBuilderComponentInput, XtendBuilderOptions, XtendBuilderRecord } from '../builder-public-types';
+
+export declare const COMPONENT_EXTENSION_POINTS_SCHEMA: string;
+export declare const ROOT_LIFECYCLE_SCHEMA: string;
+export declare const TEMPLATE_EXTENSION_SCHEMA: string;
+export declare const RENDERING_EXTENSION_SCHEMA: string;
+export declare const ROOT_HANDSHAKE_CONTRACT_VERSION: string;
+export declare const HOST_CAPABILITIES_CONTRACT_VERSION: string;
+export declare const RMT_COMPATIBILITY_BINDING_SCHEMA: string;
+export declare const ROOT_LIFECYCLE_HOOKS: XtendBuilderRecord[];
+export declare function createComponentExtensionPoints(input?: XtendBuilderComponentInput, options?: XtendBuilderOptions): XtendBuilderRecord;