@astryxdesign/core 0.0.15 → 0.1.0-canary.08d4cf4

package/src/docs-types.ts

@@ -76,7 +76,7 @@ export interface PropDoc {
  * A theming target — a stable selector surface that `defineTheme` can target
  * via `@scope` selectors. Each component renders one or more stable `xds-*`
  * class names and reflects visual props/states as `data-*` attributes via
- * `xdsThemeProps()`, so themes and external CSS have an explicit prop-aware selector surface.
+ * `themeProps()`, so themes and external CSS have an explicit prop-aware selector surface.
  *
  * @example
  * ```
@@ -91,7 +91,7 @@ export interface ThemingTarget {
    *  e.g. `"astryx-button"`, `"astryx-avatar-status-dot"`, `"astryx-card"` */
   className: string;
   /** Visual prop names reflected on this element.
-   *  These are the props passed to `xdsThemeProps()` as the second argument.
+   *  These are the props passed to `themeProps()` as the second argument.
    *  Use these names to derive preferred data selectors: `variant` →
    *  `[data-variant="secondary"]`, `level` → `[data-level="2"]`. Legacy bare
    *  classes are still emitted for compatibility but should not be the primary
@@ -494,7 +494,7 @@ interface BaseDoc {
      *  `--layout-padding-*` tokens instead of emitting raw CSS. */
     container?: boolean;
     /** Selector targets rendered by this component.
-     *  Each entry corresponds to an `xdsThemeProps()` call in the source. */
+     *  Each entry corresponds to an `themeProps()` call in the source. */
     targets: ThemingTarget[];
     /** CSS custom properties exposed for theming. */
     vars?: ComponentVar[];

package/src/hooks/useEntryAnimation.doc.mjs

@@ -23,7 +23,7 @@ export const docs = {
   ],
   usage: {
     description:
-      'Returns a StyleX style for animating an element on mount. Only animates when the element is dynamically inserted after the initial page paint; elements rendered on page load are not animated. Uses XDS motion tokens (duration, easing) for consistent animation timing. Requires "use client"; does not support SSR.',
+      'Returns a StyleX style for animating an element on mount. Only animates when the element is dynamically inserted after the initial page paint; elements rendered on page load are not animated. Uses Astryx motion tokens (duration, easing) for consistent animation timing. Requires "use client"; does not support SSR.',
     bestPractices: [
       { guidance: true, description: 'Use for conditionally rendered elements like validation messages, toasts, or expanding sections.' },
       { guidance: true, description: 'Spread the returned style into stylex.props() alongside other styles.' },
@@ -39,7 +39,7 @@ export const docs = {
 /** @type {import('../docs-types').HookTranslationDoc} */
 export const docsDense = {
   description:
-    'Returns StyleX style for animating element on mount. Only animates when element dynamically inserted after initial page paint; elements rendered on page load not animated. Uses XDS motion tokens (duration, easing) for consistent timing. Requires "use client"; does not support SSR.',
+    'Returns StyleX style for animating element on mount. Only animates when element dynamically inserted after initial page paint; elements rendered on page load not animated. Uses Astryx motion tokens (duration, easing) for consistent timing. Requires "use client"; does not support SSR.',
   paramDescriptions: {
     preset: 'animation preset applied on mount.',
   },
@@ -48,7 +48,7 @@ export const docsDense = {
   },
   usage: {
     description:
-      'Returns StyleX style for animating element on mount. Only animates when element dynamically inserted after initial page paint; elements rendered on page load not animated. Uses XDS motion tokens (duration, easing) for consistent timing. Requires "use client"; does not support SSR.',
+      'Returns StyleX style for animating element on mount. Only animates when element dynamically inserted after initial page paint; elements rendered on page load not animated. Uses Astryx motion tokens (duration, easing) for consistent timing. Requires "use client"; does not support SSR.',
     bestPractices: [
       { guidance: true, description: 'Use for conditionally rendered elements like validation messages, toasts, expanding sections.' },
       { guidance: true, description: 'Spread returned style into stylex.props() alongside other styles.' },

package/src/hooks/useMediaQuery.doc.mjs

@@ -24,7 +24,7 @@ export const docs = {
     description: 'SSR-safe media query hook that subscribes to window.matchMedia changes. Returns whether the given media query matches. Always returns false on first render for SSR compatibility.',
     bestPractices: [
       { guidance: true, description: 'Use for responsive layout switching based on viewport width, color scheme, or motion preferences.' },
-      { guidance: true, description: 'Prefer XDS responsive tokens and component props over manual breakpoint logic when possible.' },
+      { guidance: true, description: 'Prefer Astryx responsive tokens and component props over manual breakpoint logic when possible.' },
       { guidance: false, description: 'Use for server-rendered content that must match on first paint; the hook always returns false initially.' },
     ],
   },
@@ -47,7 +47,7 @@ export const docsDense = {
     description: 'SSR-safe media query hook subscribing to window.matchMedia changes. Returns whether given media query matches. Always returns false on first render for SSR compatibility.',
     bestPractices: [
       { guidance: true, description: 'Use for responsive layout switching based on viewport width, color scheme, or motion preferences.' },
-      { guidance: true, description: 'Prefer XDS responsive tokens + component props over manual breakpoint logic when possible.' },
+      { guidance: true, description: 'Prefer Astryx responsive tokens + component props over manual breakpoint logic when possible.' },
       { guidance: false, description: 'Use for server-rendered content that must match on first paint; hook always returns false initially.' },
     ],
   },

package/src/hooks/useStreamingText.doc.mjs

@@ -41,7 +41,7 @@ export const docs = {
   ],
   usage: {
     description:
-      'Smooths bursty streamed text into a steady character-by-character reveal using requestAnimationFrame. Decouples arrival rate from display rate. Advances on word and syntax boundaries to avoid slicing mid-markdown or mid-word, preventing visual glitches with markdown renderers. Animation timing derives from XDS motion tokens via useTheme when available, with sensible fallbacks outside a theme provider. Snaps to full text when isStreaming becomes false.',
+      'Smooths bursty streamed text into a steady character-by-character reveal using requestAnimationFrame. Decouples arrival rate from display rate. Advances on word and syntax boundaries to avoid slicing mid-markdown or mid-word, preventing visual glitches with markdown renderers. Animation timing derives from Astryx motion tokens via useTheme when available, with sensible fallbacks outside a theme provider. Snaps to full text when isStreaming becomes false.',
     bestPractices: [
       { guidance: true, description: 'Pass the accumulated text (not individual chunks) as targetText; the hook handles incremental reveal internally.' },
       { guidance: true, description: 'Set isStreaming to false when the stream completes to snap to the final text.' },
@@ -58,7 +58,7 @@ export const docs = {
 /** @type {import('../docs-types').HookTranslationDoc} */
 export const docsDense = {
   description:
-    'Smooths bursty streamed text into steady character-by-character reveal using requestAnimationFrame. Decouples arrival rate from display rate. Advances on word + syntax boundaries to avoid slicing mid-markdown / mid-word, preventing visual glitches w/ markdown renderers. Animation timing derives from XDS motion tokens via useTheme when available, w/ sensible fallbacks outside theme provider. Snaps to full text when isStreaming becomes false.',
+    'Smooths bursty streamed text into steady character-by-character reveal using requestAnimationFrame. Decouples arrival rate from display rate. Advances on word + syntax boundaries to avoid slicing mid-markdown / mid-word, preventing visual glitches w/ markdown renderers. Animation timing derives from Astryx motion tokens via useTheme when available, w/ sensible fallbacks outside theme provider. Snaps to full text when isStreaming becomes false.',
   paramDescriptions: {
     targetText: 'full target text to reveal. As new chunks arrive, update this value w/ accumulated text.',
     isStreaming: 'whether text currently being streamed. When false, hook returns full targetText immediately.',
@@ -70,7 +70,7 @@ export const docsDense = {
   },
   usage: {
     description:
-      'Smooths bursty streamed text into steady character-by-character reveal using requestAnimationFrame. Decouples arrival rate from display rate. Advances on word + syntax boundaries to avoid slicing mid-markdown / mid-word, preventing visual glitches w/ markdown renderers. Animation timing derives from XDS motion tokens via useTheme when available, w/ sensible fallbacks outside theme provider. Snaps to full text when isStreaming becomes false.',
+      'Smooths bursty streamed text into steady character-by-character reveal using requestAnimationFrame. Decouples arrival rate from display rate. Advances on word + syntax boundaries to avoid slicing mid-markdown / mid-word, preventing visual glitches w/ markdown renderers. Animation timing derives from Astryx motion tokens via useTheme when available, w/ sensible fallbacks outside theme provider. Snaps to full text when isStreaming becomes false.',
     bestPractices: [
       { guidance: true, description: 'Pass accumulated text (not individual chunks) as targetText; hook handles incremental reveal internally.' },
       { guidance: true, description: 'Set isStreaming to false when stream completes to snap to final text.' },

package/src/naming.ts

@@ -27,7 +27,7 @@
  * - CSS custom properties: `--astryx-*` via {@link cssVarNamespace} / {@link cssVar}.
  * - CSS layers: `astryx-base` / `astryx-theme`.
  *
- * SYNC: packages/core/src/utils/xdsThemeProps.ts (consumes classPrefix)
+ * SYNC: packages/core/src/utils/themeProps.ts (consumes classPrefix)
  * SYNC: packages/core/src/utils/parseStyleKey.ts
  * SYNC: packages/cli/src/commands/build-theme.mjs (imports @astryxdesign/core/naming)
  */

package/src/reset.css

@@ -23,7 +23,7 @@
  * 2. Combine with base styles and theme:
  *    import '@astryxdesign/core/reset.css';        // @layer reset  — clean slate
  *    import '@astryxdesign/core/astryx.css';        // @layer astryx-base — component styles
- *    import '@astryxdesign/theme-default/theme.css'; // @layer astryx-theme — theme overrides
+ *    import '@astryxdesign/theme-neutral/theme.css'; // @layer astryx-theme — theme overrides
  *
  * Layer order: reset → astryx-base → astryx-theme
  * Consumer styles (unlayered) always override all Astryx layers.

package/src/tailwind-theme.css

@@ -20,7 +20,7 @@
  *   @import "tailwindcss/preflight.css" layer(base);
  *   @import "@astryxdesign/core/reset.css";
  *   @import "@astryxdesign/core/astryx.css";
- *   @import "@astryxdesign/theme-default/theme.css";
+ *   @import "@astryxdesign/theme-neutral/theme.css";
  *   @import "@astryxdesign/core/tailwind-theme.css";
  *   @import "tailwindcss/utilities.css" layer(utilities);
  *

package/src/theme/Theme.doc.mjs

@@ -39,7 +39,7 @@ export const docs = {
   },
   usage: {
     description:
-      'Wraps a subtree with a specific XDS theme. For static production themes, use `npx astryx theme build` and import the generated CSS plus built theme object for first-paint and SSR performance. Use runtime `defineTheme()` when themes are dynamic or for prototyping.\n\n`defineTheme` accepts a `tokens` object whose keys are CSS custom property names (always prefixed with `--`). Common token names include `--color-accent`, `--color-background-surface`, `--color-background-body`, `--color-text-primary`, `--color-text-secondary`, `--radius-container`, `--spacing-1` through `--spacing-6`. Values can be a string (same for light/dark) or a `[light, dark]` tuple.\n\nExample:\n```ts\nimport {defineTheme} from \'@astryxdesign/core/theme\';\nconst myTheme = defineTheme({\n  name: \'ocean\',\n  tokens: {\n    \'--color-accent\': [\'#0077B6\', \'#48CAE4\'],\n    \'--color-background-surface\': [\'#F0F8FF\', \'#0A1628\'],\n    \'--color-text-primary\': [\'#0A1317\', \'#FFFFFF\'],\n    \'--radius-container\': \'16px\',\n  },\n});\n```',
+      'Wraps a subtree with a specific Astryx theme. For static production themes, use `npx astryx theme build` and import the generated CSS plus built theme object for first-paint and SSR performance. Use runtime `defineTheme()` when themes are dynamic or for prototyping.\n\n`defineTheme` accepts a `tokens` object whose keys are CSS custom property names (always prefixed with `--`). Common token names include `--color-accent`, `--color-background-surface`, `--color-background-body`, `--color-text-primary`, `--color-text-secondary`, `--radius-container`, `--spacing-1` through `--spacing-6`. Values can be a string (same for light/dark) or a `[light, dark]` tuple.\n\nExample:\n```ts\nimport {defineTheme} from \'@astryxdesign/core/theme\';\nconst myTheme = defineTheme({\n  name: \'ocean\',\n  tokens: {\n    \'--color-accent\': [\'#0077B6\', \'#48CAE4\'],\n    \'--color-background-surface\': [\'#F0F8FF\', \'#0A1628\'],\n    \'--color-text-primary\': [\'#0A1317\', \'#FFFFFF\'],\n    \'--radius-container\': \'16px\',\n  },\n});\n```',
     bestPractices: [
       {
         guidance: true,
@@ -90,7 +90,7 @@ export const docs = {
 export const docsDense = {
   usage: {
     description:
-      'Wraps subtree w/ specific XDS theme. For static production themes, use `npx astryx theme build` + generated CSS + built theme object for first-paint/SSR performance. Use runtime `defineTheme()` for dynamic themes or prototyping. Token names always start with `--` (e.g. `--color-accent`, `--color-background-surface`).',
+      'Wraps subtree w/ specific Astryx theme. For static production themes, use `npx astryx theme build` + generated CSS + built theme object for first-paint/SSR performance. Use runtime `defineTheme()` for dynamic themes or prototyping. Token names always start with `--` (e.g. `--color-accent`, `--color-background-surface`).',
     bestPractices: [
       {
         guidance: true,

package/src/theme/Theme.tsx

@@ -123,7 +123,7 @@ function useThemeStyleInjection(theme: DefinedTheme): void {
     if (!warnedThemes.has(theme.name)) {
       warnedThemes.add(theme.name);
       console.warn(
-        `[XDS] Theme "${theme.name}" is using runtime style injection. ` +
+        `[Astryx] Theme "${theme.name}" is using runtime style injection. ` +
           `For better performance, use the pre-built theme:\n\n` +
           `  import {${theme.name}Theme} from '@astryxdesign/theme-${theme.name}/built';\n` +
           `  import '@astryxdesign/theme-${theme.name}/theme.css';\n\n` +

package/src/theme/defineTheme.ts

@@ -173,11 +173,11 @@ export interface DefineThemeInput {
    *
    * @example
    * ```tsx
-   * import {defaultTheme} from '@astryxdesign/theme-default';
+   * import {neutralTheme} from '@astryxdesign/theme-neutral';
    *
    * const myTheme = defineTheme({
    *   name: 'my-brand',
-   *   extends: defaultTheme,
+   *   extends: neutralTheme,
    *   icons: myIcons,
    *   tokens: { '--color-accent': '#FF0000' },
    * });
@@ -361,7 +361,7 @@ export interface DefinedTheme {
 // =============================================================================
 
 /** All Astryx token defaults as a flat map. Useful for resolving full token sets. */
-export const xdsTokenDefaults: Record<string, string> = {
+export const tokenDefaults: Record<string, string> = {
   ...colorDefaults,
   ...spacingDefaults,
   ...sizeDefaults,

package/src/theme/index.ts

@@ -11,7 +11,7 @@
  * - Token exports for direct use in StyleX
  *
  * Themes are in separate packages:
- *   import { defaultTheme } from '@astryxdesign/theme-default';
+ *   import { neutralTheme } from '@astryxdesign/theme-neutral';
  *   import { neutralTheme } from '@astryxdesign/theme-neutral';
  */
 
@@ -28,7 +28,7 @@ export {
   type ThemeCSSOutput,
   type ThemeRulesSplit,
   isDefinedTheme,
-  xdsTokenDefaults,
+  tokenDefaults,
 } from './defineTheme';
 export type {
   DefineThemeInput,

package/src/theme/syntax/defineSyntaxTheme.ts

@@ -134,7 +134,7 @@ export function defineSyntaxTheme(input: SyntaxThemeInput): SyntaxThemeDefinitio
   const missing = ALL_SYNTAX_KEYS.filter(key => !(key in input.tokens));
   if (missing.length > 0) {
     console.warn(
-      '[XDS] defineSyntaxTheme("' + input.name + '"): missing tokens: ' +
+      '[Astryx] defineSyntaxTheme("' + input.name + '"): missing tokens: ' +
         missing.join(', ') + '. All 14 syntax tokens are required.',
     );
   }

package/src/theme/tokens.ts

@@ -16,7 +16,7 @@
  */
 
 import {
-  xdsTokenDefaults,
+  tokenDefaults,
   type DefinedTheme,
   type TokenName,
   type TokenValue,
@@ -60,7 +60,7 @@ export function tokenVar(name: TokenName | (string & {})): string {
 
 /** 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)]),
+  Object.keys(tokenDefaults).map(name => [name, tokenVar(name)]),
 ) as Record<TokenName, string>;
 
 /**
@@ -147,7 +147,7 @@ function resolveXDSTokenValue(
 /**
  * Resolve all Astryx token values for a theme and effective color mode.
  *
- * The result starts with `xdsTokenDefaults`, applies `theme.tokens`, then
+ * The result starts with `tokenDefaults`, applies `theme.tokens`, then
  * reapplies `theme.__inputTokens` when available so explicit tuple overrides
  * retain their original light/dark sides instead of relying on CSS parsing.
  * This mirrors the token resolution used by `useTheme()` but does not need
@@ -162,7 +162,7 @@ export function resolveThemeTokens(
   const {mode} = options;
   const resolved: Record<string, string> = {};
 
-  for (const [key, value] of Object.entries(xdsTokenDefaults)) {
+  for (const [key, value] of Object.entries(tokenDefaults)) {
     resolved[key] = resolveXDSTokenValue(value, mode);
   }
 

package/src/theme/useTheme.ts

@@ -63,7 +63,7 @@ export interface UseThemeReturn {
    * For tokens with [light, dark] tuples, returns the value matching
    * the current mode. For single-value tokens, returns the value as-is.
    *
-   * Falls back to xdsTokenDefaults if the token isn't overridden by the theme.
+   * Falls back to tokenDefaults if the token isn't overridden by the theme.
    *
    * @example
    * ```
@@ -75,7 +75,7 @@ export interface UseThemeReturn {
   /**
    * All tokens resolved for the current color mode.
    *
-   * Merges xdsTokenDefaults with the theme's overrides, resolving
+   * Merges tokenDefaults with the theme's overrides, resolving
    * light-dark() values based on the effective color mode.
    *
    * Memoized — stable reference unless theme or mode changes.

package/src/utils/dateParser.test.ts

@@ -320,5 +320,31 @@ describe('parseDateInput', () => {
     it('rejects mixed separators', () => {
       expect(parseDateInput('1/25.2026')).toBeNull();
     });
+
+    it('treats a single typed digit as incomplete, not a date', () => {
+      // A user starting to type a month (e.g. "0" or "1" for January) should
+      // not produce a date. Native Date parsing would otherwise coerce these
+      // into arbitrary dates (and a year of 0 in some engines).
+      expect(parseDateInput('0')).toBeNull();
+      expect(parseDateInput('1')).toBeNull();
+    });
+
+    it('treats bare numeric input as incomplete, not a date', () => {
+      expect(parseDateInput('00')).toBeNull();
+      expect(parseDateInput('01')).toBeNull();
+      expect(parseDateInput('12')).toBeNull();
+      expect(parseDateInput('2026')).toBeNull();
+    });
+
+    it('never returns an out-of-range date for partial input', () => {
+      // Regression: partial input must never yield a date with year < 1,
+      // which would throw when later re-parsed and crash the page.
+      for (const input of ['0', '1', '01', '00', '9', '99']) {
+        const result = parseDateInput(input);
+        if (result !== null) {
+          expect(result.year).toBeGreaterThanOrEqual(1);
+        }
+      }
+    });
   });
 });

package/src/utils/dateParser.ts

@@ -124,10 +124,24 @@ export function parseDateInput(input: string): PlainDate | null {
     return parseNumericDate(+first, +second, currentYear);
   }
 
-  // 6. Fall back to native Date parsing for other formats
+  // 6. Fall back to native Date parsing for other formats.
+  //
+  // Skip bare numeric input (e.g. "0", "1", "01", "2026"). These are
+  // in-progress values a user is still typing, not complete dates. Native
+  // `Date` parsing coerces them into arbitrary dates ("0" -> year 2000 in V8,
+  // year 0 in some engines), which is both surprising and — when the year
+  // resolves to 0 — produces an out-of-range date that throws downstream.
+  // Treat them as not-yet-a-valid-date instead.
+  if (/^\d+$/.test(trimmed)) {
+    return null;
+  }
+
   const parsed = new Date(trimmed);
   if (!isNaN(parsed.getTime())) {
-    return plainDateFromDate(parsed);
+    const fromDate = plainDateFromDate(parsed);
+    // Validate the result so we never return an out-of-range date (e.g. a
+    // year of 0), which would throw when later re-parsed.
+    return tryCreatePlainDate(fromDate.year, fromDate.month, fromDate.day);
   }
 
   return null;

package/src/utils/mergeProps.ts

@@ -4,7 +4,7 @@
  * Merge xds-* props, stylex.props result, and optional consumer className/style.
  *
  * stylex.props() returns { className, style }. This merges the Astryx stable
- * class name plus any data-attribute reflection from `xdsThemeProps()` with the
+ * class name plus any data-attribute reflection from `themeProps()` with the
  * StyleX class name so both StyleX styles and the theme-targeting surface are
  * applied.
  *
@@ -13,9 +13,9 @@
  *
  * @example
  * ```tsx
- * // Root element with xdsThemeProps
+ * // Root element with themeProps
  * <div {...mergeProps(
- *   xdsThemeProps('button', { variant }),
+ *   themeProps('button', { variant }),
  *   stylex.props(styles.base, variants[variant]),
  *   className,
  *   style,
@@ -66,7 +66,7 @@ export function mergeProps(
   style?: React.CSSProperties,
 ): PropsObject {
   // Disambiguate: first arg is string → (xdsClass, stylexResult, className?, style?)
-  // first arg is object → merge arbitrary props (supports xdsThemeProps + data attrs).
+  // first arg is object → merge arbitrary props (supports themeProps + data attrs).
   if (typeof xdsClassOrStylexResult === 'string') {
     const xdsClass = xdsClassOrStylexResult;
     const stylexResult = (stylexResultOrClassName as PropsObject) ?? {

package/src/utils/parseStyleKey.ts

@@ -6,11 +6,11 @@
  * Used by both defineTheme (CSS generation) and components (class name rendering)
  * to ensure the same convention is applied consistently.
  *
- * <!-- SYNC: packages/core/src/utils/xdsThemeProps.ts -->
+ * <!-- SYNC: packages/core/src/utils/themeProps.ts -->
  *
  * Emits the legacy class-selector suffix used by defineTheme/component override
  * generation today. Components also reflect the same prop values as data
- * attributes via `xdsThemeProps()` (`variant:secondary` renders both `.secondary`
+ * attributes via `themeProps()` (`variant:secondary` renders both `.secondary`
  * and `[data-variant="secondary"]` in the DOM), but generated theme CSS still
  * uses these class selectors until the selector contract migrates fully.
  *

package/src/utils/{xdsThemeProps.test.ts → themeProps.test.ts}

@@ -1,44 +1,44 @@
 // Copyright (c) Meta Platforms, Inc. and affiliates.
 
 import {describe, it, expect} from 'vitest';
-import {xdsThemeDataAttributes, xdsThemeProps} from './xdsThemeProps';
+import {themeDataAttributes, themeProps} from './themeProps';
 
-describe('xdsThemeProps', () => {
+describe('themeProps', () => {
   it('returns base class for component', () => {
-    expect(xdsThemeProps('card').className).toBe('astryx-card');
+    expect(themeProps('card').className).toBe('astryx-card');
   });
 
   it('adds variant classes', () => {
     expect(
-      xdsThemeProps('button', {variant: 'secondary', size: 'sm'}).className,
+      themeProps('button', {variant: 'secondary', size: 'sm'}).className,
     ).toBe('astryx-button secondary sm');
   });
 
   it('prefixes numeric values with prop name', () => {
-    expect(xdsThemeProps('heading', {level: 1}).className).toBe(
+    expect(themeProps('heading', {level: 1}).className).toBe(
       'astryx-heading level-1',
     );
   });
 
   it('skips null and undefined props', () => {
     expect(
-      xdsThemeProps('button', {variant: 'primary', size: undefined}).className,
+      themeProps('button', {variant: 'primary', size: undefined}).className,
     ).toBe('astryx-button primary');
   });
 
   it('works with no props', () => {
-    expect(xdsThemeProps('divider').className).toBe('astryx-divider');
+    expect(themeProps('divider').className).toBe('astryx-divider');
   });
 
   it('handles string numeric values', () => {
-    expect(xdsThemeProps('heading', {level: '3'}).className).toBe(
+    expect(themeProps('heading', {level: '3'}).className).toBe(
       'astryx-heading level-3',
     );
   });
 
   it('reflects visual props as data attributes', () => {
     expect(
-      xdsThemeDataAttributes({variant: 'secondary', size: 'sm', level: 2}),
+      themeDataAttributes({variant: 'secondary', size: 'sm', level: 2}),
     ).toEqual({
       'data-variant': 'secondary',
       'data-size': 'sm',
@@ -47,19 +47,19 @@ describe('xdsThemeProps', () => {
   });
 
   it('kebab-cases data attribute names', () => {
-    expect(xdsThemeDataAttributes({listStyle: 'ordered'})).toEqual({
+    expect(themeDataAttributes({listStyle: 'ordered'})).toEqual({
       'data-list-style': 'ordered',
     });
   });
 
   it('omits nullish data attributes', () => {
-    expect(xdsThemeDataAttributes({variant: 'primary', size: null})).toEqual({
+    expect(themeDataAttributes({variant: 'primary', size: null})).toEqual({
       'data-variant': 'primary',
     });
   });
 
   it('returns class and data attributes together', () => {
-    expect(xdsThemeProps('button', {variant: 'primary', size: 'sm'})).toEqual({
+    expect(themeProps('button', {variant: 'primary', size: 'sm'})).toEqual({
       className: 'astryx-button primary sm',
       'data-variant': 'primary',
       'data-size': 'sm',

package/src/utils/{xdsThemeProps.ts → themeProps.ts}

@@ -21,7 +21,7 @@ function classTokenForPropValue(prop: string, value: string): string {
  *
  * Every component renders a stable base class (`astryx-button`, `astryx-card`,
  * etc.) plus variant classes derived from visual props. Components also reflect
- * those visual props as data attributes via `xdsThemeProps()` (`data-variant`,
+ * those visual props as data attributes via `themeProps()` (`data-variant`,
  * `data-size`, `data-level`, etc.) so consumers target stable data-attribute
  * selectors rather than collision-prone bare class names.
  *
@@ -73,7 +73,7 @@ function buildClassName(component: string, props?: ClassProps): string {
  * literal prop values, including numeric values (`level: 1` → `data-level="1"`).
  * Nullish values are omitted.
  */
-export function xdsThemeDataAttributes(
+export function themeDataAttributes(
   props?: ClassProps,
 ): ThemeDataAttributes {
   const attrs: ThemeDataAttributes = {};
@@ -98,16 +98,16 @@ export function xdsThemeDataAttributes(
  * surface. For example:
  *
  * ```ts
- * xdsThemeProps('button', { variant: 'primary', size: 'sm' })
+ * themeProps('button', { variant: 'primary', size: 'sm' })
  * // → { className: 'astryx-button primary sm', data-variant: 'primary', data-size: 'sm' }
  * ```
  */
-export function xdsThemeProps(
+export function themeProps(
   component: string,
   props?: ClassProps,
 ): ThemeProps {
   return {
     className: buildClassName(component, props),
-    ...xdsThemeDataAttributes(props),
+    ...themeDataAttributes(props),
   };
 }

package/dist/DropdownMenu/renderXDSDropdownItems.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"renderXDSDropdownItems.d.ts","sourceRoot":"","sources":["../../src/DropdownMenu/renderXDSDropdownItems.tsx"],"names":[],"mappings":"AAEA;;;;GAIG;AAEH,OAAO,KAAK,EAAC,SAAS,EAAC,MAAM,OAAO,CAAC;AAUrC,OAAO,KAAK,EAEV,kBAAkB,EAEnB,MAAM,gBAAgB,CAAC;AAyBxB;;;GAGG;AACH,wBAAgB,sBAAsB,CACpC,KAAK,EAAE,kBAAkB,EAAE,GAC1B,SAAS,CA8CX"}

package/dist/utils/xdsThemeProps.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"xdsThemeProps.d.ts","sourceRoot":"","sources":["../../src/utils/xdsThemeProps.ts"],"names":[],"mappings":"AAIA,MAAM,MAAM,UAAU,GAAG,MAAM,GAAG,MAAM,GAAG,SAAS,GAAG,IAAI,CAAC;AAC5D,MAAM,MAAM,UAAU,GAAG,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;AACpD,MAAM,MAAM,mBAAmB,GAAG,MAAM,CAAC,QAAQ,MAAM,EAAE,EAAE,MAAM,GAAG,SAAS,CAAC,CAAC;AAC/E,MAAM,MAAM,UAAU,GAAG;IAAC,SAAS,EAAE,MAAM,CAAA;CAAC,GAAG,mBAAmB,CAAC;AA6DnE;;;;;;GAMG;AACH,wBAAgB,sBAAsB,CACpC,KAAK,CAAC,EAAE,UAAU,GACjB,mBAAmB,CAarB;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,aAAa,CAC3B,SAAS,EAAE,MAAM,EACjB,KAAK,CAAC,EAAE,UAAU,GACjB,UAAU,CAKZ"}