feat(material-experimental/theming): Introduce a facade layer between user-facing customizable keys and actual MDC token names

[mmalerba]

This allows us to expose easier to understand names for users, and
decouples us from changes that MDC might make to token names in the
future

[crisbeto]

Do we have an example somewhere of how the API for customizing the tokens can be used?

[mmalerba]

@crisbeto the second commit here does show an example of customizing tokens, are you asking for an example that's more setting one-off toke values rather than just theme-type or color-palette? I can certainly add that as well, might be good to show

[crisbeto]

Yeah I was thinking of a demo showing how a user can override an arbitrary token (e.g. the border radius of something).

[github-actions]

Deployed dev-app for fabab6e to: https://ng-dev-previews-comp--pr-angular-components-27219-pj0g4m6m.web.app

Note: As new commits are pushed to this pull request, this link is updated after the preview is rebuilt.

[mmalerba]

Added an example of setting arbitrary custom token values

[crisbeto]

Is the example supposed to work in the dev app or is this just to show the API?

[andrewseguin]

I'm gonna make a suggestion that I think might help carve out this design, but don't hold yourself to it:

Write the user-facing documentation while you are creating these early designs and prototypes.

This would help us understand from a user-point-of-view whether there's anything that we might be missing or isn't intuitive, and it would help as we review as well.

[mmalerba]

@andrewseguin I don't want to spend too much time wordsmithing if its likely to change, but I can write up a rough bullet point version of the user docs, I think that would be helpful 👍

[mmalerba]

@crisbeto the example should work, you just need the magic param to turn on experimental styling: https://ng-dev-previews-comp--pr-angular-components-27219-pj0g4m6m.web.app/checkbox?tokenapi= (note: all of the other components will be un-styled in this mode)

[andrewseguin]

Approved - if there's any changes we want to make over time we can do that iteratively, but this seems good to land now

[mmalerba]

Yep, nothing is set in stone here, that's why its in material-experimental. I do expect some of it to change and that's fine

[angular-automatic-lock-bot]

This issue has been automatically locked due to inactivity.
Please file a new issue if you are encountering a similar or related problem.

Read more about our automatic conversation locking policy.

_{This action has been performed automatically by a bot.}