immosquare-cleaner 0.1.42 → 0.1.44

data/node_modules/jscodeshift/src/collections/ImportDeclaration.js

@@ -0,0 +1,113 @@
+/**
+ * Copyright (c) Facebook, Inc. and its affiliates.
+ *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ */
+
+"use strict";
+
+const Collection = require("../Collection");
+const NodeCollection = require("./Node");
+
+const assert = require("assert");
+const once = require("../utils/once");
+const recast = require("recast");
+
+const types = recast.types.namedTypes;
+
+const globalMethods = {
+  /**
+   * Inserts an ImportDeclaration at the top of the AST
+   *
+   * @param {string} sourcePath
+   * @param {Array} specifiers
+   */
+  insertImportDeclaration: function (sourcePath, specifiers) {
+    assert.ok(
+      sourcePath && typeof sourcePath === "string",
+      "insertImportDeclaration(...) needs a source path"
+    );
+
+    assert.ok(
+      specifiers && Array.isArray(specifiers),
+      "insertImportDeclaration(...) needs an array of specifiers"
+    );
+
+    if (this.hasImportDeclaration(sourcePath)) {
+      return this;
+    }
+
+    const importDeclaration = recast.types.builders.importDeclaration(
+      specifiers,
+      recast.types.builders.stringLiteral(sourcePath)
+    );
+
+    return this.forEach((path) => {
+      if (path.value.type === "Program") {
+        path.value.body.unshift(importDeclaration);
+      }
+    });
+  },
+  /**
+   * Finds all ImportDeclarations optionally filtered by name
+   *
+   * @param {string} sourcePath
+   * @return {Collection}
+   */
+  findImportDeclarations: function (sourcePath) {
+    assert.ok(
+      sourcePath && typeof sourcePath === "string",
+      "findImportDeclarations(...) needs a source path"
+    );
+
+    return this.find(types.ImportDeclaration, {
+      source: { value: sourcePath },
+    });
+  },
+
+  /**
+   * Determines if the collection has an ImportDeclaration with the given sourcePath
+   *
+   * @param {string} sourcePath
+   * @returns {boolean}
+   */
+  hasImportDeclaration: function (sourcePath) {
+    assert.ok(
+      sourcePath && typeof sourcePath === "string",
+      "findImportDeclarations(...) needs a source path"
+    );
+
+    return this.findImportDeclarations(sourcePath).length > 0;
+  },
+
+  /**
+   * Renames all ImportDeclarations with the given name
+   *
+   * @param {string} sourcePath
+   * @param {string} newSourcePath
+   * @return {Collection}
+   */
+  renameImportDeclaration: function (sourcePath, newSourcePath) {
+    assert.ok(
+      sourcePath && typeof sourcePath === "string",
+      "renameImportDeclaration(...) needs a name to look for"
+    );
+
+    assert.ok(
+      newSourcePath && typeof newSourcePath === "string",
+      "renameImportDeclaration(...) needs a new name to rename to"
+    );
+
+    return this.findImportDeclarations(sourcePath).forEach((path) => {
+      path.value.source.value = newSourcePath;
+    });
+  },
+};
+
+function register() {
+  NodeCollection.register();
+  Collection.registerMethods(globalMethods, types.Node);
+}
+
+exports.register = once(register);

data/node_modules/jscodeshift/src/collections/index.js

@@ -10,4 +10,5 @@ module.exports = {
   Node: require('./Node'),
   JSXElement: require('./JSXElement'),
   VariableDeclarator: require('./VariableDeclarator'),
+  ImportDeclaration: require('./ImportDeclaration'),
 };

data/node_modules/jscodeshift/utils/testUtils.js

@@ -9,14 +9,13 @@
 'use strict';
 
 const fs = require('fs');
-const mkdirp = require('mkdirp');
 const path = require('path');
 const temp = require('temp');
 
 function renameFileTo(oldPath, newFilename, extension = '') {
   const projectPath = path.dirname(oldPath);
   const newPath = path.join(projectPath, newFilename + extension);
-  mkdirp.sync(path.dirname(newPath));
+  fs.mkdirSync(path.dirname(newPath), { recursive: true });
   fs.renameSync(oldPath, newPath);
   return newPath;
 }

data/node_modules/jscodeshift/website/README.md

@@ -0,0 +1,44 @@
+# jscodeshift docs
+
+[![Built with Starlight](https://astro.badg.es/v2/built-with-starlight/tiny.svg)](https://starlight.astro.build)
+
+## 🚀 Project Structure
+
+```
+.
+├── public/
+├── src/
+│   ├── assets/
+│   ├── content/
+│   │   ├── docs/
+│   │   └── config.ts
+│   └── env.d.ts
+├── astro.config.mjs
+├── package.json
+└── tsconfig.json
+```
+
+Starlight looks for `.md` or `.mdx` files in the `src/content/docs/` directory. Each file is exposed as a route based on
+its file name.
+
+Images can be added to `src/assets/` and embedded in Markdown with a relative link.
+
+Static assets, like favicons, can be placed in the `public/` directory.
+
+## 🧞 Commands
+
+All commands are run from the root of the project, from a terminal:
+
+| Command                | Action                                           |
+|:-----------------------|:-------------------------------------------------|
+| `yarn install`         | Installs dependencies                            |
+| `yarn dev`             | Starts local dev server at `localhost:4321`      |
+| `yarn build`           | Build your production site to `./dist/`          |
+| `yarn preview`         | Preview your build locally, before deploying     |
+| `yarn astro ...`       | Run CLI commands like `astro add`, `astro check` |
+| `yarn astro -- --help` | Get help using the Astro CLI                     |
+
+## 👀 Want to learn more?
+
+Check out [Starlight’s docs](https://starlight.astro.build/), read [the Astro documentation](https://docs.astro.build),
+or jump into the [Astro Discord server](https://astro.build/chat).

data/node_modules/jscodeshift/website/astro.config.mjs

@@ -0,0 +1,36 @@
+import {defineConfig} from 'astro/config';
+import starlight from '@astrojs/starlight';
+
+// https://astro.build/config
+export default defineConfig({
+  integrations: [
+    starlight({
+      title: 'jscodeshift',
+      social: {
+        github: 'https://github.com/facebook/jscodeshift',
+      },
+      sidebar: [
+        {
+          label: 'Overview',
+          items: [
+            // Each item here is one entry in the navigation menu.
+            {label: 'Introduction', link: '/overview/introduction/'},
+          ],
+        },
+        {
+          label: 'Building',
+          items: [
+            {label: 'API Reference', link: '/build/api-reference/'},
+            {label: 'AST Grammar', link: '/build/ast-grammar/'},
+          ],
+        },
+        {
+          label: 'Running',
+          items: [
+            {label: 'CLI', link: '/run/cli/'},
+          ],
+        },
+      ],
+    }),
+  ],
+});

data/node_modules/jscodeshift/website/package.json

@@ -0,0 +1,17 @@
+{
+  "name": "docs",
+  "type": "module",
+  "version": "0.0.1",
+  "scripts": {
+    "dev": "astro dev",
+    "start": "astro dev",
+    "build": "astro build",
+    "preview": "astro preview",
+    "astro": "astro"
+  },
+  "dependencies": {
+    "@astrojs/starlight": "^0.24.4",
+    "astro": "^4.10.2",
+    "sharp": "^0.32.5"
+  }
+}

data/node_modules/jscodeshift/website/public/favicon.svg

@@ -0,0 +1 @@
+<svg id="Layer_1" data-name="Layer 1" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" viewBox="0 0 287.56 191"><defs><style>.cls-1{fill:#0081fb;}.cls-2{fill:url(#linear-gradient);}.cls-3{fill:url(#linear-gradient-2);}</style><linearGradient id="linear-gradient" x1="62.34" y1="101.45" x2="260.34" y2="91.45" gradientTransform="matrix(1, 0, 0, -1, 0, 192)" gradientUnits="userSpaceOnUse"><stop offset="0" stop-color="#0064e1"/><stop offset="0.4" stop-color="#0064e1"/><stop offset="0.83" stop-color="#0073ee"/><stop offset="1" stop-color="#0082fb"/></linearGradient><linearGradient id="linear-gradient-2" x1="41.42" y1="53" x2="41.42" y2="126" gradientTransform="matrix(1, 0, 0, -1, 0, 192)" gradientUnits="userSpaceOnUse"><stop offset="0" stop-color="#0082fb"/><stop offset="1" stop-color="#0064e0"/></linearGradient></defs><title>facebook-meta</title><path class="cls-1" d="M31.06,126c0,11,2.41,19.41,5.56,24.51A19,19,0,0,0,53.19,160c8.1,0,15.51-2,29.79-21.76,11.44-15.83,24.92-38,34-52l15.36-23.6c10.67-16.39,23-34.61,37.18-47C181.07,5.6,193.54,0,206.09,0c21.07,0,41.14,12.21,56.5,35.11,16.81,25.08,25,56.67,25,89.27,0,19.38-3.82,33.62-10.32,44.87C271,180.13,258.72,191,238.13,191V160c17.63,0,22-16.2,22-34.74,0-26.42-6.16-55.74-19.73-76.69-9.63-14.86-22.11-23.94-35.84-23.94-14.85,0-26.8,11.2-40.23,31.17-7.14,10.61-14.47,23.54-22.7,38.13l-9.06,16c-18.2,32.27-22.81,39.62-31.91,51.75C84.74,183,71.12,191,53.19,191c-21.27,0-34.72-9.21-43-23.09C3.34,156.6,0,141.76,0,124.85Z"/><path class="cls-2" d="M24.49,37.3C38.73,15.35,59.28,0,82.85,0c13.65,0,27.22,4,41.39,15.61,15.5,12.65,32,33.48,52.63,67.81l7.39,12.32c17.84,29.72,28,45,33.93,52.22,7.64,9.26,13,12,19.94,12,17.63,0,22-16.2,22-34.74l27.4-.86c0,19.38-3.82,33.62-10.32,44.87C271,180.13,258.72,191,238.13,191c-12.8,0-24.14-2.78-36.68-14.61-9.64-9.08-20.91-25.21-29.58-39.71L146.08,93.6c-12.94-21.62-24.81-37.74-31.68-45C107,40.71,97.51,31.23,82.35,31.23c-12.27,0-22.69,8.61-31.41,21.78Z"/><path class="cls-3" d="M82.35,31.23c-12.27,0-22.69,8.61-31.41,21.78C38.61,71.62,31.06,99.34,31.06,126c0,11,2.41,19.41,5.56,24.51L10.14,167.91C3.34,156.6,0,141.76,0,124.85,0,94.1,8.44,62.05,24.49,37.3,38.73,15.35,59.28,0,82.85,0Z"/></svg>

data/node_modules/jscodeshift/website/src/content/config.ts

@@ -0,0 +1,6 @@
+import {defineCollection} from 'astro:content';
+import {docsSchema} from '@astrojs/starlight/schema';
+
+export const collections = {
+  docs: defineCollection({schema: docsSchema()}),
+};

data/node_modules/jscodeshift/website/src/content/docs/build/api-reference.mdx

@@ -0,0 +1,406 @@
+---
+title: API Reference
+---
+
+import {Steps, LinkCard, Card, CardGrid} from '@astrojs/starlight/components';
+
+`jscodeshift` has around 25 APIs to help developers easily detect and transform any JS/TS code.
+
+Generally, creating a codemod involves two main tasks: **detection** and **transformation**.
+
+<Steps>
+  1. **Detection**
+
+      Detecting a specific pattern in a large codebase can be expensive, so this task is often divided into two passes.
+
+      <Steps>
+        1. **First pass**
+
+            In the first pass, we perform an initial scope reduction of the AST nodes to significantly reduce the search space and produce a collection of AST nodes to process.
+        2. **Second pass**
+
+            In the second pass, we process and filter the nodes collection to pinpoint the specific AST nodes that need transformation.
+      </Steps>
+
+  2. **Transformation**
+
+      Once we detect the desired nodes, we transform the AST and produce the modified code.
+</Steps>
+
+For jscodeshift, we have a set of APIs for each part of the codemod process (initial traversal, filtering, transformation), as detailed below. jscodeshift accepts `—parser` as argument. We can select from the list of parser that are currently supported, all those parsers should be compatible with `estree` spec and have same AST grammar. It's important to know the AST grammar for describing the nodes in the codemod.
+
+Refer to the [`jscodeshift` node types](/build/ast-grammar/).
+
+## Building jscodeshift codemods
+
+<CardGrid>
+  <LinkCard title="Core API" href="#core-api"/>
+  <LinkCard title="Node Traversal APIs" href="#node-traversal-apis"/>
+  <LinkCard title="Node Transformation APIs" href="#node-transformation-apis"/>
+</CardGrid>
+
+## Core API
+
+### **`jscodeshift`**
+
+The main function that returns the jscodeshift instance.
+
+**Parameters**: `source` (String): The source code to be transformed.
+
+**Example**:
+
+```jsx
+const jscodeshift = require('jscodeshift');
+const sourceCode = `const a = 1;`;
+const j = jscodeshift(sourceCode);
+```
+
+## Node Traversal APIs
+
+Below are APIs that often used in the **initial scope reduction** phase ([source](https://github.com/facebook/jscodeshift/blob/4851fc8a01036868efb4cf9676f3e97836097376/src/collections/Node.js#L139)). The input is usually the whole file, and the output is a collection of nodes.
+
+### **`find`**
+
+Finds nodes that match the provided type.
+
+**Parameters**: `type` (String or Function): The type of nodes to find.
+
+**Example**:
+
+```jsx
+const variableDeclarations = j.find(j.VariableDeclaration);
+```
+
+### **`closestScope`**
+
+Finds the closest enclosing scope of a node. Useful for determining the scope context of variables and functions.
+
+**Example**:
+
+```jsx
+const closestScopes = j.find(j.Identifier).closestScope();
+```
+
+### **`closest`**
+
+Finds the nearest parent node that matches the specified type. The child node must be obtained from a previous function call, such as find.
+
+**Parameters**:`type` (String or Function): The type of ancestor to find.
+
+```jsx
+const closestFunction = j.find(j.Identifier).closest(j.FunctionDeclaration);
+```
+
+### **`getVariableDeclarators`**
+
+Retrieves variable declarators from the current collection. If the callback function returns a falsy value, the element is not included in the result.
+
+**Parameters**:`callback` (Function): A function that returns the name of the variable to find.
+
+**Example**:
+
+```jsx
+const variableDeclarators = j.find(j.Identifier).getVariableDeclarators(path => path.value.name);
+```
+
+### **`findVariableDeclarators` ([source](https://github.com/facebook/jscodeshift/blob/main/src/collections/VariableDeclarator.js))**
+
+Finds variable declarators by name.
+
+**Parameters**: `name` (String): The name of the variable to find.
+
+**Example**:
+
+```jsx
+const variableDeclarators = j.findVariableDeclarators('a');
+```
+
+Below are the APIs that are often used in the second phase, which is the **detailed node filtering** ([source](https://github.com/facebook/jscodeshift/blob/4851fc8a01036868efb4cf9676f3e97836097376/src/Collection.js)). The input of this phase is usually a collection of nodes, and the output, is specific nodes to transform.
+
+### **`filter`**
+
+Filters nodes based on a predicate function.
+
+**Parameters**: `predicate` (Function): A function to test each element.
+
+**Example**:
+
+```jsx
+const constDeclarations = j.find(j.VariableDeclaration)
+  .filter(path => path.node.kind === 'const');
+```
+
+### **`forEach`**
+
+Iterates over each node in the collection.
+
+**Parameters**: `callback` (Function): A function to call for each node.
+
+**Example**:
+
+```jsx
+j.find(j.VariableDeclaration).forEach(path => {
+  console.log(path.node);
+});
+```
+
+### `some`
+
+`some` checks if at least one element in the collection passes the test implemented by the provided function.
+
+**Parameters:** `callback`: A function that tests each element. The callback function takes three arguments:
+
+- `path`: The current element being processed.
+- `index`: The index of the current element.
+- `array`: The array `some` was called upon.
+
+**Example:**
+
+```jsx
+const j = require('jscodeshift');
+
+const root = j(`const a = 1; const b = 2; const c = 3;`);
+
+const hasVariableA = root.find(j.VariableDeclarator).some(path => path.node.id.name === 'a');
+console.log(hasVariableA); // true
+
+```
+
+### `every`
+
+`every` checks if all elements in the collection pass the test implemented by the provided function.
+
+**Parameters:** `callback`: A function that tests each element. The callback function takes three arguments:
+
+- `path`: The current element being processed.
+- `index`: The index of the current element.
+- `array`: The array `every` was called upon.
+
+**Example:**
+
+```jsx
+const j = require('jscodeshift');
+
+const root = j(`const a = 1; const b = 2; const c = 3;`);
+
+const allAreConst = root.find(j.VariableDeclaration).every(path => path.node.kind === 'const');
+console.log(allAreConst); // true
+
+```
+
+### **`map`**
+
+Maps each node in the collection to a new value.
+
+**Parameters**:`callback` (Function): A function to call for each node.
+
+**Example**:
+
+```jsx
+const variableNames = j.find(j.VariableDeclaration)
+  .map(path => path.node.declarations.map(decl => decl.id.name));
+```
+
+### **`size`**
+
+Returns the number of nodes in the collection.
+
+**Example**:
+
+```jsx
+const numberOfNodes = j.find(j.VariableDeclaration).size();
+```
+
+### `length`
+
+`length` returns the number of elements in the collection.
+
+**Example:**
+
+```jsx
+const j = require('jscodeshift');
+
+const root = j(`const a = 1; const b = 2; const c = 3;`);
+
+const varCount = root.find(j.VariableDeclarator).length;
+console.log(varCount); // 3
+
+```
+
+### **`nodes`**
+
+Returns the AST nodes in the collection.
+
+**Example**:
+
+```jsx
+const nodes = j.find(j.VariableDeclaration).nodes();
+```
+
+### **`paths`**
+
+Returns the paths of the found nodes.
+
+**Example**:
+
+```jsx
+const paths = j.find(j.VariableDeclaration).paths();
+```
+
+### `getAST`
+
+`getAST` returns the root AST node of the collection.
+
+**Example:**
+
+```jsx
+const j = require('jscodeshift');
+
+const root = j(`const a = 1;`);
+
+const ast = root.getAST();
+console.log(ast.type); // File
+
+```
+
+### **`get`**
+
+Gets the first node in the collection.
+
+**Example**:
+
+```jsx
+const firstVariableDeclaration = j.find(j.VariableDeclaration).get();
+```
+
+### **`at`**
+
+Navigates to a specific path in the AST.
+
+**Parameters**: `index` (Number): The index of the path to navigate to.
+
+**Example**:
+
+```jsx
+const secondVariableDeclaration = j.find(j.VariableDeclaration).at(1);
+```
+
+### `getTypes`
+
+`getTypes` returns the set of node types present in the collection.
+
+**Example:**
+
+```jsx
+const j = require('jscodeshift');
+
+const root = j(`const a = 1; const b = 2;`);
+
+const types = root.find(j.VariableDeclarator).getTypes();
+console.log(types); // Set { 'VariableDeclarator' }
+
+```
+
+### `isOfType`
+
+`isOfType` checks if the node in the collection is of a specific type.
+
+**Parameters:** `type`: The type to check against.
+
+**Example:**
+
+```jsx
+const j = require('jscodeshift');
+
+const root = j(`const a = 1;`);
+
+const isVariableDeclarator = root.find(j.VariableDeclarator).at(0).isOfType('VariableDeclarator');
+console.log(isVariableDeclarator); // true
+
+```
+
+## Node Transformation APIs
+
+Below are the APIs used in node transformations. ([source](https://github.com/facebook/jscodeshift/blob/4851fc8a01036868efb4cf9676f3e97836097376/src/collections/Node.js#L139))
+
+### **`replaceWith`**
+
+Replaces the current node(s) with a new node.
+
+**Parameters**: `newNode` (Node or Function): The new node or a function that returns a new node.
+
+**Example**:
+
+```jsx
+j.find(j.Identifier)
+  .replaceWith(path => j.identifier(path.node.name.toUpperCase()));
+```
+
+### **`insertBefore`**
+
+Inserts a node before the current node.
+
+**Parameters**: `newNode` (Node): The node to insert.
+
+**Example**:
+
+```jsx
+j.find(j.FunctionDeclaration)
+  .insertBefore(j.expressionStatement(j.stringLiteral('Inserted before')));
+```
+
+### **`insertAfter`**
+
+Inserts a node after the current node.
+
+**Parameters**: `newNode` (Node): The node to insert.
+
+**Example**:
+
+```jsx
+j.find(j.FunctionDeclaration)
+  .insertAfter(j.expressionStatement(j.stringLiteral('Inserted after')));
+```
+
+### **`remove`**
+
+Removes the current node(s).
+
+**Example**:
+
+```jsx
+j.find(j.VariableDeclaration).remove();
+```
+
+### `renameTo` ([source](https://github.com/facebook/jscodeshift/blob/main/src/collections/VariableDeclarator.js))
+
+`renameTo` renames the nodes in the collection to a new name.
+
+**Parameters:** `newName`: The new name to rename to.
+
+**Example:**
+
+```jsx
+const j = require('jscodeshift');
+
+const root = j(`const a = 1; const b = 2;`);
+
+root.find(j.Identifier, { name: 'a' }).renameTo('x');
+
+console.log(root.toSource()); // const x = 1; const b = 2;
+
+```
+
+These descriptions and examples should give you a clear understanding of how to use each of these jscodeshift APIs.
+
+### **`toSource`**
+
+Converts the transformed AST back to source code.
+
+**Parameters**: `options` (Object): Optional formatting options.
+
+**Example**:
+
+```jsx
+const transformedSource = j.toSource({ quote: 'single' });
+```