Halfway done

This commit is contained in:
2024-10-19 22:45:27 +01:00
parent 47f56cd473
commit f2e9d5844b
10632 changed files with 1720635 additions and 0 deletions

21
node_modules/eslint-plugin-react-refresh/LICENSE generated vendored Normal file
View File

@@ -0,0 +1,21 @@
MIT License
Copyright (c) Arnaud Barré (https://github.com/ArnaudBarre)
Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:
The above copyright notice and this permission notice shall be included in all
copies or substantial portions of the Software.
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
SOFTWARE.

142
node_modules/eslint-plugin-react-refresh/README.md generated vendored Normal file
View File

@@ -0,0 +1,142 @@
# eslint-plugin-react-refresh [![npm](https://img.shields.io/npm/v/eslint-plugin-react-refresh)](https://www.npmjs.com/package/eslint-plugin-react-refresh)
Validate that your components can safely be updated with fast refresh.
## Limitations
⚠️ To avoid false positive, by default this plugin is only applied on `tsx` & `jsx` files. See options to run on JS files. ⚠️
The plugin rely on naming conventions (i.e. use PascalCase for components, camelCase for util functions). This is why there are some limitations:
- `export *` are not supported and will be reported as an error
- Anonymous function are not supported (i.e `export default function() {}`)
- Class components are not supported
- All-uppercase function export is considered an error when not using direct named export (ex `const CMS = () => <></>; export { CMS }`)
## Installation
```sh
npm i -D eslint-plugin-react-refresh
```
## Usage
```json
{
"plugins": ["react-refresh"],
"rules": {
"react-refresh/only-export-components": "warn"
}
}
```
### Flat config
```js
import reactRefresh from "eslint-plugin-react-refresh";
export default [
{
// in main config for TSX/JSX source files
plugins: {
"react-refresh": reactRefresh,
},
rules: {
"react-refresh/only-export-components": "warn",
},
},
];
```
## Fail
```jsx
export const foo = () => {};
export const Bar = () => <></>;
```
```jsx
export default function () {}
export default compose()(MainComponent)
```
```jsx
export * from "./foo";
```
```jsx
const Tab = () => {};
export const tabs = [<Tab />, <Tab />];
```
```jsx
const App = () => {};
createRoot(document.getElementById("root")).render(<App />);
```
## Pass with allowConstantExport
```jsx
export const CONSTANT = 3;
export const Foo = () => <></>;
```
## Pass
```jsx
export default function Foo() {
return <></>;
}
```
```jsx
const foo = () => {};
export const Bar = () => <></>;
```
```jsx
import { App } from "./App";
createRoot(document.getElementById("root")).render(<App />);
```
## Options
### allowExportNames <small>(v0.4.4)</small>
If you use a framework that handles HMR of some specific exports, you can use this option to avoid warning for them.
Example for [Remix](https://remix.run/docs/en/main/other-api/dev#:~:text=React%20Fast%20Refresh,-can%20only%20handle):
```json
{
"react-refresh/only-export-components": [
"warn",
{ "allowExportNames": ["meta", "links", "headers", "loader", "action"] }
]
}
```
### allowConstantExport <small>(v0.4.0)</small>
Don't warn when a constant (string, number, boolean, templateLiteral) is exported aside one or more components.
This should be enabled if the fast refresh implementation correctly handles this case (HMR when the constant doesn't change, propagate update to importers when the constant changes.). Vite supports it, PR welcome if you notice other integrations works well.
```json
{
"react-refresh/only-export-components": [
"warn",
{ "allowConstantExport": true }
]
}
```
### checkJS <small>(v0.3.3)</small>
If your using JSX inside `.js` files (which I don't recommend because it forces you to configure every tool you use to switch the parser), you can still use the plugin by enabling this option. To reduce the number of false positive, only files importing `react` are checked.
```json
{
"react-refresh/only-export-components": ["warn", { "checkJS": true }]
}
```

234
node_modules/eslint-plugin-react-refresh/index.js generated vendored Normal file
View File

@@ -0,0 +1,234 @@
"use strict";
var __defProp = Object.defineProperty;
var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
var __getOwnPropNames = Object.getOwnPropertyNames;
var __hasOwnProp = Object.prototype.hasOwnProperty;
var __export = (target, all) => {
for (var name in all)
__defProp(target, name, { get: all[name], enumerable: true });
};
var __copyProps = (to, from, except, desc) => {
if (from && typeof from === "object" || typeof from === "function") {
for (let key of __getOwnPropNames(from))
if (!__hasOwnProp.call(to, key) && key !== except)
__defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
}
return to;
};
var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
// src/index.ts
var src_exports = {};
__export(src_exports, {
rules: () => rules
});
module.exports = __toCommonJS(src_exports);
// src/only-export-components.ts
var possibleReactExportRE = /^[A-Z][a-zA-Z0-9]*$/u;
var strictReactExportRE = /^[A-Z][a-zA-Z0-9]*[a-z]+[a-zA-Z0-9]*$/u;
var onlyExportComponents = {
meta: {
messages: {
exportAll: "This rule can't verify that `export *` only exports components.",
namedExport: "Fast refresh only works when a file only exports components. Use a new file to share constants or functions between components.",
anonymousExport: "Fast refresh can't handle anonymous components. Add a name to your export.",
localComponents: "Fast refresh only works when a file only exports components. Move your component(s) to a separate file.",
noExport: "Fast refresh only works when a file has exports. Move your component(s) to a separate file."
},
type: "problem",
schema: [
{
type: "object",
properties: {
allowConstantExport: { type: "boolean" },
checkJS: { type: "boolean" },
allowExportNames: { type: "array", items: { type: "string" } }
},
additionalProperties: false
}
]
},
defaultOptions: [],
create: (context) => {
const {
allowConstantExport = false,
checkJS = false,
allowExportNames
} = context.options[0] ?? {};
const filename = context.getFilename();
if (filename.includes(".test.") || filename.includes(".spec.") || filename.includes(".cy.") || filename.includes(".stories.")) {
return {};
}
const shouldScan = filename.endsWith(".jsx") || filename.endsWith(".tsx") || checkJS && filename.endsWith(".js");
if (!shouldScan)
return {};
const allowExportNamesSet = allowExportNames ? new Set(allowExportNames) : void 0;
return {
Program(program) {
let hasExports = false;
let mayHaveReactExport = false;
let reactIsInScope = false;
const localComponents = [];
const nonComponentExports = [];
const handleLocalIdentifier = (identifierNode) => {
if (identifierNode.type !== "Identifier")
return;
if (possibleReactExportRE.test(identifierNode.name)) {
localComponents.push(identifierNode);
}
};
const handleExportIdentifier = (identifierNode, isFunction, init) => {
if (identifierNode.type !== "Identifier") {
nonComponentExports.push(identifierNode);
return;
}
if (allowExportNamesSet == null ? void 0 : allowExportNamesSet.has(identifierNode.name))
return;
if (allowConstantExport && init && (init.type === "Literal" || // 1, "foo"
init.type === "UnaryExpression" || // -1
init.type === "TemplateLiteral" || // `Some ${template}`
init.type === "BinaryExpression")) {
return;
}
if (isFunction) {
if (possibleReactExportRE.test(identifierNode.name)) {
mayHaveReactExport = true;
} else {
nonComponentExports.push(identifierNode);
}
} else {
if (init && // Switch to allowList?
notReactComponentExpression.has(init.type)) {
nonComponentExports.push(identifierNode);
return;
}
if (!mayHaveReactExport && possibleReactExportRE.test(identifierNode.name)) {
mayHaveReactExport = true;
}
if (!strictReactExportRE.test(identifierNode.name)) {
nonComponentExports.push(identifierNode);
}
}
};
const handleExportDeclaration = (node) => {
var _a, _b;
if (node.type === "VariableDeclaration") {
for (const variable of node.declarations) {
handleExportIdentifier(
variable.id,
canBeReactFunctionComponent(variable.init),
variable.init
);
}
} else if (node.type === "FunctionDeclaration") {
if (node.id === null) {
context.report({ messageId: "anonymousExport", node });
} else {
handleExportIdentifier(node.id, true);
}
} else if (node.type === "CallExpression") {
if (node.callee.type !== "Identifier" || !reactHOCs.has(node.callee.name)) {
context.report({ messageId: "anonymousExport", node });
} else if (((_a = node.arguments[0]) == null ? void 0 : _a.type) === "FunctionExpression" && node.arguments[0].id) {
handleExportIdentifier(node.arguments[0].id, true);
} else if (((_b = node.arguments[0]) == null ? void 0 : _b.type) === "Identifier") {
mayHaveReactExport = true;
} else {
context.report({ messageId: "anonymousExport", node });
}
} else if (node.type === "TSEnumDeclaration") {
nonComponentExports.push(node.id);
}
};
for (const node of program.body) {
if (node.type === "ExportAllDeclaration") {
if (node.exportKind === "type")
continue;
hasExports = true;
context.report({ messageId: "exportAll", node });
} else if (node.type === "ExportDefaultDeclaration") {
hasExports = true;
if (node.declaration.type === "VariableDeclaration" || node.declaration.type === "FunctionDeclaration" || node.declaration.type === "CallExpression") {
handleExportDeclaration(node.declaration);
}
if (node.declaration.type === "Identifier") {
handleExportIdentifier(node.declaration);
}
if (node.declaration.type === "ArrowFunctionExpression") {
context.report({ messageId: "anonymousExport", node });
}
} else if (node.type === "ExportNamedDeclaration") {
hasExports = true;
if (node.declaration)
handleExportDeclaration(node.declaration);
for (const specifier of node.specifiers) {
handleExportIdentifier(
specifier.exported.name === "default" ? specifier.local : specifier.exported
);
}
} else if (node.type === "VariableDeclaration") {
for (const variable of node.declarations) {
handleLocalIdentifier(variable.id);
}
} else if (node.type === "FunctionDeclaration") {
handleLocalIdentifier(node.id);
} else if (node.type === "ImportDeclaration" && node.source.value === "react") {
reactIsInScope = true;
}
}
if (checkJS && !reactIsInScope)
return;
if (hasExports) {
if (mayHaveReactExport) {
for (const node of nonComponentExports) {
context.report({ messageId: "namedExport", node });
}
} else if (localComponents.length) {
for (const node of localComponents) {
context.report({ messageId: "localComponents", node });
}
}
} else if (localComponents.length) {
for (const node of localComponents) {
context.report({ messageId: "noExport", node });
}
}
}
};
}
};
var reactHOCs = /* @__PURE__ */ new Set(["memo", "forwardRef"]);
var canBeReactFunctionComponent = (init) => {
if (!init)
return false;
if (init.type === "ArrowFunctionExpression")
return true;
if (init.type === "CallExpression" && init.callee.type === "Identifier") {
return reactHOCs.has(init.callee.name);
}
return false;
};
var notReactComponentExpression = /* @__PURE__ */ new Set([
"ArrayExpression",
"AwaitExpression",
"BinaryExpression",
"ChainExpression",
"ConditionalExpression",
"Literal",
"LogicalExpression",
"ObjectExpression",
"TemplateLiteral",
"ThisExpression",
"UnaryExpression",
"UpdateExpression"
]);
// src/index.ts
var rules = {
"only-export-components": onlyExportComponents
};
// Annotate the CommonJS export names for ESM import in node:
0 && (module.exports = {
rules
});

19
node_modules/eslint-plugin-react-refresh/package.json generated vendored Normal file
View File

@@ -0,0 +1,19 @@
{
"name": "eslint-plugin-react-refresh",
"description": "Validate that your components can safely be updated with fast refresh",
"version": "0.4.9",
"author": "Arnaud Barré (https://github.com/ArnaudBarre)",
"license": "MIT",
"repository": "github:ArnaudBarre/eslint-plugin-react-refresh",
"main": "index.js",
"keywords": [
"eslint",
"eslint-plugin",
"react",
"react-refresh",
"fast refresh"
],
"peerDependencies": {
"eslint": ">=7"
}
}