@astryxdesign/core 0.1.2-canary.cac8ed5 → 0.1.2

package/dist/utils/dateTypes.d.ts

@@ -11,18 +11,6 @@
 export type ISODateString = `${number}${number}${number}${number}-${number}${number}-${number}${number}`;
 /** Day of week: 0 = Sunday through 6 = Saturday */
 export type DayOfWeek = 0 | 1 | 2 | 3 | 4 | 5 | 6;
-/**
- * Three-letter lowercase weekday name, 'sun' through 'sat'.
- * A more self-documenting alternative to the numeric {@link DayOfWeek}.
- */
-export type DayOfWeekName = 'sun' | 'mon' | 'tue' | 'wed' | 'thu' | 'fri' | 'sat';
-/**
- * Normalize a weekday to its numeric {@link DayOfWeek}. Accepts either a
- * number (0–6) or a three-letter day name ('sun'–'sat', case-insensitive),
- * so APIs like `weekStartsOn` can take whichever is more readable at the
- * call site. Unrecognized values fall back to 0 (Sunday).
- */
-export declare function normalizeDayOfWeek(value: DayOfWeek | DayOfWeekName): DayOfWeek;
 /** Immutable date record with 1-based month. */
 export interface PlainDate {
     readonly year: number;

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

@@ -1 +1 @@
-{"version":3,"file":"dateTypes.d.ts","sourceRoot":"","sources":["../../src/utils/dateTypes.ts"],"names":[],"mappings":"AAEA;;;;;GAKG;AAEH;;;GAGG;AACH,MAAM,MAAM,aAAa,GACvB,GAAG,MAAM,GAAG,MAAM,GAAG,MAAM,GAAG,MAAM,IAAI,MAAM,GAAG,MAAM,IAAI,MAAM,GAAG,MAAM,EAAE,CAAC;AAE/E,mDAAmD;AACnD,MAAM,MAAM,SAAS,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;AAElD;;;GAGG;AACH,MAAM,MAAM,aAAa,GACrB,KAAK,GACL,KAAK,GACL,KAAK,GACL,KAAK,GACL,KAAK,GACL,KAAK,GACL,KAAK,CAAC;AAaV;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAChC,KAAK,EAAE,SAAS,GAAG,aAAa,GAC/B,SAAS,CAMX;AAED,gDAAgD;AAChD,MAAM,WAAW,SAAS;IACxB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,2CAA2C;IAC3C,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;CACtB;AAED,0CAA0C;AAC1C,MAAM,WAAW,SAAS;IACxB,KAAK,EAAE,aAAa,CAAC;IACrB,GAAG,EAAE,aAAa,CAAC;CACpB"}
+{"version":3,"file":"dateTypes.d.ts","sourceRoot":"","sources":["../../src/utils/dateTypes.ts"],"names":[],"mappings":"AAEA;;;;;GAKG;AAEH;;;GAGG;AACH,MAAM,MAAM,aAAa,GACvB,GAAG,MAAM,GAAG,MAAM,GAAG,MAAM,GAAG,MAAM,IAAI,MAAM,GAAG,MAAM,IAAI,MAAM,GAAG,MAAM,EAAE,CAAC;AAE/E,mDAAmD;AACnD,MAAM,MAAM,SAAS,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;AAElD,gDAAgD;AAChD,MAAM,WAAW,SAAS;IACxB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,2CAA2C;IAC3C,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;CACtB;AAED,0CAA0C;AAC1C,MAAM,WAAW,SAAS;IACxB,KAAK,EAAE,aAAa,CAAC;IACrB,GAAG,EAAE,aAAa,CAAC;CACpB"}

package/dist/utils/dateTypes.js

@@ -1,41 +1 @@
-// Copyright (c) Meta Platforms, Inc. and affiliates.
-
-/**
- * @file dateTypes.ts
- * @input None
- * @output Shared date type definitions used across Calendar, DateInput, and other components
- * @position Core type definitions; imported by Calendar, DateInput, DateRangeInput, DateTimeInput, plainDate, dateParser
- */
-
-/**
- * ISO 8601 date string in YYYY-MM-DD format.
- * Example: "2026-01-28"
- */
-
-/** Day of week: 0 = Sunday through 6 = Saturday */
-
-/**
- * Three-letter lowercase weekday name, 'sun' through 'sat'.
- * A more self-documenting alternative to the numeric {@link DayOfWeek}.
- */
-
-/** Weekday names indexed by {@link DayOfWeek} (0 = Sunday). */
-const WEEKDAY_NAMES = ['sun', 'mon', 'tue', 'wed', 'thu', 'fri', 'sat'];
-
-/**
- * Normalize a weekday to its numeric {@link DayOfWeek}. Accepts either a
- * number (0–6) or a three-letter day name ('sun'–'sat', case-insensitive),
- * so APIs like `weekStartsOn` can take whichever is more readable at the
- * call site. Unrecognized values fall back to 0 (Sunday).
- */
-export function normalizeDayOfWeek(value) {
-  if (typeof value === 'number') {
-    return value;
-  }
-  const index = WEEKDAY_NAMES.indexOf(value.toLowerCase());
-  return index === -1 ? 0 : index;
-}
-
-/** Immutable date record with 1-based month. */
-
-/** Date range with start and end dates */
+export {};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@astryxdesign/core",
-  "version": "0.1.2-canary.cac8ed5",
+  "version": "0.1.2",
   "displayName": "XDS Core",
   "description": "The component library. Accessible, themeable React components with built-in spacing, dark mode, and StyleX styling.",
   "author": "Meta Open Source",

package/src/Calendar/Calendar.doc.mjs

@@ -103,8 +103,8 @@ export const docs = {
     },
     {
       name: 'weekStartsOn',
-      type: "0 | 1 | 2 | 3 | 4 | 5 | 6 | 'sun' | 'mon' | 'tue' | 'wed' | 'thu' | 'fri' | 'sat'",
-      description: 'First day of week. Accepts a number (0=Sunday) or a three-letter day name (e.g. "mon").',
+      type: '0 | 1 | 2 | 3 | 4 | 5 | 6',
+      description: 'First day of week (0=Sunday).',
       default: '0',
     },
   ],
@@ -147,7 +147,7 @@ export const docsZh = {
     {name: 'hasOutsideDays', type: 'boolean', description: '显示相邻月份的日期。', default: 'true'},
     {name: 'hasWeekNumbers', type: 'boolean', description: '显示 ISO 周数。', default: 'false'},
     {name: 'hasVariableRowCount', type: 'boolean', description: '可变行数与固定 6 行网格。', default: 'false'},
-    {name: 'weekStartsOn', type: "0 | 1 | 2 | 3 | 4 | 5 | 6 | 'sun'…'sat'", description: '每周起始日。可为数字（0=周日）或三字母星期缩写（如 "mon"）。', default: '0'},
+    {name: 'weekStartsOn', type: '0 | 1 | 2 | 3 | 4 | 5 | 6', description: '每周起始日（0=周日）。', default: '0'},
   ],
   theming: {
     targets: [
@@ -200,6 +200,6 @@ export const docsDense = {
     hasOutsideDays: 'show days from adjacent months',
     hasWeekNumbers: 'show ISO week numbers',
     hasVariableRowCount: 'variable vs fixed 6-row grid',
-    weekStartsOn: 'first day of week (0=Sunday, or name e.g. "mon")',
+    weekStartsOn: 'first day of week (0=Sunday)',
   },
 };

package/src/Calendar/Calendar.test.tsx

@@ -146,7 +146,10 @@ describe('Calendar', () => {
     const handleFocusChange = vi.fn();
 
     render(
-      <Calendar focusDate="2026-01-01" onFocusDateChange={handleFocusChange} />,
+      <Calendar
+        focusDate="2026-01-01"
+        onFocusDateChange={handleFocusChange}
+      />,
     );
 
     const nextButton = screen.getByRole('button', {name: 'Next month'});
@@ -186,7 +189,9 @@ describe('Calendar', () => {
       return day !== 0 && day !== 6;
     };
 
-    render(<Calendar focusDate="2026-01-01" dateConstraints={[isWeekday]} />);
+    render(
+      <Calendar focusDate="2026-01-01" dateConstraints={[isWeekday]} />,
+    );
 
     // January 4, 2026 is a Sunday - should be disabled
     const sunday = getDayButton(4);
@@ -233,21 +238,6 @@ describe('Calendar', () => {
     expect(dayNames[0]).toHaveTextContent('Mo');
   });
 
-  it('accepts a three-letter day name for weekStartsOn', () => {
-    render(<Calendar weekStartsOn="mon" />);
-
-    // "mon" should behave exactly like the numeric 1 (Monday first).
-    const dayNames = screen.getAllByText(/^(Mo|Tu|We|Th|Fr|Sa|Su)$/);
-    expect(dayNames[0]).toHaveTextContent('Mo');
-  });
-
-  it('treats weekStartsOn day names case-insensitively', () => {
-    render(<Calendar weekStartsOn={'WED' as 'wed'} />);
-
-    const dayNames = screen.getAllByText(/^(Mo|Tu|We|Th|Fr|Sa|Su)$/);
-    expect(dayNames[0]).toHaveTextContent('We');
-  });
-
   // ─── Range Mode ──────────────────────────────────────────────
 
   it('supports range selection mode', async () => {
@@ -255,7 +245,11 @@ describe('Calendar', () => {
     const handleChange = vi.fn();
 
     render(
-      <Calendar mode="range" onChange={handleChange} focusDate="2026-01-01" />,
+      <Calendar
+        mode="range"
+        onChange={handleChange}
+        focusDate="2026-01-01"
+      />,
     );
 
     // Click start date
@@ -277,7 +271,11 @@ describe('Calendar', () => {
     const handleChange = vi.fn();
 
     render(
-      <Calendar mode="range" onChange={handleChange} focusDate="2026-01-01" />,
+      <Calendar
+        mode="range"
+        onChange={handleChange}
+        focusDate="2026-01-01"
+      />,
     );
 
     // Click later date first
@@ -348,7 +346,10 @@ describe('Calendar', () => {
     const handleFocusChange = vi.fn();
 
     render(
-      <Calendar focusDate="2026-01-01" onFocusDateChange={handleFocusChange} />,
+      <Calendar
+        focusDate="2026-01-01"
+        onFocusDateChange={handleFocusChange}
+      />,
     );
 
     // Focus Jan 28
@@ -413,7 +414,11 @@ describe('Calendar', () => {
     const handleChange = vi.fn();
 
     render(
-      <Calendar mode="range" onChange={handleChange} focusDate="2026-01-01" />,
+      <Calendar
+        mode="range"
+        onChange={handleChange}
+        focusDate="2026-01-01"
+      />,
     );
 
     // Click start date to begin range selection

package/src/Calendar/Calendar.tsx

@@ -70,19 +70,8 @@ import {
 // Types
 // =============================================================================
 
-export type {
-  ISODateString,
-  DayOfWeek,
-  DayOfWeekName,
-  DateRange,
-} from '../utils/dateTypes';
-import type {
-  ISODateString,
-  DayOfWeek,
-  DayOfWeekName,
-  DateRange,
-} from '../utils/dateTypes';
-import {normalizeDayOfWeek} from '../utils/dateTypes';
+export type {ISODateString, DayOfWeek, DateRange} from '../utils/dateTypes';
+import type {ISODateString, DayOfWeek, DateRange} from '../utils/dateTypes';
 import {themeProps} from '../utils/themeProps';
 
 /** Imperative handle for Calendar handleRef */
@@ -145,11 +134,10 @@ interface CalendarBaseProps extends Omit<
   hasVariableRowCount?: boolean;
 
   /**
-   * First day of week. Accepts a number (0 = Sunday … 6 = Saturday) or a
-   * three-letter day name ('sun'–'sat', case-insensitive) for readability.
+   * First day of week.
    * Default: 0 (Sunday)
    */
-  weekStartsOn?: DayOfWeek | DayOfWeekName;
+  weekStartsOn?: DayOfWeek;
 }
 
 // ─── Mode-specific Props (discriminated union) ────────────────
@@ -212,17 +200,13 @@ export function Calendar({ref, ...props}: CalendarProps) {
     hasOutsideDays = true,
     hasWeekNumbers = false,
     hasVariableRowCount = false,
-    weekStartsOn: weekStartsOnProp = 0,
+    weekStartsOn = 0,
     xstyle,
     className,
     style,
     ...rest
   } = props;
 
-  // Normalize `weekStartsOn` (number or three-letter day name) to a numeric
-  // DayOfWeek so all downstream date math keeps working with an index.
-  const weekStartsOn = normalizeDayOfWeek(weekStartsOnProp);
-
   // Today's date (memoized)
   const today = useMemo(() => plainDateToday(), []);
 

package/src/Calendar/index.ts

@@ -17,7 +17,6 @@ export type {
   CalendarHandle,
   ISODateString,
   DayOfWeek,
-  DayOfWeekName,
   DateRange,
 } from './Calendar';
 

package/src/Dialog/Dialog.doc.mjs

@@ -40,13 +40,13 @@ export const docs = {
     {
       name: 'isOpen',
       type: 'boolean',
-      description: 'Whether the dialog is open.',
+      description: 'Whether the dialog is open (required).',
       required: true,
     },
     {
       name: 'onOpenChange',
       type: '(isOpen: boolean) => unknown',
-      description: 'Callback when dialog visibility changes.',
+      description: 'Callback when dialog visibility changes (required).',
       required: true,
     },
     {

package/src/Table/useTableColumnResize.doc.mjs

@@ -19,7 +19,7 @@ export const docs = {
       name: 'onColumnResizeEnd',
       type: '(updates: Record<string, number>) => void',
       description:
-        'Called when a resize completes (pointerup / Enter). Receives a map of every column key whose width changed; merge it into your columnWidths state.',
+        'Called when a resize completes (pointerup / Enter). Receives a map of every column key whose width changed — merge it into your columnWidths state.',
     },
     {
       name: 'minWidth',
@@ -37,7 +37,7 @@ export const docs = {
       name: 'columns',
       type: 'TableColumn<T>[]',
       description:
-        'Column definitions, needed to derive per-column min widths and detect proportional vs pixel columns for neighbor/last-column resize behavior.',
+        'Column definitions — needed to derive per-column min widths and detect proportional vs pixel columns for neighbor/last-column resize behavior.',
     },
   ],
 };
@@ -91,6 +91,6 @@ export const docsDense = {
     minWidth: 'Global min column width (px) during resize.',
     maxWidth: 'Global max column width (px) during resize. Default Infinity.',
     columns:
-      'Column defs: derive per-column mins + proportional/pixel detection for neighbor/last-column behavior.',
+      'Column defs — derive per-column mins + proportional/pixel detection for neighbor/last-column behavior.',
   },
 };

package/src/Table/useTableStickyColumns.doc.mjs

@@ -13,13 +13,13 @@ export const docs = {
       name: 'startKeys',
       type: 'string[]',
       description:
-        'Column keys pinned to the start (inline-start / left in LTR) edge: the contiguous run from the first column through the last listed key.',
+        'Column keys pinned to the start (inline-start / left in LTR) edge — the contiguous run from the first column through the last listed key.',
     },
     {
       name: 'endKeys',
       type: 'string[]',
       description:
-        'Column keys pinned to the end (inline-end / right in LTR) edge: the contiguous run from the first listed key through the last column.',
+        'Column keys pinned to the end (inline-end / right in LTR) edge — the contiguous run from the first listed key through the last column.',
     },
   ],
 };

package/src/utils/dateTypes.ts

@@ -17,46 +17,6 @@ export type ISODateString =
 /** Day of week: 0 = Sunday through 6 = Saturday */
 export type DayOfWeek = 0 | 1 | 2 | 3 | 4 | 5 | 6;
 
-/**
- * Three-letter lowercase weekday name, 'sun' through 'sat'.
- * A more self-documenting alternative to the numeric {@link DayOfWeek}.
- */
-export type DayOfWeekName =
-  | 'sun'
-  | 'mon'
-  | 'tue'
-  | 'wed'
-  | 'thu'
-  | 'fri'
-  | 'sat';
-
-/** Weekday names indexed by {@link DayOfWeek} (0 = Sunday). */
-const WEEKDAY_NAMES: ReadonlyArray<DayOfWeekName> = [
-  'sun',
-  'mon',
-  'tue',
-  'wed',
-  'thu',
-  'fri',
-  'sat',
-];
-
-/**
- * Normalize a weekday to its numeric {@link DayOfWeek}. Accepts either a
- * number (0–6) or a three-letter day name ('sun'–'sat', case-insensitive),
- * so APIs like `weekStartsOn` can take whichever is more readable at the
- * call site. Unrecognized values fall back to 0 (Sunday).
- */
-export function normalizeDayOfWeek(
-  value: DayOfWeek | DayOfWeekName,
-): DayOfWeek {
-  if (typeof value === 'number') {
-    return value;
-  }
-  const index = WEEKDAY_NAMES.indexOf(value.toLowerCase() as DayOfWeekName);
-  return index === -1 ? 0 : (index as DayOfWeek);
-}
-
 /** Immutable date record with 1-based month. */
 export interface PlainDate {
   readonly year: number;

package/src/utils/dateTypes.test.ts

@@ -1,40 +0,0 @@
-// Copyright (c) Meta Platforms, Inc. and affiliates.
-
-/**
- * @file dateTypes.test.ts
- * @input Uses vitest
- * @output Test suite for date type helpers
- * @position Tests for dateTypes.ts (normalizeDayOfWeek)
- *
- * SYNC: When dateTypes.ts changes, update tests accordingly
- */
-
-import {describe, it, expect} from 'vitest';
-import {normalizeDayOfWeek} from './dateTypes';
-
-describe('normalizeDayOfWeek', () => {
-  it('passes numeric days through unchanged', () => {
-    expect(normalizeDayOfWeek(0)).toBe(0);
-    expect(normalizeDayOfWeek(1)).toBe(1);
-    expect(normalizeDayOfWeek(6)).toBe(6);
-  });
-
-  it('maps three-letter day names to their index', () => {
-    expect(normalizeDayOfWeek('sun')).toBe(0);
-    expect(normalizeDayOfWeek('mon')).toBe(1);
-    expect(normalizeDayOfWeek('tue')).toBe(2);
-    expect(normalizeDayOfWeek('wed')).toBe(3);
-    expect(normalizeDayOfWeek('thu')).toBe(4);
-    expect(normalizeDayOfWeek('fri')).toBe(5);
-    expect(normalizeDayOfWeek('sat')).toBe(6);
-  });
-
-  it('is case-insensitive for day names', () => {
-    expect(normalizeDayOfWeek('MON' as 'mon')).toBe(1);
-    expect(normalizeDayOfWeek('Sat' as 'sat')).toBe(6);
-  });
-
-  it('falls back to 0 (Sunday) for an unrecognized name', () => {
-    expect(normalizeDayOfWeek('xyz' as 'mon')).toBe(0);
-  });
-});