An open source design system that's fully customizable and agent ready
TypeScript
docs(i18n): a Calendars guide page for other calendar systems (#10017)
nynexman44649cba0a86707b
diff --git a/.changeset/i18n-calendars-guide.md b/.changeset/i18n-calendars-guide.mdnew file mode 100644index 0000000000..63ae6f054c--- /dev/null+++ b/.changeset/i18n-calendars-guide.md@@ -0,0 +1,8 @@+---+'@astryxdesign/cli': patch+'@astryxdesign/core': patch+---++[docs] Internationalization gains a short Other calendars guide: choose a calendar on `InternationalizationProvider` or `Calendar`, values stay Gregorian ISO dates, and most calendars need `Temporal` (load `temporal-polyfill/full/global` where it is missing). A new `astryx docs calendars` namespace has the detail: the supported calendars, loading `Temporal` on the server and in the browser, why the lunisolar calendars (`chinese`, `dangi`) can differ by a day between runtimes, and ISO 8601 week numbers. The guide and `Calendar`'s `calendar` prop docs say how to get identical server and browser markup for those calendars: `installImplementation()` from `temporal-polyfill/full/shim` on both sides, since the `full/global` import keeps a native `Temporal`.++@nynexman4464diff --git a/apps/docsite/src/__tests__/route-resolution.test.ts b/apps/docsite/src/__tests__/route-resolution.test.tsindex 5e862ccf74..00e320d698 100644--- a/apps/docsite/src/__tests__/route-resolution.test.ts+++ b/apps/docsite/src/__tests__/route-resolution.test.ts@@ -93,7 +93,8 @@ describe('route resolution', () => {// `cli-host-entry` are topics added since; `global` is the Global mode// page; `authoring` holds what CLI Integrations and Writing docs did;// `use-integrations` is the guide for apps that install one;- // `cli-experimental-render-pages` is the experimental render guide.+ // `cli-experimental-render-pages` is the experimental render guide;+ // `calendars` is the calendar systems page.const sidebarGuides = docTopics.filter(d => d.category === 'guide' && d.topic !== 'getting-started').map(d => d.topic)@@ -102,6 +103,7 @@ describe('route resolution', () => {['authoring','browser-support',+ 'calendars','cli-component-lookups','cli-experimental-icon-set-files','cli-experimental-icon-sets',@@ -123,6 +125,29 @@ describe('route resolution', () => {);});+ it('shows Calendars as its own guide page, listed right after Internationalization', () => {+ const calendars = pageBySlug.get('calendars');+ expect(calendars?.category).toBe('guide');+ expect(calendars?.sections.map(section => section.id)).toContain(+ 'lunisolar-calendars',+ );+ expect(docRedirects['calendars-calendar-systems']).toBe(+ '/docs/calendars#choose-a-calendar',+ );+ // The short guide stays on the Internationalization page.+ expect(docRedirects['internationalization-i18n-calendars']).toMatch(+ /^\/docs\/internationalization#/,+ );+ // The sidebar lists guides by title (DocsShell).+ const byTitle = docTopics+ .filter(d => d.category === 'guide' && d.topic !== 'getting-started')+ .sort((a, b) => a.title.localeCompare(b.title))+ .map(d => d.topic);+ expect(byTitle.indexOf('calendars')).toBe(+ byTitle.indexOf('internationalization') + 1,+ );+ });+it('opens every authoring guide at its section on the Authoring page, from its old slug too', () => {expect(pageBySlug.get('authoring')?.category).toBe('guide');let guides = 0;diff --git a/packages/cli/api/docs/docs.test.mjs b/packages/cli/api/docs/docs.test.mjsindex a8b01929e7..6a7f0470fe 100644--- a/packages/cli/api/docs/docs.test.mjs+++ b/packages/cli/api/docs/docs.test.mjs@@ -93,7 +93,7 @@ describe('docs() dispatcher routing', () => {it("lists the docs tree's namespaces in meta, so every data entry reads as a topic", async () => {const res = await docs();- expect(res.meta.namespaces.map(entry => entry.topic)).toEqual(['authoring', 'cli', 'foundations', 'global', 'guides', 'internationalization', 'layout', 'migration', 'styling', 'styling-libraries', 'tokens', 'typography']);+ expect(res.meta.namespaces.map(entry => entry.topic)).toEqual(['authoring', 'calendars', 'cli', 'foundations', 'global', 'guides', 'internationalization', 'layout', 'migration', 'styling', 'styling-libraries', 'tokens', 'typography']);for (const entry of res.data) {expect((await docs(entry.topic)).type).toBe('docs.detail');}diff --git a/packages/cli/assets/docs/tree/calendar-systems.doc.mjs b/packages/cli/assets/docs/tree/calendar-systems.doc.mjsnew file mode 100644index 0000000000..4ad7bb397a--- /dev/null+++ b/packages/cli/assets/docs/tree/calendar-systems.doc.mjs@@ -0,0 +1,146 @@+// Copyright (c) Meta Platforms, Inc. and affiliates.++/**+ * @file `astryx docs calendars/calendar-systems`: choosing a calendar, the+ * supported calendars, loading Temporal on the server and in the browser, the+ * lunisolar calendars, and week numbers.+ */++/** @type {import('@astryxdesign/cli/authoring').ReferenceDoc} */++export const docs = {+ type: 'generic',+ name: 'calendar-systems',+ title: 'Calendar systems',+ placement: {+ parent: 'namespace:calendars',+ slot: 'guides',+ order: 10,+ },+ category: 'guide',+ description:+ 'Choosing a calendar, which calendars need Temporal, server rendering, the lunisolar calendars, and week numbers.',++ sections: [+ {+ title: 'Choose a calendar',+ content: [+ {+ type: 'prose',+ text: '`Calendar` shows the Gregorian calendar unless you choose another one. Pass `calendar` to `<InternationalizationProvider>` to set it for a subtree. A locale on its own never changes the calendar: `fa-IR` shows Gregorian dates in Persian until you pass `calendar="persian"`. A locale with a `-u-ca-` keyword, such as `th-TH-u-ca-buddhist`, keeps Gregorian dates too; set `calendar` to choose one.',+ },+ {+ type: 'code',+ lang: 'tsx',+ label: 'Persian dates in a Persian interface',+ code: `import {InternationalizationProvider} from '@astryxdesign/core/i18n';+import {Calendar} from '@astryxdesign/core/Calendar';++<InternationalizationProvider locale="fa-IR" calendar="persian">+ {/* shows Aban 1405; value and onChange stay '2026-10-30' */}+ <Calendar value={date} onChange={setDate} />+</InternationalizationProvider>;`,+ },+ {+ type: 'prose',+ text: 'Calendar and language are independent: `locale="en" calendar="hebrew"` shows Hebrew dates in English. `Calendar` also takes its own `calendar`, which wins over the provider. Use it when one screen shows two calendars side by side.',+ },+ {+ type: 'prose',+ text: 'Values never change with the calendar. `value`, `defaultValue`, `onChange`, `min`, and `max` stay Gregorian ISO dates (`YYYY-MM-DD`) in every calendar, so your data, server code, and existing handlers keep working.',+ },+ ],+ },+ {+ title: 'Supported calendars',+ content: [+ {+ type: 'table',+ headers: ['Calendar', 'Identifiers', 'Needs Temporal'],+ rows: [+ ['Gregorian', '`gregory`, `iso8601`', 'No'],+ ['Buddhist (Thai)', '`buddhist`', 'No'],+ ['Minguo', '`roc`', 'No'],+ ['Japanese (eras)', '`japanese`', 'No'],+ ['Persian (Solar Hijri)', '`persian`', 'Yes'],+ ['Indian national (Saka)', '`indian`', 'Yes'],+ ['Hebrew', '`hebrew`', 'Yes'],+ [+ 'Islamic (Hijri)',+ '`islamic-umalqura`, `islamic-civil`, `islamic-tbla`',+ 'Yes',+ ],+ ['Lunisolar', '`chinese`, `dangi`', 'Yes'],+ ['Coptic', '`coptic`', 'Yes'],+ ['Ethiopian', '`ethiopic`, `ethioaa`', 'Yes'],+ ],+ },+ {+ type: 'prose',+ text: 'Any other identifier, such as `islamic`, shows Gregorian dates and warns once in development.',+ },+ ],+ },+ {+ title: 'Load Temporal where the runtime lacks it',+ content: [+ {+ type: 'prose',+ text: "Calendars whose months are not Gregorian use the runtime's `Temporal` for their month lengths, leap months, and years. Chrome and Edge 144 and later, Firefox 139 and later, and Node.js 26 and later ship it. Safari and older runtimes do not. Astryx bundles no polyfill, so Gregorian applications pay nothing.",+ },+ {+ type: 'prose',+ text: 'Where `Temporal` is missing, load the full build of `temporal-polyfill` before your app renders. The default build has no non-ISO calendars. Load it only where `Temporal` is missing: a native implementation is more accurate for the lunisolar calendars.',+ },+ {+ type: 'code',+ lang: 'ts',+ label: 'Load the polyfill only where Temporal is missing',+ code: `// temporal-setup.ts: import before your app renders, on the server and in the browser+if (!('Temporal' in globalThis)) {+ await import('temporal-polyfill/full/global');+}`,+ },+ {+ type: 'prose',+ text: 'If you render on the server, load it there too. `Calendar` resolves its calendar during render, so a server without `Temporal` renders Gregorian dates, and a browser with it renders Persian ones: hydration then fails. When both have `Temporal`, or both lack it, they render the same markup.',+ },+ {+ type: 'prose',+ text: 'Without a `Temporal` that supports it, a calendar that needs one shows Gregorian dates and warns once in development, on the server and in the browser. The Gregorian-aligned calendars (`buddhist`, `roc`, `japanese`) work everywhere without it.',+ },+ ],+ },+ {+ title: 'Lunisolar calendars',+ content: [+ {+ type: 'prose',+ text: "In the lunisolar calendars, months start on new moons computed from astronomy, and runtimes do not all agree on a few of them. Astryx follows the runtime's `Temporal` and does not correct it.",+ },+ {+ type: 'list',+ style: 'unordered',+ items: [+ 'Native `Temporal` in Chrome, Edge, Firefox, and Node.js 26 agrees with official observatory data from 1900 through 2100.',+ "A polyfill reads the platform's `Intl` data instead. Under a polyfill, Node.js 24 starts nine `chinese` and four `dangi` months in that range one day apart from the native result: the first month of the 2027 `chinese` year starts on February 6 with native `Temporal` and on February 7 under the polyfill. Safari uses the same kind of `Intl` data, so expect the same differences there.",+ 'Within one browser, the day numbers a person sees, the dates a screen reader announces, and the value they pick agree. Only two different runtimes can disagree.',+ ],+ },+ {+ type: 'prose',+ text: 'If you render on the server, a server and a browser that use different implementations can disagree on one of these month starts. The browser then renders that month differently from the server markup, and React renders that part again on the client during hydration. The `temporal-polyfill/full/global` import keeps a native `Temporal` where one exists, so on its own it leaves Chrome, Edge, and Firefox on native `Temporal` and a Node.js 24 server on the polyfill. When identical server and browser markup for these calendars matters more than matching official data, call `installImplementation()` from `temporal-polyfill/full/shim` on the server and in the browser before rendering: it installs the polyfill even over a native `Temporal`. A server runtime with native `Temporal`, such as Node.js 26, also matches native browsers. Otherwise, do not replace a native `Temporal`: that makes native environments less accurate.',+ },+ ],+ },+ {+ title: 'Week numbers',+ content: [+ {+ type: 'prose',+ text: "`Calendar`'s `hasWeekNumbers` shows ISO 8601 week numbers in every calendar. Temporal defines week numbering only for the ISO calendar.",+ },+ ],+ },+ ],+};diff --git a/packages/cli/assets/docs/tree/calendars.doc.mjs b/packages/cli/assets/docs/tree/calendars.doc.mjsnew file mode 100644index 0000000000..87f1b7cb35--- /dev/null+++ b/packages/cli/assets/docs/tree/calendars.doc.mjs@@ -0,0 +1,46 @@+// Copyright (c) Meta Platforms, Inc. and affiliates.++/**+ * @file `astryx docs calendars`: calendar systems in detail. Which calendars+ * date components show, how to load Temporal, server rendering, and the+ * lunisolar calendars. The `internationalization/i18n-calendars` guide has the+ * short version.+ */++/** @type {import('@astryxdesign/cli/authoring').NamespaceDoc} */+export const docs = {+ type: 'namespace',+ name: 'calendars',+ // The docsite lists guide pages by title, so this one sorts directly below+ // Internationalization, the page that links here.+ title: 'Internationalization: calendars',+ summary:+ 'Show dates in the Persian, Hebrew, Islamic, Buddhist, Japanese, lunisolar, and other calendars while values stay Gregorian ISO dates.',+ keywords: [+ 'calendar',+ 'calendar system',+ 'Persian',+ 'Jalali',+ 'Hebrew',+ 'Hijri',+ 'Islamic',+ 'Buddhist',+ 'Japanese era',+ 'lunisolar',+ 'chinese',+ 'dangi',+ 'Ethiopian',+ 'Temporal',+ 'polyfill',+ 'u-ca',+ ],+ slots: {+ guides: {title: 'Guides', accepts: {kinds: ['generic']}},+ },+ blocks: [+ {+ type: 'prose',+ text: '`Calendar` shows the Gregorian calendar unless the application chooses another one; DateInput, DateRangeInput, and DateTimeInput stay Gregorian. Values never change with the calendar: they stay Gregorian ISO dates. {@link generic:i18n-calendars} has the short version.',+ },+ ],+};diff --git a/packages/cli/assets/docs/tree/i18n-calendars.doc.mjs b/packages/cli/assets/docs/tree/i18n-calendars.doc.mjsnew file mode 100644index 0000000000..253abde503--- /dev/null+++ b/packages/cli/assets/docs/tree/i18n-calendars.doc.mjs@@ -0,0 +1,51 @@+// Copyright (c) Meta Platforms, Inc. and affiliates.++/**+ * @file `astryx docs internationalization/i18n-calendars`: the short version of+ * showing dates in another calendar. The `calendars` namespace holds the+ * detail.+ */++/** @type {import('@astryxdesign/cli/authoring').ReferenceDoc} */++export const docs = {+ type: 'generic',+ name: 'i18n-calendars',+ title: 'Other calendars',+ placement: {+ parent: 'namespace:internationalization',+ slot: 'guides',+ order: 25,+ },+ category: 'guide',+ description:+ 'Show dates in the Persian, Hebrew, Islamic, Buddhist, Japanese, and other calendars while values stay Gregorian ISO dates.',++ sections: [+ {+ title: 'Show dates in another calendar',+ content: [+ {+ type: 'prose',+ text: 'Set `calendar` on `<InternationalizationProvider>` for a subtree, or on `Calendar` itself; without it, `Calendar` is Gregorian. Values stay Gregorian ISO dates (`YYYY-MM-DD`) in every calendar.',+ },+ {+ type: 'code',+ lang: 'tsx',+ label: 'Persian dates in a Persian interface',+ code: `import {InternationalizationProvider} from '@astryxdesign/core/i18n';+import {Calendar} from '@astryxdesign/core/Calendar';++<InternationalizationProvider locale="fa-IR" calendar="persian">+ {/* shows Aban 1405; value and onChange stay '2026-10-30' */}+ <Calendar value={date} onChange={setDate} />+</InternationalizationProvider>;`,+ },+ {+ type: 'prose',+ text: "Most calendars need the runtime's `Temporal`. Safari and older runtimes lack it: load `temporal-polyfill/full/global` there, on the server and in the browser. Without it, those calendars show Gregorian dates. See {@link namespace:calendars} for the supported calendars, server rendering, and the lunisolar calendars.",+ },+ ],+ },+ ],+};diff --git a/packages/cli/assets/docs/tree/internationalization.doc.mjs b/packages/cli/assets/docs/tree/internationalization.doc.mjsindex 5eb287648f..8801e36e2a 100644--- a/packages/cli/assets/docs/tree/internationalization.doc.mjs+++ b/packages/cli/assets/docs/tree/internationalization.doc.mjs@@ -2,8 +2,8 @@/*** @file `astryx docs internationalization`: the internationalization namespace.- * Groups guides for quick-start locale setup, library integration, and- * RTL + testing.+ * Groups guides for quick-start locale setup, library integration, calendars,+ * and RTL + testing.*//** @type {import('@astryxdesign/cli/authoring').NamespaceDoc} */@@ -12,7 +12,7 @@ export const docs = {name: 'internationalization',title: 'Internationalization',summary:- 'Set the active locale, load catalogs, coexist with your own i18n library, handle RTL, and test translations.',+ 'Set the active locale, load catalogs, coexist with your own i18n library, show other calendars, handle RTL, and test translations.',keywords: ['i18n','internationalization',diff --git a/packages/cli/foundation/doc-compiler/tree.test.mjs b/packages/cli/foundation/doc-compiler/tree.test.mjsindex 309d35fba2..87ca3c7d21 100644--- a/packages/cli/foundation/doc-compiler/tree.test.mjs+++ b/packages/cli/foundation/doc-compiler/tree.test.mjs@@ -536,7 +536,7 @@ describe("the CLI's own docs tree", () => {async () => {const tree = await loadDocsTree({fresh: true});expect(tree.diagnostics).toEqual([]);- expect(tree.roots().map(node => node.route)).toEqual(['authoring', 'cli', 'global', 'internationalization', 'layout', 'migration', 'styling', 'styling-libraries', 'tokens', 'typography']);+ expect(tree.roots().map(node => node.route)).toEqual(['authoring', 'calendars', 'cli', 'global', 'internationalization', 'layout', 'migration', 'styling', 'styling-libraries', 'tokens', 'typography']);// Every slot child is a node one level below the namespace that places// it, and every node but the root is placed. Read from the tree, so a// restructure of the guides does not need this test edited.diff --git a/packages/cli/test/__golden__/docs-list.json b/packages/cli/test/__golden__/docs-list.jsonindex edbe5fe334..89e83123b0 100644--- a/packages/cli/test/__golden__/docs-list.json+++ b/packages/cli/test/__golden__/docs-list.json@@ -15,6 +15,11 @@"description": "Build an npm package that adds components, templates, themes, docs, and codemods to Astryx apps, and look up every field of every file it holds.","package": "@astryxdesign/cli"},+ {+ "topic": "calendars",+ "description": "Show dates in the Persian, Hebrew, Islamic, Buddhist, Japanese, lunisolar, and other calendars while values stay Gregorian ISO dates.",+ "package": "@astryxdesign/cli"+ },{"topic": "cli","description": "Commands, programmatic APIs, and output contracts. Building an integration is under `astryx docs authoring`.",@@ -37,7 +42,7 @@},{"topic": "internationalization",- "description": "Set the active locale, load catalogs, coexist with your own i18n library, handle RTL, and test translations.",+ "description": "Set the active locale, load catalogs, coexist with your own i18n library, show other calendars, handle RTL, and test translations.","package": "@astryxdesign/cli"},{diff --git a/packages/cli/test/__golden__/no-icon-set/docs-tree.json b/packages/cli/test/__golden__/no-icon-set/docs-tree.jsonindex f124e06bd7..b00e686f52 100644--- a/packages/cli/test/__golden__/no-icon-set/docs-tree.json+++ b/packages/cli/test/__golden__/no-icon-set/docs-tree.json@@ -690,6 +690,24 @@],"mentions": []},+ "calendars": {+ "type": "docs.node",+ "children": [+ "calendars/calendar-systems"+ ],+ "mentions": []+ },+ "calendars/calendar-systems": {+ "type": "docs.detail",+ "sections": [+ "choose-a-calendar",+ "supported-calendars",+ "load-temporal-where-the-runtime-lacks-it",+ "lunisolar-calendars",+ "week-numbers"+ ],+ "mentions": []+ },"color": {"type": "docs.detail","sections": [@@ -926,10 +944,18 @@"children": ["internationalization/i18n-quick-start","internationalization/i18n-library-integration",+ "internationalization/i18n-calendars","internationalization/i18n-rtl-and-testing"],"mentions": []},+ "internationalization/i18n-calendars": {+ "type": "docs.detail",+ "sections": [+ "show-dates-in-another-calendar"+ ],+ "mentions": []+ },"internationalization/i18n-library-integration": {"type": "docs.detail","sections": [diff --git a/packages/cli/test/__golden__/no-icon-set/doctor-doc-counts.txt b/packages/cli/test/__golden__/no-icon-set/doctor-doc-counts.txtindex e3054c5150..f108ee2f9f 100644--- a/packages/cli/test/__golden__/no-icon-set/doctor-doc-counts.txt+++ b/packages/cli/test/__golden__/no-icon-set/doctor-doc-counts.txt@@ -1,4 +1,4 @@authoring-docs: <text> 19cli-docs: <text> 101 82 19-docs-tree: <text> 199 31 12-docs-progressive-disclosure: <text> 117 32+docs-tree: <text> 201 32 13+docs-progressive-disclosure: <text> 119 32diff --git a/packages/cli/test/__golden__/no-icon-set/doctor-installed-set.json b/packages/cli/test/__golden__/no-icon-set/doctor-installed-set.jsonindex 716479f1b3..20af76fde9 100644--- a/packages/cli/test/__golden__/no-icon-set/doctor-installed-set.json+++ b/packages/cli/test/__golden__/no-icon-set/doctor-installed-set.json@@ -116,13 +116,13 @@"id": "docs-tree","label": "<text>","status": "pass",- "message": "<text> 199 31 12"+ "message": "<text> 201 32 13"},{"id": "docs-progressive-disclosure","label": "<text>","status": "pass",- "message": "<text> 117 32"+ "message": "<text> 119 32"}],"summary": {diff --git a/packages/cli/test/__golden__/no-icon-set/search-icon-set.json b/packages/cli/test/__golden__/no-icon-set/search-icon-set.jsonindex 3061911c60..e6d0b16836 100644--- a/packages/cli/test/__golden__/no-icon-set/search-icon-set.json+++ b/packages/cli/test/__golden__/no-icon-set/search-icon-set.json@@ -3,7 +3,7 @@"type": "search","data": {"query": "icon set",- "matchCount": 379,+ "matchCount": 381,"results": [{"domain": "doc",diff --git a/packages/cli/test/__golden__/no-icon-set/search-icon-set.txt b/packages/cli/test/__golden__/no-icon-set/search-icon-set.txtindex 63d2e678c3..1ac0496831 100644--- a/packages/cli/test/__golden__/no-icon-set/search-icon-set.txt+++ b/packages/cli/test/__golden__/no-icon-set/search-icon-set.txt@@ -1,4 +1,4 @@-Results for "icon set" (20 of 379)+Results for "icon set" (20 of 381)name: authoring/building-blocks/templates/build-the-template/template-assets/template-iconssection: use-astryx-icondomain: docdiff --git a/packages/core/src/Calendar/Calendar.doc.mjs b/packages/core/src/Calendar/Calendar.doc.mjsindex 8777556868..0a90586ea1 100644--- a/packages/core/src/Calendar/Calendar.doc.mjs+++ b/packages/core/src/Calendar/Calendar.doc.mjs@@ -196,7 +196,7 @@ export const docs = {name: 'calendar',type: "'gregory' | 'iso8601' | 'buddhist' | 'roc' | 'japanese' | 'persian' | 'indian' | 'hebrew' | 'chinese' | 'dangi' | 'coptic' | 'ethiopic' | 'ethioaa' | 'islamic-civil' | 'islamic-tbla' | 'islamic-umalqura'",description:- "Calendar system the grid shows, such as 'persian', 'hebrew', or 'islamic-umalqura'. It sets the months, their names, and month and year navigation. value, min, max, focusDate, and every callback stay Gregorian ISO dates. Calendars other than gregory, iso8601, buddhist, roc, and japanese need Temporal; where the runtime lacks it, load a polyfill such as temporal-polyfill/full/global on the server and in the browser, or the grid shows Gregorian months. Month starts in the Chinese and Dangi calendars come from the runtime's Temporal, and some polyfills start a few months one day apart from native Temporal; when you render on the server, load the same Temporal implementation on the server and in the browser.",+ "Calendar system the grid shows, such as 'persian', 'hebrew', or 'islamic-umalqura'. It sets the months, their names, and month and year navigation. value, min, max, focusDate, and every callback stay Gregorian ISO dates. Calendars other than gregory, iso8601, buddhist, roc, and japanese need Temporal; where the runtime lacks it, load a polyfill such as temporal-polyfill/full/global on the server and in the browser, or the grid shows Gregorian months. Month starts in the Chinese and Dangi calendars come from the runtime's Temporal, and some polyfills start a few months one day apart from native Temporal; when server and browser markup must match, use one implementation on both sides, such as installImplementation() from temporal-polyfill/full/shim, which replaces a native Temporal.",default: 'the InternationalizationProvider calendar, else gregory',},],@@ -386,7 +386,7 @@ export const docsZh = {name: 'calendar',type: "'gregory' | 'iso8601' | 'buddhist' | 'roc' | 'japanese' | 'persian' | 'indian' | 'hebrew' | 'chinese' | 'dangi' | 'coptic' | 'ethiopic' | 'ethioaa' | 'islamic-civil' | 'islamic-tbla' | 'islamic-umalqura'",description:- "网格显示的历法,如 'persian'、'hebrew' 或 'islamic-umalqura'。它决定月份、月份名称以及按月和按年的导航。value、min、max、focusDate 和所有回调仍为公历 ISO 日期。gregory、iso8601、buddhist、roc 和 japanese 以外的历法需要 Temporal;运行环境没有 Temporal 时,请在服务端和浏览器中加载 polyfill(如 temporal-polyfill/full/global),否则网格显示公历月份。农历(chinese)和檀纪历(dangi)的月初取自运行环境的 Temporal,部分 polyfill 与原生 Temporal 有少数月份的月初相差一天;服务端渲染时,请在服务端和浏览器中加载同一种 Temporal 实现。",+ "网格显示的历法,如 'persian'、'hebrew' 或 'islamic-umalqura'。它决定月份、月份名称以及按月和按年的导航。value、min、max、focusDate 和所有回调仍为公历 ISO 日期。gregory、iso8601、buddhist、roc 和 japanese 以外的历法需要 Temporal;运行环境没有 Temporal 时,请在服务端和浏览器中加载 polyfill(如 temporal-polyfill/full/global),否则网格显示公历月份。农历(chinese)和檀纪历(dangi)的月初取自运行环境的 Temporal,部分 polyfill 与原生 Temporal 有少数月份的月初相差一天;服务端渲染且需要两端标记一致时,请在两端使用同一种实现,例如 temporal-polyfill/full/shim 的 installImplementation(),它会替换原生 Temporal。",default: 'InternationalizationProvider 的历法,否则为 gregory',},],