starlint 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 ogghead
+
+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,89 @@
+# starlint
+
+A fast, Rust-based JavaScript/TypeScript linter with first-class WASM plugin support.
+
+## Features
+
+- **Fast**: Built on [oxc](https://oxc.rs) for parsing, with single-pass AST traversal
+- **WASM Plugins**: Write lint rules in Rust (or any language targeting WASM) using the Component Model
+- **Native Rules**: High-performance rules that operate directly on the oxc AST
+- **Parallel**: File-level parallelism via rayon
+- **Configurable**: `starlint.toml` with rule severity overrides and file pattern overrides
+
+## Benchmarks
+
+<!-- BENCHMARKS_START -->
+Compared against [oxlint](https://oxc.rs) and [eslint](https://eslint.org) on real-world codebases with 20 equivalent lint rules.
+
+| Corpus | Files | starlint | oxlint | eslint |
+|--------|------:|----------|--------|--------|
+| express | 141 | **13ms (11 MB)** | 108ms (110 MB) | 1.50s (259 MB) |
+| date-fns | 1562 | **74ms (11 MB)** | 91ms (113 MB) | 4.78s (433 MB) |
+| grafana | 6201 | **310ms (18 MB)** | 389ms (133 MB) | 31.47s (557 MB) |
+<details>
+<summary>Full defaults (all rules enabled per tool)</summary>
+
+| Corpus | Files | starlint | oxlint | eslint |
+|--------|------:|----------|--------|--------|
+| express | 141 | 91ms (18 MB) | **71ms (108 MB)** | 1.79s (262 MB) |
+| date-fns | 1562 | 529ms (36 MB) | **140ms (109 MB)** | 6.00s (460 MB) |
+| grafana | 6201 | 3.26s (270 MB) | **695ms (152 MB)** | 4.88s (526 MB) |
+</details>
+
+*Last updated: 2026-03-04. Benchmarked with [hyperfine](https://github.com/sharkdp/hyperfine) (3 warmup, 10+ runs).*
+<!-- BENCHMARKS_END -->
+
+## Flamegraph
+
+Profiling starlint on the [Grafana](https://github.com/grafana/grafana) codebase (~6k files) with default rules:
+
+[![Flamegraph](https://raw.githubusercontent.com/ogghead/starlint/flamegraph-assets/flamegraph.svg)](https://raw.githubusercontent.com/ogghead/starlint/flamegraph-assets/flamegraph.svg)
+
+<sub>Click for interactive view. Auto-generated on each push to master.</sub>
+
+## Status
+
+**Early development** — the framework is being built. The first plugin (Storybook rules) will be ported from [oxlint-plugin-storybook](https://github.com/ogghead/oxlint-plugin-storybook).
+
+## Quick Start
+
+```bash
+# Build
+cargo build --workspace
+
+# Run
+cargo run -- .
+
+# Initialize config
+cargo run -- init
+```
+
+## Configuration
+
+Create a `starlint.toml` in your project root:
+
+```toml
+[settings]
+threads = 0  # 0 = auto-detect
+
+[[plugins]]
+name = "storybook"
+path = "./plugins/starlint-plugin-storybook.wasm"
+
+[rules]
+"no-debugger" = "error"
+"storybook/default-exports" = "error"
+
+[[overrides]]
+files = ["**/*.stories.tsx"]
+[overrides.rules]
+"storybook/default-exports" = "error"
+```
+
+## Plugin Development
+
+Plugins implement the WIT interface defined in `wit/plugin.wit`. See the `examples/` directory for sample plugins.
+
+## License
+
+MIT

package/bin/starlint

@@ -0,0 +1,78 @@
+#!/usr/bin/env node
+
+const { spawnSync } = require("child_process");
+const { platform, arch } = require("os");
+const { join } = require("path");
+
+const PLATFORMS = {
+  "linux-x64": {
+    package: "@starlint/cli-linux-x64-gnu",
+    binary: "starlint",
+  },
+  "linux-arm64": {
+    package: "@starlint/cli-linux-arm64-gnu",
+    binary: "starlint",
+  },
+  "darwin-x64": {
+    package: "@starlint/cli-darwin-x64",
+    binary: "starlint",
+  },
+  "darwin-arm64": {
+    package: "@starlint/cli-darwin-arm64",
+    binary: "starlint",
+  },
+  "win32-x64": {
+    package: "@starlint/cli-win32-x64-msvc",
+    binary: "starlint.exe",
+  },
+};
+
+function getBinaryPath() {
+  const key = `${platform()}-${arch()}`;
+  const config = PLATFORMS[key];
+
+  if (!config) {
+    console.error(
+      `Error: starlint does not have a prebuilt binary for ${platform()} ${arch()}.\n` +
+        `Supported platforms: ${Object.keys(PLATFORMS).join(", ")}.\n` +
+        `You can build from source: https://github.com/ogghead/starlint`
+    );
+    process.exit(1);
+  }
+
+  try {
+    const packageDir = require.resolve(`${config.package}/package.json`);
+    return join(packageDir, "..", config.binary);
+  } catch {
+    console.error(
+      `Error: The platform-specific package "${config.package}" is not installed.\n` +
+        `This usually means your package manager did not install the optional dependency.\n\n` +
+        `Try reinstalling:\n` +
+        `  npm install starlint\n\n` +
+        `If the problem persists, install the platform package directly:\n` +
+        `  npm install ${config.package}\n\n` +
+        `Or build from source: https://github.com/ogghead/starlint`
+    );
+    process.exit(1);
+  }
+}
+
+const binaryPath = getBinaryPath();
+const result = spawnSync(binaryPath, process.argv.slice(2), {
+  stdio: "inherit",
+  shell: platform() === "win32",
+});
+
+if (result.error) {
+  if (result.error.code === "ENOENT") {
+    console.error(
+      `Error: Could not find the starlint binary at ${binaryPath}.\n` +
+        `The platform package may be corrupted. Try reinstalling:\n` +
+        `  npm install starlint`
+    );
+    process.exit(1);
+  }
+  throw result.error;
+}
+
+process.exit(result.status ?? 1);

package/package.json

@@ -0,0 +1,36 @@
+{
+  "name": "starlint",
+  "version": "0.1.0",
+  "description": "A fast, Rust-based JavaScript/TypeScript linter",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/ogghead/starlint"
+  },
+  "homepage": "https://github.com/ogghead/starlint",
+  "keywords": [
+    "linter",
+    "javascript",
+    "typescript",
+    "lint",
+    "static-analysis"
+  ],
+  "bin": {
+    "starlint": "bin/starlint"
+  },
+  "files": [
+    "bin/starlint",
+    "README.md",
+    "LICENSE"
+  ],
+  "engines": {
+    "node": ">=14"
+  },
+  "optionalDependencies": {
+    "@starlint/cli-linux-x64-gnu": "0.1.0",
+    "@starlint/cli-linux-arm64-gnu": "0.1.0",
+    "@starlint/cli-darwin-x64": "0.1.0",
+    "@starlint/cli-darwin-arm64": "0.1.0",
+    "@starlint/cli-win32-x64-msvc": "0.1.0"
+  }
+}