@astryxdesign/core 0.7.5 → 0.7.6-canary.0bd3b37

package/src/i18n/__tests__/useDirection.test.tsx

@@ -1,66 +0,0 @@
-// Copyright (c) Meta Platforms, Inc. and affiliates.
-
-/**
- * @file useDirection.test.tsx
- * @input packages/core/src/i18n/useDirection.ts, InternationalizationProvider
- * @output Unit tests for the ambient text-direction hook
- * @position Colocated tests; targets the default (no-provider) fallback,
- *   locale-derived direction, and the explicit `dir` override.
- */
-
-import type {ReactNode} from 'react';
-import {describe, expect, test} from 'vitest';
-import {renderHook} from '@testing-library/react';
-import {useDirection} from '../useDirection';
-import {InternationalizationProvider} from '../InternationalizationProvider';
-
-describe('useDirection', () => {
-  test('returns ltr when rendered without a provider', () => {
-    const {result} = renderHook(() => useDirection());
-    expect(result.current).toBe('ltr');
-  });
-
-  test('returns ltr under an English provider', () => {
-    const {result} = renderHook(() => useDirection(), {
-      wrapper: ({children}: {children: ReactNode}) => (
-        <InternationalizationProvider locale="en">
-          {children}
-        </InternationalizationProvider>
-      ),
-    });
-    expect(result.current).toBe('ltr');
-  });
-
-  test('returns rtl under an Arabic provider', () => {
-    const {result} = renderHook(() => useDirection(), {
-      wrapper: ({children}: {children: ReactNode}) => (
-        <InternationalizationProvider locale="ar">
-          {children}
-        </InternationalizationProvider>
-      ),
-    });
-    expect(result.current).toBe('rtl');
-  });
-
-  test('explicit dir="rtl" wins over an LTR locale', () => {
-    const {result} = renderHook(() => useDirection(), {
-      wrapper: ({children}: {children: ReactNode}) => (
-        <InternationalizationProvider locale="en" dir="rtl">
-          {children}
-        </InternationalizationProvider>
-      ),
-    });
-    expect(result.current).toBe('rtl');
-  });
-
-  test('explicit dir="ltr" wins over an RTL locale', () => {
-    const {result} = renderHook(() => useDirection(), {
-      wrapper: ({children}: {children: ReactNode}) => (
-        <InternationalizationProvider locale="ar" dir="ltr">
-          {children}
-        </InternationalizationProvider>
-      ),
-    });
-    expect(result.current).toBe('ltr');
-  });
-});

package/src/i18n/__tests__/useLocale.test.tsx

@@ -1,52 +0,0 @@
-// Copyright (c) Meta Platforms, Inc. and affiliates.
-
-/**
- * @file useLocale.test.tsx
- * @input packages/core/src/i18n/useLocale.ts, InternationalizationProvider
- * @output Unit tests for the internal provider-aware locale accessor
- * @position Colocated tests; targets the default (no-provider) fallback, the
- *   provider locale, and re-rendering when the provider locale changes.
- */
-
-import type {ReactNode} from 'react';
-import {describe, expect, test} from 'vitest';
-import {render, renderHook} from '@testing-library/react';
-import {useLocale} from '../useLocale';
-import {InternationalizationProvider} from '../InternationalizationProvider';
-
-describe('useLocale', () => {
-  test('returns en when rendered without a provider', () => {
-    const {result} = renderHook(() => useLocale());
-    expect(result.current).toBe('en');
-  });
-
-  test('returns the provider locale', () => {
-    const {result} = renderHook(() => useLocale(), {
-      wrapper: ({children}: {children: ReactNode}) => (
-        <InternationalizationProvider locale="fr">
-          {children}
-        </InternationalizationProvider>
-      ),
-    });
-    expect(result.current).toBe('fr');
-  });
-
-  test('re-renders with the new locale when the provider locale changes', () => {
-    function Probe() {
-      return <span data-testid="locale">{useLocale()}</span>;
-    }
-    const {getByTestId, rerender} = render(
-      <InternationalizationProvider locale="en">
-        <Probe />
-      </InternationalizationProvider>,
-    );
-    expect(getByTestId('locale').textContent).toBe('en');
-
-    rerender(
-      <InternationalizationProvider locale="ja-JP">
-        <Probe />
-      </InternationalizationProvider>,
-    );
-    expect(getByTestId('locale').textContent).toBe('ja-JP');
-  });
-});

package/src/i18n/useTranslator.test.tsx

@@ -1,267 +0,0 @@
-// Copyright (c) Meta Platforms, Inc. and affiliates.
-
-/**
- * @file useTranslator.test.tsx
- * @input Uses vitest, @testing-library/react, useTranslator hook, i18n provider
- * @output Unit tests for the client translator bound to the provider locale
- * @position Testing; validates useTranslator.ts. Lookup/format rules
- *   themselves live in __tests__/resolve.test.ts — this file pins the
- *   context wiring and the identity of the returned function.
- *
- * SYNC: When useTranslator.ts changes, update tests to match new behavior
- */
-
-import {describe, it, expect, vi, beforeEach} from 'vitest';
-import {use, useState} from 'react';
-import {render, screen, fireEvent, renderHook} from '@testing-library/react';
-import {useTranslator, type TranslatorFn} from './useTranslator';
-import {InternationalizationProvider} from './InternationalizationProvider';
-import {InternationalizationContext} from './InternationalizationContext';
-import {__resetForTests} from './resolve';
-import type {
-  MessagesByLocale,
-  Overrides,
-  ProviderMessagesByLocale,
-} from './types';
-
-// Module scope: the provider memoizes on prop identity, so inline object
-// literals would hand back a fresh context value on every render.
-const FR_MESSAGES: MessagesByLocale = {
-  fr: {'@astryx.pagination.next': {defaultMessage: 'Page suivante'}},
-};
-const FR_RUNTIME_MESSAGES: ProviderMessagesByLocale = {
-  fr: {'@astryx.pagination.next': 'Page suivante compacte'},
-};
-// One messages value mixing shapes: a generated string map for the active
-// locale and a rich catalog for its parent.
-const MIXED_MESSAGES: ProviderMessagesByLocale = {
-  'fr-CA': {'@astryx.pagination.next': 'Page suivante (CA)'},
-  fr: {'@astryx.pagination.previous': {defaultMessage: 'Page précédente'}},
-};
-const FR_OVERRIDES: Overrides = {
-  fr: {'@astryx.pagination.next': 'Suivant'},
-};
-
-// resolve() warns once per locale+key for good; reset between tests.
-beforeEach(() => {
-  __resetForTests();
-});
-
-describe('useTranslator — resolution', () => {
-  it('resolves a shipped key to English when no provider is mounted', () => {
-    const {result} = renderHook(() => useTranslator());
-    expect(result.current('@astryx.pagination.next')).toBe('Go to next page');
-  });
-
-  it('interpolates values into the message', () => {
-    const {result} = renderHook(() => useTranslator());
-    expect(result.current('@astryx.pagination.goToPage', {page: 5})).toBe(
-      'Go to page 5',
-    );
-  });
-
-  it('returns the key itself for a key that exists nowhere', () => {
-    const warn = vi.spyOn(console, 'warn').mockImplementation(() => {});
-    const {result} = renderHook(() => useTranslator());
-
-    expect(result.current('@astryx.not.a.real.key')).toBe(
-      '@astryx.not.a.real.key',
-    );
-    expect(warn).toHaveBeenCalledWith(expect.stringContaining('missing key'));
-    warn.mockRestore();
-  });
-
-  it('uses the catalog the provider supplies for its locale', () => {
-    const {result} = renderHook(() => useTranslator(), {
-      wrapper: ({children}) => (
-        <InternationalizationProvider locale="fr" messages={FR_MESSAGES}>
-          {children}
-        </InternationalizationProvider>
-      ),
-    });
-    expect(result.current('@astryx.pagination.next')).toBe('Page suivante');
-  });
-
-  it('accepts a generated runtime catalog and preserves the rich context shape', () => {
-    const {result} = renderHook(
-      () => ({
-        context: use(InternationalizationContext),
-        translate: useTranslator(),
-      }),
-      {
-        wrapper: ({children}) => (
-          <InternationalizationProvider
-            locale="fr"
-            messages={FR_RUNTIME_MESSAGES}>
-            {children}
-          </InternationalizationProvider>
-        ),
-      },
-    );
-
-    expect(result.current.translate('@astryx.pagination.next')).toBe(
-      'Page suivante compacte',
-    );
-    expect(
-      result.current.context.messages.fr['@astryx.pagination.next'],
-    ).toEqual({defaultMessage: 'Page suivante compacte'});
-  });
-
-  it('resolves rich and runtime catalogs mixed in one messages value', () => {
-    const {result} = renderHook(
-      () => ({
-        context: use(InternationalizationContext),
-        translate: useTranslator(),
-      }),
-      {
-        wrapper: ({children}) => (
-          <InternationalizationProvider
-            locale="fr-CA"
-            messages={MIXED_MESSAGES}>
-            {children}
-          </InternationalizationProvider>
-        ),
-      },
-    );
-
-    expect(result.current.translate('@astryx.pagination.next')).toBe(
-      'Page suivante (CA)',
-    );
-    expect(result.current.translate('@astryx.pagination.previous')).toBe(
-      'Page précédente',
-    );
-    expect(result.current.context.messages).toEqual({
-      'fr-CA': {
-        '@astryx.pagination.next': {defaultMessage: 'Page suivante (CA)'},
-      },
-      fr: {'@astryx.pagination.previous': {defaultMessage: 'Page précédente'}},
-    });
-  });
-
-  it('lets a provider override beat the provider catalog', () => {
-    const {result} = renderHook(() => useTranslator(), {
-      wrapper: ({children}) => (
-        <InternationalizationProvider
-          locale="fr"
-          messages={FR_MESSAGES}
-          overrides={FR_OVERRIDES}>
-          {children}
-        </InternationalizationProvider>
-      ),
-    });
-    expect(result.current('@astryx.pagination.next')).toBe('Suivant');
-  });
-
-  it('falls back to English for keys the provider catalog is missing', () => {
-    const {result} = renderHook(() => useTranslator(), {
-      wrapper: ({children}) => (
-        <InternationalizationProvider locale="fr" messages={FR_MESSAGES}>
-          {children}
-        </InternationalizationProvider>
-      ),
-    });
-    expect(result.current('@astryx.pagination.previous')).toBe(
-      'Go to previous page',
-    );
-  });
-
-  it('formats numbers with the provider locale', () => {
-    const {result} = renderHook(() => useTranslator(), {
-      wrapper: ({children}) => (
-        <InternationalizationProvider locale="de-DE">
-          {children}
-        </InternationalizationProvider>
-      ),
-    });
-    expect(
-      result.current('@astryx.pagination.count', {
-        from: 1,
-        to: 10,
-        total: 1000,
-      }),
-    ).toBe('1–10 of 1.000');
-  });
-});
-
-describe('useTranslator — identity', () => {
-  function Probe({onRender}: {onRender: (t: TranslatorFn) => void}) {
-    const translate = useTranslator();
-    onRender(translate);
-    return (
-      <span data-testid="out">{translate('@astryx.pagination.next')}</span>
-    );
-  }
-
-  it('hands back the same translator across rerenders of an unchanged provider', () => {
-    const seen: TranslatorFn[] = [];
-    // Built fresh each time — passing the identical element back to rerender()
-    // makes React bail out of the subtree entirely.
-    const tree = () => (
-      <InternationalizationProvider locale="fr" overrides={FR_OVERRIDES}>
-        <Probe onRender={t => seen.push(t)} />
-      </InternationalizationProvider>
-    );
-
-    const {rerender} = render(tree());
-    rerender(tree());
-
-    expect(seen).toHaveLength(2);
-    expect(seen[1]).toBe(seen[0]);
-  });
-
-  it('hands back a new translator when the locale changes', () => {
-    const seen: TranslatorFn[] = [];
-
-    const {rerender} = render(
-      <InternationalizationProvider locale="fr" overrides={FR_OVERRIDES}>
-        <Probe onRender={t => seen.push(t)} />
-      </InternationalizationProvider>,
-    );
-    expect(screen.getByTestId('out').textContent).toBe('Suivant');
-
-    rerender(
-      <InternationalizationProvider locale="es" overrides={FR_OVERRIDES}>
-        <Probe onRender={t => seen.push(t)} />
-      </InternationalizationProvider>,
-    );
-
-    expect(seen[1]).not.toBe(seen[0]);
-    // The fr override no longer applies, so es falls through to English.
-    expect(screen.getByTestId('out').textContent).toBe('Go to next page');
-  });
-});
-
-describe('useTranslator — deferred calls', () => {
-  it('resolves against the provider locale when called from an event handler', () => {
-    function Deferred() {
-      const translate = useTranslator();
-      const [text, setText] = useState('');
-      return (
-        <div>
-          <button
-            type="button"
-            onClick={() =>
-              setText(translate('@astryx.pagination.goToPage', {page: 3}))
-            }>
-            announce
-          </button>
-          <span data-testid="out">{text}</span>
-        </div>
-      );
-    }
-
-    render(
-      <InternationalizationProvider
-        locale="fr"
-        overrides={{
-          fr: {'@astryx.pagination.goToPage': 'Aller à la page {page, number}'},
-        }}>
-        <Deferred />
-      </InternationalizationProvider>,
-    );
-
-    expect(screen.getByTestId('out').textContent).toBe('');
-    fireEvent.click(screen.getByText('announce'));
-    expect(screen.getByTestId('out').textContent).toBe('Aller à la page 3');
-  });
-});

package/src/inputFontFloor.test.ts

@@ -1,106 +0,0 @@
-// Copyright (c) Meta Platforms, Inc. and affiliates.
-
-/**
- * @file inputFontFloor.test.ts
- * @input Uses node:fs and node:path to read the text-control sources
- * @output Invariants for the 16px input floor shared by every text control
- * @position Family-wide source test, in the source-reading style of
- *   reset.test.ts. jsdom's CSSOM drops declarations nested inside @supports,
- *   so the iOS branch cannot be asserted against injected rules — the
- *   runtime half (no bare coarse-pointer floor) lives in TextInput.test.tsx.
- */
-
-import {readFileSync, readdirSync} from 'node:fs';
-import path from 'node:path';
-
-import {describe, expect, it} from 'vitest';
-
-/**
- * Every control that floors its text to 16px. iOS Safari zooms the page when
- * a focused control renders under 16px; no other coarse-pointer browser does.
- * `-webkit-touch-callout` is implemented by iOS WebKit alone, so each floor
- * nests `@supports (-webkit-touch-callout: none)` inside the coarse-pointer
- * query: iPhones and iPads keep the zoom guard, while Android and touch
- * laptops keep the theme's own type scale instead of an inflated 16px.
- */
-const FLOORED_CONTROLS = [
-  'Chat/ChatComposerInput.tsx',
-  'CommandPalette/CommandPaletteInput.tsx',
-  'ComplexSelector/ComplexSelector.tsx',
-  'DateInput/DateInput.tsx',
-  'DateInput/NativeDateField.tsx',
-  'DateInput/TouchDateField.tsx',
-  'DateRangeInput/DateRangeInput.tsx',
-  'DateTimeInput/DateTimeInput.tsx',
-  'DateTimeInput/TouchDateTimeField.tsx',
-  'DateTimeInput/nativePickerSegmentStyles.ts',
-  'Field/PanelSearchInput.tsx',
-  'FileInput/FileInput.tsx',
-  'NumberInput/NumberInput.tsx',
-  'Selector/Selector.tsx',
-  'TextArea/TextArea.tsx',
-  'TextInput/TextInput.tsx',
-  'TimeInput/TimeInput.tsx',
-  'Typeahead/BaseTypeahead.tsx',
-  // The rich-text package carries the same floor; its path is relative to
-  // packages/core/src.
-  '../../richtext/src/RichTextEditor.tsx',
-];
-
-/** A font floor applied to every coarse pointer, iOS or not. */
-const BARE_COARSE_FLOOR = `'@media (pointer: coarse)': \`max(1rem`;
-
-/** The same floor, gated to iOS WebKit inside the coarse-pointer query. */
-const IOS_GATED_FLOOR =
-  /'@media \(pointer: coarse\)': \{\s*'@supports \(-webkit-touch-callout: none\)': `max\(1rem, \$\{typeScaleVars\['--text-(?:body|label)-size'\]\}\)`/;
-
-/** Collect every non-test component source under `dir`, recursively. */
-function componentSources(dir: string): string[] {
-  const SOURCE_EXTENSIONS = ['.ts', '.tsx', '.js', '.jsx'];
-  const out: string[] = [];
-  for (const entry of readdirSync(dir, {withFileTypes: true})) {
-    const full = path.join(dir, entry.name);
-    if (entry.isDirectory()) {
-      out.push(...componentSources(full));
-    } else if (
-      SOURCE_EXTENSIONS.some(ext => entry.name.endsWith(ext)) &&
-      !entry.name.endsWith('.test.ts') &&
-      !entry.name.endsWith('.test.tsx') &&
-      !entry.name.endsWith('.doc.mjs')
-    ) {
-      out.push(full);
-    }
-  }
-  return out;
-}
-
-describe('the 16px input floor', () => {
-  it('gates every floored text control to iOS alone', () => {
-    // Guards the loop below against the list silently emptying out.
-    expect(FLOORED_CONTROLS.length).toBeGreaterThanOrEqual(18);
-    for (const file of FLOORED_CONTROLS) {
-      const source = readFileSync(path.resolve(__dirname, file), 'utf8');
-      expect(source, file).toMatch(IOS_GATED_FLOOR);
-      expect(source, file).not.toContain(BARE_COARSE_FLOOR);
-    }
-  });
-
-  it('leaves no bare coarse-pointer font floor anywhere in core or richtext', () => {
-    // Catches a new (or renamed) control reintroducing the ungated floor,
-    // wherever it lands — the list above only knows the current family. The
-    // rich-text package carries the same floor, so it is scanned too.
-    const scanRoots = [
-      __dirname,
-      path.resolve(__dirname, '../../richtext/src'),
-    ];
-    const offenders = scanRoots
-      .flatMap(root => componentSources(root))
-      .map(file => ({
-        file,
-        source: readFileSync(file, 'utf8'),
-      }))
-      .filter(({source}) => source.includes(BARE_COARSE_FLOOR))
-      .map(({file}) => path.relative(__dirname, file));
-    expect(offenders).toEqual([]);
-  });
-});

package/src/internal/tokenizer-presentation.test.ts

@@ -1,29 +0,0 @@
-// Copyright (c) Meta Platforms, Inc. and affiliates.
-/**
- * @file tokenizer-presentation.test.ts
- * @input The internal `internal/tokenizer-presentation` entry and the
- *   Tokenizer module
- * @output Proof that the entry re-exports the same component the public
- *   Tokenizer entry ships, by name, and that the public Tokenizer barrel
- *   names no presentation
- * @position Unit tests of packages/core/src/internal/tokenizer-presentation.ts
- */
-import {describe, expect, it} from 'vitest';
-
-describe('internal/tokenizer-presentation', () => {
-  it('re-exports the one Tokenizer component under the sheet-capable name, the same value the public entry ships', async () => {
-    const entry: Record<string, unknown> =
-      await import('./tokenizer-presentation');
-    const tokenizer = await import('../Tokenizer/Tokenizer');
-    expect(entry.TokenizerWithPresentation).toBe(tokenizer.Tokenizer);
-    // Named re-exports only, nothing else.
-    expect(Object.keys(entry).sort()).toEqual(['TokenizerWithPresentation']);
-  });
-
-  it('the public Tokenizer barrel exports no presentation surface', async () => {
-    const pub: Record<string, unknown> = await import('../Tokenizer');
-    expect(Object.keys(pub).sort()).toEqual(['Tokenizer']);
-    expect(pub).not.toHaveProperty('TokenizerWithPresentation');
-    expect(pub).not.toHaveProperty('TokenizerBottomSheet');
-  });
-});

package/src/internal/touch.test.ts

@@ -1,44 +0,0 @@
-// Copyright (c) Meta Platforms, Inc. and affiliates.
-
-/**
- * @file touch.test.ts
- * @input The internal `internal/touch` entry and the gesture core
- * @output INV13's entry checks: the entry re-exports the gesture core's
- *   primitives by name, the same values a Core component imports by path, and
- *   no gathering object; importing it attaches no window or document
- *   listeners, so a page with only a fine pointer runs none (`spec:AST-094`
- *   FR19, FR24)
- * @position Unit tests of packages/core/src/internal/touch.ts
- *   (architecture:react-component-runtime INV13)
- */
-
-import {afterEach, describe, expect, it, vi} from 'vitest';
-
-afterEach(() => {
-  vi.restoreAllMocks();
-});
-
-describe('internal/touch', () => {
-  it('re-exports the gesture core by name, the same values Core imports by path', async () => {
-    const entry: Record<string, unknown> = await import('./touch');
-    const arena = await import('../gestures/GestureArena');
-    const recognizer = await import('../gestures/GestureRecognizer');
-    expect(entry.GestureArena).toBe(arena.GestureArena);
-    expect(entry.GestureRecognizer).toBe(recognizer.GestureRecognizer);
-    for (const name of ['TapGestureRecognizer', 'LongPressGestureRecognizer']) {
-      expect(typeof entry[name], name).toBe('function');
-    }
-    // Named re-exports only: no gathering object a component would carry
-    // whole (architecture:component-style-authoring INV6).
-    expect(entry).not.toHaveProperty('touchModule');
-  });
-
-  it('attaches no window or document listeners when it loads', async () => {
-    vi.resetModules();
-    const onWindow = vi.spyOn(window, 'addEventListener');
-    const onDocument = vi.spyOn(document, 'addEventListener');
-    await import('./touch');
-    expect(onWindow).not.toHaveBeenCalled();
-    expect(onDocument).not.toHaveBeenCalled();
-  });
-});