@atlaskit/eslint-plugin-design-system/dist/es2019/rules/no-emotion-primitives/index.js

The essential plugin for use with the Atlassian Design System.

import { literal } from 'eslint-codemod-utils';
import { createLintRule } from '../utils/create-lint-rule';
const schema = {
  type: 'array',
  items: [{
    type: 'object',
    properties: {
      autofix: {
        type: 'boolean'
      }
    },
    additionalProperties: false
  }]
};
const defaultConfig = {
  autofix: false
};
function readConfig(context) {
  const [config] = context.options;
  return Object.assign({}, defaultConfig, config);
}
const PACKAGE_NAME = '@atlaskit/primitives';
const COMPILED_PACKAGE_NAME = '@atlaskit/primitives/compiled';

/**
 * The set of Emotion entrypoints that have a direct Compiled equivalent under
 * `@atlaskit/primitives/compiled/<subpath>`. Imports from these entrypoints can be
 * safely autofixed by prefixing the subpath with `compiled/`.
 */
const AUTOFIXABLE_ENTRYPOINTS = new Set(['anchor', 'bleed', 'box', 'flex', 'grid', 'hide', 'inline', 'media-helper', 'metric-text', 'pressable', 'show', 'stack', 'surface-provider', 'text']);

/**
 * Determines whether an import source points at an Emotion `@atlaskit/primitives` entrypoint
 * that should be migrated to Compiled.
 *
 * Returns the suggested Compiled import source to use for the autofix, or `null` when the
 * import should be ignored (i.e. it is not an `@atlaskit/primitives` import, or it is already
 * a Compiled entrypoint).
 *
 * When the import is an Emotion entrypoint that has no direct Compiled equivalent, the rule
 * still reports a violation but there is no safe autofix; in that case the original source is
 * returned so the fixer becomes a no-op replacement.
 */
function getCompiledSource(importSource) {
  // The barrel import, e.g. `@atlaskit/primitives`.
  if (importSource === PACKAGE_NAME) {
    return COMPILED_PACKAGE_NAME;
  }

  // Ignore anything that isn't scoped to `@atlaskit/primitives/...`.
  if (!importSource.startsWith(`${PACKAGE_NAME}/`)) {
    return null;
  }
  const subpath = importSource.slice(`${PACKAGE_NAME}/`.length);

  // Compiled entrypoints (`@atlaskit/primitives/compiled` and `@atlaskit/primitives/compiled/*`)
  // are already valid and should be ignored.
  if (subpath === 'compiled' || subpath.startsWith('compiled/')) {
    return null;
  }

  // Emotion entrypoint with a known Compiled equivalent — safe to autofix.
  if (AUTOFIXABLE_ENTRYPOINTS.has(subpath)) {
    return `${COMPILED_PACKAGE_NAME}/${subpath}`;
  }

  // Emotion entrypoint without a direct Compiled equivalent (e.g. `xcss`, `constants`,
  // `responsive/*`). Report the violation but leave the source unchanged so no broken
  // autofix is produced.
  return importSource;
}
export const rule = createLintRule({
  meta: {
    name: 'no-emotion-primitives',
    type: 'problem',
    fixable: 'code',
    docs: {
      description: 'Ensures usage of Compiled Primitives import instead of Emotion entrypoint.',
      severity: 'warn',
      recommended: false
    },
    messages: {
      'no-emotion-primitives': 'Use @atlaskit/primitives/compiled instead of @atlaskit/primitives. Refer to go/akcss for more information.'
    },
    schema
  },
  create(context) {
    const config = readConfig(context);
    return {
      ImportDeclaration(node) {
        const importSource = node.source.value;
        const compiledSource = getCompiledSource(importSource);
        if (compiledSource === null) {
          return;
        }
        context.report({
          node: node.source,
          messageId: 'no-emotion-primitives',
          fix(fixer) {
            // No safe autofix when there is no Compiled equivalent for this entrypoint.
            if (!config.autofix || compiledSource === importSource) {
              return null;
            }
            const newSource = literal(compiledSource);
            return fixer.replaceText(node.source, newSource.raw || `'${compiledSource}'`);
          }
        });
      }
    };
  }
});

// eslint-disable-next-line @atlaskit/volt-strict-mode/no-multiple-exports
export default rule;