@pg-labs-incubator/cobweb 0.0.0-stage → 0.0.1

package/target/tsc/color/hct.d.ts

@@ -0,0 +1,114 @@
+/**
+ * Color in the HCT color space.
+ *
+ * HCT describes a color by the hue and chroma of the CAM16 color appearance model, under the
+ * viewing conditions of {@link hctOfArgb}, and by its tone, the CIE L* lightness. The hue, chroma,
+ * and tone are always derived from {@link Hct.argb | `argb`}: a color {@link solveHct | solved}
+ * from a requested hue, chroma, and tone has, in general, a different hue, chroma, and tone than
+ * requested.
+ */
+export interface Hct {
+    /**
+     * ARGB color, as an unsigned 32-bit integer.
+     */
+    readonly argb: number;
+    /**
+     * Hue, in degrees, in `[0, 360)`.
+     */
+    readonly hue: number;
+    /**
+     * Chroma, `0` or greater.
+     */
+    readonly chroma: number;
+    /**
+     * Tone, in `[0, 100]`.
+     */
+    readonly tone: number;
+}
+/**
+ * Clamp a number to a range.
+ *
+ * The lower bound is tested first: if `min` is greater than `max`, a number less than `min` is
+ * clamped to `min`, and any other number to `max`.
+ *
+ * @param min - lower bound
+ * @param max - upper bound
+ * @param val - number to clamp
+ * @returns `min` if `val` is less than `min`; otherwise, `max` if `val` is greater than `max`;
+ * otherwise, `val`
+ */
+export declare function clamp(min: number, max: number, val: number): number;
+/**
+ * Normalize an angle, in degrees, to `[0, 360]`.
+ *
+ * Note that a tiny negative angle is normalized to `360`, and that `-0` is retained as-is.
+ *
+ * @param deg - angle, in degrees
+ * @returns equivalent angle, in `[0, 360]`
+ */
+export declare function sanitizeDegrees(deg: number): number;
+/**
+ * Convert a tone to relative luminance.
+ *
+ * @param tone - CIE L* lightness
+ * @returns relative luminance, on a scale of `0` to `100`
+ */
+export declare function yOfLstar(tone: number): number;
+/**
+ * Convert relative luminance to a tone.
+ *
+ * @param y - relative luminance, on a scale of `0` to `100`
+ * @returns CIE L* lightness
+ */
+export declare function lstarOfY(y: number): number;
+/**
+ * Convert an ARGB color to CIE L*a*b*.
+ *
+ * Alpha of `argb` is ignored.
+ *
+ * @param argb - ARGB color
+ * @returns tuple of the L*, a*, and b* coordinates of `argb`, under a D65 white point
+ */
+export declare function labOfArgb(argb: number): [l: number, a: number, b: number];
+/**
+ * Convert an ARGB color to HCT.
+ *
+ * Hue and chroma are those of CAM16 under fixed viewing conditions: a D65 white point, an
+ * adapting luminance of `200 / pi` times the relative luminance of tone `50`, a background of tone
+ * `50`, and an average surround, without discounting the illuminant. Tone is the CIE L* lightness
+ * of the color. Alpha of `argb` is ignored.
+ *
+ * @param argb - ARGB color
+ * @returns HCT color of `argb`
+ */
+export declare function hctOfArgb(argb: number): Hct;
+/**
+ * Convert an HCT color to an ARGB color.
+ *
+ * This solves the color of tone `tone` whose hue is as close as possible to `hue`, and whose
+ * chroma is as close as possible to `chroma` without exceeding the chroma available in the sRGB
+ * gamut at that hue and tone. Colors of a chroma less than `0.0001`, and colors of a tone less
+ * than `0.0001` or greater than `99.9999`, are solved as grays.
+ *
+ * @param hue - hue, in degrees
+ * @param chroma - chroma
+ * @param tone - tone
+ * @returns opaque, unsigned ARGB color
+ */
+export declare function argbOfHct(hue: number, chroma: number, tone: number): number;
+/**
+ * Solve an HCT color.
+ *
+ * @param hue - hue, in degrees
+ * @param chroma - chroma
+ * @param tone - tone
+ * @returns HCT color of {@link argbOfHct | solved} color
+ */
+export declare function solveHct(hue: number, chroma: number, tone: number): Hct;
+/**
+ * Format an ARGB color as a CSS hexadecimal color.
+ *
+ * @param argb - ARGB color
+ * @returns `#rrggbb` color, in lowercase, without alpha
+ */
+export declare function hexOfArgb(argb: number): string;

package/target/tsc/color/index.css.d.ts

@@ -0,0 +1,3 @@
+// SPDX-License-Identifier: MPL-2.0
+
+export {};

package/target/tsc/color/index.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Material 3 color roles and source-color dynamic schemes.
+ *
+ * Role names follow the AndroidX Material 3 [`ColorScheme`][color-scheme], while dynamic schemes
+ * follow the Material 3 [dynamic color][dynamic-color] specifications of 2021 and 2025.
+ *
+ * Static role names and their light/dark CSS behavior are defined by `index.css`: the root
+ * follows the preferred color scheme, and the `cw-theme-light` and `cw-theme-dark` classes apply
+ * either scheme to a subtree. The TypeScript API in this module generates immutable schemes of
+ * every dynamic color style from CSS hex or ARGB source colors, and applies them to elements.
+ *
+ * Schemes are generated in the HCT color space, whose hue and chroma are those of the CAM16 color
+ * appearance model and whose tone is the CIE L* lightness. The source color determines a tonal
+ * palette of each role group, and each role takes the color of its palette at a tone which
+ * reaches the contrast of the role against its background, at the requested contrast level.
+ *
+ * [color-scheme]: https://android.googlesource.com/platform/frameworks/support/+/HEAD/compose/material3/material3/src/commonMain/kotlin/androidx/compose/material3/ColorScheme.kt
+ * [dynamic-color]: https://m3.material.io/styles/color/dynamic
+ *
+ * @packageDocumentation
+ */
+export type { ColorScheme, ColorSchemeArgb, ColorSchemeCleanup, ColorSchemeCssRole, ColorSchemeMode, ColorSchemeOptions, ColorSchemeRole, ColorSchemeRoleMapping, ColorSchemeSpecVersion, ColorSchemeTarget, ColorSchemeValues, ColorSchemeVariant, ColorSchemeVariables, ColorSource, ColorValue } from "./scheme";
+export { COLOR_SCHEME_CSS_ROLES, COLOR_SCHEME_ROLE_MAPPINGS, applyColorScheme, createColorScheme, removeColorScheme } from "./scheme";

package/target/tsc/color/palette.d.ts

@@ -0,0 +1,30 @@
+import type { Hct } from "./hct";
+/**
+ * Test whether a hue is a yellow hue.
+ *
+ * @param hue - hue, in degrees
+ * @returns `true` if, and only if, `hue` is in `[105, 125)`
+ */
+export declare function isYellowHue(hue: number): boolean;
+/**
+ * Retrieve color of a tonal palette at a tone.
+ *
+ * A tonal palette holds the colors of a hue and chroma at every tone. This {@link argbOfHct |
+ * solves} the color of hue `hue` and chroma `chroma` at tone `tone`, except for tone `99` of a
+ * {@link isYellowHue | yellow} hue, whose color is the average of the colors at tones `98` and
+ * `100`, channel by channel.
+ *
+ * @param hue - hue of palette, in degrees
+ * @param chroma - chroma of palette
+ * @param tone - tone of color
+ * @returns opaque, unsigned ARGB color
+ */
+export declare function argbOfPalette(hue: number, chroma: number, tone: number): number;
+/**
+ * Lighten a color if it is disliked.
+ *
+ * @param color - color to fix
+ * @returns `color` lightened to tone `70` if it is {@link isDisliked | disliked}; otherwise,
+ * `color` as-is
+ */
+export declare function fixDislikedColor(color: Hct): Hct;

package/target/tsc/color/scheme.d.ts

@@ -0,0 +1,446 @@
+/**
+ * A CSS hexadecimal color or an ARGB 32-bit color integer.
+ */
+export type ColorSource = string | number;
+/**
+ * Color-scheme appearance mode.
+ */
+export type ColorSchemeMode = "light" | "dark";
+/**
+ * Material dynamic color specification revision.
+ *
+ * | Revision | Description                                                              |
+ * | -------- | ------------------------------------------------------------------------ |
+ * | `"2021"` | Dynamic color specification of 2021, available for every variant.       |
+ * | `"2025"` | Dynamic color specification of 2025.                                     |
+ *
+ * The `"2025"` revision is available for the `tonalSpot`, `neutral`, `vibrant`, and `expressive`
+ * {@link ColorSchemeVariant | variants}; other variants fall back to `"2021"`.
+ */
+export type ColorSchemeSpecVersion = "2021" | "2025";
+/**
+ * Dynamic color style.
+ *
+ * | Variant        | Scheme                                                                  |
+ * | -------------- | ----------------------------------------------------------------------- |
+ * | `"tonalSpot"`  | Low to medium colorfulness, with a tertiary hue related to the source.  |
+ * | `"neutral"`    | Near grayscale.                                                         |
+ * | `"vibrant"`    | Maximum colorfulness of the primary palette at each tone.              |
+ * | `"expressive"` | Intentionally detached from the source color.                           |
+ * | `"fidelity"`   | Source color as primary container, adjusted for color relativity.       |
+ * | `"content"`    | Source color as primary container, adjusted for color relativity.       |
+ * | `"monochrome"` | Grayscale.                                                              |
+ * | `"rainbow"`    | Playful; the hue of the source color does not appear.                   |
+ * | `"fruitSalad"` | Playful; the hue of the source color does not appear.                   |
+ */
+export type ColorSchemeVariant = "tonalSpot" | "expressive" | "vibrant" | "fidelity" | "content" | "monochrome" | "neutral" | "rainbow" | "fruitSalad";
+/**
+ * Options used to construct a dynamic Material 3 color scheme.
+ */
+export interface ColorSchemeOptions {
+    /**
+     * Appearance mode.
+     *
+     * When {@link ColorSchemeOptions.isDark} is also supplied, both values must select the same
+     * mode; conflicting values cause {@link createColorScheme} to throw a `RangeError`.
+     *
+     * @defaultValue `"light"` when neither appearance option is supplied
+     */
+    readonly mode?: ColorSchemeMode;
+    /**
+     * Boolean appearance convenience. `true` selects dark mode.
+     *
+     * When {@link ColorSchemeOptions.mode} is also supplied, both values must agree.
+     *
+     * @defaultValue `false` when neither appearance option is supplied
+     */
+    readonly isDark?: boolean;
+    /**
+     * Contrast adjustment in the inclusive range `[-1, 1]`. Must be finite.
+     *
+     * `0` is the standard contrast of the design, `-1` the minimum, and `1` the maximum contrast.
+     * Medium and high contrast schemes, for example for users preferring more contrast
+     * (`prefers-contrast: more`), are generated with a higher level, such as `0.5` and `1`,
+     * respectively.
+     *
+     * @defaultValue `0`
+     */
+    readonly contrastLevel?: number;
+    /**
+     * Dynamic color style.
+     *
+     * @defaultValue `"tonalSpot"`
+     */
+    readonly variant?: ColorSchemeVariant;
+    /**
+     * Requested specification revision.
+     *
+     * Variants which do not support the requested revision use the `"2021"` revision instead,
+     * exposed by {@link ColorScheme.specVersion}.
+     *
+     * @defaultValue `"2025"`
+     */
+    readonly specVersion?: ColorSchemeSpecVersion;
+}
+/**
+ * A CSS color value emitted by a color scheme.
+ */
+export type ColorValue = string;
+/**
+ * Canonical Material 3 color role names.
+ */
+export type ColorSchemeRole = "primary" | "onPrimary" | "primaryContainer" | "onPrimaryContainer" | "inversePrimary" | "secondary" | "onSecondary" | "secondaryContainer" | "onSecondaryContainer" | "tertiary" | "onTertiary" | "tertiaryContainer" | "onTertiaryContainer" | "background" | "onBackground" | "surface" | "onSurface" | "surfaceVariant" | "onSurfaceVariant" | "surfaceTint" | "inverseSurface" | "inverseOnSurface" | "error" | "onError" | "errorContainer" | "onErrorContainer" | "outline" | "outlineVariant" | "scrim" | "surfaceBright" | "surfaceDim" | "surfaceContainer" | "surfaceContainerHigh" | "surfaceContainerHighest" | "surfaceContainerLow" | "surfaceContainerLowest" | "primaryFixed" | "primaryFixedDim" | "onPrimaryFixed" | "onPrimaryFixedVariant" | "secondaryFixed" | "secondaryFixedDim" | "onSecondaryFixed" | "onSecondaryFixedVariant" | "tertiaryFixed" | "tertiaryFixedDim" | "onTertiaryFixed" | "onTertiaryFixedVariant" | "shadow";
+/**
+ * ARGB values for all Material 3 roles and Cobweb's retained `shadow` role.
+ */
+export type ColorSchemeArgb = Readonly<Record<ColorSchemeRole, number>>;
+/**
+ * Cobweb role suffixes used after `--cw-Color-`.
+ *
+ * Grouped names deliberately retain the existing Cobweb vocabulary (`fill`, `onFill`, and
+ * `inverseFill`) while the ungrouped `background`, `scrim`, and outline roles mirror Material 3.
+ */
+export type ColorSchemeCssRole = "primary-fill" | "primary-onFill" | "primary-container" | "primary-onContainer" | "primary-inverseFill" | "primary-fixedFill" | "primary-fixedFillDim" | "primary-onFixedFill" | "primary-onFixedFillVariant" | "secondary-fill" | "secondary-onFill" | "secondary-container" | "secondary-onContainer" | "secondary-fixedFill" | "secondary-fixedFillDim" | "secondary-onFixedFill" | "secondary-onFixedFillVariant" | "tertiary-fill" | "tertiary-onFill" | "tertiary-container" | "tertiary-onContainer" | "tertiary-fixedFill" | "tertiary-fixedFillDim" | "tertiary-onFixedFill" | "tertiary-onFixedFillVariant" | "error-fill" | "error-onFill" | "error-container" | "error-onContainer" | "background" | "onBackground" | "surface-fill" | "surface-onFill" | "surface-fillVariant" | "surface-onFillVariant" | "surface-tint" | "surface-inverseFill" | "surface-inverseOnFill" | "surface-fillBright" | "surface-fillDim" | "surface-container" | "surface-containerHigh" | "surface-containerHighest" | "surface-containerLow" | "surface-containerLowest" | "outline" | "outlineVariant" | "scrim" | "shadow";
+/**
+ * CSS custom properties keyed by their complete Cobweb property name.
+ */
+export type ColorSchemeVariables = Readonly<Record<`--cw-Color-${ColorSchemeCssRole}`, ColorValue>>;
+/**
+ * Values keyed by Cobweb role suffix, without the `--cw-Color-` prefix.
+ */
+export type ColorSchemeValues = Readonly<Record<ColorSchemeCssRole, ColorValue>>;
+/**
+ * An immutable Material 3 color scheme.
+ *
+ * Role properties use the canonical Material 3 names and contain CSS hexadecimal colors. The
+ * `values` and `variables` views expose the same colors using Cobweb's design-role names. The
+ * object and its nested views are frozen before being returned.
+ */
+export interface ColorScheme {
+    /**
+     * Specification revision the scheme was generated with, after the fallback of its variant.
+     */
+    readonly specVersion: ColorSchemeSpecVersion;
+    /**
+     * Source color as an opaque CSS hexadecimal color.
+     *
+     * The original alpha channel is available through {@link ColorScheme.sourceColorArgb}.
+     */
+    readonly sourceColor: ColorValue;
+    /**
+     * Original source color as an unsigned 32-bit ARGB integer, including alpha.
+     */
+    readonly sourceColorArgb: number;
+    /**
+     * Resolved light or dark appearance mode.
+     */
+    readonly mode: ColorSchemeMode;
+    /**
+     * Whether {@link ColorScheme.mode} is `"dark"`.
+     */
+    readonly isDark: boolean;
+    /**
+     * Resolved contrast adjustment in the inclusive range `[-1, 1]`.
+     */
+    readonly contrastLevel: number;
+    /**
+     * Dynamic color style the scheme was generated with.
+     */
+    readonly variant: ColorSchemeVariant;
+    /**
+     * Primary accent color for prominent controls and active elements.
+     */
+    readonly primary: ColorValue;
+    /**
+     * Foreground color paired with {@link ColorScheme.primary}.
+     */
+    readonly onPrimary: ColorValue;
+    /**
+     * Container color for primary-accent content.
+     */
+    readonly primaryContainer: ColorValue;
+    /**
+     * Foreground color paired with {@link ColorScheme.primaryContainer}.
+     */
+    readonly onPrimaryContainer: ColorValue;
+    /**
+     * Primary accent color for an inverse surface.
+     */
+    readonly inversePrimary: ColorValue;
+    /**
+     * Secondary accent color for less prominent controls.
+     */
+    readonly secondary: ColorValue;
+    /**
+     * Foreground color paired with {@link ColorScheme.secondary}.
+     */
+    readonly onSecondary: ColorValue;
+    /**
+     * Container color for secondary-accent content.
+     */
+    readonly secondaryContainer: ColorValue;
+    /**
+     * Foreground color paired with {@link ColorScheme.secondaryContainer}.
+     */
+    readonly onSecondaryContainer: ColorValue;
+    /**
+     * Tertiary accent color for contrasting accents.
+     */
+    readonly tertiary: ColorValue;
+    /**
+     * Foreground color paired with {@link ColorScheme.tertiary}.
+     */
+    readonly onTertiary: ColorValue;
+    /**
+     * Container color for tertiary-accent content.
+     */
+    readonly tertiaryContainer: ColorValue;
+    /**
+     * Foreground color paired with {@link ColorScheme.tertiaryContainer}.
+     */
+    readonly onTertiaryContainer: ColorValue;
+    /**
+     * Background color for the application canvas.
+     */
+    readonly background: ColorValue;
+    /**
+     * Foreground color paired with {@link ColorScheme.background}.
+     */
+    readonly onBackground: ColorValue;
+    /**
+     * Default surface color for components and containers.
+     */
+    readonly surface: ColorValue;
+    /**
+     * Foreground color paired with {@link ColorScheme.surface}.
+     */
+    readonly onSurface: ColorValue;
+    /**
+     * Alternate surface color retained for compatible component designs.
+     */
+    readonly surfaceVariant: ColorValue;
+    /**
+     * Lower-emphasis foreground color for surface content.
+     */
+    readonly onSurfaceVariant: ColorValue;
+    /**
+     * Tint used to express elevated surface treatments.
+     */
+    readonly surfaceTint: ColorValue;
+    /**
+     * Surface color contrasting with the current appearance mode.
+     */
+    readonly inverseSurface: ColorValue;
+    /**
+     * Foreground color paired with {@link ColorScheme.inverseSurface}.
+     */
+    readonly inverseOnSurface: ColorValue;
+    /**
+     * Color indicating an error or destructive state.
+     */
+    readonly error: ColorValue;
+    /**
+     * Foreground color paired with {@link ColorScheme.error}.
+     */
+    readonly onError: ColorValue;
+    /**
+     * Container color for error content.
+     */
+    readonly errorContainer: ColorValue;
+    /**
+     * Foreground color paired with {@link ColorScheme.errorContainer}.
+     */
+    readonly onErrorContainer: ColorValue;
+    /**
+     * Outline color for boundaries requiring emphasis.
+     */
+    readonly outline: ColorValue;
+    /**
+     * Lower-emphasis outline color for decorative boundaries.
+     */
+    readonly outlineVariant: ColorValue;
+    /**
+     * Color for a scrim obscuring content behind an overlay.
+     */
+    readonly scrim: ColorValue;
+    /**
+     * Brightest general surface color in the current mode.
+     */
+    readonly surfaceBright: ColorValue;
+    /**
+     * Dimmest general surface color in the current mode.
+     */
+    readonly surfaceDim: ColorValue;
+    /**
+     * Default surface-container color.
+     */
+    readonly surfaceContainer: ColorValue;
+    /**
+     * Higher-emphasis surface-container color.
+     */
+    readonly surfaceContainerHigh: ColorValue;
+    /**
+     * Highest-emphasis surface-container color.
+     */
+    readonly surfaceContainerHighest: ColorValue;
+    /**
+     * Lower-emphasis surface-container color.
+     */
+    readonly surfaceContainerLow: ColorValue;
+    /**
+     * Lowest-emphasis surface-container color.
+     */
+    readonly surfaceContainerLowest: ColorValue;
+    /**
+     * Primary fixed-accent color for content using a fixed color pairing.
+     */
+    readonly primaryFixed: ColorValue;
+    /**
+     * Dimmer fixed-accent color paired with {@link ColorScheme.primaryFixed}.
+     */
+    readonly primaryFixedDim: ColorValue;
+    /**
+     * Foreground color for the primary fixed-accent pair.
+     */
+    readonly onPrimaryFixed: ColorValue;
+    /**
+     * Lower-emphasis foreground color for the primary fixed-accent pair.
+     */
+    readonly onPrimaryFixedVariant: ColorValue;
+    /**
+     * Secondary fixed-accent color for content using a fixed color pairing.
+     */
+    readonly secondaryFixed: ColorValue;
+    /**
+     * Dimmer fixed-accent color paired with {@link ColorScheme.secondaryFixed}.
+     */
+    readonly secondaryFixedDim: ColorValue;
+    /**
+     * Foreground color for the secondary fixed-accent pair.
+     */
+    readonly onSecondaryFixed: ColorValue;
+    /**
+     * Lower-emphasis foreground color for the secondary fixed-accent pair.
+     */
+    readonly onSecondaryFixedVariant: ColorValue;
+    /**
+     * Tertiary fixed-accent color for content using a fixed color pairing.
+     */
+    readonly tertiaryFixed: ColorValue;
+    /**
+     * Dimmer fixed-accent color paired with {@link ColorScheme.tertiaryFixed}.
+     */
+    readonly tertiaryFixedDim: ColorValue;
+    /**
+     * Foreground color for the tertiary fixed-accent pair.
+     */
+    readonly onTertiaryFixed: ColorValue;
+    /**
+     * Lower-emphasis foreground color for the tertiary fixed-accent pair.
+     */
+    readonly onTertiaryFixedVariant: ColorValue;
+    /**
+     * Shadow color retained as a Cobweb design role.
+     */
+    readonly shadow: ColorValue;
+    /**
+     * Frozen map of canonical role names to unsigned 32-bit ARGB colors.
+     */
+    readonly argb: ColorSchemeArgb;
+    /**
+     * Frozen map of Cobweb role suffixes to CSS hexadecimal colors.
+     *
+     * Keys omit the `--cw-Color-` prefix; see {@link ColorSchemeCssRole}.
+     */
+    readonly values: ColorSchemeValues;
+    /**
+     * Frozen map of complete `--cw-Color-*` property names to CSS hexadecimal colors.
+     *
+     * This view contains color properties; {@link ColorScheme.cssText} also sets `color-scheme`.
+     */
+    readonly variables: ColorSchemeVariables;
+    /**
+     * Serialized declarations of {@link ColorScheme.variables} and `color-scheme`.
+     *
+     * This may be emitted in a style rule, for example to generate a fixed scheme at build time.
+     */
+    readonly cssText: string;
+}
+/**
+ * A target with an inline CSS declaration block.
+ */
+export type ColorSchemeTarget = Element & ElementCSSInlineStyle;
+/**
+ * Reversible cleanup returned by {@link applyColorScheme}.
+ */
+export type ColorSchemeCleanup = () => void;
+/**
+ * Canonical role to Cobweb CSS suffix mapping.
+ */
+export interface ColorSchemeRoleMapping {
+    /**
+     * Canonical Material color role used to read a generated scheme.
+     */
+    readonly role: ColorSchemeRole;
+    /**
+     * Corresponding Cobweb suffix used after `--cw-Color-`.
+     */
+    readonly cssRole: ColorSchemeCssRole;
+}
+/**
+ * Mapping from canonical Material 3 role names to Cobweb role suffixes, in serialization order.
+ */
+export declare const COLOR_SCHEME_ROLE_MAPPINGS: readonly ColorSchemeRoleMapping[];
+/**
+ * All supported Cobweb color role suffixes in deterministic serialization order.
+ */
+export declare const COLOR_SCHEME_CSS_ROLES: readonly ColorSchemeCssRole[];
+/**
+ * Construct a complete Material 3 color scheme from a source color.
+ *
+ * CSS strings use the CSS hexadecimal forms `#RGB`, `#RGBA`, `#RRGGBB`, and `#RRGGBBAA` (the
+ * latter follows CSS's `RRGGBBAA` order). Alpha is retained in `sourceColorArgb`, but HCT scheme
+ * generation uses the RGB channels and emits opaque role colors. Numeric sources are unsigned
+ * `0xAARRGGBB` values. No DOM or global browser state is accessed by this function.
+ *
+ * Generating a scheme solves the contrast of every role, which takes in the order of a tenth of a
+ * millisecond. Interfaces regenerating schemes from continuous input, such as a color picker,
+ * should memoize schemes per input and throttle regeneration, for example to one scheme per
+ * animation frame. Fixed schemes are best generated at build time, emitting {@link
+ * ColorScheme.cssText} in a style rule.
+ *
+ * @param sourceColor - CSS hex string or unsigned ARGB integer
+ * @param modeOrOptions - mode, boolean `isDark`, or options object
+ * @param contrastLevel - positional contrast level, overriding any value in the options object
+ * @param variant - positional variant, overriding any value in the options object
+ * @returns immutable scheme with canonical roles, Cobweb properties, and serialized CSS
+ * @throws {@link TypeError} `sourceColor` is malformed, or an option has an unsupported value
+ * @throws {@link RangeError} `sourceColor` is an out of range number, `mode` and `isDark` disagree,
+ * or the contrast level is out of range
+ */
+export declare function createColorScheme(sourceColor: ColorSource, modeOrOptions?: ColorSchemeMode | boolean | ColorSchemeOptions, contrastLevel?: number, variant?: ColorSchemeVariant): ColorScheme;
+/**
+ * Apply a generated color scheme to an element's inline custom properties.
+ *
+ * Only color-scheme declarations are changed. Unrelated inline styles remain reactive while a
+ * scheme is applied. Cleanup restores pre-existing values and priorities for declarations still
+ * owned by this application, preserving subsequent authored overrides. Reapplying replaces the
+ * current scheme, while retaining the declarations which preceded the first application; cleanup
+ * for an older application does not disturb a newer application.
+ *
+ * @param target - element receiving `--cw-Color-*` declarations
+ * @param scheme - scheme to apply
+ * @returns idempotent cleanup function
+ * @throws {@link TypeError} `target` has no inline style declarations or `scheme` is not a color
+ * scheme
+ */
+export declare function applyColorScheme(target: ColorSchemeTarget, scheme: ColorScheme): ColorSchemeCleanup;
+/**
+ * Remove the most recently applied generated color scheme from a target.
+ *
+ * Restores previous values and priorities only for declarations still owned by that application.
+ * Authored overrides remain intact. A target without an applied scheme is unchanged.
+ *
+ * @param target - element previously passed to {@link applyColorScheme}
+ */
+export declare function removeColorScheme(target: ColorSchemeTarget): void;

package/target/tsc/color/temperature.d.ts

@@ -0,0 +1,24 @@
+import type { Hct } from "./hct";
+/**
+ * Determine an analogous color of a color.
+ *
+ * Going around the hue wheel of `source`, starting at its hue, this sums the changes of
+ * relative temperature from color to color. The analogous color is the first color at which the
+ * sum reaches one sixth of the total change, excluding the change from the last color back to the
+ * first.
+ *
+ * @param source - color to determine analogous color of
+ * @returns analogous color, of the chroma and tone of `source`
+ */
+export declare function analogousColorOf(source: Hct): Hct;
+/**
+ * Determine the complementary color of a color.
+ *
+ * The complementary color is the color of the hue wheel of `source`, among the hues between the
+ * coldest and the warmest color on the side of the wheel opposite to `source`, whose relative
+ * temperature is nearest to `1` less the relative temperature of `source`.
+ *
+ * @param source - color to determine complementary color of
+ * @returns complementary color, of the chroma and tone of `source`
+ */
+export declare function complementaryColorOf(source: Hct): Hct;

package/target/tsc/container/card.css.d.ts

@@ -0,0 +1,3 @@
+// SPDX-License-Identifier: MPL-2.0
+
+export {};