From 7cdb62a3a4a691ebdbc6e63bb5ad4e7cf5737270 Mon Sep 17 00:00:00 2001
From: Christian Svensson <csvn.dev@gmail.com>
Date: Sat, 2 Aug 2025 21:30:38 +0200
Subject: [PATCH 01/11] feat: add Fresh lint plugin

---
 packages/init/src/init.ts                     |  3 +
 packages/lint/README.md                       | 26 ++++++++
 packages/lint/deno.json                       | 13 ++++
 packages/lint/src/plugin.ts                   | 41 +++++++++++++
 .../lint/src/rules/handler-export.test.ts     | 51 ++++++++++++++++
 packages/lint/src/rules/handler-export.ts     | 43 ++++++++++++++
 .../src/rules/server-event-handlers.test.ts   | 59 +++++++++++++++++++
 .../lint/src/rules/server-event-handlers.ts   | 53 +++++++++++++++++
 packages/lint/src/test-utils.ts               |  9 +++
 packages/lint/src/utils.ts                    | 21 +++++++
 packages/update/src/update.ts                 |  7 ++-
 www/deno.json                                 |  3 +
 12 files changed, 328 insertions(+), 1 deletion(-)
 create mode 100644 packages/lint/README.md
 create mode 100644 packages/lint/deno.json
 create mode 100644 packages/lint/src/plugin.ts
 create mode 100644 packages/lint/src/rules/handler-export.test.ts
 create mode 100644 packages/lint/src/rules/handler-export.ts
 create mode 100644 packages/lint/src/rules/server-event-handlers.test.ts
 create mode 100644 packages/lint/src/rules/server-event-handlers.ts
 create mode 100644 packages/lint/src/test-utils.ts
 create mode 100644 packages/lint/src/utils.ts

diff --git a/packages/init/src/init.ts b/packages/init/src/init.ts
index 53d97e70a9a..df1367f88f6 100644
--- a/packages/init/src/init.ts
+++ b/packages/init/src/init.ts
@@ -6,6 +6,7 @@ import initConfig from "../deno.json" with { type: "json" };
 
 // Keep these as is, as we replace these version in our release script
 const FRESH_VERSION = "2.2.2";
+const FRESH_LINT_VERSION = "0.0.0";
 const FRESH_TAILWIND_VERSION = "1.0.0";
 const FRESH_VITE_PLUGIN = "1.0.0";
 const PREACT_VERSION = "10.28.3";
@@ -569,6 +570,7 @@ if (Deno.args.includes("build")) {
       update: "deno run -A -r jsr:@fresh/update .",
     },
     lint: {
+      plugins: ["jsr:@fresh/lint"],
       rules: {
         tags: ["fresh", "recommended"],
       },
@@ -577,6 +579,7 @@ if (Deno.args.includes("build")) {
     imports: {
       "@/": "./",
       "fresh": `jsr:@fresh/core@^${freshVersion}`,
+      "@fresh/lint": `jsr:@fresh/lint@^${FRESH_LINT_VERSION}`,
       "preact": `npm:preact@^${PREACT_VERSION}`,
       "@preact/signals": `npm:@preact/signals@^${PREACT_SIGNALS_VERSION}`,
     } as Record<string, string>,
diff --git a/packages/lint/README.md b/packages/lint/README.md
new file mode 100644
index 00000000000..a0b91626b17
--- /dev/null
+++ b/packages/lint/README.md
@@ -0,0 +1,26 @@
+# Fresh Lint rules
+
+This is a plugin with custom rules specifically for Fresh.
+
+## Usage
+
+1. Install the Fresh lint plugin
+   ```sh
+   deno add jsr:@fresh/lint
+   ```
+2. Configure the plugin in `deno.json`
+   ```json deno.json
+   {
+     "lint": {
+       "plugins": ["@fresh/lint"],
+       "rules": {
+         "include": ["fresh/[lint-rule]"]
+       }
+     }
+   }
+   ```
+3. You can now start linting Fresh code! 🎉
+
+## Rules
+
+TODO: COMING SOON!
diff --git a/packages/lint/deno.json b/packages/lint/deno.json
new file mode 100644
index 00000000000..09a35fdcd9f
--- /dev/null
+++ b/packages/lint/deno.json
@@ -0,0 +1,13 @@
+{
+  "name": "@fresh/lint",
+  "version": "0.0.0",
+  "license": "MIT",
+  "exports": "./src/plugin.ts",
+  "publish": {
+    "include": [
+      "src/**/*.ts",
+      "deno.json",
+      "README.md"
+    ]
+  }
+}
diff --git a/packages/lint/src/plugin.ts b/packages/lint/src/plugin.ts
new file mode 100644
index 00000000000..d2465500a5c
--- /dev/null
+++ b/packages/lint/src/plugin.ts
@@ -0,0 +1,41 @@
+import * as handlerExport from "./rules/handler-export.ts";
+import * as serverEventHandlers from "./rules/server-event-handlers.ts";
+
+/** Expected shape of each lint rule module */
+export interface RuleModule {
+  /** The name of the lint rule, which becomes `fresh/<rule-name>` */
+  RULE_NAME: string;
+  /** Rule implementation */
+  rule: Deno.lint.Rule;
+}
+
+/**
+ * Plugin for Fresh linting rules.
+ *
+ * For a full list of rules, see {@linkcode rules}.
+ *
+ * Enable lint rules by updating `deno.json`, each rule
+ * should be prefixed with `fresh/<rule_name>`.
+ *
+ * @example
+ * ```json deno.json
+ * {
+ *   "lint": {
+ *     "plugins": ["@fresh/lint"],
+ *     "rules": {
+ *       "include": ["fresh/test"]
+ *     }
+ *   }
+ * }
+ * ```
+ */
+const plugin: Deno.lint.Plugin = {
+  name: "fresh",
+  rules: createRules(handlerExport, serverEventHandlers),
+};
+
+function createRules(...modules: RuleModule[]): Deno.lint.Plugin["rules"] {
+  return Object.fromEntries(modules.map((mod) => [mod.RULE_NAME, mod.rule]));
+}
+
+export default plugin;
diff --git a/packages/lint/src/rules/handler-export.test.ts b/packages/lint/src/rules/handler-export.test.ts
new file mode 100644
index 00000000000..f3c2e2a495e
--- /dev/null
+++ b/packages/lint/src/rules/handler-export.test.ts
@@ -0,0 +1,51 @@
+import { expect } from "@std/expect";
+import { testPlugin } from "../test-utils.ts";
+import * as testRule from "./handler-export.ts";
+
+const okCases = new Set<[filename: string, code: string]>([
+  ["file:///foo.jsx", "const handler = {}"],
+  ["file:///foo.jsx", "function handler() {}"],
+  ["file:///foo.jsx", "export const handler = {}"],
+  ["file:///foo.jsx", "export const handlers = {}"],
+  ["file:///foo.jsx", "export function handlers() {}"],
+  ["file:///routes/foo.jsx", "export const handler = {}"],
+  ["file:///routes/foo.jsx", "export function handler() {}"],
+  ["file:///routes/foo.jsx", "export async function handler() {}"],
+  ["file:///routes/foo.jsx", "export const handler = define.handlers({});"],
+  ["file:///C:/www/routes/foo.jsx", "export const handler = {}"],
+]);
+
+const errCases = new Set<[file: string, code: string, range: [number, number]]>(
+  [
+    ["file:///routes/index.tsx", "export const handlers = {}", [13, 21]],
+    ["file:///routes/index.tsx", "export function handlers() {}", [16, 24]],
+    ["file:///routes/index.tsx", "export async function handlers() {}", [
+      22,
+      30,
+    ]],
+    ["file:///C:/www/routes/foo.jsx", "export const handlers = {}", [13, 21]],
+  ],
+);
+
+Deno.test("fresh/handler-export - ok", () => {
+  for (const [file, code] of okCases) {
+    const diagnostics = Deno.lint.runPlugin(testPlugin(testRule), file, code);
+
+    expect(diagnostics.length).toBe(0);
+  }
+});
+
+Deno.test("fresh/handler-export - err", () => {
+  for (const [file, code, range] of errCases) {
+    const [d, ...rest] = Deno.lint.runPlugin(testPlugin(testRule), file, code);
+
+    expect(rest.length).toBe(0);
+    expect(d.fix).toEqual([]);
+    expect(d.range).toEqual(range);
+    expect(d.id).toBe("fresh/handler-export");
+    expect(d.message).toBe(
+      'Fresh middlewares must be exported as "handler" but got "handlers" instead.',
+    );
+    expect(d.hint).toBe('Did you mean "handler"?');
+  }
+});
diff --git a/packages/lint/src/rules/handler-export.ts b/packages/lint/src/rules/handler-export.ts
new file mode 100644
index 00000000000..01116b4c4ee
--- /dev/null
+++ b/packages/lint/src/rules/handler-export.ts
@@ -0,0 +1,43 @@
+import { NO_VISITOR, pathSegments } from "../utils.ts";
+
+/**
+ * Reports routes using an incorrect export name for handlers.
+ *
+ * @example
+ * ```tsx
+ * // routes/index.ts
+ * export const handlers = () => {};
+ *           // ^^^^^^^^ should be "handler"
+ * ```
+ *
+ * @module
+ */
+
+export const RULE_NAME = "handler-export";
+
+const MESSAGE =
+  'Fresh middlewares must be exported as "handler" but got "handlers" instead.';
+const HINT = 'Did you mean "handler"?';
+
+const HANDLERS_NAME = "handlers";
+const HANDLERS_EXPORT_SELECTOR =
+  `ExportNamedDeclaration > VariableDeclaration > VariableDeclarator > Identifier[name=${HANDLERS_NAME}],
+   ExportNamedDeclaration > FunctionDeclaration > Identifier[name=${HANDLERS_NAME}]`;
+
+export const rule: Deno.lint.Rule = {
+  create(ctx) {
+    // Ignore files outside `routes/` dir
+    if (!pathSegments(ctx.filename).isRoute()) return NO_VISITOR;
+
+    return {
+      [HANDLERS_EXPORT_SELECTOR](node: Deno.lint.Identifier) {
+        ctx.report({
+          message: MESSAGE,
+          hint: HINT,
+          node,
+          range: node.range,
+        });
+      },
+    };
+  },
+};
diff --git a/packages/lint/src/rules/server-event-handlers.test.ts b/packages/lint/src/rules/server-event-handlers.test.ts
new file mode 100644
index 00000000000..84c9ac4f68c
--- /dev/null
+++ b/packages/lint/src/rules/server-event-handlers.test.ts
@@ -0,0 +1,59 @@
+import { expect } from "@std/expect";
+import { testPlugin } from "../test-utils.ts";
+import * as testRule from "./server-event-handlers.ts";
+
+const okCases = new Set<[filename: string, code: string]>([
+  ["file:///foo.jsx", "<Foo onClick={() => {}} />"],
+  ["file:///foo.jsx", "<button onClick={() => {}} />"],
+  ["file:///foo.jsx", "<button onClick={function () {}} />"],
+  ["file:///foo.jsx", "<button onclick={function () {}} />"],
+  ["file:///foo.jsx", "<button onClick=\"console.log('hey')\" />"],
+  ["file:///foo.jsx", '<button online="foo" />'],
+  ["file:///foo.jsx", "<x-foo onClick=\"console.log('hey')\" />"],
+  [
+    "file:///routes/foo/(_islands)/foo.jsx",
+    "<button onClick={function () {}} />",
+  ],
+]);
+
+const errCases = new Set<[file: string, code: string, range: [number, number]]>(
+  [
+    ["file:///routes/index.tsx", "<button onClick={() => {}} />", [8, 26]],
+    ["file:///routes/index.tsx", "<button onTouchMove={() => {}} />", [8, 30]],
+    [
+      "file:///routes/index.tsx",
+      `<button onTouchMove={"console.log('hey')"} />`,
+      [8, 42],
+    ],
+    ["file:///routes/index.tsx", "<foo-button foo={() => {}} />", [12, 26]],
+    ["file:///routes/index.tsx", "<foo-button foo={function () {}} />", [
+      12,
+      32,
+    ]],
+  ],
+);
+
+Deno.test("fresh/server-event-handlers - ok", () => {
+  for (const [file, code] of okCases) {
+    const diagnostics = Deno.lint.runPlugin(testPlugin(testRule), file, code);
+
+    expect(diagnostics.length).toBe(0);
+  }
+});
+
+Deno.test("fresh/server-event-handlers - err", () => {
+  for (const [file, code, range] of errCases) {
+    const [d, ...rest] = Deno.lint.runPlugin(testPlugin(testRule), file, code);
+
+    expect(rest.length).toBe(0);
+    expect(d.fix).toEqual([]);
+    expect(d.range).toEqual(range);
+    expect(d.id).toBe("fresh/server-event-handlers");
+    expect(d.message).toBe(
+      "Server components cannot install client side event handlers.",
+    );
+    expect(d.hint).toBe(
+      "Remove this property or turn the enclosing component into an island",
+    );
+  }
+});
diff --git a/packages/lint/src/rules/server-event-handlers.ts b/packages/lint/src/rules/server-event-handlers.ts
new file mode 100644
index 00000000000..f4c6bd4ebc4
--- /dev/null
+++ b/packages/lint/src/rules/server-event-handlers.ts
@@ -0,0 +1,53 @@
+import { NO_VISITOR, pathSegments } from "../utils.ts";
+
+/**
+ * Reports server components that install client side event handlers.
+ *
+ * Disallows `on*` attributes for JSX components inside the
+ * `routes/` directory, as these components are rendered on the server.
+ *
+ * @example
+ * ```tsx
+ * // routes/index.ts
+ * <button onClick={() => {}} />
+ *      // ^^^^^^^^^^^^^^^^^^ invalid handler
+ * ```
+ *
+ * The `(_islands)` directory is excluded from this lint rule.
+ *
+ * @module
+ */
+
+export const RULE_NAME = "server-event-handlers";
+
+const MESSAGE = "Server components cannot install client side event handlers.";
+const HINT =
+  "Remove this property or turn the enclosing component into an island";
+
+const CUSTOM_ELEMENT_FN_EXPR_ATTR_SELECTOR =
+  'JSXOpeningElement[name.type="JSXIdentifier"][name.name=/-/] > JSXAttribute[name.type="JSXIdentifier"]:has(> JSXExpressionContainer[expression.type=/^(FunctionExpression|ArrowFunctionExpression)$/])';
+const HTML_ELEMENT_ON_ATTR_SELECTOR =
+  'JSXOpeningElement[name.type="JSXIdentifier"][name.name=/^[a-z]+$/] > JSXAttribute[name.type="JSXIdentifier"][name.name=/^on/]';
+
+export const rule: Deno.lint.Rule = {
+  create(ctx) {
+    const path = pathSegments(ctx.filename);
+
+    // Ignore island components or components outside `routes/` dir
+    if (path.isIsland() || !path.isRoute()) return NO_VISITOR;
+
+    const reportNode = (node: Deno.lint.JSXAttribute) => {
+      ctx.report({
+        message: MESSAGE,
+        hint: HINT,
+        node,
+        range: node.range,
+      });
+    };
+
+    return {
+      [CUSTOM_ELEMENT_FN_EXPR_ATTR_SELECTOR]: reportNode,
+      [HTML_ELEMENT_ON_ATTR_SELECTOR]: reportNode,
+    };
+  },
+};
diff --git a/packages/lint/src/test-utils.ts b/packages/lint/src/test-utils.ts
new file mode 100644
index 00000000000..274389a0a8f
--- /dev/null
+++ b/packages/lint/src/test-utils.ts
@@ -0,0 +1,9 @@
+import type { RuleModule } from "./plugin.ts";
+
+/** Create a test lint plugin for the given rule */
+export function testPlugin({ rule, RULE_NAME }: RuleModule): Deno.lint.Plugin {
+  return {
+    name: `fresh`,
+    rules: { [RULE_NAME]: rule },
+  };
+}
diff --git a/packages/lint/src/utils.ts b/packages/lint/src/utils.ts
new file mode 100644
index 00000000000..a62cec3f11a
--- /dev/null
+++ b/packages/lint/src/utils.ts
@@ -0,0 +1,21 @@
+import { SEPARATOR_PATTERN } from "@std/path";
+
+/** Utility for e.g. ignored files to avoid visiting any AST nodes */
+export const NO_VISITOR: Deno.lint.LintVisitor = Object.freeze({});
+
+/** Utility for inspecting the path segments of a file */
+export function pathSegments(filename: string) {
+  // TODO: Make this folder respect Fresh config?
+  const ROUTES_DIR = "routes";
+  const ISLANDS_DIR = "(_islands)";
+  const segments = filename.split(SEPARATOR_PATTERN);
+
+  return {
+    isRoute() {
+      return segments.includes(ROUTES_DIR);
+    },
+    isIsland() {
+      return segments.includes(ISLANDS_DIR);
+    },
+  };
+}
diff --git a/packages/update/src/update.ts b/packages/update/src/update.ts
index 8b3a8a6e954..688e03ea70d 100644
--- a/packages/update/src/update.ts
+++ b/packages/update/src/update.ts
@@ -8,6 +8,7 @@ import { walk } from "@std/fs/walk";
 export const SyntaxKind = tsmorph.ts.SyntaxKind;
 
 export const FRESH_VERSION = "2.2.2";
+export const FRESH_LINT_VERSION = "0.0.0";
 export const PREACT_VERSION = "10.28.3";
 export const PREACT_SIGNALS_VERSION = "2.7.1";
 
@@ -142,6 +143,10 @@ export async function updateProject(dir: string) {
     delete config.imports["@preact/signals-core"];
     delete config.imports["preact-render-to-string"];
 
+    if (config.imports["@fresh/lint"]) {
+      config.imports["@fresh/lint"] = `jsr:@fresh/lint@^${FRESH_LINT_VERSION}`;
+    }
+
     // We should always use a lockfile going forwards
     if ("lock" in config) {
       delete config.lock;
@@ -290,7 +295,7 @@ export async function updateProject(dir: string) {
   // deno-lint-ignore no-console
   console.log(
     `   Unmodified (no changes needed): ${
-      filesToProcess.length - modifiedFilesList.length
+      userFiles.length - modifiedFilesToShow.length
     }`,
   );
 
diff --git a/www/deno.json b/www/deno.json
index 5353381bb4d..971d144125d 100644
--- a/www/deno.json
+++ b/www/deno.json
@@ -1,4 +1,7 @@
 {
+  "lint": {
+    "plugins": ["../packages/lint/src/plugin.ts"]
+  },
   "tasks": {
     "start": "deno serve -A _fresh/server.js",
     "dev": "vite",

From 57622c75f86e2dfbdeb55769ae4e7a52ff2f25de Mon Sep 17 00:00:00 2001
From: Christian Svensson <csvn.dev@gmail.com>
Date: Thu, 26 Mar 2026 14:58:23 +0100
Subject: [PATCH 02/11] fix: exclude unit tests from publish

---
 packages/lint/deno.json | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/packages/lint/deno.json b/packages/lint/deno.json
index 09a35fdcd9f..4e879003744 100644
--- a/packages/lint/deno.json
+++ b/packages/lint/deno.json
@@ -8,6 +8,7 @@
       "src/**/*.ts",
       "deno.json",
       "README.md"
-    ]
+    ],
+    "exclude": ["src/**/*.test.ts"]
   }
 }

From 591c48250c91b1c4391bef441c4b4c531b6f6b8e Mon Sep 17 00:00:00 2001
From: Christian Svensson <csvn.dev@gmail.com>
Date: Thu, 26 Mar 2026 15:15:14 +0100
Subject: [PATCH 03/11] fix: revert unintended regression

---
 packages/update/src/update.ts | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/packages/update/src/update.ts b/packages/update/src/update.ts
index 688e03ea70d..f0e97c1fbc5 100644
--- a/packages/update/src/update.ts
+++ b/packages/update/src/update.ts
@@ -295,7 +295,7 @@ export async function updateProject(dir: string) {
   // deno-lint-ignore no-console
   console.log(
     `   Unmodified (no changes needed): ${
-      userFiles.length - modifiedFilesToShow.length
+      filesToProcess.length - modifiedFilesList.length
     }`,
   );
 

From 60ea66d3d5872759b3bb43d93ca50bfb4860299b Mon Sep 17 00:00:00 2001
From: Christian Svensson <csvn.dev@gmail.com>
Date: Thu, 26 Mar 2026 15:27:30 +0100
Subject: [PATCH 04/11] docs: reword handler export based on feedback

---
 packages/lint/src/rules/handler-export.ts | 3 +--
 1 file changed, 1 insertion(+), 2 deletions(-)

diff --git a/packages/lint/src/rules/handler-export.ts b/packages/lint/src/rules/handler-export.ts
index 01116b4c4ee..52c1900e756 100644
--- a/packages/lint/src/rules/handler-export.ts
+++ b/packages/lint/src/rules/handler-export.ts
@@ -15,8 +15,7 @@ import { NO_VISITOR, pathSegments } from "../utils.ts";
 
 export const RULE_NAME = "handler-export";
 
-const MESSAGE =
-  'Fresh middlewares must be exported as "handler" but got "handlers" instead.';
+const MESSAGE = 'Fresh routes must export "handler" instead of "handlers".';
 const HINT = 'Did you mean "handler"?';
 
 const HANDLERS_NAME = "handlers";

From fd06e381707f913ae2a5e3cece75db3c81a4cad9 Mon Sep 17 00:00:00 2001
From: Christian Svensson <csvn.dev@gmail.com>
Date: Thu, 26 Mar 2026 15:36:53 +0100
Subject: [PATCH 05/11] fix: use explicit "/" since filename is a file url

---
 .zed/settings.json         | 30 ++++++++++++++++++++++++++++++
 packages/lint/src/utils.ts | 10 ++++------
 2 files changed, 34 insertions(+), 6 deletions(-)
 create mode 100644 .zed/settings.json

diff --git a/.zed/settings.json b/.zed/settings.json
new file mode 100644
index 00000000000..075a7e23af3
--- /dev/null
+++ b/.zed/settings.json
@@ -0,0 +1,30 @@
+{
+  "lsp": {
+    "deno": {
+      "settings": {
+        "deno": {
+          "enable": true,
+          "inlayHints": {
+            "enabled": "on",
+            "parameterNames": { "enabled": "all" },
+            "parameterTypes": { "enabled": true },
+            "variableTypes": { "enabled": true },
+            "propertyDeclarationTypes": { "enabled": true },
+            "functionLikeReturnTypes": { "enabled": true },
+            "enumMemberValues": { "enabled": true }
+          }
+        }
+      }
+    }
+  },
+  "languages": {
+    "TypeScript": {
+      "formatter": "language_server",
+      "language_servers": [
+        "deno",
+        "!tsgo",
+        "!vtsls"
+      ]
+    }
+  }
+}
diff --git a/packages/lint/src/utils.ts b/packages/lint/src/utils.ts
index a62cec3f11a..695b342077c 100644
--- a/packages/lint/src/utils.ts
+++ b/packages/lint/src/utils.ts
@@ -1,21 +1,19 @@
-import { SEPARATOR_PATTERN } from "@std/path";
-
 /** Utility for e.g. ignored files to avoid visiting any AST nodes */
 export const NO_VISITOR: Deno.lint.LintVisitor = Object.freeze({});
 
-/** Utility for inspecting the path segments of a file */
+/** Utility for inspecting the path segments of a `file://` path */
 export function pathSegments(filename: string) {
   // TODO: Make this folder respect Fresh config?
   const ROUTES_DIR = "routes";
   const ISLANDS_DIR = "(_islands)";
-  const segments = filename.split(SEPARATOR_PATTERN);
+  const segments = new Set(filename.split("/"));
 
   return {
     isRoute() {
-      return segments.includes(ROUTES_DIR);
+      return segments.has(ROUTES_DIR);
     },
     isIsland() {
-      return segments.includes(ISLANDS_DIR);
+      return segments.has(ISLANDS_DIR);
     },
   };
 }

From 31f91160e56a6a0f89bc0d336703bdca0c30081a Mon Sep 17 00:00:00 2001
From: Christian Svensson <csvn.dev@gmail.com>
Date: Thu, 26 Mar 2026 15:44:23 +0100
Subject: [PATCH 06/11] docs: update rules section with real info

---
 packages/lint/README.md | 5 ++++-
 1 file changed, 4 insertions(+), 1 deletion(-)

diff --git a/packages/lint/README.md b/packages/lint/README.md
index a0b91626b17..c141ac7da01 100644
--- a/packages/lint/README.md
+++ b/packages/lint/README.md
@@ -23,4 +23,7 @@ This is a plugin with custom rules specifically for Fresh.
 
 ## Rules
 
-TODO: COMING SOON!
+| Rule ID                 | Description                                                  |
+| ----------------------- | ------------------------------------------------------------ |
+| `handler-export`        | Warn when exporting `handlers` over `handler`                |
+| `server-event-handlers` | Warn when code attempts to use event handlers in server code |

From 6aa861949f768badc63fbd9f088eafb23fd35610 Mon Sep 17 00:00:00 2001
From: Christian Svensson <csvn.dev@gmail.com>
Date: Thu, 26 Mar 2026 15:53:57 +0100
Subject: [PATCH 07/11] docs: add rules information to readme

---
 packages/lint/README.md | 8 ++++----
 1 file changed, 4 insertions(+), 4 deletions(-)

diff --git a/packages/lint/README.md b/packages/lint/README.md
index c141ac7da01..c6aa75c7f21 100644
--- a/packages/lint/README.md
+++ b/packages/lint/README.md
@@ -23,7 +23,7 @@ This is a plugin with custom rules specifically for Fresh.
 
 ## Rules
 
-| Rule ID                 | Description                                                  |
-| ----------------------- | ------------------------------------------------------------ |
-| `handler-export`        | Warn when exporting `handlers` over `handler`                |
-| `server-event-handlers` | Warn when code attempts to use event handlers in server code |
+| Rule ID                 | Description                                                                        |
+| ----------------------- | ---------------------------------------------------------------------------------- |
+| `handler-export`        | Warn when exporting `handlers` over `handler`                                      |
+| `server-event-handlers` | Warn when code attempts to use event handlers or functions as props in server code |

From e598981d582dc61887c91a106e1b4d22be9864c4 Mon Sep 17 00:00:00 2001
From: Christian Svensson <csvn.dev@gmail.com>
Date: Thu, 26 Mar 2026 15:54:46 +0100
Subject: [PATCH 08/11] docs: add note about warning function props

---
 packages/lint/src/rules/server-event-handlers.ts | 7 +++++++
 1 file changed, 7 insertions(+)

diff --git a/packages/lint/src/rules/server-event-handlers.ts b/packages/lint/src/rules/server-event-handlers.ts
index f4c6bd4ebc4..d8574c7c6be 100644
--- a/packages/lint/src/rules/server-event-handlers.ts
+++ b/packages/lint/src/rules/server-event-handlers.ts
@@ -6,11 +6,17 @@ import { NO_VISITOR, pathSegments } from "../utils.ts";
  * Disallows `on*` attributes for JSX components inside the
  * `routes/` directory, as these components are rendered on the server.
  *
+ * It will also warn when passing a function as prop to a custom element,
+ * as functions cannot be serialized to HTML on the server.
+ *
  * @example
  * ```tsx
  * // routes/index.ts
  * <button onClick={() => {}} />
  *      // ^^^^^^^^^^^^^^^^^^ invalid handler
+ *
+ * <MyComponent handler={() => {}} />
+ *           // ^^^^^^^^^^^^^^^^^^ invalid handler
  * ```
  *
  * The `(_islands)` directory is excluded from this lint rule.
@@ -24,6 +30,7 @@ const MESSAGE = "Server components cannot install client side event handlers.";
 const HINT =
   "Remove this property or turn the enclosing component into an island";
 
+// Note: This selector will match any function passed as a prop to a custom element, not just event handlers.
 const CUSTOM_ELEMENT_FN_EXPR_ATTR_SELECTOR =
   'JSXOpeningElement[name.type="JSXIdentifier"][name.name=/-/] > JSXAttribute[name.type="JSXIdentifier"]:has(> JSXExpressionContainer[expression.type=/^(FunctionExpression|ArrowFunctionExpression)$/])';
 const HTML_ELEMENT_ON_ATTR_SELECTOR =

From b549ab21e169eae8042506a9d3a19d77e5492726 Mon Sep 17 00:00:00 2001
From: Christian Svensson <csvn.dev@gmail.com>
Date: Thu, 26 Mar 2026 16:18:42 +0100
Subject: [PATCH 09/11] test: fix failing test

---
 packages/lint/src/rules/handler-export.test.ts | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/packages/lint/src/rules/handler-export.test.ts b/packages/lint/src/rules/handler-export.test.ts
index f3c2e2a495e..6cc8b0c5982 100644
--- a/packages/lint/src/rules/handler-export.test.ts
+++ b/packages/lint/src/rules/handler-export.test.ts
@@ -44,7 +44,7 @@ Deno.test("fresh/handler-export - err", () => {
     expect(d.range).toEqual(range);
     expect(d.id).toBe("fresh/handler-export");
     expect(d.message).toBe(
-      'Fresh middlewares must be exported as "handler" but got "handlers" instead.',
+      'Fresh routes must export "handler" instead of "handlers".',
     );
     expect(d.hint).toBe('Did you mean "handler"?');
   }

From 19695fd5ea320d575d14a5239b88d2d0d1fc660d Mon Sep 17 00:00:00 2001
From: Christian Svensson <csvn.dev@gmail.com>
Date: Thu, 9 Apr 2026 16:14:58 +0200
Subject: [PATCH 10/11] fix: remove unrelated changes

---
 .zed/settings.json | 30 ------------------------------
 1 file changed, 30 deletions(-)
 delete mode 100644 .zed/settings.json

diff --git a/.zed/settings.json b/.zed/settings.json
deleted file mode 100644
index 075a7e23af3..00000000000
--- a/.zed/settings.json
+++ /dev/null
@@ -1,30 +0,0 @@
-{
-  "lsp": {
-    "deno": {
-      "settings": {
-        "deno": {
-          "enable": true,
-          "inlayHints": {
-            "enabled": "on",
-            "parameterNames": { "enabled": "all" },
-            "parameterTypes": { "enabled": true },
-            "variableTypes": { "enabled": true },
-            "propertyDeclarationTypes": { "enabled": true },
-            "functionLikeReturnTypes": { "enabled": true },
-            "enumMemberValues": { "enabled": true }
-          }
-        }
-      }
-    }
-  },
-  "languages": {
-    "TypeScript": {
-      "formatter": "language_server",
-      "language_servers": [
-        "deno",
-        "!tsgo",
-        "!vtsls"
-      ]
-    }
-  }
-}

From baeea46e5c4b4ee896a8765bd3f67c8240c187f3 Mon Sep 17 00:00:00 2001
From: Christian Svensson <csvn.dev@gmail.com>
Date: Thu, 9 Apr 2026 16:16:25 +0200
Subject: [PATCH 11/11] fix: use a better initial version number

---
 packages/init/src/init.ts     | 2 +-
 packages/update/src/update.ts | 2 +-
 2 files changed, 2 insertions(+), 2 deletions(-)

diff --git a/packages/init/src/init.ts b/packages/init/src/init.ts
index df1367f88f6..7a8f9576a08 100644
--- a/packages/init/src/init.ts
+++ b/packages/init/src/init.ts
@@ -6,7 +6,7 @@ import initConfig from "../deno.json" with { type: "json" };
 
 // Keep these as is, as we replace these version in our release script
 const FRESH_VERSION = "2.2.2";
-const FRESH_LINT_VERSION = "0.0.0";
+const FRESH_LINT_VERSION = "0.1.0";
 const FRESH_TAILWIND_VERSION = "1.0.0";
 const FRESH_VITE_PLUGIN = "1.0.0";
 const PREACT_VERSION = "10.28.3";
diff --git a/packages/update/src/update.ts b/packages/update/src/update.ts
index f0e97c1fbc5..f147d05b48a 100644
--- a/packages/update/src/update.ts
+++ b/packages/update/src/update.ts
@@ -8,7 +8,7 @@ import { walk } from "@std/fs/walk";
 export const SyntaxKind = tsmorph.ts.SyntaxKind;
 
 export const FRESH_VERSION = "2.2.2";
-export const FRESH_LINT_VERSION = "0.0.0";
+export const FRESH_LINT_VERSION = "0.1.0";
 export const PREACT_VERSION = "10.28.3";
 export const PREACT_SIGNALS_VERSION = "2.7.1";