Added the elementFinder library functions

framework/default/ortoo-core/default/lwc/elementFinder/__tests__/elementFinder.test.js

@@ -0,0 +1,33 @@
+import configureFindElement from 'c/elementFinder';
+
+describe( 'configureFindElement', () => {
+    it( 'will add a "findElement" function against the passed object', () => {
+
+        const objectToRunAgainst = {};
+
+        configureFindElement( objectToRunAgainst );
+
+        expect( objectToRunAgainst.findElement ).toBeDefined();
+    });
+});
+
+describe( 'findElement', () => {
+    it( 'will ask the bound object for the element with the specified data-ortoo-elem-id', () => {
+
+        const mockQuerySelector = jest.fn();
+
+        const objectToRunAgainst = {
+            template: {
+                querySelector: mockQuerySelector
+            }
+        };
+        mockQuerySelector.mockReturnValueOnce( 'the element' );
+
+        configureFindElement( objectToRunAgainst );
+
+        const response = objectToRunAgainst.findElement( 'test-element' );
+
+        expect( response ).toBe( 'the element' );
+        expect( mockQuerySelector ).toBeCalledWith( '[data-ortoo-elem-id="test-element"]' );
+    });
+});

framework/default/ortoo-core/default/lwc/elementFinder/elementFinder.js

@@ -0,0 +1,18 @@
+/**
+ * Will bind a function that will allow the bound LWC to 'findElement' passing an Ortoo Element Id.
+ *
+ * Should be bound in the connectedCallback of the LWC.  E.g.
+ *
+ * connectedCallback() {
+ *      configureFindElement( this );
+ * }
+ *
+ * @param bindTo The LWC to bind this function to
+ */
+const configureFindElement = bindTo => {
+    bindTo.findElement = function( ortooElemId ) {
+                                return this.template.querySelector( `[data-ortoo-elem-id="${ortooElemId}"]` );
+                            }.bind( bindTo );
+};
+
+export default configureFindElement;

framework/default/ortoo-core/default/lwc/elementFinder/elementFinder.js-meta.xml

@@ -0,0 +1,5 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<LightningComponentBundle xmlns="http://soap.sforce.com/2006/04/metadata">
+    <apiVersion>52.0</apiVersion>
+    <isExposed>false</isExposed>
+</LightningComponentBundle>