@react-native-windows/automation-commands 0.0.0-canary.1016

package/README.md

@@ -0,0 +1,31 @@
+# @react-native-windows/automation-commands
+
+`@react-native-windows/automation-commands` provides built-in commands that may
+be used with `@react-native-windows/automation-channel` to make it easier to
+test your application.
+
+**This package is a work in progress**
+
+## Adding to your application
+
+**TBD**
+
+## Commands
+
+### dumpVisualTree
+
+The `dumpVisualTree` command creates a JSON object corresponding to the XAML
+tree under a given testID. This can be used in conjunction with snapshot
+testing to validate that your native UI looks how you could expect.
+
+```ts
+import {dumpVisualTree} from '@react-native-windows/automation-commands';
+
+test('Widget', async () => {
+  const dump = await dumpVisualTree('widget-test-id');
+  expect(dump).toMatchSnapshot();
+});
+```
+
+#### Options
+**TBD**

package/lib-commonjs/dumpVisualTree.d.ts

@@ -0,0 +1,73 @@
+/**
+ * Copyright (c) Microsoft Corporation.
+ * Licensed under the MIT License.
+ *
+ * @format
+ */
+import { AutomationClient } from '@react-native-windows/automation-channel';
+/**
+ * Schema of tree dumped node
+ */
+export type UIElement = {
+    XamlType: string;
+    Foreground?: string | null;
+    Background?: string | null;
+    Padding?: string | null;
+    Margin?: string | null;
+    RenderSize?: number[] | null;
+    Visibility?: 'Collapsed' | 'Visible' | null;
+    CornerRadius?: string | null;
+    BorderThickness?: string | null;
+    Width?: number | null;
+    Height?: number | null;
+    BorderBrush?: string | null;
+    VerticalAlignment?: string | null;
+    HorizontalAlignment?: string | null;
+    Clip?: string | null;
+    FlowDirection?: string | null;
+    Name?: string | null;
+    Text?: string | null;
+    children?: UIElement[];
+    [index: string]: unknown;
+};
+export type AutomationNode = {
+    AutomationId?: string;
+    ControlType?: number;
+    LocalizedControlType?: string;
+    __Children?: [AutomationNode];
+};
+export type ComponentNode = {
+    Type: string;
+    _Props?: {
+        TestId?: string;
+        Sources?: [{
+            Uri?: string;
+        }];
+    };
+    __Children?: [ComponentNode];
+};
+export type VisualNode = {
+    Comment?: string;
+    Offset?: `${number} ${number} ${number}`;
+    Size?: `${number} ${number}`;
+    'Visual Type'?: string;
+    __Children?: [VisualNode];
+};
+export type VisualTree = {
+    'Automation Tree': AutomationNode;
+    'Component Tree': ComponentNode;
+    'Visual Tree': VisualNode;
+};
+declare global {
+    const automationClient: AutomationClient | undefined;
+}
+/**
+ * Dump a section of the native visual tree.
+ */
+export default function dumpVisualTree(accessibilityId: string, opts?: {
+    pruneCollapsed?: boolean;
+    deterministicOnly?: boolean;
+    removeDefaultProps?: boolean;
+    removeGuidsFromImageSources?: boolean;
+    additionalProperties?: string[];
+}): Promise<UIElement | VisualTree>;

package/lib-commonjs/dumpVisualTree.js

@@ -0,0 +1,124 @@
+"use strict";
+/**
+ * Copyright (c) Microsoft Corporation.
+ * Licensed under the MIT License.
+ *
+ * @format
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+/**
+ * Dump a section of the native visual tree.
+ */
+async function dumpVisualTree(accessibilityId, opts) {
+    if (!automationClient) {
+        throw new Error('RPC client is not enabled');
+    }
+    const dumpResponse = await automationClient.invoke('DumpVisualTree', {
+        accessibilityId,
+        ...opts,
+    });
+    if (dumpResponse.type === 'error') {
+        throw new Error(dumpResponse.message);
+    }
+    const element = dumpResponse.result;
+    if ('XamlType' in element && (opts === null || opts === void 0 ? void 0 : opts.pruneCollapsed) !== false) {
+        pruneCollapsedElements(element);
+    }
+    if ('XamlType' in element && (opts === null || opts === void 0 ? void 0 : opts.deterministicOnly) !== false) {
+        removeNonDeterministicProps(element);
+    }
+    if ('XamlType' in element && (opts === null || opts === void 0 ? void 0 : opts.removeDefaultProps) !== false) {
+        removeDefaultProps(element);
+    }
+    if (!('XamlType' in element) && (opts === null || opts === void 0 ? void 0 : opts.removeGuidsFromImageSources) !== false) {
+        removeGuidsFromImageSources(element);
+    }
+    return element;
+}
+exports.default = dumpVisualTree;
+function removeGuidsFromImageSourcesHelper(node) {
+    if (node._Props && node._Props.Sources) {
+        node._Props.Sources.forEach((source) => {
+            if (source.Uri) {
+                if (source.Uri.startsWith('blob:')) {
+                    source.Uri = source.Uri.replace(/blob:[a-f0-9]+-[a-f0-9]+-[a-f0-9]+-[a-f0-9]+-[a-f0-9]+/, 'blob:<some_guid_here>');
+                    source.Uri = source.Uri.replace(/size=\d{5}/, 'size=<size>');
+                }
+                else if (source.Uri.startsWith('https://www.facebook.com/assets/fb_lite_messaging/E2EE-settings@3x.png?r=1&t=')) {
+                    source.Uri =
+                        'https://www.facebook.com/assets/fb_lite_messaging/E2EE-settings@3x.png?r=1&t=<some_hash_here>';
+                }
+                else if (source.Uri.startsWith('https://www.facebook.com/ar_effect/external_textures/648609739826677.png?hash=')) {
+                    source.Uri =
+                        'https://www.facebook.com/ar_effect/external_textures/648609739826677.png?hash=<some_hash_here>';
+                }
+                else if (source.Uri.startsWith('https://www.facebook.com/ads/pics/successstories.png?hash=')) {
+                    source.Uri =
+                        'https://www.facebook.com/ads/pics/successstories.png?hash=<some_hash_here>';
+                }
+                else {
+                    // When getting files from a prebuilt bundle the uri is going to include a local path, which would make snapshots inconsistent,
+                    // This logic replaces the local path so that we get consistent results.
+                    // file://E:\\repos\\react-native-windows\\packages\\e2e-test-app-fabric\\windows\\RNTesterApp-Fabric.Package\\bin\\x64\\Release\\AppX\\RNTesterApp-Fabric\\Bundle\\@react-native-windows/tester/js/assets/uie_thumb_normal@2x.png
+                    // becomes
+                    // <localOrBundlerUri>@react-native-windows/tester/js/assets/uie_thumb_normal@2x.png
+                    const packagesPath = require('path')
+                        .resolve(__dirname, '../../..')
+                        .replace(/\\/g, '\\\\');
+                    source.Uri = source.Uri.replace(new RegExp(`file://${packagesPath}.*\\\\Bundle\\\\assets/_+`), '<localOrBundlerUri>');
+                    // When loading the bundle from metro local paths will be replaced with paths to localhost, which will not align with snapshots made with prebuilt bundles.
+                    // This logic replaces the localhost uri, with the same uri that we would have gotten from a prebuild bundle.  This makes it easier to debug without breaking snapshots
+                    // http://localhost:8081/assets/@@/@react-native-windows/tester/js/assets/uie_thumb_normal@2x.png?platform=windows&hash=c6f5aec4d9e0aa47c0887e4266796224
+                    // becomes
+                    // "<localOrBundlerUri>@react-native-windows/tester/js/assets/uie_thumb_normal@2x.png"
+                    source.Uri = source.Uri.replace(/http:\/\/localhost:8081\/assets\/(@@\/)+/, '<localOrBundlerUri>');
+                    source.Uri = source.Uri.replace(/\?platform=windows&hash=[^=]$/, '');
+                }
+            }
+        });
+    }
+    if (node.__Children) {
+        node.__Children.forEach((child) => removeGuidsFromImageSourcesHelper(child));
+    }
+}
+function removeGuidsFromImageSources(visualTree) {
+    removeGuidsFromImageSourcesHelper(visualTree['Component Tree']);
+}
+/**
+ * Removes trees of XAML that are not visible.
+ */
+function pruneCollapsedElements(element) {
+    if (!element.children) {
+        return;
+    }
+    element.children = element.children.filter(child => child.Visibility !== 'Collapsed');
+    element.children.forEach(pruneCollapsedElements);
+}
+/**
+ * Removes trees of properties that are not deterministic
+ */
+function removeNonDeterministicProps(element) {
+    if (element.RenderSize) {
+        // RenderSize is subject to rounding, etc and should mostly be derived from
+        // other deterministic properties in the tree.
+        delete element.RenderSize;
+    }
+    if (element.children) {
+        element.children.forEach(removeNonDeterministicProps);
+    }
+}
+/**
+ * Removes noise from snapshot by removing properties with the default value
+ */
+function removeDefaultProps(element) {
+    const defaultValues = [['Tooltip', null]];
+    defaultValues.forEach(([propname, defaultValue]) => {
+        if (element[propname] === defaultValue) {
+            delete element[propname];
+        }
+    });
+    if (element.children) {
+        element.children.forEach(removeDefaultProps);
+    }
+}
+//# sourceMappingURL=dumpVisualTree.js.map

package/lib-commonjs/dumpVisualTree.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dumpVisualTree.js","sourceRoot":"","sources":["../src/dumpVisualTree.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Copyright (c) Microsoft Corporation.\n * Licensed under the MIT License.\n *\n * @format\n */\n\nimport {AutomationClient} from '@react-native-windows/automation-channel';\n\n/**\n * Schema of tree dumped node\n */\nexport type UIElement = {\n  XamlType: string;\n  Foreground?: string | null;\n  Background?: string | null;\n  Padding?: string | null;\n  Margin?: string | null;\n  RenderSize?: number[] | null;\n  Visibility?: 'Collapsed' | 'Visible' | null;\n  CornerRadius?: string | null;\n  BorderThickness?: string | null;\n  Width?: number | null;\n  Height?: number | null;\n  BorderBrush?: string | null;\n  VerticalAlignment?: string | null;\n  HorizontalAlignment?: string | null;\n  Clip?: string | null;\n  FlowDirection?: string | null;\n  Name?: string | null;\n  Text?: string | null;\n  children?: UIElement[];\n  [index: string]: unknown;\n};\n\nexport type AutomationNode = {\n  AutomationId?: string;\n  ControlType?: number;\n  LocalizedControlType?: string;\n  __Children?: [AutomationNode];\n};\n\nexport type ComponentNode = {\n  Type: string;\n  _Props?: {\n    TestId?: string;\n    Sources?: [{Uri?: string}];\n  };\n  __Children?: [ComponentNode];\n};\n\nexport type VisualNode = {\n  Comment?: string;\n  Offset?: `${number} ${number} ${number}`;\n  Size?: `${number} ${number}`;\n  'Visual Type'?: string;\n  __Children?: [VisualNode];\n};\n\nexport type VisualTree = {\n  'Automation Tree': AutomationNode;\n  'Component Tree': ComponentNode;\n  'Visual Tree': VisualNode;\n};\n\ndeclare global {\n  const automationClient: AutomationClient | undefined;\n}\n\n/**\n * Dump a section of the native visual tree.\n */\nexport default async function dumpVisualTree(\n  accessibilityId: string,\n  opts?: {\n    pruneCollapsed?: boolean;\n    deterministicOnly?: boolean;\n    removeDefaultProps?: boolean;\n    removeGuidsFromImageSources?: boolean;\n    additionalProperties?: string[];\n  },\n): Promise<UIElement | VisualTree> {\n  if (!automationClient) {\n    throw new Error('RPC client is not enabled');\n  }\n\n  const dumpResponse = await automationClient.invoke('DumpVisualTree', {\n    accessibilityId,\n    ...opts,\n  });\n\n  if (dumpResponse.type === 'error') {\n    throw new Error(dumpResponse.message);\n  }\n\n  const element: UIElement | VisualTree = dumpResponse.result;\n\n  if ('XamlType' in element && opts?.pruneCollapsed !== false) {\n    pruneCollapsedElements(element);\n  }\n\n  if ('XamlType' in element && opts?.deterministicOnly !== false) {\n    removeNonDeterministicProps(element);\n  }\n\n  if ('XamlType' in element && opts?.removeDefaultProps !== false) {\n    removeDefaultProps(element);\n  }\n\n  if (!('XamlType' in element) && opts?.removeGuidsFromImageSources !== false) {\n    removeGuidsFromImageSources(element);\n  }\n\n  return element;\n}\n\nfunction removeGuidsFromImageSourcesHelper(node: ComponentNode) {\n  if (node._Props && node._Props.Sources) {\n    node._Props.Sources.forEach((source: any) => {\n      if (source.Uri) {\n        if (source.Uri.startsWith('blob:')) {\n          source.Uri = source.Uri.replace(\n            /blob:[a-f0-9]+-[a-f0-9]+-[a-f0-9]+-[a-f0-9]+-[a-f0-9]+/,\n            'blob:<some_guid_here>',\n          );\n          source.Uri = source.Uri.replace(/size=\\d{5}/, 'size=<size>');\n        } else if (\n          source.Uri.startsWith(\n            'https://www.facebook.com/assets/fb_lite_messaging/E2EE-settings@3x.png?r=1&t=',\n          )\n        ) {\n          source.Uri =\n            'https://www.facebook.com/assets/fb_lite_messaging/E2EE-settings@3x.png?r=1&t=<some_hash_here>';\n        } else if (\n          source.Uri.startsWith(\n            'https://www.facebook.com/ar_effect/external_textures/648609739826677.png?hash=',\n          )\n        ) {\n          source.Uri =\n            'https://www.facebook.com/ar_effect/external_textures/648609739826677.png?hash=<some_hash_here>';\n        } else if (\n          source.Uri.startsWith(\n            'https://www.facebook.com/ads/pics/successstories.png?hash=',\n          )\n        ) {\n          source.Uri =\n            'https://www.facebook.com/ads/pics/successstories.png?hash=<some_hash_here>';\n        } else {\n          // When getting files from a prebuilt bundle the uri is going to include a local path, which would make snapshots inconsistent,\n          // This logic replaces the local path so that we get consistent results.\n          // file://E:\\\\repos\\\\react-native-windows\\\\packages\\\\e2e-test-app-fabric\\\\windows\\\\RNTesterApp-Fabric.Package\\\\bin\\\\x64\\\\Release\\\\AppX\\\\RNTesterApp-Fabric\\\\Bundle\\\\@react-native-windows/tester/js/assets/uie_thumb_normal@2x.png\n          // becomes\n          // <localOrBundlerUri>@react-native-windows/tester/js/assets/uie_thumb_normal@2x.png\n          const packagesPath = require('path')\n            .resolve(__dirname, '../../..')\n            .replace(/\\\\/g, '\\\\\\\\');\n          source.Uri = source.Uri.replace(\n            new RegExp(`file://${packagesPath}.*\\\\\\\\Bundle\\\\\\\\assets/_+`),\n            '<localOrBundlerUri>',\n          );\n\n          // When loading the bundle from metro local paths will be replaced with paths to localhost, which will not align with snapshots made with prebuilt bundles.\n          // This logic replaces the localhost uri, with the same uri that we would have gotten from a prebuild bundle.  This makes it easier to debug without breaking snapshots\n          // http://localhost:8081/assets/@@/@react-native-windows/tester/js/assets/uie_thumb_normal@2x.png?platform=windows&hash=c6f5aec4d9e0aa47c0887e4266796224\n          // becomes\n          // \"<localOrBundlerUri>@react-native-windows/tester/js/assets/uie_thumb_normal@2x.png\"\n          source.Uri = source.Uri.replace(\n            /http:\\/\\/localhost:8081\\/assets\\/(@@\\/)+/,\n            '<localOrBundlerUri>',\n          );\n          source.Uri = source.Uri.replace(/\\?platform=windows&hash=[^=]$/, '');\n        }\n      }\n    });\n  }\n  if (node.__Children) {\n    node.__Children.forEach((child: any) =>\n      removeGuidsFromImageSourcesHelper(child),\n    );\n  }\n}\n\nfunction removeGuidsFromImageSources(visualTree: VisualTree) {\n  removeGuidsFromImageSourcesHelper(visualTree['Component Tree']);\n}\n\n/**\n * Removes trees of XAML that are not visible.\n */\nfunction pruneCollapsedElements(element: UIElement) {\n  if (!element.children) {\n    return;\n  }\n\n  element.children = element.children.filter(\n    child => child.Visibility !== 'Collapsed',\n  );\n\n  element.children.forEach(pruneCollapsedElements);\n}\n\n/**\n * Removes trees of properties that are not deterministic\n */\nfunction removeNonDeterministicProps(element: UIElement) {\n  if (element.RenderSize) {\n    // RenderSize is subject to rounding, etc and should mostly be derived from\n    // other deterministic properties in the tree.\n    delete element.RenderSize;\n  }\n\n  if (element.children) {\n    element.children.forEach(removeNonDeterministicProps);\n  }\n}\n\n/**\n * Removes noise from snapshot by removing properties with the default value\n */\nfunction removeDefaultProps(element: UIElement) {\n  const defaultValues: [string, unknown][] = [['Tooltip', null]];\n\n  defaultValues.forEach(([propname, defaultValue]) => {\n    if (element[propname] === defaultValue) {\n      delete element[propname];\n    }\n  });\n\n  if (element.children) {\n    element.children.forEach(removeDefaultProps);\n  }\n}\n"]}

package/lib-commonjs/index.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Copyright (c) Microsoft Corporation.
+ * Licensed under the MIT License.
+ *
+ * @format
+ */
+import dumpVisualTree from './dumpVisualTree';
+export { dumpVisualTree };

package/lib-commonjs/index.js

@@ -0,0 +1,15 @@
+"use strict";
+/**
+ * Copyright (c) Microsoft Corporation.
+ * Licensed under the MIT License.
+ *
+ * @format
+ */
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.dumpVisualTree = void 0;
+const dumpVisualTree_1 = __importDefault(require("./dumpVisualTree"));
+exports.dumpVisualTree = dumpVisualTree_1.default;
+//# sourceMappingURL=index.js.map

package/lib-commonjs/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAAA;;;;;GAKG;;;;;;AAEH,sEAA8C;AAEtC,yBAFD,wBAAc,CAEC","sourcesContent":["/**\n * Copyright (c) Microsoft Corporation.\n * Licensed under the MIT License.\n *\n * @format\n */\n\nimport dumpVisualTree from './dumpVisualTree';\n\nexport {dumpVisualTree};\n"]}

package/package.json

@@ -0,0 +1,55 @@
+{
+  "name": "@react-native-windows/automation-commands",
+  "version": "0.0.0-canary.1016",
+  "description": "Allows controlling your react-native-windows application",
+  "main": "lib-commonjs/index.js",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/microsoft/react-native-windows",
+    "directory": "packages/@react-native-windows/automation-commands"
+  },
+  "private": false,
+  "scripts": {
+    "build": "rnw-scripts build",
+    "clean": "rnw-scripts clean",
+    "lint": "rnw-scripts lint",
+    "lint:fix": "rnw-scripts lint:fix",
+    "watch": "rnw-scripts watch"
+  },
+  "dependencies": {
+    "@react-native-windows/automation-channel": "0.0.0-canary.1016",
+    "@typescript-eslint/eslint-plugin": "^7.1.1",
+    "@typescript-eslint/parser": "^7.1.1"
+  },
+  "devDependencies": {
+    "@jest/types": "^29.2.1",
+    "@rnw-scripts/eslint-config": "1.2.38",
+    "@rnw-scripts/just-task": "2.3.58",
+    "@rnw-scripts/ts-config": "2.0.6",
+    "@types/jest": "^29.2.2",
+    "@types/node": "^22.14.0",
+    "eslint": "^8.19.0",
+    "prettier": "2.8.8",
+    "typescript": "5.0.4"
+  },
+  "files": [
+    "lib-commonjs",
+    "README.md"
+  ],
+  "beachball": {
+    "defaultNpmTag": "canary",
+    "disallowedChangeTypes": [
+      "major",
+      "minor",
+      "patch",
+      "premajor",
+      "preminor",
+      "prepatch"
+    ]
+  },
+  "promoteRelease": true,
+  "engines": {
+    "node": ">= 22"
+  }
+}