How hasansarwer/salt-theme-gen works
salt-theme-gen is a dependency-free TypeScript design-system theme generator. A consumer supplies a color or nature preset, optional harmony and scale choices; the public API generates light and dark themes with semantic colors, interaction states, elevation, and accessibility reports. Consumers can also adjust, compare, or validate themes. The graph follows documented behavior and sampled imports; unsampled implementation details are omitted where relationships cannot be verified.
Main entry points: generate-theme.ts Theme generator · adjust-theme.ts Theme adjustment · index.ts Exports · on-colors.ts On-colors and contrast
Components 15
Public API
- Exports
src/index.ts
Theme Generation
- Theme generator
src/generate-theme.ts - Nature presets
src/presets/nature-presets.ts - Spacing presets
src/presets/spacing-presets.ts - Radius presets
src/presets/radius-presets.ts - Font-size presets
src/presets/font-size-presets.ts - Generated themes
src/types.ts
Color Derivation
- Color math
src/color-math.ts - Color derivation
src/butterfly.ts - On-colors and contrast
src/on-colors.ts - Interaction states
src/state-colors.ts
Theme Utilities
- Theme adjustment
src/adjust-theme.ts - Theme diff
src/diff-theme.ts - Theme validation
src/validate.ts
Other components
- Theme consumer
Connections 27
- Theme consumer → Exports: uses
README.md - Exports → Theme generator: exports
src/index.ts - Exports → Theme adjustment: exports
src/index.ts - Exports → Theme diff: exports
src/index.ts - Exports → Theme validation: exports
src/index.ts - Theme generator → Nature presets: resolves preset
src/generate-theme.ts - Theme generator → Spacing presets: resolves scale
src/generate-theme.ts - Theme generator → Radius presets: resolves scale
src/generate-theme.ts - Theme generator → Font-size presets: resolves scale
src/generate-theme.ts - Theme generator → Color math: parses colors
src/generate-theme.ts - Theme generator → Color derivation: derives colors
src/generate-theme.ts - Theme generator → Interaction states: derives states
src/generate-theme.ts - Theme generator → On-colors and contrast: builds report
src/generate-theme.ts - Theme generator → Generated themes: returns
src/generate-theme.ts - Color derivation → Color math: uses
src/butterfly.ts - Color derivation → On-colors and contrast: derives foregrounds
src/butterfly.ts - On-colors and contrast → Color math: measures contrast
src/on-colors.ts - Interaction states → Color math: derives states
src/state-colors.ts - Interaction states → On-colors and contrast: corrects contrast
src/state-colors.ts - Theme consumer → Theme adjustment: adjusts theme
README.md - Theme adjustment → On-colors and contrast: recalculates contrast
src/adjust-theme.ts - Theme adjustment → Color derivation: recalculates elevation
src/adjust-theme.ts - Theme adjustment → Interaction states: recalculates states
src/adjust-theme.ts - Theme adjustment → Generated themes: returns adjusted
README.md - Theme consumer → Theme diff: compares themes
README.md - Theme diff → Generated themes: compares fields
src/diff-theme.ts - Theme consumer → Theme validation: parses JSON
README.md