@razorwind/eslint 0.0.2

package/dist/runtime.d.cts

@@ -0,0 +1,110 @@
+import { a as DesignSystemRuleId, d as ManifestToken, f as TokenCategory, i as DesignSystemOptions, l as ManifestComponent, n as CoreRuleId, o as DesignSystemSettings, p as TokenReferenceStyle, r as DesignSystemManifest, s as DesignSystemSeverity, t as ComponentRole, u as ManifestFont } from "./types-cqb0r3sP.cjs";
+import { GuardrailRuleModule } from "@razorwind/tailwindcss/eslint-runtime";
+import { GuardrailRuleModule as GuardrailRuleModule$1 } from "@razorwind/tamagui/eslint-runtime";
+//#region src/runtime/ast.d.ts
+interface Node {
+  type: string;
+  parent?: Node;
+  range?: [number, number];
+  [key: string]: unknown;
+}
+interface Fix {
+  range: [number, number];
+  text: string;
+}
+interface Fixer {
+  replaceText: (node: Node, text: string) => Fix;
+  replaceTextRange: (range: [number, number], text: string) => Fix;
+}
+type FixFunction = (fixer: Fixer) => Fix | Fix[] | null;
+interface SuggestionDescriptor {
+  messageId: string;
+  data?: Record<string, string>;
+  fix: FixFunction;
+}
+interface ReportDescriptor {
+  node: Node;
+  messageId: string;
+  data?: Record<string, string>;
+  fix?: FixFunction;
+  suggest?: SuggestionDescriptor[];
+}
+interface Variable {
+  defs: {
+    node: Node;
+  }[];
+}
+interface Scope {
+  set: Map<string, Variable>;
+  upper: Scope | null;
+}
+interface SourceCode {
+  getText: (node?: Node) => string;
+  getScope?: (node: Node) => Scope;
+}
+interface RuleContext {
+  report: (descriptor: ReportDescriptor) => void;
+  settings?: Record<string, unknown>;
+  sourceCode: SourceCode;
+}
+type Visitors = Record<string, (node: Node) => void>;
+interface RuleModule {
+  meta: {
+    type: "problem" | "suggestion";
+    docs: {
+      description: string;
+    };
+    messages: Record<string, string>;
+    schema: [];
+    fixable?: "code";
+    hasSuggestions?: boolean;
+  };
+  create: (context: RuleContext) => Visitors;
+}
+//#endregion
+//#region src/runtime/settings.d.ts
+/** Settings key the core rules read their sources from. */
+declare const SETTINGS_KEY = "razorwind-design-system";
+//#endregion
+//#region src/runtime/values.d.ts
+/**
+ * Normalize a CSS color to `#rrggbbaa` (hex, `rgb()`, `hsl()`, named colors);
+ * other color spaces are compared as lowercased, whitespace-collapsed text.
+ */
+declare function normalizeColor(input: string): string | undefined;
+//#endregion
+//#region src/runtime.d.ts
+type AnyRuleModule = RuleModule | GuardrailRuleModule | GuardrailRuleModule$1;
+interface DesignSystemConfig {
+  files: string[];
+  ignores: string[];
+  plugins: Record<string, DesignSystemEslintPlugin>;
+  settings: Record<string, unknown>;
+  rules: Record<string, DesignSystemSeverity>;
+}
+interface DesignSystemEslintPlugin {
+  meta: {
+    name: string;
+    version: string;
+  };
+  rules: Partial<Record<DesignSystemRuleId, AnyRuleModule>>;
+  configs: {
+    recommended?: DesignSystemConfig;
+  };
+}
+interface DesignSystemPlugin {
+  plugin: DesignSystemEslintPlugin;
+  rules: Partial<Record<DesignSystemRuleId, AnyRuleModule>>;
+  defaultSeverity: Partial<Record<DesignSystemRuleId, DesignSystemSeverity>>;
+  configs: DesignSystemEslintPlugin["configs"];
+  /** Build a flat-config block to spread into `eslint.config.*`. */
+  config: (options?: DesignSystemOptions) => DesignSystemConfig;
+}
+/**
+ * Build the design-system rules, default severities and flat-config factory
+ * for a schema-derived manifest.
+ */
+declare function createDesignSystemPlugin(manifest: DesignSystemManifest): DesignSystemPlugin;
+//#endregion
+export { AnyRuleModule, type ComponentRole, type CoreRuleId, DesignSystemConfig, DesignSystemEslintPlugin, type DesignSystemManifest, type DesignSystemOptions, DesignSystemPlugin, type DesignSystemRuleId, type DesignSystemSettings, type DesignSystemSeverity, type ManifestComponent, type ManifestFont, type ManifestToken, SETTINGS_KEY, type TokenCategory, type TokenReferenceStyle, createDesignSystemPlugin, normalizeColor };
+//# sourceMappingURL=runtime.d.cts.map

package/dist/runtime.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime.d.cts","names":["TailwindRuleModule","TamaguiRuleModule"],"sources":["../src/runtime/ast.ts","../src/runtime/settings.ts","../src/runtime/values.ts","../src/runtime.ts"],"mappings":";;;;UAuBiB;EACf;EACA,SAAS;EACT;GACC;;UAGc;EACf;EACA;;UAGe;EACf,cAAc,MAAM,MAAM,iBAAiB;EAC3C,mBAAmB,yBAAyB,iBAAiB;;KAGnD,eAAe,OAAO,UAAU,MAAM;UAEjC;EACf;EACA,OAAO;EACP,KAAK;;UAGU;EACf,MAAM;EACN;EACA,OAAO;EACP,MAAM;EACN,UAAU;;UAGF;EACR;IAAQ,MAAM;;;UAGC;EACf,KAAK,YAAY;EACjB,OAAO;;UAGQ;EACf,UAAU,OAAO;EACjB,YAAY,MAAM,SAAS;;UAGZ;EACf,SAAS,YAAY;EACrB,WAAW;EACX,YAAY;;KAGF,WAAW,gBAAgB,MAAM;UAE5B;EACf;IACE;IACA;MAAQ;;IACR,UAAU;IACV;IACA;IACA;;EAEF,SAAS,SAAS,gBAAgB;;;;;cCjEvB;;;;;;;iBC6hBG,eAAe;;;KChenB,gBAAgB,aAAaA,sBAAqBC;UAE7C;EACf;EACA;EACA,SAAS,eAAe;EACxB,UAAU;EACV,OAAO,eAAe;;UAGP;EACf;IAAQ;IAAc;;EACtB,OAAO,QAAQ,OAAO,oBAAoB;EAC1C;IAAW,cAAc;;;UAGV;EACf,QAAQ;EACR,OAAO,QAAQ,OAAO,oBAAoB;EAC1C,iBAAiB,QAAQ,OAAO,oBAAoB;EACpD,SAAS;;EAET,SAAS,UAAU,wBAAwB;;;;;;iBA0G7B,yBACd,UAAU,uBACT"}

package/dist/runtime.d.mts

@@ -0,0 +1,110 @@
+import { a as DesignSystemRuleId, d as ManifestToken, f as TokenCategory, i as DesignSystemOptions, l as ManifestComponent, n as CoreRuleId, o as DesignSystemSettings, p as TokenReferenceStyle, r as DesignSystemManifest, s as DesignSystemSeverity, t as ComponentRole, u as ManifestFont } from "./types-BskEdv2u.mjs";
+import { GuardrailRuleModule } from "@razorwind/tailwindcss/eslint-runtime";
+import { GuardrailRuleModule as GuardrailRuleModule$1 } from "@razorwind/tamagui/eslint-runtime";
+//#region src/runtime/ast.d.ts
+interface Node {
+  type: string;
+  parent?: Node;
+  range?: [number, number];
+  [key: string]: unknown;
+}
+interface Fix {
+  range: [number, number];
+  text: string;
+}
+interface Fixer {
+  replaceText: (node: Node, text: string) => Fix;
+  replaceTextRange: (range: [number, number], text: string) => Fix;
+}
+type FixFunction = (fixer: Fixer) => Fix | Fix[] | null;
+interface SuggestionDescriptor {
+  messageId: string;
+  data?: Record<string, string>;
+  fix: FixFunction;
+}
+interface ReportDescriptor {
+  node: Node;
+  messageId: string;
+  data?: Record<string, string>;
+  fix?: FixFunction;
+  suggest?: SuggestionDescriptor[];
+}
+interface Variable {
+  defs: {
+    node: Node;
+  }[];
+}
+interface Scope {
+  set: Map<string, Variable>;
+  upper: Scope | null;
+}
+interface SourceCode {
+  getText: (node?: Node) => string;
+  getScope?: (node: Node) => Scope;
+}
+interface RuleContext {
+  report: (descriptor: ReportDescriptor) => void;
+  settings?: Record<string, unknown>;
+  sourceCode: SourceCode;
+}
+type Visitors = Record<string, (node: Node) => void>;
+interface RuleModule {
+  meta: {
+    type: "problem" | "suggestion";
+    docs: {
+      description: string;
+    };
+    messages: Record<string, string>;
+    schema: [];
+    fixable?: "code";
+    hasSuggestions?: boolean;
+  };
+  create: (context: RuleContext) => Visitors;
+}
+//#endregion
+//#region src/runtime/settings.d.ts
+/** Settings key the core rules read their sources from. */
+declare const SETTINGS_KEY = "razorwind-design-system";
+//#endregion
+//#region src/runtime/values.d.ts
+/**
+ * Normalize a CSS color to `#rrggbbaa` (hex, `rgb()`, `hsl()`, named colors);
+ * other color spaces are compared as lowercased, whitespace-collapsed text.
+ */
+declare function normalizeColor(input: string): string | undefined;
+//#endregion
+//#region src/runtime.d.ts
+type AnyRuleModule = RuleModule | GuardrailRuleModule | GuardrailRuleModule$1;
+interface DesignSystemConfig {
+  files: string[];
+  ignores: string[];
+  plugins: Record<string, DesignSystemEslintPlugin>;
+  settings: Record<string, unknown>;
+  rules: Record<string, DesignSystemSeverity>;
+}
+interface DesignSystemEslintPlugin {
+  meta: {
+    name: string;
+    version: string;
+  };
+  rules: Partial<Record<DesignSystemRuleId, AnyRuleModule>>;
+  configs: {
+    recommended?: DesignSystemConfig;
+  };
+}
+interface DesignSystemPlugin {
+  plugin: DesignSystemEslintPlugin;
+  rules: Partial<Record<DesignSystemRuleId, AnyRuleModule>>;
+  defaultSeverity: Partial<Record<DesignSystemRuleId, DesignSystemSeverity>>;
+  configs: DesignSystemEslintPlugin["configs"];
+  /** Build a flat-config block to spread into `eslint.config.*`. */
+  config: (options?: DesignSystemOptions) => DesignSystemConfig;
+}
+/**
+ * Build the design-system rules, default severities and flat-config factory
+ * for a schema-derived manifest.
+ */
+declare function createDesignSystemPlugin(manifest: DesignSystemManifest): DesignSystemPlugin;
+//#endregion
+export { AnyRuleModule, type ComponentRole, type CoreRuleId, DesignSystemConfig, DesignSystemEslintPlugin, type DesignSystemManifest, type DesignSystemOptions, DesignSystemPlugin, type DesignSystemRuleId, type DesignSystemSettings, type DesignSystemSeverity, type ManifestComponent, type ManifestFont, type ManifestToken, SETTINGS_KEY, type TokenCategory, type TokenReferenceStyle, createDesignSystemPlugin, normalizeColor };
+//# sourceMappingURL=runtime.d.mts.map

package/dist/runtime.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime.d.mts","names":["TailwindRuleModule","TamaguiRuleModule"],"sources":["../src/runtime/ast.ts","../src/runtime/settings.ts","../src/runtime/values.ts","../src/runtime.ts"],"mappings":""}

package/dist/runtime.mjs

@@ -0,0 +1 @@
+import{n as e,r as t,t as n}from"./runtime-gmz9xNDY.mjs";export{t as SETTINGS_KEY,n as createDesignSystemPlugin,e as normalizeColor};

package/dist/types-BskEdv2u.d.mts

@@ -0,0 +1,207 @@
+import { GuardrailRuleId as TailwindGuardrailRuleId, GuardrailSettings as TailwindGuardrailSettings, GuardrailTheme as TailwindGuardrailTheme } from "@razorwind/tailwindcss/eslint-runtime";
+import { GuardrailRuleId as TamaguiGuardrailRuleId, GuardrailSettings as TamaguiGuardrailSettings, GuardrailTheme as TamaguiGuardrailTheme } from "@razorwind/tamagui/eslint-runtime";
+import { TokenType } from "@power-plant/dtcg-schema";
+//#region src/types.d.ts
+/**
+ * Options for the Razorwind ESLint design-system plugin generator.
+ */
+interface EslintPluginOptions {
+  /**
+   * Output path of the generated ESLint plugin module, written relative to
+   * the execution cwd.
+   *
+   * @defaultValue "eslint/design-system/index.mjs"
+   */
+  eslintPath?: string;
+  /**
+   * Rule namespace used in `eslint.config.*`
+   * (`<prefix>/ensure-design-token-usage`).
+   *
+   * @defaultValue "design-system"
+   */
+  prefix?: string;
+  /**
+   * Module the generated file imports `createDesignSystemPlugin` from.
+   *
+   * @defaultValue "\@razorwind/eslint/runtime"
+   */
+  runtimeImport?: string;
+  /**
+   * Prefix of the CSS custom properties generated for the design tokens
+   * (`--<prefix>-color-primary`). Set to `false` when tokens are emitted
+   * without a prefix.
+   *
+   * @defaultValue initials derived from the schema name, matching `\@razorwind/css`
+   */
+  cssVarPrefix?: string | false;
+  /**
+   * Include the `\@razorwind/tailwindcss` class guardrails, exposed as
+   * `<prefix>/tailwind-*` rules.
+   *
+   * @defaultValue true
+   */
+  tailwind?: boolean;
+  /**
+   * Include the `\@razorwind/tamagui` v3 flat-value guardrails, exposed as
+   * `<prefix>/tamagui-*` rules. Pass an object to forward the app's Tamagui
+   * shorthands or restrict the token types.
+   *
+   * @defaultValue false
+   */
+  tamagui?: boolean | {
+    shorthands?: Record<string, string>;
+    includeTypes?: TokenType[];
+  };
+  /**
+   * Override body for generated `INSTALL.md`. When omitted, ESLint flat-config
+   * wiring steps are generated for the output file.
+   */
+  installGuide?: string;
+}
+/**
+ * Design-token categories a style property resolves against. Derived from
+ * the DTCG `$type` and the token path.
+ */
+type TokenCategory = "color" | "shadow" | "space" | "size" | "radius" | "borderWidth" | "fontFamily" | "fontSize" | "fontWeight" | "lineHeight" | "letterSpacing" | "typography" | "duration" | "easing" | "zIndex" | "opacity";
+/**
+ * The part a schema component plays, used to point raw HTML and hand-rolled
+ * patterns at the design-system replacement.
+ */
+type ComponentRole = "button" | "icon-button" | "link" | "checkbox" | "code" | "heading" | "image" | "radio" | "range" | "select" | "text-input" | "textarea" | "text" | "visually-hidden" | "icon" | "primitive";
+/** A design token as the lint rules see it. */
+interface ManifestToken {
+  /** Dot-separated token path (`color.primary`). */
+  path: string;
+  /** DTCG `$type`, when known. */
+  type?: string;
+  /** Category style properties resolve this token against. */
+  category?: TokenCategory;
+  /** Generated CSS custom property (`--acme-color-primary`). */
+  cssVar: string;
+  /** Resolved CSS value in the primary theme, used to suggest replacements. */
+  value?: string;
+  /** True when the token aliases another token (a semantic token). */
+  alias?: boolean;
+  /** DTCG `$deprecated`: `true` or the deprecation note. */
+  deprecated?: true | string;
+  /** Replacement token path, read from a `{path}` reference in `$deprecated`. */
+  replacement?: string;
+}
+/** A schema component as the lint rules see it. */
+interface ManifestComponent {
+  /** Schema component name (`icon-button`). */
+  name: string;
+  /** JSX names the component is rendered as (`IconButton`). */
+  jsx: string[];
+  /** Roles inferred from the component name and title. */
+  roles: ComponentRole[];
+  /** True when the component is tagged `deprecated`. */
+  deprecated?: boolean;
+  /** JSX names of the related components suggested as replacements. */
+  replacements?: string[];
+}
+/** A schema font family. */
+interface ManifestFont {
+  /** CSS `font-family` name. */
+  family: string;
+  /** Font role (`sans`, `mono`, …). */
+  role?: string;
+}
+/**
+ * Schema-derived design-system manifest serialized into the generated ESLint
+ * module.
+ */
+interface DesignSystemManifest {
+  /** Plugin `meta.name`. */
+  name: string;
+  /** Plugin `meta.version`. */
+  version: string;
+  /** Rule namespace used in flat config. */
+  prefix: string;
+  /** CSS custom-property prefix, when tokens are emitted with one. */
+  cssVarPrefix?: string;
+  /** Theme ids present in the schema (`light`, `dark`). */
+  themes: string[];
+  tokens: ManifestToken[];
+  components: ManifestComponent[];
+  /** JSX names of the schema icons (`ArrowRightIcon`). */
+  icons: string[];
+  fonts: ManifestFont[];
+  /** `\@razorwind/tailwindcss` guardrail theme, when enabled. */
+  tailwind?: TailwindGuardrailTheme;
+  /** `\@razorwind/tamagui` guardrail theme, when enabled. */
+  tamagui?: TamaguiGuardrailTheme;
+}
+/** Raw HTML elements with a design-system replacement rule. */
+type HtmlElementRuleId = "no-html-anchor" | "no-html-button" | "no-html-checkbox" | "no-html-code" | "no-html-heading" | "no-html-image" | "no-html-radio" | "no-html-range" | "no-html-select" | "no-html-text-input" | "no-html-textarea";
+/** Rule ids ported from `\@atlaskit/eslint-plugin-design-system`. */
+type CoreRuleId = "ensure-design-token-usage" | "no-unsafe-design-token-usage" | "no-deprecated-design-token-usage" | "use-tokens-space" | "use-tokens-shape" | "use-tokens-typography" | "use-tokens-motion" | "expand-motion-shorthand" | "no-margin" | "no-physical-properties" | "no-nested-styles" | "no-exported-css" | "no-exported-keyframes" | "no-empty-styled-expression" | "no-css-tagged-template-expression" | "no-styled-tagged-template-expression" | "no-keyframes-tagged-template-expression" | "no-banned-imports" | "no-deprecated-imports" | "no-unsafe-style-overrides" | "prefer-primitives" | "use-primitives-text" | "use-visually-hidden" | "icon-label" | "no-empty-icon-button-label" | "no-placeholder" | "no-readonly-or-disabled-inputs" | HtmlElementRuleId;
+type TailwindRuleId = `tailwind-${TailwindGuardrailRuleId}`;
+type TamaguiRuleId = `tamagui-${TamaguiGuardrailRuleId}`;
+/** Every rule id the generated plugin can expose. */
+type DesignSystemRuleId = CoreRuleId | TailwindRuleId | TamaguiRuleId;
+type DesignSystemSeverity = "error" | "warn" | "off";
+/** How suggestions reference a token. */
+type TokenReferenceStyle = "css-var" | "function";
+/** Shared ESLint `settings["razorwind-design-system"]` read by the core rules. */
+interface DesignSystemSettings {
+  /**
+   * Functions that resolve a token path (`token("color.primary")`).
+   *
+   * @defaultValue ["token"]
+   */
+  tokenFunctions?: string[];
+  /**
+   * How suggested fixes reference a token: `var(--acme-color-primary)` or
+   * `token("color.primary")` (the first of {@link tokenFunctions}).
+   *
+   * @defaultValue "css-var"
+   */
+  tokenReference?: TokenReferenceStyle;
+  /**
+   * CSS-in-JS calls whose object or template arguments are styles.
+   * `styled.*` factories and `StyleSheet.create` are always read.
+   *
+   * @defaultValue ["css", "cssMap", "xcss", "keyframes", "injectGlobal", "createGlobalStyle"]
+   */
+  styleCallees?: string[];
+  /**
+   * JSX attributes holding style objects.
+   *
+   * @defaultValue ["style", "css", "xcss", "sx"]
+   */
+  styleAttributes?: string[];
+  /**
+   * Props on design-system components reported by `no-unsafe-style-overrides`.
+   *
+   * @defaultValue ["style", "css", "xcss", "sx", "UNSAFE_style", "UNSAFE_className"]
+   */
+  unsafeStyleProps?: string[];
+  /**
+   * Module specifiers (or prefixes ending in `/`) the design-system
+   * components are imported from. When set, component rules only apply to
+   * JSX names imported from these modules.
+   */
+  componentModules?: string[];
+  /**
+   * Modules reported by `no-banned-imports`, mapped to the reason (or the
+   * replacement to use instead).
+   */
+  bannedImports?: Record<string, string>;
+}
+/** Options for the generated flat-config factory. */
+interface DesignSystemOptions extends DesignSystemSettings {
+  /** Glob(s) the rules apply to. */
+  files?: string[];
+  /** Glob(s) exempt from every rule. */
+  ignores?: string[];
+  /** Per-rule overrides of the schema-derived default severities. */
+  severity?: Partial<Record<DesignSystemRuleId, DesignSystemSeverity>>;
+  /** Class sources read by the `tailwind-*` rules. */
+  tailwind?: TailwindGuardrailSettings;
+  /** Style sources read by the `tamagui-*` rules. */
+  tamagui?: TamaguiGuardrailSettings;
+}
+//#endregion
+export { DesignSystemRuleId as a, EslintPluginOptions as c, ManifestToken as d, TokenCategory as f, DesignSystemOptions as i, ManifestComponent as l, CoreRuleId as n, DesignSystemSettings as o, TokenReferenceStyle as p, DesignSystemManifest as r, DesignSystemSeverity as s, ComponentRole as t, ManifestFont as u };
+//# sourceMappingURL=types-BskEdv2u.d.mts.map

package/dist/types-BskEdv2u.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types-BskEdv2u.d.mts","names":[],"sources":["../src/types.ts"],"mappings":""}

package/dist/types-cqb0r3sP.d.cts

@@ -0,0 +1,207 @@
+import { TokenType } from "@power-plant/dtcg-schema";
+import { GuardrailRuleId as TailwindGuardrailRuleId, GuardrailSettings as TailwindGuardrailSettings, GuardrailTheme as TailwindGuardrailTheme } from "@razorwind/tailwindcss/eslint-runtime";
+import { GuardrailRuleId as TamaguiGuardrailRuleId, GuardrailSettings as TamaguiGuardrailSettings, GuardrailTheme as TamaguiGuardrailTheme } from "@razorwind/tamagui/eslint-runtime";
+//#region src/types.d.ts
+/**
+ * Options for the Razorwind ESLint design-system plugin generator.
+ */
+interface EslintPluginOptions {
+  /**
+   * Output path of the generated ESLint plugin module, written relative to
+   * the execution cwd.
+   *
+   * @defaultValue "eslint/design-system/index.mjs"
+   */
+  eslintPath?: string;
+  /**
+   * Rule namespace used in `eslint.config.*`
+   * (`<prefix>/ensure-design-token-usage`).
+   *
+   * @defaultValue "design-system"
+   */
+  prefix?: string;
+  /**
+   * Module the generated file imports `createDesignSystemPlugin` from.
+   *
+   * @defaultValue "\@razorwind/eslint/runtime"
+   */
+  runtimeImport?: string;
+  /**
+   * Prefix of the CSS custom properties generated for the design tokens
+   * (`--<prefix>-color-primary`). Set to `false` when tokens are emitted
+   * without a prefix.
+   *
+   * @defaultValue initials derived from the schema name, matching `\@razorwind/css`
+   */
+  cssVarPrefix?: string | false;
+  /**
+   * Include the `\@razorwind/tailwindcss` class guardrails, exposed as
+   * `<prefix>/tailwind-*` rules.
+   *
+   * @defaultValue true
+   */
+  tailwind?: boolean;
+  /**
+   * Include the `\@razorwind/tamagui` v3 flat-value guardrails, exposed as
+   * `<prefix>/tamagui-*` rules. Pass an object to forward the app's Tamagui
+   * shorthands or restrict the token types.
+   *
+   * @defaultValue false
+   */
+  tamagui?: boolean | {
+    shorthands?: Record<string, string>;
+    includeTypes?: TokenType[];
+  };
+  /**
+   * Override body for generated `INSTALL.md`. When omitted, ESLint flat-config
+   * wiring steps are generated for the output file.
+   */
+  installGuide?: string;
+}
+/**
+ * Design-token categories a style property resolves against. Derived from
+ * the DTCG `$type` and the token path.
+ */
+type TokenCategory = "color" | "shadow" | "space" | "size" | "radius" | "borderWidth" | "fontFamily" | "fontSize" | "fontWeight" | "lineHeight" | "letterSpacing" | "typography" | "duration" | "easing" | "zIndex" | "opacity";
+/**
+ * The part a schema component plays, used to point raw HTML and hand-rolled
+ * patterns at the design-system replacement.
+ */
+type ComponentRole = "button" | "icon-button" | "link" | "checkbox" | "code" | "heading" | "image" | "radio" | "range" | "select" | "text-input" | "textarea" | "text" | "visually-hidden" | "icon" | "primitive";
+/** A design token as the lint rules see it. */
+interface ManifestToken {
+  /** Dot-separated token path (`color.primary`). */
+  path: string;
+  /** DTCG `$type`, when known. */
+  type?: string;
+  /** Category style properties resolve this token against. */
+  category?: TokenCategory;
+  /** Generated CSS custom property (`--acme-color-primary`). */
+  cssVar: string;
+  /** Resolved CSS value in the primary theme, used to suggest replacements. */
+  value?: string;
+  /** True when the token aliases another token (a semantic token). */
+  alias?: boolean;
+  /** DTCG `$deprecated`: `true` or the deprecation note. */
+  deprecated?: true | string;
+  /** Replacement token path, read from a `{path}` reference in `$deprecated`. */
+  replacement?: string;
+}
+/** A schema component as the lint rules see it. */
+interface ManifestComponent {
+  /** Schema component name (`icon-button`). */
+  name: string;
+  /** JSX names the component is rendered as (`IconButton`). */
+  jsx: string[];
+  /** Roles inferred from the component name and title. */
+  roles: ComponentRole[];
+  /** True when the component is tagged `deprecated`. */
+  deprecated?: boolean;
+  /** JSX names of the related components suggested as replacements. */
+  replacements?: string[];
+}
+/** A schema font family. */
+interface ManifestFont {
+  /** CSS `font-family` name. */
+  family: string;
+  /** Font role (`sans`, `mono`, …). */
+  role?: string;
+}
+/**
+ * Schema-derived design-system manifest serialized into the generated ESLint
+ * module.
+ */
+interface DesignSystemManifest {
+  /** Plugin `meta.name`. */
+  name: string;
+  /** Plugin `meta.version`. */
+  version: string;
+  /** Rule namespace used in flat config. */
+  prefix: string;
+  /** CSS custom-property prefix, when tokens are emitted with one. */
+  cssVarPrefix?: string;
+  /** Theme ids present in the schema (`light`, `dark`). */
+  themes: string[];
+  tokens: ManifestToken[];
+  components: ManifestComponent[];
+  /** JSX names of the schema icons (`ArrowRightIcon`). */
+  icons: string[];
+  fonts: ManifestFont[];
+  /** `\@razorwind/tailwindcss` guardrail theme, when enabled. */
+  tailwind?: TailwindGuardrailTheme;
+  /** `\@razorwind/tamagui` guardrail theme, when enabled. */
+  tamagui?: TamaguiGuardrailTheme;
+}
+/** Raw HTML elements with a design-system replacement rule. */
+type HtmlElementRuleId = "no-html-anchor" | "no-html-button" | "no-html-checkbox" | "no-html-code" | "no-html-heading" | "no-html-image" | "no-html-radio" | "no-html-range" | "no-html-select" | "no-html-text-input" | "no-html-textarea";
+/** Rule ids ported from `\@atlaskit/eslint-plugin-design-system`. */
+type CoreRuleId = "ensure-design-token-usage" | "no-unsafe-design-token-usage" | "no-deprecated-design-token-usage" | "use-tokens-space" | "use-tokens-shape" | "use-tokens-typography" | "use-tokens-motion" | "expand-motion-shorthand" | "no-margin" | "no-physical-properties" | "no-nested-styles" | "no-exported-css" | "no-exported-keyframes" | "no-empty-styled-expression" | "no-css-tagged-template-expression" | "no-styled-tagged-template-expression" | "no-keyframes-tagged-template-expression" | "no-banned-imports" | "no-deprecated-imports" | "no-unsafe-style-overrides" | "prefer-primitives" | "use-primitives-text" | "use-visually-hidden" | "icon-label" | "no-empty-icon-button-label" | "no-placeholder" | "no-readonly-or-disabled-inputs" | HtmlElementRuleId;
+type TailwindRuleId = `tailwind-${TailwindGuardrailRuleId}`;
+type TamaguiRuleId = `tamagui-${TamaguiGuardrailRuleId}`;
+/** Every rule id the generated plugin can expose. */
+type DesignSystemRuleId = CoreRuleId | TailwindRuleId | TamaguiRuleId;
+type DesignSystemSeverity = "error" | "warn" | "off";
+/** How suggestions reference a token. */
+type TokenReferenceStyle = "css-var" | "function";
+/** Shared ESLint `settings["razorwind-design-system"]` read by the core rules. */
+interface DesignSystemSettings {
+  /**
+   * Functions that resolve a token path (`token("color.primary")`).
+   *
+   * @defaultValue ["token"]
+   */
+  tokenFunctions?: string[];
+  /**
+   * How suggested fixes reference a token: `var(--acme-color-primary)` or
+   * `token("color.primary")` (the first of {@link tokenFunctions}).
+   *
+   * @defaultValue "css-var"
+   */
+  tokenReference?: TokenReferenceStyle;
+  /**
+   * CSS-in-JS calls whose object or template arguments are styles.
+   * `styled.*` factories and `StyleSheet.create` are always read.
+   *
+   * @defaultValue ["css", "cssMap", "xcss", "keyframes", "injectGlobal", "createGlobalStyle"]
+   */
+  styleCallees?: string[];
+  /**
+   * JSX attributes holding style objects.
+   *
+   * @defaultValue ["style", "css", "xcss", "sx"]
+   */
+  styleAttributes?: string[];
+  /**
+   * Props on design-system components reported by `no-unsafe-style-overrides`.
+   *
+   * @defaultValue ["style", "css", "xcss", "sx", "UNSAFE_style", "UNSAFE_className"]
+   */
+  unsafeStyleProps?: string[];
+  /**
+   * Module specifiers (or prefixes ending in `/`) the design-system
+   * components are imported from. When set, component rules only apply to
+   * JSX names imported from these modules.
+   */
+  componentModules?: string[];
+  /**
+   * Modules reported by `no-banned-imports`, mapped to the reason (or the
+   * replacement to use instead).
+   */
+  bannedImports?: Record<string, string>;
+}
+/** Options for the generated flat-config factory. */
+interface DesignSystemOptions extends DesignSystemSettings {
+  /** Glob(s) the rules apply to. */
+  files?: string[];
+  /** Glob(s) exempt from every rule. */
+  ignores?: string[];
+  /** Per-rule overrides of the schema-derived default severities. */
+  severity?: Partial<Record<DesignSystemRuleId, DesignSystemSeverity>>;
+  /** Class sources read by the `tailwind-*` rules. */
+  tailwind?: TailwindGuardrailSettings;
+  /** Style sources read by the `tamagui-*` rules. */
+  tamagui?: TamaguiGuardrailSettings;
+}
+//#endregion
+export { DesignSystemRuleId as a, EslintPluginOptions as c, ManifestToken as d, TokenCategory as f, DesignSystemOptions as i, ManifestComponent as l, CoreRuleId as n, DesignSystemSettings as o, TokenReferenceStyle as p, DesignSystemManifest as r, DesignSystemSeverity as s, ComponentRole as t, ManifestFont as u };
+//# sourceMappingURL=types-cqb0r3sP.d.cts.map

package/dist/types-cqb0r3sP.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types-cqb0r3sP.d.cts","names":[],"sources":["../src/types.ts"],"mappings":";;;;;;;UA0CiB;;;;;;;EAOf;;;;;;;EAQA;;;;;;EAOA;;;;;;;;EASA;;;;;;;EAQA;;;;;;;;EASA;IAGM,aAAa;IACb,eAAe;;;;;;EAOrB;;;;;;KAOU;;;;;KAsBA;;UAmBK;;EAEf;;EAEA;;EAEA,WAAW;;EAEX;;EAEA;;EAEA;;EAEA;;EAEA;;;UAIe;;EAEf;;EAEA;;EAEA,OAAO;;EAEP;;EAEA;;;UAIe;;EAEf;;EAEA;;;;;;UAOe;;EAEf;;EAEA;;EAEA;;EAEA;;EAEA;EACA,QAAQ;EACR,YAAY;;EAEZ;EACA,OAAO;;EAEP,WAAW;;EAEX,UAAU;;;KAIA;;KAcA,quBA4BR;KAEQ,6BAA6B;KAC7B,2BAA2B;;KAG3B,qBAAqB,aAAa,iBAAiB;KAEnD;;KAGA;;UAGK;;;;;;EAMf;;;;;;;EAOA,iBAAiB;;;;;;;EAOjB;;;;;;EAMA;;;;;;EAMA;;;;;;EAMA;;;;;EAKA,gBAAgB;;;UAID,4BAA4B;;EAE3C;;EAEA;;EAEA,WAAW,QAAQ,OAAO,oBAAoB;;EAE9C,WAAW;;EAEX,UAAU"}