@atlaskit/eslint-plugin-platform 2.7.2 → 2.8.0

package/dist/cjs/rules/import/shared/perf.js

@@ -0,0 +1,89 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.PERF_ENV_VAR = void 0;
+exports.isPerfEnabled = isPerfEnabled;
+exports.perfInc = perfInc;
+exports.perfTime = perfTime;
+var PERF_ENV_VAR = exports.PERF_ENV_VAR = 'INTERNAL_ESLINT_BARREL_PERF';
+function nowMs() {
+  // eslint-disable-next-line no-restricted-globals
+  return typeof performance !== 'undefined' && performance.now ? performance.now() : Date.now();
+}
+function isPerfEnabled() {
+  return process.env[PERF_ENV_VAR] === '1' || process.env[PERF_ENV_VAR] === 'true';
+}
+function ensurePerfInitialized(_ref) {
+  var fs = _ref.fs;
+  if (!fs.cache.perf) {
+    fs.cache.perf = {
+      installedExitHook: false,
+      counters: {},
+      timers: {}
+    };
+  }
+}
+function ensureExitHookInstalled(_ref2) {
+  var fs = _ref2.fs;
+  if (!isPerfEnabled()) {
+    return;
+  }
+  ensurePerfInitialized({
+    fs: fs
+  });
+  if (fs.cache.perf.installedExitHook) {
+    return;
+  }
+  fs.cache.perf.installedExitHook = true;
+  // eslint-disable-next-line no-console
+  console.error("[eslint-plugin-internal] perf enabled via ".concat(PERF_ENV_VAR));
+  process.once('exit', function () {
+    var _fs$cache$perf$counte, _fs$cache$perf, _fs$cache$perf$timers, _fs$cache$perf2;
+    // eslint-disable-next-line no-console
+    console.error("[eslint-plugin-internal] perf exit hook fired (".concat(PERF_ENV_VAR, ")"));
+    // eslint-disable-next-line no-console
+    console.log("[eslint-plugin-internal] perf summary (".concat(PERF_ENV_VAR, ")"));
+    // eslint-disable-next-line no-console
+    console.log(JSON.stringify({
+      counters: (_fs$cache$perf$counte = (_fs$cache$perf = fs.cache.perf) === null || _fs$cache$perf === void 0 ? void 0 : _fs$cache$perf.counters) !== null && _fs$cache$perf$counte !== void 0 ? _fs$cache$perf$counte : {},
+      timers: (_fs$cache$perf$timers = (_fs$cache$perf2 = fs.cache.perf) === null || _fs$cache$perf2 === void 0 ? void 0 : _fs$cache$perf2.timers) !== null && _fs$cache$perf$timers !== void 0 ? _fs$cache$perf$timers : {}
+    }, null, 2));
+  });
+}
+function perfInc(_ref3) {
+  var _perf$counters$key;
+  var fs = _ref3.fs,
+    key = _ref3.key,
+    _ref3$by = _ref3.by,
+    by = _ref3$by === void 0 ? 1 : _ref3$by;
+  if (!isPerfEnabled()) {
+    return;
+  }
+  ensureExitHookInstalled({
+    fs: fs
+  });
+  var perf = fs.cache.perf;
+  perf.counters[key] = ((_perf$counters$key = perf.counters[key]) !== null && _perf$counters$key !== void 0 ? _perf$counters$key : 0) + by;
+}
+function perfTime(_ref4) {
+  var fs = _ref4.fs,
+    key = _ref4.key,
+    fn = _ref4.fn;
+  if (!isPerfEnabled()) {
+    return fn();
+  }
+  ensureExitHookInstalled({
+    fs: fs
+  });
+  var perf = fs.cache.perf;
+  var start = nowMs();
+  try {
+    return fn();
+  } finally {
+    var _perf$timers$key;
+    var duration = nowMs() - start;
+    perf.timers[key] = ((_perf$timers$key = perf.timers[key]) !== null && _perf$timers$key !== void 0 ? _perf$timers$key : 0) + duration;
+  }
+}

package/dist/cjs/rules/import/shared/types.js

@@ -0,0 +1,67 @@
+"use strict";
+
+var _interopRequireDefault = require("@babel/runtime/helpers/interopRequireDefault");
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.realFileSystem = void 0;
+var _defineProperty2 = _interopRequireDefault(require("@babel/runtime/helpers/defineProperty"));
+var _child_process = require("child_process");
+var _fs = require("fs");
+function ownKeys(e, r) { var t = Object.keys(e); if (Object.getOwnPropertySymbols) { var o = Object.getOwnPropertySymbols(e); r && (o = o.filter(function (r) { return Object.getOwnPropertyDescriptor(e, r).enumerable; })), t.push.apply(t, o); } return t; }
+function _objectSpread(e) { for (var r = 1; r < arguments.length; r++) { var t = null != arguments[r] ? arguments[r] : {}; r % 2 ? ownKeys(Object(t), !0).forEach(function (r) { (0, _defineProperty2.default)(e, r, t[r]); }) : Object.getOwnPropertyDescriptors ? Object.defineProperties(e, Object.getOwnPropertyDescriptors(t)) : ownKeys(Object(t)).forEach(function (r) { Object.defineProperty(e, r, Object.getOwnPropertyDescriptor(t, r)); }); } return e; }
+/**
+ * Directory entry returned by readdirSync with withFileTypes option.
+ */
+
+/**
+ * State for the package registry cache.
+ * This is used to cache package name to directory mappings for efficient lookups.
+ */
+
+/**
+ * Cache structure for file system operations.
+ * Contains both package registry cache and workspace root cache.
+ */
+
+/**
+ * File system abstraction for testability.
+ * This interface allows the core logic to be tested with mock file systems.
+ * The cache property holds package resolution state and can be passed as an empty
+ * object for tests to ensure fresh state for each test case.
+ */
+
+/**
+ * Real file system implementation using Node.js fs module.
+ */
+var realFileSystem = exports.realFileSystem = {
+  existsSync: _fs.existsSync,
+  readFileSync: _fs.readFileSync,
+  realpathSync: _fs.realpathSync,
+  statSync: _fs.statSync,
+  readdirSync: function readdirSync(path, options) {
+    return (0, _fs.readdirSync)(path, options);
+  },
+  execSync: function execSync(command, options) {
+    try {
+      return (0, _child_process.execSync)(command, _objectSpread(_objectSpread({}, options), {}, {
+        encoding: 'utf-8'
+      })).trim();
+    } catch (_unused) {
+      return null;
+    }
+  },
+  cache: {}
+};
+
+/**
+ * Information about cross-package re-export origin.
+ */
+
+/**
+ * Information about where an export originates.
+ */
+
+/**
+ * Context for package resolution operations.
+ */

package/dist/es2019/index.js

@@ -13,7 +13,6 @@ import ensureNoPrivateDependencies from './rules/ensure-no-private-dependencies'
 import expandBorderShorthand from './rules/compiled/expand-border-shorthand';
 import noInvalidStorybookDecoratorUsage from './rules/no-invalid-storybook-decorator-usage';
 import ensurePublishValid from './rules/ensure-publish-valid';
-import ensureNativeAndAfExportsSynced from './rules/ensure-native-and-af-exports-synced';
 import noModuleLevelEval from './rules/feature-gating/no-module-level-eval';
 import noModuleLevelEvalNav4 from './rules/feature-gating/no-module-level-eval-nav4';
 import staticFeatureFlags from './rules/feature-gating/static-feature-flags';
@@ -23,12 +22,18 @@ import preferFG from './rules/feature-gating/prefer-fg';
 import noAlias from './rules/feature-gating/no-alias';
 import useEntrypointsInExamples from './rules/use-entrypoints-in-examples';
 import useRecommendedUtils from './rules/feature-gating/use-recommended-utils';
+import validGateName from './rules/feature-gating/valid-gate-name';
 import expandBackgroundShorthand from './rules/compiled/expand-background-shorthand';
 import expandSpacingShorthand from './rules/compiled/expand-spacing-shorthand';
 import noSparseCheckout from './rules/no-sparse-checkout';
 import noDirectDocumentUsage from './rules/no-direct-document-usage';
 import noSetImmediate from './rules/no-set-immediate';
 import preferCryptoRandomUuid from './rules/prefer-crypto-random-uuid';
+import noBarrelEntryImports from './rules/import/no-barrel-entry-imports';
+import noBarrelEntryJestMock from './rules/import/no-barrel-entry-jest-mock';
+import noJestMockBarrelFiles from './rules/import/no-jest-mock-barrel-files';
+import noRelativeBarrelFileImports from './rules/import/no-relative-barrel-file-imports';
+import noConversationAssistantBarrelImports from './rules/import/no-conversation-assistant-barrel-imports';
 import { join, normalize } from 'node:path';
 import { readFileSync } from 'node:fs';
 let jiraRoot;
@@ -64,7 +69,6 @@ const rules = {
   'no-pre-post-install-scripts': noPreAndPostInstallScripts,
   'no-invalid-storybook-decorator-usage': noInvalidStorybookDecoratorUsage,
   'ensure-publish-valid': ensurePublishValid,
-  'ensure-native-and-af-exports-synced': ensureNativeAndAfExportsSynced,
   'no-module-level-eval': noModuleLevelEval,
   'no-module-level-eval-nav4': noModuleLevelEvalNav4,
   'static-feature-flags': staticFeatureFlags,
@@ -74,10 +78,16 @@ const rules = {
   'no-alias': noAlias,
   'use-entrypoints-in-examples': useEntrypointsInExamples,
   'use-recommended-utils': useRecommendedUtils,
+  'valid-gate-name': validGateName,
   'no-sparse-checkout': noSparseCheckout,
   'no-direct-document-usage': noDirectDocumentUsage,
   'no-set-immediate': noSetImmediate,
-  'prefer-crypto-random-uuid': preferCryptoRandomUuid
+  'prefer-crypto-random-uuid': preferCryptoRandomUuid,
+  'no-barrel-entry-imports': noBarrelEntryImports,
+  'no-barrel-entry-jest-mock': noBarrelEntryJestMock,
+  'no-jest-mock-barrel-files': noJestMockBarrelFiles,
+  'no-relative-barrel-file-imports': noRelativeBarrelFileImports,
+  'no-conversation-assistant-barrel-imports': noConversationAssistantBarrelImports
 };
 const commonConfig = {
   '@atlaskit/platform/ensure-test-runner-arguments': 'error',
@@ -108,6 +118,7 @@ const recommendedRules = {
   '@atlaskit/platform/inline-usage': 'error',
   '@atlaskit/platform/prefer-fg': 'error',
   '@atlaskit/platform/no-alias': 'error',
+  '@atlaskit/platform/valid-gate-name': 'error',
   // end: feature-gating rules
   '@atlaskit/platform/ensure-feature-flag-registration': 'error'
 };

package/dist/es2019/rules/feature-gating/valid-gate-name/index.js

@@ -0,0 +1,52 @@
+import { FEATURE_API_IMPORT_SOURCES } from '../../constants';
+import { isIdentifierImportedFrom } from '../utils';
+const IMPORT_SOURCES = new Set([...FEATURE_API_IMPORT_SOURCES, '@atlassian/jira-feature-flagging-utils', '@atlassian/jira-feature-gate-component']);
+const FUNCTION_NAMES = new Set(['ff', 'fg', 'getFeatureFlagValue', 'componentWithFF', 'componentWithFG', 'passGate', 'withGate', 'expVal', 'expValEquals', 'UNSAFE_noExposureExp', 'mockExp', 'withExp', 'wasExperimentManuallyExposed']);
+
+/**
+ * Valid gate names must only contain lowercase letters (a-z), numbers (0-9),
+ * underscores (_), hyphens (-), and dots (.).
+ * No spaces, capital letters, or other characters are allowed.
+ */
+const VALID_GATE_NAME_PATTERN = /^[a-z0-9_.-]+$/;
+function isValidGateName(name) {
+  return VALID_GATE_NAME_PATTERN.test(name);
+}
+const rule = {
+  meta: {
+    type: 'problem',
+    docs: {
+      description: 'Ensure feature gate names contain only lowercase letters, numbers, underscores, and hyphens'
+    },
+    messages: {
+      invalidGateName: 'Feature gate name "{{name}}" is invalid. Gate names must contain only lowercase letters (a-z), numbers (0-9), underscores (_), hyphens (-), and dots (.).'
+    }
+  },
+  create(context) {
+    return {
+      'CallExpression[callee.type="Identifier"][arguments.length>0][arguments.0.type="Literal"]': node => {
+        if (node.type !== 'CallExpression') {
+          return;
+        }
+        if (node.callee.type === 'Identifier' && (!FUNCTION_NAMES.has(node.callee.name) || !isIdentifierImportedFrom(node.callee.name, IMPORT_SOURCES, context, node))) {
+          return;
+        }
+        const nameArgument = node.arguments[0];
+        if (nameArgument.type !== 'Literal' || typeof nameArgument.value !== 'string') {
+          return;
+        }
+        const gateName = nameArgument.value;
+        if (!isValidGateName(gateName)) {
+          context.report({
+            node: nameArgument,
+            messageId: 'invalidGateName',
+            data: {
+              name: gateName
+            }
+          });
+        }
+      }
+    };
+  }
+};
+export default rule;