@996-design/996-fast-color 1.0.0

package/LICENSE

@@ -0,0 +1,20 @@
+The MIT License (MIT)
+Copyright (c) 2015-present Alipay.com, https://www.alipay.com/
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in
+all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS 
+OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF 
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. 
+IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY 
+CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, 
+TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE 
+SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

package/NOTICE.md

@@ -0,0 +1,22 @@
+# Upstream attribution
+
+The runtime and declaration artifacts in `es/` and `lib/` are derived from
+`@ant-design/fast-color` 3.0.1.
+
+- Upstream: https://github.com/ant-design/fast-color/tree/3.0.1
+- License: MIT. See `LICENSE`.
+
+Local changes are limited to the package identity, workspace scripts, package
+metadata, and namespace references. The color implementation is otherwise kept
+aligned with the published 3.0.1 package.
+
+## Mechanical parity source
+
+- npm tarball: https://registry.npmjs.org/@ant-design/fast-color/-/fast-color-3.0.1.tgz
+- Integrity: `sha512-esKJegpW4nckh0o6kV3Tkb7NPIZYbPnnFxmQDUmL08ukXZAvV85TZBr70eGuke/CIArLaP6aw8lt9KILjnWuOw==`
+- Guard inventory: 16 runtime files; sorted-path SHA-256
+  `0a75335e068de66ea5e581157abc98467137e335674c1f122986d358e32a6376`.
+
+The parity inventory excludes package metadata, local build products,
+`node_modules`, and caches. Every inventoried file is compared after only the
+declared package-namespace rewrite.

package/README.md

@@ -0,0 +1,21 @@
+# 996 Design Fast Color
+
+Small immutable color class for parsing, conversion, channel operations, mixing and contrast calculations.
+
+## Install
+
+```sh
+pnpm add @996-design/996-fast-color
+```
+
+## Use
+
+```ts
+import { FastColor } from "@996-design/996-fast-color";
+
+const accent = new FastColor("#5b8cff").setA(0.88).toRgbString();
+```
+
+## License
+
+MIT. See `LICENSE` and `NOTICE.md` for license and source attribution.

package/es/FastColor.d.ts

@@ -0,0 +1,100 @@
+import type { ColorInput, HSL, HSV, RGB } from './types';
+export declare class FastColor {
+    /**
+     * All FastColor objects are valid. So isValid is always true. This property is kept to be compatible with TinyColor.
+     */
+    isValid: boolean;
+    /**
+     * Red, R in RGB
+     */
+    r: number;
+    /**
+     * Green, G in RGB
+     */
+    g: number;
+    /**
+     * Blue, B in RGB
+     */
+    b: number;
+    /**
+     * Alpha/Opacity, A in RGBA/HSLA
+     */
+    a: number;
+    private _h?;
+    private _hsl_s?;
+    private _hsv_s?;
+    private _l?;
+    private _v?;
+    private _max?;
+    private _min?;
+    private _brightness?;
+    constructor(input: ColorInput);
+    setR(value: number): this;
+    setG(value: number): this;
+    setB(value: number): this;
+    setA(value: number): this;
+    setHue(value: number): this;
+    /**
+     * Returns the perceived luminance of a color, from 0-1.
+     * @see http://www.w3.org/TR/2008/REC-WCAG20-20081211/#relativeluminancedef
+     */
+    getLuminance(): number;
+    getHue(): number;
+    /**
+     * @deprecated should use getHSVSaturation or getHSLSaturation instead
+     */
+    getSaturation(): number;
+    getHSVSaturation(): number;
+    getHSLSaturation(): number;
+    getLightness(): number;
+    getValue(): number;
+    /**
+     * Returns the perceived brightness of the color, from 0-255.
+     * Note: this is not the b of HSB
+     * @see http://www.w3.org/TR/AERT#color-contrast
+     */
+    getBrightness(): number;
+    darken(amount?: number): this;
+    lighten(amount?: number): this;
+    /**
+     * Mix the current color a given amount with another color, from 0 to 100.
+     * 0 means no mixing (return current color).
+     */
+    mix(input: ColorInput, amount?: number): this;
+    /**
+     * Mix the color with pure white, from 0 to 100.
+     * Providing 0 will do nothing, providing 100 will always return white.
+     */
+    tint(amount?: number): this;
+    /**
+     * Mix the color with pure black, from 0 to 100.
+     * Providing 0 will do nothing, providing 100 will always return black.
+     */
+    shade(amount?: number): this;
+    onBackground(background: ColorInput): this;
+    isDark(): boolean;
+    isLight(): boolean;
+    equals(other: FastColor): boolean;
+    clone(): this;
+    toHexString(): string;
+    /** CSS support color pattern */
+    toHsl(): HSL;
+    /** CSS support color pattern */
+    toHslString(): string;
+    /** Same as toHsb */
+    toHsv(): HSV;
+    toRgb(): RGB;
+    toRgbString(): string;
+    toString(): string;
+    /** Return a new FastColor object with one channel changed */
+    private _sc;
+    private _c;
+    private getMax;
+    private getMin;
+    private fromHexString;
+    private fromHsl;
+    private fromHsv;
+    private fromHsvString;
+    private fromHslString;
+    private fromRgbString;
+}