@elliemae/pui-cli 9.0.0-alpha.1 → 9.0.0-alpha.11

package/lib/lint-config/eslint/flat/rules.mjs

@@ -0,0 +1,185 @@
+/** Shared rule sets migrated from legacy eslintrc (common.cjs + typescript/*.cjs). */
+
+export const baseRules = {
+  'arrow-body-style': ['error', 'as-needed'],
+  'class-methods-use-this': 'off',
+  'import-x/imports-first': 'off',
+  'import-x/newline-after-import': 'off',
+  'import-x/no-dynamic-require': 'off',
+  // Off — legacy parity; PUI apps import via @elliemae/app-react-dependencies (not direct package.json entries).
+  'import-x/no-extraneous-dependencies': 'off',
+  'import-x/no-named-as-default': 'off',
+  'import-x/no-unresolved': [
+    'error',
+    { caseSensitive: true, caseSensitiveStrict: true },
+  ],
+  'import-x/no-webpack-loader-syntax': 'off',
+  'import-x/prefer-default-export': 'off',
+  'import-x/default': 'off',
+  'import-x/namespace': 'off',
+  'import-x/extensions': [
+    'error',
+    'never',
+    {
+      json: 'ignorePackages',
+      js: 'ignorePackages',
+    },
+  ],
+  complexity: ['error', { max: 10 }],
+  'max-depth': ['error', { max: 4 }],
+  'max-lines-per-function': 'off',
+  'max-nested-callbacks': ['error', { max: 3 }],
+  'max-params': ['error', { max: 3 }],
+  'max-statements': ['error', { max: 20 }],
+  'max-len': 'off',
+  'newline-per-chained-call': 'off',
+  'no-confusing-arrow': 'off',
+  'no-console': 'warn',
+  'no-param-reassign': ['error', { props: false }],
+  'prefer-template': 'error',
+  'require-yield': 'off',
+};
+
+/** Relaxed type-checked rules for test files (shared by default and strict configs). */
+export const typescriptTestRelaxedRules = {
+  '@typescript-eslint/no-unsafe-assignment': 'off',
+  '@typescript-eslint/no-unsafe-member-access': 'off',
+  '@typescript-eslint/no-unsafe-call': 'off',
+  '@typescript-eslint/no-unsafe-argument': 'off',
+  '@typescript-eslint/no-unsafe-return': 'off',
+  '@typescript-eslint/unbound-method': 'off',
+  '@typescript-eslint/no-unsafe-declaration-merging': 'off',
+  '@typescript-eslint/no-unsafe-enum-comparison': 'off',
+  '@typescript-eslint/await-thenable': 'off',
+  '@typescript-eslint/prefer-promise-reject-errors': 'off',
+  'no-constant-binary-expression': 'off',
+  'valid-typeof': 'off',
+  'prefer-const': 'off',
+};
+
+/** Relaxed core rules for generated test fixture JS (checksum mocks, etc.). */
+export const testFixtureRelaxedRules = {
+  'no-unused-vars': 'off',
+  'no-console': 'off',
+  'max-lines': 'off',
+  'max-statements': 'off',
+  complexity: 'off',
+};
+
+export const jsRules = {
+  ...baseRules,
+  'max-lines': ['error', { max: 120, skipComments: true }],
+  'no-unused-vars': 'error',
+};
+
+export const typescriptRules = {
+  ...baseRules,
+  'max-lines': ['error', { max: 200, skipComments: true }],
+  '@typescript-eslint/explicit-module-boundary-types': 'off',
+  '@typescript-eslint/explicit-function-return-type': 'off',
+  '@typescript-eslint/no-use-before-define': [
+    'error',
+    { functions: false, classes: true, variables: true, typedefs: true },
+  ],
+  '@typescript-eslint/unbound-method': ['error', { ignoreStatic: true }],
+  '@typescript-eslint/no-floating-promises': ['error', { ignoreIIFE: true }],
+  '@typescript-eslint/no-misused-promises': [
+    'error',
+    { checksVoidReturn: { attributes: false } },
+  ],
+  '@typescript-eslint/no-unsafe-assignment': 'warn',
+  '@typescript-eslint/no-unsafe-member-access': 'warn',
+  '@typescript-eslint/no-unsafe-call': 'warn',
+  '@typescript-eslint/no-unsafe-argument': 'warn',
+  '@typescript-eslint/no-unsafe-return': 'warn',
+  '@typescript-eslint/consistent-type-imports': [
+    'error',
+    { prefer: 'type-imports', fixStyle: 'inline-type-imports' },
+  ],
+  '@typescript-eslint/no-import-type-side-effects': 'error',
+  'no-unused-vars': 'off',
+  '@typescript-eslint/no-unused-vars': [
+    'error',
+    { argsIgnorePattern: '^_', ignoreRestSiblings: true },
+  ],
+};
+
+/** Stricter TypeScript rules (error on unsafe any usage). */
+export const typescriptStrictRules = {
+  ...typescriptRules,
+  '@typescript-eslint/no-unsafe-assignment': 'error',
+  '@typescript-eslint/no-unsafe-member-access': 'error',
+  '@typescript-eslint/no-unsafe-call': 'error',
+  '@typescript-eslint/no-unsafe-argument': 'error',
+  '@typescript-eslint/no-unsafe-return': 'error',
+};
+
+export const reactRules = {
+  'jsx-a11y/aria-props': 'error',
+  'jsx-a11y/heading-has-content': 'off',
+  'jsx-a11y/label-has-associated-control': [
+    'error',
+    {
+      controlComponents: ['Input'],
+    },
+  ],
+  'jsx-a11y/label-has-for': 'off',
+  'jsx-a11y/mouse-events-have-key-events': 'error',
+  'jsx-a11y/role-has-required-aria-props': 'error',
+  'jsx-a11y/role-supports-aria-props': 'error',
+  'react/destructuring-assignment': 'off',
+  'react-hooks/rules-of-hooks': 'error',
+  'react-hooks/exhaustive-deps': 'warn',
+  'react/jsx-closing-tag-location': 'off',
+  'react/forbid-prop-types': 'off',
+  'react/jsx-first-prop-new-line': ['error', 'multiline'],
+  'react/jsx-no-target-blank': 'off',
+  'react/jsx-props-no-spreading': 'off',
+  'react/jsx-uses-vars': 'error',
+  'react/require-default-props': 'off',
+  'react/require-extension': 'off',
+  'react/self-closing-comp': 'off',
+  'react/sort-comp': 'off',
+  'react/react-in-jsx-scope': 'off',
+  'react/jsx-filename-extension': [
+    'warn',
+    { extensions: ['.js', '.jsx', '.tsx', '.mdx'] },
+  ],
+  'react/function-component-definition': [
+    'error',
+    { namedComponents: 'arrow-function' },
+  ],
+  'react/prop-types': 'off',
+  'redux-saga/no-yield-in-race': 'error',
+  'redux-saga/yield-effects': 'error',
+};
+
+/** Stricter React rules (exhaustive-deps as error). */
+export const reactStrictRules = {
+  ...reactRules,
+  'react-hooks/exhaustive-deps': 'error',
+};
+
+export const ignorePatterns = [
+  '**/build/**',
+  '**/node_modules/**',
+  '**/dist/**',
+  '**/reports/**',
+  '**/allure-report/**',
+  '**/coverage/**',
+  '**/demo/**',
+  '**/docs/**',
+  '**/docs/api/**',
+  '**/temp/**',
+  '**/.tmp/**',
+  '**/public/**',
+  '**/webroot/**',
+  '**/cdn/**',
+  '**/.docusaurus/**',
+  '**/vendor/*.js',
+  '**/.nx/**',
+  '**/pnpm-lock.yaml',
+  '**/.scannerwork/**',
+  '**/stats.json',
+  '**/jsconfig.json',
+];

package/lib/lint-config/eslint/non-react.cjs

@@ -0,0 +1,14 @@
+const {
+  baseExtends,
+  baseRules,
+  baseOverrides,
+  baseConfig,
+} = require('./common.cjs');
+const { tsConfig } = require('./typescript/non-react.cjs');
+
+exports.esConfig = {
+  ...baseConfig,
+  extends: ['airbnb-base'].concat(baseExtends),
+  rules: baseRules,
+  overrides: baseOverrides.concat([tsConfig]),
+};

package/lib/lint-config/eslint/react.cjs

@@ -0,0 +1,26 @@
+const {
+  baseExtends,
+  baseRules,
+  baseOverrides,
+  baseConfig,
+  reactRules,
+} = require('./common.cjs');
+const { tsReactConfig } = require('./typescript/react.cjs');
+
+exports.esReactConfig = {
+  ...baseConfig,
+  extends: ['airbnb', 'airbnb/hooks', 'plugin:redux-saga/recommended'].concat(
+    baseExtends,
+  ),
+  rules: {
+    ...baseRules,
+    ...reactRules,
+  },
+  overrides: baseOverrides.concat([
+    tsReactConfig,
+    {
+      files: '*.mdx',
+      extends: 'plugin:mdx/recommended',
+    },
+  ]),
+};

package/lib/lint-config/eslint/typescript/common.cjs

@@ -0,0 +1,49 @@
+const { baseExtends, basePlugins } = require('../common.cjs');
+
+exports.tsBaseExtends = [
+  'plugin:@typescript-eslint/recommended',
+  'plugin:import/typescript',
+  'plugin:@typescript-eslint/recommended-requiring-type-checking',
+].concat(baseExtends);
+
+exports.tsBaseRules = {
+  '@typescript-eslint/explicit-module-boundary-types': 'off',
+  '@typescript-eslint/explicit-function-return-type': 'off',
+  '@typescript-eslint/no-use-before-define': [
+    'error',
+    { functions: false, classes: true, variables: true, typedefs: true },
+  ],
+  'max-lines': ['error', { max: 200, skipComments: true }],
+  '@typescript-eslint/unbound-method': [
+    'error',
+    {
+      ignoreStatic: true,
+    },
+  ],
+  '@typescript-eslint/no-floating-promises': [
+    'error',
+    {
+      ignoreIIFE: true,
+    },
+  ],
+};
+
+exports.tsBaseConfig = {
+  files: ['*.ts', '*.tsx'],
+  parser: '@typescript-eslint/parser',
+  plugins: ['@typescript-eslint'].concat(basePlugins),
+  parserOptions: {
+    tsconfigRootDir: process.cwd(),
+    project: true,
+  },
+  settings: {
+    'import/resolver': {
+      typescript: {
+        alwaysTryTypes: true,
+      },
+    },
+    'import/parsers': {
+      '@typescript-eslint/parser': ['.ts', '.tsx'],
+    },
+  },
+};

package/lib/lint-config/eslint/typescript/non-react.cjs

@@ -0,0 +1,12 @@
+ 
+const { baseRules } = require('../common.cjs');
+const { tsBaseExtends, tsBaseRules, tsBaseConfig } = require('./common.cjs');
+
+exports.tsConfig = {
+  ...tsBaseConfig,
+  extends: ['airbnb-base', 'airbnb-typescript/base'].concat(tsBaseExtends),
+  rules: {
+    ...baseRules,
+    ...tsBaseRules,
+  },
+};

package/lib/lint-config/eslint/typescript/react.cjs

@@ -0,0 +1,19 @@
+ 
+const { baseRules, reactRules } = require('../common.cjs');
+const { tsBaseExtends, tsBaseRules, tsBaseConfig } = require('./common.cjs');
+
+exports.tsReactConfig = {
+  ...tsBaseConfig,
+  extends: [
+    'airbnb',
+    'airbnb/hooks',
+    'plugin:redux-saga/recommended',
+    'airbnb-typescript',
+  ].concat(tsBaseExtends),
+  rules: {
+    ...baseRules,
+    ...tsBaseRules,
+    ...reactRules,
+    'react/prop-types': 0,
+  },
+};

package/lib/lint-config/lint-staged.config.js

@@ -0,0 +1,15 @@
+import path from "node:path";
+import fs from "node:fs";
+
+const npmClient = fs.existsSync(path.join(process.cwd(), "pnpm-lock.yaml"))
+  ? "pnpm"
+  : "npm";
+
+export const lintStagedConfig = {
+  "*.{js,ts,jsx,tsx,md,mdx,html,css,json}": ["prettier --write"],
+  "*.{ts,tsx}": [`${npmClient} run tscheck`],
+  "*.{js,ts,jsx,tsx}": [
+    `${npmClient} run lint:fix`,
+    `${npmClient} run test:staged`,
+  ],
+};

package/lib/lint-config/prettier.config.cjs

@@ -0,0 +1,8 @@
+exports.prettierConfig = {
+  printWidth: 80,
+  tabWidth: 2,
+  useTabs: false,
+  semi: true,
+  singleQuote: true,
+  trailingComma: 'all',
+};

package/lib/lint-config/stylelint/config.mjs

@@ -0,0 +1,27 @@
+/** @type {import('stylelint').Config} */
+export const stylelintConfig = {
+  ignoreFiles: [
+    '/dist/**/*',
+    '/coverage/**/*',
+    '/build/**/*',
+    '/reports/**/*',
+    '/temp/**/*',
+    '/docs/**/*',
+    '/demo/**/*',
+    '/node_modules/**/*',
+    '/vendor/**/*',
+  ],
+  customSyntax: 'postcss-styled-syntax',
+  extends: ['stylelint-config-recommended'],
+  rules: {
+    'selector-type-no-unknown': null,
+    'function-no-unknown': null,
+    // Formerly from stylelint-config-styled-components (unmaintained; references
+    // removed rules like no-missing-end-of-source-newline in Stylelint 17).
+    'value-no-vendor-prefix': true,
+    'property-no-vendor-prefix': true,
+    'no-empty-source': null,
+  },
+};
+
+export default stylelintConfig;

package/lib/lint-config/stylelint/export.mjs

@@ -0,0 +1 @@
+export { stylelintConfig, default } from './config.mjs';

package/lib/lint-config/stylelint.config.cjs

@@ -0,0 +1,3 @@
+const { stylelintConfig } = require('./stylelint/export.mjs');
+
+exports.stylelintConfig = stylelintConfig;

package/lib/release.config.mjs

@@ -0,0 +1,28 @@
+/** @type {import('semantic-release').GlobalConfig} */
+export default {
+  branches: [
+    '+([0-9])?(.{+([0-9]),x}).x',
+    'master',
+    'main',
+    'next-major',
+    { name: 'beta', prerelease: true },
+    { name: 'alpha', prerelease: true },
+    { name: 'rc', prerelease: true },
+    { name: 'hotfix', prerelease: true },
+    { name: 'next', prerelease: true },
+  ],
+  plugins: [
+    '@semantic-release/commit-analyzer',
+    '@semantic-release/release-notes-generator',
+    [
+      '@semantic-release/changelog',
+      {
+        changelogTitle:
+          '# Changelog\n\nAll notable changes to this project will be documented in this file. See\n[Conventional Commits](https://conventionalcommits.org) for commit guidelines.',
+      },
+    ],
+    '@semantic-release/npm',
+    './semantic-release-plugin.mjs',
+    '@semantic-release/github',
+  ],
+};

package/lib/semantic-release-plugin.mjs

@@ -0,0 +1,30 @@
+import fs from 'node:fs';
+import path from 'node:path';
+
+/**
+ * Semantic Release plugin to write publish info and set dist tag
+ * @see https://semantic-release.gitbook.io/semantic-release/developer-guide/plugin
+ */
+export default {
+  success: async (pluginConfig, context) => {
+    const { nextRelease, logger } = context;
+
+    if (!nextRelease) {
+      logger?.log?.('No release information available');
+      return;
+    }
+
+    if (!nextRelease.channel) {
+      nextRelease.channel = 'latest';
+    }
+    const fname = path.join(process.cwd(), 'publish-info.json');
+
+    try {
+      fs.writeFileSync(fname, JSON.stringify(nextRelease, null, 2));
+      logger?.log?.(`Wrote publish info to ${fname}`);
+    } catch (error) {
+      logger?.error?.(`Failed to write publish info: ${error.message}`);
+      throw error;
+    }
+  },
+};