@ccslabs/xtend 0.1.0-rc.1 → 0.1.2

package/xtend-builder/generators/rmt-app-platform.js

@@ -0,0 +1,239 @@
+'use strict';
+
+const fs = require('fs');
+const path = require('path');
+const {
+  requireLocalOrScoped
+} = require('../lib/package-resolver');
+const {
+  analyzeRmtAppPlatformSource,
+  createRmtAppPlatformScaffoldPlan,
+  RMT_APP_PLATFORM_SCAFFOLD_SCHEMA,
+  RMT_APP_PLATFORM_TOOLING_LOCAL_GATE
+} = requireLocalOrScoped(
+  __filename,
+  '../../tools/rmt-language/app-platform-tooling',
+  '@ccslabs/xtend-compiler/rmt-language/app-platform-tooling'
+);
+const {
+  normalizeRelativePath,
+  writeScaffoldFiles
+} = require('../writing/write-plan');
+
+const RMT_APP_PLATFORM_BUILD_SCHEMA = 'xtend.scaffold.rmt-app-platform-build.v1';
+const RMT_APP_PLATFORM_BUILD_REPORT_SCHEMA = 'xtend.scaffold.rmt-app-platform-build-report.v1';
+const DEFAULT_SOURCE_PATH = 'tests/fixtures/rmt-app-platform-tooling.rmt';
+const DEFAULT_LOCAL_GATE = RMT_APP_PLATFORM_TOOLING_LOCAL_GATE;
+
+function toBoolean(value) {
+  return value === true || value === 'true' || value === '1' || value === 'yes';
+}
+
+function stableJson(value) {
+  return `${JSON.stringify(value, null, 2)}\n`;
+}
+
+function resolveBuildPaths(input = {}) {
+  const rawSource = input.source || input.src || (Array.isArray(input._) ? input._[0] : null) || DEFAULT_SOURCE_PATH;
+  const normalized = normalizeRelativePath(rawSource);
+  if (!normalized.ok) {
+    return {
+      ok: false,
+      errors: [normalized.error]
+    };
+  }
+  if (!normalized.path.endsWith('.rmt')) {
+    return {
+      ok: false,
+      errors: [`RMT App Platform source "${normalized.path}" must be a .rmt document.`]
+    };
+  }
+  const sourcePath = normalized.path;
+  const sourceDir = path.posix.dirname(sourcePath);
+  const baseName = path.posix.basename(sourcePath, '.rmt');
+  const outputDir = input.outputDir || input['output-dir'] || (sourceDir === '.' ? '.xtend-build' : `${sourceDir}/.xtend-build`);
+  return {
+    ok: true,
+    errors: [],
+    sourcePath,
+    sourceDir,
+    baseName,
+    reportPath: input.report || `${outputDir}/${baseName}.app-platform-build.json`,
+    diagnosticsPath: input.diagnostics || `${outputDir}/${baseName}.app-platform-diagnostics.json`,
+    sourceMapPath: input.sourceMap || input['source-map'] || `${outputDir}/${baseName}.app-platform-source-map.json`
+  };
+}
+
+function createOutputs(paths, analysis, scaffoldPlan, report) {
+  return [
+    {
+      id: 'diagnostics',
+      path: paths.diagnosticsPath,
+      kind: 'rmt-app-platform-diagnostics',
+      generated: true,
+      content: stableJson(analysis)
+    },
+    {
+      id: 'source-map',
+      path: paths.sourceMapPath,
+      kind: 'rmt-app-platform-source-map',
+      generated: true,
+      content: stableJson(analysis.sourceMap)
+    },
+    {
+      id: 'scaffold-plan',
+      path: paths.reportPath,
+      kind: 'rmt-app-platform-build-report',
+      generated: true,
+      content: stableJson(report)
+    }
+  ];
+}
+
+function summarizeOutput(output) {
+  return {
+    id: output.id,
+    path: output.path,
+    kind: output.kind,
+    generated: output.generated
+  };
+}
+
+function createRmtAppPlatformBuild(input = {}, options = {}) {
+  const rootDir = path.resolve(options.rootDir || input.rootDir || input['root-dir'] || process.cwd());
+  const write = toBoolean(input.write);
+  const check = toBoolean(input.check);
+  const paths = resolveBuildPaths(input);
+  if (!paths.ok) {
+    return {
+      schema: RMT_APP_PLATFORM_BUILD_SCHEMA,
+      ok: false,
+      status: 'invalid_input',
+      mode: write ? 'write' : (check ? 'check' : 'dry-run'),
+      errors: paths.errors,
+      outputs: []
+    };
+  }
+
+  const absoluteSourcePath = path.resolve(rootDir, paths.sourcePath);
+  if (!fs.existsSync(absoluteSourcePath)) {
+    return {
+      schema: RMT_APP_PLATFORM_BUILD_SCHEMA,
+      ok: false,
+      status: 'source_missing',
+      mode: write ? 'write' : (check ? 'check' : 'dry-run'),
+      source: paths.sourcePath,
+      errors: [`RMT App Platform source "${paths.sourcePath}" does not exist.`],
+      outputs: []
+    };
+  }
+
+  const text = fs.readFileSync(absoluteSourcePath, 'utf8');
+  const analysis = analyzeRmtAppPlatformSource({
+    text,
+    filePath: absoluteSourcePath,
+    source: paths.sourcePath,
+    version: 1
+  }, {
+    rootDir
+  });
+  const scaffoldPlan = createRmtAppPlatformScaffoldPlan({
+    text,
+    filePath: absoluteSourcePath,
+    source: paths.sourcePath,
+    version: 1
+  }, {
+    rootDir
+  });
+  const report = {
+    schema: RMT_APP_PLATFORM_BUILD_REPORT_SCHEMA,
+    buildSchema: RMT_APP_PLATFORM_BUILD_SCHEMA,
+    scaffoldSchema: RMT_APP_PLATFORM_SCAFFOLD_SCHEMA,
+    status: analysis.ok ? 'planned' : 'blocked',
+    ok: analysis.ok,
+    source: paths.sourcePath,
+    localGate: DEFAULT_LOCAL_GATE,
+    generated: {
+      diagnostics: paths.diagnosticsPath,
+      sourceMap: paths.sourceMapPath,
+      report: paths.reportPath
+    },
+    diagnosticSummary: analysis.summary,
+    sourceMapSummary: {
+      totalCount: analysis.sourceMap.totalCount,
+      byDomain: analysis.sourceMap.byDomain
+    },
+    checks: scaffoldPlan.report.checks,
+    boundaries: [
+      'diagnostics-before-runtime',
+      'source-map-before-browser-smoke',
+      'no-product-local-registry-repaint',
+      'no-manual-shell-html-sinks',
+      'no-rmt-kernel-import-of-xtend-types'
+    ]
+  };
+  const outputs = createOutputs(paths, analysis, scaffoldPlan, report);
+  const writeReport = writeScaffoldFiles(outputs, {
+    rootDir,
+    write,
+    check,
+    force: toBoolean(input.force),
+    generator: 'rmt-app-platform',
+    owner: `rmt-app-platform:${paths.baseName}`,
+    allowedRoots: [
+      '.xtend-build/',
+      `${paths.sourceDir}/.xtend-build/`,
+      'tests/fixtures/.xtend-build/',
+      paths.reportPath,
+      paths.diagnosticsPath,
+      paths.sourceMapPath
+    ]
+  });
+
+  if (!writeReport.ok) {
+    return {
+      schema: RMT_APP_PLATFORM_BUILD_SCHEMA,
+      ok: false,
+      status: writeReport.status,
+      mode: write ? 'write' : (check ? 'check' : 'dry-run'),
+      source: paths.sourcePath,
+      errors: writeReport.errors,
+      diagnostics: analysis.diagnostics,
+      sourceMap: analysis.sourceMap,
+      outputs: outputs.map(summarizeOutput),
+      writePlan: writeReport.plan,
+      written: writeReport.writes,
+      ownershipManifest: writeReport.ownershipManifest
+    };
+  }
+
+  return {
+    schema: RMT_APP_PLATFORM_BUILD_SCHEMA,
+    reportSchema: RMT_APP_PLATFORM_BUILD_REPORT_SCHEMA,
+    scaffoldSchema: RMT_APP_PLATFORM_SCAFFOLD_SCHEMA,
+    ok: analysis.ok,
+    status: write ? writeReport.status : (check ? writeReport.status : report.status),
+    mode: write ? 'write' : (check ? 'check' : 'dry-run'),
+    source: paths.sourcePath,
+    localGate: DEFAULT_LOCAL_GATE,
+    report,
+    diagnostics: analysis.diagnostics,
+    sourceMap: analysis.sourceMap,
+    outputs: outputs.map((output) => ({
+      ...summarizeOutput(output),
+      content: output.content
+    })),
+    writePlan: writeReport.plan,
+    written: writeReport.writes,
+    ownershipManifest: writeReport.ownershipManifest
+  };
+}
+
+module.exports = {
+  DEFAULT_LOCAL_GATE,
+  DEFAULT_SOURCE_PATH,
+  RMT_APP_PLATFORM_BUILD_REPORT_SCHEMA,
+  RMT_APP_PLATFORM_BUILD_SCHEMA,
+  createRmtAppPlatformBuild,
+  resolveBuildPaths
+};

package/xtend-builder/generators/rmt-lifecycle-demo.js

@@ -27,8 +27,8 @@ const SOURCE_PATH = 'xtendrmt/rmt-lifecycle-demo.rmt';
 const CORE_PATH = 'xtendrmt/rmt-lifecycle-demo.core.json';
 const SCAFFOLD_REPORT_PATH = 'xtendrmt/rmt-lifecycle-demo.scaffold.json';
 const APP_PATH = 'xtendrmt/rmt-lifecycle-demo.app.js';
-const HOST_PATH = 'xtendrmt-rmt-lifecycle-demo.html';
 const BROWSER_SMOKE_PATH = 'tests/browser/fixtures/rmt-lifecycle-demo-smoke.html';
+const HOST_PATH = BROWSER_SMOKE_PATH;
 const GENERATED_COMPONENT_TAG = 'x-rmt-lifecycle-demo';
 const GENERATED_COMPONENT_PATH = 'components/x-rmt-lifecycle-demo.js';
 const BUILD_COMMAND = 'node xtend-builder/scaffold.js rmt-lifecycle-demo --write --json';
@@ -37,8 +37,7 @@ const RMT_LIFECYCLE_ALLOWED_WRITE_ROOTS = Object.freeze([
   '.xtend-build/',
   'components/',
   'xtendrmt/',
-  'tests/browser/fixtures/',
-  HOST_PATH
+  'tests/browser/fixtures/'
 ]);
 
 function toBoolean(value) {
@@ -729,7 +728,7 @@ function createBuildReport(input) {
       'compiler-emits-deterministic-core-json',
       'scaffold-writes-generated-xtend-component',
       'scaffold-writes-generated-demo-app',
-      'host-loads-over-http-dev-server',
+      'browser-smoke-loads-over-http-dev-server',
       'browser-smoke-renders-generated-app'
     ],
     boundaries: [
@@ -831,13 +830,6 @@ function createRmtLifecycleDemoBuild(input = {}, options = {}) {
       generated: true,
       content: appModule
     },
-    {
-      id: 'host',
-      path: HOST_PATH,
-      kind: 'http-host',
-      generated: true,
-      content: renderHostHtml()
-    },
     {
       id: 'browser-smoke',
       path: BROWSER_SMOKE_PATH,

package/xtend-builder/lib/cli.js

@@ -138,6 +138,7 @@ function buildHelpText() {
     '  node xtend-builder/scaffold.js extensions --tag x-example --profile display --json',
     '  node xtend-builder/scaffold.js rmt-lifecycle-demo --write --json',
     '  node xtend-builder/scaffold.js rmt-build --source xtendrmt/rmt-lifecycle-demo.rmt --write --json',
+    '  node xtend-builder/scaffold.js rmt-app-platform --source tests/fixtures/rmt-surface-resource-graph-runtime.rmt --write --json',
     '  node xtend-builder/scaffold.js workflow --json',
     '  node xtend-builder/scaffold.js verify --json',
     '  npm run scaffold -- layout',
@@ -160,6 +161,7 @@ function buildHelpText() {
     '  extensions Create the dry-run templating, rendering and root-lifecycle extension contract.',
     '  rmt-lifecycle-demo Compile the vNext RMT lifecycle template and build the generated demo app.',
     '  rmt-build Compile an RMT vNext template into XTend app build artifacts.',
+    '  rmt-app-platform Build App Platform diagnostics, source maps and scaffold reports.',
     '  workflow  Print the local dry-run developer workflow.',
     '  verify    Print the local scaffold verification plan.',
     '  validate  Alias for verify.',
@@ -185,6 +187,7 @@ function buildConfigSummary() {
     typing: config.typing,
     preview: config.preview,
     rmtAppBuild: config.rmtAppBuild,
+    rmtAppPlatformTooling: config.rmtAppPlatformTooling,
     rmtCompatibility: config.rmtCompatibility,
     extensions: config.extensions,
     workflows: config.workflows,
@@ -472,6 +475,40 @@ function runCli(args = process.argv.slice(2), io = {}) {
     return 0;
   }
 
+  if (command === 'rmt-app-platform') {
+    const result = runGenerator('rmt-app-platform', parseFlagArgs(options.rest));
+    if (!result.ok) {
+      if (options.json) {
+        writeLine(stdout, JSON.stringify(result, null, 2));
+      } else {
+        result.diagnostics && result.diagnostics.length
+          ? result.diagnostics.forEach((diagnostic) => writeLine(stderr, `${diagnostic.severity.toUpperCase()} ${diagnostic.code}: ${diagnostic.message}`))
+          : (result.errors || []).forEach((error) => writeLine(stderr, error));
+      }
+      return 1;
+    }
+
+    if (options.json) {
+      writeLine(stdout, JSON.stringify({
+        ...result,
+        outputs: result.outputs.map((output) => ({
+          id: output.id,
+          path: output.path,
+          kind: output.kind,
+          generated: output.generated
+        }))
+      }, null, 2));
+      return 0;
+    }
+
+    writeLine(stdout, `XTend-Scaffold RMT App Platform: ${result.status}`);
+    writeLine(stdout, '');
+    result.outputs.forEach((output) => {
+      writeLine(stdout, `${output.id.padEnd(20)} ${output.path}`);
+    });
+    return 0;
+  }
+
   if (command === 'workflow') {
     const workflow = createDeveloperWorkflow(parseFlagArgs(options.rest));
     if (options.json) {
@@ -515,6 +552,7 @@ function runCli(args = process.argv.slice(2), io = {}) {
         '  xt rmt lint app.rmt',
         '  xt rmt lint app.rmt --json',
         '  xt rmt lint tests/fixtures --fail-on warning',
+        '  xt rmt lint app.rmt --format problem-matcher',
         '',
         'Commands:',
         '  lint  Run the native RMT linter.'

package/xtend-builder/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ccslabs/xtend-cli",
-  "version": "0.1.0-rc.1",
+  "version": "0.1.2",
   "private": false,
   "description": "XTend scaffold, builder and component authoring CLI.",
   "license": "Apache-2.0",
@@ -68,8 +68,8 @@
     "./package.json": "./package.json"
   },
   "peerDependencies": {
-    "@ccslabs/xtend": "0.1.0-rc.1",
-    "@ccslabs/xtend-compiler": "0.1.0-rc.1"
+    "@ccslabs/xtend": "0.1.2",
+    "@ccslabs/xtend-compiler": "0.1.2"
   },
   "peerDependenciesMeta": {
     "@ccslabs/xtend": {

package/xtend-builder/scaffold.config.js

@@ -78,6 +78,7 @@ module.exports = {
     componentA11y: "xtend-builder/a11y/component-a11y-profile.js",
     componentPerformance: "xtend-builder/performance/component-performance-profile.js",
     rmtBuild: "xtend-builder/generators/rmt-build.js",
+    rmtAppPlatform: "xtend-builder/generators/rmt-app-platform.js",
     mode: "plan-dry-run-render-type-preview-extension-and-write-plan-contract",
     defaultCommand: "component-plan",
     fileOutputMode: "dry-run-render-or-write-with-feature-type-preview-extension-ownership-manifest-patch-and-build-report"
@@ -98,6 +99,32 @@ module.exports = {
     httpServerCompatible: true,
     networkPolicy: "repo-local-assets-only"
   },
+  rmtAppPlatformTooling: {
+    schema: "xtend.epic18.rmt-app-platform-tooling.v1",
+    reportSchema: "xtend.epic18.rmt-app-platform-tooling-report.v1",
+    scaffoldSchema: "xtend.epic18.rmt-app-platform-scaffold.v1",
+    sourceMapSchema: "xtend.epic18.rmt-app-platform-source-map.v1",
+    generator: "xtend-builder/generators/rmt-app-platform.js",
+    sourcePattern: "tests/fixtures/*.rmt",
+    outputMode: "diagnostics-source-map-and-scaffold-report",
+    buildCommand: "node xtend-builder/scaffold.js rmt-app-platform --source tests/fixtures/rmt-surface-resource-graph-runtime.rmt --write --json",
+    checkCommand: "node xtend-builder/scaffold.js rmt-app-platform --source tests/fixtures/rmt-surface-resource-graph-runtime.rmt --check --json",
+    localGate: "node scripts/run_xtend_tests.js rmt-app-platform-tooling --json",
+    diagnostics: [
+      "no-manual-shell-html-sinks",
+      "unsafe-html-boundaries",
+      "unkeyed-repeat",
+      "untyped-events",
+      "missing-resource-ownership",
+      "portal-and-resource-references"
+    ],
+    lsp: [
+      "completion",
+      "hover",
+      "diagnostics"
+    ],
+    networkPolicy: "repo-local-assets-only"
+  },
   a11y: {
     schema: "xtend.scaffold.a11y-profile-plan.v1",
     module: "xtend-builder/a11y/component-a11y-profile.js",
@@ -755,7 +782,7 @@ module.exports = {
     suite: "tests/rmt/surface_manager_workbench_fixture_suite.js",
     docs: "docs/surface-manager-workbench-fixture.md",
     fixture: "xtendrmt/surface-workbench.rmt",
-    host: "xtendrmt-surface-workbench.html",
+    host: "tests/browser/fixtures/rmt-surface-workbench-smoke.html",
     runtime: "xtendrmt/surface-workbench.js",
     browserSmoke: "tests/browser/fixtures/rmt-surface-workbench-smoke.html",
     status: "accepted-rmt-first-workbench-fixture",
@@ -1459,7 +1486,7 @@ module.exports = {
     packageDryRunArtifact: ".xtend-test-results/xtend-pack-dry-run.json",
     packageExportSurfaceArtifact: ".xtend-test-results/xtend-package-export-surface-lock.json",
     packageExportLockReportArtifact: ".xtend-test-results/xtend-package-export-lock-report.json",
-    expectedExportCount: 115,
+    expectedExportCount: 124,
     localGateRequiresNpmPackExecution: false,
     artifactRequiredForRc1: true,
     nextWorkpackage: "WP-E13-13",

package/xtend.css

@@ -147,11 +147,58 @@ body[data-xt-ui-effects-state="ready"] {
   }
 }
 
+:where(
+  x-header,
+  x-hero,
+  x-router,
+  x-footer,
+  x-section,
+  x-cards,
+  x-masonry,
+  x-player,
+  x-lightbox,
+  x-side-panel,
+  x-surface-manager,
+  x-surface-window,
+  xtend-doc-page
+) {
+  display: block;
+  box-sizing: border-box;
+  min-width: 0;
+  max-width: 100%;
+}
+
+[data-xtend-layout-reserve] {
+  display: block;
+  box-sizing: border-box;
+  min-width: 0;
+  min-block-size: var(--xtend-layout-reserved-block-size, var(--xtend-skeleton-min-height, auto));
+}
+
+[data-xtend-layout-reserve~="inline"] {
+  display: inline-block;
+  vertical-align: middle;
+}
+
+[data-xtend-layout-reserve~="media"] {
+  aspect-ratio: var(--xtend-layout-aspect-ratio, auto);
+}
+
+[data-xtend-layout-reserve~="lazy"] {
+  content-visibility: auto;
+  contain-intrinsic-size: auto var(--xtend-layout-reserved-block-size, 24rem);
+}
+
+[data-xtend-layout-reserve][data-xtend-hydrating],
+[data-xtend-layout-reserve][data-xtend-skeleton-active="true"] {
+  transition-property: opacity, transform, color, background-color, border-color, box-shadow !important;
+}
+
 [data-xtend-skeleton]:not(:defined) {
   display: block;
   position: relative;
   min-width: 0;
-  min-height: var(--xtend-skeleton-min-height, 4rem);
+  min-height: var(--xtend-layout-reserved-block-size, var(--xtend-skeleton-min-height, 4rem));
   overflow: hidden;
   contain: layout paint;
   pointer-events: none;
@@ -175,7 +222,7 @@ body[data-xt-ui-effects-state="ready"] {
 [data-xtend-skeleton="inline"]:not(:defined) {
   display: inline-block;
   min-width: var(--xtend-skeleton-width, 7rem);
-  min-height: var(--xtend-skeleton-min-height, 2.25rem);
+  min-height: var(--xtend-layout-reserved-block-size, var(--xtend-skeleton-min-height, 2.25rem));
   vertical-align: middle;
 }
 

package/xtendrmt/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ccslabs/xtend-rmt",
-  "version": "0.1.0-rc.1",
+  "version": "0.1.2",
   "private": false,
   "description": "XTendRMT scheduler runtime and browser bridge.",
   "license": "Apache-2.0",
@@ -25,6 +25,22 @@
     "rmt-core.esm.js",
     "rmt-runtime.esm.js",
     "rmt-runtime.browser.js",
+    "rmt-dom-descriptor-renderer.d.ts",
+    "rmt-dom-descriptor-renderer.js",
+    "rmt-component-capability-registry.d.ts",
+    "rmt-component-capability-registry.js",
+    "rmt-state-selector-runtime.d.ts",
+    "rmt-state-selector-runtime.js",
+    "rmt-action-effect-runtime.d.ts",
+    "rmt-action-effect-runtime.js",
+    "rmt-event-routing-runtime.d.ts",
+    "rmt-event-routing-runtime.js",
+    "rmt-surface-resource-graph-runtime.d.ts",
+    "rmt-surface-resource-graph-runtime.js",
+    "rmt-native-shell-runtime.d.ts",
+    "rmt-native-shell-runtime.js",
+    "rmt-node-ssr-adapter.d.ts",
+    "rmt-node-ssr-adapter.js",
     "rmt.schema.json",
     "rmt-manifest.json",
     "package.json"
@@ -49,6 +65,38 @@
       "browser": "./rmt-runtime.browser.js",
       "default": "./rmt-runtime.browser.js"
     },
+    "./dom-descriptor-renderer": {
+      "types": "./rmt-dom-descriptor-renderer.d.ts",
+      "default": "./rmt-dom-descriptor-renderer.js"
+    },
+    "./component-capability-registry": {
+      "types": "./rmt-component-capability-registry.d.ts",
+      "default": "./rmt-component-capability-registry.js"
+    },
+    "./state-selector-runtime": {
+      "types": "./rmt-state-selector-runtime.d.ts",
+      "default": "./rmt-state-selector-runtime.js"
+    },
+    "./action-effect-runtime": {
+      "types": "./rmt-action-effect-runtime.d.ts",
+      "default": "./rmt-action-effect-runtime.js"
+    },
+    "./event-routing-runtime": {
+      "types": "./rmt-event-routing-runtime.d.ts",
+      "default": "./rmt-event-routing-runtime.js"
+    },
+    "./surface-resource-graph-runtime": {
+      "types": "./rmt-surface-resource-graph-runtime.d.ts",
+      "default": "./rmt-surface-resource-graph-runtime.js"
+    },
+    "./native-shell-runtime": {
+      "types": "./rmt-native-shell-runtime.d.ts",
+      "default": "./rmt-native-shell-runtime.js"
+    },
+    "./node-ssr-adapter": {
+      "types": "./rmt-node-ssr-adapter.d.ts",
+      "default": "./rmt-node-ssr-adapter.js"
+    },
     "./schema": "./rmt.schema.json",
     "./manifest": "./rmt-manifest.json",
     "./package.json": "./package.json"