@chipmobilesdk/rn-theme 1.2.0 → 1.3.0

package/lib/typescript/module/types/tokens.d.ts

@@ -0,0 +1,79 @@
+export interface SpacingTokens {
+    none: number;
+    xxs: number;
+    xs: number;
+    sm: number;
+    smPlus: number;
+    md: number;
+    mdPlus: number;
+    lg: number;
+    xl: number;
+    xlPlus: number;
+    xxl: number;
+    xxxl: number;
+}
+export type SpacingKey = keyof SpacingTokens;
+export interface RadiusTokens {
+    none: number;
+    xs: number;
+    sm: number;
+    md: number;
+    lg: number;
+    xl: number;
+    full: number;
+}
+export interface BorderWidthTokens {
+    hairline: number;
+    thin: number;
+    thick: number;
+}
+export interface SizeTokens {
+    /** Minimum touch target side, in points (WCAG 2.5.8 / standards V). */
+    touchTarget: number;
+    icon: {
+        sm: number;
+        md: number;
+        lg: number;
+    };
+}
+/** Material 3 state-layer and disabled opacities. */
+export interface OpacityTokens {
+    hover: number;
+    focus: number;
+    pressed: number;
+    dragged: number;
+    disabledContent: number;
+    disabledContainer: number;
+}
+/** Cubic-bezier control points `[x1, y1, x2, y2]`, e.g. for `Easing.bezier`. */
+export type EasingCurve = [number, number, number, number];
+export interface MotionTokens {
+    duration: {
+        short: number;
+        medium: number;
+        long: number;
+    };
+    easing: {
+        standard: EasingCurve;
+        emphasized: EasingCurve;
+        decelerate: EasingCurve;
+        accelerate: EasingCurve;
+    };
+}
+export interface ShadowToken {
+    /** CSS-style shadow list, rendered by React Native on iOS and Android. */
+    boxShadow: string;
+}
+export interface ShadowTokens {
+    sm: ShadowToken;
+    md: ShadowToken;
+    lg: ShadowToken;
+}
+export interface ZIndexTokens {
+    base: number;
+    raised: number;
+    modal: number;
+    overlay: number;
+    toast: number;
+}
+//# sourceMappingURL=tokens.d.ts.map

package/lib/typescript/module/types/tokens.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tokens.d.ts","sourceRoot":"","sources":["../../../../src/types/tokens.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,aAAa;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,MAAM,CAAC;IACZ,EAAE,EAAE,MAAM,CAAC;IACX,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,MAAM,CAAC;IACf,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,MAAM,CAAC;IACf,EAAE,EAAE,MAAM,CAAC;IACX,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,MAAM,CAAC;IACf,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;CACb;AAED,MAAM,MAAM,UAAU,GAAG,MAAM,aAAa,CAAC;AAE7C,MAAM,WAAW,YAAY;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,EAAE,EAAE,MAAM,CAAC;IACX,EAAE,EAAE,MAAM,CAAC;IACX,EAAE,EAAE,MAAM,CAAC;IACX,EAAE,EAAE,MAAM,CAAC;IACX,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;CACb;AAED,MAAM,WAAW,iBAAiB;IACjC,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,UAAU;IAC1B,uEAAuE;IACvE,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,EAAE;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,EAAE,EAAE,MAAM,CAAC;QAAC,EAAE,EAAE,MAAM,CAAA;KAAE,CAAC;CAC7C;AAED,qDAAqD;AACrD,MAAM,WAAW,aAAa;IAC7B,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,eAAe,EAAE,MAAM,CAAC;IACxB,iBAAiB,EAAE,MAAM,CAAC;CAC1B;AAED,gFAAgF;AAChF,MAAM,MAAM,WAAW,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;AAE3D,MAAM,WAAW,YAAY;IAC5B,QAAQ,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC;IAC1D,MAAM,EAAE;QACP,QAAQ,EAAE,WAAW,CAAC;QACtB,UAAU,EAAE,WAAW,CAAC;QACxB,UAAU,EAAE,WAAW,CAAC;QACxB,UAAU,EAAE,WAAW,CAAC;KACxB,CAAC;CACF;AAED,MAAM,WAAW,WAAW;IAC3B,0EAA0E;IAC1E,SAAS,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,YAAY;IAC5B,EAAE,EAAE,WAAW,CAAC;IAChB,EAAE,EAAE,WAAW,CAAC;IAChB,EAAE,EAAE,WAAW,CAAC;CAChB;AAED,MAAM,WAAW,YAAY;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;CACd"}

package/lib/typescript/module/types/typography.d.ts

@@ -0,0 +1,53 @@
+export type FontWeightName = 'regular' | 'medium' | 'semibold' | 'bold' | 'heavy';
+/** The weight strings the package emits; each is a valid React Native `fontWeight`. */
+export type FontWeightValue = 'normal' | '400' | '500' | '600' | '700' | '800' | '900';
+/**
+ * Custom font files per weight. Android cannot pick a weight inside a family,
+ * so every weight needs its own family name there; iOS resolves weights within
+ * one family unless a per-weight name is given.
+ */
+export interface FontConfig {
+    /** Family used where no per-weight name applies. */
+    family?: string;
+    ios?: Partial<Record<FontWeightName, string>>;
+    android?: Partial<Record<FontWeightName, string>>;
+}
+export interface TypographyConfig {
+    /** Single family for every weight (0.2.x behaviour). Defaults to `System`. */
+    fontFamily?: string;
+    fonts?: FontConfig;
+    baseFontSize?: number;
+    /** Design-time multiplier. It does not track the OS text-size setting. */
+    fontScale?: number;
+    /**
+     * Ceiling for the OS text-size multiplier, applied by the app's `Text`
+     * through `maxFontSizeMultiplier`. Defaults to 2 (WCAG 1.4.4).
+     */
+    maxFontScale?: number;
+}
+export type TypographyRole = 'display' | 'headline' | 'title' | 'body' | 'label' | 'caption';
+export type TypographyStyleName = TypographyRole | `${TypographyRole}Small` | `${TypographyRole}Large`;
+export interface TypographyToken {
+    fontSize: number;
+    lineHeight: number;
+    fontWeight: FontWeightValue;
+    fontFamily: string;
+    letterSpacing?: number;
+}
+/** The six 0.2.x role names resolve to the medium size. */
+export type Typography = {
+    fontFamily: string;
+} & Record<TypographyStyleName, TypographyToken>;
+/** The fixed weight scale behind the weight names. */
+export interface FontWeights {
+    regular: '400';
+    medium: '500';
+    semibold: '600';
+    bold: '700';
+    heavy: '800';
+}
+export interface FontToken {
+    fontFamily: string;
+    fontWeight: FontWeightValue;
+}
+//# sourceMappingURL=typography.d.ts.map

package/lib/typescript/module/types/typography.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"typography.d.ts","sourceRoot":"","sources":["../../../../src/types/typography.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,cAAc,GAAG,SAAS,GAAG,QAAQ,GAAG,UAAU,GAAG,MAAM,GAAG,OAAO,CAAC;AAElF,uFAAuF;AACvF,MAAM,MAAM,eAAe,GAAG,QAAQ,GAAG,KAAK,GAAG,KAAK,GAAG,KAAK,GAAG,KAAK,GAAG,KAAK,GAAG,KAAK,CAAC;AAEvF;;;;GAIG;AACH,MAAM,WAAW,UAAU;IAC1B,oDAAoD;IACpD,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,GAAG,CAAC,EAAE,OAAO,CAAC,MAAM,CAAC,cAAc,EAAE,MAAM,CAAC,CAAC,CAAC;IAC9C,OAAO,CAAC,EAAE,OAAO,CAAC,MAAM,CAAC,cAAc,EAAE,MAAM,CAAC,CAAC,CAAC;CAClD;AAED,MAAM,WAAW,gBAAgB;IAChC,8EAA8E;IAC9E,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,KAAK,CAAC,EAAE,UAAU,CAAC;IACnB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,0EAA0E;IAC1E,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;;;OAGG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,MAAM,cAAc,GAAG,SAAS,GAAG,UAAU,GAAG,OAAO,GAAG,MAAM,GAAG,OAAO,GAAG,SAAS,CAAC;AAE7F,MAAM,MAAM,mBAAmB,GAC9B,cAAc,GAAG,GAAG,cAAc,OAAO,GAAG,GAAG,cAAc,OAAO,CAAC;AAEtE,MAAM,WAAW,eAAe;IAC/B,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,eAAe,CAAC;IAC5B,UAAU,EAAE,MAAM,CAAC;IACnB,aAAa,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,2DAA2D;AAC3D,MAAM,MAAM,UAAU,GAAG;IAAE,UAAU,EAAE,MAAM,CAAA;CAAE,GAAG,MAAM,CAAC,mBAAmB,EAAE,eAAe,CAAC,CAAC;AAE/F,sDAAsD;AACtD,MAAM,WAAW,WAAW;IAC3B,OAAO,EAAE,KAAK,CAAC;IACf,MAAM,EAAE,KAAK,CAAC;IACd,QAAQ,EAAE,KAAK,CAAC;IAChB,IAAI,EAAE,KAAK,CAAC;IACZ,KAAK,EAAE,KAAK,CAAC;CACb;AAED,MAAM,WAAW,SAAS;IACzB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,eAAe,CAAC;CAC5B"}

package/lib/typescript/module/unistyles/createUnistylesConfig.d.ts

@@ -0,0 +1,52 @@
+import { type BuildThemesOptions } from '../theme/buildThemes.js';
+import { DEFAULT_BREAKPOINTS } from '../tokens/defaults.js';
+import type { EmptyExtension, ThemeConfig, ThemeName, Themes } from '../types/theme.js';
+type Breakpoints = Record<string, number>;
+interface UnistylesBaseSettings {
+    CSSVars?: boolean;
+    nativeBreakpointsMode?: 'pixels' | 'points';
+}
+export type UnistylesConfigOptions<TName extends string = never, TBreakpoints extends Breakpoints = typeof DEFAULT_BREAKPOINTS> = UnistylesBaseSettings & BuildThemesOptions & {
+    /** Replaces the default `compact`/`medium`/`expanded` breakpoints; one must be 0. */
+    breakpoints?: TBreakpoints;
+} & ({
+    /** Theme active on first launch. Defaults to 'light'. */
+    initialTheme?: ThemeName<TName> | (() => ThemeName<TName>);
+    adaptiveThemes?: false;
+} | {
+    /** Follow the system colour scheme between light and dark. */
+    adaptiveThemes: boolean;
+    initialTheme?: never;
+});
+type UnistylesSettings<TName extends string> = UnistylesBaseSettings & ({
+    initialTheme: ThemeName<TName> | (() => ThemeName<TName>);
+    adaptiveThemes?: false;
+} | {
+    adaptiveThemes: true;
+    initialTheme?: never;
+});
+export interface UnistylesConfig<TExt extends object = EmptyExtension, TTone extends string = never, TName extends string = never, TBreakpoints extends Breakpoints = typeof DEFAULT_BREAKPOINTS> {
+    themes: Themes<TExt, TTone, TName>;
+    settings: UnistylesSettings<TName>;
+    breakpoints: TBreakpoints;
+}
+/**
+ * Builds the object for `StyleSheet.configure`: every theme, settings and
+ * breakpoints.
+ *
+ * ```ts
+ * const config = createUnistylesConfig({ brandColors: BRAND_COLORS }, { initialTheme: 'light' });
+ *
+ * type AppThemes = typeof config.themes;
+ * type AppBreakpoints = typeof config.breakpoints;
+ * declare module 'react-native-unistyles' {
+ *   export interface UnistylesThemes extends AppThemes {}
+ *   export interface UnistylesBreakpoints extends AppBreakpoints {}
+ * }
+ *
+ * StyleSheet.configure(config);
+ * ```
+ */
+export declare function createUnistylesConfig<TExt extends object = EmptyExtension, TTone extends string = never, TName extends string = never, TBreakpoints extends Breakpoints = typeof DEFAULT_BREAKPOINTS>(config: ThemeConfig<TExt, TTone, TName>, options?: UnistylesConfigOptions<NoInfer<TName>, TBreakpoints>): UnistylesConfig<TExt, TTone, TName, TBreakpoints>;
+export {};
+//# sourceMappingURL=createUnistylesConfig.d.ts.map

package/lib/typescript/module/unistyles/createUnistylesConfig.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"createUnistylesConfig.d.ts","sourceRoot":"","sources":["../../../../src/unistyles/createUnistylesConfig.ts"],"names":[],"mappings":"AAAA,OAAO,EAAe,KAAK,kBAAkB,EAAE,MAAM,yBAAsB,CAAC;AAI5E,OAAO,EAAE,mBAAmB,EAAE,MAAM,uBAAoB,CAAC;AACzD,OAAO,KAAK,EAAE,cAAc,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,mBAAgB,CAAC;AAErF,KAAK,WAAW,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;AAE1C,UAAU,qBAAqB;IAC9B,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,qBAAqB,CAAC,EAAE,QAAQ,GAAG,QAAQ,CAAC;CAC5C;AAED,MAAM,MAAM,sBAAsB,CACjC,KAAK,SAAS,MAAM,GAAG,KAAK,EAC5B,YAAY,SAAS,WAAW,GAAG,OAAO,mBAAmB,IAC1D,qBAAqB,GACxB,kBAAkB,GAAG;IACpB,qFAAqF;IACrF,WAAW,CAAC,EAAE,YAAY,CAAC;CAC3B,GAAG,CACD;IACA,yDAAyD;IACzD,YAAY,CAAC,EAAE,SAAS,CAAC,KAAK,CAAC,GAAG,CAAC,MAAM,SAAS,CAAC,KAAK,CAAC,CAAC,CAAC;IAC3D,cAAc,CAAC,EAAE,KAAK,CAAC;CACtB,GACD;IACA,8DAA8D;IAC9D,cAAc,EAAE,OAAO,CAAC;IACxB,YAAY,CAAC,EAAE,KAAK,CAAC;CACpB,CACH,CAAC;AAEH,KAAK,iBAAiB,CAAC,KAAK,SAAS,MAAM,IAAI,qBAAqB,GACnE,CACG;IAAE,YAAY,EAAE,SAAS,CAAC,KAAK,CAAC,GAAG,CAAC,MAAM,SAAS,CAAC,KAAK,CAAC,CAAC,CAAC;IAAC,cAAc,CAAC,EAAE,KAAK,CAAA;CAAE,GACrF;IAAE,cAAc,EAAE,IAAI,CAAC;IAAC,YAAY,CAAC,EAAE,KAAK,CAAA;CAAE,CAChD,CAAC;AAEH,MAAM,WAAW,eAAe,CAC/B,IAAI,SAAS,MAAM,GAAG,cAAc,EACpC,KAAK,SAAS,MAAM,GAAG,KAAK,EAC5B,KAAK,SAAS,MAAM,GAAG,KAAK,EAC5B,YAAY,SAAS,WAAW,GAAG,OAAO,mBAAmB;IAE7D,MAAM,EAAE,MAAM,CAAC,IAAI,EAAE,KAAK,EAAE,KAAK,CAAC,CAAC;IACnC,QAAQ,EAAE,iBAAiB,CAAC,KAAK,CAAC,CAAC;IACnC,WAAW,EAAE,YAAY,CAAC;CAC1B;AAsFD;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,qBAAqB,CACpC,IAAI,SAAS,MAAM,GAAG,cAAc,EACpC,KAAK,SAAS,MAAM,GAAG,KAAK,EAC5B,KAAK,SAAS,MAAM,GAAG,KAAK,EAC5B,YAAY,SAAS,WAAW,GAAG,OAAO,mBAAmB,EAE7D,MAAM,EAAE,WAAW,CAAC,IAAI,EAAE,KAAK,EAAE,KAAK,CAAC,EACvC,OAAO,CAAC,EAAE,sBAAsB,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,YAAY,CAAC,GAC5D,eAAe,CAAC,IAAI,EAAE,KAAK,EAAE,KAAK,EAAE,YAAY,CAAC,CAWnD"}

package/lib/typescript/module/unistyles/themeMode.d.ts

@@ -0,0 +1,13 @@
+export type ThemeMode = 'system' | 'light' | 'dark';
+/** The two runtime calls a mode change needs. */
+export interface ThemeModeRuntime {
+    setAdaptiveThemes(enabled: boolean): void;
+    setTheme(name: string): void;
+}
+/**
+ * Applies a light/dark/system preference. Adaptive themes are switched off
+ * before a manual theme is set; in the other order the next OS colour-scheme
+ * change overrides the user's choice. Persisting the preference is the app's.
+ */
+export declare function applyThemeMode(mode: ThemeMode, runtime?: ThemeModeRuntime): void;
+//# sourceMappingURL=themeMode.d.ts.map

package/lib/typescript/module/unistyles/themeMode.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"themeMode.d.ts","sourceRoot":"","sources":["../../../../src/unistyles/themeMode.ts"],"names":[],"mappings":"AAIA,MAAM,MAAM,SAAS,GAAG,QAAQ,GAAG,OAAO,GAAG,MAAM,CAAC;AAEpD,iDAAiD;AACjD,MAAM,WAAW,gBAAgB;IAChC,iBAAiB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAAC;IAC1C,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;CAC7B;AAwBD;;;;GAIG;AACH,wBAAgB,cAAc,CAC7B,IAAI,EAAE,SAAS,EACf,OAAO,GAAE,gBAAmC,GAC1C,IAAI,CAQN"}

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

@@ -0,0 +1,132 @@
+/**
+ * @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 { ViewingConditions } from './viewing_conditions.js';
+/**
+ * CAM16, a color appearance model. Colors are not just defined by their hex
+ * code, but rather, a hex code and viewing conditions.
+ *
+ * CAM16 instances also have coordinates in the CAM16-UCS space, called J*, a*,
+ * b*, or jstar, astar, bstar in code. CAM16-UCS is included in the CAM16
+ * specification, and should be used when measuring distances between colors.
+ *
+ * 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)
+ */
+export declare class Cam16 {
+    readonly hue: number;
+    readonly chroma: number;
+    readonly j: number;
+    readonly q: number;
+    readonly m: number;
+    readonly s: number;
+    readonly jstar: number;
+    readonly astar: number;
+    readonly bstar: number;
+    /**
+     * All of the CAM16 dimensions can be calculated from 3 of the dimensions, in
+     * the following combinations:
+     *      -  {j or q} and {c, m, or s} and hue
+     *      - jstar, astar, bstar
+     * Prefer using a static method that constructs from 3 of those dimensions.
+     * This constructor is intended for those methods to use to return all
+     * possible dimensions.
+     *
+     * @param hue
+     * @param chroma informally, colorfulness / color intensity. like saturation
+     *     in HSL, except perceptually accurate.
+     * @param j lightness
+     * @param q brightness; ratio of lightness to white point's lightness
+     * @param m colorfulness
+     * @param s saturation; ratio of chroma to white point's chroma
+     * @param jstar CAM16-UCS J coordinate
+     * @param astar CAM16-UCS a coordinate
+     * @param bstar CAM16-UCS b coordinate
+     */
+    constructor(hue: number, chroma: number, j: number, q: number, m: number, s: number, jstar: number, astar: number, bstar: number);
+    /**
+     * CAM16 instances also have coordinates in the CAM16-UCS space, called J*,
+     * a*, b*, or jstar, astar, bstar in code. CAM16-UCS is included in the CAM16
+     * specification, and is used to measure distances between colors.
+     */
+    distance(other: Cam16): number;
+    /**
+     * @param argb ARGB representation of a color.
+     * @return CAM16 color, assuming the color was viewed in default viewing
+     *     conditions.
+     */
+    static fromInt(argb: number): Cam16;
+    /**
+     * @param argb ARGB representation of a color.
+     * @param viewingConditions Information about the environment where the color
+     *     was observed.
+     * @return CAM16 color.
+     */
+    static fromIntInViewingConditions(argb: number, viewingConditions: ViewingConditions): Cam16;
+    /**
+     * @param j CAM16 lightness
+     * @param c CAM16 chroma
+     * @param h CAM16 hue
+     */
+    static fromJch(j: number, c: number, h: number): Cam16;
+    /**
+     * @param j CAM16 lightness
+     * @param c CAM16 chroma
+     * @param h CAM16 hue
+     * @param viewingConditions Information about the environment where the color
+     *     was observed.
+     */
+    static fromJchInViewingConditions(j: number, c: number, h: number, viewingConditions: ViewingConditions): Cam16;
+    /**
+     * @param jstar CAM16-UCS lightness.
+     * @param astar CAM16-UCS a dimension. Like a* in L*a*b*, it is a Cartesian
+     *     coordinate on the Y axis.
+     * @param bstar CAM16-UCS b dimension. Like a* in L*a*b*, it is a Cartesian
+     *     coordinate on the X axis.
+     */
+    static fromUcs(jstar: number, astar: number, bstar: number): Cam16;
+    /**
+     * @param jstar CAM16-UCS lightness.
+     * @param astar CAM16-UCS a dimension. Like a* in L*a*b*, it is a Cartesian
+     *     coordinate on the Y axis.
+     * @param bstar CAM16-UCS b dimension. Like a* in L*a*b*, it is a Cartesian
+     *     coordinate on the X axis.
+     * @param viewingConditions Information about the environment where the color
+     *     was observed.
+     */
+    static fromUcsInViewingConditions(jstar: number, astar: number, bstar: number, viewingConditions: ViewingConditions): Cam16;
+    /**
+     *  @return ARGB representation of color, assuming the color was viewed in
+     *     default viewing conditions, which are near-identical to the default
+     *     viewing conditions for sRGB.
+     */
+    toInt(): number;
+    /**
+     * @param viewingConditions Information about the environment where the color
+     *     will be viewed.
+     * @return ARGB representation of color
+     */
+    viewed(viewingConditions: ViewingConditions): number;
+    static fromXyzInViewingConditions(x: number, y: number, z: number, viewingConditions: ViewingConditions): Cam16;
+    xyzInViewingConditions(viewingConditions: ViewingConditions): number[];
+}
+//# sourceMappingURL=cam16.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"cam16.d.ts","sourceRoot":"","sources":["../../../../../../src/vendor/mcu/hct/cam16.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAQH,OAAO,EAAC,iBAAiB,EAAC,MAAM,yBAAsB,CAAC;AAEvD;;;;;;;;;;;;;;;;GAgBG;AACH,qBAAa,KAAK;IAsBZ,QAAQ,CAAC,GAAG,EAAE,MAAM;IAAE,QAAQ,CAAC,MAAM,EAAE,MAAM;IAAE,QAAQ,CAAC,CAAC,EAAE,MAAM;IACjE,QAAQ,CAAC,CAAC,EAAE,MAAM;IAAE,QAAQ,CAAC,CAAC,EAAE,MAAM;IAAE,QAAQ,CAAC,CAAC,EAAE,MAAM;IAC1D,QAAQ,CAAC,KAAK,EAAE,MAAM;IAAE,QAAQ,CAAC,KAAK,EAAE,MAAM;IAAE,QAAQ,CAAC,KAAK,EAAE,MAAM;IAvB1E;;;;;;;;;;;;;;;;;;;OAmBG;gBAEU,GAAG,EAAE,MAAM,EAAW,MAAM,EAAE,MAAM,EAAW,CAAC,EAAE,MAAM,EACxD,CAAC,EAAE,MAAM,EAAW,CAAC,EAAE,MAAM,EAAW,CAAC,EAAE,MAAM,EACjD,KAAK,EAAE,MAAM,EAAW,KAAK,EAAE,MAAM,EAAW,KAAK,EAAE,MAAM;IAE1E;;;;OAIG;IACH,QAAQ,CAAC,KAAK,EAAE,KAAK,GAAG,MAAM;IAS9B;;;;OAIG;IACH,MAAM,CAAC,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,KAAK;IAInC;;;;;OAKG;IACH,MAAM,CAAC,0BAA0B,CAC7B,IAAI,EAAE,MAAM,EAAE,iBAAiB,EAAE,iBAAiB,GAAG,KAAK;IA8D9D;;;;OAIG;IACH,MAAM,CAAC,OAAO,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,KAAK;IAItD;;;;;;OAMG;IACH,MAAM,CAAC,0BAA0B,CAC7B,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAC/B,iBAAiB,EAAE,iBAAiB,GAAG,KAAK;IAehD;;;;;;OAMG;IACH,MAAM,CAAC,OAAO,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,KAAK;IAKlE;;;;;;;;OAQG;IACH,MAAM,CAAC,0BAA0B,CAC7B,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAC3C,iBAAiB,EAAE,iBAAiB,GAAG,KAAK;IAchD;;;;OAIG;IACH,KAAK,IAAI,MAAM;IAIf;;;;OAIG;IACH,MAAM,CAAC,iBAAiB,EAAE,iBAAiB,GAAG,MAAM;IAoDpD,MAAM,CAAC,0BAA0B,CAC7B,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAC/B,iBAAiB,EAAE,iBAAiB,GAAG,KAAK;IAuEhD,sBAAsB,CAAC,iBAAiB,EAAE,iBAAiB,GAAG,MAAM,EAAE;CAiDvE"}

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

@@ -0,0 +1,93 @@
+/**
+ * @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 { ViewingConditions } from './viewing_conditions.js';
+/**
+ * HCT, hue, chroma, and tone. A color system that provides a perceptually
+ * accurate color measurement system that can also accurately render what colors
+ * will appear as in different lighting environments.
+ */
+export declare class Hct {
+    private argb;
+    /**
+     * @param hue 0 <= hue < 360; invalid values are corrected.
+     * @param chroma 0 <= chroma < ?; Informally, colorfulness. The color
+     *     returned may be lower than the requested chroma. Chroma has a different
+     *     maximum for any given hue and tone.
+     * @param tone 0 <= tone <= 100; invalid values are corrected.
+     * @return HCT representation of a color in default viewing conditions.
+     */
+    internalHue: number;
+    internalChroma: number;
+    internalTone: number;
+    static from(hue: number, chroma: number, tone: number): Hct;
+    /**
+     * @param argb ARGB representation of a color.
+     * @return HCT representation of a color in default viewing conditions
+     */
+    static fromInt(argb: number): Hct;
+    toInt(): number;
+    /**
+     * A number, in degrees, representing ex. red, orange, yellow, etc.
+     * Ranges from 0 <= hue < 360.
+     */
+    get hue(): number;
+    /**
+     * @param newHue 0 <= newHue < 360; invalid values are corrected.
+     * Chroma may decrease because chroma has a different maximum for any given
+     * hue and tone.
+     */
+    set hue(newHue: number);
+    get chroma(): number;
+    /**
+     * @param newChroma 0 <= newChroma < ?
+     * Chroma may decrease because chroma has a different maximum for any given
+     * hue and tone.
+     */
+    set chroma(newChroma: number);
+    /** Lightness. Ranges from 0 to 100. */
+    get tone(): number;
+    /**
+     * @param newTone 0 <= newTone <= 100; invalid valids are corrected.
+     * Chroma may decrease because chroma has a different maximum for any given
+     * hue and tone.
+     */
+    set tone(newTone: number);
+    /** Sets a property of the Hct object. */
+    setValue(propertyName: string, value: number): void;
+    toString(): string;
+    static isBlue(hue: number): boolean;
+    static isYellow(hue: number): boolean;
+    static isCyan(hue: number): boolean;
+    private constructor();
+    private setInternalState;
+    /**
+     * Translates a color into different [ViewingConditions].
+     *
+     * Colors change appearance. They look different with lights on versus off,
+     * the same color, as in hex code, on white looks different when on black.
+     * This is called color relativity, most famously explicated by Josef Albers
+     * in Interaction of Color.
+     *
+     * In color science, color appearance models can account for this and
+     * calculate the appearance of a color in different settings. HCT is based on
+     * CAM16, a color appearance model, and uses it to make these calculations.
+     *
+     * See [ViewingConditions.make] for parameters affecting color appearance.
+     */
+    inViewingConditions(vc: ViewingConditions): Hct;
+}
+//# sourceMappingURL=hct.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"hct.d.ts","sourceRoot":"","sources":["../../../../../../src/vendor/mcu/hct/hct.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAyBH,OAAO,EAAC,iBAAiB,EAAC,MAAM,yBAAsB,CAAC;AAGvD;;;;GAIG;AACH,qBAAa,GAAG;IAkHM,OAAO,CAAC,IAAI;IAjHhC;;;;;;;OAOG;IAEH,WAAW,EAAE,MAAM,CAAC;IACpB,cAAc,EAAE,MAAM,CAAC;IACvB,YAAY,EAAE,MAAM,CAAC;IAErB,MAAM,CAAC,IAAI,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM;IAIrD;;;OAGG;IACH,MAAM,CAAC,OAAO,CAAC,IAAI,EAAE,MAAM;IAI3B,KAAK,IAAI,MAAM;IAIf;;;OAGG;IACH,IAAI,GAAG,IAAI,MAAM,CAEhB;IAED;;;;OAIG;IACH,IAAI,GAAG,CAAC,MAAM,EAAE,MAAM,EAQrB;IAED,IAAI,MAAM,IAAI,MAAM,CAEnB;IAED;;;;OAIG;IACH,IAAI,MAAM,CAAC,SAAS,EAAE,MAAM,EAQ3B;IAED,uCAAuC;IACvC,IAAI,IAAI,IAAI,MAAM,CAEjB;IAED;;;;OAIG;IACH,IAAI,IAAI,CAAC,OAAO,EAAE,MAAM,EAQvB;IAED,yCAAyC;IACzC,QAAQ,CAAC,YAAY,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM;IAI5C,QAAQ,IAAI,MAAM;IAKlB,MAAM,CAAC,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO;IAInC,MAAM,CAAC,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO;IAIrC,MAAM,CAAC,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO;IAInC,OAAO;IAQP,OAAO,CAAC,gBAAgB;IAQxB;;;;;;;;;;;;;OAaG;IACH,mBAAmB,CAAC,EAAE,EAAE,iBAAiB,GAAG,GAAG;CAuBhD"}

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

@@ -0,0 +1,147 @@
+/**
+ * @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 { Cam16 } from './cam16.js';
+/**
+ * A class that solves the HCT equation.
+ */
+export declare class HctSolver {
+    static SCALED_DISCOUNT_FROM_LINRGB: number[][];
+    static LINRGB_FROM_SCALED_DISCOUNT: number[][];
+    static Y_FROM_LINRGB: number[];
+    static CRITICAL_PLANES: number[];
+    /**
+     * Sanitizes a small enough angle in radians.
+     *
+     * @param angle An angle in radians; must not deviate too much
+     * from 0.
+     * @return A coterminal angle between 0 and 2pi.
+     */
+    private static sanitizeRadians;
+    /**
+     * Delinearizes an RGB component, returning a floating-point
+     * number.
+     *
+     * @param rgbComponent 0.0 <= rgb_component <= 100.0, represents
+     * linear R/G/B channel
+     * @return 0.0 <= output <= 255.0, color channel converted to
+     * regular RGB space
+     */
+    private static trueDelinearized;
+    private static chromaticAdaptation;
+    /**
+     * Returns the hue of a linear RGB color in CAM16.
+     *
+     * @param linrgb The linear RGB coordinates of a color.
+     * @return The hue of the color in CAM16, in radians.
+     */
+    private static hueOf;
+    private static areInCyclicOrder;
+    /**
+     * Solves the lerp equation.
+     *
+     * @param source The starting number.
+     * @param mid The number in the middle.
+     * @param target The ending number.
+     * @return A number t such that lerp(source, target, t) = mid.
+     */
+    private static intercept;
+    private static lerpPoint;
+    /**
+     * Intersects a segment with a plane.
+     *
+     * @param source The coordinates of point A.
+     * @param coordinate The R-, G-, or B-coordinate of the plane.
+     * @param target The coordinates of point B.
+     * @param axis The axis the plane is perpendicular with. (0: R, 1:
+     * G, 2: B)
+     * @return The intersection point of the segment AB with the plane
+     * R=coordinate, G=coordinate, or B=coordinate
+     */
+    private static setCoordinate;
+    private static isBounded;
+    /**
+     * Returns the nth possible vertex of the polygonal intersection.
+     *
+     * @param y The Y value of the plane.
+     * @param n The zero-based index of the point. 0 <= n <= 11.
+     * @return The nth possible vertex of the polygonal intersection
+     * of the y plane and the RGB cube, in linear RGB coordinates, if
+     * it exists. If this possible vertex lies outside of the cube,
+     * [-1.0, -1.0, -1.0] is returned.
+     */
+    private static nthVertex;
+    /**
+     * Finds the segment containing the desired color.
+     *
+     * @param y The Y value of the color.
+     * @param targetHue The hue of the color.
+     * @return A list of two sets of linear RGB coordinates, each
+     * corresponding to an endpoint of the segment containing the
+     * desired color.
+     */
+    private static bisectToSegment;
+    private static midpoint;
+    private static criticalPlaneBelow;
+    private static criticalPlaneAbove;
+    /**
+     * Finds a color with the given Y and hue on the boundary of the
+     * cube.
+     *
+     * @param y The Y value of the color.
+     * @param targetHue The hue of the color.
+     * @return The desired color, in linear RGB coordinates.
+     */
+    private static bisectToLimit;
+    private static inverseChromaticAdaptation;
+    /**
+     * Finds a color with the given hue, chroma, and Y.
+     *
+     * @param hueRadians The desired hue in radians.
+     * @param chroma The desired chroma.
+     * @param y The desired Y.
+     * @return The desired color as a hexadecimal integer, if found; 0
+     * otherwise.
+     */
+    private static findResultByJ;
+    /**
+     * Finds an sRGB color with the given hue, chroma, and L*, if
+     * possible.
+     *
+     * @param hueDegrees The desired hue, in degrees.
+     * @param chroma The desired chroma.
+     * @param lstar The desired L*.
+     * @return A hexadecimal representing the sRGB color. The color
+     * has sufficiently close hue, chroma, and L* to the desired
+     * values, if possible; otherwise, the hue and L* will be
+     * sufficiently close, and chroma will be maximized.
+     */
+    static solveToInt(hueDegrees: number, chroma: number, lstar: number): number;
+    /**
+     * Finds an sRGB color with the given hue, chroma, and L*, if
+     * possible.
+     *
+     * @param hueDegrees The desired hue, in degrees.
+     * @param chroma The desired chroma.
+     * @param lstar The desired L*.
+     * @return An CAM16 object representing the sRGB color. The color
+     * has sufficiently close hue, chroma, and L* to the desired
+     * values, if possible; otherwise, the hue and L* will be
+     * sufficiently close, and chroma will be maximized.
+     */
+    static solveToCam(hueDegrees: number, chroma: number, lstar: number): Cam16;
+}
+//# sourceMappingURL=hct_solver.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"hct_solver.d.ts","sourceRoot":"","sources":["../../../../../../src/vendor/mcu/hct/hct_solver.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAUH,OAAO,EAAC,KAAK,EAAC,MAAM,YAAS,CAAC;AAS9B;;GAEG;AACH,qBAAa,SAAS;IACpB,MAAM,CAAC,2BAA2B,aAgBhC;IAEF,MAAM,CAAC,2BAA2B,aAgBhC;IAEF,MAAM,CAAC,aAAa,WAA4B;IAEhD,MAAM,CAAC,eAAe,WAsFpB;IAEF;;;;;;OAMG;IACH,OAAO,CAAC,MAAM,CAAC,eAAe;IAI9B;;;;;;;;OAQG;IACH,OAAO,CAAC,MAAM,CAAC,gBAAgB;IAW/B,OAAO,CAAC,MAAM,CAAC,mBAAmB;IAKlC;;;;;OAKG;IACH,OAAO,CAAC,MAAM,CAAC,KAAK;IAapB,OAAO,CAAC,MAAM,CAAC,gBAAgB;IAM/B;;;;;;;OAOG;IACH,OAAO,CAAC,MAAM,CAAC,SAAS;IAKxB,OAAO,CAAC,MAAM,CAAC,SAAS;IASxB;;;;;;;;;;OAUG;IACH,OAAO,CAAC,MAAM,CAAC,aAAa;IAU5B,OAAO,CAAC,MAAM,CAAC,SAAS;IAIxB;;;;;;;;;OASG;IACH,OAAO,CAAC,MAAM,CAAC,SAAS;IAoCxB;;;;;;;;OAQG;IACH,OAAO,CAAC,MAAM,CAAC,eAAe;IAmC9B,OAAO,CAAC,MAAM,CAAC,QAAQ;IAQvB,OAAO,CAAC,MAAM,CAAC,kBAAkB;IAIjC,OAAO,CAAC,MAAM,CAAC,kBAAkB;IAIjC;;;;;;;OAOG;IACH,OAAO,CAAC,MAAM,CAAC,aAAa;IA4C5B,OAAO,CAAC,MAAM,CAAC,0BAA0B;IAMzC;;;;;;;;OAQG;IACH,OAAO,CAAC,MAAM,CAAC,aAAa;IAqE5B;;;;;;;;;;;OAWG;IACH,MAAM,CAAC,UAAU,CAAC,UAAU,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM;IAe5E;;;;;;;;;;;OAWG;IACH,MAAM,CAAC,UAAU,CAAC,UAAU,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,KAAK;CAG5E"}