@atlaskit/eslint-plugin-platform 0.1.3 → 0.1.5

package/CHANGELOG.md

@@ -1,5 +1,17 @@
 # @atlaskit/eslint-plugin-platform
 
+## 0.1.5
+
+### Patch Changes
+
+- [`b47e48ad163`](https://bitbucket.org/atlassian/atlassian-frontend/commits/b47e48ad163) - Adds an eslint rule to confirm that storybooks only get passed an object - to ensure that codemods work correctly.
+
+## 0.1.4
+
+### Patch Changes
+
+- [`971489f4ff4`](https://bitbucket.org/atlassian/atlassian-frontend/commits/971489f4ff4) - Add test runner to identified calls that require registration of platform feature flags
+
 ## 0.1.3
 
 ### Patch Changes

package/dist/cjs/index.js

@@ -10,12 +10,14 @@ var _noPrePostInstalls = _interopRequireDefault(require("./rules/no-pre-post-ins
 var _ensureTestRunnerArguments = _interopRequireDefault(require("./rules/ensure-test-runner-arguments"));
 var _ensureTestRunnerNestedCount = _interopRequireDefault(require("./rules/ensure-test-runner-nested-count"));
 var _noInvalidFeatureFlagUsage = _interopRequireDefault(require("./rules/no-invalid-feature-flag-usage"));
+var _noInvalidStorybookDecoratorUsage = _interopRequireDefault(require("./rules/no-invalid-storybook-decorator-usage"));
 var rules = {
   'ensure-feature-flag-registration': _ensureFeatureFlagRegistration.default,
   'ensure-test-runner-arguments': _ensureTestRunnerArguments.default,
   'ensure-test-runner-nested-count': _ensureTestRunnerNestedCount.default,
   'no-invalid-feature-flag-usage': _noInvalidFeatureFlagUsage.default,
-  'no-pre-post-install-scripts': _noPrePostInstalls.default
+  'no-pre-post-install-scripts': _noPrePostInstalls.default,
+  'no-invalid-storybook-decorator-usage': _noInvalidStorybookDecoratorUsage.default
 };
 exports.rules = rules;
 var configs = {
@@ -25,7 +27,8 @@ var configs = {
       '@atlaskit/platform/ensure-feature-flag-registration': 'error',
       '@atlaskit/platform/ensure-test-runner-arguments': 'error',
       '@atlaskit/platform/ensure-test-runner-nested-count': 'warn',
-      '@atlaskit/platform/no-invalid-feature-flag-usage': 'error'
+      '@atlaskit/platform/no-invalid-feature-flag-usage': 'error',
+      '@atlaskit/platform/no-invalid-storybook-decorator-usage': 'error'
     }
   }
 };

package/dist/cjs/rules/ensure-feature-flag-registration/index.js

@@ -13,8 +13,10 @@ var _fuse = _interopRequireDefault(require("fuse.js"));
 function ownKeys(object, enumerableOnly) { var keys = Object.keys(object); if (Object.getOwnPropertySymbols) { var symbols = Object.getOwnPropertySymbols(object); enumerableOnly && (symbols = symbols.filter(function (sym) { return Object.getOwnPropertyDescriptor(object, sym).enumerable; })), keys.push.apply(keys, symbols); } return keys; }
 function _objectSpread(target) { for (var i = 1; i < arguments.length; i++) { var source = null != arguments[i] ? arguments[i] : {}; i % 2 ? ownKeys(Object(source), !0).forEach(function (key) { (0, _defineProperty2.default)(target, key, source[key]); }) : Object.getOwnPropertyDescriptors ? Object.defineProperties(target, Object.getOwnPropertyDescriptors(source)) : ownKeys(Object(source)).forEach(function (key) { Object.defineProperty(target, key, Object.getOwnPropertyDescriptor(source, key)); }); } return target; }
 // defines a "getter" to "type" map, if more types are required for feature flags (like string) add it here!
+// if you don't want to verify the type use `null` as the value
 var getterIdentifierToFlagTypeMap = {
-  getBooleanFF: 'boolean'
+  getBooleanFF: 'boolean',
+  ffTest: 'boolean'
 };
 // make sure we cache reading the package.json so we don't end up reading it for every instance of this rule.
 var pkgJsonCache = new Map();
@@ -54,7 +56,8 @@ var rule = {
     messages: {
       registrationSectionMissing: 'Please add a "platform-feature-flags" section to your package.json! See http://go/pff-eslint for more details',
       featureFlagMissing: "Please add a \"{{ featureFlag }}\" section to the \"platform-feature-flags\" section in your package.json. See http://go/pff-eslint for more details",
-      changeFeatureFlag: "Change flag key to \"{{ closestFlag }}\" already defined in package.json"
+      changeFeatureFlag: "Change flag key to \"{{ closestFlag }}\" already defined in package.json",
+      featureFlagIncorrectType: "Please change the type for \"{{ featureFlag }}\" to \"{{ expectedType }}\" in the section to the \"platform-feature-flags\" section in your package.json. See http://go/pff-eslint for more details\""
     },
     hasSuggestions: true
   },
@@ -78,6 +81,19 @@ var rule = {
           if (args.length === 1 && args[0].type === 'Literal' && args[0].raw) {
             var featureFlag = args[0].value;
             var featureFlagRegistration = platformFeatureFlags[featureFlag];
+            var expectedType = getterIdentifierToFlagTypeMap[getterIdentifier];
+
+            // ensure the flag type matches what is registered
+            if (featureFlagRegistration != null && expectedType != null && (featureFlagRegistration === null || featureFlagRegistration === void 0 ? void 0 : featureFlagRegistration.type) !== expectedType) {
+              return context.report({
+                node: args[0],
+                messageId: 'featureFlagIncorrectType',
+                data: {
+                  featureFlag: featureFlag,
+                  expectedType: expectedType
+                }
+              });
+            }
             if (!featureFlagRegistration) {
               // find the closest match in existing section for suggestion text
               var closestMatchFix = null;

package/dist/cjs/rules/no-invalid-storybook-decorator-usage/index.js

@@ -0,0 +1,38 @@
+"use strict";
+
+var _interopRequireDefault = require("@babel/runtime/helpers/interopRequireDefault");
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.default = void 0;
+var _defineProperty2 = _interopRequireDefault(require("@babel/runtime/helpers/defineProperty"));
+var STORYBOOK_DECORATOR_IDENTIFIER = 'withPlatformFeatureFlags';
+var rule = {
+  meta: {
+    hasSuggestions: false,
+    docs: {
+      recommended: false
+    },
+    type: 'problem',
+    messages: {
+      onlyObjectExpression: 'Only object literals allowed in the storybook decorator! See http://go/pff-eslint for more details'
+    }
+  },
+  create: function create(context) {
+    return (0, _defineProperty2.default)({}, "CallExpression[callee.name=/".concat(STORYBOOK_DECORATOR_IDENTIFIER, "/]"), function CallExpressionCalleeName(node) {
+      // to make typescript happy
+      if (node.type === 'CallExpression') {
+        var args = node.arguments;
+        if (args.length === 1 && args[0].type !== 'ObjectExpression') {
+          return context.report({
+            node: node,
+            messageId: 'onlyObjectExpression'
+          });
+        }
+      }
+      return {};
+    });
+  }
+};
+var _default = rule;
+exports.default = _default;

package/dist/cjs/version.json

@@ -1,5 +1,5 @@
 {
 	"name": "@atlaskit/eslint-plugin-platform",
-	"version": "0.1.3",
+	"version": "0.1.5",
 	"sideEffects": false
 }

package/dist/es2019/index.js

@@ -3,12 +3,14 @@ import noPreAndPostInstallScripts from './rules/no-pre-post-installs';
 import ensureTestRunnerArguments from './rules/ensure-test-runner-arguments';
 import ensureTestRunnerNestedCount from './rules/ensure-test-runner-nested-count';
 import noInvalidFeatureFlagUsage from './rules/no-invalid-feature-flag-usage';
+import noInvalidStorybookDecoratorUsage from './rules/no-invalid-storybook-decorator-usage';
 export const rules = {
   'ensure-feature-flag-registration': ensureFeatureFlagRegistration,
   'ensure-test-runner-arguments': ensureTestRunnerArguments,
   'ensure-test-runner-nested-count': ensureTestRunnerNestedCount,
   'no-invalid-feature-flag-usage': noInvalidFeatureFlagUsage,
-  'no-pre-post-install-scripts': noPreAndPostInstallScripts
+  'no-pre-post-install-scripts': noPreAndPostInstallScripts,
+  'no-invalid-storybook-decorator-usage': noInvalidStorybookDecoratorUsage
 };
 export const configs = {
   recommended: {
@@ -17,7 +19,8 @@ export const configs = {
       '@atlaskit/platform/ensure-feature-flag-registration': 'error',
       '@atlaskit/platform/ensure-test-runner-arguments': 'error',
       '@atlaskit/platform/ensure-test-runner-nested-count': 'warn',
-      '@atlaskit/platform/no-invalid-feature-flag-usage': 'error'
+      '@atlaskit/platform/no-invalid-feature-flag-usage': 'error',
+      '@atlaskit/platform/no-invalid-storybook-decorator-usage': 'error'
     }
   }
 };

package/dist/es2019/rules/ensure-feature-flag-registration/index.js

@@ -3,8 +3,10 @@ import path from 'path';
 import Fuse from 'fuse.js';
 
 // defines a "getter" to "type" map, if more types are required for feature flags (like string) add it here!
+// if you don't want to verify the type use `null` as the value
 const getterIdentifierToFlagTypeMap = {
-  getBooleanFF: 'boolean'
+  getBooleanFF: 'boolean',
+  ffTest: 'boolean'
 };
 // make sure we cache reading the package.json so we don't end up reading it for every instance of this rule.
 const pkgJsonCache = new Map();
@@ -45,7 +47,8 @@ const rule = {
     messages: {
       registrationSectionMissing: 'Please add a "platform-feature-flags" section to your package.json! See http://go/pff-eslint for more details',
       featureFlagMissing: `Please add a "{{ featureFlag }}" section to the "platform-feature-flags" section in your package.json. See http://go/pff-eslint for more details`,
-      changeFeatureFlag: `Change flag key to "{{ closestFlag }}" already defined in package.json`
+      changeFeatureFlag: `Change flag key to "{{ closestFlag }}" already defined in package.json`,
+      featureFlagIncorrectType: `Please change the type for "{{ featureFlag }}" to "{{ expectedType }}" in the section to the "platform-feature-flags" section in your package.json. See http://go/pff-eslint for more details"`
     },
     hasSuggestions: true
   },
@@ -69,6 +72,19 @@ const rule = {
         if (args.length === 1 && args[0].type === 'Literal' && args[0].raw) {
           const featureFlag = args[0].value;
           const featureFlagRegistration = platformFeatureFlags[featureFlag];
+          const expectedType = getterIdentifierToFlagTypeMap[getterIdentifier];
+
+          // ensure the flag type matches what is registered
+          if (featureFlagRegistration != null && expectedType != null && (featureFlagRegistration === null || featureFlagRegistration === void 0 ? void 0 : featureFlagRegistration.type) !== expectedType) {
+            return context.report({
+              node: args[0],
+              messageId: 'featureFlagIncorrectType',
+              data: {
+                featureFlag,
+                expectedType
+              }
+            });
+          }
           if (!featureFlagRegistration) {
             // find the closest match in existing section for suggestion text
             let closestMatchFix = null;

package/dist/es2019/rules/no-invalid-storybook-decorator-usage/index.js

@@ -0,0 +1,31 @@
+const STORYBOOK_DECORATOR_IDENTIFIER = 'withPlatformFeatureFlags';
+const rule = {
+  meta: {
+    hasSuggestions: false,
+    docs: {
+      recommended: false
+    },
+    type: 'problem',
+    messages: {
+      onlyObjectExpression: 'Only object literals allowed in the storybook decorator! See http://go/pff-eslint for more details'
+    }
+  },
+  create(context) {
+    return {
+      [`CallExpression[callee.name=/${STORYBOOK_DECORATOR_IDENTIFIER}/]`]: node => {
+        // to make typescript happy
+        if (node.type === 'CallExpression') {
+          const args = node.arguments;
+          if (args.length === 1 && args[0].type !== 'ObjectExpression') {
+            return context.report({
+              node,
+              messageId: 'onlyObjectExpression'
+            });
+          }
+        }
+        return {};
+      }
+    };
+  }
+};
+export default rule;

package/dist/es2019/version.json

@@ -1,5 +1,5 @@
 {
 	"name": "@atlaskit/eslint-plugin-platform",
-	"version": "0.1.3",
+	"version": "0.1.5",
 	"sideEffects": false
 }

package/dist/esm/index.js

@@ -3,12 +3,14 @@ import noPreAndPostInstallScripts from './rules/no-pre-post-installs';
 import ensureTestRunnerArguments from './rules/ensure-test-runner-arguments';
 import ensureTestRunnerNestedCount from './rules/ensure-test-runner-nested-count';
 import noInvalidFeatureFlagUsage from './rules/no-invalid-feature-flag-usage';
+import noInvalidStorybookDecoratorUsage from './rules/no-invalid-storybook-decorator-usage';
 export var rules = {
   'ensure-feature-flag-registration': ensureFeatureFlagRegistration,
   'ensure-test-runner-arguments': ensureTestRunnerArguments,
   'ensure-test-runner-nested-count': ensureTestRunnerNestedCount,
   'no-invalid-feature-flag-usage': noInvalidFeatureFlagUsage,
-  'no-pre-post-install-scripts': noPreAndPostInstallScripts
+  'no-pre-post-install-scripts': noPreAndPostInstallScripts,
+  'no-invalid-storybook-decorator-usage': noInvalidStorybookDecoratorUsage
 };
 export var configs = {
   recommended: {
@@ -17,7 +19,8 @@ export var configs = {
       '@atlaskit/platform/ensure-feature-flag-registration': 'error',
       '@atlaskit/platform/ensure-test-runner-arguments': 'error',
       '@atlaskit/platform/ensure-test-runner-nested-count': 'warn',
-      '@atlaskit/platform/no-invalid-feature-flag-usage': 'error'
+      '@atlaskit/platform/no-invalid-feature-flag-usage': 'error',
+      '@atlaskit/platform/no-invalid-storybook-decorator-usage': 'error'
     }
   }
 };

package/dist/esm/rules/ensure-feature-flag-registration/index.js

@@ -7,8 +7,10 @@ import path from 'path';
 import Fuse from 'fuse.js';
 
 // defines a "getter" to "type" map, if more types are required for feature flags (like string) add it here!
+// if you don't want to verify the type use `null` as the value
 var getterIdentifierToFlagTypeMap = {
-  getBooleanFF: 'boolean'
+  getBooleanFF: 'boolean',
+  ffTest: 'boolean'
 };
 // make sure we cache reading the package.json so we don't end up reading it for every instance of this rule.
 var pkgJsonCache = new Map();
@@ -48,7 +50,8 @@ var rule = {
     messages: {
       registrationSectionMissing: 'Please add a "platform-feature-flags" section to your package.json! See http://go/pff-eslint for more details',
       featureFlagMissing: "Please add a \"{{ featureFlag }}\" section to the \"platform-feature-flags\" section in your package.json. See http://go/pff-eslint for more details",
-      changeFeatureFlag: "Change flag key to \"{{ closestFlag }}\" already defined in package.json"
+      changeFeatureFlag: "Change flag key to \"{{ closestFlag }}\" already defined in package.json",
+      featureFlagIncorrectType: "Please change the type for \"{{ featureFlag }}\" to \"{{ expectedType }}\" in the section to the \"platform-feature-flags\" section in your package.json. See http://go/pff-eslint for more details\""
     },
     hasSuggestions: true
   },
@@ -72,6 +75,19 @@ var rule = {
           if (args.length === 1 && args[0].type === 'Literal' && args[0].raw) {
             var featureFlag = args[0].value;
             var featureFlagRegistration = platformFeatureFlags[featureFlag];
+            var expectedType = getterIdentifierToFlagTypeMap[getterIdentifier];
+
+            // ensure the flag type matches what is registered
+            if (featureFlagRegistration != null && expectedType != null && (featureFlagRegistration === null || featureFlagRegistration === void 0 ? void 0 : featureFlagRegistration.type) !== expectedType) {
+              return context.report({
+                node: args[0],
+                messageId: 'featureFlagIncorrectType',
+                data: {
+                  featureFlag: featureFlag,
+                  expectedType: expectedType
+                }
+              });
+            }
             if (!featureFlagRegistration) {
               // find the closest match in existing section for suggestion text
               var closestMatchFix = null;

package/dist/esm/rules/no-invalid-storybook-decorator-usage/index.js

@@ -0,0 +1,30 @@
+import _defineProperty from "@babel/runtime/helpers/defineProperty";
+var STORYBOOK_DECORATOR_IDENTIFIER = 'withPlatformFeatureFlags';
+var rule = {
+  meta: {
+    hasSuggestions: false,
+    docs: {
+      recommended: false
+    },
+    type: 'problem',
+    messages: {
+      onlyObjectExpression: 'Only object literals allowed in the storybook decorator! See http://go/pff-eslint for more details'
+    }
+  },
+  create: function create(context) {
+    return _defineProperty({}, "CallExpression[callee.name=/".concat(STORYBOOK_DECORATOR_IDENTIFIER, "/]"), function CallExpressionCalleeName(node) {
+      // to make typescript happy
+      if (node.type === 'CallExpression') {
+        var args = node.arguments;
+        if (args.length === 1 && args[0].type !== 'ObjectExpression') {
+          return context.report({
+            node: node,
+            messageId: 'onlyObjectExpression'
+          });
+        }
+      }
+      return {};
+    });
+  }
+};
+export default rule;

package/dist/esm/version.json

@@ -1,5 +1,5 @@
 {
 	"name": "@atlaskit/eslint-plugin-platform",
-	"version": "0.1.3",
+	"version": "0.1.5",
 	"sideEffects": false
 }

package/dist/types/index.d.ts

@@ -5,6 +5,7 @@ export declare const rules: {
     'ensure-test-runner-nested-count': import("eslint").Rule.RuleModule;
     'no-invalid-feature-flag-usage': import("eslint").Rule.RuleModule;
     'no-pre-post-install-scripts': import("eslint").Rule.RuleModule;
+    'no-invalid-storybook-decorator-usage': import("eslint").Rule.RuleModule;
 };
 export declare const configs: {
     recommended: {
@@ -14,6 +15,7 @@ export declare const configs: {
             '@atlaskit/platform/ensure-test-runner-arguments': string;
             '@atlaskit/platform/ensure-test-runner-nested-count': string;
             '@atlaskit/platform/no-invalid-feature-flag-usage': string;
+            '@atlaskit/platform/no-invalid-storybook-decorator-usage': string;
         };
     };
 };

package/dist/types/rules/no-invalid-storybook-decorator-usage/index.d.ts

@@ -0,0 +1,3 @@
+import type { Rule } from 'eslint';
+declare const rule: Rule.RuleModule;
+export default rule;

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@atlaskit/eslint-plugin-platform",
   "description": "The essential plugin for use with Atlassian frontend platform tools",
-  "version": "0.1.3",
+  "version": "0.1.5",
   "author": "Atlassian Pty Ltd",
   "atlassian": {
     "team": "UIP - Platform Integration Trust (PITa)",

package/report.api.md

@@ -27,6 +27,7 @@ export const configs: {
       '@atlaskit/platform/ensure-test-runner-arguments': string;
       '@atlaskit/platform/ensure-test-runner-nested-count': string;
       '@atlaskit/platform/no-invalid-feature-flag-usage': string;
+      '@atlaskit/platform/no-invalid-storybook-decorator-usage': string;
     };
   };
 };
@@ -43,6 +44,7 @@ export const rules: {
   'ensure-test-runner-nested-count': Rule.RuleModule;
   'no-invalid-feature-flag-usage': Rule.RuleModule;
   'no-pre-post-install-scripts': Rule.RuleModule;
+  'no-invalid-storybook-decorator-usage': Rule.RuleModule;
 };
 
 // (No @packageDocumentation comment for this package)

package/src/index.tsx

@@ -4,6 +4,7 @@ import noPreAndPostInstallScripts from './rules/no-pre-post-installs';
 import ensureTestRunnerArguments from './rules/ensure-test-runner-arguments';
 import ensureTestRunnerNestedCount from './rules/ensure-test-runner-nested-count';
 import noInvalidFeatureFlagUsage from './rules/no-invalid-feature-flag-usage';
+import noInvalidStorybookDecoratorUsage from './rules/no-invalid-storybook-decorator-usage';
 
 export const rules = {
   'ensure-feature-flag-registration': ensureFeatureFlagRegistration,
@@ -11,6 +12,7 @@ export const rules = {
   'ensure-test-runner-nested-count': ensureTestRunnerNestedCount,
   'no-invalid-feature-flag-usage': noInvalidFeatureFlagUsage,
   'no-pre-post-install-scripts': noPreAndPostInstallScripts,
+  'no-invalid-storybook-decorator-usage': noInvalidStorybookDecoratorUsage,
 };
 
 export const configs = {
@@ -21,6 +23,7 @@ export const configs = {
       '@atlaskit/platform/ensure-test-runner-arguments': 'error',
       '@atlaskit/platform/ensure-test-runner-nested-count': 'warn',
       '@atlaskit/platform/no-invalid-feature-flag-usage': 'error',
+      '@atlaskit/platform/no-invalid-storybook-decorator-usage': 'error',
     },
   },
 };

package/src/rules/ensure-feature-flag-registration/__tests__/unit/rule.test.tsx

@@ -27,6 +27,9 @@ describe('with existing platform-feature-flags section', () => {
         'test-flag': {
           type: 'boolean',
         },
+        'string-flag': {
+          type: 'string',
+        },
       },
     };
   });
@@ -37,10 +40,30 @@ describe('with existing platform-feature-flags section', () => {
       {
         code: `getBooleanFF('test-flag')`,
       },
+      {
+        code: `ffTest('test-flag')`,
+      },
     ],
     invalid: [
       {
-        code: `getBooleanFF('invalid-flag')`,
+        code: `ffTest('test-flag-invalid')`,
+        errors: [
+          {
+            messageId: 'featureFlagMissing',
+            suggestions: [
+              {
+                messageId: 'changeFeatureFlag',
+                data: {
+                  closestFlag: 'test-flag',
+                },
+                output: `ffTest('test-flag')`,
+              },
+            ],
+          },
+        ],
+      },
+      {
+        code: `getBooleanFF('test-flag-invalid')`,
         errors: [
           {
             messageId: 'featureFlagMissing',
@@ -56,6 +79,18 @@ describe('with existing platform-feature-flags section', () => {
           },
         ],
       },
+      {
+        code: `getBooleanFF('string-flag')`,
+        errors: [
+          {
+            messageId: 'featureFlagIncorrectType',
+            data: {
+              featureFlag: 'string-flag',
+              expectedType: 'boolean',
+            },
+          },
+        ],
+      },
     ],
   });
 });

package/src/rules/ensure-feature-flag-registration/index.tsx

@@ -4,8 +4,10 @@ import path from 'path';
 import Fuse from 'fuse.js';
 
 // defines a "getter" to "type" map, if more types are required for feature flags (like string) add it here!
+// if you don't want to verify the type use `null` as the value
 const getterIdentifierToFlagTypeMap = {
   getBooleanFF: 'boolean' as const,
+  ffTest: 'boolean' as const,
 } as const;
 
 type PlatformFeatureFlagRegistrationSection = {
@@ -69,6 +71,7 @@ const rule: Rule.RuleModule = {
         'Please add a "platform-feature-flags" section to your package.json! See http://go/pff-eslint for more details',
       featureFlagMissing: `Please add a "{{ featureFlag }}" section to the "platform-feature-flags" section in your package.json. See http://go/pff-eslint for more details`,
       changeFeatureFlag: `Change flag key to "{{ closestFlag }}" already defined in package.json`,
+      featureFlagIncorrectType: `Please change the type for "{{ featureFlag }}" to "{{ expectedType }}" in the section to the "platform-feature-flags" section in your package.json. See http://go/pff-eslint for more details"`,
     },
 
     hasSuggestions: true,
@@ -106,6 +109,25 @@ const rule: Rule.RuleModule = {
               const featureFlag = args[0].value as string;
               const featureFlagRegistration = platformFeatureFlags[featureFlag];
 
+              const expectedType =
+                getterIdentifierToFlagTypeMap[getterIdentifier];
+
+              // ensure the flag type matches what is registered
+              if (
+                featureFlagRegistration != null &&
+                expectedType != null &&
+                featureFlagRegistration?.type !== expectedType
+              ) {
+                return context.report({
+                  node: args[0],
+                  messageId: 'featureFlagIncorrectType',
+                  data: {
+                    featureFlag,
+                    expectedType,
+                  },
+                });
+              }
+
               if (!featureFlagRegistration) {
                 // find the closest match in existing section for suggestion text
                 let closestMatchFix: Rule.SuggestionReportDescriptor | null =

package/src/rules/no-invalid-storybook-decorator-usage/__tests__/unit/rule.test.tsx

@@ -0,0 +1,18 @@
+import { tester } from '../../../../__tests__/utils/_tester';
+import rule from '../../index';
+
+describe('no-invalid-storybook-decorator-usage tests', () => {
+  tester.run('no-invalid-storybook-decorator-usage', rule, {
+    valid: [
+      {
+        code: `withPlatformFeatureFlags({})(<SampleComponent/>)`,
+      },
+    ],
+    invalid: [
+      {
+        code: `const flags = {'uip.sample.color': true}; withPlatformFeatureFlags(flags)(<SampleComponent/>)`,
+        errors: [{ messageId: 'onlyObjectExpression' }],
+      },
+    ],
+  });
+});

package/src/rules/no-invalid-storybook-decorator-usage/index.tsx

@@ -0,0 +1,40 @@
+import type { Rule } from 'eslint';
+
+const STORYBOOK_DECORATOR_IDENTIFIER = 'withPlatformFeatureFlags' as const;
+
+const rule: Rule.RuleModule = {
+  meta: {
+    hasSuggestions: false,
+    docs: {
+      recommended: false,
+    },
+    type: 'problem',
+    messages: {
+      onlyObjectExpression:
+        'Only object literals allowed in the storybook decorator! See http://go/pff-eslint for more details',
+    },
+  },
+  create(context) {
+    return {
+      [`CallExpression[callee.name=/${STORYBOOK_DECORATOR_IDENTIFIER}/]`]: (
+        node: Rule.Node,
+      ) => {
+        // to make typescript happy
+        if (node.type === 'CallExpression') {
+          const args = node.arguments;
+
+          if (args.length === 1 && args[0].type !== 'ObjectExpression') {
+            return context.report({
+              node,
+              messageId: 'onlyObjectExpression',
+            });
+          }
+        }
+
+        return {};
+      },
+    };
+  },
+};
+
+export default rule;

package/tmp/api-report-tmp.d.ts

@@ -16,6 +16,7 @@ export const configs: {
             '@atlaskit/platform/ensure-test-runner-arguments': string;
             '@atlaskit/platform/ensure-test-runner-nested-count': string;
             '@atlaskit/platform/no-invalid-feature-flag-usage': string;
+            '@atlaskit/platform/no-invalid-storybook-decorator-usage': string;
         };
     };
 };
@@ -32,6 +33,7 @@ export const rules: {
     'ensure-test-runner-nested-count': Rule.RuleModule;
     'no-invalid-feature-flag-usage': Rule.RuleModule;
     'no-pre-post-install-scripts': Rule.RuleModule;
+    'no-invalid-storybook-decorator-usage': Rule.RuleModule;
 };
 
 // (No @packageDocumentation comment for this package)