@ripple-ts/eslint-plugin 0.2.153

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Dominic Gannaway
+
+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.

package/README.md

@@ -0,0 +1,266 @@
+# @ripple-ts/eslint-plugin
+
+ESLint plugin for [Ripple](https://ripple-ts.com) - helps enforce best practices and catch common mistakes when writing Ripple applications.
+
+Works just like `eslint-plugin-react` - simply install and use the recommended config!
+
+## Installation
+
+```bash
+npm install --save-dev '@ripple-ts/eslint-plugin'
+# or
+yarn add --dev '@ripple-ts/eslint-plugin'
+# or
+pnpm add --save-dev '@ripple-ts/eslint-plugin'
+```
+
+## Usage
+
+### Flat Config (ESLint 9+)
+
+```js
+// eslint.config.js
+import ripple from '@ripple-ts/eslint-plugin';
+
+export default [...ripple.configs.recommended];
+```
+
+The plugin automatically:
+
+- Detects and uses `@ripple-ts/eslint-parser` if installed for `.ripple` files
+- Detects and uses `@typescript-eslint/parser` if installed for `.ts`/`.tsx` files
+- Excludes `.d.ts` files, `node_modules`, `dist`, and `build` directories from linting
+- Works with both `.ts`/`.tsx` and `.ripple` files
+
+### Legacy Config (.eslintrc)
+
+```json
+{
+  "plugins": ["ripple"],
+  "extends": ["plugin:ripple/recommended"]
+}
+```
+
+## Configurations
+
+### `recommended`
+
+The recommended configuration enables all rules at their default severity levels (errors and warnings).
+
+```js
+import ripple from '@ripple-ts/eslint-plugin';
+
+export default [
+  {
+    plugins: { ripple },
+    rules: ripple.configs.recommended.rules,
+  },
+];
+```
+
+### `strict`
+
+The strict configuration enables all rules as errors.
+
+```js
+import ripple from '@ripple-ts/eslint-plugin';
+
+export default [
+  {
+    plugins: { ripple },
+    rules: ripple.configs.strict.rules,
+  },
+];
+```
+
+## Rules
+
+### `ripple/no-module-scope-track` (error)
+
+Prevents calling `track()` at module scope. Tracked values must be created within a component context.
+
+❌ **Incorrect:**
+
+```js
+import { track } from 'ripple';
+
+// This will cause runtime errors
+let globalCount = track(0);
+
+export component App() {
+  <div>{@globalCount}</div>
+}
+```
+
+✅ **Correct:**
+
+```js
+import { track } from 'ripple';
+
+export component App() {
+  // track() called within component
+  let count = track(0);
+
+  <div>{@count}</div>
+}
+```
+
+### `ripple/require-component-export` (warning)
+
+Warns when capitalized components are not exported. This helps ensure components are reusable across modules.
+
+❌ **Incorrect:**
+
+```js
+component MyButton() {
+  <button>Click me</button>
+}
+// MyButton is defined but not exported
+```
+
+✅ **Correct:**
+
+```js
+export component MyButton() {
+  <button>Click me</button>
+}
+```
+
+### `ripple/prefer-oninput` (warning, fixable)
+
+Recommends using `onInput` instead of `onChange` for form inputs. Unlike React, Ripple doesn't have synthetic events, so `onInput` is the correct event handler.
+
+❌ **Incorrect:**
+
+```jsx
+<input onChange={handleChange} />
+```
+
+✅ **Correct:**
+
+```jsx
+<input onInput={handleInput} />
+```
+
+This rule is auto-fixable with `--fix`.
+
+### `ripple/no-return-in-component` (error)
+
+Prevents returning JSX from Ripple components. In Ripple, JSX should be used as statements, not expressions.
+
+❌ **Incorrect:**
+
+```js
+export component App() {
+  return <div>Hello World</div>;
+}
+```
+
+✅ **Correct:**
+
+```js
+export component App() {
+  <div>Hello World</div>
+}
+```
+
+### `ripple/unbox-tracked-values` (error)
+
+Ensures tracked values are unboxed with the `@` operator when used in JSX expressions.
+
+❌ **Incorrect:**
+
+```js
+export component App() {
+  let count = track(0);
+
+  // Missing @ operator
+  <div>{count}</div>
+}
+```
+
+✅ **Correct:**
+
+```js
+export component App() {
+  let count = track(0);
+
+  // Properly unboxed with @
+  <div>{@count}</div>
+}
+```
+
+### `ripple/no-introspect-in-modules` (error)
+
+Prevents using the `@` introspection operator in TypeScript/JavaScript modules. In `.ts`/`.js` files, you should use `get()` and `set()` functions instead.
+
+❌ **Incorrect:**
+
+```ts
+// count.ts
+export function useCount() {
+  const count = track(1);
+  effect(() => {
+    console.log(@count); // Error: Cannot use @ in TypeScript modules
+  });
+  return { count };
+}
+```
+
+✅ **Correct:**
+
+```ts
+// count.ts
+import { get, set } from 'ripple';
+
+export function useCount() {
+  const count = track(1);
+
+  // Use get() to read tracked values
+  const double = derived(() => get(count) * 2);
+
+  effect(() => {
+    console.log('count is', get(count));
+  });
+
+  return { count, double };
+}
+```
+
+**Note:** The `@` operator is only valid in `.ripple` component files. In TypeScript modules, use `get()` to read values and `set()` to update them.
+
+## Custom Configuration
+
+You can customize individual rules in your ESLint config:
+
+```js
+export default [
+  {
+    plugins: { ripple },
+    rules: {
+      'ripple/no-module-scope-track': 'error',
+      'ripple/require-component-export': 'off', // Disable this rule
+      'ripple/prefer-oninput': 'error', // Make this an error instead of warning
+      'ripple/no-return-in-component': 'error',
+      'ripple/unbox-tracked-values': 'error',
+      'ripple/no-introspect-in-modules': 'error',
+    },
+  },
+];
+```
+
+The plugin will automatically detect and use the Ripple parser for your `.ripple` files.
+
+## License
+
+MIT
+
+## Contributing
+
+Contributions are welcome! Please feel free to submit a Pull Request.
+
+## Related
+
+- [Ripple](https://ripple-ts.com) - The Ripple framework
+- [@ripple-ts/vite-plugin](https://www.npmjs.com/package/@ripple-ts/vite-plugin) - Vite plugin for Ripple
+- [@ripple-ts/prettier-plugin](https://www.npmjs.com/package/@ripple-ts/prettier-plugin) - Prettier plugin for Ripple

package/dist/index.d.ts

@@ -0,0 +1,21 @@
+import * as eslint0 from "eslint";
+
+//#region src/index.d.ts
+declare const plugin: {
+  meta: {
+    name: string;
+    version: string;
+  };
+  rules: {
+    'no-module-scope-track': eslint0.Rule.RuleModule;
+    'prefer-oninput': eslint0.Rule.RuleModule;
+    'no-return-in-component': eslint0.Rule.RuleModule;
+    'unbox-tracked-values': eslint0.Rule.RuleModule;
+    'control-flow-jsx': eslint0.Rule.RuleModule;
+    'no-introspect-in-modules': eslint0.Rule.RuleModule;
+  };
+  configs: any;
+};
+//#endregion
+export { plugin as default };
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","names":[],"sources":["../src/index.ts"],"sourcesContent":[],"mappings":";;;cAQM;;;IAAA,OAcL,EAAA,MAAA;EAAA,CAAA"}

package/dist/index.js

@@ -0,0 +1,355 @@
+import { createRequire } from "module";
+
+//#region src/rules/no-module-scope-track.ts
+const rule$5 = {
+	meta: {
+		type: "problem",
+		docs: {
+			description: "Disallow calling track() at module scope",
+			category: "Possible Errors",
+			recommended: true
+		},
+		messages: { moduleScope: "track() cannot be called at module scope. It must be called within a component context." },
+		schema: []
+	},
+	create(context) {
+		let componentDepth = 0;
+		let functionDepth = 0;
+		const incrementComponentDepth = () => componentDepth++;
+		const decrementComponentDepth = () => componentDepth--;
+		const incrementFunctionDepth = () => functionDepth++;
+		const decrementFunctionDepth = () => functionDepth--;
+		return {
+			"Component": incrementComponentDepth,
+			"Component:exit": decrementComponentDepth,
+			"FunctionDeclaration": incrementFunctionDepth,
+			"FunctionDeclaration:exit": decrementFunctionDepth,
+			"FunctionExpression": incrementFunctionDepth,
+			"FunctionExpression:exit": decrementFunctionDepth,
+			"ArrowFunctionExpression": incrementFunctionDepth,
+			"ArrowFunctionExpression:exit": decrementFunctionDepth,
+			CallExpression(node) {
+				if (node.callee.type === "Identifier" && node.callee.name === "track" && componentDepth === 0 && functionDepth === 0) context.report({
+					node,
+					messageId: "moduleScope"
+				});
+			}
+		};
+	}
+};
+var no_module_scope_track_default = rule$5;
+
+//#endregion
+//#region src/rules/prefer-oninput.ts
+const rule$4 = {
+	meta: {
+		type: "suggestion",
+		docs: {
+			description: "Prefer onInput over onChange for form inputs in Ripple",
+			category: "Best Practices",
+			recommended: true
+		},
+		messages: { preferOnInput: "Use \"onInput\" instead of \"onChange\". Ripple does not have synthetic events like React." },
+		fixable: "code",
+		schema: []
+	},
+	create(context) {
+		return {
+			"JSXAttribute[name.name=\"onChange\"]"(node) {
+				context.report({
+					node,
+					messageId: "preferOnInput",
+					fix(fixer) {
+						return fixer.replaceText(node.name, "onInput");
+					}
+				});
+			},
+			"Attribute[name.name=\"onChange\"]"(node) {
+				context.report({
+					node,
+					messageId: "preferOnInput",
+					fix(fixer) {
+						return fixer.replaceText(node.name, "onInput");
+					}
+				});
+			},
+			"Property[key.name=\"onChange\"]"(node) {
+				if (context.sourceCode.getAncestors(node).some((ancestor) => ancestor.type === "ObjectExpression")) context.report({
+					node,
+					messageId: "preferOnInput",
+					fix(fixer) {
+						return fixer.replaceText(node.key, "onInput");
+					}
+				});
+			}
+		};
+	}
+};
+var prefer_oninput_default = rule$4;
+
+//#endregion
+//#region src/rules/no-return-in-component.ts
+const rule$3 = {
+	meta: {
+		type: "problem",
+		docs: {
+			description: "Disallow return statements with JSX in Ripple components",
+			category: "Possible Errors",
+			recommended: true
+		},
+		messages: { noReturn: "Do not return JSX from Ripple components. Use JSX as statements instead." },
+		schema: []
+	},
+	create(context) {
+		let insideComponent = 0;
+		return {
+			"ExpressionStatement > CallExpression[callee.name='component']"() {
+				insideComponent++;
+			},
+			"ExpressionStatement > CallExpression[callee.name='component']:exit"() {
+				insideComponent--;
+			},
+			"VariableDeclarator[init.callee.name=\"component\"]"() {
+				insideComponent++;
+			},
+			"VariableDeclarator[init.callee.name=\"component\"]:exit"() {
+				insideComponent--;
+			},
+			ReturnStatement(node) {
+				if (insideComponent > 0 && node.argument) {
+					if (node.argument.type === "JSXElement" || node.argument.type === "JSXFragment") context.report({
+						node,
+						messageId: "noReturn"
+					});
+				}
+			}
+		};
+	}
+};
+var no_return_in_component_default = rule$3;
+
+//#endregion
+//#region src/rules/unbox-tracked-values.ts
+const rule$2 = {
+	meta: {
+		type: "problem",
+		docs: {
+			description: "Ensure tracked values are unboxed with @ operator",
+			category: "Possible Errors",
+			recommended: true
+		},
+		messages: { needsUnbox: "Tracked value should be unboxed with @ operator. Did you mean \"@{{name}}\"?" },
+		schema: []
+	},
+	create(context) {
+		const trackedVariables = /* @__PURE__ */ new Set();
+		function isInJSXContext(node) {
+			let parent = node.parent;
+			while (parent) {
+				const parentType = parent.type;
+				if (parentType === "JSXExpressionContainer" || parentType === "JSXElement" || parentType === "JSXFragment" || parentType === "ExpressionContainer" || parentType === "Element") return true;
+				parent = parent.parent;
+			}
+			return false;
+		}
+		function checkTrackedIdentifier(node) {
+			if (trackedVariables.has(node.name) && isInJSXContext(node)) {
+				const parent = node.parent;
+				let isUnboxed = parent && parent.type === "UnaryExpression" && parent.operator === "@";
+				if (!isUnboxed) isUnboxed = context.getSourceCode().text.substring(Math.max(0, node.range[0] - 1), node.range[0]) === "@";
+				if (!isUnboxed) context.report({
+					node,
+					messageId: "needsUnbox",
+					data: { name: node.name }
+				});
+			}
+		}
+		return {
+			"VariableDeclarator[init.callee.name=\"track\"]"(node) {
+				if (node.id.type === "Identifier") trackedVariables.add(node.id.name);
+			},
+			Identifier(node) {
+				checkTrackedIdentifier(node);
+			}
+		};
+	}
+};
+var unbox_tracked_values_default = rule$2;
+
+//#endregion
+//#region src/rules/control-flow-jsx.ts
+const rule$1 = {
+	meta: {
+		type: "problem",
+		docs: {
+			description: "Require JSX in for...of loops within components, but disallow JSX in for...of loops within effects",
+			category: "Possible Errors",
+			recommended: true
+		},
+		messages: {
+			requireJsxInLoop: "For...of loops in component bodies should contain JSX elements. Use JSX to render items.",
+			noJsxInEffectLoop: "For...of loops inside effect() should not contain JSX. Effects are for side effects, not rendering."
+		},
+		schema: []
+	},
+	create(context) {
+		let insideComponent = 0;
+		let insideEffect = 0;
+		function containsJSX(node, visited = /* @__PURE__ */ new Set()) {
+			if (!node) return false;
+			if (visited.has(node)) return false;
+			visited.add(node);
+			if (node.type === "JSXElement" || node.type === "JSXFragment" || node.type === "Element") return true;
+			const keys = Object.keys(node);
+			for (const key of keys) {
+				if (key === "parent" || key === "loc" || key === "range") continue;
+				const value = node[key];
+				if (value && typeof value === "object") {
+					if (Array.isArray(value)) {
+						for (const item of value) if (item && typeof item === "object" && containsJSX(item, visited)) return true;
+					} else if (value.type && containsJSX(value, visited)) return true;
+				}
+			}
+			return false;
+		}
+		return {
+			Component() {
+				insideComponent++;
+			},
+			"Component:exit"() {
+				insideComponent--;
+			},
+			"CallExpression[callee.name='effect']"() {
+				insideEffect++;
+			},
+			"CallExpression[callee.name='effect']:exit"() {
+				insideEffect--;
+			},
+			ForOfStatement(node) {
+				if (insideComponent === 0) return;
+				const hasJSX = containsJSX(node.body);
+				if (insideEffect > 0) {
+					if (hasJSX) context.report({
+						node,
+						messageId: "noJsxInEffectLoop"
+					});
+				} else if (!hasJSX) context.report({
+					node,
+					messageId: "requireJsxInLoop"
+				});
+			}
+		};
+	}
+};
+var control_flow_jsx_default = rule$1;
+
+//#endregion
+//#region src/rules/no-introspect-in-modules.ts
+const rule = {
+	meta: {
+		type: "problem",
+		docs: {
+			description: "Disallow @ introspection operator in TypeScript/JavaScript modules",
+			category: "Possible Errors",
+			recommended: true
+		},
+		messages: { noIntrospect: "The @ operator cannot be used in TypeScript/JavaScript modules. Use get() to read tracked values and set() to update them instead." },
+		schema: []
+	},
+	create(context) {
+		const filename = context.filename || context.getFilename();
+		if (filename && filename.endsWith(".ripple")) return {};
+		return { Identifier(node) {
+			if (node.tracked === true) context.report({
+				node,
+				messageId: "noIntrospect"
+			});
+		} };
+	}
+};
+var no_introspect_in_modules_default = rule;
+
+//#endregion
+//#region src/index.ts
+const plugin = {
+	meta: {
+		name: "@ripple-ts/eslint-plugin",
+		version: "0.1.3"
+	},
+	rules: {
+		"no-module-scope-track": no_module_scope_track_default,
+		"prefer-oninput": prefer_oninput_default,
+		"no-return-in-component": no_return_in_component_default,
+		"unbox-tracked-values": unbox_tracked_values_default,
+		"control-flow-jsx": control_flow_jsx_default,
+		"no-introspect-in-modules": no_introspect_in_modules_default
+	},
+	configs: {}
+};
+const require = createRequire(import.meta.url);
+let rippleParser;
+let tsParser;
+try {
+	rippleParser = require("@ripple-ts/eslint-parser");
+} catch {
+	rippleParser = null;
+}
+try {
+	tsParser = require("@typescript-eslint/parser");
+} catch {
+	tsParser = null;
+}
+function createConfig(name, files, parser) {
+	const config = {
+		name,
+		files,
+		plugins: { ripple: plugin },
+		rules: {
+			"ripple/no-module-scope-track": "error",
+			"ripple/prefer-oninput": "warn",
+			"ripple/no-return-in-component": "error",
+			"ripple/unbox-tracked-values": "error",
+			"ripple/control-flow-jsx": "error",
+			"ripple/no-introspect-in-modules": "error"
+		}
+	};
+	if (parser) config.languageOptions = {
+		parser,
+		parserOptions: {
+			ecmaVersion: "latest",
+			sourceType: "module"
+		}
+	};
+	return config;
+}
+plugin.configs.recommended = [
+	createConfig("ripple/recommended-ripple-files", ["**/*.ripple"], rippleParser),
+	createConfig("ripple/recommended-typescript-files", ["**/*.ts", "**/*.tsx"], tsParser),
+	{
+		name: "ripple/ignores",
+		ignores: [
+			"**/*.d.ts",
+			"**/node_modules/**",
+			"**/dist/**",
+			"**/build/**"
+		]
+	}
+];
+plugin.configs.strict = [
+	createConfig("ripple/strict-ripple-files", ["**/*.ripple"], rippleParser),
+	createConfig("ripple/strict-typescript-files", ["**/*.ts", "**/*.tsx"], tsParser),
+	{
+		name: "ripple/ignores",
+		ignores: [
+			"**/*.d.ts",
+			"**/node_modules/**",
+			"**/dist/**",
+			"**/build/**"
+		]
+	}
+];
+var src_default = plugin;
+
+//#endregion
+export { src_default as default };
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","names":["rule: Rule.RuleModule","rule","rule: Rule.RuleModule","rule","rule: Rule.RuleModule","rule","rule: Rule.RuleModule","rule","rule: Rule.RuleModule","rule","rule: Rule.RuleModule","noModuleScopeTrack","preferOnInput","noReturnInComponent","unboxTrackedValues","controlFlowJsx","noIntrospectInModules","rippleParser: any","tsParser: any","config: any"],"sources":["../src/rules/no-module-scope-track.ts","../src/rules/prefer-oninput.ts","../src/rules/no-return-in-component.ts","../src/rules/unbox-tracked-values.ts","../src/rules/control-flow-jsx.ts","../src/rules/no-introspect-in-modules.ts","../src/index.ts"],"sourcesContent":["import type { Rule } from 'eslint';\nimport type { CallExpression } from 'estree';\n\nconst rule: Rule.RuleModule = {\n  meta: {\n    type: 'problem',\n    docs: {\n      description: 'Disallow calling track() at module scope',\n      category: 'Possible Errors',\n      recommended: true,\n    },\n    messages: {\n      moduleScope: 'track() cannot be called at module scope. It must be called within a component context.',\n    },\n    schema: [],\n  },\n  create(context) {\n    let componentDepth = 0;\n    let functionDepth = 0;\n\n    const incrementComponentDepth = () => componentDepth++;\n    const decrementComponentDepth = () => componentDepth--;\n    const incrementFunctionDepth = () => functionDepth++;\n    const decrementFunctionDepth = () => functionDepth--;\n\n    return {\n      // Only track when we enter a Ripple component\n      // Ripple's parser returns \"Component\" nodes for component declarations\n      'Component': incrementComponentDepth,\n      'Component:exit': decrementComponentDepth,\n\n      // Track regular functions and arrow functions\n      'FunctionDeclaration': incrementFunctionDepth,\n      'FunctionDeclaration:exit': decrementFunctionDepth,\n      'FunctionExpression': incrementFunctionDepth,\n      'FunctionExpression:exit': decrementFunctionDepth,\n      'ArrowFunctionExpression': incrementFunctionDepth,\n      'ArrowFunctionExpression:exit': decrementFunctionDepth,\n\n      // Check track() calls\n      CallExpression(node: CallExpression) {\n        if (\n          node.callee.type === 'Identifier' &&\n          node.callee.name === 'track' &&\n          componentDepth === 0 &&\n          functionDepth === 0\n        ) {\n          context.report({\n            node,\n            messageId: 'moduleScope',\n          });\n        }\n      },\n    };\n  },\n};\n\nexport default rule;\n","import type { Rule } from 'eslint';\n\nconst rule: Rule.RuleModule = {\n  meta: {\n    type: 'suggestion',\n    docs: {\n      description: 'Prefer onInput over onChange for form inputs in Ripple',\n      category: 'Best Practices',\n      recommended: true,\n    },\n    messages: {\n      preferOnInput: 'Use \"onInput\" instead of \"onChange\". Ripple does not have synthetic events like React.',\n    },\n    fixable: 'code',\n    schema: [],\n  },\n  create(context) {\n    return {\n      // Check JSX attributes (standard JSX)\n      'JSXAttribute[name.name=\"onChange\"]'(node: any) {\n        context.report({\n          node,\n          messageId: 'preferOnInput',\n          fix(fixer) {\n            return fixer.replaceText(node.name, 'onInput');\n          },\n        });\n      },\n      // Check Attribute nodes (Ripple parser)\n      'Attribute[name.name=\"onChange\"]'(node: any) {\n        context.report({\n          node,\n          messageId: 'preferOnInput',\n          fix(fixer) {\n            return fixer.replaceText(node.name, 'onInput');\n          },\n        });\n      },\n      // Check object properties (for spread props)\n      'Property[key.name=\"onChange\"]'(node: any) {\n        // Only report if this looks like it's in a props object\n        const ancestors = context.sourceCode.getAncestors(node);\n        const inObjectExpression = ancestors.some(\n          (ancestor) => ancestor.type === 'ObjectExpression'\n        );\n\n        if (inObjectExpression) {\n          context.report({\n            node,\n            messageId: 'preferOnInput',\n            fix(fixer) {\n              return fixer.replaceText(node.key, 'onInput');\n            },\n          });\n        }\n      },\n    };\n  },\n};\n\nexport default rule;\n","import type { Rule } from 'eslint';\nimport type { ReturnStatement } from 'estree';\n\nconst rule: Rule.RuleModule = {\n  meta: {\n    type: 'problem',\n    docs: {\n      description: 'Disallow return statements with JSX in Ripple components',\n      category: 'Possible Errors',\n      recommended: true,\n    },\n    messages: {\n      noReturn: 'Do not return JSX from Ripple components. Use JSX as statements instead.',\n    },\n    schema: [],\n  },\n  create(context) {\n    let insideComponent = 0;\n\n    return {\n      // Track component boundaries\n      \"ExpressionStatement > CallExpression[callee.name='component']\"() {\n        insideComponent++;\n      },\n      \"ExpressionStatement > CallExpression[callee.name='component']:exit\"() {\n        insideComponent--;\n      },\n      // Also track arrow functions and regular functions that might be components\n      'VariableDeclarator[init.callee.name=\"component\"]'() {\n        insideComponent++;\n      },\n      'VariableDeclarator[init.callee.name=\"component\"]:exit'() {\n        insideComponent--;\n      },\n      // Check return statements\n      ReturnStatement(node: ReturnStatement) {\n        if (insideComponent > 0 && node.argument) {\n          // Check if returning JSX (JSXElement, JSXFragment)\n          if (\n            node.argument.type === 'JSXElement' ||\n            node.argument.type === 'JSXFragment'\n          ) {\n            context.report({\n              node,\n              messageId: 'noReturn',\n            });\n          }\n        }\n      },\n    };\n  },\n};\n\nexport default rule;\n","import type { Rule } from 'eslint';\n\nconst rule: Rule.RuleModule = {\n  meta: {\n    type: 'problem',\n    docs: {\n      description: 'Ensure tracked values are unboxed with @ operator',\n      category: 'Possible Errors',\n      recommended: true,\n    },\n    messages: {\n      needsUnbox: 'Tracked value should be unboxed with @ operator. Did you mean \"@{{name}}\"?',\n    },\n    schema: [],\n  },\n  create(context) {\n    const trackedVariables = new Set<string>();\n\n    function isInJSXContext(node: any): boolean {\n      let parent = node.parent;\n\n      // Walk up the AST to find if we're inside JSX/Element\n      while (parent) {\n        const parentType = parent.type;\n        // Check for JSX context\n        if (\n          parentType === 'JSXExpressionContainer' ||\n          parentType === 'JSXElement' ||\n          parentType === 'JSXFragment' ||\n          // Check for Ripple Element context\n          parentType === 'ExpressionContainer' ||\n          parentType === 'Element'\n        ) {\n          return true;\n        }\n        parent = parent.parent;\n      }\n\n      return false;\n    }\n\n    function checkTrackedIdentifier(node: any) {\n      if (trackedVariables.has(node.name) && isInJSXContext(node)) {\n        // Check if it's not already unboxed (preceded by @)\n        // The @ operator in Ripple creates a UnaryExpression node\n        const parent = node.parent;\n        let isUnboxed = parent &&\n                       parent.type === 'UnaryExpression' &&\n                       parent.operator === '@';\n\n        // Fallback: check source code for @ character before the identifier\n        if (!isUnboxed) {\n          const sourceCode = context.getSourceCode();\n          const textBefore = sourceCode.text.substring(\n            Math.max(0, node.range![0] - 1),\n            node.range![0]\n          );\n          isUnboxed = textBefore === '@';\n        }\n\n        if (!isUnboxed) {\n          context.report({\n            node,\n            messageId: 'needsUnbox',\n            data: { name: node.name },\n          });\n        }\n      }\n    }\n\n    return {\n      // Track variables that are assigned from track()\n      'VariableDeclarator[init.callee.name=\"track\"]'(node: any) {\n        if (node.id.type === 'Identifier') {\n          trackedVariables.add(node.id.name);\n        }\n      },\n      // Check all identifiers\n      Identifier(node: any) {\n        checkTrackedIdentifier(node);\n      },\n    };\n  },\n};\n\nexport default rule;\n","import type { Rule } from 'eslint';\nimport type { ForOfStatement, Node } from 'estree';\n\nconst rule: Rule.RuleModule = {\n  meta: {\n    type: 'problem',\n    docs: {\n      description:\n        'Require JSX in for...of loops within components, but disallow JSX in for...of loops within effects',\n      category: 'Possible Errors',\n      recommended: true,\n    },\n    messages: {\n      requireJsxInLoop:\n        'For...of loops in component bodies should contain JSX elements. Use JSX to render items.',\n      noJsxInEffectLoop:\n        'For...of loops inside effect() should not contain JSX. Effects are for side effects, not rendering.',\n    },\n    schema: [],\n  },\n  create(context) {\n    let insideComponent = 0;\n    let insideEffect = 0;\n\n    function containsJSX(node: Node, visited: Set<Node> = new Set()): boolean {\n      if (!node) return false;\n\n      // Avoid infinite loops from circular references\n      if (visited.has(node)) return false;\n      visited.add(node);\n\n      // Check if current node is JSX/Element (Ripple uses 'Element' type instead of 'JSXElement')\n      if (node.type === 'JSXElement' as string || node.type === 'JSXFragment' as string || node.type === 'Element' as string) {\n        return true;\n      }\n\n      const keys = Object.keys(node);\n      for (const key of keys) {\n        if (key === 'parent' || key === 'loc' || key === 'range') {\n          continue;\n        }\n\n        const value = (node as any)[key];\n        if (value && typeof value === 'object') {\n          if (Array.isArray(value)) {\n            for (const item of value) {\n              if (item && typeof item === 'object' && containsJSX(item, visited)) {\n                return true;\n              }\n            }\n          } else if (value.type && containsJSX(value, visited)) {\n            return true;\n          }\n        }\n      }\n\n      return false;\n    }\n\n    return {\n      Component() {\n        insideComponent++;\n      },\n      'Component:exit'() {\n        insideComponent--;\n      },\n\n      \"CallExpression[callee.name='effect']\"() {\n        insideEffect++;\n      },\n      \"CallExpression[callee.name='effect']:exit\"() {\n        insideEffect--;\n      },\n\n      ForOfStatement(node: ForOfStatement) {\n        if (insideComponent === 0) return;\n\n        const hasJSX = containsJSX(node.body);\n\n        if (insideEffect > 0) {\n          if (hasJSX) {\n            context.report({\n              node,\n              messageId: 'noJsxInEffectLoop',\n            });\n          }\n        } else {\n          if (!hasJSX) {\n            context.report({\n              node,\n              messageId: 'requireJsxInLoop',\n            });\n          }\n        }\n      },\n    };\n  },\n};\n\nexport default rule;\n","import type { Rule } from 'eslint';\n\nconst rule: Rule.RuleModule = {\n  meta: {\n    type: 'problem',\n    docs: {\n      description: 'Disallow @ introspection operator in TypeScript/JavaScript modules',\n      category: 'Possible Errors',\n      recommended: true,\n    },\n    messages: {\n      noIntrospect: 'The @ operator cannot be used in TypeScript/JavaScript modules. Use get() to read tracked values and set() to update them instead.',\n    },\n    schema: [],\n  },\n  create(context) {\n    const filename = context.filename || context.getFilename();\n    \n    // Skip .ripple files where @ operator is valid\n    if (filename && filename.endsWith('.ripple')) {\n      return {};\n    }\n\n    return {\n      // Check for identifiers with the 'tracked' property\n      // The @ operator is parsed by Ripple as an identifier with tracked=true\n      Identifier(node: any) {\n        if (node.tracked === true) {\n          context.report({\n            node,\n            messageId: 'noIntrospect',\n          });\n        }\n      },\n    };\n  },\n};\n\nexport default rule;\n\n","import { createRequire } from 'module';\nimport noModuleScopeTrack from './rules/no-module-scope-track.js';\nimport preferOnInput from './rules/prefer-oninput.js';\nimport noReturnInComponent from './rules/no-return-in-component.js';\nimport unboxTrackedValues from './rules/unbox-tracked-values.js';\nimport controlFlowJsx from './rules/control-flow-jsx.js';\nimport noIntrospectInModules from './rules/no-introspect-in-modules.js';\n\nconst plugin = {\n\tmeta: {\n\t\tname: '@ripple-ts/eslint-plugin',\n\t\tversion: '0.1.3',\n\t},\n\trules: {\n\t\t'no-module-scope-track': noModuleScopeTrack,\n\t\t'prefer-oninput': preferOnInput,\n\t\t'no-return-in-component': noReturnInComponent,\n\t\t'unbox-tracked-values': unboxTrackedValues,\n\t\t'control-flow-jsx': controlFlowJsx,\n\t\t'no-introspect-in-modules': noIntrospectInModules,\n\t},\n\tconfigs: {} as any,\n};\n\n// Try to load optional parsers\nconst require = createRequire(import.meta.url);\n\nlet rippleParser: any;\nlet tsParser: any;\n\ntry {\n\trippleParser = require('@ripple-ts/eslint-parser');\n} catch {\n\t// @ripple-ts/eslint-parser is optional\n\trippleParser = null;\n}\n\ntry {\n\ttsParser = require('@typescript-eslint/parser');\n} catch {\n\t// @typescript-eslint/parser is optional\n\ttsParser = null;\n}\n\n// Helper to create config objects\nfunction createConfig(name: string, files: string[], parser: any) {\n\tconst config: any = {\n\t\tname,\n\t\tfiles,\n\t\tplugins: {\n\t\t\tripple: plugin,\n\t\t},\n\t\trules: {\n\t\t\t'ripple/no-module-scope-track': 'error',\n\t\t\t'ripple/prefer-oninput': 'warn',\n\t\t\t'ripple/no-return-in-component': 'error',\n\t\t\t'ripple/unbox-tracked-values': 'error',\n\t\t\t'ripple/control-flow-jsx': 'error',\n\t\t\t'ripple/no-introspect-in-modules': 'error',\n\t\t},\n\t};\n\n\t// Only add parser if it's available\n\tif (parser) {\n\t\tconfig.languageOptions = {\n\t\t\tparser,\n\t\t\tparserOptions: {\n\t\t\t\tecmaVersion: 'latest',\n\t\t\t\tsourceType: 'module',\n\t\t\t},\n\t\t};\n\t}\n\n\treturn config;\n}\n\n// Recommended configuration (flat config format)\nplugin.configs.recommended = [\n\tcreateConfig('ripple/recommended-ripple-files', ['**/*.ripple'], rippleParser),\n\tcreateConfig('ripple/recommended-typescript-files', ['**/*.ts', '**/*.tsx'], tsParser),\n\t{\n\t\tname: 'ripple/ignores',\n\t\tignores: ['**/*.d.ts', '**/node_modules/**', '**/dist/**', '**/build/**'],\n\t},\n];\n\n// Strict configuration (flat config format)\nplugin.configs.strict = [\n\tcreateConfig('ripple/strict-ripple-files', ['**/*.ripple'], rippleParser),\n\tcreateConfig('ripple/strict-typescript-files', ['**/*.ts', '**/*.tsx'], tsParser),\n\t{\n\t\tname: 'ripple/ignores',\n\t\tignores: ['**/*.d.ts', '**/node_modules/**', '**/dist/**', '**/build/**'],\n\t},\n];\n\nexport default plugin;\n"],"mappings":"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"}

package/package.json

@@ -0,0 +1,64 @@
+{
+  "name": "@ripple-ts/eslint-plugin",
+  "version": "0.2.153",
+  "description": "ESLint plugin for Ripple",
+  "type": "module",
+  "main": "src/index.ts",
+  "exports": {
+    ".": "./dist/index.js"
+  },
+  "files": [
+    "dist"
+  ],
+  "keywords": [
+    "eslint",
+    "eslintplugin",
+    "eslint-plugin",
+    "ripple"
+  ],
+  "author": "Dominic Gannaway",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/Ripple-TS/ripple.git",
+    "directory": "packages/eslint-plugin"
+  },
+  "bugs": {
+    "url": "https://github.com/Ripple-TS/ripple/issues"
+  },
+  "homepage": "https://ripple-ts.com",
+  "peerDependencies": {
+    "eslint": ">=9.0.0",
+    "@typescript-eslint/parser": "^8.20.0",
+    "@ripple-ts/eslint-parser": "0.2.153"
+  },
+  "peerDependenciesMeta": {
+    "@typescript-eslint/parser": {
+      "optional": true
+    },
+    "@ripple-ts/eslint-parser": {
+      "optional": true
+    }
+  },
+  "devDependencies": {
+    "@types/eslint": "^9.6.1",
+    "@types/estree": "^1.0.8",
+    "@types/node": "^24.3.0",
+    "@typescript-eslint/parser": "^8.20.0",
+    "eslint": "^9.0.0",
+    "tsdown": "^0.15.4",
+    "typescript": "^5.9.2",
+    "vitest": "^3.2.4",
+    "@ripple-ts/eslint-parser": "0.2.153"
+  },
+  "engines": {
+    "node": ">=20.0.0"
+  },
+  "scripts": {
+    "dist": "perl -pi -e 's/\"main\": \"src\\/index.ts\"/\"main\": \"dist\\/index.js\"/' package.json",
+    "src": "perl -pi -e 's/\"main\": \"dist\\/index.js\"/\"main\": \"src\\/index.ts\"/' package.json",
+    "build": "pnpm dist && tsdown && pnpm src || pnpm src",
+    "test": "vitest run",
+    "test:watch": "vitest"
+  }
+}

package/src/index.ts

@@ -0,0 +1,97 @@
+import { createRequire } from 'module';
+import noModuleScopeTrack from './rules/no-module-scope-track.js';
+import preferOnInput from './rules/prefer-oninput.js';
+import noReturnInComponent from './rules/no-return-in-component.js';
+import unboxTrackedValues from './rules/unbox-tracked-values.js';
+import controlFlowJsx from './rules/control-flow-jsx.js';
+import noIntrospectInModules from './rules/no-introspect-in-modules.js';
+
+const plugin = {
+	meta: {
+		name: '@ripple-ts/eslint-plugin',
+		version: '0.1.3',
+	},
+	rules: {
+		'no-module-scope-track': noModuleScopeTrack,
+		'prefer-oninput': preferOnInput,
+		'no-return-in-component': noReturnInComponent,
+		'unbox-tracked-values': unboxTrackedValues,
+		'control-flow-jsx': controlFlowJsx,
+		'no-introspect-in-modules': noIntrospectInModules,
+	},
+	configs: {} as any,
+};
+
+// Try to load optional parsers
+const require = createRequire(import.meta.url);
+
+let rippleParser: any;
+let tsParser: any;
+
+try {
+	rippleParser = require('@ripple-ts/eslint-parser');
+} catch {
+	// @ripple-ts/eslint-parser is optional
+	rippleParser = null;
+}
+
+try {
+	tsParser = require('@typescript-eslint/parser');
+} catch {
+	// @typescript-eslint/parser is optional
+	tsParser = null;
+}
+
+// Helper to create config objects
+function createConfig(name: string, files: string[], parser: any) {
+	const config: any = {
+		name,
+		files,
+		plugins: {
+			ripple: plugin,
+		},
+		rules: {
+			'ripple/no-module-scope-track': 'error',
+			'ripple/prefer-oninput': 'warn',
+			'ripple/no-return-in-component': 'error',
+			'ripple/unbox-tracked-values': 'error',
+			'ripple/control-flow-jsx': 'error',
+			'ripple/no-introspect-in-modules': 'error',
+		},
+	};
+
+	// Only add parser if it's available
+	if (parser) {
+		config.languageOptions = {
+			parser,
+			parserOptions: {
+				ecmaVersion: 'latest',
+				sourceType: 'module',
+			},
+		};
+	}
+
+	return config;
+}
+
+// Recommended configuration (flat config format)
+plugin.configs.recommended = [
+	createConfig('ripple/recommended-ripple-files', ['**/*.ripple'], rippleParser),
+	createConfig('ripple/recommended-typescript-files', ['**/*.ts', '**/*.tsx'], tsParser),
+	{
+		name: 'ripple/ignores',
+		ignores: ['**/*.d.ts', '**/node_modules/**', '**/dist/**', '**/build/**'],
+	},
+];
+
+// Strict configuration (flat config format)
+plugin.configs.strict = [
+	createConfig('ripple/strict-ripple-files', ['**/*.ripple'], rippleParser),
+	createConfig('ripple/strict-typescript-files', ['**/*.ts', '**/*.tsx'], tsParser),
+	{
+		name: 'ripple/ignores',
+		ignores: ['**/*.d.ts', '**/node_modules/**', '**/dist/**', '**/build/**'],
+	},
+];
+
+export default plugin;