Update Jest mock file comments to include @file annotations for clarity

- Added @file annotations to the comments in various Jest mock files to standardize documentation and improve clarity on their purpose.
- Updated unit test files to reflect the same @file annotation format for consistency in documentation style.

Co-authored-by: Cursor <cursoragent@cursor.com>

Author: alex-rawlings-yyc

__mocks__/fileMock.ts

@@ -1,5 +1,5 @@
 /**
- * Jest mock for static asset imports (images, fonts, etc.). Importing e.g. `logo.png` in tests will
+ * @file Jest mock for static asset imports (images, fonts, etc.). Importing e.g. `logo.png` in tests will
  * receive this string instead of running file loaders. Mirrors webpack's asset/inline and
  * asset/resource handling in webpack.config.base.
  *

__mocks__/interlinearXmlContent.ts

@@ -1,5 +1,5 @@
 /**
- * Jest mock for webpack ?raw XML import. Exports the contents of test-data/Interlinear_en_MAT.xml
+ * @file Jest mock for webpack ?raw XML import. Exports the contents of test-data/Interlinear_en_MAT.xml
  * so interlinearizer.web-view.tsx can parse it in unit tests without webpack.
  */
 import fs from 'fs';

__mocks__/papi-backend.ts

@@ -1,5 +1,5 @@
 /**
- * Jest mock for @papi/backend. Provides papi and logger so main.ts can be unit-tested without
+ * @file Jest mock for @papi/backend. Provides papi and logger so main.ts can be unit-tested without
  * loading the real Platform API.
  */
 

__mocks__/papi-core.ts

@@ -1,5 +1,5 @@
 /**
- * Jest mock for @papi/core. main.ts imports only types from here (ExecutionActivationContext,
+ * @file Jest mock for @papi/core. main.ts imports only types from here (ExecutionActivationContext,
  * IWebViewProvider, SavedWebViewDefinition, WebViewDefinition); types are erased at runtime so this
  * mock only needs to exist for module resolution.
  */

__mocks__/papi-frontend-react.ts

@@ -1,5 +1,5 @@
 /**
- * Jest mock for @papi/frontend/react. Provides stub implementations of various PAPI React hooks so
+ * @file Jest mock for @papi/frontend/react. Provides stub implementations of various PAPI React hooks so
  * WebView/frontend components can be unit-tested without the real Platform API.
  */
 

__mocks__/papi-frontend.ts

@@ -1,5 +1,5 @@
 /**
- * Jest mock for @papi/frontend. Provides papi, logger, network, projectDataProviders, and other
+ * @file Jest mock for @papi/frontend. Provides papi, logger, network, projectDataProviders, and other
  * renderer API stubs so WebView/frontend code can be unit-tested without loading the real
  * Platform API.
  */

__mocks__/platform-bible-utils.ts

@@ -1,5 +1,5 @@
 /**
- * Jest mock for platform-bible-utils. Exposes only UnsubscriberAsyncList so test-helpers can build
+ * @file Jest mock for platform-bible-utils. Exposes only UnsubscriberAsyncList so test-helpers can build
  * ExecutionActivationContext without loading the real package (which pulls in ESM deps).
  */
 

__mocks__/styleInlineMock.ts

@@ -1,5 +1,5 @@
 /**
- * Jest mock for webpack ?inline style imports (e.g. .scss?inline). Returns empty string as the
+ * @file Jest mock for webpack ?inline style imports (e.g. .scss?inline). Returns empty string as the
  * "inlined" content so main.ts can pass it to the WebView definition.
  */
 module.exports = '';

__mocks__/styleMock.ts

@@ -1,5 +1,5 @@
 /**
- * Jest mock for stylesheet imports (CSS, SCSS, SASS). Used so that `import './foo.scss'` and
+ * @file Jest mock for stylesheet imports (CSS, SCSS, SASS). Used so that `import './foo.scss'` and
  * similar do not run real style loaders in tests. Mirrors webpack's handling of .(sa|sc|c)ss in
  * webpack.config.base (we mock instead of compile).
  *

__mocks__/web-view-inline.ts

@@ -1,5 +1,5 @@
 /**
- * Jest mock for webpack ?inline component import (interlinearizer.web-view?inline). Exports a dummy
+ * @file Jest mock for webpack ?inline component import (interlinearizer.web-view?inline). Exports a dummy
  * function so main.ts can pass it to the WebView provider without pulling in React.
  * Returns null so that if this mock is ever rendered as a React component, it follows React
  * semantics (null = render nothing; undefined can trigger strict-mode warnings).