@ccslabs/xtend 0.1.0-rc.1 → 0.1.2

package/catalog/epic18-rmt-component-template-primitives.js

@@ -0,0 +1,240 @@
+const {
+  KERNEL_BOUNDARY
+} = require('./epic12-rc0-gate-matrix');
+const {
+  RMT_DOM_DESCRIPTOR_RENDERER_SCHEMA,
+  RMT_DOM_DESCRIPTOR_RENDERER_WORKPACKAGE
+} = require('./epic18-rmt-dom-descriptor-renderer');
+
+const RMT_COMPONENT_TEMPLATE_PRIMITIVES_SCHEMA = 'xtend.epic18.rmt-component-template-primitives.v1';
+const RMT_COMPONENT_TEMPLATE_PRIMITIVES_REPORT_SCHEMA = 'xtend.epic18.rmt-component-template-primitives-report.v1';
+const RMT_COMPONENT_TEMPLATE_PRIMITIVES_FIXTURE_SCHEMA = 'xtend.epic18.rmt-component-template-primitives-fixture.v1';
+const RMT_COMPONENT_TEMPLATE_PRIMITIVES_WORKPACKAGE = 'WP-E18-06';
+const RMT_COMPONENT_TEMPLATE_PRIMITIVES_STATUS = 'accepted-component-template-primitives';
+const RMT_COMPONENT_TEMPLATE_PRIMITIVES_TARGET = 'rmt-component-template-primitives-ready';
+const RMT_COMPONENT_TEMPLATE_PRIMITIVES_MODULE = 'catalog/epic18-rmt-component-template-primitives.js';
+const RMT_COMPONENT_TEMPLATE_PRIMITIVES_RUNTIME = 'xtendrmt/rmt-dom-descriptor-renderer.js';
+const RMT_COMPONENT_TEMPLATE_PRIMITIVES_TYPES = 'xtendrmt/rmt-dom-descriptor-renderer.d.ts';
+const RMT_COMPONENT_TEMPLATE_PRIMITIVES_SUITE = 'tests/rmt/rmt_component_template_primitives_suite.js';
+const RMT_COMPONENT_TEMPLATE_PRIMITIVES_FIXTURE = 'tests/fixtures/rmt-component-template-primitives.rmt';
+const RMT_COMPONENT_TEMPLATE_PRIMITIVES_DOCS = 'docs/rmt-component-template-primitives.md';
+const RMT_COMPONENT_TEMPLATE_PRIMITIVES_WORKPACKAGE_DOC = 'development/WP-E18-06-Component-native-Template-Primitives-fuer-RMT-implementieren.md';
+const RMT_COMPONENT_TEMPLATE_PRIMITIVES_BACKLOG = 'development/BACKLOG-EPIC-18-XTendRMT-App-Platform-und-Media-Manager-Vendor-Upstream.md';
+const RMT_COMPONENT_TEMPLATE_PRIMITIVES_EPIC = 'docs/epic18-media-manager-vendor-upstream.md';
+const RMT_COMPONENT_TEMPLATE_PRIMITIVES_LOCAL_GATE = 'node scripts/run_xtend_tests.js rmt-component-template-primitives --json';
+const RMT_COMPONENT_TEMPLATE_PRIMITIVES_PACKAGE_SCRIPT = 'npm run test:rmt-component-template-primitives';
+const NEXT_WORKPACKAGE = 'WP-E18-07';
+const NEXT_DECISION = 'typed-state-selectors-xstate-bridge';
+
+const REQUIRED_TEMPLATE_PRIMITIVES = Object.freeze([
+  'component',
+  'props',
+  'attributes',
+  'parts',
+  'slots',
+  'text',
+  'when',
+  'repeat',
+  'empty',
+  'fallback',
+  'key',
+  'ref',
+  'class',
+  'style-token'
+]);
+
+const REQUIRED_COMPONENT_FAMILIES = Object.freeze([
+  'icons',
+  'tooltips',
+  'form-controls',
+  'navigation',
+  'list',
+  'selection',
+  'empty-state',
+  'error-state',
+  'custom-elements'
+]);
+
+const REQUIRED_RENDERER_CAPABILITIES = Object.freeze([
+  'component-tag-resolution',
+  'property-binding',
+  'attribute-binding',
+  'slot-content-object',
+  'css-part-mapping',
+  'class-token-mapping',
+  'style-token-mapping',
+  'ref-capture',
+  'conditional-rendering',
+  'repeat-keyed-rendering',
+  'empty-fallback-rendering',
+  'event-listener-binding',
+  'no-manual-html'
+]);
+
+const REQUIRED_BOUNDARIES = Object.freeze([
+  'component-native-over-html-strings',
+  'developer-defined-component-families',
+  'generic-custom-elements-supported',
+  'no-media-manager-product-taxonomy',
+  'no-external-innerhtml-helper-required',
+  'no-rmt-kernel-import-of-xtend-types'
+]);
+
+const REQUIRED_ARTIFACTS = Object.freeze([
+  RMT_COMPONENT_TEMPLATE_PRIMITIVES_MODULE,
+  RMT_COMPONENT_TEMPLATE_PRIMITIVES_SUITE,
+  RMT_COMPONENT_TEMPLATE_PRIMITIVES_FIXTURE,
+  RMT_COMPONENT_TEMPLATE_PRIMITIVES_DOCS,
+  RMT_COMPONENT_TEMPLATE_PRIMITIVES_WORKPACKAGE_DOC,
+  RMT_COMPONENT_TEMPLATE_PRIMITIVES_RUNTIME,
+  RMT_COMPONENT_TEMPLATE_PRIMITIVES_TYPES
+]);
+
+const REQUIRED_DOCS = Object.freeze([
+  RMT_COMPONENT_TEMPLATE_PRIMITIVES_DOCS,
+  RMT_COMPONENT_TEMPLATE_PRIMITIVES_WORKPACKAGE_DOC,
+  RMT_COMPONENT_TEMPLATE_PRIMITIVES_BACKLOG,
+  RMT_COMPONENT_TEMPLATE_PRIMITIVES_EPIC
+]);
+
+function createRmtComponentTemplatePrimitivesPlan(options = {}) {
+  return {
+    schema: RMT_COMPONENT_TEMPLATE_PRIMITIVES_SCHEMA,
+    reportSchema: RMT_COMPONENT_TEMPLATE_PRIMITIVES_REPORT_SCHEMA,
+    fixtureSchema: RMT_COMPONENT_TEMPLATE_PRIMITIVES_FIXTURE_SCHEMA,
+    rendererSchema: RMT_DOM_DESCRIPTOR_RENDERER_SCHEMA,
+    rendererWorkpackage: RMT_DOM_DESCRIPTOR_RENDERER_WORKPACKAGE,
+    workpackage: RMT_COMPONENT_TEMPLATE_PRIMITIVES_WORKPACKAGE,
+    status: RMT_COMPONENT_TEMPLATE_PRIMITIVES_STATUS,
+    generatedAt: options.generatedAt || 'static-local',
+    targetReadiness: RMT_COMPONENT_TEMPLATE_PRIMITIVES_TARGET,
+    module: RMT_COMPONENT_TEMPLATE_PRIMITIVES_MODULE,
+    runtime: RMT_COMPONENT_TEMPLATE_PRIMITIVES_RUNTIME,
+    types: RMT_COMPONENT_TEMPLATE_PRIMITIVES_TYPES,
+    suite: RMT_COMPONENT_TEMPLATE_PRIMITIVES_SUITE,
+    fixture: RMT_COMPONENT_TEMPLATE_PRIMITIVES_FIXTURE,
+    docs: RMT_COMPONENT_TEMPLATE_PRIMITIVES_DOCS,
+    workpackageDocument: RMT_COMPONENT_TEMPLATE_PRIMITIVES_WORKPACKAGE_DOC,
+    localGate: RMT_COMPONENT_TEMPLATE_PRIMITIVES_LOCAL_GATE,
+    packageScript: RMT_COMPONENT_TEMPLATE_PRIMITIVES_PACKAGE_SCRIPT,
+    templatePrimitives: REQUIRED_TEMPLATE_PRIMITIVES.slice(),
+    componentFamilies: REQUIRED_COMPONENT_FAMILIES.slice(),
+    rendererCapabilities: REQUIRED_RENDERER_CAPABILITIES.slice(),
+    boundaries: REQUIRED_BOUNDARIES.slice(),
+    artifactPaths: REQUIRED_ARTIFACTS.slice(),
+    requiredDocs: REQUIRED_DOCS.slice(),
+    model: {
+      componentNativeTemplates: true,
+      htmlStringRendererRequired: false,
+      customElementTagsAllowed: true,
+      genericComponentFamiliesRequired: true,
+      listSelectionEmptyErrorStatesRequired: true,
+      productSurfaceTaxonomyAllowed: false,
+      rendererReusedFromWp05: true
+    },
+    kernelBoundary: KERNEL_BOUNDARY,
+    nextWorkpackage: NEXT_WORKPACKAGE,
+    nextDecision: NEXT_DECISION
+  };
+}
+
+function validateRmtComponentTemplatePrimitivesPlan(plan = createRmtComponentTemplatePrimitivesPlan()) {
+  const errors = [];
+  const model = plan && plan.model ? plan.model : {};
+
+  if (!plan || plan.schema !== RMT_COMPONENT_TEMPLATE_PRIMITIVES_SCHEMA) errors.push(`schema must be ${RMT_COMPONENT_TEMPLATE_PRIMITIVES_SCHEMA}`);
+  if (!plan || plan.reportSchema !== RMT_COMPONENT_TEMPLATE_PRIMITIVES_REPORT_SCHEMA) errors.push(`reportSchema must be ${RMT_COMPONENT_TEMPLATE_PRIMITIVES_REPORT_SCHEMA}`);
+  if (!plan || plan.fixtureSchema !== RMT_COMPONENT_TEMPLATE_PRIMITIVES_FIXTURE_SCHEMA) errors.push(`fixtureSchema must be ${RMT_COMPONENT_TEMPLATE_PRIMITIVES_FIXTURE_SCHEMA}`);
+  if (!plan || plan.rendererSchema !== RMT_DOM_DESCRIPTOR_RENDERER_SCHEMA) errors.push('renderer schema must come from WP-E18-05');
+  if (!plan || plan.rendererWorkpackage !== RMT_DOM_DESCRIPTOR_RENDERER_WORKPACKAGE) errors.push('renderer workpackage must be WP-E18-05');
+  if (!plan || plan.workpackage !== RMT_COMPONENT_TEMPLATE_PRIMITIVES_WORKPACKAGE) errors.push(`workpackage must be ${RMT_COMPONENT_TEMPLATE_PRIMITIVES_WORKPACKAGE}`);
+  if (!plan || plan.status !== RMT_COMPONENT_TEMPLATE_PRIMITIVES_STATUS) errors.push(`status must be ${RMT_COMPONENT_TEMPLATE_PRIMITIVES_STATUS}`);
+  if (!plan || plan.targetReadiness !== RMT_COMPONENT_TEMPLATE_PRIMITIVES_TARGET) errors.push(`targetReadiness must be ${RMT_COMPONENT_TEMPLATE_PRIMITIVES_TARGET}`);
+  REQUIRED_TEMPLATE_PRIMITIVES.forEach((primitive) => {
+    if (!plan || !plan.templatePrimitives.includes(primitive)) errors.push(`template primitive missing: ${primitive}`);
+  });
+  REQUIRED_COMPONENT_FAMILIES.forEach((family) => {
+    if (!plan || !plan.componentFamilies.includes(family)) errors.push(`component family missing: ${family}`);
+  });
+  REQUIRED_RENDERER_CAPABILITIES.forEach((capability) => {
+    if (!plan || !plan.rendererCapabilities.includes(capability)) errors.push(`renderer capability missing: ${capability}`);
+  });
+  REQUIRED_BOUNDARIES.forEach((boundary) => {
+    if (!plan || !plan.boundaries.includes(boundary)) errors.push(`boundary missing: ${boundary}`);
+  });
+  REQUIRED_ARTIFACTS.forEach((artifact) => {
+    if (!plan || !plan.artifactPaths.includes(artifact)) errors.push(`artifact missing: ${artifact}`);
+  });
+  REQUIRED_DOCS.forEach((doc) => {
+    if (!plan || !plan.requiredDocs.includes(doc)) errors.push(`doc missing: ${doc}`);
+  });
+  if (model.componentNativeTemplates !== true) errors.push('component native templates must be enabled');
+  if (model.htmlStringRendererRequired !== false) errors.push('HTML string renderer must not be required');
+  if (model.customElementTagsAllowed !== true) errors.push('custom elements must be supported');
+  if (model.genericComponentFamiliesRequired !== true) errors.push('generic component families must be required');
+  if (model.listSelectionEmptyErrorStatesRequired !== true) errors.push('list, selection, empty and error states must be required');
+  if (model.productSurfaceTaxonomyAllowed !== false) errors.push('product surface taxonomy must stay disallowed');
+  if (model.rendererReusedFromWp05 !== true) errors.push('WP-E18-06 must build on WP-E18-05 renderer');
+  if (!plan || plan.kernelBoundary !== KERNEL_BOUNDARY) errors.push(`kernelBoundary must be ${KERNEL_BOUNDARY}`);
+  if (!plan || plan.nextWorkpackage !== NEXT_WORKPACKAGE) errors.push(`nextWorkpackage must be ${NEXT_WORKPACKAGE}`);
+  if (!plan || plan.nextDecision !== NEXT_DECISION) errors.push(`nextDecision must be ${NEXT_DECISION}`);
+
+  return {
+    schema: RMT_COMPONENT_TEMPLATE_PRIMITIVES_REPORT_SCHEMA,
+    ok: errors.length === 0,
+    errors,
+    workpackage: RMT_COMPONENT_TEMPLATE_PRIMITIVES_WORKPACKAGE,
+    checkedAt: 'static-local'
+  };
+}
+
+function createRmtComponentTemplatePrimitivesReport(options = {}) {
+  const plan = options.plan || createRmtComponentTemplatePrimitivesPlan(options);
+  const validation = validateRmtComponentTemplatePrimitivesPlan(plan);
+
+  return {
+    schema: RMT_COMPONENT_TEMPLATE_PRIMITIVES_REPORT_SCHEMA,
+    ok: validation.ok,
+    errors: validation.errors.slice(),
+    workpackage: plan.workpackage,
+    status: plan.status,
+    targetReadiness: plan.targetReadiness,
+    templatePrimitiveCount: plan.templatePrimitives.length,
+    componentFamilyCount: plan.componentFamilies.length,
+    rendererCapabilityCount: plan.rendererCapabilities.length,
+    boundaryCount: plan.boundaries.length,
+    htmlStringRendererRequired: plan.model.htmlStringRendererRequired,
+    nextWorkpackage: plan.nextWorkpackage,
+    nextDecision: plan.nextDecision,
+    kernelBoundary: plan.kernelBoundary
+  };
+}
+
+module.exports = {
+  NEXT_DECISION,
+  NEXT_WORKPACKAGE,
+  REQUIRED_ARTIFACTS,
+  REQUIRED_BOUNDARIES,
+  REQUIRED_COMPONENT_FAMILIES,
+  REQUIRED_DOCS,
+  REQUIRED_RENDERER_CAPABILITIES,
+  REQUIRED_TEMPLATE_PRIMITIVES,
+  RMT_COMPONENT_TEMPLATE_PRIMITIVES_DOCS,
+  RMT_COMPONENT_TEMPLATE_PRIMITIVES_FIXTURE,
+  RMT_COMPONENT_TEMPLATE_PRIMITIVES_FIXTURE_SCHEMA,
+  RMT_COMPONENT_TEMPLATE_PRIMITIVES_LOCAL_GATE,
+  RMT_COMPONENT_TEMPLATE_PRIMITIVES_MODULE,
+  RMT_COMPONENT_TEMPLATE_PRIMITIVES_PACKAGE_SCRIPT,
+  RMT_COMPONENT_TEMPLATE_PRIMITIVES_REPORT_SCHEMA,
+  RMT_COMPONENT_TEMPLATE_PRIMITIVES_RUNTIME,
+  RMT_COMPONENT_TEMPLATE_PRIMITIVES_SCHEMA,
+  RMT_COMPONENT_TEMPLATE_PRIMITIVES_STATUS,
+  RMT_COMPONENT_TEMPLATE_PRIMITIVES_SUITE,
+  RMT_COMPONENT_TEMPLATE_PRIMITIVES_TARGET,
+  RMT_COMPONENT_TEMPLATE_PRIMITIVES_TYPES,
+  RMT_COMPONENT_TEMPLATE_PRIMITIVES_WORKPACKAGE,
+  RMT_COMPONENT_TEMPLATE_PRIMITIVES_WORKPACKAGE_DOC,
+  createRmtComponentTemplatePrimitivesPlan,
+  createRmtComponentTemplatePrimitivesReport,
+  validateRmtComponentTemplatePrimitivesPlan
+};

package/catalog/epic18-rmt-dom-descriptor-renderer.d.ts

@@ -0,0 +1,35 @@
+import type {
+  XtendCatalogConstant,
+  XtendCatalogOptions,
+  XtendCatalogPlan,
+  XtendCatalogReport
+} from './catalog-public-types';
+
+export declare const FORBIDDEN_NORMAL_UI_SINKS: readonly XtendCatalogConstant[] | XtendCatalogConstant;
+export declare const NEXT_DECISION: string;
+export declare const NEXT_WORKPACKAGE: string;
+export declare const NO_MANUAL_HTML_GATE_SCHEMA: string;
+export declare const REQUIRED_ARTIFACTS: readonly XtendCatalogConstant[] | XtendCatalogConstant;
+export declare const REQUIRED_BOUNDARIES: readonly XtendCatalogConstant[] | XtendCatalogConstant;
+export declare const REQUIRED_DOCS: readonly XtendCatalogConstant[] | XtendCatalogConstant;
+export declare const REQUIRED_RENDER_OPERATIONS: readonly XtendCatalogConstant[] | XtendCatalogConstant;
+export declare const RMT_DOM_DESCRIPTOR_RENDERER_DOCS: string;
+export declare const RMT_DOM_DESCRIPTOR_RENDERER_FIXTURE: string;
+export declare const RMT_DOM_DESCRIPTOR_RENDERER_FIXTURE_SCHEMA: string;
+export declare const RMT_DOM_DESCRIPTOR_RENDERER_LOCAL_GATE: string;
+export declare const RMT_DOM_DESCRIPTOR_RENDERER_MODULE: string;
+export declare const RMT_DOM_DESCRIPTOR_RENDERER_PACKAGE_SCRIPT: string;
+export declare const RMT_DOM_DESCRIPTOR_RENDERER_REPORT_SCHEMA: string;
+export declare const RMT_DOM_DESCRIPTOR_RENDERER_RUNTIME: string;
+export declare const RMT_DOM_DESCRIPTOR_RENDERER_SCHEMA: string;
+export declare const RMT_DOM_DESCRIPTOR_RENDERER_STATUS: string;
+export declare const RMT_DOM_DESCRIPTOR_RENDERER_SUITE: string;
+export declare const RMT_DOM_DESCRIPTOR_RENDERER_TARGET: string;
+export declare const RMT_DOM_DESCRIPTOR_RENDERER_TYPES: string;
+export declare const RMT_DOM_DESCRIPTOR_RENDERER_WORKPACKAGE: string;
+export declare const RMT_DOM_DESCRIPTOR_RENDERER_WORKPACKAGE_DOC: string;
+export declare const RMT_DOM_RENDERER_DIAGNOSTIC_SCHEMA: string;
+export declare const TRUSTED_DOM_BOUNDARY: string;
+export declare function createRmtDomDescriptorRendererPlan(options?: XtendCatalogOptions): XtendCatalogPlan;
+export declare function createRmtDomDescriptorRendererReport(options?: XtendCatalogOptions): XtendCatalogReport;
+export declare function validateRmtDomDescriptorRendererPlan(plan?: unknown): XtendCatalogReport;

package/catalog/epic18-rmt-dom-descriptor-renderer.js

@@ -0,0 +1,232 @@
+const {
+  KERNEL_BOUNDARY
+} = require('./epic12-rc0-gate-matrix');
+const {
+  RMT_APP_PLATFORM_AUTHORING_SCHEMA,
+  RMT_APP_PLATFORM_AUTHORING_WORKPACKAGE
+} = require('./epic18-rmt-app-platform-authoring');
+
+const RMT_DOM_DESCRIPTOR_RENDERER_SCHEMA = 'xtend.epic18.rmt-dom-descriptor-renderer.v1';
+const RMT_DOM_DESCRIPTOR_RENDERER_REPORT_SCHEMA = 'xtend.epic18.rmt-dom-descriptor-renderer-report.v1';
+const RMT_DOM_DESCRIPTOR_RENDERER_FIXTURE_SCHEMA = 'xtend.epic18.rmt-dom-descriptor-renderer-fixture.v1';
+const RMT_DOM_RENDERER_DIAGNOSTIC_SCHEMA = 'xtend.epic18.rmt-dom-renderer-diagnostic.v1';
+const NO_MANUAL_HTML_GATE_SCHEMA = 'xtend.epic18.no-manual-html-gate.v1';
+const RMT_DOM_DESCRIPTOR_RENDERER_WORKPACKAGE = 'WP-E18-05';
+const RMT_DOM_DESCRIPTOR_RENDERER_STATUS = 'accepted-dom-descriptor-renderer';
+const RMT_DOM_DESCRIPTOR_RENDERER_TARGET = 'rmt-dom-descriptor-renderer-ready';
+const RMT_DOM_DESCRIPTOR_RENDERER_MODULE = 'catalog/epic18-rmt-dom-descriptor-renderer.js';
+const RMT_DOM_DESCRIPTOR_RENDERER_RUNTIME = 'xtendrmt/rmt-dom-descriptor-renderer.js';
+const RMT_DOM_DESCRIPTOR_RENDERER_TYPES = 'xtendrmt/rmt-dom-descriptor-renderer.d.ts';
+const RMT_DOM_DESCRIPTOR_RENDERER_SUITE = 'tests/rmt/rmt_dom_descriptor_renderer_suite.js';
+const RMT_DOM_DESCRIPTOR_RENDERER_FIXTURE = 'tests/fixtures/rmt-dom-descriptor-renderer.rmt';
+const RMT_DOM_DESCRIPTOR_RENDERER_DOCS = 'docs/rmt-dom-descriptor-renderer.md';
+const RMT_DOM_DESCRIPTOR_RENDERER_WORKPACKAGE_DOC = 'development/WP-E18-05-Sicheren-DOM-Descriptor-Renderer-und-No-Manual-HTML-Gate-bauen.md';
+const RMT_DOM_DESCRIPTOR_RENDERER_BACKLOG = 'development/BACKLOG-EPIC-18-XTendRMT-App-Platform-und-Media-Manager-Vendor-Upstream.md';
+const RMT_DOM_DESCRIPTOR_RENDERER_EPIC = 'docs/epic18-media-manager-vendor-upstream.md';
+const RMT_DOM_DESCRIPTOR_RENDERER_LOCAL_GATE = 'node scripts/run_xtend_tests.js rmt-dom-descriptor-renderer --json';
+const RMT_DOM_DESCRIPTOR_RENDERER_PACKAGE_SCRIPT = 'npm run test:rmt-dom-descriptor-renderer';
+const TRUSTED_DOM_BOUNDARY = 'xtend.rmt.trusted-dom-boundary.explicit';
+const NEXT_WORKPACKAGE = 'WP-E18-06';
+const NEXT_DECISION = 'component-native-template-primitives';
+
+const REQUIRED_RENDER_OPERATIONS = Object.freeze([
+  'document.createElement',
+  'document.createTextNode',
+  'document.createDocumentFragment',
+  'root.replaceChildren',
+  'element.replaceChildren',
+  'keyed-child-reuse',
+  'safe-setAttribute',
+  'safe-removeAttribute',
+  'safe-property-setter',
+  'addEventListener',
+  'trusted-dom-boundary-delegation',
+  'diagnostic-source-map'
+]);
+
+const FORBIDDEN_NORMAL_UI_SINKS = Object.freeze([
+  'root.innerHTML',
+  'element.innerHTML',
+  'template.innerHTML',
+  'outerHTML',
+  'insertAdjacentHTML',
+  'document.write',
+  'createContextualFragment'
+]);
+
+const REQUIRED_BOUNDARIES = Object.freeze([
+  'structured-dom-descriptor-default',
+  'trusted-html-explicit-boundary-only',
+  'no-manual-html-normal-ui',
+  'no-external-innerhtml-helper-required',
+  'diagnostics-map-runtime-errors-to-rmt-source',
+  'no-rmt-kernel-import-of-xtend-types'
+]);
+
+const REQUIRED_ARTIFACTS = Object.freeze([
+  RMT_DOM_DESCRIPTOR_RENDERER_MODULE,
+  RMT_DOM_DESCRIPTOR_RENDERER_RUNTIME,
+  RMT_DOM_DESCRIPTOR_RENDERER_TYPES,
+  RMT_DOM_DESCRIPTOR_RENDERER_SUITE,
+  RMT_DOM_DESCRIPTOR_RENDERER_FIXTURE,
+  RMT_DOM_DESCRIPTOR_RENDERER_DOCS,
+  RMT_DOM_DESCRIPTOR_RENDERER_WORKPACKAGE_DOC
+]);
+
+const REQUIRED_DOCS = Object.freeze([
+  RMT_DOM_DESCRIPTOR_RENDERER_DOCS,
+  RMT_DOM_DESCRIPTOR_RENDERER_WORKPACKAGE_DOC,
+  RMT_DOM_DESCRIPTOR_RENDERER_BACKLOG,
+  RMT_DOM_DESCRIPTOR_RENDERER_EPIC
+]);
+
+function createRmtDomDescriptorRendererPlan(options = {}) {
+  return {
+    schema: RMT_DOM_DESCRIPTOR_RENDERER_SCHEMA,
+    reportSchema: RMT_DOM_DESCRIPTOR_RENDERER_REPORT_SCHEMA,
+    fixtureSchema: RMT_DOM_DESCRIPTOR_RENDERER_FIXTURE_SCHEMA,
+    diagnosticSchema: RMT_DOM_RENDERER_DIAGNOSTIC_SCHEMA,
+    noManualHtmlGateSchema: NO_MANUAL_HTML_GATE_SCHEMA,
+    authoringSchema: RMT_APP_PLATFORM_AUTHORING_SCHEMA,
+    authoringWorkpackage: RMT_APP_PLATFORM_AUTHORING_WORKPACKAGE,
+    workpackage: RMT_DOM_DESCRIPTOR_RENDERER_WORKPACKAGE,
+    status: RMT_DOM_DESCRIPTOR_RENDERER_STATUS,
+    generatedAt: options.generatedAt || 'static-local',
+    targetReadiness: RMT_DOM_DESCRIPTOR_RENDERER_TARGET,
+    module: RMT_DOM_DESCRIPTOR_RENDERER_MODULE,
+    runtime: RMT_DOM_DESCRIPTOR_RENDERER_RUNTIME,
+    types: RMT_DOM_DESCRIPTOR_RENDERER_TYPES,
+    suite: RMT_DOM_DESCRIPTOR_RENDERER_SUITE,
+    fixture: RMT_DOM_DESCRIPTOR_RENDERER_FIXTURE,
+    docs: RMT_DOM_DESCRIPTOR_RENDERER_DOCS,
+    workpackageDocument: RMT_DOM_DESCRIPTOR_RENDERER_WORKPACKAGE_DOC,
+    localGate: RMT_DOM_DESCRIPTOR_RENDERER_LOCAL_GATE,
+    packageScript: RMT_DOM_DESCRIPTOR_RENDERER_PACKAGE_SCRIPT,
+    trustedDomBoundary: TRUSTED_DOM_BOUNDARY,
+    requiredRenderOperations: REQUIRED_RENDER_OPERATIONS.slice(),
+    forbiddenNormalUiSinks: FORBIDDEN_NORMAL_UI_SINKS.slice(),
+    boundaries: REQUIRED_BOUNDARIES.slice(),
+    artifactPaths: REQUIRED_ARTIFACTS.slice(),
+    requiredDocs: REQUIRED_DOCS.slice(),
+    model: {
+      rendererImplemented: true,
+      runtimeImplemented: true,
+      structuredDescriptorDefault: true,
+      normalUiAllowsManualHtml: false,
+      trustedHtmlAllowedOnlyWithExplicitBoundary: true,
+      externalInnerHtmlHelperRequired: false,
+      diagnosticSourceMappingRequired: true,
+      keyedDiffingRequired: true,
+      productSurfaceTaxonomyAllowed: false
+    },
+    kernelBoundary: KERNEL_BOUNDARY,
+    nextWorkpackage: NEXT_WORKPACKAGE,
+    nextDecision: NEXT_DECISION
+  };
+}
+
+function validateRmtDomDescriptorRendererPlan(plan = createRmtDomDescriptorRendererPlan()) {
+  const errors = [];
+  const model = plan && plan.model ? plan.model : {};
+
+  if (!plan || plan.schema !== RMT_DOM_DESCRIPTOR_RENDERER_SCHEMA) errors.push(`schema must be ${RMT_DOM_DESCRIPTOR_RENDERER_SCHEMA}`);
+  if (!plan || plan.reportSchema !== RMT_DOM_DESCRIPTOR_RENDERER_REPORT_SCHEMA) errors.push(`reportSchema must be ${RMT_DOM_DESCRIPTOR_RENDERER_REPORT_SCHEMA}`);
+  if (!plan || plan.fixtureSchema !== RMT_DOM_DESCRIPTOR_RENDERER_FIXTURE_SCHEMA) errors.push(`fixtureSchema must be ${RMT_DOM_DESCRIPTOR_RENDERER_FIXTURE_SCHEMA}`);
+  if (!plan || plan.diagnosticSchema !== RMT_DOM_RENDERER_DIAGNOSTIC_SCHEMA) errors.push(`diagnosticSchema must be ${RMT_DOM_RENDERER_DIAGNOSTIC_SCHEMA}`);
+  if (!plan || plan.noManualHtmlGateSchema !== NO_MANUAL_HTML_GATE_SCHEMA) errors.push(`noManualHtmlGateSchema must be ${NO_MANUAL_HTML_GATE_SCHEMA}`);
+  if (!plan || plan.authoringSchema !== RMT_APP_PLATFORM_AUTHORING_SCHEMA) errors.push('authoring schema must match WP-E18-04');
+  if (!plan || plan.authoringWorkpackage !== RMT_APP_PLATFORM_AUTHORING_WORKPACKAGE) errors.push('authoring workpackage must match WP-E18-04');
+  if (!plan || plan.workpackage !== RMT_DOM_DESCRIPTOR_RENDERER_WORKPACKAGE) errors.push(`workpackage must be ${RMT_DOM_DESCRIPTOR_RENDERER_WORKPACKAGE}`);
+  if (!plan || plan.status !== RMT_DOM_DESCRIPTOR_RENDERER_STATUS) errors.push(`status must be ${RMT_DOM_DESCRIPTOR_RENDERER_STATUS}`);
+  if (!plan || plan.targetReadiness !== RMT_DOM_DESCRIPTOR_RENDERER_TARGET) errors.push(`targetReadiness must be ${RMT_DOM_DESCRIPTOR_RENDERER_TARGET}`);
+  if (!plan || plan.trustedDomBoundary !== TRUSTED_DOM_BOUNDARY) errors.push(`trustedDomBoundary must be ${TRUSTED_DOM_BOUNDARY}`);
+  REQUIRED_RENDER_OPERATIONS.forEach((operation) => {
+    if (!plan || !plan.requiredRenderOperations.includes(operation)) errors.push(`render operation missing: ${operation}`);
+  });
+  FORBIDDEN_NORMAL_UI_SINKS.forEach((sink) => {
+    if (!plan || !plan.forbiddenNormalUiSinks.includes(sink)) errors.push(`forbidden sink missing: ${sink}`);
+  });
+  REQUIRED_BOUNDARIES.forEach((boundary) => {
+    if (!plan || !plan.boundaries.includes(boundary)) errors.push(`boundary missing: ${boundary}`);
+  });
+  REQUIRED_ARTIFACTS.forEach((artifact) => {
+    if (!plan || !plan.artifactPaths.includes(artifact)) errors.push(`artifact missing: ${artifact}`);
+  });
+  REQUIRED_DOCS.forEach((doc) => {
+    if (!plan || !plan.requiredDocs.includes(doc)) errors.push(`doc missing: ${doc}`);
+  });
+  if (model.rendererImplemented !== true || model.runtimeImplemented !== true) errors.push('WP-E18-05 must implement renderer/runtime');
+  if (model.structuredDescriptorDefault !== true) errors.push('structured descriptor must be default');
+  if (model.normalUiAllowsManualHtml !== false) errors.push('normal UI must not allow manual HTML');
+  if (model.trustedHtmlAllowedOnlyWithExplicitBoundary !== true) errors.push('trusted HTML must require explicit boundary');
+  if (model.externalInnerHtmlHelperRequired !== false) errors.push('external innerHTML helper must not be required');
+  if (model.diagnosticSourceMappingRequired !== true) errors.push('diagnostic source mapping must be required');
+  if (model.keyedDiffingRequired !== true) errors.push('keyed diffing must be required');
+  if (model.productSurfaceTaxonomyAllowed !== false) errors.push('product surface taxonomy must stay disallowed');
+  if (!plan || plan.kernelBoundary !== KERNEL_BOUNDARY) errors.push(`kernelBoundary must be ${KERNEL_BOUNDARY}`);
+  if (!plan || plan.nextWorkpackage !== NEXT_WORKPACKAGE) errors.push(`nextWorkpackage must be ${NEXT_WORKPACKAGE}`);
+  if (!plan || plan.nextDecision !== NEXT_DECISION) errors.push(`nextDecision must be ${NEXT_DECISION}`);
+
+  return {
+    schema: RMT_DOM_DESCRIPTOR_RENDERER_REPORT_SCHEMA,
+    ok: errors.length === 0,
+    errors,
+    workpackage: RMT_DOM_DESCRIPTOR_RENDERER_WORKPACKAGE,
+    checkedAt: 'static-local'
+  };
+}
+
+function createRmtDomDescriptorRendererReport(options = {}) {
+  const plan = options.plan || createRmtDomDescriptorRendererPlan(options);
+  const validation = validateRmtDomDescriptorRendererPlan(plan);
+
+  return {
+    schema: RMT_DOM_DESCRIPTOR_RENDERER_REPORT_SCHEMA,
+    ok: validation.ok,
+    errors: validation.errors.slice(),
+    workpackage: plan.workpackage,
+    status: plan.status,
+    targetReadiness: plan.targetReadiness,
+    renderOperationCount: plan.requiredRenderOperations.length,
+    forbiddenSinkCount: plan.forbiddenNormalUiSinks.length,
+    boundaryCount: plan.boundaries.length,
+    rendererImplemented: plan.model.rendererImplemented,
+    runtimeImplemented: plan.model.runtimeImplemented,
+    normalUiAllowsManualHtml: plan.model.normalUiAllowsManualHtml,
+    trustedDomBoundary: plan.trustedDomBoundary,
+    nextWorkpackage: plan.nextWorkpackage,
+    nextDecision: plan.nextDecision,
+    kernelBoundary: plan.kernelBoundary
+  };
+}
+
+module.exports = {
+  FORBIDDEN_NORMAL_UI_SINKS,
+  NEXT_DECISION,
+  NEXT_WORKPACKAGE,
+  NO_MANUAL_HTML_GATE_SCHEMA,
+  REQUIRED_ARTIFACTS,
+  REQUIRED_BOUNDARIES,
+  REQUIRED_DOCS,
+  REQUIRED_RENDER_OPERATIONS,
+  RMT_DOM_DESCRIPTOR_RENDERER_DOCS,
+  RMT_DOM_DESCRIPTOR_RENDERER_FIXTURE,
+  RMT_DOM_DESCRIPTOR_RENDERER_FIXTURE_SCHEMA,
+  RMT_DOM_DESCRIPTOR_RENDERER_LOCAL_GATE,
+  RMT_DOM_DESCRIPTOR_RENDERER_MODULE,
+  RMT_DOM_DESCRIPTOR_RENDERER_PACKAGE_SCRIPT,
+  RMT_DOM_DESCRIPTOR_RENDERER_REPORT_SCHEMA,
+  RMT_DOM_DESCRIPTOR_RENDERER_RUNTIME,
+  RMT_DOM_DESCRIPTOR_RENDERER_SCHEMA,
+  RMT_DOM_DESCRIPTOR_RENDERER_STATUS,
+  RMT_DOM_DESCRIPTOR_RENDERER_SUITE,
+  RMT_DOM_DESCRIPTOR_RENDERER_TARGET,
+  RMT_DOM_DESCRIPTOR_RENDERER_TYPES,
+  RMT_DOM_DESCRIPTOR_RENDERER_WORKPACKAGE,
+  RMT_DOM_DESCRIPTOR_RENDERER_WORKPACKAGE_DOC,
+  RMT_DOM_RENDERER_DIAGNOSTIC_SCHEMA,
+  TRUSTED_DOM_BOUNDARY,
+  createRmtDomDescriptorRendererPlan,
+  createRmtDomDescriptorRendererReport,
+  validateRmtDomDescriptorRendererPlan
+};

package/catalog/epic18-rmt-event-routing-runtime.d.ts

@@ -0,0 +1,35 @@
+import type {
+  XtendCatalogConstant,
+  XtendCatalogOptions,
+  XtendCatalogPlan,
+  XtendCatalogReport
+} from './catalog-public-types';
+
+export declare const NEXT_DECISION: string;
+export declare const NEXT_WORKPACKAGE: string;
+export declare const REQUIRED_ARTIFACTS: readonly XtendCatalogConstant[] | XtendCatalogConstant;
+export declare const REQUIRED_BOUNDARIES: readonly XtendCatalogConstant[] | XtendCatalogConstant;
+export declare const REQUIRED_DOCS: readonly XtendCatalogConstant[] | XtendCatalogConstant;
+export declare const REQUIRED_EVENT_CAPABILITIES: readonly XtendCatalogConstant[] | XtendCatalogConstant;
+export declare const REQUIRED_EVENT_KINDS: readonly XtendCatalogConstant[] | XtendCatalogConstant;
+export declare const REQUIRED_GOVERNANCE_POLICIES: readonly XtendCatalogConstant[] | XtendCatalogConstant;
+export declare const RMT_EVENT_ROUTING_RUNTIME_BACKLOG: string;
+export declare const RMT_EVENT_ROUTING_RUNTIME_DOCS: string;
+export declare const RMT_EVENT_ROUTING_RUNTIME_EPIC: string;
+export declare const RMT_EVENT_ROUTING_RUNTIME_FIXTURE: string;
+export declare const RMT_EVENT_ROUTING_RUNTIME_FIXTURE_SCHEMA: string;
+export declare const RMT_EVENT_ROUTING_RUNTIME_LOCAL_GATE: string;
+export declare const RMT_EVENT_ROUTING_RUNTIME_MODULE: string;
+export declare const RMT_EVENT_ROUTING_RUNTIME_PACKAGE_SCRIPT: string;
+export declare const RMT_EVENT_ROUTING_RUNTIME_REPORT_SCHEMA: string;
+export declare const RMT_EVENT_ROUTING_RUNTIME_RUNTIME: string;
+export declare const RMT_EVENT_ROUTING_RUNTIME_SCHEMA: string;
+export declare const RMT_EVENT_ROUTING_RUNTIME_STATUS: string;
+export declare const RMT_EVENT_ROUTING_RUNTIME_SUITE: string;
+export declare const RMT_EVENT_ROUTING_RUNTIME_TARGET: string;
+export declare const RMT_EVENT_ROUTING_RUNTIME_TYPES: string;
+export declare const RMT_EVENT_ROUTING_RUNTIME_WORKPACKAGE: string;
+export declare const RMT_EVENT_ROUTING_RUNTIME_WORKPACKAGE_DOC: string;
+export declare function createRmtEventRoutingRuntimePlan(options?: XtendCatalogOptions): XtendCatalogPlan;
+export declare function createRmtEventRoutingRuntimeReport(options?: XtendCatalogOptions): XtendCatalogReport;
+export declare function validateRmtEventRoutingRuntimePlan(plan?: unknown): XtendCatalogReport;