@astryxdesign/core 0.7.1 → 0.7.2-canary.01eab6a

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

@@ -0,0 +1,128 @@
+// Copyright (c) Meta Platforms, Inc. and affiliates.
+
+/**
+ * @file InternationalizationProvider.test.tsx
+ * @input packages/core/src/i18n/InternationalizationProvider.tsx, useTranslator,
+ *   useDirection, useLocale
+ * @output Unit tests for the provider's update and nesting contract
+ * @position Colocated tests; targets re-rendering when messages, overrides, or
+ *   dir change (locale is covered by useLocale/useTranslator tests) and a nested
+ *   provider replacing rather than merging its parent's context.
+ */
+
+import {describe, expect, test} from 'vitest';
+import {render} from '@testing-library/react';
+import {InternationalizationProvider} from '../InternationalizationProvider';
+import {useDirection} from '../useDirection';
+import {useLocale} from '../useLocale';
+import {useTranslator} from '../useTranslator';
+import type {MessagesByLocale, Overrides} from '../types';
+
+const NEXT = '@astryx.pagination.next';
+const APP_KEY = '@myapp.save';
+
+function Probe() {
+  const t = useTranslator();
+  return (
+    <>
+      <span data-testid="next">{t(NEXT)}</span>
+      <span data-testid="app">{t(APP_KEY)}</span>
+      <span data-testid="locale">{useLocale()}</span>
+      <span data-testid="dir">{useDirection()}</span>
+    </>
+  );
+}
+
+const FR_MESSAGES: MessagesByLocale = {
+  fr: {[APP_KEY]: {defaultMessage: 'Enregistrer'}},
+};
+const FR_MESSAGES_V2: MessagesByLocale = {
+  fr: {[APP_KEY]: {defaultMessage: 'Sauvegarder'}},
+};
+const FR_OVERRIDES: Overrides = {fr: {[NEXT]: 'Suivant'}};
+const FR_OVERRIDES_V2: Overrides = {fr: {[NEXT]: 'Page suivante'}};
+
+describe('InternationalizationProvider — re-rendering', () => {
+  test('re-renders consumers when messages change', () => {
+    const {getByTestId, rerender} = render(
+      <InternationalizationProvider locale="fr" messages={FR_MESSAGES}>
+        <Probe />
+      </InternationalizationProvider>,
+    );
+    expect(getByTestId('app').textContent).toBe('Enregistrer');
+
+    rerender(
+      <InternationalizationProvider locale="fr" messages={FR_MESSAGES_V2}>
+        <Probe />
+      </InternationalizationProvider>,
+    );
+    expect(getByTestId('app').textContent).toBe('Sauvegarder');
+  });
+
+  test('re-renders consumers when overrides change', () => {
+    const {getByTestId, rerender} = render(
+      <InternationalizationProvider locale="fr" overrides={FR_OVERRIDES}>
+        <Probe />
+      </InternationalizationProvider>,
+    );
+    expect(getByTestId('next').textContent).toBe('Suivant');
+
+    rerender(
+      <InternationalizationProvider locale="fr" overrides={FR_OVERRIDES_V2}>
+        <Probe />
+      </InternationalizationProvider>,
+    );
+    expect(getByTestId('next').textContent).toBe('Page suivante');
+  });
+
+  test('re-renders consumers when dir changes', () => {
+    const {getByTestId, rerender} = render(
+      <InternationalizationProvider locale="en" dir="rtl">
+        <Probe />
+      </InternationalizationProvider>,
+    );
+    expect(getByTestId('dir').textContent).toBe('rtl');
+
+    rerender(
+      <InternationalizationProvider locale="en" dir="ltr">
+        <Probe />
+      </InternationalizationProvider>,
+    );
+    expect(getByTestId('dir').textContent).toBe('ltr');
+  });
+});
+
+describe('InternationalizationProvider — nesting', () => {
+  test('a nested provider replaces the parent context instead of merging it', () => {
+    const {getByTestId} = render(
+      <InternationalizationProvider
+        locale="fr"
+        dir="rtl"
+        messages={FR_MESSAGES}
+        overrides={FR_OVERRIDES}>
+        <InternationalizationProvider locale="fr">
+          <Probe />
+        </InternationalizationProvider>
+      </InternationalizationProvider>,
+    );
+    // Locale is the child's own; direction derives from it, not the parent's
+    // explicit rtl; parent overrides and catalogs do not leak into the child.
+    expect(getByTestId('locale').textContent).toBe('fr');
+    expect(getByTestId('dir').textContent).toBe('ltr');
+    expect(getByTestId('next').textContent).toBe('Go to next page');
+    expect(getByTestId('app').textContent).toBe(APP_KEY);
+  });
+
+  test('a nested provider can narrow the locale for one subtree', () => {
+    const {getByTestId} = render(
+      <InternationalizationProvider locale="fr" overrides={FR_OVERRIDES}>
+        <InternationalizationProvider locale="de">
+          <Probe />
+        </InternationalizationProvider>
+      </InternationalizationProvider>,
+    );
+    expect(getByTestId('locale').textContent).toBe('de');
+    // No de override or catalog: shipped English wins.
+    expect(getByTestId('next').textContent).toBe('Go to next page');
+  });
+});

package/src/i18n/generated-locales/en.generated.ts

@@ -158,6 +158,27 @@ const runtimeCatalog: Readonly<Record<string, string>> = {
     '{itemName} dropped at position {position, number} of {total, number}.',
   '@astryx.listInput.announceAlreadyAtBoundary':
     'This {itemName} is already {boundary, select, first {first} last {last} other {}}.',
+  '@astryx.diffViewer.label': 'Diff',
+  '@astryx.diffViewer.renamedPath': '{oldPath} → {newPath}',
+  '@astryx.diffViewer.statusAdded': 'Added',
+  '@astryx.diffViewer.statusDeleted': 'Deleted',
+  '@astryx.diffViewer.statusRenamed': 'Renamed',
+  '@astryx.diffViewer.addedCount': '+{count, number}',
+  '@astryx.diffViewer.removedCount': '−{count, number}',
+  '@astryx.diffViewer.stats':
+    '{added, plural, one {# line added} other {# lines added}}, {removed, plural, one {# line removed} other {# lines removed}}',
+  '@astryx.diffViewer.added': 'Added',
+  '@astryx.diffViewer.removed': 'Removed',
+  '@astryx.diffViewer.lineNumberButton':
+    '{side, select, old {Original line {line, number}} other {Changed line {line, number}}}',
+  '@astryx.diffViewer.columnOldLine': 'Original line number',
+  '@astryx.diffViewer.columnNewLine': 'Changed line number',
+  '@astryx.diffViewer.columnChange': 'Change',
+  '@astryx.diffViewer.columnCode': 'Code',
+  '@astryx.diffViewer.columnOldCode': 'Original code',
+  '@astryx.diffViewer.columnNewCode': 'Changed code',
+  '@astryx.diffViewer.binary': 'Binary file not shown',
+  '@astryx.diffViewer.noChanges': 'No content changes',
   '@astryx.markdownHeadingLinks.copied': 'Link copied',
   '@astryx.markdownHeadingLinks.copy': 'Copy link to {heading}',
   '@astryx.richTextEditor.tabEscapeHint':
@@ -459,6 +480,106 @@ const runtimeCatalog: Readonly<Record<string, string>> = {
   '@astryx.transferListSelector.apply': 'Apply',
   '@astryx.transferListSelector.cancel': 'Cancel',
   '@astryx.transferListSelector.triggerLabel': '{count, number} selected',
+  '@astryx.emojiPicker.label': 'Emoji',
+  '@astryx.emojiPicker.searchLabel': 'Search emoji',
+  '@astryx.emojiPicker.frequentlyUsed': 'Frequently used',
+  '@astryx.emojiPicker.searchResults': 'Search results',
+  '@astryx.emojiPicker.noResults': 'No emoji match “{query}”',
+  '@astryx.emojiPicker.loading': 'Loading emoji',
+  '@astryx.emojiPicker.loadFailed': "More emoji couldn't be loaded.",
+  '@astryx.emojiPicker.groupSmileysEmotion': 'Smileys & emotion',
+  '@astryx.emojiPicker.groupPeopleBody': 'People & body',
+  '@astryx.emojiPicker.groupAnimalsNature': 'Animals & nature',
+  '@astryx.emojiPicker.groupFoodDrink': 'Food & drink',
+  '@astryx.emojiPicker.groupTravelPlaces': 'Travel & places',
+  '@astryx.emojiPicker.groupActivities': 'Activities',
+  '@astryx.emojiPicker.groupObjects': 'Objects',
+  '@astryx.emojiPicker.groupSymbols': 'Symbols',
+  '@astryx.emojiPicker.groupFlags': 'Flags',
+  '@astryx.comments.retry': 'Retry',
+  '@astryx.commentComposer.placeholder': 'Write a comment…',
+  '@astryx.commentComposer.noAgents': 'No agents',
+  '@astryx.commentComposer.agents': 'Agents',
+  '@astryx.commentComposer.uploadFailed': "Images couldn't be added",
+  '@astryx.commentComposer.imagesOnly': 'Only image files can be added',
+  '@astryx.commentComposer.chooseImages': 'Choose images',
+  '@astryx.commentComposer.imageAlt': 'Image attachment',
+  '@astryx.commentComposer.removeQuote': 'Remove quoted text',
+  '@astryx.commentComposer.attachImages': 'Attach images',
+  '@astryx.commentComposer.addEmoji': 'Add emoji',
+  '@astryx.commentComposer.cancel': 'Cancel',
+  '@astryx.comments.actionsLabel': "Actions for {name}'s comment",
+  '@astryx.comments.addReaction': 'Add reaction',
+  '@astryx.comments.agentBadge': 'Agent',
+  '@astryx.comments.agentLogo': '{name} logo',
+  '@astryx.comments.chooseReaction': 'Choose a reaction',
+  '@astryx.comments.copyLink': 'Copy comment link',
+  '@astryx.comments.currentVersion': 'Current version',
+  '@astryx.comments.delete': 'Delete',
+  '@astryx.comments.deleteDescription':
+    "Delete {name}'s comment? This action cannot be undone.",
+  '@astryx.comments.deleteFailed': "This comment couldn't be deleted.",
+  '@astryx.comments.deleteFailedRetry':
+    "This comment couldn't be deleted. Try again.",
+  '@astryx.comments.deleteTitle': 'Delete comment?',
+  '@astryx.comments.edit': 'Edit',
+  '@astryx.comments.editFailed': "Your edit couldn't be saved.",
+  '@astryx.comments.editPlaceholder': 'Edit comment',
+  '@astryx.comments.edited': 'Edited',
+  '@astryx.comments.editingContext': 'Editing comment',
+  '@astryx.comments.hideReplies': 'Hide replies',
+  '@astryx.comments.historyEmptyDescription':
+    'This comment has no earlier versions.',
+  '@astryx.comments.historyEmptyTitle': 'No edit history',
+  '@astryx.comments.historyFailed': "Edit history couldn't load",
+  '@astryx.comments.historyLoadFailed':
+    "The comment's edit history couldn't be loaded. Try again.",
+  '@astryx.comments.historyLoading': 'Loading edit history',
+  '@astryx.comments.historySubtitle': 'Comment by {name}',
+  '@astryx.comments.historyTitle': 'Edit history',
+  '@astryx.comments.linkCopied': 'Comment link copied',
+  '@astryx.comments.otherReactors':
+    '{count, plural, one {# other} other {# others}}',
+  '@astryx.comments.outdated': 'Outdated',
+  '@astryx.comments.reactionCelebrate': 'Celebrate',
+  '@astryx.comments.reactionCount': '{reaction}: {count, number}',
+  '@astryx.comments.reactionFailed': "Your reaction couldn't be saved.",
+  '@astryx.comments.reactionLaugh': 'Haha',
+  '@astryx.comments.reactionLike': 'Like',
+  '@astryx.comments.reactionLove': 'Love',
+  '@astryx.comments.reactionSad': 'Sad',
+  '@astryx.comments.reactionWow': 'Wow',
+  '@astryx.comments.reopen': 'Reopen',
+  '@astryx.comments.reopenFailed': "This thread couldn't be reopened.",
+  '@astryx.comments.reply': 'Reply',
+  '@astryx.comments.replyFailed': "Your reply couldn't be posted.",
+  '@astryx.comments.replyPlaceholder': 'Reply to {name}…',
+  '@astryx.comments.replyingContext': 'Replying to {name}',
+  '@astryx.comments.resolve': 'Mark as resolved',
+  '@astryx.comments.resolveFailed': "This thread couldn't be resolved.",
+  '@astryx.comments.resolved': 'Resolved',
+  '@astryx.comments.resolvedBy': 'Resolved by {name}',
+  '@astryx.comments.retryFailed': "Retrying didn't work.",
+  '@astryx.comments.sendFailed': "Couldn't send this comment.",
+  '@astryx.comments.threadLabel': 'Thread by {name}',
+  '@astryx.comments.unread': 'New',
+  '@astryx.comments.unsavedDraft':
+    'Unsaved draft. Dismiss again to discard it.',
+  '@astryx.comments.versionAuthor': 'by {name}',
+  '@astryx.comments.viewHistory': 'View edit history',
+  '@astryx.comments.viewReplies':
+    'View {count, plural, one {# reply} other {# replies}}',
+  '@astryx.comments.commentsLabel': 'Threads in {label}',
+  '@astryx.comments.emptyDescription': 'Start the discussion with a comment.',
+  '@astryx.comments.emptyReadOnlyDescription':
+    'There is no discussion on this item.',
+  '@astryx.comments.emptyTitle': 'No comments yet',
+  '@astryx.comments.label': 'Comments',
+  '@astryx.comments.loadFailed': "Comments couldn't load",
+  '@astryx.comments.loadOlder': 'Load earlier comments',
+  '@astryx.comments.loading': 'Loading comments',
+  '@astryx.comments.olderFailed': "Earlier comments couldn't load",
+  '@astryx.comments.postFailed': "Your comment couldn't be posted.",
 };
 
 export default runtimeCatalog;

package/src/i18n/generated-locales/pseudo.generated.ts

@@ -163,6 +163,27 @@ const runtimeCatalog: Readonly<Record<string, string>> = {
     '⟦{itemName} ðřóþþéð àţ þóšíţíóñ {position, number} óƒ {total, number}.⟧',
   '@astryx.listInput.announceAlreadyAtBoundary':
     '⟦Ţĥíš {itemName} íš àłřéàðý {boundary, select, first {first} last {last} other {}}.⟧',
+  '@astryx.diffViewer.label': '⟦Ð탃⟧',
+  '@astryx.diffViewer.renamedPath': '⟦{oldPath} → {newPath}⟧',
+  '@astryx.diffViewer.statusAdded': '⟦Àððéð⟧',
+  '@astryx.diffViewer.statusDeleted': '⟦Ðéłéţéð⟧',
+  '@astryx.diffViewer.statusRenamed': '⟦Řéñàɱéð⟧',
+  '@astryx.diffViewer.addedCount': '⟦+{count, number}⟧',
+  '@astryx.diffViewer.removedCount': '⟦−{count, number}⟧',
+  '@astryx.diffViewer.stats':
+    '⟦{added, plural, one {# line added} other {# lines added}}, {removed, plural, one {# line removed} other {# lines removed}}⟧',
+  '@astryx.diffViewer.added': '⟦Àððéð⟧',
+  '@astryx.diffViewer.removed': '⟦Řéɱóṽéð⟧',
+  '@astryx.diffViewer.lineNumberButton':
+    '⟦{side, select, old {Original line {line, number}} other {Changed line {line, number}}}⟧',
+  '@astryx.diffViewer.columnOldLine': '⟦Óříĝíñàł łíñé ñúɱƀéř⟧',
+  '@astryx.diffViewer.columnNewLine': '⟦Çĥàñĝéð łíñé ñúɱƀéř⟧',
+  '@astryx.diffViewer.columnChange': '⟦Çĥàñĝé⟧',
+  '@astryx.diffViewer.columnCode': '⟦Çóðé⟧',
+  '@astryx.diffViewer.columnOldCode': '⟦Óříĝíñàł çóðé⟧',
+  '@astryx.diffViewer.columnNewCode': '⟦Çĥàñĝéð çóðé⟧',
+  '@astryx.diffViewer.binary': '⟦Ɓíñàřý ƒíłé ñóţ šĥóŵñ⟧',
+  '@astryx.diffViewer.noChanges': '⟦Ñó çóñţéñţ çĥàñĝéš⟧',
   '@astryx.markdownHeadingLinks.copied': '⟦Łíñķ çóþíéð⟧',
   '@astryx.markdownHeadingLinks.copy': '⟦Çóþý łíñķ ţó {heading}⟧',
   '@astryx.richTextEditor.tabEscapeHint':
@@ -468,6 +489,106 @@ const runtimeCatalog: Readonly<Record<string, string>> = {
   '@astryx.transferListSelector.apply': '⟦Àþþłý⟧',
   '@astryx.transferListSelector.cancel': '⟦Çàñçéł⟧',
   '@astryx.transferListSelector.triggerLabel': '⟦{count, number} šéłéçţéð⟧',
+  '@astryx.emojiPicker.label': '⟦Éɱóĵí⟧',
+  '@astryx.emojiPicker.searchLabel': '⟦Šéàřçĥ éɱóĵí⟧',
+  '@astryx.emojiPicker.frequentlyUsed': '⟦Ƒřéɋúéñţłý úšéð⟧',
+  '@astryx.emojiPicker.searchResults': '⟦Šéàřçĥ řéšúłţš⟧',
+  '@astryx.emojiPicker.noResults': '⟦Ñó éɱóĵí ɱàţçĥ “{query}”⟧',
+  '@astryx.emojiPicker.loading': '⟦Łóàðíñĝ éɱóĵí⟧',
+  '@astryx.emojiPicker.loadFailed': "⟦Ṁóřé éɱóĵí çóúłðñ'ţ ƀé łóàðéð.⟧",
+  '@astryx.emojiPicker.groupSmileysEmotion': '⟦Šɱíłéýš & éɱóţíóñ⟧',
+  '@astryx.emojiPicker.groupPeopleBody': '⟦Þéóþłé & ƀóðý⟧',
+  '@astryx.emojiPicker.groupAnimalsNature': '⟦Àñíɱàłš & ñàţúřé⟧',
+  '@astryx.emojiPicker.groupFoodDrink': '⟦Ƒóóð & ðříñķ⟧',
+  '@astryx.emojiPicker.groupTravelPlaces': '⟦Ţřàṽéł & þłàçéš⟧',
+  '@astryx.emojiPicker.groupActivities': '⟦Àçţíṽíţíéš⟧',
+  '@astryx.emojiPicker.groupObjects': '⟦Óƀĵéçţš⟧',
+  '@astryx.emojiPicker.groupSymbols': '⟦Šýɱƀółš⟧',
+  '@astryx.emojiPicker.groupFlags': '⟦Ƒłàĝš⟧',
+  '@astryx.comments.retry': '⟦Řéţřý⟧',
+  '@astryx.commentComposer.placeholder': '⟦Ŵříţé à çóɱɱéñţ…⟧',
+  '@astryx.commentComposer.noAgents': '⟦Ñó àĝéñţš⟧',
+  '@astryx.commentComposer.agents': '⟦Àĝéñţš⟧',
+  '@astryx.commentComposer.uploadFailed': "⟦Íɱàĝéš çóúłðñ'ţ ƀé àððéð⟧",
+  '@astryx.commentComposer.imagesOnly': '⟦Óñłý íɱàĝé ƒíłéš çàñ ƀé àððéð⟧',
+  '@astryx.commentComposer.chooseImages': '⟦Çĥóóšé íɱàĝéš⟧',
+  '@astryx.commentComposer.imageAlt': '⟦Íɱàĝé àţţàçĥɱéñţ⟧',
+  '@astryx.commentComposer.removeQuote': '⟦Řéɱóṽé ɋúóţéð ţéẋţ⟧',
+  '@astryx.commentComposer.attachImages': '⟦Àţţàçĥ íɱàĝéš⟧',
+  '@astryx.commentComposer.addEmoji': '⟦Àðð éɱóĵí⟧',
+  '@astryx.commentComposer.cancel': '⟦Çàñçéł⟧',
+  '@astryx.comments.actionsLabel': "⟦Àçţíóñš ƒóř {name}'š çóɱɱéñţ⟧",
+  '@astryx.comments.addReaction': '⟦Àðð řéàçţíóñ⟧',
+  '@astryx.comments.agentBadge': '⟦Àĝéñţ⟧',
+  '@astryx.comments.agentLogo': '⟦{name} łóĝó⟧',
+  '@astryx.comments.chooseReaction': '⟦Çĥóóšé à řéàçţíóñ⟧',
+  '@astryx.comments.copyLink': '⟦Çóþý çóɱɱéñţ łíñķ⟧',
+  '@astryx.comments.currentVersion': '⟦Çúřřéñţ ṽéřšíóñ⟧',
+  '@astryx.comments.delete': '⟦Ðéłéţé⟧',
+  '@astryx.comments.deleteDescription':
+    "⟦Ðéłéţé {name}'š çóɱɱéñţ? Ţĥíš àçţíóñ çàññóţ ƀé úñðóñé.⟧",
+  '@astryx.comments.deleteFailed': "⟦Ţĥíš çóɱɱéñţ çóúłðñ'ţ ƀé ðéłéţéð.⟧",
+  '@astryx.comments.deleteFailedRetry':
+    "⟦Ţĥíš çóɱɱéñţ çóúłðñ'ţ ƀé ðéłéţéð. Ţřý àĝàíñ.⟧",
+  '@astryx.comments.deleteTitle': '⟦Ðéłéţé çóɱɱéñţ?⟧',
+  '@astryx.comments.edit': '⟦Éðíţ⟧',
+  '@astryx.comments.editFailed': "⟦Ýóúř éðíţ çóúłðñ'ţ ƀé šàṽéð.⟧",
+  '@astryx.comments.editPlaceholder': '⟦Éðíţ çóɱɱéñţ⟧',
+  '@astryx.comments.edited': '⟦Éðíţéð⟧',
+  '@astryx.comments.editingContext': '⟦Éðíţíñĝ çóɱɱéñţ⟧',
+  '@astryx.comments.hideReplies': '⟦Ĥíðé řéþłíéš⟧',
+  '@astryx.comments.historyEmptyDescription':
+    '⟦Ţĥíš çóɱɱéñţ ĥàš ñó éàřłíéř ṽéřšíóñš.⟧',
+  '@astryx.comments.historyEmptyTitle': '⟦Ñó éðíţ ĥíšţóřý⟧',
+  '@astryx.comments.historyFailed': "⟦Éðíţ ĥíšţóřý çóúłðñ'ţ łóàð⟧",
+  '@astryx.comments.historyLoadFailed':
+    "⟦Ţĥé çóɱɱéñţ'š éðíţ ĥíšţóřý çóúłðñ'ţ ƀé łóàðéð. Ţřý àĝàíñ.⟧",
+  '@astryx.comments.historyLoading': '⟦Łóàðíñĝ éðíţ ĥíšţóřý⟧',
+  '@astryx.comments.historySubtitle': '⟦Çóɱɱéñţ ƀý {name}⟧',
+  '@astryx.comments.historyTitle': '⟦Éðíţ ĥíšţóřý⟧',
+  '@astryx.comments.linkCopied': '⟦Çóɱɱéñţ łíñķ çóþíéð⟧',
+  '@astryx.comments.otherReactors':
+    '⟦{count, plural, one {# other} other {# others}}⟧',
+  '@astryx.comments.outdated': '⟦Óúţðàţéð⟧',
+  '@astryx.comments.reactionCelebrate': '⟦Çéłéƀřàţé⟧',
+  '@astryx.comments.reactionCount': '⟦{reaction}: {count, number}⟧',
+  '@astryx.comments.reactionFailed': "⟦Ýóúř řéàçţíóñ çóúłðñ'ţ ƀé šàṽéð.⟧",
+  '@astryx.comments.reactionLaugh': '⟦Ĥàĥà⟧',
+  '@astryx.comments.reactionLike': '⟦Łíķé⟧',
+  '@astryx.comments.reactionLove': '⟦Łóṽé⟧',
+  '@astryx.comments.reactionSad': '⟦Šàð⟧',
+  '@astryx.comments.reactionWow': '⟦Ŵóŵ⟧',
+  '@astryx.comments.reopen': '⟦Řéóþéñ⟧',
+  '@astryx.comments.reopenFailed': "⟦Ţĥíš ţĥřéàð çóúłðñ'ţ ƀé řéóþéñéð.⟧",
+  '@astryx.comments.reply': '⟦Řéþłý⟧',
+  '@astryx.comments.replyFailed': "⟦Ýóúř řéþłý çóúłðñ'ţ ƀé þóšţéð.⟧",
+  '@astryx.comments.replyPlaceholder': '⟦Řéþłý ţó {name}…⟧',
+  '@astryx.comments.replyingContext': '⟦Řéþłýíñĝ ţó {name}⟧',
+  '@astryx.comments.resolve': '⟦Ṁàřķ àš řéšółṽéð⟧',
+  '@astryx.comments.resolveFailed': "⟦Ţĥíš ţĥřéàð çóúłðñ'ţ ƀé řéšółṽéð.⟧",
+  '@astryx.comments.resolved': '⟦Řéšółṽéð⟧',
+  '@astryx.comments.resolvedBy': '⟦Řéšółṽéð ƀý {name}⟧',
+  '@astryx.comments.retryFailed': "⟦Řéţřýíñĝ ðíðñ'ţ ŵóřķ.⟧",
+  '@astryx.comments.sendFailed': "⟦Çóúłðñ'ţ šéñð ţĥíš çóɱɱéñţ.⟧",
+  '@astryx.comments.threadLabel': '⟦Ţĥřéàð ƀý {name}⟧',
+  '@astryx.comments.unread': '⟦Ñéŵ⟧',
+  '@astryx.comments.unsavedDraft':
+    '⟦Úñšàṽéð ðřàƒţ. Ðíšɱíšš àĝàíñ ţó ðíšçàřð íţ.⟧',
+  '@astryx.comments.versionAuthor': '⟦ƀý {name}⟧',
+  '@astryx.comments.viewHistory': '⟦Ṽíéŵ éðíţ ĥíšţóřý⟧',
+  '@astryx.comments.viewReplies':
+    '⟦Ṽíéŵ {count, plural, one {# reply} other {# replies}}⟧',
+  '@astryx.comments.commentsLabel': '⟦Ţĥřéàðš íñ {label}⟧',
+  '@astryx.comments.emptyDescription': '⟦Šţàřţ ţĥé ðíšçúššíóñ ŵíţĥ à çóɱɱéñţ.⟧',
+  '@astryx.comments.emptyReadOnlyDescription':
+    '⟦Ţĥéřé íš ñó ðíšçúššíóñ óñ ţĥíš íţéɱ.⟧',
+  '@astryx.comments.emptyTitle': '⟦Ñó çóɱɱéñţš ýéţ⟧',
+  '@astryx.comments.label': '⟦Çóɱɱéñţš⟧',
+  '@astryx.comments.loadFailed': "⟦Çóɱɱéñţš çóúłðñ'ţ łóàð⟧",
+  '@astryx.comments.loadOlder': '⟦Łóàð éàřłíéř çóɱɱéñţš⟧',
+  '@astryx.comments.loading': '⟦Łóàðíñĝ çóɱɱéñţš⟧',
+  '@astryx.comments.olderFailed': "⟦Éàřłíéř çóɱɱéñţš çóúłðñ'ţ łóàð⟧",
+  '@astryx.comments.postFailed': "⟦Ýóúř çóɱɱéñţ çóúłðñ'ţ ƀé þóšţéð.⟧",
 };
 
 export default runtimeCatalog;

package/src/i18n/useTranslator.test.tsx

@@ -32,6 +32,12 @@ const FR_MESSAGES: MessagesByLocale = {
 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'},
 };
@@ -101,6 +107,37 @@ describe('useTranslator — resolution', () => {
     ).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}) => (

package/src/index.ts

@@ -95,6 +95,7 @@ export * from './AlertDialog';
 export * from './Dialog';
 export * from './ContextMenu';
 export * from './DropdownMenu';
+export * from './Drawer';
 export * from './MoreMenu';
 export * from './InteractiveRoleContext';
 export * from './SizeContext';

package/src/reset.css

@@ -203,35 +203,6 @@
     height: auto;
   }
 
-  /* ===========================================================================
-     AspectRatio Fit Baseline
-     =========================================================================== */
-
-  /*
-   * Child sizing for AspectRatio's `fit` prop — the component marks the
-   * child's direct parent with `data-astryx-aspect-ratio-override` (carrying
-   * the fit value), and these direct-child rules size the child, so
-   * consumers don't hand-write width/height/object-fit on every media child.
-   * The marker sits on the parent itself, so the rules don't depend on
-   * AspectRatio's internal element structure or its theming surface. As with
-   * the [data-astryx-media] baseline below, the rules are zero-specificity
-   * and any styling the child sets itself still wins. `fit="center"` needs
-   * no rules here — the component centers the child from its own wrapper.
-   */
-  :where([data-astryx-aspect-ratio-override="cover"], [data-astryx-aspect-ratio-override="contain"])
-    > :where(*) {
-    width: 100%;
-    height: 100%;
-  }
-
-  :where([data-astryx-aspect-ratio-override="cover"]) > :where(img, video) {
-    object-fit: cover;
-  }
-
-  :where([data-astryx-aspect-ratio-override="contain"]) > :where(img, video) {
-    object-fit: contain;
-  }
-
   /* ===========================================================================
      Forms
      =========================================================================== */

package/src/theme/derivedVarRegistry.test.ts

@@ -224,9 +224,6 @@ const DIR_TO_REGISTRY_KEY: Record<string, string> = {
   Chat: 'chat',
   ContextMenu: 'context-menu',
   Dialog: 'dialog',
-  // The Drawer doc file lives in packages/lab/src/Drawer, outside this
-  // package's scan; the mapping keeps the registry orphan check honest and
-  // defineTheme.test.ts pins the expansion.
   Drawer: 'drawer',
   DropdownMenu: 'dropdown-menu',
   Field: 'field',
@@ -264,6 +261,9 @@ const CROSS_COMPONENT_VARS: Record<string, string[]> = {
   // The destructive item variant recolors the Item it renders; Item owns,
   // documents and reads both slots.
   DropdownMenu: ['--_item-label-color', '--_item-description-color'],
+  // List's edge="flush" zeroes the inline inset of the Item each ListItem
+  // renders; Item owns, documents and reads it.
+  List: ['--_item-inset-inline'],
   // A layer content root stops an outer Stepper's connector gap; Stepper owns,
   // documents and reads it.
   Layer: ['--step-connector-gap'],
@@ -319,6 +319,10 @@ const VARS_WITHOUT_DERIVED_MAPPING = new Set([
   '--tree-list-indent',
   '--_tree-indent',
   '--tree-list-row-gap',
+  // Published by each treeitem while it has keyboard focus and read as its
+  // row's z-index, so the focused row paints above the guide lines. Focus
+  // state, not a value a theme author sets.
+  '--_tree-focus-z',
   // Clipped on the ONE side each on-track connector segment faces the
   // indicator from — trailing above the node, leading below it, mirrored
   // again per axis. No standard property maps onto this purpose-based seam:

package/src/theme/derivedVarRegistry.ts

@@ -59,9 +59,6 @@ export const derivedVarRegistry: Record<string, DerivedVarEntry[]> = {
     {property: 'borderRadius', vars: ['--_dialog-radius']},
     {property: 'padding', expand: 'container'},
   ],
-  // Drawer lives in @astryxdesign/lab; its doc source of truth is
-  // packages/lab/src/Drawer/Drawer.doc.mjs, outside this package's consistency
-  // scan. defineTheme.test.ts pins the expansion instead.
   drawer: [{property: 'padding', expand: 'container'}],
   'context-menu': [
     {property: 'borderRadius', vars: ['--_dropdown-menu-radius']},

package/src/utils/focusOutline.stylex.ts

@@ -70,6 +70,10 @@ const focusOutlineLonghands = {
  * independently overridable — and every part stays a var, so a theme's
  * `--focus-outline-*` overrides still flow through.
  *
+ * NOT usable inside another file's `stylex.create`, for the same reason as
+ * {@link FOCUS_OUTLINE}: StyleX compiles each member there to a CSS variable
+ * nothing defines. Compose the `focusVars` tokens instead.
+ *
  * Keys are camelCase to match `HTMLElement.style`, so this spreads straight
  * onto an element:
  *

package/src/utils/plainDate.test.ts

@@ -1,6 +1,6 @@
 // Copyright (c) Meta Platforms, Inc. and affiliates.
 
-import {describe, it, expect} from 'vitest';
+import {describe, it, expect, afterEach} from 'vitest';
 import {
   type PlainDate,
   plainDateCreate,
@@ -711,6 +711,42 @@ describe('plainDateGetWeekNumber', () => {
     expect(plainDateGetWeekNumber({year: 2026, month: 1, day: 4})).toBe(1);
   });
 
+  // Regression: the week number must not depend on the host timezone's DST
+  // offset. Zones whose DST ends after New Year (southern hemisphere) used to
+  // add a phantom hour to the Thursday-vs-Jan-1 day count, and in years whose
+  // Jan 1 is a Friday that hour rounded a whole week up.
+  describe('DST independence', () => {
+    const originalTZ = process.env.TZ;
+
+    afterEach(() => {
+      if (originalTZ === undefined) {
+        delete process.env.TZ;
+      } else {
+        process.env.TZ = originalTZ;
+      }
+    });
+
+    it.each(['Australia/Sydney', 'Pacific/Auckland', 'America/Santiago'])(
+      'does not round week 14 up to 15 in %s (DST ends after New Year)',
+      zone => {
+        process.env.TZ = zone;
+        // 2021-01-01 is a Friday, so every ISO Thursday falls on a whole
+        // multiple of 7 days into the year. 2021-04-05..11 is ISO week 14.
+        expect(plainDateGetWeekNumber({year: 2021, month: 4, day: 5})).toBe(14);
+        expect(plainDateGetWeekNumber({year: 2021, month: 4, day: 8})).toBe(14);
+        expect(plainDateGetWeekNumber({year: 2021, month: 4, day: 11})).toBe(
+          14,
+        );
+      },
+    );
+
+    it('keeps late-December weeks correct in Australia/Sydney', () => {
+      process.env.TZ = 'Australia/Sydney';
+      // 2027-12-30 (Thursday) is ISO week 52, not 53.
+      expect(plainDateGetWeekNumber({year: 2027, month: 12, day: 30})).toBe(52);
+    });
+  });
+
   it('keeps years 1-99 instead of mapping them to 1900-1999', () => {
     // 0004-01-01 is a Thursday (ISO week 1); 1904-01-01 was a Friday.
     expect(plainDateGetWeekNumber({year: 4, month: 1, day: 1})).toBe(1);

package/src/utils/plainDate.ts

@@ -282,11 +282,21 @@ export function plainDateSetEndOfWeekExclusive(
 }
 
 export function plainDateGetWeekNumber(pd: PlainDate): number {
-  const d = plainDateToDate(pd);
-  const dayNum = d.getDay() || 7;
-  d.setDate(d.getDate() + 4 - dayNum);
-  const yearStart = plainDateToDate({year: d.getFullYear(), month: 1, day: 1});
-  return Math.ceil(((d.getTime() - yearStart.getTime()) / 86400000 + 1) / 7);
+  // ISO week number: ceil(day-of-year of the week's Thursday / 7). Computed
+  // entirely on UTC anchors — the same DST immunity plainDateDiffDays relies
+  // on — because mixing local-time instants leaks the host zone's DST offset
+  // into the day count. When Jan 1 is a Friday (so every Thursday's day-of-year
+  // is an exact multiple of 7), a one-hour offset from a zone whose DST ends
+  // after New Year rounds a whole week up: Sydney, Auckland and Santiago users
+  // saw week 15 for the week that is ISO week 14. utcTime keeps years 1-99
+  // as given, like the other Calendar date helpers.
+  const msPerDay = 24 * 60 * 60 * 1000;
+  const utcMidnight = utcTime(pd.year, pd.month - 1, pd.day);
+  const dayNum = new Date(utcMidnight).getUTCDay() || 7;
+  const thursday = utcMidnight + (4 - dayNum) * msPerDay;
+  const yearStart = utcTime(new Date(thursday).getUTCFullYear(), 0, 1);
+  const dayOfYear = (thursday - yearStart) / msPerDay + 1;
+  return Math.ceil(dayOfYear / 7);
 }
 
 // e.g. "Wednesday, May 21, 2026" (locale-dependent)