onsystem 0.10.0 → 0.10.2

package/dist/eslint-worker.d.ts

@@ -1,6 +1,5 @@
-import { h as DesignSystemModel, i as ResolvedConfig } from "./config-BbTW1jKU.js";
+import { h as DesignSystemModel, i as ResolvedConfig } from "./config-JaNAiR9Z.js";
 import { MessagePort } from "node:worker_threads";
-//#region src/eslint/worker.d.ts
 export interface LoadRequest {
   /** ESLint's working directory: where `check` would run from. */
   cwd: string;
@@ -32,5 +31,4 @@ export interface Call {
   signal: Int32Array;
   port: MessagePort;
 }
-export declare function load(request: LoadRequest): Promise<LoadResponse>;
-//#endregion
+export declare function load(request: LoadRequest): Promise<LoadResponse>;

package/dist/eslint-worker.js

@@ -1,9 +1,9 @@
-import { Mt as relativePath, at as excludedBy, i as componentFiles, r as buildModel } from "./design-system-D53Jxybo.js";
-import { r as loadTarget } from "./workspace-DAa_08uB.js";
+import { At as relativePath, i as componentFiles, ot as excludedBy, r as buildModel } from "./design-system-rl__N6tw.js";
+import { r as loadTarget } from "./workspace-INef0Yqt.js";
 import fs from "node:fs";
 import path from "node:path";
 import { parentPort } from "node:worker_threads";
-//#region src/eslint/worker.ts
+// src/eslint/worker.ts
 /**
 * The ESLint plugin's loader, in a worker thread. ESLint rules run synchronously, and finding a
 * project's design system does not (config files written in code, globs, the extraction
@@ -89,5 +89,4 @@ parentPort?.on("message", ({ request, signal, port }) => {
 		reply({ error: error.message });
 	});
 });
-//#endregion
 export { load };

package/dist/eslint.d.ts

@@ -1,5 +1,4 @@
 import { Linter, Rule } from "eslint";
-//#region src/eslint/index.d.ts
 /** `settings.onsystem`: where the project and its config are, when finding them from ESLint's cwd is not right. */
 export interface Settings {
   /** The project root, relative to ESLint's working directory (`check --root`). */
@@ -19,5 +18,4 @@ declare const plugin: {
     recommended: Linter.Config;
   };
 };
-//#endregion
 export { plugin as default };

package/dist/eslint.js

@@ -1,7 +1,7 @@
-import { Mt as relativePath, N as RULES, Q as DEFAULT_TEST_FOLDERS, X as DEFAULT_SEVERITY, Z as DEFAULT_TEST_EXCLUDE, t as DesignSystem, v as NAME, y as VERSION } from "./design-system-D53Jxybo.js";
+import { At as relativePath, N as RULES, Q as DEFAULT_TEST_FOLDERS, X as DEFAULT_SEVERITY, Z as DEFAULT_TEST_EXCLUDE, t as DesignSystem, v as NAME, y as VERSION } from "./design-system-rl__N6tw.js";
 import path from "node:path";
 import { MessageChannel, Worker, receiveMessageOnPort } from "node:worker_threads";
-//#region src/eslint/bridge.ts
+// src/eslint/bridge.ts
 /**
 * Calls the loader worker (`worker.ts`) synchronously: posts the request, blocks on a shared
 * flag until the worker has answered, and takes the answer off the port. The worker is
@@ -39,8 +39,7 @@ function loadSync(request) {
 		port1.close();
 	}
 }
-//#endregion
-//#region src/eslint/index.ts
+// src/eslint/index.ts
 /**
 * onsystem's rules as an ESLint plugin (ESLint 9 and 10, flat config):
 *
@@ -229,5 +228,4 @@ plugin.configs.recommended = {
 	plugins: { onsystem: plugin },
 	rules: Object.fromEntries(RULES.map((rule) => [`onsystem/${rule.id}`, DEFAULT_SEVERITY[rule.id]]))
 };
-//#endregion
 export { plugin as default };

package/dist/index.d.ts

@@ -1,8 +1,7 @@
-import { C as TOKEN_CATEGORIES, D as VariantInfo, E as TokenCategory, O as ImportMapping, S as SourceLocation, T as Token, _ as DocSection, a as ResolvedRule, b as PropInfo, c as configJsonSchema, d as CheckResult, f as ComponentDocs, g as Diagnostic, h as DesignSystemModel, i as ResolvedConfig, l as defineConfig, m as CompoundVariantInfo, n as LoadConfigOptions, o as RuleId, p as ComponentInfo, r as RULE_IDS, s as RuleOptions, t as Config, u as loadConfig, v as ExampleInfo, w as TextEdit, x as Severity, y as InheritedProps } from "./config-BbTW1jKU.js";
+import { C as TOKEN_CATEGORIES, D as VariantInfo, E as TokenCategory, O as ImportMapping, S as SourceLocation, T as Token, _ as DocSection, a as ResolvedRule, b as PropInfo, c as configJsonSchema, d as CheckResult, f as ComponentDocs, g as Diagnostic, h as DesignSystemModel, i as ResolvedConfig, l as defineConfig, m as CompoundVariantInfo, n as LoadConfigOptions, o as RuleId, p as ComponentInfo, r as RULE_IDS, s as RuleOptions, t as Config, u as loadConfig, v as ExampleInfo, w as TextEdit, x as Severity, y as InheritedProps } from "./config-JaNAiR9Z.js";
 import ts from "typescript";
 import { Oklch } from "culori";
 import { McpServer, Transport } from "@modelcontextprotocol/server";
-//#region src/lint/analyze.d.ts
 interface ImportBinding {
   source: string;
   /** Imported name, `default`, or `*` for namespace imports. */
@@ -37,8 +36,6 @@ interface Analysis {
   classStrings: ClassString[];
   styles: StyleObject[];
 }
-//#endregion
-//#region src/modules.d.ts
 /** Where an import points: a file relative to the root, or `{}` for a declared module not on disk. */
 interface ModuleLocation {
   file?: string;
@@ -83,8 +80,6 @@ declare class ModuleResolver {
   exportsOf(file: string): ModuleExports | undefined;
   private createResolver;
 }
-//#endregion
-//#region src/tokens/roles.d.ts
 /**
  * What a color utility paints, which decides the tokens that fit it: `text-*`
  * wants a foreground, `bg-*` a surface, `border-*` a border color.
@@ -100,8 +95,6 @@ type ColorRole = 'text' | 'surface' | 'line';
  * palette (`color-red-500`).
  */
 type ScopedFamily = string;
-//#endregion
-//#region src/tokens/css.d.ts
 /**
  * Reads design tokens from CSS custom properties, the way shadcn/ui and
  * Tailwind v4 projects define them:
@@ -114,14 +107,10 @@ export declare function parseCssTokens(css: string, file: string): {
   tokens: Token[];
   warnings: string[];
 };
-//#endregion
-//#region src/tokens/design-md.d.ts
 export declare function parseDesignMd(text: string, file: string): {
   tokens: Token[];
   warnings: string[];
 };
-//#endregion
-//#region src/tokens/dtcg.d.ts
 interface DtcgOptions {
   /** Prefix for generated custom property names: `ds` → `--ds-color-primary`. */
   prefix?: string;
@@ -130,8 +119,6 @@ export declare function parseDtcgTokens(text: string, file: string, options?: Dt
   tokens: Token[];
   warnings: string[];
 };
-//#endregion
-//#region src/tokens/export.d.ts
 /**
  * Writes the tokens onsystem found as a DTCG 2025.10 file or a DESIGN.md. Both are grouped by
  * category; reading the DTCG file back gives the same tokens, with the same names.
@@ -158,8 +145,6 @@ export declare function toDtcg(tokens: readonly Token[]): Exported;
 export declare function toDesignMd(tokens: readonly Token[], options: {
   name: string;
 }): Exported;
-//#endregion
-//#region src/tokens/index.d.ts
 interface TokenSource {
   file: string;
   /** DTCG only: prefix for generated custom property names. */
@@ -281,8 +266,6 @@ export declare class TokenIndex {
   /** px value of a token-like length string, resolving `var()` against the token set. */
   toPx(value: string): number | undefined;
 }
-//#endregion
-//#region src/lint/target.d.ts
 /** What the lint rules need to know about the design system. */
 declare class LintTarget {
   readonly model: DesignSystemModel;
@@ -378,8 +361,6 @@ declare class LintTarget {
   /** Component names for "did you mean" suggestions. */
   names(): string[];
 }
-//#endregion
-//#region src/lint/context.d.ts
 interface Report {
   start: number;
   end: number;
@@ -440,12 +421,8 @@ type Resolution =
 {
   kind: 'external';
 };
-//#endregion
-//#region src/lint/rules/index.d.ts
 /** Every rule, in the order they run. */
 export declare const RULES: readonly Rule[];
-//#endregion
-//#region src/lint/format.d.ts
 type OutputFormat = 'pretty' | 'json' | 'github' | 'sarif';
 /**
  * Renders check results:
@@ -468,8 +445,6 @@ export declare function formatDiagnostics(results: CheckResult[], format: Output
    */
   uri?: ((file: string) => string) | undefined;
 }): string;
-//#endregion
-//#region src/lint/index.d.ts
 interface CheckOptions {
   /** File name used in results and to pick TSX vs JSX parsing. Default `snippet.tsx`. */
   filename?: string | undefined;
@@ -483,8 +458,6 @@ interface CheckOptions {
 export declare function checkSource(code: string, target: LintTarget, options: CheckOptions): CheckResult;
 /** Applies non-overlapping fixes from the end of the file backwards. */
 export declare function applyFixes(code: string, diagnostics: Diagnostic[]): string;
-//#endregion
-//#region src/search/bm25.d.ts
 /**
  * Okapi BM25 over weighted fields (BM25F-style: field weights scale term
  * frequency and document length). Small, dependency-free and deterministic,
@@ -512,8 +485,6 @@ declare class Bm25Index<T> {
   get size(): number;
   search(query: Map<string, number>, limit?: number): Bm25Hit<T>[];
 }
-//#endregion
-//#region src/search/index.d.ts
 interface SearchHit {
   component: ComponentInfo;
   score: number;
@@ -530,8 +501,6 @@ interface SearchHit {
  * which is not an answer to give as the best match.
  */
 export declare function searchComponents(index: Bm25Index<ComponentInfo>, query: string, limit?: number): SearchHit[];
-//#endregion
-//#region src/util/log.d.ts
 /**
  * Diagnostics go to stderr: in stdio mode stdout carries JSON-RPC and must
  * never receive anything else.
@@ -541,8 +510,6 @@ interface Logger {
   warn(message: string): void;
   error(message: string): void;
 }
-//#endregion
-//#region src/design-system.d.ts
 /** A loaded design system: the model plus the indexes the tools query. */
 export declare class DesignSystem {
   readonly model: DesignSystemModel;
@@ -659,6 +626,11 @@ export declare class DesignSystemHost {
   constructor(config: ResolvedConfig, options?: HostOptions);
   get(): Promise<DesignSystem>;
   reload(): Promise<DesignSystem>;
+  /**
+   * `build`, dropped if it fails with no earlier model to serve instead (a first build that
+   * fails), so the next `get()` builds again.
+   */
+  private kept;
   onChange(listener: (ds: DesignSystem) => void): () => void;
   /** Watches the component, token and docs locations, the config and the tsconfig chain. */
   watch(): void;
@@ -677,8 +649,6 @@ export declare class DesignSystemHost {
   private reloadConfig;
   private build;
 }
-//#endregion
-//#region src/extract/components.d.ts
 interface ExtractComponentsOptions {
   root: string;
   /** Absolute paths of the component source files. */
@@ -708,8 +678,6 @@ interface ExtractComponentsResult {
  * `Tabs.List` via static members or `Object.assign`).
  */
 export declare function extractComponents(options: ExtractComponentsOptions): ExtractComponentsResult;
-//#endregion
-//#region src/extract/cva.d.ts
 /** A `cva()` (class-variance-authority) or `tv()` (tailwind-variants) definition. */
 interface VariantDefinition {
   /** The variable it is assigned to, e.g. `buttonVariants`. */
@@ -721,8 +689,6 @@ interface VariantDefinition {
 }
 /** Finds every `const x = cva(base, { variants, defaultVariants })` in a file. */
 export declare function findVariantDefinitions(sourceFile: ts.SourceFile): Map<string, VariantDefinition>;
-//#endregion
-//#region src/extract/docs.d.ts
 interface ParsedDoc {
   file: string;
   title?: string;
@@ -739,8 +705,6 @@ interface ParsedDoc {
 export declare function parseDoc(text: string, file: string): ParsedDoc;
 /** Attaches docs and their examples to components. Returns warnings for unmatched pages. */
 export declare function attachDocs(components: ComponentInfo[], docs: ParsedDoc[]): string[];
-//#endregion
-//#region src/catalog.d.ts
 /** One project's design system at a workspace root. */
 interface ServedProject {
   ds: DesignSystem;
@@ -809,8 +773,6 @@ declare class Catalog {
     query?: string | undefined;
   }): CatalogToken[];
 }
-//#endregion
-//#region src/server/index.d.ts
 export declare const INSTRUCTIONS = "This server describes the project's design system: its React components (props, variants, parts), design tokens and usage docs, and lints UI code against it.\nWhen writing or changing UI in this project:\n1. Find components with search_components (by intent) or list_components.\n2. Read get_component before using a component: use only the props and variant values it lists.\n3. Style with tokens from get_tokens, never with hex/rgb colors, arbitrary px values or Tailwind's default palette. chart-* and sidebar-* tokens are for charts and the sidebar only: for a status color the theme has no token for (success, warning, info), add a token or keep the Tailwind color as check_ui says, and never use a chart-* or sidebar-* token for it.\n4. Run check_ui on every snippet or file you write and fix all errors before you finish.\nIn a monorepo served from its root, pass `path` (the file you are editing) to list_components, get_component, search_components and get_tokens, and `path` or `filename` to check_ui, so each answer comes from that file's own project.";
 interface CreateServerOptions {
   /**
@@ -826,9 +788,7 @@ interface CreateServerOptions {
   getProjects?: (target?: string) => Promise<ProjectSet | undefined>;
 }
 /** Builds the MCP server: five tools, two resources and one prompt. Transport-agnostic. */
-export declare function createServer({ getDesignSystem, getProjects }: CreateServerOptions): McpServer;
-//#endregion
-//#region src/server/stdio.d.ts
+export declare function createServer(options: CreateServerOptions): McpServer;
 interface ServeOptions extends LoadConfigOptions {
   cwd: string;
   cache: boolean;
@@ -860,12 +820,18 @@ interface ServerHandle {
  * project marker, or the monorepo root above that, served as if the server had been
  * started there, except that a config there is read only when it is JSON: a prompt can
  * choose the path, so a JavaScript or TypeScript config is not run. Each root found is
- * loaded once and kept; a request without an absolute path is answered from the one root
- * found so far.
+ * loaded once and kept, by its real path; a request without an absolute path is answered from
+ * the one root found so far. The same holds for a `--root` (or a client's root) that is no
+ * project but holds projects in its folders, such as a folder of repositories, except that only
+ * an absolute path in that folder is answered, from the project in it that holds the file (never
+ * from a folder outside or above it), and a file in none of them from that folder, as before.
+ * Links are resolved: a path, or the project it leads to, that is really outside the folder is
+ * refused, a workspace in it serves only its packages that are really in it, and a project in it
+ * that a link replaces while the server runs is not built again from where the link leads.
+ *
+ * A load that fails, such as on an invalid config, is not kept: the next request loads
+ * again, so fixing the config is enough, also when it was invalid at startup.
  */
 export declare function serveStdio(options: ServeOptions): Promise<ServerHandle>;
-//#endregion
-//#region src/version.d.ts
 export declare const VERSION: string;
-//#endregion
 export { type CheckResult, type ComponentDocs, type ComponentInfo, type CompoundVariantInfo, type Config, type DesignSystemModel, type Diagnostic, type DocSection, type ExampleInfo, type HostOptions, type InheritedProps, type LoadConfigOptions, type LoadOptions, type OutputFormat, type PropInfo, RULE_IDS, type ResolvedConfig, type RuleId, type Severity, type SourceLocation, type TOKEN_CATEGORIES, type TextEdit, type Token, type TokenCategory, type VariantInfo, configJsonSchema, defineConfig, loadConfig };

package/dist/index.js

@@ -1,3 +1,3 @@
-import { F as loadTokens, G as parseDoc, H as parseDesignMd, I as mergeTokens, K as extractComponents, L as toDesignMd, N as RULES, P as TokenIndex, R as toDtcg, U as parseCssTokens, V as parseDtcgTokens, W as attachDocs, _ as formatDiagnostics, a as fingerprint, dt as findVariantDefinitions, f as searchComponents, it as defineConfig, m as checkSource, n as DesignSystemHost, nt as RULE_IDS, o as loadDesignSystem, p as applyFixes, r as buildModel, rt as configJsonSchema, st as loadConfig, t as DesignSystem, y as VERSION } from "./design-system-D53Jxybo.js";
-import { n as INSTRUCTIONS, r as createServer, t as serveStdio } from "./stdio-ha4IF0CU.js";
+import { F as loadTokens, G as parseDoc, H as parseDesignMd, I as mergeTokens, K as extractComponents, L as toDesignMd, N as RULES, P as TokenIndex, R as toDtcg, U as parseCssTokens, V as parseDtcgTokens, W as attachDocs, _ as formatDiagnostics, a as fingerprint, at as defineConfig, ct as loadConfig, f as searchComponents, ft as findVariantDefinitions, it as configJsonSchema, m as checkSource, n as DesignSystemHost, o as loadDesignSystem, p as applyFixes, r as buildModel, rt as RULE_IDS, t as DesignSystem, y as VERSION } from "./design-system-rl__N6tw.js";
+import { n as INSTRUCTIONS, r as createServer, t as serveStdio } from "./stdio-CkczPt_1.js";
 export { DesignSystem, DesignSystemHost, INSTRUCTIONS, RULES, RULE_IDS, TokenIndex, VERSION, applyFixes, attachDocs, buildModel, checkSource, configJsonSchema, createServer, defineConfig, extractComponents, findVariantDefinitions, fingerprint, formatDiagnostics, loadConfig, loadDesignSystem, loadTokens, mergeTokens, parseCssTokens, parseDesignMd, parseDoc, parseDtcgTokens, searchComponents, serveStdio, toDesignMd, toDtcg };