Get by attribute exact then contains

.gitignore

@@ -2,4 +2,5 @@
 /node_modules
 *.tgz
 /test-results
-/docs
+/docs
+src/.DS_Store

package.json

@@ -52,6 +52,6 @@
   "author": "Umut Ay Bora",
   "license": "MIT",
   "dependencies": {
-    "@civitas-cerebrum/test-coverage": "^0.0.8"
+    "@civitas-cerebrum/test-coverage": "^0.0.9"
   }
 }

src/repo/ElementRepository.ts

@@ -60,6 +60,18 @@ export class ElementRepository {
     return (page.platform ?? 'web') === 'web';
   }
 
+  /**
+   * Returns the platform string for the given page, or `'web'` if not specified.
+   * @param pageName The name of the page block in the JSON repository.
+   * @returns The platform string (e.g. `'web'`, `'android'`, `'ios'`).
+   * @throws Error if the page is not found.
+   */
+  public getPagePlatform(pageName: string): string {
+    const page = this.findPage(pageName);
+    if (!page) throw new Error(`ElementRepository: Page '${pageName}' not found.`);
+    return page.platform ?? 'web';
+  }
+
   /**
    * Updates the default timeout for all subsequent element retrievals.
    * @param timeout The new timeout in milliseconds.

tests/element-repository.spec.ts

@@ -145,6 +145,42 @@ test.describe('setDefaultTimeout', () => {
   });
 });
 
+// ===========================================================================
+// getPagePlatform
+// ===========================================================================
+
+test.describe('getPagePlatform', () => {
+  test('returns "web" when platform is not specified', () => {
+    const repo = new ElementRepository(webMockData);
+    expect(repo.getPagePlatform('TestPage')).toBe('web');
+  });
+
+  test('returns explicit platform when set', () => {
+    const repo = new ElementRepository(multiPlatformMockData);
+    expect(repo.getPagePlatform('LoginPage')).toBe('web');
+    expect(repo.getPagePlatform('LoginPageAndroid')).toBe('android');
+    expect(repo.getPagePlatform('LoginPageIOS')).toBe('ios');
+  });
+
+  test('returns custom platform string as-is', () => {
+    const repo = new ElementRepository({
+      pages: [
+        { name: 'DesktopPage', platform: 'macos', elements: [] },
+        { name: 'WinPage', platform: 'windows', elements: [] },
+      ],
+    });
+    expect(repo.getPagePlatform('DesktopPage')).toBe('macos');
+    expect(repo.getPagePlatform('WinPage')).toBe('windows');
+  });
+
+  test('throws when page is not found', () => {
+    const repo = new ElementRepository(webMockData);
+    expect(() => repo.getPagePlatform('NonExistentPage')).toThrow(
+      "ElementRepository: Page 'NonExistentPage' not found."
+    );
+  });
+});
+
 // ===========================================================================
 // get — platform branch
 // ===========================================================================