@resolve-components/theme 1.0.0

package/src/lib/styles/theming/_register.scss

@@ -0,0 +1,58 @@
+// =============================================================================
+// Resolve Components — Theme Registration
+// =============================================================================
+
+@use 'sass:map';
+@use 'sass:meta';
+@use 'theming-variables' as vars;
+@use 'functions' as fn;
+@use 'mapping' as mp;
+
+/// Register a theme into the global theme registry.
+///
+/// Merging order (lowest to highest priority):
+///   1. Component mapping ($rc-mapping) — base defaults
+///   2. Parent theme values (if $parent-name is provided)
+///   3. Current theme values ($theme)
+///
+/// @param {Map} $theme - The theme variable map.
+/// @param {String} $name - Unique theme name (e.g. 'default', 'dark').
+/// @param {String|null} $parent-name - Parent theme to inherit from.
+/// @return {Map} Updated global $rc-themes map.
+@function rc-register-theme($theme, $name, $parent-name: null) {
+  // Start with the component mapping as the base layer
+  $merged: mp.$rc-mapping;
+
+  // If inheriting from a parent theme, merge parent values
+  @if $parent-name != null {
+    @if map.has-key(vars.$rc-themes, $parent-name) {
+      $parent-theme: map.get(vars.$rc-themes, $parent-name);
+      $merged: map.merge($merged, $parent-theme);
+    } @else {
+      @warn 'rc-register-theme: parent theme "#{$parent-name}" not found. Registering "#{$name}" without parent.';
+    }
+  }
+
+  // Merge the current theme on top (highest priority)
+  $merged: map.merge($merged, $theme);
+
+  // Store in global registry
+  @return fn.rc-map-set(vars.$rc-themes, $name, $merged);
+}
+
+/// Get a registered theme by name.
+/// @param {String} $name - Theme name.
+/// @return {Map} The theme variable map.
+@function rc-get-registered-theme($name) {
+  @return map.get(vars.$rc-themes, $name);
+}
+
+/// Get the list of enabled theme names.
+/// If $rc-enabled-themes is empty, returns all registered theme names.
+/// @return {List} Theme names.
+@function rc-get-enabled-themes() {
+  @if length(vars.$rc-enabled-themes) > 0 {
+    @return vars.$rc-enabled-themes;
+  }
+  @return map.keys(vars.$rc-themes);
+}

package/src/lib/styles/theming/_theming-variables.scss

@@ -0,0 +1,30 @@
+// =============================================================================
+// Resolve Components — Theming Variables (Global State)
+// =============================================================================
+// These mutable globals are the backbone of the theming engine.
+// $rc-themes is a SCSS map-of-maps: { 'default': (...), 'dark': (...) }
+// Every theme registration appends to this map.
+// =============================================================================
+
+/// When true, the theming engine emits CSS custom properties (recommended).
+/// When false, it falls back to duplicated SCSS output per theme.
+$rc-enable-css-custom-properties: true !default;
+
+/// Master registry of all registered themes.
+/// Structure: ( 'theme-name': ( variable-name: value, ... ), ... )
+$rc-themes: () !default;
+
+/// List of theme names to include in output. Empty = all registered.
+$rc-enabled-themes: () !default;
+
+/// Current theme name being processed (set during compilation).
+$rc-theme-name: null !default;
+
+/// Current theme map being processed.
+$rc-theme: () !default;
+
+/// How theme values are resolved: 'lazy-process' or 'pre-process'.
+$rc-theme-process-mode: 'lazy-process' !default;
+
+/// Pre-processed theme (all aliases resolved to terminal values).
+$rc-processed-theme: () !default;