@chipmobilesdk/rn-theme 1.1.0 → 1.3.0

package/lib/typescript/module/vendor/mcu/hct/viewing_conditions.d.ts

@@ -0,0 +1,75 @@
+/**
+ * @license
+ * Copyright 2021 Google LLC
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *      http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+/**
+ * In traditional color spaces, a color can be identified solely by the
+ * observer's measurement of the color. Color appearance models such as CAM16
+ * also use information about the environment where the color was
+ * observed, known as the viewing conditions.
+ *
+ * For example, white under the traditional assumption of a midday sun white
+ * point is accurately measured as a slightly chromatic blue by CAM16. (roughly,
+ * hue 203, chroma 3, lightness 100)
+ *
+ * This class caches intermediate values of the CAM16 conversion process that
+ * depend only on viewing conditions, enabling speed ups.
+ */
+export declare class ViewingConditions {
+    n: number;
+    aw: number;
+    nbb: number;
+    ncb: number;
+    c: number;
+    nc: number;
+    rgbD: number[];
+    fl: number;
+    fLRoot: number;
+    z: number;
+    /** sRGB-like viewing conditions.  */
+    static DEFAULT: ViewingConditions;
+    /**
+     * Create ViewingConditions from a simple, physically relevant, set of
+     * parameters.
+     *
+     * @param whitePoint White point, measured in the XYZ color space.
+     *     default = D65, or sunny day afternoon
+     * @param adaptingLuminance The luminance of the adapting field. Informally,
+     *     how bright it is in the room where the color is viewed. Can be
+     *     calculated from lux by multiplying lux by 0.0586. default = 11.72,
+     *     or 200 lux.
+     * @param backgroundLstar The lightness of the area surrounding the color.
+     *     measured by L* in L*a*b*. default = 50.0
+     * @param surround A general description of the lighting surrounding the
+     *     color. 0 is pitch dark, like watching a movie in a theater. 1.0 is a
+     *     dimly light room, like watching TV at home at night. 2.0 means there
+     *     is no difference between the lighting on the color and around it.
+     *     default = 2.0
+     * @param discountingIlluminant Whether the eye accounts for the tint of the
+     *     ambient lighting, such as knowing an apple is still red in green light.
+     *     default = false, the eye does not perform this process on
+     *       self-luminous objects like displays.
+     */
+    static make(whitePoint?: number[], adaptingLuminance?: number, backgroundLstar?: number, surround?: number, discountingIlluminant?: boolean): ViewingConditions;
+    /**
+     * Parameters are intermediate values of the CAM16 conversion process. Their
+     * names are shorthand for technical color science terminology, this class
+     * would not benefit from documenting them individually. A brief overview
+     * is available in the CAM16 specification, and a complete overview requires
+     * a color science textbook, such as Fairchild's Color Appearance Models.
+     */
+    private constructor();
+}
+//# sourceMappingURL=viewing_conditions.d.ts.map

package/lib/typescript/module/vendor/mcu/hct/viewing_conditions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"viewing_conditions.d.ts","sourceRoot":"","sources":["../../../../../../src/vendor/mcu/hct/viewing_conditions.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAQH;;;;;;;;;;;;GAYG;AACH,qBAAa,iBAAiB;IAgFjB,CAAC,EAAE,MAAM;IAAS,EAAE,EAAE,MAAM;IAAS,GAAG,EAAE,MAAM;IAChD,GAAG,EAAE,MAAM;IAAS,CAAC,EAAE,MAAM;IAAS,EAAE,EAAE,MAAM;IAChD,IAAI,EAAE,MAAM,EAAE;IAAS,EAAE,EAAE,MAAM;IAAS,MAAM,EAAE,MAAM;IACxD,CAAC,EAAE,MAAM;IAlFpB,qCAAqC;IACrC,MAAM,CAAC,OAAO,oBAA4B;IAE1C;;;;;;;;;;;;;;;;;;;;;OAqBG;IACH,MAAM,CAAC,IAAI,CACP,UAAU,WAAwB,EAClC,iBAAiB,SAAqD,EACtE,eAAe,SAAO,EAAE,QAAQ,SAAM,EACtC,qBAAqB,UAAQ,GAAG,iBAAiB;IA0CrD;;;;;;OAMG;IACH,OAAO;CAKR"}

package/lib/typescript/module/vendor/mcu/index.d.ts

@@ -0,0 +1,4 @@
+export { Hct } from './hct/hct.js';
+export { TonalPalette } from './palettes/tonal_palette.js';
+export { argbFromRgb } from './utils/color_utils.js';
+//# sourceMappingURL=index.d.ts.map

package/lib/typescript/module/vendor/mcu/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/vendor/mcu/index.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,GAAG,EAAE,MAAM,cAAW,CAAC;AAChC,OAAO,EAAE,YAAY,EAAE,MAAM,6BAA0B,CAAC;AACxD,OAAO,EAAE,WAAW,EAAE,MAAM,wBAAqB,CAAC"}

package/lib/typescript/module/vendor/mcu/palettes/tonal_palette.d.ts

@@ -0,0 +1,56 @@
+/**
+ * @license
+ * Copyright 2021 Google LLC
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *      http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+import { Hct } from '../hct/hct.js';
+/**
+ *  A convenience class for retrieving colors that are constant in hue and
+ *  chroma, but vary in tone.
+ */
+export declare class TonalPalette {
+    readonly hue: number;
+    readonly chroma: number;
+    readonly keyColor: Hct;
+    private readonly cache;
+    /**
+     * @param argb ARGB representation of a color
+     * @return Tones matching that color's hue and chroma.
+     */
+    static fromInt(argb: number): TonalPalette;
+    /**
+     * @param hct Hct
+     * @return Tones matching that color's hue and chroma.
+     */
+    static fromHct(hct: Hct): TonalPalette;
+    /**
+     * @param hue HCT hue
+     * @param chroma HCT chroma
+     * @return Tones matching hue and chroma.
+     */
+    static fromHueAndChroma(hue: number, chroma: number): TonalPalette;
+    private constructor();
+    /**
+     * @param tone HCT tone, measured from 0 to 100.
+     * @return ARGB representation of a color with that tone.
+     */
+    tone(tone: number): number;
+    /**
+     * @param tone HCT tone.
+     * @return HCT representation of a color with that tone.
+     */
+    getHct(tone: number): Hct;
+    private averageArgb;
+}
+//# sourceMappingURL=tonal_palette.d.ts.map

package/lib/typescript/module/vendor/mcu/palettes/tonal_palette.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tonal_palette.d.ts","sourceRoot":"","sources":["../../../../../../src/vendor/mcu/palettes/tonal_palette.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAKH,OAAO,EAAC,GAAG,EAAC,MAAM,eAAY,CAAC;AAE/B;;;GAGG;AACH,qBAAa,YAAY;IA+BnB,QAAQ,CAAC,GAAG,EAAE,MAAM;IAAE,QAAQ,CAAC,MAAM,EAAE,MAAM;IAAE,QAAQ,CAAC,QAAQ,EAAE,GAAG;IA9BzE,OAAO,CAAC,QAAQ,CAAC,KAAK,CAA6B;IAEnD;;;OAGG;IACH,MAAM,CAAC,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,YAAY;IAK1C;;;OAGG;IACH,MAAM,CAAC,OAAO,CAAC,GAAG,EAAE,GAAG;IAIvB;;;;OAIG;IACH,MAAM,CAAC,gBAAgB,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,YAAY;IAKlE,OAAO;IAGP;;;OAGG;IACH,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM;IAa1B;;;OAGG;IACH,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,GAAG;IAIzB,OAAO,CAAC,WAAW;CAcpB"}

package/lib/typescript/module/vendor/mcu/utils/color_utils.d.ts

@@ -0,0 +1,129 @@
+/**
+ * @license
+ * Copyright 2021 Google LLC
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *      http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+/**
+ * Converts a color from RGB components to ARGB format.
+ */
+export declare function argbFromRgb(red: number, green: number, blue: number): number;
+/**
+ * Converts a color from linear RGB components to ARGB format.
+ */
+export declare function argbFromLinrgb(linrgb: number[]): number;
+/**
+ * Returns the alpha component of a color in ARGB format.
+ */
+export declare function alphaFromArgb(argb: number): number;
+/**
+ * Returns the red component of a color in ARGB format.
+ */
+export declare function redFromArgb(argb: number): number;
+/**
+ * Returns the green component of a color in ARGB format.
+ */
+export declare function greenFromArgb(argb: number): number;
+/**
+ * Returns the blue component of a color in ARGB format.
+ */
+export declare function blueFromArgb(argb: number): number;
+/**
+ * Returns whether a color in ARGB format is opaque.
+ */
+export declare function isOpaque(argb: number): boolean;
+/**
+ * Converts a color from ARGB to XYZ.
+ */
+export declare function argbFromXyz(x: number, y: number, z: number): number;
+/**
+ * Converts a color from XYZ to ARGB.
+ */
+export declare function xyzFromArgb(argb: number): number[];
+/**
+ * Converts a color represented in Lab color space into an ARGB
+ * integer.
+ */
+export declare function argbFromLab(l: number, a: number, b: number): number;
+/**
+ * Converts a color from ARGB representation to L*a*b*
+ * representation.
+ *
+ * @param argb the ARGB representation of a color
+ * @return a Lab object representing the color
+ */
+export declare function labFromArgb(argb: number): number[];
+/**
+ * Converts an L* value to an ARGB representation.
+ *
+ * @param lstar L* in L*a*b*
+ * @return ARGB representation of grayscale color with lightness
+ * matching L*
+ */
+export declare function argbFromLstar(lstar: number): number;
+/**
+ * Computes the L* value of a color in ARGB representation.
+ *
+ * @param argb ARGB representation of a color
+ * @return L*, from L*a*b*, coordinate of the color
+ */
+export declare function lstarFromArgb(argb: number): number;
+/**
+ * Converts an L* value to a Y value.
+ *
+ * L* in L*a*b* and Y in XYZ measure the same quantity, luminance.
+ *
+ * L* measures perceptual luminance, a linear scale. Y in XYZ
+ * measures relative luminance, a logarithmic scale.
+ *
+ * @param lstar L* in L*a*b*
+ * @return Y in XYZ
+ */
+export declare function yFromLstar(lstar: number): number;
+/**
+ * Converts a Y value to an L* value.
+ *
+ * L* in L*a*b* and Y in XYZ measure the same quantity, luminance.
+ *
+ * L* measures perceptual luminance, a linear scale. Y in XYZ
+ * measures relative luminance, a logarithmic scale.
+ *
+ * @param y Y in XYZ
+ * @return L* in L*a*b*
+ */
+export declare function lstarFromY(y: number): number;
+/**
+ * Linearizes an RGB component.
+ *
+ * @param rgbComponent 0 <= rgb_component <= 255, represents R/G/B
+ * channel
+ * @return 0.0 <= output <= 100.0, color channel converted to
+ * linear RGB space
+ */
+export declare function linearized(rgbComponent: number): number;
+/**
+ * Delinearizes an RGB component.
+ *
+ * @param rgbComponent 0.0 <= rgb_component <= 100.0, represents
+ * linear R/G/B channel
+ * @return 0 <= output <= 255, color channel converted to regular
+ * RGB space
+ */
+export declare function delinearized(rgbComponent: number): number;
+/**
+ * Returns the standard white point; white on a sunny day.
+ *
+ * @return The white point
+ */
+export declare function whitePointD65(): number[];
+//# sourceMappingURL=color_utils.d.ts.map

package/lib/typescript/module/vendor/mcu/utils/color_utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"color_utils.d.ts","sourceRoot":"","sources":["../../../../../../src/vendor/mcu/utils/color_utils.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AA0CH;;GAEG;AACH,wBAAgB,WAAW,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAG5E;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,CAKvD;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAElD;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAEhD;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAElD;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAEjD;AAED;;GAEG;AACH,wBAAgB,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAE9C;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,CASnE;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,CAKlD;AAED;;;GAGG;AACH,wBAAgB,WAAW,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,CAYnE;AAED;;;;;;GAMG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,CAsBlD;AAED;;;;;;GAMG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAInD;AAED;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAGlD;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAEhD;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,UAAU,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,CAE5C;AAED;;;;;;;GAOG;AACH,wBAAgB,UAAU,CAAC,YAAY,EAAE,MAAM,GAAG,MAAM,CAOvD;AAED;;;;;;;GAOG;AACH,wBAAgB,YAAY,CAAC,YAAY,EAAE,MAAM,GAAG,MAAM,CASzD;AAED;;;;GAIG;AACH,wBAAgB,aAAa,IAAI,MAAM,EAAE,CAExC"}

package/lib/typescript/module/vendor/mcu/utils/math_utils.d.ts

@@ -0,0 +1,83 @@
+/**
+ * @license
+ * Copyright 2021 Google LLC
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *      http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+/**
+ * Utility methods for mathematical operations.
+ */
+/**
+ * The signum function.
+ *
+ * @return 1 if num > 0, -1 if num < 0, and 0 if num = 0
+ */
+export declare function signum(num: number): number;
+/**
+ * The linear interpolation function.
+ *
+ * @return start if amount = 0 and stop if amount = 1
+ */
+export declare function lerp(start: number, stop: number, amount: number): number;
+/**
+ * Clamps an integer between two integers.
+ *
+ * @return input when min <= input <= max, and either min or max
+ * otherwise.
+ */
+export declare function clampInt(min: number, max: number, input: number): number;
+/**
+ * Clamps an integer between two floating-point numbers.
+ *
+ * @return input when min <= input <= max, and either min or max
+ * otherwise.
+ */
+export declare function clampDouble(min: number, max: number, input: number): number;
+/**
+ * Sanitizes a degree measure as an integer.
+ *
+ * @return a degree measure between 0 (inclusive) and 360
+ * (exclusive).
+ */
+export declare function sanitizeDegreesInt(degrees: number): number;
+/**
+ * Sanitizes a degree measure as a floating-point number.
+ *
+ * @return a degree measure between 0.0 (inclusive) and 360.0
+ * (exclusive).
+ */
+export declare function sanitizeDegreesDouble(degrees: number): number;
+/**
+ * Sign of direction change needed to travel from one angle to
+ * another.
+ *
+ * For angles that are 180 degrees apart from each other, both
+ * directions have the same travel distance, so either direction is
+ * shortest. The value 1.0 is returned in this case.
+ *
+ * @param from The angle travel starts from, in degrees.
+ * @param to The angle travel ends at, in degrees.
+ * @return -1 if decreasing from leads to the shortest travel
+ * distance, 1 if increasing from leads to the shortest travel
+ * distance.
+ */
+export declare function rotationDirection(from: number, to: number): number;
+/**
+ * Distance of two points on a circle, represented using degrees.
+ */
+export declare function differenceDegrees(a: number, b: number): number;
+/**
+ * Multiplies a 1x3 row vector with a 3x3 matrix.
+ */
+export declare function matrixMultiply(row: number[], matrix: number[][]): number[];
+//# sourceMappingURL=math_utils.d.ts.map

package/lib/typescript/module/vendor/mcu/utils/math_utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"math_utils.d.ts","sourceRoot":"","sources":["../../../../../../src/vendor/mcu/utils/math_utils.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAOH;;GAEG;AAEH;;;;GAIG;AACH,wBAAgB,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAQ1C;AAED;;;;GAIG;AACH,wBAAgB,IAAI,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAExE;AAED;;;;;GAKG;AACH,wBAAgB,QAAQ,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAQxE;AAED;;;;;GAKG;AACH,wBAAgB,WAAW,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAQ3E;AAED;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAM1D;AAED;;;;;GAKG;AACH,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAM7D;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,MAAM,CAGlE;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,CAE9D;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,GAAG,EAAE,MAAM,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,EAAE,GAAG,MAAM,EAAE,CAQ1E"}

package/package.json

@@ -1,15 +1,23 @@
 {
 	"name": "@chipmobilesdk/rn-theme",
-	"version": "1.1.0",
+	"version": "1.3.0",
 	"private": false,
 	"license": "UNLICENSED",
-	"main": "src/index.ts",
-	"types": "src/index.ts",
+	"source": "./src/index.ts",
+	"main": "./lib/commonjs/index.js",
+	"module": "./lib/module/index.js",
+	"types": "./lib/typescript/commonjs/index.d.ts",
 	"exports": {
 		".": {
-			"types": "./src/index.ts",
-			"react-native": "./src/index.ts",
-			"default": "./src/index.ts"
+			"chipmobilesdk-source": "./src/index.ts",
+			"import": {
+				"types": "./lib/typescript/module/index.d.ts",
+				"default": "./lib/module/index.js"
+			},
+			"require": {
+				"types": "./lib/typescript/commonjs/index.d.ts",
+				"default": "./lib/commonjs/index.js"
+			}
 		}
 	},
 	"files": [
@@ -25,28 +33,44 @@
 		"skills",
 		"README.md",
 		"CHANGELOG.md",
-		"NOTICE"
+		"NOTICE",
+		"lib"
 	],
 	"sideEffects": false,
 	"scripts": {
+		"build": "bob build",
 		"typecheck": "tsc -p tsconfig.json && tsc -p tsconfig.test.json",
-		"pack:check": "npm pack --dry-run"
+		"pack:check": "npm pack --dry-run",
+		"prepack": "npm run build"
 	},
 	"dependencies": {
-		"@chipmobilesdk/rn-core": "^0.1.0"
+		"@chipmobilesdk/rn-core": "^0.2.0"
 	},
 	"peerDependencies": {
-		"react": ">=19",
 		"react-native": ">=0.85",
-		"react-native-unistyles": ">=3.2"
-	},
-	"peerDependenciesMeta": {
-		"react-native-unistyles": {
-			"optional": false
-		}
+		"react-native-unistyles": "^3.2.0"
 	},
 	"publishConfig": {
 		"access": "public",
 		"registry": "https://registry.npmjs.org/"
+	},
+	"react-native-builder-bob": {
+		"source": "src",
+		"output": "lib",
+		"targets": [
+			[
+				"commonjs",
+				{
+					"esm": true
+				}
+			],
+			[
+				"module",
+				{
+					"esm": true
+				}
+			],
+			"typescript"
+		]
 	}
 }

package/src/color/roles.ts

@@ -7,6 +7,7 @@ import type {
 	StandardToneName,
 	ToneColors,
 } from '../types/colors';
+import { DEFAULT_OPACITY } from '../tokens/defaults';
 import { argbFromColor, hexFromArgb, withAlpha } from './parse';
 
 /**
@@ -27,7 +28,8 @@ const MAX_NEUTRAL_SEED_CHROMA = 16;
 const NEUTRAL_VARIANT_EXTRA_CHROMA = 4;
 
 /** Material 3 opacities applied to `onSurface` and the scrim. */
-export const DISABLED_CONTENT_OPACITY = 0.38;
+/** The same figure as `opacity.disabledContent`, from its one definition (THM-07). */
+export const DISABLED_CONTENT_OPACITY = DEFAULT_OPACITY.disabledContent;
 const SCRIM_OPACITY = 0.32;
 
 /**

package/src/theme/buildThemes.ts

@@ -27,8 +27,8 @@ import type {
 	Themes,
 } from '../types/theme';
 import type { FontToken, FontWeightName } from '../types/typography';
-import { describeFailures, ThemeContrastError } from './errors';
-import { mergeOverrides, pick } from './overrides';
+import { describeFailures, ThemeConfigError, ThemeContrastError } from './errors';
+import { isPlainObject, mergeOverrides, pick } from './overrides';
 import { validateThemeConfig } from './validateThemeConfig';
 
 export interface BuildThemesOptions {
@@ -56,23 +56,15 @@ function deviceHairlineWidth(): number {
 	return (result.ok ? result.module.StyleSheet?.hairlineWidth : undefined) ?? 1;
 }
 
-/** Groups that come straight from tokens (presets and tones are derived after). */
-const TOKEN_KEYS = [
-	'color',
-	'typography',
-	'font',
-	'fontWeight',
-	'spacing',
-	'radius',
-	'borderWidth',
-	'size',
-	'opacity',
-	'motion',
-	'shadow',
-	'zIndex',
-	'maxFontScale',
-	'categorical',
-] as const;
+/** The standard tone names an app's own tone may not take over (THM-03). */
+const STANDARD_TONES: ReadonlySet<string> = new Set([
+	'neutral',
+	'primary',
+	'info',
+	'success',
+	'warning',
+	'error',
+]);
 
 interface ThemeSource {
 	name: string;
@@ -92,6 +84,35 @@ function cloneFonts(font: Record<FontWeightName, FontToken>): Record<FontWeightN
 	return copy;
 }
 
+/**
+ * Every top-level group an override may name, and nothing else.
+ *
+ * An override naming a group that does not exist — `radii` for `radius`,
+ * `colors` for `color` — used to be dropped without a word, so the override
+ * simply had no effect (THM-01). The list is derived from what was generated
+ * rather than written out by hand, so a new token group cannot be forgotten
+ * (THM-06).
+ */
+function assertKnownOverrideGroups(
+	overrides: unknown,
+	known: Iterable<string>,
+	path: string,
+): void {
+	if (!isPlainObject(overrides)) {
+		return;
+	}
+	const allowed = new Set(known);
+	for (const key of Object.keys(overrides)) {
+		if (overrides[key] === undefined || allowed.has(key)) {
+			continue;
+		}
+		throw new ThemeConfigError(
+			`${path}.${key}`,
+			'does not exist on the theme. Add new tokens through `extend`.',
+		);
+	}
+}
+
 function buildOne(
 	source: ThemeSource,
 	fonts: ReturnType<typeof buildFonts>,
@@ -100,9 +121,15 @@ function buildOne(
 ): object {
 	const { name, scheme, config, palettes } = source;
 	const path = `overrides.${name}`;
-	const color = buildColorRoles(palettes, scheme);
+	const generatedColor = buildColorRoles(palettes, scheme);
+
+	// Colour is merged first, because what follows is derived from it: an
+	// override of `color.shadow` or `color.onSurface` used to leave `shadow` and
+	// `tone.neutral` built from the generated value, so a theme that pinned a
+	// colour disagreed with itself (THM-02).
+	const color = mergeOverrides(generatedColor, pick(overrides, ['color'])?.color, `${path}.color`);
 
-	const generated = {
+	const tokenGroups = {
 		color,
 		typography: buildTypography(config.typography, fonts.font, fonts.family),
 		font: cloneFonts(fonts.font),
@@ -117,21 +144,41 @@ function buildOne(
 		zIndex: buildZIndex(),
 		maxFontScale: config.typography?.maxFontScale ?? DEFAULT_MAX_FONT_SCALE,
 		categorical: buildCategorical(config.brandColors.primary, scheme),
-	};
-	const tokens = mergeOverrides(generated, pick(overrides, TOKEN_KEYS), path);
+	} satisfies Omit<BaseTheme<string>, 'tone' | (typeof PRESET_KEYS)[number]>;
+
+	const tokenKeys = Object.keys(tokenGroups);
+	const tokens = mergeOverrides(tokenGroups, pick(overrides, tokenKeys), path);
 	const tone = mergeOverrides(
-		buildTones<string>(palettes, color, scheme),
+		// From the merged colour, so `tone.neutral` follows an override of
+		// `color.onSurface` as the text presets already did.
+		buildTones<string>(palettes, tokens.color, scheme),
 		pick(overrides, ['tone'])?.tone,
 		`${path}.tone`,
 	);
 	const presets = mergeOverrides(buildPresets(tokens), pick(overrides, PRESET_KEYS), path);
-	const base = { ...tokens, tone, ...presets } as BaseTheme<string>;
+	const base = { ...tokens, tone, ...presets } satisfies BaseTheme<string>;
 
 	if (!config.extend) {
+		assertKnownOverrideGroups(overrides, [...tokenKeys, 'tone', ...PRESET_KEYS], path);
 		return base;
 	}
 
 	const extension = config.extend({ name, scheme, theme: base });
+	for (const key of Object.keys(extension)) {
+		if (key in base) {
+			// `extend` returning `{ spacing: … }` replaced the whole spacing scale
+			// with whatever it held, unvalidated (THM-03).
+			throw new ThemeConfigError(
+				`extend.${key}`,
+				'is already a theme group. Give the extension token a name of its own.',
+			);
+		}
+	}
+	assertKnownOverrideGroups(
+		overrides,
+		[...tokenKeys, 'tone', ...PRESET_KEYS, ...Object.keys(extension)],
+		path,
+	);
 	const extensionOverrides = pick(overrides, Object.keys(extension));
 
 	return { ...base, ...mergeOverrides(extension, extensionOverrides, path) };
@@ -186,11 +233,22 @@ export function buildThemes<
 		{ name: 'light', scheme: 'light', config: loose, palettes: basePalettes },
 		{ name: 'dark', scheme: 'dark', config: loose, palettes: basePalettes },
 		...Object.entries(loose.themes ?? {}).map(([name, named]) => {
+			const tones = { ...loose.tones, ...named.tones } as Record<string, string>;
+			for (const tone of Object.keys(tones)) {
+				if (STANDARD_TONES.has(tone)) {
+					// A custom tone named `primary` silently replaced the standard
+					// one, contrast guarantees and all (THM-03).
+					throw new ThemeConfigError(
+						`themes.${name}.tones.${tone}`,
+						'is a standard tone. Override it through `overrides` instead.',
+					);
+				}
+			}
 			const namedConfig = {
 				...loose,
 				brandColors: named.brandColors ?? loose.brandColors,
 				seeds: { ...loose.seeds, ...named.seeds },
-				tones: { ...loose.tones, ...named.tones } as Record<string, string>,
+				tones,
 			};
 
 			return {