@ossido-labs/ossido-eslint-plugin 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Chris Schofield
+
+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,84 @@
+# ossido-eslint-plugin
+
+Lint rules [ossido](https://ossido.dev) projects should run. It exposes one rule
+today —
+[`react-refresh/only-export-components`](https://github.com/ArnaudBarre/eslint-plugin-react-refresh)
+— authored with [oxlint](https://oxc.rs)'s performant `createOnce` API and
+wrapped with `eslintCompatPlugin`, so the **same package runs under both oxlint
+and ESLint**.
+
+## Why
+
+React Fast Refresh can only hot-update a module when **every** export is a
+component. A single non-component export (an object, function, or class) next to
+your component turns every edit to that file into a **full page reload** instead
+of a state-preserving hot update — and on an SSR route, that reload refetches the
+route's server data. (Primitive constant exports are fine; Vite handles them.)
+
+The default export being the component doesn't help: the refresh boundary is the
+whole module, so one disqualifying export poisons the file. This rule flags that
+at author time, before you feel it in dev.
+
+## Usage
+
+Install:
+
+```sh
+npm install -D @ossido-labs/ossido-eslint-plugin
+```
+
+### oxlint (`.oxlintrc.json`)
+
+```json
+{
+  "jsPlugins": ["@ossido-labs/ossido-eslint-plugin"],
+  "rules": {
+    "react-refresh/only-export-components": [
+      "warn",
+      { "allowConstantExport": true }
+    ]
+  }
+}
+```
+
+> JS plugins are an alpha oxlint feature — requires an oxlint version that
+> supports `jsPlugins`.
+
+### ESLint (`eslint.config.js`, flat config)
+
+```js
+import reactRefresh from '@ossido-labs/ossido-eslint-plugin';
+
+export default [
+  {
+    files: ['**/*.{jsx,tsx}'],
+    plugins: { 'react-refresh': reactRefresh },
+    rules: {
+      'react-refresh/only-export-components': [
+        'warn',
+        { allowConstantExport: true },
+      ],
+    },
+  },
+];
+```
+
+`allowConstantExport: true` permits `export const FOO = 'bar'` (primitive
+constants), which don't break Fast Refresh — matching the runtime behaviour.
+
+## Fixing a warning
+
+Move the non-component export to its own module:
+
+```tsx
+// page.tsx  — clean boundary, hot-updates with state preserved
+import { PAGE_META } from './page.meta';
+export default function Page() {
+  /* ... */
+}
+```
+
+```ts
+// page.meta.ts
+export const PAGE_META = { title: 'Home' };
+```

package/dist/esm/index.d.ts

@@ -0,0 +1,34 @@
+/**
+ * Oxlint (and ESLint) plugin for ossido projects.
+ *
+ * Exposes [eslint-plugin-react-refresh](https://github.com/ArnaudBarre/eslint-plugin-react-refresh)'s
+ * `only-export-components` rule authored with oxlint's performant `createOnce`
+ * API, then wrapped with {@link eslintCompatPlugin} so the same package works as
+ * both an oxlint JS plugin (`jsPlugins`) and a standard ESLint plugin (the
+ * wrapper adds ESLint-compatible `create` methods that delegate to `createOnce`).
+ *
+ * The rule keeps route/component files valid React Fast Refresh boundaries: it
+ * flags a non-component export (object, function, class) co-located with a
+ * component, which would otherwise force a full page reload on every edit to
+ * that file instead of a state-preserving hot update. Primitive constant exports
+ * are permitted via the rule's `allowConstantExport` option (they don't break
+ * Fast Refresh under Vite).
+ *
+ * The plugin is namespaced `react-refresh`, so the rule id is
+ * `react-refresh/only-export-components`.
+ *
+ * @example .oxlintrc.json
+ * ```json
+ * {
+ *   "jsPlugins": ["@ossido-labs/ossido-eslint-plugin"],
+ *   "rules": {
+ *     "react-refresh/only-export-components": [
+ *       "warn",
+ *       { "allowConstantExport": true }
+ *     ]
+ *   }
+ * }
+ * ```
+ */
+declare const plugin: import("@oxlint/plugins").Plugin;
+export default plugin;

package/dist/esm/index.js

@@ -0,0 +1,53 @@
+import { defineRule, eslintCompatPlugin } from "@oxlint/plugins";
+import reactRefresh from "eslint-plugin-react-refresh";
+
+//#region src/index.ts
+const eslintRule = reactRefresh.rules["only-export-components"];
+const rule = defineRule({
+	meta: eslintRule.meta,
+	createOnce(context) {
+		return { Program(node) {
+			eslintRule.create(context).Program?.(node);
+		} };
+	}
+});
+/**
+* Oxlint (and ESLint) plugin for ossido projects.
+*
+* Exposes [eslint-plugin-react-refresh](https://github.com/ArnaudBarre/eslint-plugin-react-refresh)'s
+* `only-export-components` rule authored with oxlint's performant `createOnce`
+* API, then wrapped with {@link eslintCompatPlugin} so the same package works as
+* both an oxlint JS plugin (`jsPlugins`) and a standard ESLint plugin (the
+* wrapper adds ESLint-compatible `create` methods that delegate to `createOnce`).
+*
+* The rule keeps route/component files valid React Fast Refresh boundaries: it
+* flags a non-component export (object, function, class) co-located with a
+* component, which would otherwise force a full page reload on every edit to
+* that file instead of a state-preserving hot update. Primitive constant exports
+* are permitted via the rule's `allowConstantExport` option (they don't break
+* Fast Refresh under Vite).
+*
+* The plugin is namespaced `react-refresh`, so the rule id is
+* `react-refresh/only-export-components`.
+*
+* @example .oxlintrc.json
+* ```json
+* {
+*   "jsPlugins": ["@ossido-labs/ossido-eslint-plugin"],
+*   "rules": {
+*     "react-refresh/only-export-components": [
+*       "warn",
+*       { "allowConstantExport": true }
+*     ]
+*   }
+* }
+* ```
+*/
+const plugin = eslintCompatPlugin({
+	meta: { name: "react-refresh" },
+	rules: { "only-export-components": rule }
+});
+
+//#endregion
+export { plugin as default };
+//# sourceMappingURL=index.js.map

package/dist/esm/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","names":[],"sources":["../../src/index.ts"],"sourcesContent":["import { defineRule, eslintCompatPlugin } from '@oxlint/plugins';\nimport type { Context, RuleMeta } from '@oxlint/plugins';\nimport reactRefresh from 'eslint-plugin-react-refresh';\n\n// eslint-plugin-react-refresh authors the rule with ESLint's per-file\n// `create(context)` API, doing all its work in a single `Program` visitor. We\n// re-expose it through oxlint's performant `createOnce` API (called once, so\n// oxlint can statically see the visited node types), delegating each file's\n// check to the upstream rule. The rule reads per-file context (filename /\n// source) at `create` time, so a fresh instance is created for each `Program`\n// (i.e. per file) — reusing one instance across files reports nothing.\ninterface EslintRuleModule {\n  meta?: RuleMeta;\n  create: (context: unknown) => { Program?: (node: unknown) => void };\n}\n\nconst eslintRule = reactRefresh.rules[\n  'only-export-components'\n] as unknown as EslintRuleModule;\n\nconst rule = defineRule({\n  meta: eslintRule.meta,\n  createOnce(context: Context) {\n    return {\n      Program(node): void {\n        eslintRule.create(context).Program?.(node);\n      },\n    };\n  },\n});\n\n/**\n * Oxlint (and ESLint) plugin for ossido projects.\n *\n * Exposes [eslint-plugin-react-refresh](https://github.com/ArnaudBarre/eslint-plugin-react-refresh)'s\n * `only-export-components` rule authored with oxlint's performant `createOnce`\n * API, then wrapped with {@link eslintCompatPlugin} so the same package works as\n * both an oxlint JS plugin (`jsPlugins`) and a standard ESLint plugin (the\n * wrapper adds ESLint-compatible `create` methods that delegate to `createOnce`).\n *\n * The rule keeps route/component files valid React Fast Refresh boundaries: it\n * flags a non-component export (object, function, class) co-located with a\n * component, which would otherwise force a full page reload on every edit to\n * that file instead of a state-preserving hot update. Primitive constant exports\n * are permitted via the rule's `allowConstantExport` option (they don't break\n * Fast Refresh under Vite).\n *\n * The plugin is namespaced `react-refresh`, so the rule id is\n * `react-refresh/only-export-components`.\n *\n * @example .oxlintrc.json\n * ```json\n * {\n *   \"jsPlugins\": [\"@ossido-labs/ossido-eslint-plugin\"],\n *   \"rules\": {\n *     \"react-refresh/only-export-components\": [\n *       \"warn\",\n *       { \"allowConstantExport\": true }\n *     ]\n *   }\n * }\n * ```\n */\nconst plugin = eslintCompatPlugin({\n  meta: { name: 'react-refresh' },\n  rules: { 'only-export-components': rule },\n});\n\nexport default plugin;\n"],"mappings":";;;;AAgBA,MAAM,aAAa,aAAa,MAC9B;AAGF,MAAM,OAAO,WAAW;CACtB,MAAM,WAAW;CACjB,WAAW,SAAkB;EAC3B,OAAO,EACL,QAAQ,MAAY;GAClB,WAAW,OAAO,OAAO,CAAC,CAAC,UAAU,IAAI;EAC3C,EACF;CACF;AACF,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAkCD,MAAM,SAAS,mBAAmB;CAChC,MAAM,EAAE,MAAM,gBAAgB;CAC9B,OAAO,EAAE,0BAA0B,KAAK;AAC1C,CAAC"}

package/package.json

@@ -0,0 +1,56 @@
+{
+  "name": "@ossido-labs/ossido-eslint-plugin",
+  "version": "0.1.0",
+  "publishConfig": {
+    "access": "public"
+  },
+  "description": "Oxlint plugin bundling the lint rules ossido projects should run. Currently exposes react-refresh's only-export-components so route/component files stay valid React Fast Refresh boundaries. Ossido is the react/rust fullstack framework",
+  "homepage": "https://ossido.dev",
+  "scripts": {
+    "dev": "tsdown --watch",
+    "build": "tsdown && tsc -p tsconfig.build.json",
+    "prepack": "bun run build",
+    "lint": "oxlint",
+    "format": "oxfmt --check .",
+    "format:fix": "oxfmt .",
+    "typecheck": "tsc --noEmit",
+    "test:watch": "vitest",
+    "test": "vitest run"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/ossido-labs/ossido.git",
+    "directory": "packages/ossido-eslint-plugin"
+  },
+  "keywords": [],
+  "author": "Chris Schofield <chris@childishforces.com>",
+  "license": "MIT",
+  "type": "module",
+  "types": "dist/esm/index.d.ts",
+  "main": "dist/esm/index.js",
+  "module": "dist/esm/index.js",
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "exports": {
+    ".": {
+      "types": "./dist/esm/index.d.ts",
+      "default": "./dist/esm/index.js"
+    },
+    "./package.json": "./package.json"
+  },
+  "dependencies": {
+    "eslint-plugin-react-refresh": "^0.5.3"
+  },
+  "peerDependencies": {
+    "@oxlint/plugins": "^1.76.0"
+  },
+  "devDependencies": {
+    "@oxlint/plugins": "1.76.0",
+    "oxlint": "1.76.0",
+    "tsdown": "0.22.14",
+    "vite-config": "1.0.0",
+    "vitest": "4.1.10"
+  }
+}