onsystem 0.10.1 → 0.10.3

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 { at as excludedBy, i as componentFiles, kt as relativePath, r as buildModel } from "./design-system-CPH4C7-1.js";
-import { r as loadTarget } from "./workspace-BINqxi7p.js";
+import { At as relativePath, i as componentFiles, ot as excludedBy, r as buildModel } from "./design-system-7wZoJsMm.js";
+import { r as loadTarget } from "./workspace-C5pMS6Xv.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 { N as RULES, Q as DEFAULT_TEST_FOLDERS, X as DEFAULT_SEVERITY, Z as DEFAULT_TEST_EXCLUDE, kt as relativePath, t as DesignSystem, v as NAME, y as VERSION } from "./design-system-CPH4C7-1.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-7wZoJsMm.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,12 +266,10 @@ 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;
-  readonly config: Pick<ResolvedConfig, 'elements' | 'importPath'> & Partial<Pick<ResolvedConfig, 'designSystems'>>;
+  readonly config: Pick<ResolvedConfig, 'elements' | 'importPath'> & Partial<Pick<ResolvedConfig, 'designSystems' | 'imports'>>;
   private readonly resolver?;
   readonly components: Map<string, ComponentInfo>;
   /** Every component under each name and alias, when two design systems share one (`Button`). */
@@ -308,13 +291,15 @@ declare class LintTarget {
   private readonly sources?;
   /** Published libraries the model read from type declarations: `@mui/material`. */
   readonly libraries: Set<string>;
+  /** The name in each package.json read, by its path: undefined where there is none. */
+  private readonly manifests;
   /**
    * `resolver` finds the module an import points at and what it exports
    * (`@calcom/ui/components/icon` → `components/icon/index.ts`), so a name from
    * a module the model left out is not taken for an invented one. Without it,
    * every missing name is invented.
    */
-  constructor(model: DesignSystemModel, config: Pick<ResolvedConfig, 'elements' | 'importPath'> & Partial<Pick<ResolvedConfig, 'designSystems'>>, resolver?: Pick<ModuleResolver, "locate" | "exportsOf"> | undefined);
+  constructor(model: DesignSystemModel, config: Pick<ResolvedConfig, 'elements' | 'importPath'> & Partial<Pick<ResolvedConfig, 'designSystems' | 'imports'>>, resolver?: Pick<ModuleResolver, "locate" | "exportsOf"> | undefined);
   /**
    * Whether an import specifier points at the design system. Relative
    * specifiers are resolved against `fromFile` (relative to the root) and
@@ -335,10 +320,27 @@ declare class LintTarget {
    * model left out rather than an invented one: its module exists outside the
    * folders extraction read and exports `name`, or re-exports from such a
    * module (an excluded `icons/` folder, a barrel's `export * from "./icons"`).
-   * A module declared in a package's `exports` but not on disk counts too,
-   * except the design system's own import path.
+   * A module declared in a package's `exports` but not on disk counts too (built to `dist/`,
+   * not built yet), except the design system's own import path, and one whose export, as the
+   * package.json writes it, leads to a source file only: `@acme/ui/components/tooltip` is
+   * `src/components/tooltip.tsx` through `"./components/*": "./src/components/*.tsx"`, and with
+   * no such file it does not exist.
    */
   outsideModel(specifier: string, name: string, fromFile?: string): boolean;
+  /**
+   * The module a design-system package's `exports` lead `specifier` to, relative to the root, as
+   * its package.json writes them: the first of the entry's targets that is on disk, else, when
+   * each of them is a source file, the first (which does not exist). Undefined when a target
+   * leads to a build folder (`"./*": "./dist/components/*.js"`, maybe not built yet, whose
+   * sources may be anywhere), the entry blocks the subpath (`null`), or no entry maps it.
+   */
+  private exportedSource;
+  /**
+   * The folder of package `name` that `file` is in: the nearest package.json above it with a
+   * name, when that name is `name`. One without a name (`{"type": "module"}` in a subfolder) is
+   * no package's. Each package.json is read once.
+   */
+  private packageDir;
   /**
    * The component a JSX tag means when `name` is imported from `specifier`, among the
    * model's components of that name: the one declared where the import leads, through
@@ -378,8 +380,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 +440,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 +464,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 +477,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 +504,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 +520,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 +529,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 +645,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 +668,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 +697,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 +708,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 +724,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 +792,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 {
   /**
@@ -827,8 +808,6 @@ interface CreateServerOptions {
 }
 /** Builds the MCP server: five tools, two resources and one prompt. Transport-agnostic. */
 export declare function createServer(options: CreateServerOptions): McpServer;
-//#endregion
-//#region src/server/stdio.d.ts
 interface ServeOptions extends LoadConfigOptions {
   cwd: string;
   cache: boolean;
@@ -860,12 +839,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-CPH4C7-1.js";
-import { n as INSTRUCTIONS, r as createServer, t as serveStdio } from "./stdio-BK2kMN1x.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-7wZoJsMm.js";
+import { n as INSTRUCTIONS, r as createServer, t as serveStdio } from "./stdio-B31hp2UZ.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 };