onsystem 0.10.0 → 0.10.2

package/README.md

@@ -69,7 +69,7 @@ npx -y onsystem check .   # the same check the agent and CI run
 npx -y onsystem init      # write the config, and offer a baseline
 ```
 
-At a [monorepo root](https://onsystem.vercel.app/docs/configuration#monorepo-roots), `inspect` lists every app and design-system package, and `check` checks each file by its own project's design system. In a [design-system package](https://onsystem.vercel.app/docs/design-system-packages), `init` sets it up for every app that depends on it, with no config in the apps: as a workspace package, or installed from npm when it publishes its component sources (`init` checks its `files` list). From a package that publishes only compiled code, installed apps get the token rules but no component, prop, variant or native-element checks.
+At a [monorepo root](https://onsystem.vercel.app/docs/configuration#monorepo-roots), `inspect` lists every app and design-system package, and `check` checks each file by its own project's design system. In a [design-system package](https://onsystem.vercel.app/docs/design-system-packages), `init` sets it up for every app that depends on it, with no config in the apps: as a workspace package, or installed from npm. Installed apps read the components from the sources the package publishes, or from its type declarations (`.d.ts`) when it publishes only compiled `dist/`, and get every rule either way (`init` checks its `files` list). From a package that publishes compiled code and no type declarations, they get the token rules but no component, prop, variant or native-element checks.
 
 In a new create-next-app, the template page's hardcoded colors already make the first `check .` fail; `init` offers to record them as a baseline, so only new findings fail. Folders installed from a shadcn registry, such as `components/ai-elements`, are someone else's code: [Code from shadcn registries](https://onsystem.vercel.app/docs/configuration#code-from-shadcn-registries) says how to check them or leave them out.
 
@@ -128,6 +128,21 @@ steps:
 
 That count is onsystem's own, and the MCP server and the hook show the agent the same errors to fix. In tasks that ask for a green status label in a design system with no success token, agents with onsystem often used `chart-*` tokens, which it counts as clean. The blind labels by an AI reviewer, 12 files per arm, are too few to confirm the count either way, and every violation they found with the hook or all three is a palette color in Dub, whose tokens 0.5.0 did not read. The [benchmark page](https://onsystem.vercel.app/benchmark) has every table, and [bench/v2](bench/v2) the method, the per-run data and every generated file.
 
+## Compatibility
+
+What `package.json` declares and CI runs:
+
+| With             | Supported                                                                                                                                                                                              |
+| ---------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
+| Node.js          | Node.js 20.19 or later (`engines`). CI runs the tests on Node.js 22, 24 and 26, and the built package on 20.19                                                                                         |
+| Operating system | Linux, macOS and Windows: CI runs the tests and the pack test on each                                                                                                                                  |
+| ESLint           | ESLint 8.57, 9 and 10, for the ESLint plugin only: `eslint` is an optional peer, and the CLI, the MCP server, the hook and the Action do not need it                                                   |
+| TypeScript       | Your project's TypeScript is not used, and a JavaScript project needs none: onsystem reads `.tsx` and `.jsx` with its own TypeScript 6.0, a dependency, not a peer                                     |
+| React            | Components written for React 18 (`forwardRef`) or React 19 (`ref` as a prop), read from source or type declarations. onsystem does not depend on React                                                 |
+| Tailwind CSS     | v4 (`@theme`) and v3 (`tailwind.config`, read without running it). Without Tailwind, tokens come from CSS custom properties, DTCG files or a DESIGN.md                                                 |
+| shadcn/ui        | Both bases, Radix (`asChild`) and Base UI (`render`), on Tailwind v3 or v4, with no config                                                                                                             |
+| MCP clients      | Any client that starts a stdio server; CI connects on the 2025-11-25 and 2026-07-28 protocols. [Set up your agent](https://onsystem.vercel.app/docs/clients) has each client's config and support tier |
+
 ## Docs
 
 On the [website](https://onsystem.vercel.app/docs), and as Markdown in [docs/](docs):

package/dist/cli.js

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
-import { $ as DEFAULT_TOKENS, A as unrecordedRules, At as isInside, B as statusKinds, C as countBaseline, D as pruneBaseline, E as onLines, Et as plural, Ft as readProjectConfig, J as ConfigError, L as toDesignMd, M as writeBaseline, Mt as relativePath, Nt as toPosix, O as readBaseline, Ot as unique, R as toDtcg, S as applyBaseline, T as goneFiles, Y as DEFAULT_DOCS, _ as formatDiagnostics, at as excludedBy, b as BASELINE_FILE, c as silentLogger, et as FALLBACK_TOKENS, g as escapeData, gt as PACKAGE_FIELD, h as uncheckedNotice, ht as notReadYet, i as componentFiles, j as updateBaseline, jt as matchesGlob, k as rulesRun, kt as SCRIPT_FILE, l as stderrLogger, lt as rulesFor, mt as libraryTitle, nt as RULE_IDS, o as loadDesignSystem, q as CONFIG_FILES, s as tokenFiles, tt as LEGACY_CONFIG_FILES, v as NAME, vt as declaredConfig, w as findMoves, x as LEGACY_BASELINE_FILE, xt as isDesignSystemName, y as VERSION, yt as detectProject } from "./design-system-D53Jxybo.js";
-import { a as notReadNotices, i as missingDependencies, o as explainProject, s as librariesLeftOut, t as serveStdio } from "./stdio-ha4IF0CU.js";
-import { r as loadTarget } from "./workspace-DAa_08uB.js";
+import { $ as DEFAULT_TOKENS, A as unrecordedRules, At as relativePath, B as statusKinds, C as countBaseline, D as pruneBaseline, Dt as isInside, E as onLines, Et as SCRIPT_FILE, It as unique, J as ConfigError, L as toDesignMd, M as writeBaseline, O as readBaseline, Ot as matchesGlob, Pt as plural, R as toDtcg, Rt as readProjectConfig, S as applyBaseline, St as isDesignSystemName, T as goneFiles, Y as DEFAULT_DOCS, _ as formatDiagnostics, _t as PACKAGE_FIELD, b as BASELINE_FILE, bt as detectProject, c as silentLogger, et as FALLBACK_TOKENS, g as escapeData, gt as notReadYet, h as uncheckedNotice, ht as libraryTitle, i as componentFiles, j as updateBaseline, jt as toPosix, k as rulesRun, l as stderrLogger, o as loadDesignSystem, ot as excludedBy, q as CONFIG_FILES, rt as RULE_IDS, s as tokenFiles, tt as LEGACY_CONFIG_FILES, ut as rulesFor, v as NAME, w as findMoves, x as LEGACY_BASELINE_FILE, y as VERSION, yt as declaredConfig } from "./design-system-rl__N6tw.js";
+import { a as notReadNotices, i as missingDependencies, o as explainProject, s as librariesLeftOut, t as serveStdio } from "./stdio-CkczPt_1.js";
+import { r as loadTarget } from "./workspace-INef0Yqt.js";
 import fs from "node:fs";
 import path from "node:path";
 import { escapePath, glob } from "tinyglobby";
@@ -10,7 +10,7 @@ import fsp from "node:fs/promises";
 import { spawnSync } from "node:child_process";
 import readline from "node:readline/promises";
 import { parseArgs } from "node:util";
-//#region src/init.ts
+// src/init.ts
 const SCHEMA = "https://unpkg.com/onsystem/schema.json";
 /** More detected globs than this are files, not folders: zero config keeps them. */
 const MAX_GLOBS = 6;
@@ -685,8 +685,7 @@ function count$1(n, word) {
 function andList(items, conjunction = "and") {
 	return items.length > 1 ? `${items.slice(0, -1).join(", ")} ${conjunction} ${items.at(-1) ?? ""}` : items.join("");
 }
-//#endregion
-//#region src/cli.ts
+// src/cli.ts
 const DOCS = "https://onsystem.vercel.app/docs";
 const HELP = `${NAME} ${VERSION}
 
@@ -944,7 +943,8 @@ async function main(argv, io = defaultIo) {
 			io.stderr(error.message);
 			return 2;
 		}
-		throw error;
+		io.stderr(error.stack ?? String(error));
+		return 2;
 	}
 }
 async function check(patterns, configOptions, values, io) {
@@ -1880,13 +1880,11 @@ function displayPath(cwd, file) {
 	const rel = path.relative(cwd, file);
 	return rel && !rel.startsWith("..") && !path.isAbsolute(rel) ? rel : file;
 }
-//#endregion
-//#region src/bin.ts
+// src/bin.ts
 main(process.argv.slice(2)).then((code) => {
 	process.exitCode = code;
 }, (error) => {
 	process.stderr.write(`${error.stack ?? String(error)}\n`);
 	process.exitCode = 1;
 });
-//#endregion
 export {};

package/dist/{config-BbTW1jKU.d.ts → config-JaNAiR9Z.d.ts}

@@ -1,5 +1,4 @@
 import * as z from "zod";
-//#region src/detect.d.ts
 /**
  * How apps import a design-system module, from a package's `exports`:
  * `@midday/ui/button` → `../../packages/ui/src/components/button.tsx`, or a
@@ -45,8 +44,6 @@ interface DesignSystemSource {
    */
   registry?: string | undefined;
 }
-//#endregion
-//#region src/types.d.ts
 /**
  * The design-system model the server exposes. Everything here is plain JSON so
  * it can be cached on disk and returned as MCP structured content.
@@ -269,8 +266,6 @@ interface CheckResult {
    */
   skipped?: string;
 }
-//#endregion
-//#region src/libraries/index.d.ts
 /** The ids of the libraries onsystem can read, for the config's `libraries` list. */
 declare const LIBRARY_IDS: readonly ["mui"];
 type LibraryId = (typeof LIBRARY_IDS)[number];
@@ -287,8 +282,6 @@ interface LibrarySource {
    */
   designSystem?: true | undefined;
 }
-//#endregion
-//#region src/config.d.ts
 declare const RULE_IDS: readonly ["no-hardcoded-color", "no-hardcoded-spacing", "no-hardcoded-radius", "prefer-design-system-component", "no-unknown-component", "no-unknown-prop", "no-unknown-variant", "icon-button-accessible-name"];
 type RuleId = (typeof RULE_IDS)[number];
 declare const severitySchema: z.ZodEnum<{
@@ -504,9 +497,14 @@ interface LoadConfigOptions {
    * choose, unlike the folder the server was started in.
    */
   jsonConfigOnly?: boolean | undefined;
+  /**
+   * With `jsonConfigOnly`: the folder the MCP server was started for (its `--root` or the
+   * client's root) when that folder is no project but holds the one read, which the error for a
+   * JavaScript or TypeScript config names.
+   */
+  jsonConfigWithin?: string | undefined;
 }
 declare function loadConfig(options?: LoadConfigOptions): Promise<ResolvedConfig>;
 /** JSON Schema for editor completion in `onsystem.config.json`. */
 declare function configJsonSchema(): Record<string, unknown>;
-//#endregion
 export { TOKEN_CATEGORIES as C, VariantInfo as D, TokenCategory as E, ImportMapping as O, SourceLocation as S, Token as T, DocSection as _, ResolvedRule as a, PropInfo as b, configJsonSchema as c, CheckResult as d, ComponentDocs as f, Diagnostic as g, DesignSystemModel as h, ResolvedConfig as i, defineConfig as l, CompoundVariantInfo as m, LoadConfigOptions as n, RuleId as o, ComponentInfo as p, RULE_IDS as r, RuleOptions as s, Config as t, loadConfig as u, ExampleInfo as v, TextEdit as w, Severity as x, InheritedProps as y };