SKILL.md
@pierre/theming
Use @pierre/theming to manage runtime themes. The package separates theme metadata, theme resolution, selected state, and UI color mapping.
Install
pnpm add @pierre/themingInstall optional peer dependencies only for the selected entry. The React entry needs react. The themes entry needs @pierre/theme, @shikijs/themes, and shiki.
Select an API reference
| Need | Reference |
|---|---|
| Create a collection, catalog, descriptor, or bundled theme set | [Collections API](references/collections.md) |
| Register, load, seed, or cache theme objects | [Resolver API](references/resolver.md) |
| Track the color mode and selected light and dark themes | [Controller API](references/controller.md) |
| Normalize workbench colors or derive colors | [Colors API](references/colors.md) |
| Read controller state in React | [React API](references/react.md) |
Select a controller recipe
| Situation | Recipe |
|---|---|
| One app or page shares one color mode and one light/dark selection | [Use one controller](references/recipe-one-controller.md) |
| Independent areas need separate selections or separate controller lifecycles | [Use multiple controllers](references/recipe-multiple-controllers.md) |
Use one controller by default. Use multiple controllers only when the theme state must differ between areas.
Select a framework recipe
| Host | Recipe |
|---|---|
| Vanilla JavaScript or another framework | [Use vanilla JavaScript](references/recipe-vanilla.md) |
| React | [Use React](references/recipe-react.md) |