@atlaskit/media-test-helpers 41.1.0 → 42.0.0

package/AGENTS.md

@@ -0,0 +1,58 @@
+# media-test-helpers — Agent Guide
+
+> **Parent guide:** Always read [`../AGENTS.md`](../AGENTS.md) before working in this package — it
+> contains workspace-wide rules covering platform guidelines, changeset workflow, accessibility
+> standards, and the knowledge index protocol that applies to every Media package.
+
+## Package identity
+
+| Field    | Value                                                                                             |
+| -------- | ------------------------------------------------------------------------------------------------- |
+| NPM name | `@atlaskit/media-test-helpers`                                                                    |
+| Path     | `media-test-helpers/`                                                                             |
+| Owner    | Media Exif                                                                                        |
+| Purpose  | Collection of test helpers, mocks, fakes, and utilities used in Media component stories and specs |
+
+## Knowledge index
+
+> Read, search, edit, investigate, and validate the repository knowledge index at
+> `.agents/knowledge-index/`. ALWAYS use this skill before making ANY repo change, or when exploring
+> the codebase. The knowledge index is the canonical starting point for every coding task in this
+> repo, trigger this skill aggressively whenever the user mentions architecture, conventions,
+> packages, modules, services, build, coding, writing code, APIs, feature flags, testing, or
+> anything similar. Also trigger when "is the knowledge index up to date?" / "update the knowledge
+> index" / "what does the knowledge index say about Y?" — even if they don't say the words
+> "knowledge index". Also use it (via the `validate` subcommand) to detect drift between the
+> codebase and the docs after any code change. Use the `generate` subcommand to bootstrap the index
+> in a new repository.
+
+**Entry point:** `.agents/knowledge-index/INDEX.md` **Unit doc:**
+`.agents/knowledge-index/domains/media/units/atlaskit-media-test-helpers.md` **CLI:**
+`python3 .agents/skills/knowledge-index/scripts/kg.py {find,read,edit,investigate,validate,init,explore,generate} …`
+**Refresh protocol:** never silently bump `Last verified` — always re-read the listed `Sources`
+first, edit, then `kg.py edit <path> --message "<reason>"`.
+
+## Key source files
+
+- `src/index.tsx` — public API entry point
+- `src/fakeMediaClient.ts` — `fakeMediaClient()` factory for tests
+- `src/mockData/` — MSW mock handlers and routers
+- `src/mocks/` — mock database, routers, and WebSocket mocks
+- `src/fileStateFactory/` — `FileState` factories and file simulation
+- `src/dataURIs/` — sample data URIs for image testing
+- `src/featureFlagsWrapper/` — feature flag test wrapper
+- `src/utils/` — shared test utilities
+
+## Public API (key exports)
+
+`fakeMediaClient`, `StoryBookAuthProvider`, `generateFilesFromTestData`, and 48 total export
+subpaths covering mocks, helpers, factories, and data URIs.
+
+## Development notes
+
+- Internal dependencies: `@atlaskit/media-client`, `@atlaskit/media-common`,
+  `@atlaskit/media-state`, `@atlaskit/media-ui`
+- Peer dependencies: `@atlaskit/media-core`, `react`, `react-intl`
+- 1 feature flag: `should-render-to-parent-should-be-true-media-exif`
+- 48 export subpaths — always use subpath imports rather than the root barrel
+- Uses MSW (Mock Service Worker) for network-level mocking

package/CHANGELOG.md

@@ -1,5 +1,42 @@
 # @atlaskit/media-test-helpers
 
+## 42.0.0
+
+### Major Changes
+
+- [`f2dc9097319f0`](https://bitbucket.org/atlassian/atlassian-frontend-monorepo/commits/f2dc9097319f0) - ###
+  Dropped support for _legacy_ Typescript 4 types. **Typescript 5 is now the new minimum**.
+
+  Removes the `typesVersions` property and `dist/types-ts4.5` directory from the dist.
+
+  Types are now exclusively via the `"types": "dist/types/index.d.ts"` property.
+
+  ```diff
+  - "typesVersions": {
+  -    ">=4.5 <4.9": {
+  -        "*": [
+  -            "dist/types-ts4.5/*",
+  -            "dist/types-ts4.5/index.d.ts"
+  -        ]
+  -    }
+  - },
+  ```
+
+### Patch Changes
+
+- Updated dependencies
+
+## 41.2.0
+
+### Minor Changes
+
+- [`4b1523c328148`](https://bitbucket.org/atlassian/atlassian-frontend-monorepo/commits/4b1523c328148) -
+  Clean up flag to improve accessibility of layered components.
+
+### Patch Changes
+
+- Updated dependencies
+
 ## 41.1.0
 
 ### Minor Changes

package/I18nWrapper/package.json

@@ -6,12 +6,5 @@
   "sideEffects": [
     "*.compiled.css"
   ],
-  "types": "../dist/types/I18nWrapper.d.ts",
-  "typesVersions": {
-    ">=4.5 <5.9": {
-      "*": [
-        "../dist/types-ts4.5/I18nWrapper.d.ts"
-      ]
-    }
-  }
+  "types": "../dist/types/I18nWrapper.d.ts"
 }

package/MockGlobalImage/package.json

@@ -6,12 +6,5 @@
   "sideEffects": [
     "*.compiled.css"
   ],
-  "types": "../dist/types/MockGlobalImage.d.ts",
-  "typesVersions": {
-    ">=4.5 <5.9": {
-      "*": [
-        "../dist/types-ts4.5/MockGlobalImage.d.ts"
-      ]
-    }
-  }
+  "types": "../dist/types/MockGlobalImage.d.ts"
 }

package/authProvider/package.json

@@ -6,12 +6,5 @@
   "sideEffects": [
     "*.compiled.css"
   ],
-  "types": "../dist/types/authProvider.d.ts",
-  "typesVersions": {
-    ">=4.5 <5.9": {
-      "*": [
-        "../dist/types-ts4.5/authProvider.d.ts"
-      ]
-    }
-  }
+  "types": "../dist/types/authProvider.d.ts"
 }

package/await-error/package.json

@@ -6,12 +6,5 @@
   "sideEffects": [
     "*.compiled.css"
   ],
-  "types": "../dist/types/await-error.d.ts",
-  "typesVersions": {
-    ">=4.5 <5.9": {
-      "*": [
-        "../dist/types-ts4.5/await-error.d.ts"
-      ]
-    }
-  }
+  "types": "../dist/types/await-error.d.ts"
 }

package/clipboardEventMocks/package.json

@@ -6,12 +6,5 @@
   "sideEffects": [
     "*.compiled.css"
   ],
-  "types": "../dist/types/clipboardEventMocks.d.ts",
-  "typesVersions": {
-    ">=4.5 <5.9": {
-      "*": [
-        "../dist/types-ts4.5/clipboardEventMocks.d.ts"
-      ]
-    }
-  }
+  "types": "../dist/types/clipboardEventMocks.d.ts"
 }

package/collectionNames/package.json

@@ -6,12 +6,5 @@
   "sideEffects": [
     "*.compiled.css"
   ],
-  "types": "../dist/types/collectionNames.d.ts",
-  "typesVersions": {
-    ">=4.5 <5.9": {
-      "*": [
-        "../dist/types-ts4.5/collectionNames.d.ts"
-      ]
-    }
-  }
+  "types": "../dist/types/collectionNames.d.ts"
 }

package/createFileState/package.json

@@ -6,12 +6,5 @@
   "sideEffects": [
     "*.compiled.css"
   ],
-  "types": "../dist/types/fileStateFactory/factory/createFileState.d.ts",
-  "typesVersions": {
-    ">=4.5 <5.9": {
-      "*": [
-        "../dist/types-ts4.5/fileStateFactory/factory/createFileState.d.ts"
-      ]
-    }
-  }
+  "types": "../dist/types/fileStateFactory/factory/createFileState.d.ts"
 }

package/createMouseEvent/package.json

@@ -6,12 +6,5 @@
   "sideEffects": [
     "*.compiled.css"
   ],
-  "types": "../dist/types/createMouseEvent.d.ts",
-  "typesVersions": {
-    ">=4.5 <5.9": {
-      "*": [
-        "../dist/types-ts4.5/createMouseEvent.d.ts"
-      ]
-    }
-  }
+  "types": "../dist/types/createMouseEvent.d.ts"
 }

package/createTouchEvent/package.json

@@ -6,12 +6,5 @@
   "sideEffects": [
     "*.compiled.css"
   ],
-  "types": "../dist/types/createTouchEvent.d.ts",
-  "typesVersions": {
-    ">=4.5 <5.9": {
-      "*": [
-        "../dist/types-ts4.5/createTouchEvent.d.ts"
-      ]
-    }
-  }
+  "types": "../dist/types/createTouchEvent.d.ts"
 }

package/dist/cjs/authProvider.js

@@ -23,7 +23,7 @@ var StoryBookAuthProvider = exports.StoryBookAuthProvider = /*#__PURE__*/functio
       var loadTenatAuth = /*#__PURE__*/function () {
         var _ref = (0, _asyncToGenerator2.default)( /*#__PURE__*/_regenerator.default.mark(function _callee(collectionName) {
           var environment, headers, config, url, response;
-          return _regenerator.default.wrap(function _callee$(_context) {
+          return _regenerator.default.wrap(function (_context) {
             while (1) switch (_context.prev = _context.next) {
               case 0:
                 environment = isAsapEnvironment ? 'asap' : '';
@@ -40,14 +40,14 @@ var StoryBookAuthProvider = exports.StoryBookAuthProvider = /*#__PURE__*/functio
                 };
                 url = "".concat(_mediaBaseURLS.MEDIA_PLAYGROUND_BASE_URL, "/token/tenant?collection=").concat(collectionName, "&environment=").concat(environment);
                 response = fetch(url, config); // We leverage the fact, that our internal /toke/tenant API returns data in the same format as Auth
-                _context.next = 9;
+                _context.next = 1;
                 return response;
-              case 9:
-                _context.next = 11;
+              case 1:
+                _context.next = 2;
                 return _context.sent.json();
-              case 11:
+              case 2:
                 return _context.abrupt("return", _context.sent);
-              case 12:
+              case 3:
               case "end":
                 return _context.stop();
             }

package/dist/cjs/await-error.js

@@ -12,28 +12,29 @@ function awaitError(_x, _x2) {
 }
 function _awaitError() {
   _awaitError = (0, _asyncToGenerator2.default)( /*#__PURE__*/_regenerator.default.mark(function _callee(response, expectedMessage) {
-    return _regenerator.default.wrap(function _callee$(_context) {
+    var _t;
+    return _regenerator.default.wrap(function (_context) {
       while (1) switch (_context.prev = _context.next) {
         case 0:
           _context.prev = 0;
-          _context.next = 3;
+          _context.next = 1;
           return response;
-        case 3:
-          _context.next = 9;
+        case 1:
+          _context.next = 3;
           break;
-        case 5:
-          _context.prev = 5;
-          _context.t0 = _context["catch"](0);
-          if (!(_context.t0 instanceof Error && _context.t0.message !== expectedMessage)) {
-            _context.next = 9;
+        case 2:
+          _context.prev = 2;
+          _t = _context["catch"](0);
+          if (!(_t instanceof Error && _t.message !== expectedMessage)) {
+            _context.next = 3;
             break;
           }
-          throw _context.t0;
-        case 9:
+          throw _t;
+        case 3:
         case "end":
           return _context.stop();
       }
-    }, _callee, null, [[0, 5]]);
+    }, _callee, null, [[0, 2]]);
   }));
   return _awaitError.apply(this, arguments);
 }

package/dist/cjs/featureFlagsWrapper/dropdown.js

@@ -15,7 +15,6 @@ var _helpers = require("./helpers");
 var _crossCircle = _interopRequireDefault(require("@atlaskit/icon/core/cross-circle"));
 var _chevronDown = _interopRequireDefault(require("@atlaskit/icon/core/chevron-down"));
 var _standardButton = _interopRequireDefault(require("@atlaskit/button/standard-button"));
-var _platformFeatureFlags = require("@atlaskit/platform-feature-flags");
 var _primitives = require("@atlaskit/primitives");
 var _tooltip = _interopRequireDefault(require("@atlaskit/tooltip"));
 var _styled = _interopRequireDefault(require("@emotion/styled"));
@@ -145,7 +144,7 @@ var MediaFeatureFlagsDropdown = function MediaFeatureFlagsDropdown(_ref6) {
         })
       }), "Media Feature Flags");
     },
-    shouldRenderToParent: (0, _platformFeatureFlags.fg)('should-render-to-parent-should-be-true-media-exif')
+    shouldRenderToParent: true
   }), /*#__PURE__*/_react.default.createElement(_tooltip.default, {
     content: "Reset all flags"
   }, /*#__PURE__*/_react.default.createElement(_standardButton.default

package/dist/cjs/fileStateFactory/factory/factory.js

@@ -39,21 +39,21 @@ var MediaClientMock = exports.MediaClientMock = /*#__PURE__*/function (_MediaCli
     });
     (0, _defineProperty2.default)(_this, "getImage", /*#__PURE__*/(0, _asyncToGenerator2.default)( /*#__PURE__*/_regenerator.default.mark(function _callee() {
       var _this$options$getImag, getImageDelay;
-      return _regenerator.default.wrap(function _callee$(_context) {
+      return _regenerator.default.wrap(function (_context) {
         while (1) switch (_context.prev = _context.next) {
           case 0:
             _this$options$getImag = _this.options.getImageDelay, getImageDelay = _this$options$getImag === void 0 ? 0 : _this$options$getImag;
             if (_this.hasPreview) {
-              _context.next = 3;
+              _context.next = 1;
               break;
             }
             throw new Error('some error');
-          case 3:
-            _context.next = 5;
+          case 1:
+            _context.next = 2;
             return (0, _nextTick.sleep)(getImageDelay);
-          case 5:
+          case 2:
             return _context.abrupt("return", (0, _mockData.dataURItoBlob)(_images.tallImage));
-          case 6:
+          case 3:
           case "end":
             return _context.stop();
         }
@@ -76,7 +76,7 @@ var MediaClientMock = exports.MediaClientMock = /*#__PURE__*/function (_MediaCli
 var mockConfig = {
   authProvider: function () {
     var _authProvider = (0, _asyncToGenerator2.default)( /*#__PURE__*/_regenerator.default.mark(function _callee2() {
-      return _regenerator.default.wrap(function _callee2$(_context2) {
+      return _regenerator.default.wrap(function (_context2) {
         while (1) switch (_context2.prev = _context2.next) {
           case 0:
             return _context2.abrupt("return", {