@automators/design-tokens

Framework-independent Automators foundation and semantic theme tokens generated from the repository's canonical tokens/source.json.

Published under the MIT license. Product builds should still vendor and commit the generated artifacts so registry availability cannot block a release.

import {
  themes,
  themeMap,
  themeAliases,
  tokens,
  tokenMap,
} from "@automators/design-tokens";
import "@automators/design-tokens/css";

The CSS export defines Automators Light on :root and [data-ds-theme="light"], and Automators Dark on .dark and [data-ds-theme="dark"]. Consume semantic roles such as --ds-theme-surface, --ds-theme-text-primary, and --ds-theme-action-primary in product adapters. Do not couple components to a theme's literal values.

themeAliases normalizes existing stored preferences during migration. It maps gray and tosca to Light, and graydark, highcontrast, and matrix to Dark. Do not use the aliases to keep legacy choices in user-facing controls.

Light guarantees AA contrast for declared normal-text pairs. Dark guarantees AAA contrast for declared normal-text pairs. This package guarantee does not replace whole-product accessibility testing.

Do not edit dist/ manually. Run pnpm build at the repository root.