Skip to content

An open source design system that's fully customizable and agent ready

TypeScript

docs: rename product name XDS -> Astryx in source comments + descriptions (#3038)

EJ Hammond544d2dd4db3a
diff --git a/packages/build/src/babel.js b/packages/build/src/babel.js
index b9d29cbbe6..587c86f59e 100644
--- a/packages/build/src/babel.js
+++ b/packages/build/src/babel.js
@@ -6,7 +6,7 @@
* @astryxdesign/build/babel
*
* Babel plugin that delegates to @stylexjs/babel-plugin with a
- * different classNamePrefix for XDS library files vs product files.
+ * different classNamePrefix for Astryx library files vs product files.
*
* Library files get 'astryx' prefix (.astryx78zum5), product files get 'x' (.x78zum5).
*/
diff --git a/packages/build/src/config.js b/packages/build/src/config.js
index 1353c404e4..16ab250849 100644
--- a/packages/build/src/config.js
+++ b/packages/build/src/config.js
@@ -5,7 +5,7 @@
/**
* @astryxdesign/build
*
- * Unified build configuration for XDS source builds.
+ * Unified build configuration for Astryx source builds.
*
* Usage:
* // babel.config.js
@@ -20,7 +20,7 @@
const path = require('node:path');
/**
- * Resolve XDS package aliases from a root directory.
+ * Resolve Astryx package aliases from a root directory.
* Handles both npm installs (node_modules/@astryxdesign/core) and
* monorepo layouts (packages/core).
*/
@@ -50,7 +50,7 @@ function stylexOptions(rootDir, overrides = {}) {
}
/**
- * Generate a complete babel.config.js for XDS source builds.
+ * Generate a complete babel.config.js for Astryx source builds.
*
* @param {string} rootDir — __dirname of the project root
* @param {object} [overrides] — extra StyleX options to merge
@@ -66,7 +66,7 @@ function babel(rootDir, overrides = {}) {
}
/**
- * Generate a complete postcss.config.js for XDS source builds.
+ * Generate a complete postcss.config.js for Astryx source builds.
*
* @param {string} rootDir — __dirname of the project root
* @param {object} [overrides] — extra options (appDir, extraInclude, etc.)
diff --git a/packages/build/src/index.js b/packages/build/src/index.js
index b81629c9c7..a34605356b 100644
--- a/packages/build/src/index.js
+++ b/packages/build/src/index.js
@@ -5,8 +5,8 @@
/**
* @astryxdesign/postcss-plugin
*
- * PostCSS plugin for XDS source builds. Compiles StyleX from both
- * XDS library source and product code in two separate passes with
+ * PostCSS plugin for Astryx source builds. Compiles StyleX from both
+ * Astryx library source and product code in two separate passes with
* different class name prefixes, then outputs them in separate layers:
*
* reset < astryx-base (library, prefix: 'astryx') < astryx-theme < product (prefix: 'x')
diff --git a/packages/build/src/next.js b/packages/build/src/next.js
index b8862dd512..2d9a9b5fc8 100644
--- a/packages/build/src/next.js
+++ b/packages/build/src/next.js
@@ -5,7 +5,7 @@
/**
* @astryxdesign/build/next
*
- * Next.js configuration helper for XDS source builds.
+ * Next.js configuration helper for Astryx source builds.
*
* Usage in next.config.mjs:
* import {withXDS} from '@astryxdesign/build/next';
@@ -15,7 +15,7 @@
*/
/**
- * Wraps a Next.js config to enable XDS source builds.
+ * Wraps a Next.js config to enable Astryx source builds.
* - Adds transpilePackages for @astryxdesign/* packages
* - Sets conditionNames to resolve source exports
*/
diff --git a/packages/build/src/vite.ts b/packages/build/src/vite.ts
index 26046d04d3..edc6c5a9b9 100644
--- a/packages/build/src/vite.ts
+++ b/packages/build/src/vite.ts
@@ -29,7 +29,7 @@ export const LIGHTNINGCSS_TARGETS = {
export interface XDSVitePluginLegacyOptions {
stylexOptions: Parameters<typeof stylex.vite>[0];
libraryPattern?: string;
- /** StyleX atomic class-name prefix for XDS library styles. @default 'astryx' */
+ /** StyleX atomic class-name prefix for Astryx library styles. @default 'astryx' */
stylexPrefix?: string;
layers?: {
library?: string;
@@ -51,7 +51,7 @@ export interface XDSVitePluginOptions {
rootDir?: string;
/**
- * Pattern to identify XDS library files vs product files.
+ * Pattern to identify Astryx library files vs product files.
* @default 'node_modules/@astryxdesign/'
*/
libraryPattern?: string;
@@ -60,7 +60,7 @@ export interface XDSVitePluginOptions {
* CSS layer names for the split output.
*/
layers?: {
- /** Layer name for XDS library styles @default 'astryx-base' */
+ /** Layer name for Astryx library styles @default 'astryx-base' */
library?: string;
/** Layer name for product styles @default 'product' */
product?: string;
@@ -75,11 +75,11 @@ export interface XDSVitePluginOptions {
lightningcssTargets?: Record<string, number>;
/**
- * StyleX atomic class-name prefix for XDS *library* styles. The product
+ * StyleX atomic class-name prefix for Astryx *library* styles. The product
* build uses a distinct prefix so library and product atoms never collide
* across layers.
*
- * Configurable to support the XDS-prefix migration (P2380608025): a consumer
+ * Configurable to support the Astryx-prefix migration (P2380608025): a consumer
* can rebrand the library atom prefix to `astryx` before the final cutover.
* Defaults to `xds` so existing consumers are unaffected.
*
@@ -94,9 +94,9 @@ export interface XDSVitePluginOptions {
}
/**
- * XDS Vite plugin for source builds.
+ * Astryx Vite plugin for source builds.
*
- * Provides sensible defaults for StyleX compilation with XDS.
+ * Provides sensible defaults for StyleX compilation with Astryx.
* Just spread into your plugins array:
*
* plugins: [...xdsStylex(), react()]
@@ -105,7 +105,7 @@ export interface XDSVitePluginOptions {
* - StyleX compilation with correct settings
* - CSS layer ordering (reset < astryx-base < astryx-theme < product)
* - resolve.alias for @astryxdesign/core source
- * - optimizeDeps.exclude to prevent Vite pre-bundling XDS
+ * - optimizeDeps.exclude to prevent Vite pre-bundling Astryx
*
* @param options — optional overrides
*/
@@ -186,7 +186,7 @@ export function xdsStylex(
name: 'xds-config',
config(): UserConfig {
// Discover all @astryxdesign/* packages to exclude from pre-bundling.
- // XDS ships as source that must be compiled by StyleX — pre-bundling
+ // Astryx ships as source that must be compiled by StyleX — pre-bundling
// strips stylex.create/defineVars calls and causes runtime errors.
let xdsPackages: string[] = ['@astryxdesign/core'];
try {
diff --git a/packages/cli/src/api/doctor.mjs b/packages/cli/src/api/doctor.mjs
index 933d2bd80b..9e2a6b451b 100644
--- a/packages/cli/src/api/doctor.mjs
+++ b/packages/cli/src/api/doctor.mjs
@@ -328,7 +328,7 @@ export async function checkConfig(ctx) {
}
/**
- * Check 6 — agent docs exist and contain the XDS section markers.
+ * Check 6 — agent docs exist and contain the Astryx section markers.
* @param {DoctorContext} ctx
* @returns {DoctorCheck}
*/
diff --git a/packages/cli/src/api/index.mjs b/packages/cli/src/api/index.mjs
index 5af734c0fb..fcf7da5120 100644
--- a/packages/cli/src/api/index.mjs
+++ b/packages/cli/src/api/index.mjs
@@ -1,7 +1,7 @@
// Copyright (c) Meta Platforms, Inc. and affiliates.
/**
- * @file Programmatic API for the XDS CLI.
+ * @file Programmatic API for the Astryx CLI.
*
* Every function returns the same { type, data } envelope that `xds --json` outputs.
* Errors throw AstryxError (with optional .suggestions).
diff --git a/packages/cli/src/commands/agent-docs.mjs b/packages/cli/src/commands/agent-docs.mjs
index b3eab5a368..780d7ee77d 100644
--- a/packages/cli/src/commands/agent-docs.mjs
+++ b/packages/cli/src/commands/agent-docs.mjs
@@ -183,7 +183,7 @@ export function generateCompressedIndex(version, {coreDir, runPrefix = getRunPre
}
/**
- * Get XDS version from core package.
+ * Get Astryx version from core package.
*/
export function getXdsVersion(coreDir) {
if (coreDir) {
@@ -199,7 +199,7 @@ export function getXdsVersion(coreDir) {
}
/**
- * Inject or update XDS section in a file using XDS markers.
+ * Inject or update Astryx section in a file using Astryx markers.
* If the file has existing markers, replaces the content between them.
* If the file exists without markers, appends the block (unless onlyReplace is true).
* If createIfMissing is true and the file doesn't exist, creates it with a header.
@@ -209,7 +209,7 @@ export function getXdsVersion(coreDir) {
* @param {object} [options]
* @param {boolean} [options.createIfMissing] - Create the file if it doesn't exist
* @param {string} [options.header] - Header for newly created files
- * @param {boolean} [options.onlyReplace] - Only write if XDS markers already exist (skip files without markers)
+ * @param {boolean} [options.onlyReplace] - Only write if Astryx markers already exist (skip files without markers)
* @returns {boolean} Whether the file was written
*/
export function injectXdsBlock(filePath, compressedIndex, {createIfMissing = false, header = '', onlyReplace = false} = {}) {
@@ -227,7 +227,7 @@ export function injectXdsBlock(filePath, compressedIndex, {createIfMissing = fal
compressedIndex +
content.slice(endIdx + XDS_MARKER_END.length);
} else if (onlyReplace) {
- // File exists but has no XDS markers — skip it
+ // File exists but has no Astryx markers — skip it
return false;
} else {
content = content.trimEnd() + '\n\n' + compressedIndex + '\n';
@@ -243,7 +243,7 @@ export function injectXdsBlock(filePath, compressedIndex, {createIfMissing = fal
}
/**
- * Inject or update XDS section in AGENTS.md.
+ * Inject or update Astryx section in AGENTS.md.
* Always creates the file if it doesn't exist.
*/
export function injectAgentsMd(targetDir, version) {
@@ -256,7 +256,7 @@ export function injectAgentsMd(targetDir, version) {
}
/**
- * Inject or update XDS section in CLAUDE.md.
+ * Inject or update Astryx section in CLAUDE.md.
* Only injects if CLAUDE.md already exists.
*
* @returns {boolean} Whether the file was written
@@ -268,10 +268,10 @@ export function injectClaudeMd(targetDir, version) {
}
/**
- * Remove XDS section from a file.
+ * Remove Astryx section from a file.
* If the file becomes empty (only boilerplate header remains), deletes it.
*
- * @returns {boolean} Whether the XDS section was found and removed
+ * @returns {boolean} Whether the Astryx section was found and removed
*/
export function removeXdsBlock(filePath, {deleteIfEmpty = false} = {}) {
if (!fs.existsSync(filePath)) return false;
@@ -299,7 +299,7 @@ export function removeXdsBlock(filePath, {deleteIfEmpty = false} = {}) {
}
/**
- * Remove XDS section from all known agent doc files.
+ * Remove Astryx section from all known agent doc files.
*/
export function removeAgentDocs(targetDir) {
const allPaths = discoverAgentDocs(targetDir);
@@ -332,7 +332,7 @@ export function removeAgentDocs(targetDir) {
* @param {string} [options.lang]
* @param {string} [options.agent] - Tool preset: 'claude', 'cursor', 'codex', 'all'
* @param {string[]} [options.paths] - Explicit paths (overrides agent/auto-detect)
- * @param {boolean} [options.onlyReplace] - Only update files that already have XDS markers (for upgrades)
+ * @param {boolean} [options.onlyReplace] - Only update files that already have Astryx markers (for upgrades)
* @returns {string[]} List of files written
*/
export function installAgentDocs(targetDir, {zh = false, lang, agent, paths, onlyReplace = false} = {}) {
diff --git a/packages/cli/src/commands/build-theme.mjs b/packages/cli/src/commands/build-theme.mjs
index e9344d998f..fa57be78f2 100644
--- a/packages/cli/src/commands/build-theme.mjs
+++ b/packages/cli/src/commands/build-theme.mjs
@@ -162,7 +162,7 @@ async function getKnownValues(componentName) {
* component prop values found in the theme's `components` keys. Reads known
* values from doc files to filter out base prop values.
*
- * Interface naming convention: XDS + PascalCase(component) + PascalCase(prop) + Map
+ * Interface naming convention: Astryx + PascalCase(component) + PascalCase(prop) + Map
* banner + status → XDSBannerStatusMap
* button + variant → XDSButtonVariantMap
*
@@ -431,7 +431,7 @@ ${iconType}export declare const ${toIdentifier(themeDef.name)}Theme: DefinedThem
// =============================================================================
/**
- * Known XDS component names and their visual props.
+ * Known Astryx component names and their visual props.
* Used to warn on typos in defineTheme component overrides.
*/
const KNOWN_COMPONENTS = {
diff --git a/packages/cli/src/commands/discover.mjs b/packages/cli/src/commands/discover.mjs
index 2fd22365eb..96ab2be44e 100644
--- a/packages/cli/src/commands/discover.mjs
+++ b/packages/cli/src/commands/discover.mjs
@@ -1,7 +1,7 @@
// Copyright (c) Meta Platforms, Inc. and affiliates.
/**
- * @file discover command — find external XDS packages and components
+ * @file discover command — find external Astryx packages and components
*
* Usage:
* xds discover List all packages
diff --git a/packages/cli/src/commands/docs.mjs b/packages/cli/src/commands/docs.mjs
index 0634199c75..e3246c6e90 100644
--- a/packages/cli/src/commands/docs.mjs
+++ b/packages/cli/src/commands/docs.mjs
@@ -1,7 +1,7 @@
// Copyright (c) Meta Platforms, Inc. and affiliates.
/**
- * @file docs command — Print XDS reference docs
+ * @file docs command — Print Astryx reference docs
*
* Auto-discovers .doc.mjs files from the docs/ directory.
* Supports --detail (full|compact|brief) and --lang (en|zh|dense).
diff --git a/packages/cli/src/commands/gap-report.mjs b/packages/cli/src/commands/gap-report.mjs
index 53488cd6cd..65f541a325 100644
--- a/packages/cli/src/commands/gap-report.mjs
+++ b/packages/cli/src/commands/gap-report.mjs
@@ -1,7 +1,7 @@
// Copyright (c) Meta Platforms, Inc. and affiliates.
/**
- * @file gap-report command — File a gap report for missing XDS capabilities
+ * @file gap-report command — File a gap report for missing Astryx capabilities
*
* Interactive and non-interactive modes for reporting gaps in the design system.
* Creates GitHub issues with the `gap-report` label.
@@ -107,7 +107,7 @@ function writeGapReportConfig(targetDir, gapReportValue) {
fs.writeFileSync(configPath, content);
} else {
const content = `/**
- * XDS Configuration
+ * Astryx Configuration
* Generated by \`xds gap-report setup\`
*/
export default {
diff --git a/packages/cli/src/commands/upgrade.mjs b/packages/cli/src/commands/upgrade.mjs
index 8062c012d3..465350e6d5 100644
--- a/packages/cli/src/commands/upgrade.mjs
+++ b/packages/cli/src/commands/upgrade.mjs
@@ -326,8 +326,8 @@ export function registerUpgrade(program) {
const existingDocs = discoverAgentDocs(process.cwd());
if (existingDocs.length > 0) {
try {
- // onlyReplace: only update files that already have XDS markers.
- // Don't inject into files that never had XDS content.
+ // onlyReplace: only update files that already have Astryx markers.
+ // Don't inject into files that never had Astryx content.
const written = installAgentDocs(process.cwd(), {onlyReplace: true});
receipt.agentDocsRefreshed = written.length > 0;
if (!json && written.length > 0) p.log.success(`Agent docs updated: ${written.join(', ')}`);
diff --git a/packages/cli/src/index.mjs b/packages/cli/src/index.mjs
index 384496a38a..cad4a73bcb 100644
--- a/packages/cli/src/index.mjs
+++ b/packages/cli/src/index.mjs
@@ -1,7 +1,7 @@
// Copyright (c) Meta Platforms, Inc. and affiliates.
/**
- * @file XDS CLI — Commander program setup
+ * @file Astryx CLI — Commander program setup
*
* Registers all commands via lazy loading. If one command fails to load
* (bad import, syntax error), the other commands still work.
diff --git a/packages/cli/src/lib/cli-error.mjs b/packages/cli/src/lib/cli-error.mjs
index 7bd138e578..9a9737435f 100644
--- a/packages/cli/src/lib/cli-error.mjs
+++ b/packages/cli/src/lib/cli-error.mjs
@@ -1,11 +1,11 @@
// Copyright (c) Meta Platforms, Inc. and affiliates.
/**
- * @file XDS CLI — central error handling helper.
+ * @file Astryx CLI — central error handling helper.
*
* ## Exit-code policy
*
- * The XDS CLI follows one rule above all: **exit code is the contract**. CI
+ * The Astryx CLI follows one rule above all: **exit code is the contract**. CI
* scripts and AI agents read it before they read any text. Every error path
* across every command must agree on the exit code so that callers can
* detect failure without parsing stdout/stderr.
diff --git a/packages/cli/src/lib/component-discovery.mjs b/packages/cli/src/lib/component-discovery.mjs
index 1e53afe35c..a7c15327ff 100644
--- a/packages/cli/src/lib/component-discovery.mjs
+++ b/packages/cli/src/lib/component-discovery.mjs
@@ -1,7 +1,7 @@
// Copyright (c) Meta Platforms, Inc. and affiliates.
/**
- * @file Component discovery — find, list, and resolve XDS components
+ * @file Component discovery — find, list, and resolve Astryx components
*/
import * as fs from 'node:fs';
@@ -95,7 +95,7 @@ function readDocMeta(docPath) {
}
/**
- * Auto-discover components by scanning for XDS*.tsx files in core/src/.
+ * Auto-discover components by scanning for Astryx*.tsx files in core/src/.
*
* Returns an ordered Record where:
* - Grouped components use the group name as key: `'Buttons': ['Button', 'IconButton']`
@@ -131,7 +131,7 @@ export function discoverComponents(coreDir) {
const xdsFiles = collectXDSFiles(dirPath);
// Read the group from the directory's .doc.mjs file (if it exists)
- // Check both {Name}.doc.mjs and XDS{Name}.doc.mjs naming conventions
+ // Check both {Name}.doc.mjs and Astryx{Name}.doc.mjs naming conventions
let docFile = path.join(dirPath, `${entry.name}.doc.mjs`);
if (!fs.existsSync(docFile)) {
docFile = path.join(dirPath, `XDS${entry.name}.doc.mjs`);
@@ -220,13 +220,13 @@ export function findComponentReadme(coreDir, name) {
const exactDoc = `${name}.doc.mjs`;
const xdsDoc = `XDS${name}.doc.mjs`;
- // Direct match: src/{name}/{Name}.doc.mjs or src/{name}/XDS{Name}.doc.mjs
+ // Direct match: src/{name}/{Name}.doc.mjs or src/{name}/Astryx{Name}.doc.mjs
const direct = path.join(srcDir, name, exactDoc);
if (fs.existsSync(direct)) return direct;
const directXds = path.join(srcDir, name, xdsDoc);
if (fs.existsSync(directXds)) return directXds;
- // Nested match: src/*/{name}/{Name}.doc.mjs or src/*/{name}/XDS{Name}.doc.mjs
+ // Nested match: src/*/{name}/{Name}.doc.mjs or src/*/{name}/Astryx{Name}.doc.mjs
const entries = fs.readdirSync(srcDir, {withFileTypes: true});
for (const entry of entries) {
if (!entry.isDirectory()) continue;
@@ -236,7 +236,7 @@ export function findComponentReadme(coreDir, name) {
if (fs.existsSync(nestedXds)) return nestedXds;
}
- // Per-component doc in a parent directory: src/*/{Name}.doc.mjs or src/*/XDS{Name}.doc.mjs
+ // Per-component doc in a parent directory: src/*/{Name}.doc.mjs or src/*/Astryx{Name}.doc.mjs
for (const entry of entries) {
if (!entry.isDirectory()) continue;
const perComp = path.join(srcDir, entry.name, exactDoc);
@@ -263,7 +263,7 @@ export function findComponentReadme(coreDir, name) {
}
/**
- * Find the main source file for a component (XDS*.tsx, excluding tests).
+ * Find the main source file for a component (Astryx*.tsx, excluding tests).
* For "Button" finds src/Button/XDSButton.tsx
* For "Layout" finds src/Layout/XDSLayout/XDSLayout.tsx
* For "Card" finds src/Layout/Container/XDSCard.tsx (deep search fallback)
@@ -271,7 +271,7 @@ export function findComponentReadme(coreDir, name) {
export function findComponentSource(coreDir, name) {
const srcDir = path.join(coreDir, 'src');
// Try the prefixed form (`XDSButton.tsx`) first since that is the current
- // on-disk convention, then the bare form (`Button.tsx`) that the XDS-prefix
+ // on-disk convention, then the bare form (`Button.tsx`) that the Astryx-prefix
// migration (P4) renames to. Listing the prefixed name first keeps behavior
// identical until files are actually renamed.
const candidateFiles = [`XDS${name}.tsx`, `${name}.tsx`];
diff --git a/packages/cli/src/lib/component-format.mjs b/packages/cli/src/lib/component-format.mjs
index b08c7bee66..82bea05fc9 100644
--- a/packages/cli/src/lib/component-format.mjs
+++ b/packages/cli/src/lib/component-format.mjs
@@ -305,7 +305,7 @@ export function formatFull(docs, options = {}) {
*/
export function formatCompact(docs, componentName, importHint) {
// Bare name (un-prefix migration P5a): the CLI now presents component names
- // without the XDS prefix. componentName is already bare post-P4.
+ // without the Astryx prefix. componentName is already bare post-P4.
const displayName = componentName.startsWith('XDS')
? componentName.slice(3)
: componentName;
diff --git a/packages/cli/src/lib/error-codes.mjs b/packages/cli/src/lib/error-codes.mjs
index ff0d5b20c4..5d0e0eeec4 100644
--- a/packages/cli/src/lib/error-codes.mjs
+++ b/packages/cli/src/lib/error-codes.mjs
@@ -1,7 +1,7 @@
// Copyright (c) Meta Platforms, Inc. and affiliates.
/**
- * @file XDS CLI — stable machine-readable error codes.
+ * @file Astryx CLI — stable machine-readable error codes.
*
* ## Why codes exist
*
@@ -78,7 +78,7 @@
*/
/**
- * The complete, frozen set of XDS CLI error codes. Append-only.
+ * The complete, frozen set of Astryx CLI error codes. Append-only.
* @type {Readonly<Record<ErrorCode, ErrorCode>>}
*/
export const ERROR_CODES = Object.freeze({
diff --git a/packages/cli/src/lib/hook-discovery.mjs b/packages/cli/src/lib/hook-discovery.mjs
index 61cc152407..759f0925b6 100644
--- a/packages/cli/src/lib/hook-discovery.mjs
+++ b/packages/cli/src/lib/hook-discovery.mjs
@@ -1,7 +1,7 @@
// Copyright (c) Meta Platforms, Inc. and affiliates.
/**
- * @file Hook discovery — find, list, and resolve XDS hooks
+ * @file Hook discovery — find, list, and resolve Astryx hooks
*/
import * as fs from 'node:fs';
diff --git a/packages/cli/src/lib/json-shim.mjs b/packages/cli/src/lib/json-shim.mjs
index e17d003d7d..60913fd67a 100644
--- a/packages/cli/src/lib/json-shim.mjs
+++ b/packages/cli/src/lib/json-shim.mjs
@@ -113,7 +113,7 @@ function emitJsonError(message, suggestions, code) {
}
/**
- * Map a Commander parse-error code (and its message) to a stable XDS error
+ * Map a Commander parse-error code (and its message) to a stable Astryx error
* code. Commander's own codes are stable enough, but they aren't part of our
* documented contract — so we translate them into the `ERR_*` taxonomy.
*
diff --git a/packages/cli/src/lib/parse.mjs b/packages/cli/src/lib/parse.mjs
index 087bc42e5d..42c83537ce 100644
--- a/packages/cli/src/lib/parse.mjs
+++ b/packages/cli/src/lib/parse.mjs
@@ -1,7 +1,7 @@
// Copyright (c) Meta Platforms, Inc. and affiliates.
/**
- * @file Consumer utilities for parsing XDS CLI JSON output.
+ * @file Consumer utilities for parsing Astryx CLI JSON output.
*
* Exported via `@astryxdesign/cli/json`:
* import { parseResponse, isError, assertResponse } from '@astryxdesign/cli/json';
diff --git a/packages/cli/src/lib/resolve-theme.mjs b/packages/cli/src/lib/resolve-theme.mjs
index 7d24988c51..e79ad8b93b 100644
--- a/packages/cli/src/lib/resolve-theme.mjs
+++ b/packages/cli/src/lib/resolve-theme.mjs
@@ -77,7 +77,7 @@ function extractTheme(mod) {
}
/**
- * Resolve the active XDS theme from config and environment.
+ * Resolve the active Astryx theme from config and environment.
*
* @param {string} [cwd] - Working directory (defaults to process.cwd())
* @returns {{ variants?: Record<string, string[]>, fonts?: Record<string, string>, name?: string } | null}
diff --git a/packages/cli/src/types/base.d.ts b/packages/cli/src/types/base.d.ts
index 2b3b36a884..8e43918ffb 100644
--- a/packages/cli/src/types/base.d.ts
+++ b/packages/cli/src/types/base.d.ts
@@ -1,7 +1,7 @@
// Copyright (c) Meta Platforms, Inc. and affiliates.
/**
- * Shared types for the XDS CLI JSON API.
+ * Shared types for the Astryx CLI JSON API.
*
* CLIError and CLIUnsupportedError are the two error shapes.
* CLIAnyResponse is the union of all success response types.
diff --git a/packages/cli/src/utils/github.mjs b/packages/cli/src/utils/github.mjs
index 57db45aa11..6e99cd4ab2 100644
--- a/packages/cli/src/utils/github.mjs
+++ b/packages/cli/src/utils/github.mjs
@@ -1,7 +1,7 @@
// Copyright (c) Meta Platforms, Inc. and affiliates.
/**
- * @file GitHub utilities for XDS CLI
+ * @file GitHub utilities for Astryx CLI
*
* Shared helpers for interacting with the GitHub CLI (`gh`).
* Used by gap-report and swizzle commands.
diff --git a/packages/cli/src/utils/paths.mjs b/packages/cli/src/utils/paths.mjs
index 199afb7d54..88fce72dd1 100644
--- a/packages/cli/src/utils/paths.mjs
+++ b/packages/cli/src/utils/paths.mjs
@@ -1,7 +1,7 @@
// Copyright (c) Meta Platforms, Inc. and affiliates.
/**
- * @file Path resolution utilities for XDS CLI
+ * @file Path resolution utilities for Astryx CLI
*
* Finds packages/core, project root, and CLI package root.
*/
@@ -140,7 +140,7 @@ export function discoverExternalPackages(startDir = process.cwd()) {
/**
* List available component directories in packages/core/src.
- * Returns directory names that contain XDS*.tsx files.
+ * Returns directory names that contain Astryx*.tsx files.
*/
export function listComponents(coreDir) {
const srcDir = path.join(coreDir, 'src');
diff --git a/packages/cli/src/utils/semver.mjs b/packages/cli/src/utils/semver.mjs
index a315f83414..b5ec05d444 100644
--- a/packages/cli/src/utils/semver.mjs
+++ b/packages/cli/src/utils/semver.mjs
@@ -3,7 +3,7 @@
/**
* @file Minimal semver utilities for the CLI.
*
- * We deliberately avoid pulling in `semver` from npm — XDS releases follow a
+ * We deliberately avoid pulling in `semver` from npm — Astryx releases follow a
* strict `MAJOR.MINOR.PATCH[-prerelease]` shape and the CLI runs in consumer
* sandboxes where a smaller dependency surface is preferred.
*/
diff --git a/packages/core/src/Badge/Badge.test-violations.tsx b/packages/core/src/Badge/Badge.test-violations.tsx
index 667749757f..fdf231c877 100644
--- a/packages/core/src/Badge/Badge.test-violations.tsx
+++ b/packages/core/src/Badge/Badge.test-violations.tsx
@@ -7,7 +7,7 @@
import * as stylex from '@stylexjs/stylex';
-// This file contains intentional violations to test the XDS ESLint plugin
+// This file contains intentional violations to test the Astryx ESLint plugin
const badStyles = stylex.create({
// VIOLATION: hardcoded fontSize (should use textSizeVars)
diff --git a/packages/core/src/Badge/Badge.tsx b/packages/core/src/Badge/Badge.tsx
index 6667e5490f..597a03c072 100644
--- a/packages/core/src/Badge/Badge.tsx
+++ b/packages/core/src/Badge/Badge.tsx
@@ -173,7 +173,7 @@ export interface BadgeProps extends BaseProps<HTMLSpanElement> {
/**
* A badge component for displaying status indicators, counts, or labels.
*
- * Styles use XDS theme tokens via StyleX.
+ * Styles use Astryx theme tokens via StyleX.
* Wrap your app in <Theme> to apply a theme.
*
* @example
diff --git a/packages/core/src/BaseProps.ts b/packages/core/src/BaseProps.ts
index f14f53d636..02db072415 100644
--- a/packages/core/src/BaseProps.ts
+++ b/packages/core/src/BaseProps.ts
@@ -3,7 +3,7 @@
/**
* @file BaseProps.ts
* @input None (pure type definitions)
- * @output Exports BaseProps — the shared base interface for all XDS components
+ * @output Exports BaseProps — the shared base interface for all Astryx components
* @position Type foundation; extended by all component prop interfaces
*
* Keeps: event handlers, aria-*, role, tabIndex, hidden, draggable, inert,
@@ -15,7 +15,7 @@ import type React from 'react';
import type {StyleXStyles} from '@stylexjs/stylex';
/**
- * Base props shared by all XDS components.
+ * Base props shared by all Astryx components.
*
* Omits props that are footguns, deprecated, or irrelevant to component APIs.
* Components that genuinely need an omitted prop can declare it explicitly.
@@ -90,6 +90,6 @@ export interface BaseProps<T extends HTMLElement = HTMLElement> extends Omit<
xstyle?: StyleXStyles;
/** Allow data-* attributes for telemetry, testing, integration hooks, and
- * XDS component prop/state reflection (for example data-variant/data-size). */
+ * Astryx component prop/state reflection (for example data-variant/data-size). */
[key: `data-${string}`]: string | undefined;
}
diff --git a/packages/core/src/Blockquote/Blockquote.tsx b/packages/core/src/Blockquote/Blockquote.tsx
index eca6c00815..8423f98f31 100644
--- a/packages/core/src/Blockquote/Blockquote.tsx
+++ b/packages/core/src/Blockquote/Blockquote.tsx
@@ -58,7 +58,7 @@ const styles = stylex.create({
* Blockquote component for displaying quoted content.
*
* Renders a semantic `<blockquote>` with an accent-colored left border
- * and secondary text color, matching the XDS visual language.
+ * and secondary text color, matching the Astryx visual language.
*
* @example
* ```
diff --git a/packages/core/src/Button/Button.tsx b/packages/core/src/Button/Button.tsx
index 208a0cf370..3c20754626 100644
--- a/packages/core/src/Button/Button.tsx
+++ b/packages/core/src/Button/Button.tsx
@@ -464,7 +464,7 @@ const groupStyles = stylex.create({
/**
* A versatile button component with multiple variants.
*
- * Styles use XDS theme tokens via StyleX.
+ * Styles use Astryx theme tokens via StyleX.
* Wrap your app in <Theme> to apply a theme.
* Themes can provide component-level variant overrides via theme.components.button.variants
*
diff --git a/packages/core/src/Collapsible/CollapsibleGroup.tsx b/packages/core/src/Collapsible/CollapsibleGroup.tsx
index 2abf032ca3..745fe0fb6e 100644
--- a/packages/core/src/Collapsible/CollapsibleGroup.tsx
+++ b/packages/core/src/Collapsible/CollapsibleGroup.tsx
@@ -105,8 +105,8 @@ function normalizeToArray(value: string | string[] | undefined): string[] {
* <CollapsibleGroup type="single" defaultValue="faq1">
* <VStack gap={2}>
* <Card>
- * <Collapsible trigger="What is XDS?" value="faq1">
- * XDS is a design system for building internal tools.
+ * <Collapsible trigger="What is Astryx?" value="faq1">
+ * Astryx is a design system for building internal tools.
* </Collapsible>
* </Card>
* <Card>
diff --git a/packages/core/src/Collapsible/useCollapsible.ts b/packages/core/src/Collapsible/useCollapsible.ts
index 55c2ed5412..4e37403fc3 100644
--- a/packages/core/src/Collapsible/useCollapsible.ts
+++ b/packages/core/src/Collapsible/useCollapsible.ts
@@ -18,7 +18,7 @@
* - /packages/core/src/Collapsible/index.ts (exports)
* - /packages/core/src/Collapsible/Collapsible.doc.mjs
*
- * NOTE: Public hooks use the `useXDS` prefix per XDS naming conventions.
+ * NOTE: Public hooks use the `useXDS` prefix per Astryx naming conventions.
*/
import {useState, use} from 'react';
diff --git a/packages/core/src/Divider/Divider.tsx b/packages/core/src/Divider/Divider.tsx
index 45324cd6ac..1b2f3bc171 100644
--- a/packages/core/src/Divider/Divider.tsx
+++ b/packages/core/src/Divider/Divider.tsx
@@ -171,7 +171,7 @@ const fullBleedStyles = stylex.create({
* Divider component for visual separation of content.
*
* Provides horizontal and vertical dividers with optional labels.
- * Uses XDS design tokens for colors and spacing.
+ * Uses Astryx design tokens for colors and spacing.
*
* @example
* ```
diff --git a/packages/core/src/DropdownMenu/DropdownMenu.tsx b/packages/core/src/DropdownMenu/DropdownMenu.tsx
index 65e4a8d478..0870636851 100644
--- a/packages/core/src/DropdownMenu/DropdownMenu.tsx
+++ b/packages/core/src/DropdownMenu/DropdownMenu.tsx
@@ -129,7 +129,7 @@ interface DropdownMenuBaseProps extends BaseProps {
hasChevron?: boolean;
/**
* Position placement relative to the trigger.
- * Uses the same placement values as other XDS layer-based components.
+ * Uses the same placement values as other Astryx layer-based components.
* @default 'below'
*/
placement?: LayerPlacement;
diff --git a/packages/core/src/EmptyState/EmptyState.tsx b/packages/core/src/EmptyState/EmptyState.tsx
index 3d6f9b121c..8bde81befb 100644
--- a/packages/core/src/EmptyState/EmptyState.tsx
+++ b/packages/core/src/EmptyState/EmptyState.tsx
@@ -121,7 +121,7 @@ export interface EmptyStateProps extends BaseProps<HTMLDivElement> {
* Displays an icon or illustration, title, optional description, and action buttons.
*
* Uses `role="status"` to announce content to screen readers.
- * Styles use XDS theme tokens via StyleX. Wrap your app in <Theme> to apply a theme.
+ * Styles use Astryx theme tokens via StyleX. Wrap your app in <Theme> to apply a theme.
*
* @example
* ```
diff --git a/packages/core/src/FormLayout/FormLayout.tsx b/packages/core/src/FormLayout/FormLayout.tsx
index 2ead6a63a3..481d9d0206 100644
--- a/packages/core/src/FormLayout/FormLayout.tsx
+++ b/packages/core/src/FormLayout/FormLayout.tsx
@@ -68,7 +68,7 @@ export interface FormLayoutProps extends BaseProps<HTMLDivElement> {
/** Ref forwarded to the root element */
ref?: React.Ref<HTMLDivElement>;
/**
- * Form fields to arrange. Accepts XDS inputs (TextInput, Selector, etc.)
+ * Form fields to arrange. Accepts Astryx inputs (TextInput, Selector, etc.)
* and Field-wrapped custom controls.
*/
children?: ReactNode;
diff --git a/packages/core/src/Icon/globalIconRegistry.tsx b/packages/core/src/Icon/globalIconRegistry.tsx
index 743bad335d..8c86169c0f 100644
--- a/packages/core/src/Icon/globalIconRegistry.tsx
+++ b/packages/core/src/Icon/globalIconRegistry.tsx
@@ -18,7 +18,7 @@ import {defaultIcons} from './defaultIcons';
// =============================================================================
/**
- * Semantic icon names used internally by XDS components.
+ * Semantic icon names used internally by Astryx components.
*
* These represent the functional purpose of each icon, not a specific
* visual representation. Themes provide the actual icon components.
diff --git a/packages/core/src/Layout/index.ts b/packages/core/src/Layout/index.ts
index d1011b9f6d..d8279b5565 100644
--- a/packages/core/src/Layout/index.ts
+++ b/packages/core/src/Layout/index.ts
@@ -5,7 +5,7 @@
/**
* @file index.ts
* @input Imports layout utilities and components
- * @output Exports XDS layout system
+ * @output Exports Astryx layout system
* @position Entry point for @astryxdesign/core/Layout
*
* SYNC: When modified, update /packages/core/src/Layout/Layout.doc.mjs
diff --git a/packages/core/src/Link/LinkContext.ts b/packages/core/src/Link/LinkContext.ts
index 853bf868ef..666da992c8 100644
--- a/packages/core/src/Link/LinkContext.ts
+++ b/packages/core/src/Link/LinkContext.ts
@@ -30,7 +30,7 @@ export interface LinkContextValue {
}
/**
- * Context for providing a custom link component to all XDS components.
+ * Context for providing a custom link component to all Astryx components.
* Defaults to null (components fall back to native `<a>`).
*/
export const LinkContext = createContext<LinkContextValue | null>(null);
diff --git a/packages/core/src/Link/LinkProvider.tsx b/packages/core/src/Link/LinkProvider.tsx
index e37e9c2a99..4675d65280 100644
--- a/packages/core/src/Link/LinkProvider.tsx
+++ b/packages/core/src/Link/LinkProvider.tsx
@@ -8,7 +8,7 @@
* @output Exports LinkProvider component and LinkProviderProps
* @position Provider component for polymorphic link support
*
- * Sets the default link component for all XDS components in the subtree.
+ * Sets the default link component for all Astryx components in the subtree.
* Individual components can still override via the `as` prop.
*
* @example
@@ -45,7 +45,7 @@ export interface LinkProviderProps {
}
/**
- * Provides a custom link component to all XDS components in the subtree.
+ * Provides a custom link component to all Astryx components in the subtree.
*
* Wrap your app (or a section of it) in LinkProvider to replace
* native `<a>` elements with your framework's link component
diff --git a/packages/core/src/Link/useLinkComponent.ts b/packages/core/src/Link/useLinkComponent.ts
index 03d1047f6f..ff3718fa85 100644
--- a/packages/core/src/Link/useLinkComponent.ts
+++ b/packages/core/src/Link/useLinkComponent.ts
@@ -6,7 +6,7 @@
* @file useLinkComponent.ts
* @input React use, useMemo, createElement, forwardRef, LinkContext, LinkComponentType
* @output Exports useLinkComponent hook
- * @position Hook for resolving the link component in XDS components
+ * @position Hook for resolving the link component in Astryx components
*
* Resolution order: per-component `as` prop > LinkProvider context > native `<a>`.
*
diff --git a/packages/core/src/List/ListItem.tsx b/packages/core/src/List/ListItem.tsx
index 46f4505315..6f94e60dae 100644
--- a/packages/core/src/List/ListItem.tsx
+++ b/packages/core/src/List/ListItem.tsx
@@ -125,7 +125,7 @@ const styles = stylex.create({
// =============================================================================
// Marker styles — custom-rendered markers instead of native list-style-type.
-// Uses CSS counters for numbers (same pattern as WWW XDS).
+// Uses CSS counters for numbers (same pattern as WWW Astryx).
// =============================================================================
const MARKER_DOT_SIZE = 6;
diff --git a/packages/core/src/Markdown/Markdown.tsx b/packages/core/src/Markdown/Markdown.tsx
index 9aba990f1b..0d0ce43aef 100644
--- a/packages/core/src/Markdown/Markdown.tsx
+++ b/packages/core/src/Markdown/Markdown.tsx
@@ -6,7 +6,7 @@
* @file Markdown.tsx
* @input Markdown string, parser AST types
* @output Exports Markdown component and MarkdownProps
- * @position Core implementation; renders markdown as XDS components
+ * @position Core implementation; renders markdown as Astryx components
*/
import {useMemo, useRef} from 'react';
@@ -1518,7 +1518,7 @@ function renderBlock(
// ---------------------------------------------------------------------------
/**
- * Renders a markdown string as XDS components. Supports streaming with
+ * Renders a markdown string as Astryx components. Supports streaming with
* smooth fade-in animation via isStreaming.
*
* @example
diff --git a/packages/core/src/Markdown/parser.ts b/packages/core/src/Markdown/parser.ts
index 7311579e82..0e52ab913c 100644
--- a/packages/core/src/Markdown/parser.ts
+++ b/packages/core/src/Markdown/parser.ts
@@ -73,7 +73,7 @@ export type ParseOptions = {
*
* Two intentional deviations from the strict GFM spec for v1:
* trailing `&entity;` is not peeled off the URL, and an invalid TLD
- * suffix is not rejected (XDS accepts any plausible TLD shape).
+ * suffix is not rejected (Astryx accepts any plausible TLD shape).
*/
autolink?: 'gfm';
};
diff --git a/packages/core/src/Outline/Outline.tsx b/packages/core/src/Outline/Outline.tsx
index fc4dcb60f3..7ba5734867 100644
--- a/packages/core/src/Outline/Outline.tsx
+++ b/packages/core/src/Outline/Outline.tsx
@@ -4,7 +4,7 @@
/**
* @file Outline.tsx
- * @input Uses React, StyleX, XDS link provider integration, Outline hooks/types
+ * @input Uses React, StyleX, Astryx link provider integration, Outline hooks/types
* @output Exports Outline component and OutlineProps type
* @position Core implementation; consumed by index.ts
*
diff --git a/packages/core/src/Pagination/Pagination.tsx b/packages/core/src/Pagination/Pagination.tsx
index 8fe969145f..f3fe5b7472 100644
--- a/packages/core/src/Pagination/Pagination.tsx
+++ b/packages/core/src/Pagination/Pagination.tsx
@@ -145,7 +145,7 @@ export interface PaginationProps extends Omit<
*/
label?: string;
- // --- Standard XDS ---
+ // --- Standard Astryx ---
/** Test ID for automated testing. */
'data-testid'?: string;
}
diff --git a/packages/core/src/ProgressBar/ProgressBar.tsx b/packages/core/src/ProgressBar/ProgressBar.tsx
index aa1d9ade4c..c50068fa43 100644
--- a/packages/core/src/ProgressBar/ProgressBar.tsx
+++ b/packages/core/src/ProgressBar/ProgressBar.tsx
@@ -241,7 +241,7 @@ function defaultFormatValueLabel(value: number, max: number): string {
* icons, and descriptions alongside the bar using layout components rather
* than adding props to ProgressBar itself.
*
- * Styles use XDS theme tokens via StyleX.
+ * Styles use Astryx theme tokens via StyleX.
* Wrap your app in <Theme> to apply a theme.
*
* @example
diff --git a/packages/core/src/StatusDot/StatusDot.tsx b/packages/core/src/StatusDot/StatusDot.tsx
index 09523e9d31..a23edadedd 100644
--- a/packages/core/src/StatusDot/StatusDot.tsx
+++ b/packages/core/src/StatusDot/StatusDot.tsx
@@ -132,7 +132,7 @@ export interface StatusDotProps extends BaseProps<HTMLSpanElement> {
* A small colored dot indicator for status display (online/offline, severity, etc).
*
* Fixed 8px size. Renders as a non-focusable `<span>` with `role="img"` and
- * `aria-label` for accessibility. Styles use XDS theme tokens via StyleX.
+ * `aria-label` for accessibility. Styles use Astryx theme tokens via StyleX.
* Wrap your app in `<Theme>` to apply a theme.
*
* @example
diff --git a/packages/core/src/Table/plugins/filtering/useTableFiltering.tsx b/packages/core/src/Table/plugins/filtering/useTableFiltering.tsx
index 6ca13c7954..8611d72ae8 100644
--- a/packages/core/src/Table/plugins/filtering/useTableFiltering.tsx
+++ b/packages/core/src/Table/plugins/filtering/useTableFiltering.tsx
@@ -4,7 +4,7 @@
/**
* @file useTableFiltering.tsx
- * @input React, types, XDS components, theme tokens
+ * @input React, types, Astryx components, theme tokens
* @output Exports useTableFiltering hook and filter type definitions
* @position Filtering plugin; consumed by Table via plugins prop
*
diff --git a/packages/core/src/Table/plugins/sortable/useTableSortable.tsx b/packages/core/src/Table/plugins/sortable/useTableSortable.tsx
index f686b02748..d4c6ffcd1c 100644
--- a/packages/core/src/Table/plugins/sortable/useTableSortable.tsx
+++ b/packages/core/src/Table/plugins/sortable/useTableSortable.tsx
@@ -65,7 +65,7 @@ export type TableSortState<TSortKey extends string = string> =
/**
* Configuration for useTableSortable.
*
- * Follows XDS headless plugin conventions: the consumer owns all state
+ * Follows Astryx headless plugin conventions: the consumer owns all state
* and provides callbacks. The plugin never holds internal sort state.
*
* @template TSortKey - Union of valid sort key strings
diff --git a/packages/core/src/Table/useBaseTablePlugins.ts b/packages/core/src/Table/useBaseTablePlugins.ts
index 668d7f65ff..6dd0ae4097 100644
--- a/packages/core/src/Table/useBaseTablePlugins.ts
+++ b/packages/core/src/Table/useBaseTablePlugins.ts
@@ -151,7 +151,7 @@ function validatePlugin<T extends Record<string, unknown>>(
* Plugins are sorted into a canonical order (see PLUGIN_ORDER) so that
* interactions between first-party plugins are deterministic.
*
- * @param basePlugins - Stable array of built-in plugins (e.g. XDS style plugin)
+ * @param basePlugins - Stable array of built-in plugins (e.g. Astryx style plugin)
* @param userPlugins - Named plugin record from the consumer
* @returns Stable array of plugins suitable for BaseTable
*
diff --git a/packages/core/src/docs-types.ts b/packages/core/src/docs-types.ts
index 0b2532bcdf..9fd83e819d 100644
--- a/packages/core/src/docs-types.ts
+++ b/packages/core/src/docs-types.ts
@@ -47,7 +47,7 @@ export interface PropDoc {
default?: string;
/** True if the prop must be provided. Omit (don't set to false) if optional. */
required?: boolean;
- /** For ReactNode props: the XDS components this slot typically accepts.
+ /** For ReactNode props: the Astryx components this slot typically accepts.
* Each entry is an ElementDescriptor that the playground uses to
* create a default instance when the user toggles the slot on.
*
@@ -191,12 +191,12 @@ export interface ComponentVar {
* with the primary/most-used component first.
*/
export interface ComponentEntry {
- /** Full export name including XDS prefix. e.g. `"TableRow"`,
+ /** Full export name including Astryx prefix. e.g. `"TableRow"`,
* `"DialogHeader"`, `"useTableSelection"` */
name: string;
/** Human-readable display name for this subcomponent. Matches the import
* name visually with spaces between PascalCase / camelCase words
- * (e.g. `"TableRow"` → `"XDS Table Row"`). See `BaseDoc.displayName`. */
+ * (e.g. `"TableRow"` → `"Astryx Table Row"`). See `BaseDoc.displayName`. */
displayName: string;
/** One-sentence description of what this specific component does.
* For sub-components, explain the role within the parent composition. */
@@ -414,7 +414,7 @@ export interface PlaygroundConfig {
* Do not use this interface directly — use `ComponentDoc` (the union type).
*/
interface BaseDoc {
- /** Directory name without the XDS prefix, PascalCase.
+ /** Directory name without the Astryx prefix, PascalCase.
* e.g. `"Button"`, `"Table"`, `"TextInput"`, `"AppShell"` */
name: string;
/** Human-readable display name with spaces between words, used by the
@@ -434,7 +434,7 @@ interface BaseDoc {
/** Sub-component names to hide from human-facing UI (CLI listings,
* docs catalogs). The components stay public and importable — agents
* and tooling can still discover them via source. Use when the
- * directory's doc covers a group but some XDS*.tsx files shouldn't
+ * directory's doc covers a group but some Astryx*.tsx files shouldn't
* appear in the catalog. */
hiddenComponents?: string[];
/** Hide this entire component from human-facing UI (CLI listings,
@@ -535,7 +535,7 @@ export interface SingleComponentDoc extends BaseDoc {
* the entry's content is emitted from the sub-component's own file, not here.
*/
export interface ComponentRef {
- /** Full export name including XDS prefix, e.g. `"ChatComposer"`. Must
+ /** Full export name including Astryx prefix, e.g. `"ChatComposer"`. Must
* match the `name` field of the referenced sub-component's own doc. */
name: string;
}
@@ -957,7 +957,7 @@ export type TemplateDoc = PageTemplateDoc | BlockTemplateDoc;
* Metadata for a component group that is NOT itself a component.
*
* Some groups (e.g. 'Checkbox', 'Layout', 'Tabs') are category labels —
- * they cluster related components but have no corresponding XDS*.tsx file.
+ * they cluster related components but have no corresponding Astryx*.tsx file.
* This metadata tells the docsite and CLI which component to treat as the
* canonical entry point for the group.
*
diff --git a/packages/core/src/hooks/useStreamingText.ts b/packages/core/src/hooks/useStreamingText.ts
index e75f24895f..8f13ec0731 100644
--- a/packages/core/src/hooks/useStreamingText.ts
+++ b/packages/core/src/hooks/useStreamingText.ts
@@ -13,7 +13,7 @@
* Advances on word/syntax boundaries to avoid slicing mid-markdown or
* mid-word, preventing visual glitches when used with markdown renderers.
*
- * Animation timing derives from XDS motion tokens (via useTheme) when
+ * Animation timing derives from Astryx motion tokens (via useTheme) when
* an Theme provider is present. Falls back to sensible defaults when
* used outside a theme provider.
*
@@ -96,7 +96,7 @@ export function useStreamingText(
const speed = options?.speed ?? 'natural';
const charsPerTick = CHARS_PER_TICK[speed];
- // Derive tick timing from XDS motion tokens when available.
+ // Derive tick timing from Astryx motion tokens when available.
// natural → --duration-fast-min (frame-level cadence from the theme)
// fast → half that, floored at 4ms (roughly 2x speed)
const {token} = useTheme();
diff --git a/packages/core/src/reset.css b/packages/core/src/reset.css
index 3c045c5275..238610d85f 100644
--- a/packages/core/src/reset.css
+++ b/packages/core/src/reset.css
@@ -1,11 +1,11 @@
/* Copyright (c) Meta Platforms, Inc. and affiliates. */
/**
- * XDS Reset Stylesheet
+ * Astryx Reset Stylesheet
*
* An opinionated CSS reset that provides a clean, predictable base for
- * XDS applications. Built on the same principles as Tailwind Preflight
- * and modern-normalize, adapted for the XDS design system.
+ * Astryx applications. Built on the same principles as Tailwind Preflight
+ * and modern-normalize, adapted for the Astryx design system.
*
* This reset:
* - Normalizes cross-browser inconsistencies
@@ -26,7 +26,7 @@
* import '@astryxdesign/theme-default/theme.css'; // @layer astryx-theme — theme overrides
*
* Layer order: reset → astryx-base → astryx-theme
- * Consumer styles (unlayered) always override all XDS layers.
+ * Consumer styles (unlayered) always override all Astryx layers.
* The reset has the lowest priority and can be overridden by any other layer.
*
* Similar to:
@@ -248,7 +248,7 @@
/*
* Normalize placeholder opacity (Firefox renders at reduced opacity)
- * and set a sensible default color using the XDS text-placeholder token.
+ * and set a sensible default color using the Astryx text-placeholder token.
*/
:where(input::placeholder, textarea::placeholder) {
opacity: 1;
diff --git a/packages/core/src/theme/Theme.tsx b/packages/core/src/theme/Theme.tsx
index 07aeeeac65..48e8dc0694 100644
--- a/packages/core/src/theme/Theme.tsx
+++ b/packages/core/src/theme/Theme.tsx
@@ -8,7 +8,7 @@
* Applies theme tokens and sets color-scheme for light-dark() to work.
* Themes are created with `defineTheme()` and applied via CSS:
* - Token overrides set as CSS custom properties on [data-astryx-theme]
- * - Component overrides scoped via @scope'd CSS selectors on the stable XDS
+ * - Component overrides scoped via @scope'd CSS selectors on the stable Astryx
* selector surface (`.xds-*` classes today; components also emit `data-*`
* prop reflections for the data-attribute selector migration)
*
diff --git a/packages/core/src/theme/defineTheme.ts b/packages/core/src/theme/defineTheme.ts
index 48a90b5001..d7508f6863 100644
--- a/packages/core/src/theme/defineTheme.ts
+++ b/packages/core/src/theme/defineTheme.ts
@@ -1,7 +1,7 @@
// Copyright (c) Meta Platforms, Inc. and affiliates.
/**
- * defineTheme — Create an XDS theme from a flat token map.
+ * defineTheme — Create an Astryx theme from a flat token map.
*
* Two distribution modes:
* - Unbuilt: Theme generates CSS and injects a <style> tag at runtime
@@ -74,7 +74,7 @@ import type {SyntaxThemeDefinition} from './syntax';
// Types
// =============================================================================
-/** All valid XDS core token names */
+/** All valid Astryx core token names */
export type CoreTokenName =
| keyof typeof colorDefaults
| keyof typeof spacingDefaults
@@ -89,7 +89,7 @@ export type CoreTokenName =
| keyof typeof fontWeightDefaults
| keyof typeof typeScaleDefaults;
-/** All valid XDS token names — core + domain tokens */
+/** All valid Astryx token names — core + domain tokens */
export type TokenName = CoreTokenName | DomainTokenName;
/**
@@ -360,7 +360,7 @@ export interface DefinedTheme {
// All defaults merged into a single flat map
// =============================================================================
-/** All XDS token defaults as a flat map. Useful for resolving full token sets. */
+/** All Astryx token defaults as a flat map. Useful for resolving full token sets. */
export const xdsTokenDefaults: Record<string, string> = {
...colorDefaults,
...spacingDefaults,
@@ -469,10 +469,10 @@ function buildFontFamily(
}
/**
- * Create an XDS theme.
+ * Create an Astryx theme.
*
* Pass only the tokens you want to override — everything else
- * inherits from the XDS defaults.
+ * inherits from the Astryx defaults.
*
* When `typography.scale` is provided, it generates typography token overrides
* that are merged into the token map. Explicit `tokens` entries take
diff --git a/packages/core/src/theme/expandColorScale.ts b/packages/core/src/theme/expandColorScale.ts
index eaa3f719a9..d564fcdfcc 100644
--- a/packages/core/src/theme/expandColorScale.ts
+++ b/packages/core/src/theme/expandColorScale.ts
@@ -78,7 +78,7 @@ function ld(light: string, dark: string): string {
}
/**
- * Expand a color scale config into XDS color token overrides.
+ * Expand a color scale config into Astryx color token overrides.
*
* Only generates tokens that meaningfully derive from the accent color.
* Tokens that are convention-bound (status colors, categorical hues,
diff --git a/packages/core/src/theme/expandMotionScale.ts b/packages/core/src/theme/expandMotionScale.ts
index feea50a7f6..f7be0fb405 100644
--- a/packages/core/src/theme/expandMotionScale.ts
+++ b/packages/core/src/theme/expandMotionScale.ts
@@ -29,7 +29,7 @@
*
* @example
* ```
- * // Default XDS motion scale
+ * // Default Astryx motion scale
* { fast: 175, medium: 410, slow: 975, ratio: 0.75 }
*
* // Snappy theme (reduced motion budget)
diff --git a/packages/core/src/theme/expandRadiusScale.ts b/packages/core/src/theme/expandRadiusScale.ts
index aa28313479..18db9736b3 100644
--- a/packages/core/src/theme/expandRadiusScale.ts
+++ b/packages/core/src/theme/expandRadiusScale.ts
@@ -33,7 +33,7 @@
*
* @example
* ```
- * // Default XDS radius scale
+ * // Default Astryx radius scale
* { base: 4, multiplier: 1 }
*
* // Sharp/brutalist — all radii become 0
diff --git a/packages/core/src/theme/expandTypeScale.ts b/packages/core/src/theme/expandTypeScale.ts
index 8bf88e08a7..201603f381 100644
--- a/packages/core/src/theme/expandTypeScale.ts
+++ b/packages/core/src/theme/expandTypeScale.ts
@@ -87,7 +87,7 @@ export type TextWeightOverrides = Partial<
*
* @example
* ```
- * // Default XDS type scale
+ * // Default Astryx type scale
* { base: 14, ratio: 1.2 }
*
* // With custom weights
diff --git a/packages/core/src/theme/index.ts b/packages/core/src/theme/index.ts
index ee376a9aa1..667020027a 100644
--- a/packages/core/src/theme/index.ts
+++ b/packages/core/src/theme/index.ts
@@ -3,7 +3,7 @@
'use client';
/**
- * XDS Theme System
+ * Astryx Theme System
*
* Exports:
* - Theme: Provider component that applies theme
diff --git a/packages/core/src/theme/tokens.stylex.ts b/packages/core/src/theme/tokens.stylex.ts
index 3a2fd5cbdf..53c71202b2 100644
--- a/packages/core/src/theme/tokens.stylex.ts
+++ b/packages/core/src/theme/tokens.stylex.ts
@@ -1,7 +1,7 @@
// Copyright (c) Meta Platforms, Inc. and affiliates.
/**
- * XDS Design Tokens
+ * Astryx Design Tokens
*
* Defines all design tokens using StyleX defineVars.
* - *Defaults: Plain objects with default values (used by defineVars and themes)
diff --git a/packages/core/src/theme/tokens.ts b/packages/core/src/theme/tokens.ts
index 503875a476..acd045a2a6 100644
--- a/packages/core/src/theme/tokens.ts
+++ b/packages/core/src/theme/tokens.ts
@@ -6,7 +6,7 @@
* @output Server-safe token helpers for resolving theme values and building CSS var references
* @position Public theme utility; backs useTheme and external styling-library adapters
*
- * Use these helpers when code outside React hooks needs XDS token values:
+ * Use these helpers when code outside React hooks needs Astryx token values:
* build-time theme adapters, chart configuration, canvas/SVG rendering, tests,
* or plain JS theme objects for other styling libraries.
*
@@ -38,11 +38,11 @@ export interface ResolveThemeTokenOptions extends ResolveThemeTokensOptions {
}
/**
- * Return a CSS custom property reference for an XDS token name.
+ * Return a CSS custom property reference for an Astryx token name.
*
* Useful for non-StyleX styling-library configs (Panda, Chakra, MUI,
* Emotion, styled-components, UnoCSS, CSS Modules) where the value should
- * stay connected to the active XDS theme through the CSS cascade.
+ * stay connected to the active Astryx theme through the CSS cascade.
*
* @example
* ```ts
@@ -58,7 +58,7 @@ export function tokenVar(name: TokenName | (string & {})): string {
return `var(${name})`;
}
-/** Flat map of every known XDS token name to its `var(--token-name)` reference. */
+/** Flat map of every known Astryx token name to its `var(--token-name)` reference. */
export const tokenVars: Record<TokenName, string> = Object.fromEntries(
Object.keys(xdsTokenDefaults).map(name => [name, tokenVar(name)]),
) as Record<TokenName, string>;
@@ -145,7 +145,7 @@ function resolveXDSTokenValue(
}
/**
- * Resolve all XDS token values for a theme and effective color mode.
+ * Resolve all Astryx token values for a theme and effective color mode.
*
* The result starts with `xdsTokenDefaults`, applies `theme.tokens`, then
* reapplies `theme.__inputTokens` when available so explicit tuple overrides
@@ -185,7 +185,7 @@ export function resolveThemeTokens(
return resolved;
}
-/** Resolve one XDS token value for a theme and effective color mode. */
+/** Resolve one Astryx token value for a theme and effective color mode. */
export function resolveThemeToken(
theme: DefinedTheme | null | undefined,
name: TokenName | (string & {}),
diff --git a/packages/core/src/theme/types.ts b/packages/core/src/theme/types.ts
index 91b6b150e8..b0076c5e13 100644
--- a/packages/core/src/theme/types.ts
+++ b/packages/core/src/theme/types.ts
@@ -1,9 +1,9 @@
// Copyright (c) Meta Platforms, Inc. and affiliates.
/**
- * XDS Type Definitions
+ * Astryx Type Definitions
*
- * Shared types used across XDS components.
+ * Shared types used across Astryx components.
*/
// =============================================================================
@@ -25,7 +25,7 @@ export type FontWeight =
* A typography role declaration (body, heading, or code).
*
* Fonts must be loaded by the consumer (e.g. via a <link> tag in <head>
- * or an @import in CSS). XDS does not handle font loading — it only
+ * or an @import in CSS). Astryx does not handle font loading — it only
* sets the font-family token so the font is used once available.
*
* @example
diff --git a/packages/core/src/theme/useTheme.ts b/packages/core/src/theme/useTheme.ts
index 5daf55ea61..ac5a3ccb39 100644
--- a/packages/core/src/theme/useTheme.ts
+++ b/packages/core/src/theme/useTheme.ts
@@ -88,7 +88,7 @@ export interface UseThemeReturn {
// =============================================================================
/**
- * Access the current XDS theme's token values, resolved for the active color mode.
+ * Access the current Astryx theme's token values, resolved for the active color mode.
*
* Returns raw CSS values (hex colors, px values, etc.) suitable for
* non-CSS consumers like canvas, SVG, or data visualization libraries
diff --git a/packages/core/src/utils/mergeProps.ts b/packages/core/src/utils/mergeProps.ts
index 64148b6195..fba3647250 100644
--- a/packages/core/src/utils/mergeProps.ts
+++ b/packages/core/src/utils/mergeProps.ts
@@ -3,7 +3,7 @@
/**
* Merge xds-* props, stylex.props result, and optional consumer className/style.
*
- * stylex.props() returns { className, style }. This merges the XDS stable
+ * stylex.props() returns { className, style }. This merges the Astryx stable
* class name plus any data-attribute reflection from `xdsThemeProps()` with the
* StyleX class name so both StyleX styles and the theme-targeting surface are
* applied.
diff --git a/packages/core/src/utils/types.ts b/packages/core/src/utils/types.ts
index b56a717a7f..6b8f3e3805 100644
--- a/packages/core/src/utils/types.ts
+++ b/packages/core/src/utils/types.ts
@@ -13,7 +13,7 @@
export type SizeValue = number | string;
/**
- * Numeric spacing step from the XDS spacing scale.
+ * Numeric spacing step from the Astryx spacing scale.
*
* Maps to CSS spacing tokens:
* - 0 = 0px (--spacing-0)
diff --git a/packages/core/src/utils/xdsThemeProps.ts b/packages/core/src/utils/xdsThemeProps.ts
index 221c2af79d..da0a440ea9 100644
--- a/packages/core/src/utils/xdsThemeProps.ts
+++ b/packages/core/src/utils/xdsThemeProps.ts
@@ -67,7 +67,7 @@ function buildClassName(component: string, props?: ClassProps): string {
}
/**
- * Reflect XDS visual props as `data-*` attributes.
+ * Reflect Astryx visual props as `data-*` attributes.
*
* Keys are kebab-cased (`listStyle` → `data-list-style`) and values are the
* literal prop values, including numeric values (`level: 1` → `data-level="1"`).
@@ -92,7 +92,7 @@ export function xdsThemeDataAttributes(
/**
* Build the props object components should spread onto the same element that
- * receives the stable XDS class name.
+ * receives the stable Astryx class name.
*
* This emits the stable astryx class plus the data-attribute reflection
* surface. For example:
diff --git a/packages/lab/src/Chart/ChartTooltip.tsx b/packages/lab/src/Chart/ChartTooltip.tsx
index 0c5907e328..fa8ab3ea9c 100644
--- a/packages/lab/src/Chart/ChartTooltip.tsx
+++ b/packages/lab/src/Chart/ChartTooltip.tsx
@@ -6,7 +6,7 @@
* @position Child of Chart; reads scales from context
*
* Combines tooltip content and crosshair display into one component.
- * Uses the XDS Layer system (Popover API) so the tooltip renders above
+ * Uses the Astryx Layer system (Popover API) so the tooltip renders above
* all other content — portaled to the chart container div (outside SVG).
*/
diff --git a/packages/lab/src/Radial/RadialTooltip.tsx b/packages/lab/src/Radial/RadialTooltip.tsx
index 58dc68c2ef..eec291313e 100644
--- a/packages/lab/src/Radial/RadialTooltip.tsx
+++ b/packages/lab/src/Radial/RadialTooltip.tsx
@@ -5,7 +5,7 @@
* @output Hover tooltip for radial charts (pie/donut/spider)
* @position Child of RadialChart; reads geometry from radial context
*
- * Uses the XDS Layer system for top-layer rendering.
+ * Uses the Astryx Layer system for top-layer rendering.
* Hit-tests pointer position against slices (pie/donut) or axis proximity (spider).
* Portals the popover div outside the SVG into the chart container.
*/
diff --git a/packages/lab/src/SVGIcon/tokens.stylex.ts b/packages/lab/src/SVGIcon/tokens.stylex.ts
index 04c4224dcf..e5326917be 100644
--- a/packages/lab/src/SVGIcon/tokens.stylex.ts
+++ b/packages/lab/src/SVGIcon/tokens.stylex.ts
@@ -2,7 +2,7 @@
/**
* @file tokens.stylex.ts
- * @input XDS design token system
+ * @input Astryx design token system
* @output CSS custom properties for SVG icon rendering
* @position Token definitions consumed by SVGIcon and variation presets
*
diff --git a/packages/lab/src/SVGIcon/xif-types.ts b/packages/lab/src/SVGIcon/xif-types.ts
index 06e1c13bc9..a95de71d0e 100644
--- a/packages/lab/src/SVGIcon/xif-types.ts
+++ b/packages/lab/src/SVGIcon/xif-types.ts
@@ -2,7 +2,7 @@
/**
* @file xif-types.ts
- * @description XDS Icon Format (XIF) type definitions — v0.1.0 draft
+ * @description Astryx Icon Format (XIF) type definitions — v0.1.0 draft
*
* Icons are pure structure — zero visual values. The theme resolves
* all visual properties (color, weight, rounding, timing).
@@ -148,7 +148,7 @@ export interface XIFPath {
// =============================================================================
/**
- * Root type for an XDS Icon Format definition.
+ * Root type for an Astryx Icon Format definition.
* Pure structure — no visual values.
*/
export interface XIFIcon {
diff --git a/packages/lab/src/Stepper/Step.tsx b/packages/lab/src/Stepper/Step.tsx
index f33720b24e..48329d160c 100644
--- a/packages/lab/src/Stepper/Step.tsx
+++ b/packages/lab/src/Stepper/Step.tsx
@@ -74,7 +74,7 @@ export interface StepProps extends BaseProps<HTMLLIElement> {
icon?: ReactNode;
/**
* Semantic color for the step. Controls **color only** and maps to the
- * global XDS semantic tokens (`accent`, `success`, `warning`, `error`).
+ * global Astryx semantic tokens (`accent`, `success`, `warning`, `error`).
* Leave unset to use the progress-derived default coloring.
*/
status?: StepStatus;
diff --git a/packages/lab/src/Stepper/StepStatus.ts b/packages/lab/src/Stepper/StepStatus.ts
index b94dca42f0..b188009453 100644
--- a/packages/lab/src/Stepper/StepStatus.ts
+++ b/packages/lab/src/Stepper/StepStatus.ts
@@ -9,7 +9,7 @@
/**
* Semantic color status for a step. Controls **color only** — it maps directly
- * onto the XDS global semantic color tokens and does not change layout,
+ * onto the Astryx global semantic color tokens and does not change layout,
* iconography, or behavior.
*
* Plain string values aligned with the global token semantics:
diff --git a/packages/lab/src/index.ts b/packages/lab/src/index.ts
index 2dc00955e8..d21401cb19 100644
--- a/packages/lab/src/index.ts
+++ b/packages/lab/src/index.ts
@@ -1,7 +1,7 @@
// Copyright (c) Meta Platforms, Inc. and affiliates.
/**
- * @astryxdesign/lab — Experimental XDS components
+ * @astryxdesign/lab — Experimental Astryx components
*
* Components here are functional but not yet hardened for production.
* They're available in storybook and sandbox for testing and iteration.
diff --git a/packages/themes/brutalist/package.json b/packages/themes/brutalist/package.json
index 803967965c..5da88a4d39 100644
--- a/packages/themes/brutalist/package.json
+++ b/packages/themes/brutalist/package.json
@@ -2,7 +2,7 @@
"name": "@astryxdesign/theme-brutalist",
"version": "0.0.15",
"private": true,
- "description": "Brutalist theme for XDS — zero radius, monospace, heavy borders",
+ "description": "Brutalist theme for Astryx — zero radius, monospace, heavy borders",
"author": "Meta Open Source",
"license": "MIT",
"homepage": "https://github.com/facebookexperimental/xds#readme",
diff --git a/packages/themes/brutalist/src/brutalistTheme.ts b/packages/themes/brutalist/src/brutalistTheme.ts
index 7bec2b9170..ad5a2e1a48 100644
--- a/packages/themes/brutalist/src/brutalistTheme.ts
+++ b/packages/themes/brutalist/src/brutalistTheme.ts
@@ -1,7 +1,7 @@
// Copyright (c) Meta Platforms, Inc. and affiliates.
/**
- * Brutalist theme for XDS
+ * Brutalist theme for Astryx
*
* Zero radius, monospace everything, hot pink accent, heavy borders.
* Demonstrates the full power of defineTheme: typography roles,
diff --git a/packages/themes/butter/README.md b/packages/themes/butter/README.md
index f08fe3d228..eac3fa39a0 100644
--- a/packages/themes/butter/README.md
+++ b/packages/themes/butter/README.md
@@ -1,6 +1,6 @@
# @astryxdesign/theme-butter
-Golden buttery theme for XDS with blue accents. Sarina for display type, Outfit for headings and body.
+Golden buttery theme for Astryx with blue accents. Sarina for display type, Outfit for headings and body.
## Install
diff --git a/packages/themes/chocolate/package.json b/packages/themes/chocolate/package.json
index 432495ee5f..b9dd1ecb6f 100644
--- a/packages/themes/chocolate/package.json
+++ b/packages/themes/chocolate/package.json
@@ -3,7 +3,7 @@
"version": "0.0.15",
"displayName": "Chocolate Theme",
"private": false,
- "description": "Warm chocolate theme for XDS — rich brown palette with Fraunces headings, Albert Sans body, and Lucide icons",
+ "description": "Warm chocolate theme for Astryx — rich brown palette with Fraunces headings, Albert Sans body, and Lucide icons",
"author": "Meta Open Source",
"license": "MIT",
"homepage": "https://github.com/facebookexperimental/xds#readme",
diff --git a/packages/themes/daily/package.json b/packages/themes/daily/package.json
index ce89a9cf85..c678c70e07 100644
--- a/packages/themes/daily/package.json
+++ b/packages/themes/daily/package.json
@@ -2,7 +2,7 @@
"name": "@astryxdesign/theme-daily",
"version": "0.0.15",
"private": false,
- "description": "Daily theme for XDS — warm, productivity-focused palette with Lucide icon set",
+ "description": "Daily theme for Astryx — warm, productivity-focused palette with Lucide icon set",
"author": "Meta Open Source",
"license": "MIT",
"homepage": "https://github.com/facebookexperimental/xds#readme",
diff --git a/packages/themes/default/src/defaultTheme.ts b/packages/themes/default/src/defaultTheme.ts
index 71ae87387d..70069ff2bc 100644
--- a/packages/themes/default/src/defaultTheme.ts
+++ b/packages/themes/default/src/defaultTheme.ts
@@ -1,9 +1,9 @@
// Copyright (c) Meta Platforms, Inc. and affiliates.
/**
- * XDS Default Theme
+ * Astryx Default Theme
*
- * The reference theme — provides the standard XDS visual language.
+ * The reference theme — provides the standard Astryx visual language.
* Uses defineTheme for CSS-based theming (no StyleX build required for consumers).
*
* Typography sizing is driven by typography.scale, which auto-generates both
diff --git a/packages/themes/gothic/README.md b/packages/themes/gothic/README.md
index 0a96592e15..681c9e81a1 100644
--- a/packages/themes/gothic/README.md
+++ b/packages/themes/gothic/README.md
@@ -1,6 +1,6 @@
# @astryxdesign/theme-gothic
-**Dark-only** atmospheric gothic theme for XDS — deep blue-gray surfaces, distressed display heading, and pastel categorical accents that glow against the dark page like illuminated panels. Uses Manufacturing Consent for headings, Fustat for body text, and [Lucide](https://lucide.dev) icons.
+**Dark-only** atmospheric gothic theme for Astryx — deep blue-gray surfaces, distressed display heading, and pastel categorical accents that glow against the dark page like illuminated panels. Uses Manufacturing Consent for headings, Fustat for body text, and [Lucide](https://lucide.dev) icons.
> Gothic is a single-mode theme: it always renders dark, regardless of the user's system color preference. For best browser-chrome integration (scrollbars, native form controls), pass `mode="dark"` to your `XDSTheme` provider.
diff --git a/packages/themes/y2k/README.md b/packages/themes/y2k/README.md
index 09b96be198..caf4f0a489 100644
--- a/packages/themes/y2k/README.md
+++ b/packages/themes/y2k/README.md
@@ -1,6 +1,6 @@
# @astryxdesign/theme-y2k
-Playful Y2K pop theme for XDS: a soft periwinkle body, charcoal accent, holographic categorical colors derived from HCT tonal palettes, Poppins for body/headings, and a Crimson Text serif for display sizes.
+Playful Y2K pop theme for Astryx: a soft periwinkle body, charcoal accent, holographic categorical colors derived from HCT tonal palettes, Poppins for body/headings, and a Crimson Text serif for display sizes.
## Install
diff --git a/packages/vega/src/index.ts b/packages/vega/src/index.ts
index 801df688d7..a7a6f72351 100644
--- a/packages/vega/src/index.ts
+++ b/packages/vega/src/index.ts
@@ -3,7 +3,7 @@
/**
* @file index.ts
* @input All public exports for @astryxdesign/vega
- * @output Public API surface for the XDS Vega wrapper package
+ * @output Public API surface for the Astryx Vega wrapper package
* @position Barrel export; entry point for consumers of @astryxdesign/vega
*
* SYNC: When modified, update /packages/vega/README.md
@@ -12,7 +12,7 @@
/**
* @file index.ts
* @input All public exports for @astryxdesign/vega
- * @output Public API surface for the XDS Vega wrapper package
+ * @output Public API surface for the Astryx Vega wrapper package
* @position Barrel export; entry point for consumers of @astryxdesign/vega
*
* SYNC: When modified, update /packages/vega/README.md
diff --git a/packages/vega/src/types.ts b/packages/vega/src/types.ts
index 00abb921d4..95ab8a6775 100644
--- a/packages/vega/src/types.ts
+++ b/packages/vega/src/types.ts
@@ -2,7 +2,7 @@
/**
* @file types.ts
- * @input Vega and Vega-Lite spec types, and the XDS Vega wrapper API surface
+ * @input Vega and Vega-Lite spec types, and the Astryx Vega wrapper API surface
* @output Shared TypeScript types for @astryxdesign/vega
* @position Type definitions; imported by all components in this package
*
@@ -92,7 +92,7 @@ export type ViewData = Record<string, unknown[]>;
* `dangerouslySetInnerHTML`) for full DOM event passthrough — drag, pointer,
* keyboard, clipboard, `data-testid`, etc.
*
- * Note: unlike other XDS components, this component does not accept `xstyle`
+ * Note: unlike other Astryx components, this component does not accept `xstyle`
* because `@astryxdesign/vega` does not depend on StyleX. Use `className` or `style`
* for layout overrides instead.
*/
diff --git a/packages/vega/src/vegaLiteConfig.ts b/packages/vega/src/vegaLiteConfig.ts
index b81e9df16a..7222701f8e 100644
--- a/packages/vega/src/vegaLiteConfig.ts
+++ b/packages/vega/src/vegaLiteConfig.ts
@@ -2,12 +2,12 @@
/**
* @file vegaLiteConfig.ts
- * @input XDS theme tokens via useXDSTheme
- * @output Predefined Vega-Lite Config object for XDS-themed charts
+ * @input Astryx theme tokens via useTheme
+ * @output Predefined Vega-Lite Config object for Astryx-themed charts
* @position Utility module; consumed by VegaChart and exported standalone
*
- * Ported from the internal XDS data-viz config — structural config only.
- * Colors are wired through XDS data tokens (see domainTokens/dataTokens.ts).
+ * Ported from the internal Astryx data-viz config — structural config only.
+ * Colors are wired through Astryx data tokens (see domainTokens/dataTokens.ts).
*
* SYNC: When modified, update this header and /packages/lab/src/VegaChart/README.md
*/
@@ -49,7 +49,7 @@ type TokenResolver = (name: string) => string;
// ---------------------------------------------------------------------------
/**
- * Build a Vega-Lite `Config` object themed with XDS tokens.
+ * Build a Vega-Lite `Config` object themed with Astryx tokens.
*
* Call this inside a component that has access to `useXDSTheme()`:
*
@@ -60,7 +60,7 @@ type TokenResolver = (name: string) => string;
*
* The returned config sets axis styles, legend layout, line/point mark
* defaults, title typography, and view chrome — everything except color
- * scales (which are set via `range` using the XDS data-viz tokens).
+ * scales (which are set via `range` using the Astryx data-viz tokens).
*/
export function buildVegaLiteConfig(token: TokenResolver): VegaLiteConfig {
return {