[Epic] Polaris tokens reconciliation

[aaronccasanova]

Token reconciliation

Beta Give feedback

1. Identify and document experimental design tokens created during the Uplift
2. Compare and analyze current and experimental Polaris tokens
3. Analyze existing token groups to determine where to introduce semantics
4. Determine what token groups are in scope for reconciliation
5. Consolidate current and experimental tokens to a finalized set

Theming

Beta Give feedback

1. Evaluate existing tokens integration and outline an approach to support theming #9987
   1 of 2
   #gsd:36565 Tokens +2
   
2. Establish a pattern for global theming Polaris tokens #9988
   #gsd:36565 Tokens +2
   
3. Establish a pattern for accessing theme values at runtime in JSX #9989
   #gsd:36565 Tokens +2
   
4. Adjust Polaris tokens build artifacts (ESM, CJS, JSON, SCSS, CSS, etc.) to support theming #10043
   #gsd:36565 Tokens +2
5. Deprecate non theme related exports in v12 (metadata, tokens, individual token groups, etc)
6. Deprecate v0 polaris.shopify.com tokens REST API (to avoid enabling multi-theme support)
7. Update documentation to reflect the changes made to support theming
8. Remove * exports from Polaris tokens (e.g. use explicit named exports)

Rollout and migrations

Beta Give feedback

1. Identify migration paths that can leverage the Polaris migrator
2. Determine what migration paths need to be handled manually
3. [Epic] Write migrations to run across Polaris, Web, 1P, and 3P apps #10301
   60 of 66
   #gsd:36565 Tokens +2
   
4. Document the migration path for internal and external Polaris consumers #10302
   #gsd:36565 Tokens untriaged +3
   
5. After migrations add deprecated custom properties to stylelint-polaris

Stretch goals

Beta Give feedback

1. Establish a pattern for theme/token overrides
2. Explore responsive tokens
3. [Polaris tokens] Rename createVar to createVarName
4. Investigate Chromatic Story Modes: https://www.chromatic.com/docs/modes