@kyralabs/m3e-tokens 1.0.1 → 1.2.0

package/dist/theme.d.ts

@@ -28,9 +28,32 @@ declare const SPEC_2025_ONLY_ROLES: readonly string[];
  */
 declare const COLOR_ROLES: readonly string[];
 declare const rolesFor: (specVersion: SpecVersion) => readonly string[];
+/**
+ * Optional source colors for the palettes other than primary, like Material Theme Builder's
+ * "core colors". Each one replaces the palette the variant would derive from `seed` with
+ * `TonalPalette.fromInt(color)` (the color's own hue and chroma); the variant still maps the
+ * roles to tones. Keys are the `DynamicScheme` palette names (`dynamiccolor/dynamic_scheme.d.ts`
+ * L63–L68, MCU 0.4.0). The same mapping as Angular Material's `theme-color` schematic
+ * (`TonalPalette.fromHct` per custom color); Theme Builder's own is `TODO(verify)` (SOURCES.md
+ * register #62).
+ *
+ * `neutralVariant` has no effect with spec 2025 (tonalSpot, neutral, vibrant, expressive): that
+ * spec draws on-surface-variant, outline and outline-variant from the neutral palette with a
+ * chroma multiplier (`dynamiccolor/color_spec_2025.js` L449–L524) and maps surface-variant to
+ * surface-container-highest (L1105–L1107), so set `neutral` instead.
+ */
+declare const CORE_COLORS: readonly ["secondary", "tertiary", "neutral", "neutralVariant", "error"];
+type CoreColor = (typeof CORE_COLORS)[number];
+/** `undefined` means unset, the same as leaving the key out. */
+type CoreColors = Partial<Record<CoreColor, string | undefined>>;
 interface CreateThemeOptions {
     /** Source color, `#rgb` or `#rrggbb`. */
     seed: string;
+    /**
+     * Optional source colors for the secondary, tertiary, neutral, neutral variant and error
+     * palettes (`#rgb` or `#rrggbb`). Unset palettes come from `seed` and `variant` as usual.
+     */
+    coreColors?: CoreColors;
     variant?: Variant;
     mode?: ThemeMode;
     /** −1…1 (0 = standard) or a preset name. Spec 2025 treats negative contrast as 0. */
@@ -50,6 +73,8 @@ interface Theme {
     cssText: string;
     tokens: {
         seed: string;
+        /** Normalized core colors; present only when at least one was given. */
+        coreColors?: CoreColors;
         variant: Variant;
         contrast: number;
         specVersion: SpecVersion;
@@ -59,7 +84,7 @@ interface Theme {
     };
 }
 /** Resolves every role of one scheme to `#rrggbb`. */
-declare function schemeColors(seed: string, variant: Variant, isDark: boolean, contrast: number, specVersion: SpecVersion): Record<string, string>;
+declare function schemeColors(seed: string, variant: Variant, isDark: boolean, contrast: number, specVersion: SpecVersion, coreColors?: CoreColors): Record<string, string>;
 declare function createTheme(options: CreateThemeOptions): Theme;
 
-export { COLOR_ROLES, CONTRAST, ColorRoles, type CreateThemeOptions, DEFAULT_SPEC_VERSION, MotionScheme, SPEC_2025_ONLY_ROLES, SPEC_VERSIONS, type SpecVersion, type Theme, ThemeMode, VARIANTS, type Variant, createTheme, rolesFor, schemeColors };
+export { COLOR_ROLES, CONTRAST, CORE_COLORS, ColorRoles, type CoreColor, type CoreColors, type CreateThemeOptions, DEFAULT_SPEC_VERSION, MotionScheme, SPEC_2025_ONLY_ROLES, SPEC_VERSIONS, type SpecVersion, type Theme, ThemeMode, VARIANTS, type Variant, createTheme, rolesFor, schemeColors };

package/dist/theme.js

@@ -5087,13 +5087,55 @@ var COLOR_ROLES = Object.getOwnPropertyNames(
 var rolesFor = (specVersion) => specVersion === "2025" ? COLOR_ROLES : COLOR_ROLES.filter((r) => !SPEC_2025_ONLY_ROLES.includes(r));
 var HEX = /^#(?:[0-9a-f]{3}|[0-9a-f]{6})$/i;
 var normalizeHex = (hex) => hexFromArgb(argbFromHex(hex));
-function schemeColors(seed, variant, isDark, contrast, specVersion) {
-  const scheme = new SCHEMES[variant](
+var CORE_COLORS = ["secondary", "tertiary", "neutral", "neutralVariant", "error"];
+function normalizeCoreColors(coreColors, caller) {
+  const out = {};
+  for (const key of Object.keys(coreColors)) {
+    if (!CORE_COLORS.includes(key)) {
+      throw new Error(`${caller}: unknown core color "${key}"`);
+    }
+  }
+  for (const key of CORE_COLORS) {
+    const hex = coreColors[key];
+    if (hex === void 0) continue;
+    if (typeof hex !== "string" || !HEX.test(hex)) {
+      throw new Error(
+        `${caller}: core color ${key} must be #rgb or #rrggbb, got ${JSON.stringify(hex)}`
+      );
+    }
+    out[key] = normalizeHex(hex);
+  }
+  return out;
+}
+function withCoreColors(scheme, coreColors) {
+  if (CORE_COLORS.every((key) => coreColors[key] === void 0)) return scheme;
+  const palette = (key) => {
+    const hex = coreColors[key];
+    return hex === void 0 ? void 0 : TonalPalette.fromInt(argbFromHex(hex));
+  };
+  return new DynamicScheme({
+    sourceColorHct: scheme.sourceColorHct,
+    variant: scheme.variant,
+    contrastLevel: scheme.contrastLevel,
+    isDark: scheme.isDark,
+    platform: scheme.platform,
+    specVersion: scheme.specVersion,
+    primaryPalette: scheme.primaryPalette,
+    secondaryPalette: palette("secondary") ?? scheme.secondaryPalette,
+    tertiaryPalette: palette("tertiary") ?? scheme.tertiaryPalette,
+    neutralPalette: palette("neutral") ?? scheme.neutralPalette,
+    neutralVariantPalette: palette("neutralVariant") ?? scheme.neutralVariantPalette,
+    errorPalette: palette("error") ?? scheme.errorPalette
+  });
+}
+function schemeColors(seed, variant, isDark, contrast, specVersion, coreColors = {}) {
+  const variantScheme = new SCHEMES[variant](
     Hct.fromInt(argbFromHex(seed)),
     isDark,
     contrast,
     specVersion
   );
+  const scheme = withCoreColors(variantScheme, normalizeCoreColors(coreColors, "schemeColors"));
   const out = {};
   for (const role of rolesFor(specVersion)) {
     const method = dynamicColors[role];
@@ -5125,9 +5167,11 @@ function createTheme(options) {
       `createTheme: contrast must be within [-1, 1], got ${String(options.contrast)}`
     );
   }
+  const coreColors = normalizeCoreColors(options.coreColors ?? {}, "createTheme");
+  const hasCoreColors = Object.keys(coreColors).length > 0;
   const roles = rolesFor(specVersion);
   const build = (isDark, extra) => {
-    const colors = schemeColors(seed, variant, isDark, contrast, specVersion);
+    const colors = schemeColors(seed, variant, isDark, contrast, specVersion, coreColors);
     for (const [role, hex] of Object.entries(extra ?? {})) {
       if (!roles.includes(role)) throw new Error(`createTheme: unknown color role "${role}"`);
       if (!HEX.test(hex)) throw new Error(`createTheme: override ${role} must be a hex color`);
@@ -5148,6 +5192,7 @@ function createTheme(options) {
     cssText,
     tokens: {
       seed: normalizeHex(seed),
+      ...hasCoreColors ? { coreColors } : {},
       variant,
       contrast,
       specVersion,
@@ -5269,6 +5314,6 @@ function createTheme(options) {
    *)
 */
 
-export { COLOR_ROLES, CONTRAST, DEFAULT_SPEC_VERSION, SPEC_2025_ONLY_ROLES, SPEC_VERSIONS, VARIANTS, colorVar, createTheme, rolesFor, schemeColors, themeCss };
+export { COLOR_ROLES, CONTRAST, CORE_COLORS, DEFAULT_SPEC_VERSION, SPEC_2025_ONLY_ROLES, SPEC_VERSIONS, VARIANTS, colorVar, createTheme, rolesFor, schemeColors, themeCss };
 //# sourceMappingURL=theme.js.map
 //# sourceMappingURL=theme.js.map