@polyxd/ds-antd 0.1.0

package/LICENSE

@@ -0,0 +1,202 @@
+                                 Apache License
+                           Version 2.0, January 2004
+                        http://www.apache.org/licenses/
+
+   TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+   1. Definitions.
+
+      "License" shall mean the terms and conditions for use, reproduction,
+      and distribution as defined by Sections 1 through 9 of this document.
+
+      "Licensor" shall mean the copyright owner or entity authorized by
+      the copyright owner that is granting the License.
+
+      "Legal Entity" shall mean the union of the acting entity and all
+      other entities that control, are controlled by, or are under common
+      control with that entity. For the purposes of this definition,
+      "control" means (i) the power, direct or indirect, to cause the
+      direction or management of such entity, whether by contract or
+      otherwise, or (ii) ownership of fifty percent (50%) or more of the
+      outstanding shares, or (iii) beneficial ownership of such entity.
+
+      "You" (or "Your") shall mean an individual or Legal Entity
+      exercising permissions granted by this License.
+
+      "Source" form shall mean the preferred form for making modifications,
+      including but not limited to software source code, documentation
+      source, and configuration files.
+
+      "Object" form shall mean any form resulting from mechanical
+      transformation or translation of a Source form, including but
+      not limited to compiled object code, generated documentation,
+      and conversions to other media types.
+
+      "Work" shall mean the work of authorship, whether in Source or
+      Object form, made available under the License, as indicated by a
+      copyright notice that is included in or attached to the work
+      (an example is provided in the Appendix below).
+
+      "Derivative Works" shall mean any work, whether in Source or Object
+      form, that is based on (or derived from) the Work and for which the
+      editorial revisions, annotations, elaborations, or other modifications
+      represent, as a whole, an original work of authorship. For the purposes
+      of this License, Derivative Works shall not include works that remain
+      separable from, or merely link (or bind by name) to the interfaces of,
+      the Work and Derivative Works thereof.
+
+      "Contribution" shall mean any work of authorship, including
+      the original version of the Work and any modifications or additions
+      to that Work or Derivative Works thereof, that is intentionally
+      submitted to Licensor for inclusion in the Work by the copyright owner
+      or by an individual or Legal Entity authorized to submit on behalf of
+      the copyright owner. For the purposes of this definition, "submitted"
+      means any form of electronic, verbal, or written communication sent
+      to the Licensor or its representatives, including but not limited to
+      communication on electronic mailing lists, source code control systems,
+      and issue tracking systems that are managed by, or on behalf of, the
+      Licensor for the purpose of discussing and improving the Work, but
+      excluding communication that is conspicuously marked or otherwise
+      designated in writing by the copyright owner as "Not a Contribution."
+
+      "Contributor" shall mean Licensor and any individual or Legal Entity
+      on behalf of whom a Contribution has been received by Licensor and
+      subsequently incorporated within the Work.
+
+   2. Grant of Copyright License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      copyright license to reproduce, prepare Derivative Works of,
+      publicly display, publicly perform, sublicense, and distribute the
+      Work and such Derivative Works in Source or Object form.
+
+   3. Grant of Patent License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      (except as stated in this section) patent license to make, have made,
+      use, offer to sell, sell, import, and otherwise transfer the Work,
+      where such license applies only to those patent claims licensable
+      by such Contributor that are necessarily infringed by their
+      Contribution(s) alone or by combination of their Contribution(s)
+      with the Work to which such Contribution(s) was submitted. If You
+      institute patent litigation against any entity (including a
+      cross-claim or counterclaim in a lawsuit) alleging that the Work
+      or a Contribution incorporated within the Work constitutes direct
+      or contributory patent infringement, then any patent licenses
+      granted to You under this License for that Work shall terminate
+      as of the date such litigation is filed.
+
+   4. Redistribution. You may reproduce and distribute copies of the
+      Work or Derivative Works thereof in any medium, with or without
+      modifications, and in Source or Object form, provided that You
+      meet the following conditions:
+
+      (a) You must give any other recipients of the Work or
+          Derivative Works a copy of this License; and
+
+      (b) You must cause any modified files to carry prominent notices
+          stating that You changed the files; and
+
+      (c) You must retain, in the Source form of any Derivative Works
+          that You distribute, all copyright, patent, trademark, and
+          attribution notices from the Source form of the Work,
+          excluding those notices that do not pertain to any part of
+          the Derivative Works; and
+
+      (d) If the Work includes a "NOTICE" text file as part of its
+          distribution, then any Derivative Works that You distribute must
+          include a readable copy of the attribution notices contained
+          within such NOTICE file, excluding those notices that do not
+          pertain to any part of the Derivative Works, in at least one
+          of the following places: within a NOTICE text file distributed
+          as part of the Derivative Works; within the Source form or
+          documentation, if provided along with the Derivative Works; or,
+          within a display generated by the Derivative Works, if and
+          wherever such third-party notices normally appear. The contents
+          of the NOTICE file are for informational purposes only and
+          do not modify the License. You may add Your own attribution
+          notices within Derivative Works that You distribute, alongside
+          or as an addendum to the NOTICE text from the Work, provided
+          that such additional attribution notices cannot be construed
+          as modifying the License.
+
+      You may add Your own copyright statement to Your modifications and
+      may provide additional or different license terms and conditions
+      for use, reproduction, or distribution of Your modifications, or
+      for any such Derivative Works as a whole, provided Your use,
+      reproduction, and distribution of the Work otherwise complies with
+      the conditions stated in this License.
+
+   5. Submission of Contributions. Unless You explicitly state otherwise,
+      any Contribution intentionally submitted for inclusion in the Work
+      by You to the Licensor shall be under the terms and conditions of
+      this License, without any additional terms or conditions.
+      Notwithstanding the above, nothing herein shall supersede or modify
+      the terms of any separate license agreement you may have executed
+      with Licensor regarding such Contributions.
+
+   6. Trademarks. This License does not grant permission to use the trade
+      names, trademarks, service marks, or product names of the Licensor,
+      except as required for reasonable and customary use in describing the
+      origin of the Work and reproducing the content of the NOTICE file.
+
+   7. Disclaimer of Warranty. Unless required by applicable law or
+      agreed to in writing, Licensor provides the Work (and each
+      Contributor provides its Contributions) on an "AS IS" BASIS,
+      WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+      implied, including, without limitation, any warranties or conditions
+      of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
+      PARTICULAR PURPOSE. You are solely responsible for determining the
+      appropriateness of using or redistributing the Work and assume any
+      risks associated with Your exercise of permissions under this License.
+
+   8. Limitation of Liability. In no event and under no legal theory,
+      whether in tort (including negligence), contract, or otherwise,
+      unless required by applicable law (such as deliberate and grossly
+      negligent acts) or agreed to in writing, shall any Contributor be
+      liable to You for damages, including any direct, indirect, special,
+      incidental, or consequential damages of any character arising as a
+      result of this License or out of the use or inability to use the
+      Work (including but not limited to damages for loss of goodwill,
+      work stoppage, computer failure or malfunction, or any and all
+      other commercial damages or losses), even if such Contributor
+      has been advised of the possibility of such damages.
+
+   9. Accepting Warranty or Additional Liability. While redistributing
+      the Work or Derivative Works thereof, You may choose to offer,
+      and charge a fee for, acceptance of support, warranty, indemnity,
+      or other liability obligations and/or rights consistent with this
+      License. However, in accepting such obligations, You may act only
+      on Your own behalf and on Your sole responsibility, not on behalf
+      of any other Contributor, and only if You agree to indemnify,
+      defend, and hold each Contributor harmless for any liability
+      incurred by, or claims asserted against, such Contributor by reason
+      of your accepting any such warranty or additional liability.
+
+   END OF TERMS AND CONDITIONS
+
+   APPENDIX: How to apply the Apache License to your work.
+
+      To apply the Apache License to your work, attach the following
+      boilerplate notice, with the fields enclosed by brackets "[]"
+      replaced with your own identifying information. (Don't include
+      the brackets!)  The text should be enclosed in the appropriate
+      comment syntax for the file format. We also recommend that a
+      file or class name and description of purpose be included on the
+      same "printed page" as the copyright notice for easier
+      identification within third-party archives.
+
+   Copyright [yyyy] [name of copyright owner]
+
+   Licensed under the Apache License, Version 2.0 (the "License");
+   you may not use this file except in compliance with the License.
+   You may obtain a copy of the License at
+
+       http://www.apache.org/licenses/LICENSE-2.0
+
+   Unless required by applicable law or agreed to in writing, software
+   distributed under the License is distributed on an "AS IS" BASIS,
+   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+   See the License for the specific language governing permissions and
+   limitations under the License.
+

package/NOTICE

@@ -0,0 +1,177 @@
+Polyxd
+Copyright 2026 the Polyxd authors
+
+This product includes software developed at Polyxd, licensed under the Apache
+License, Version 2.0 (see LICENSE).
+
+It also includes material from the projects below. Each is used under its own
+licence, and each licence is included in full beside the material it covers.
+
+
+## Design-system packs
+
+A pack reads a design system's published tokens and maps them onto Polyxd's
+semantic token contract. The upstream token files are vendored verbatim — so a
+pack can be regenerated and audited without a network — under that pack's
+`scripts/sources/` directory, together with the upstream licence.
+
+The packs are Polyxd's work, not the work of the design systems they read. The
+names below identify whose tokens a pack reads. Polyxd is not affiliated with,
+endorsed by, or sponsored by any of these projects or their owners, and each
+name is the trademark of its owner.
+
+### Ant Design  (`@polyxd/ds-antd`)
+
+Upstream: https://github.com/ant-design/ant-design
+
+- npm:antd 6.6.4 — MIT
+- npm:@ant-design/colors 8.0.1 — MIT
+
+Vendored under `packages/ds-antd/scripts/sources/`, with the upstream licence file beside it.
+
+### Bootstrap 5  (`@polyxd/ds-bootstrap`)
+
+Upstream: https://github.com/twbs/bootstrap
+
+- npm:bootstrap dist/css/bootstrap.css 5.3.8 — MIT
+
+Vendored under `packages/ds-bootstrap/scripts/sources/`, with the upstream licence file beside it.
+
+### IBM Carbon  (`@polyxd/ds-carbon`)
+
+Upstream: https://github.com/carbon-design-system/carbon
+
+- npm:@carbon/colors 11.58.0 — Apache-2.0
+- npm:@carbon/themes 11.81.0 — Apache-2.0
+- npm:@carbon/layout 11.59.0 — Apache-2.0
+- npm:@carbon/type 11.67.0 — Apache-2.0
+- npm:@carbon/motion 11.52.0 — Apache-2.0
+- npm:@carbon/charts scss/_color-palette.scss 1.27.20 — Apache-2.0
+- npm:@carbon/styles scss/utilities/_box-shadow.scss and _focus-outline.scss 1.115.0 — Apache-2.0
+
+Vendored under `packages/ds-carbon/scripts/sources/`, with the upstream licence file beside it.
+
+### Chakra UI 3  (`@polyxd/ds-chakra`)
+
+Upstream: https://github.com/chakra-ui/chakra-ui
+
+- npm:@chakra-ui/react defaultSystem.getTokenCss 3.37.0 — MIT
+
+Vendored under `packages/ds-chakra/scripts/sources/`, with the upstream licence file beside it.
+
+### Microsoft Fluent 2  (`@polyxd/ds-fluent`)
+
+Upstream: https://github.com/microsoft/fluentui
+
+- npm:@fluentui/tokens 1.0.0-alpha.24 — MIT
+
+Vendored under `packages/ds-fluent/scripts/sources/`, with the upstream licence file beside it.
+
+### GOV.UK Frontend  (`@polyxd/ds-govuk`)
+
+Upstream: https://github.com/alphagov/govuk-frontend
+
+- npm:govuk-frontend dist/govuk/settings 6.5.1 — MIT
+
+Vendored under `packages/ds-govuk/scripts/sources/`, with the upstream licence file beside it.
+
+### Mantine 8  (`@polyxd/ds-mantine`)
+
+Upstream: https://github.com/mantinedev/mantine
+
+- npm:@mantine/core styles.css 8.4.2 — MIT
+
+Vendored under `packages/ds-mantine/scripts/sources/`, with the upstream licence file beside it.
+
+### Material 3  (`@polyxd/ds-material3`)
+
+Upstream: https://github.com/material-components/material-web
+
+- npm:@material/material-color-utilities 0.4.0 — Apache-2.0
+- github:material-components/material-web tokens/versions/v0_192/_md-ref-typeface.scss, _md-sys-typescale.scss, _md-sys-shape.scss, _md-sys-motion.scss, _md-sys-state.scss, _md-sys-elevation.scss v2.5.0 (commit b4de401eb665ec63474f39319a4ba8f2145974cc) — Apache-2.0
+- github:material-components/material-web tokens/versions/v0_192/_md-comp-scrim.scss, _md-comp-filled-button.scss, _md-comp-icon-button.scss, _md-comp-outlined-text-field.scss v2.5.0 (commit b4de401eb665ec63474f39319a4ba8f2145974cc) — Apache-2.0
+- github:material-components/material-web tokens/_md-comp-focus-ring.scss and elevation/internal/_elevation.scss v2.5.0 (commit b4de401eb665ec63474f39319a4ba8f2145974cc) — Apache-2.0
+
+Vendored under `packages/ds-material3/scripts/sources/`, with the upstream licence file beside it.
+
+### Shopify Polaris  (`@polyxd/ds-polaris`)
+
+Upstream: https://github.com/Shopify/polaris
+
+- npm:@shopify/polaris-tokens dist/css/styles.css 9.4.2 — MIT
+
+Vendored under `packages/ds-polaris/scripts/sources/`, with the upstream licence file beside it.
+
+### GitHub Primer  (`@polyxd/ds-primer`)
+
+Upstream: https://github.com/primer/primitives
+
+- npm:@primer/primitives dist/css 11.10.0 — MIT
+
+Vendored under `packages/ds-primer/scripts/sources/`, with the upstream licence file beside it.
+
+### Radix Themes 3  (`@polyxd/ds-radix`)
+
+Upstream: https://github.com/radix-ui/themes
+
+- npm:@radix-ui/themes styles.css 3.3.0 — MIT
+
+Vendored under `packages/ds-radix/scripts/sources/`, with the upstream licence file beside it.
+
+### shadcn/ui on Tailwind CSS  (`@polyxd/ds-shadcn`)
+
+Upstream: https://github.com/shadcn-ui/ui
+
+- shadcn/ui default theme main @ 2026-09-20 — MIT
+- npm:tailwindcss theme.css 4.3.3 — MIT
+
+Vendored under `packages/ds-shadcn/scripts/sources/`, with the upstream licence file beside it.
+
+### Adobe Spectrum 2  (`@polyxd/ds-spectrum`)
+
+Upstream: https://github.com/adobe/spectrum-tokens
+
+- npm:@adobe/spectrum-tokens dist/json/variables.json 15.4.1 — Apache-2.0
+
+Vendored under `packages/ds-spectrum/scripts/sources/`, with the upstream licence file beside it.
+
+## Specification
+
+### A2UI
+
+- `packages/a2ui/vendor/a2ui/v1_0-04e6f07/` — Apache-2.0
+
+Vendored at a pinned commit so the component catalogue can be checked against
+A2UI's schema without a network.
+
+
+## Dependencies
+
+Everything Polyxd depends on at runtime or to build is fetched from npm rather
+than vendored, so the licences below are recorded rather than reproduced.
+
+Apache-2.0: playwright
+MIT: react, react-dom, radix-ui, ajv, ajv-formats, vite, @vitejs/plugin-react,
+     marked, lenis, @types/react, @types/react-dom
+MIT OR Apache-2.0: wrangler, @cloudflare/workers-types
+
+Two need a word.
+
+**axe-core** (Mozilla Public License 2.0) runs inside the verifier's rendered
+audit. MPL-2.0 is file-level copyleft: it attaches to modified MPL files, and
+axe-core is used unmodified, as a library. No Polyxd file is covered by it.
+
+**GSAP** (https://gsap.com/standard-license) drives the motion on polyxd.com
+only, and is not an OSI-approved licence. It is not used by the spec, the
+renderer, the packs or the verifier, none of which it can reach; and no GSAP
+file is committed to this repository — the site's build copies them out of
+node_modules into its own output. Anyone building the site is therefore subject
+to GSAP's licence, and anyone using the rest of Polyxd is not.
+
+
+## Fonts
+
+No font files are distributed. polyxd.com loads its typefaces from Google Fonts
+at request time, and a design-system pack names the typeface its system
+specifies without shipping it — a pack that asks for Adobe Clean, for example,
+names an open metric-compatible fallback for anyone who does not have it.

package/README.md

@@ -0,0 +1,120 @@
+# @polyxd/ds-antd
+
+The Ant Design design-system pack for Polyxd. It has DTCG 2025.10 token files that satisfy the Polyxd semantic token contract (`packages/spec/tokens/semantic-contract.json`, v0.1.0) in `light` and `dark` modes.
+
+```sh
+npm run check -w @polyxd/ds-antd     # contract check, both modes
+npm run generate -w @polyxd/ds-antd  # regenerate tokens/*.json
+```
+
+## Tiers
+
+Ant's own token names are kept as they are, so you can trace every semantic token back to `theme.useToken()` / `ConfigProvider` names.
+
+| Tier | File | Contents |
+|---|---|---|
+| Reference (primitive) | `tokens/primitive.json` | `antd.seed.*` (the default seed: `colorPrimary`, `fontSize`, `borderRadius`, `controlHeight`, `motionUnit`, preset seed colours, …). `antd.palette.<preset>.1..10` (`presetPalettes`, e.g. `antd.palette.blue.6`) and `antd.paletteDark.<preset>.1..10` (`presetDarkPalettes`). `antd.palette.{primary,success,warning,error,info}.1..10` and the `paletteDark` equivalents: the palettes each algorithm derives from the colour seeds. |
+| System | `tokens/system.json` | `antd.token.*` map/alias tokens with the same value in both algorithms: `fontSize*`, `lineHeight*`, `fontFamily`, `borderRadius*`, `controlHeight*`, `padding*`, `margin*`, `size*`, `lineWidth*`, `motionDuration*`, `motionEase*`, `screen*`, `zIndex*`, … Tokens the seed passes through unchanged alias `antd.seed.*`. Polyxd additions: `polyxd.sys.{font,radius,motion,focus,state.disabled}`. |
+| System, per mode | `tokens/system.light.json`, `tokens/system.dark.json` | `antd.token.*` colour and `boxShadow*` tokens from `defaultAlgorithm` / `darkAlgorithm`. A colour is an alias to a palette step wherever the algorithm took it from one (for example, `colorPrimary` → `{antd.palette.primary.6}`, `colorPrimaryActive` → `.7`). Polyxd additions: `polyxd.sys.color.solid.*` (opaque composites, see below), `polyxd.sys.color.<role>` (roles that differ by mode or were adjusted for contrast, chart colours) and `polyxd.sys.state.{hover,pressed,focus}`. |
+| Semantic | `tokens/semantic.json` | The Polyxd contract tokens, each an `{alias}` to an `antd.token.*`, or to a `polyxd.sys.*` token where Ant has no directly usable value. The file is the same in both modes. |
+
+`manifest.json` merges the files for each mode in this order: primitive → system → system.<mode> → semantic.
+
+The main semantic mappings are:
+
+- **Surfaces:** default and raised are `colorBgContainer`, because antd cards sit on the container colour and are set apart by a border rather than a tone. Subtle is `colorFillAlter` (table and collapse headers). Overlay is `colorBgElevated` (Modal, Popover, Dropdown). Inverse is `colorBgSpotlight` (Tooltip). Scrim is `colorBgMask`, used with its alpha.
+- **Text:** default is `colorText`, muted is `colorTextSecondary`, inverse is `colorTextLightSolid` and link is `colorLink` (adjusted, see Contrast).
+- **Borders:** default is `colorBorderSecondary`. Strong would be `colorBorder`, but that was adjusted. Focus is `colorPrimaryBorder`, the `genFocusOutline` colour (also adjusted).
+- **Actions:** primary is `colorPrimary` with `colorTextLightSolid` text. Secondary is antd's default Button: `colorBgContainer`, `colorText` text and a `colorBorder` outline. Danger is `colorError` with `colorTextLightSolid` text. Selection is `controlItemBgActive` with `colorText` text.
+- **Status:** background is `color<Status>Bg`, foreground is `color<Status>Text` and emphasis is `color<Status>`. `danger` uses antd's `colorError*`.
+- **Data:** positive is `colorSuccess`, negative is `colorError` and neutral is `colorTextTertiary` (antd's icon grey, `colorIcon`).
+- **Type:** fontFamily is `fontFamily` everywhere, and letter-spacing is 0. The page title is Title level 2 (`fontSizeHeading2` 30px), the section title is level 4 (20px) and the item title is level 5 (16px); all three use `fontWeightStrong` 600. Body default is `fontSizeLG` (16px) and body small is `fontSize` (14px). Label default is `fontSize` (14px) and label small is `fontSizeSM` (12px). Numeric display is `fontSizeHeading3` (24px), the Statistic value size. Every style uses its matching antd `lineHeight*` token.
+- **Space:** the antd size ladder. Inset is `paddingSM`/`padding`/`paddingLG` (12/16/24). Stack is `marginXXS`/`marginXS`/`margin`/`marginXL` (4/8/16/32). Inline is `marginXXS`/`marginXS`/`margin` (4/8/16).
+- **Size, radius and border:** target size is `controlHeight` (32). Icons are `fontSizeIcon` (12) and `fontSize` (14), because antd icons inherit the text size. Radius is `borderRadiusSM`/`borderRadius`/`borderRadiusLG` (4/6/8), and full is `polyxd.sys.radius.full` (9999px). Border widths are `lineWidth`/`lineWidthBold` (1/2). The focus ring is `lineWidthFocus` (3px) with a 1px offset.
+- **Shadows:** raised is `boxShadowTertiary` and overlay is `boxShadowSecondary`. `boxShadowSecondary` is what antd's popovers and dropdowns use, and it is identical to `boxShadow`, which Modal uses. Every `boxShadow*` token is parsed into DTCG shadow layers; inset layers get `inset: true`.
+- **Motion:** instant, short and medium are `motionDurationFast`/`Mid`/`Slow` (100/200/300ms). Long is `polyxd.sys.motion.duration-long` (400ms). Easing is `motionEaseInOut` for standard, and the zoom pair antd uses for Modal and Popover for enter and exit: `motionEaseOutCirc` and `motionEaseInOutCirc`.
+
+## Judgement calls
+
+- **Body text is 16px, not antd's 14px.** antd's base `fontSize` is 14px. The contract requires `type.body.default` ≥ 16px, so body default maps to `fontSizeLG` (16px, `lineHeightLG` 1.5). antd's 14px base is still available as `type.body.small` and `type.label.default`, so controls keep antd's density.
+- **Target size is antd's `controlHeight` (32px).** This passes the contract (WCAG 2.5.8, ≥ 24px), but **antd's default density is below the 44–48px touch-target guidance** of iOS and Material. Use `controlHeightLG` (40px) or larger for touch-first surfaces.
+- **Radius** keeps antd's small scale: 4/6/8. antd has no pill token.
+- **Translucent colours.** antd's neutrals are alpha colours: `colorText` is `rgba(0,0,0,0.88)` in light mode and `rgba(255,255,255,0.85)` in dark mode. The same goes for `colorTextSecondary`, `colorFillAlter` and the light `colorBgSpotlight`. Semantic colours must be opaque for contrast checks and for renderers that do not composite, so these roles alias `polyxd.sys.color.solid.<antdName>`: the antd colour composited on that mode's `colorBgContainer`. The generator checks contrast with the real alpha composited on each actual background. Composited on white, antd's text alphas give its familiar greys: 0.88 → `#1f1f1f`, 0.65 → `#595959`, 0.45 → `#8c8c8c`.
+- **State opacities:** antd shifts colours rather than using state layers. Hover and pressed are the alpha of `colorBgTextHover`/`colorBgTextActive` (0.06/0.15 in light, 0.12/0.18 in dark), and focus is the alpha of `controlOutline` (0.1 in light, 0.31 in dark). These are per mode.
+- **Chart colours:** antd ships no chart palette (that is AntV). Series 1–6 are presets blue, orange, cyan, magenta, green and purple, with the order alternating warm and cool. They use step 6 (the preset's base colour) from `presetPalettes` in light mode and `presetDarkPalettes` in dark mode. Where step 6 fails 3:1 against the surface, the series moves to the nearest passing step (see Contrast).
+- **Long duration:** antd defines durations as `motionBase + motionUnit × n`, with fast ×1, mid ×2 and slow ×3. `duration-long` extends that ladder by one step (×4 = 400ms).
+- **Dark shadows:** in antd 6.6.4, `darkAlgorithm` derives shadows from `colorShadow` `rgba(255,255,255,0.2)`, so the dark `boxShadow*` layers are white at 1–2.4% alpha. They are vendored as antd computes them.
+
+## Contrast
+
+antd's default palette misses several WCAG thresholds. For each contract pair that failed with the natural mapping, the generator moved the role to the **nearest step of the same antd palette** that passes every pair the role is in. For `border.strong` it used antd's neutral ladder (`colorBorderSecondary` → `colorBorder` → `colorTextQuaternary` → `colorTextTertiary` → `colorTextSecondary` → `colorText`) instead. `npm run generate` prints this list. Ratios are WCAG 2.x, with translucent colours composited.
+
+**Light (`defaultAlgorithm`)**
+
+| Role | antd natural | Ratio | Now | Ratio |
+|---|---|---|---|---|
+| text.link | `colorLink` #1677ff | 4.10 on surface | primary/info step 7 #0958d9 (= `colorPrimaryActive`) | 6.16 |
+| action.primary.background | `colorPrimary` #1677ff | **4.10 with white text** | step 7 #0958d9 | 6.16 |
+| action.danger.background | `colorError` #ff4d4f | 3.27 with white text | error step 7 #d9363e (= `colorErrorActive`) | 4.62 |
+| status.info.foreground | `colorInfoText` #1677ff | 3.66 on `colorInfoBg` | info step 7 #0958d9 | 5.50 |
+| status.success.foreground | `colorSuccessText` #52c41a | 2.21 on `colorSuccessBg` | success step 8 #237804 | 5.44 |
+| status.success.emphasis | `colorSuccess` #52c41a | 2.27 | success step 7 #389e0d | 3.46 |
+| status.warning.foreground | `colorWarningText` #faad14 | **1.83** on `colorWarningBg` | warning step 9 #874d00 | 6.53 |
+| status.warning.emphasis | `colorWarning` #faad14 | 1.90 | warning step 8 #ad6800 | 4.41 |
+| status.danger.foreground | `colorErrorText` #ff4d4f | 2.99 on `colorErrorBg` | error step 8 #b32430 | 5.98 |
+| border.strong | `colorBorder` #d9d9d9 | **1.41** (input outlines) | `colorTextTertiary` #8c8c8c | 3.36 |
+| border.focus | `colorPrimaryBorder` #91caff | 1.74 (focus outline) | primary step 6 #1677ff (= `colorPrimary`) | 4.10 |
+| data.categorical.2 | orange 6 #fa8c16 | 2.38 | orange 7 #d46b08 | 3.56 |
+| data.categorical.3 | cyan 6 #13c2c2 | 2.21 | cyan 7 #08979c | 3.55 |
+| data.categorical.5 | green 6 #52c41a | 2.27 | green 7 #389e0d | 3.46 |
+| data.positive | `colorSuccess` #52c41a | 2.27 | success step 7 #389e0d | 3.46 |
+
+**Dark (`darkAlgorithm`)**
+
+| Role | antd natural | Ratio | Now | Ratio |
+|---|---|---|---|---|
+| text.link | `colorLink` #1668dc | 3.55 | info step 7 #3c89e8 (= dark `colorPrimaryHover`) | 5.21 |
+| action.danger.background | `colorError` #dc4446 | 4.24 with white text | error step 5 #ad393a | 6.13 (3.00 on surface) |
+| status.info.foreground | `colorInfoText` #1668dc | 3.35 on `colorInfoBg` | info step 7 #3c89e8 | 4.91 |
+| status.danger.foreground | `colorErrorText` #dc4446 | 4.01 on `colorErrorBg` | error step 7 #e86e6b | 5.57 |
+| border.strong | `colorBorder` #424242 | 1.83 | `colorTextTertiary` (composited #7e7e7e) | 4.54 |
+| border.focus | `colorPrimaryBorder` #15325b | 1.44 | primary step 6 #1668dc (= `colorPrimary`) | 3.55 |
+| data.categorical.6 | purple 6 #642ab5 | 2.23 | purple 7 #854eca | 3.46 |
+
+Findings worth knowing:
+
+- antd's primary button (white on `#1677ff`, 4.10:1) and its light link colour fail WCAG AA 1.4.3 for normal-size text.
+- Warning text on the warning background is 1.83:1.
+- The default input border `#d9d9d9` is 1.41:1, well below the 3:1 non-text minimum.
+- The dark primary button (white on `#1668dc`) passes at 5.19:1, so it was not adjusted.
+- The tightest pair after adjustment is dark `action.danger.background` against the surface, at exactly 3.00:1. Step 5 is the only error step that passes both the white-text pair (≥ 4.5) and the surface pair (≥ 3).
+- `opacity.state.disabled` is adjusted too. antd's disabled content is `colorTextDisabled` (alpha 0.25), below the contract's 0.3 minimum, so the pack uses 0.45, the next step of antd's text-alpha ladder (`colorTextTertiary`).
+- `action.secondary.border` stays antd's `colorBorder`, because the contract has no contrast pair for it. The button label identifies the control.
+
+## Regenerating
+
+`scripts/generate.ts` writes all five token files and gives the same output on every run. It works offline from `scripts/sources/antd/antd-tokens.json`. Do not edit the token files by hand. The generator also checks every contract contrast pair with alpha compositing, and it fails if a role cannot be brought into compliance.
+
+To refresh the vendored data for a new antd version, **use a scratch directory outside the repo**. The pack has no npm dependencies on purpose.
+
+```sh
+cd "$(mktemp -d)" && npm init -y && npm install antd@<version> react react-dom
+cp <repo>/packages/ds-antd/scripts/sources/antd/dump-antd-tokens.mjs .
+node dump-antd-tokens.mjs > <repo>/packages/ds-antd/scripts/sources/antd/antd-tokens.json
+```
+
+Then update `ANTD_VERSION` / `COLORS_VERSION` in `generate.ts`, `manifest.json` and this README, and run `npm run generate`.
+
+The dump holds `theme.defaultSeed`, the output of `theme.defaultAlgorithm(seed)` and `theme.darkAlgorithm(seed)` (map tokens), and `theme.getDesignToken({ algorithm })` (map + alias tokens). It also holds `presetPalettes`, `presetDarkPalettes`, and `generate(seed)` / `generate(seed, { theme: 'dark' })` for each colour seed.
+
+## Provenance
+
+`manifest.json` → `provenance` has the full list. In short:
+
+| Source | Version | License | Used for |
+|---|---|---|---|
+| [`antd`](https://github.com/ant-design/ant-design) | 6.6.4 | MIT | Seed, map and alias tokens for both algorithms; focus-outline offset and colour (`es/style/index.js` `genFocusOutline`); zoom-motion easings (`es/style/motion/zoom.js`) |
+| [`@ant-design/colors`](https://github.com/ant-design/ant-design-colors) | 8.0.1 (resolved by antd 6.6.4) | MIT | Preset palettes (light and dark) and the seed palettes |
+| Polyxd | – | Apache-2.0 | The semantic mapping, contrast adjustments, solid composites, and the `polyxd.sys.*` additions |
+
+The dump was produced with react/react-dom 19.3.0, which antd needs as a peer dependency but which affects no values. The licence texts of antd and @ant-design/colors are vendored next to the data (`scripts/sources/antd/LICENSE.*`). Our own code and the token files are Apache-2.0.

package/manifest.json

@@ -0,0 +1,32 @@
+{
+  "$schema": "../spec/schema/design-system.schema.json",
+  "name": "antd",
+  "displayName": "Ant Design",
+  "version": "0.0.0",
+  "contractVersion": "0.1.0",
+  "license": "Apache-2.0",
+  "modes": {
+    "light": ["tokens/primitive.json", "tokens/system.json", "tokens/system.light.json", "tokens/semantic.json"],
+    "dark": ["tokens/primitive.json", "tokens/system.json", "tokens/system.dark.json", "tokens/semantic.json"]
+  },
+  "defaultMode": "light",
+  "provenance": [
+    {
+      "source": "npm:antd (https://github.com/ant-design/ant-design)",
+      "version": "6.6.4",
+      "license": "MIT",
+      "notes": "antd.seed.* = theme.defaultSeed. antd.token.* = theme.getDesignToken({ algorithm }) with theme.defaultAlgorithm (light) and theme.darkAlgorithm (dark) applied to the default seed: map and alias tokens. Dumped by scripts/sources/antd/dump-antd-tokens.mjs into scripts/sources/antd/antd-tokens.json (vendored with antd's LICENSE); generate.ts runs offline from that file. Focus-ring offset (1px) and colour (colorPrimaryBorder) are from es/style/index.js genFocusOutline; enter/exit easings from es/style/motion/zoom.js."
+    },
+    {
+      "source": "npm:@ant-design/colors (https://github.com/ant-design/ant-design-colors)",
+      "version": "8.0.1",
+      "license": "MIT",
+      "notes": "antd.palette.<preset>.1-10 = presetPalettes, antd.paletteDark.<preset>.1-10 = presetDarkPalettes. antd.palette.{primary,success,warning,error,info} = generate(seed) and antd.paletteDark.* = generate(seed, { theme: 'dark' }): the palettes the two algorithms derive colorPrimary*/colorSuccess*/... from. The version is the one antd 6.6.4 resolved to."
+    },
+    {
+      "source": "Polyxd",
+      "license": "Apache-2.0",
+      "notes": "The semantic-tier mapping; contrast adjustments to neighbouring steps of the same antd palette (listed in README.md); polyxd.sys.color.solid.* (antd's translucent colours composited on colorBgContainer); polyxd.sys.state.* (alphas of antd's hover/active/focus tokens; disabled 0.45); radius.full 9999px; font weight 400 and letter-spacing 0; motion duration-long 400ms (motionUnit x 4); measure.max 65."
+    }
+  ]
+}

package/package.json

@@ -0,0 +1,30 @@
+{
+  "name": "@polyxd/ds-antd",
+  "version": "0.1.0",
+  "description": "Ant Design design-system pack for Polyxd (DTCG 2025.10 tokens)",
+  "license": "Apache-2.0",
+  "type": "module",
+  "files": [
+    "manifest.json",
+    "tokens",
+    "README.md",
+    "LICENSE",
+    "NOTICE",
+    "scripts/sources/**/LICEN[CS]E*"
+  ],
+  "scripts": {
+    "generate": "node scripts/generate.ts",
+    "check": "node ../spec/src/cli/check-design-system.ts manifest.json",
+    "test": "npm run check"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/visualfart/polyxd.git",
+    "directory": "packages/ds-antd"
+  },
+  "homepage": "https://polyxd.com",
+  "bugs": "https://github.com/visualfart/polyxd/issues",
+  "publishConfig": {
+    "access": "public"
+  }
+}

package/scripts/sources/antd/LICENSE.ant-design-colors

@@ -0,0 +1,22 @@
+MIT LICENSE
+
+Copyright (c) 2018-present Ant UED, https://xtech.antfin.com/
+
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of this software and associated documentation files (the
+"Software"), to deal in the Software without restriction, including
+without limitation the rights to use, copy, modify, merge, publish,
+distribute, sublicense, and/or sell copies of the Software, and to
+permit persons to whom the Software is furnished to do so, subject to
+the following conditions:
+
+The above copyright notice and this permission notice shall be
+included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
+LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
+OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
+WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

package/scripts/sources/antd/LICENSE.antd

@@ -0,0 +1,22 @@
+MIT LICENSE
+
+Copyright (c) 2015-present Ant UED, https://xtech.antfin.com/
+
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of this software and associated documentation files (the
+"Software"), to deal in the Software without restriction, including
+without limitation the rights to use, copy, modify, merge, publish,
+distribute, sublicense, and/or sell copies of the Software, and to
+permit persons to whom the Software is furnished to do so, subject to
+the following conditions:
+
+The above copyright notice and this permission notice shall be
+included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
+LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
+OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
+WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.