first commit

node_modules/is-reference/README.md

@@ -0,0 +1,61 @@
+# is-reference
+
+Utility for determining whether an AST node is a reference.
+
+`foo` is a reference in these cases:
+
+```js
+console.log(foo);
+var foo;
+function foo() {}
+function bar(foo) {}
+export { foo as x };
+```
+
+`foo` is *not* a reference in these cases:
+
+```js
+var obj = { foo: 1 };
+console.log(obj.foo);
+export { x as foo };
+```
+
+In all cases, `foo` is an `Identifier` node, but the two kinds must be treated differently for the purposes of scope analysis etc. (The examples are non-exhaustive.)
+
+
+## Installation
+
+```bash
+npm install is-reference
+```
+
+
+## Usage
+
+Example using [Acorn](https://github.com/ternjs/acorn) and [estree-walker](https://github.com/Rich-Harris/estree-walker):
+
+```js
+import { parse } from 'acorn';
+import { walk } from 'estree-walker';
+import is_reference from 'is-reference';
+
+const identifiers = [];
+const references = [];
+
+const ast = parse(`var a = b.c;`);
+
+walk(ast, {
+	enter(node, parent) {
+		if (node.type === 'Identifier') identifiers.push(node);
+		if (is_reference(node, parent)) references.push(node);
+	}
+});
+
+identifiers.forEach(node => console.log(node.name)); // a, b, c
+references.forEach(node => console.log(node.name)); // a, b
+```
+
+
+## License
+
+MIT

node_modules/is-reference/package.json

@@ -0,0 +1,48 @@
+{
+	"name": "is-reference",
+	"version": "3.0.3",
+	"description": "Determine whether an AST node is a reference",
+	"type": "module",
+	"module": "src/index.js",
+	"types": "types/index.d.ts",
+	"exports": {
+		"types": "./types/index.d.ts",
+		"import": "./src/index.js"
+	},
+	"files": [
+		"src",
+		"types"
+	],
+	"scripts": {
+		"test": "uvu",
+		"prepublishOnly": "npm test && dts-buddy"
+	},
+	"repository": {
+		"type": "git",
+		"url": "git+https://github.com/Rich-Harris/is-reference.git"
+	},
+	"keywords": [
+		"ast",
+		"javascript",
+		"estree",
+		"acorn"
+	],
+	"author": "Rich Harris",
+	"license": "MIT",
+	"bugs": {
+		"url": "https://github.com/Rich-Harris/is-reference/issues"
+	},
+	"homepage": "https://github.com/Rich-Harris/is-reference#readme",
+	"dependencies": {
+		"@types/estree": "^1.0.6"
+	},
+	"devDependencies": {
+		"acorn": "^8.0.5",
+		"acorn-class-fields": "^1.0.0",
+		"acorn-static-class-features": "^1.0.0",
+		"dts-buddy": "^0.5.3",
+		"estree-walker": "^3.0.0",
+		"typescript": "^5.6.3",
+		"uvu": "^0.5.6"
+	}
+}

node_modules/is-reference/src/index.js

@@ -0,0 +1,51 @@
+/** @import { Node } from 'estree' */
+
+/**
+ * @param {Node} node
+ * @param {Node} parent
+ * @returns {boolean}
+ */
+export default function is_reference(node, parent) {
+	if (node.type === 'MemberExpression') {
+		return !node.computed && is_reference(node.object, node);
+	}
+
+	if (node.type !== 'Identifier') return false;
+
+	switch (parent?.type) {
+		// disregard `bar` in `foo.bar`
+		case 'MemberExpression':
+			return parent.computed || node === parent.object;
+
+		// disregard the `foo` in `class {foo(){}}` but keep it in `class {[foo](){}}`
+		case 'MethodDefinition':
+			return parent.computed;
+
+		// disregard the `meta` in `import.meta`
+		case 'MetaProperty':
+			return parent.meta === node;
+
+		// disregard the `foo` in `class {foo=bar}` but keep it in `class {[foo]=bar}` and `class {bar=foo}`
+		case 'PropertyDefinition':
+			return parent.computed || node === parent.value;
+
+		// disregard the `bar` in `{ bar: foo }`, but keep it in `{ [bar]: foo }`
+		case 'Property':
+			return parent.computed || node === parent.value;
+
+		// disregard the `bar` in `export { foo as bar }` or
+		// the foo in `import { foo as bar }`
+		case 'ExportSpecifier':
+		case 'ImportSpecifier':
+			return node === parent.local;
+
+		// disregard the `foo` in `foo: while (...) { ... break foo; ... continue foo;}`
+		case 'LabeledStatement':
+		case 'BreakStatement':
+		case 'ContinueStatement':
+			return false;
+
+		default:
+			return true;
+	}
+}

node_modules/is-reference/types/index.d.ts

@@ -0,0 +1,8 @@
+declare module 'is-reference' {
+	import type { Node } from 'estree';
+	export default function is_reference(node: Node, parent: Node): boolean;
+
+	export {};
+}
+
+//# sourceMappingURL=index.d.ts.map

node_modules/is-reference/types/index.d.ts.map

@@ -0,0 +1,9 @@
+{
+	"version": 3,
+	"file": "index.d.ts",
+	"names": [],
+	"sources": [],
+	"sourcesContent": [],
+	"mappings": "",
+	"ignoreList": []
+}