@thi.ng/color-palettes 1.1.18 → 1.2.0

package/CHANGELOG.md

@@ -1,6 +1,6 @@
 # Change Log
 
-- **Last updated**: 2023-08-27T11:20:58Z
+- **Last updated**: 2023-09-25T07:43:28Z
 - **Generator**: [thi.ng/monopub](https://thi.ng/monopub)
 
 All notable changes to this project will be documented in this file.
@@ -9,6 +9,12 @@ See [Conventional Commits](https://conventionalcommits.org/) for commit guidelin
 **Note:** Unlisted _patch_ versions only involve non-code or otherwise excluded changes
 and/or version bumps of transitive dependencies.
 
+## [1.2.0](https://github.com/thi-ng/umbrella/tree/@thi.ng/color-palettes@1.2.0) (2023-09-25)
+
+#### 🚀 Features
+
+- add opt arg to get theme in reverse order ([4163fda](https://github.com/thi-ng/umbrella/commit/4163fda))
+
 ## [1.1.0](https://github.com/thi-ng/umbrella/tree/@thi.ng/color-palettes@1.1.0) (2023-04-25)
 
 #### 🚀 Features

package/README.md

@@ -271,7 +271,7 @@ For Node.js REPL:
 const colorPalettes = await import("@thi.ng/color-palettes");
 ```
 
-Package sizes (brotli'd, pre-treeshake): ESM: 4.75 KB
+Package sizes (brotli'd, pre-treeshake): ESM: 4.77 KB
 
 ## Dependencies
 
@@ -290,9 +290,10 @@ directory are using this package.
 
 A selection:
 
-| Screenshot                                                                                                           | Description                                          | Live demo                                           | Source                                                                           |
-|:---------------------------------------------------------------------------------------------------------------------|:-----------------------------------------------------|:----------------------------------------------------|:---------------------------------------------------------------------------------|
-| <img src="https://raw.githubusercontent.com/thi-ng/umbrella/develop/assets/examples/pixel-indexed.jpg" width="240"/> | Image dithering and remapping using indexed palettes | [Demo](https://demo.thi.ng/umbrella/pixel-indexed/) | [Source](https://github.com/thi-ng/umbrella/tree/develop/examples/pixel-indexed) |
+| Screenshot                                                                                                           | Description                                                       | Live demo                                           | Source                                                                           |
+|:---------------------------------------------------------------------------------------------------------------------|:------------------------------------------------------------------|:----------------------------------------------------|:---------------------------------------------------------------------------------|
+| <img src="https://raw.githubusercontent.com/thi-ng/umbrella/develop/assets/examples/geom-sdf-logo.jpg" width="240"/> | (Re)Constructing the thi.ng logo using a 2D signed-distance field | [Demo](https://demo.thi.ng/umbrella/geom-sdf-logo/) | [Source](https://github.com/thi-ng/umbrella/tree/develop/examples/geom-sdf-logo) |
+| <img src="https://raw.githubusercontent.com/thi-ng/umbrella/develop/assets/examples/pixel-indexed.jpg" width="240"/> | Image dithering and remapping using indexed palettes              | [Demo](https://demo.thi.ng/umbrella/pixel-indexed/) | [Source](https://github.com/thi-ng/umbrella/tree/develop/examples/pixel-indexed) |
 
 ### Usage
 
@@ -303,6 +304,10 @@ import { asCSS, asRGB } from "@thi.ng/color-palettes";
 asCSS(7);
 // ["#2f1864", "#e40302", "#f25c22", "#d987bd", "#44b6e7", "#e3dadd"]
 
+// get in reverse order
+asCSS(7, true);
+// ["#e3dadd", "#44b6e7", "#d987bd", "#f25c22", "#e40302", "#2f1864"]
+
 asInt(7).map(x => x.toString(16));
 // [ 'ff2f1864', 'ffe40302', 'fff25c22', 'ffd987bd', 'ff44b6e7', 'ffe3dadd']
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@thi.ng/color-palettes",
-  "version": "1.1.18",
+  "version": "1.2.0",
   "description": "Collection of 200+ image based color themes & composable theme query filters",
   "type": "module",
   "module": "./index.js",
@@ -39,7 +39,7 @@
     "@thi.ng/api": "^8.9.5",
     "@thi.ng/base-n": "^2.5.13",
     "@thi.ng/checks": "^3.4.5",
-    "@thi.ng/color": "^5.5.18",
+    "@thi.ng/color": "^5.5.19",
     "@thi.ng/errors": "^2.3.5",
     "@thi.ng/hex": "^2.3.17"
   },
@@ -90,5 +90,5 @@
     "parent": "@thi.ng/color",
     "year": 2021
   },
-  "gitHead": "b2ef5a1b8932d067af4ec2fc7da03d59d6868dc7\n"
+  "gitHead": "fb2697579b193b609ec52237ea0d99c7295b6d3c\n"
 }

package/theme.d.ts

@@ -1,43 +1,51 @@
-import type { CSSTheme, IntTheme, LCHTheme, RGBTheme, ThemePredicate } from "./api.js";
+import type { LCHTheme, RGBTheme, ThemePredicate } from "./api.js";
 /**
- * Returns theme for given ID as CSS hex colors.
+ * Returns theme for given ID as CSS hex colors. If `reverse` is true (default:
+ * false), the theme colors will be returned in reverse order.
  *
  * @param id
+ * @param reverse
  */
-export declare const asCSS: (id: number) => CSSTheme;
+export declare const asCSS: (id: number, reverse?: boolean) => string[];
 /**
  * Returns theme for given ID as packed ARGB integers (alpha channel will always
- * be set to 0xff).
+ * be set to 0xff). If `reverse` is true (default: false), the theme colors will
+ * be returned in reverse order.
  *
  * @param id
+ * @param reverse
  */
-export declare const asInt: (id: number) => IntTheme;
+export declare const asInt: (id: number, reverse?: boolean) => number[];
 /**
- * Returns theme for given ID as thi.ng/color LCH color vectors.
+ * Returns theme for given ID as thi.ng/color LCH color vectors. If `reverse` is
+ * true (default: false), the theme colors will be returned in reverse order.
  *
  * @param id
+ * @param reverse
  */
-export declare const asLCH: (id: number) => LCHTheme;
+export declare const asLCH: (id: number, reverse?: boolean) => LCHTheme;
 /**
- * Returns theme for given ID as thi.ng/color sRGB color vectors.
+ * Returns theme for given ID as thi.ng/color sRGB color vectors. If `reverse`
+ * is true (default: false), the theme colors will be returned in reverse order.
  *
  * @param id
+ * @param reverse
  */
-export declare const asRGB: (id: number) => RGBTheme;
+export declare const asRGB: (id: number, reverse?: boolean) => RGBTheme;
 /**
  * Yields iterator of CSS themes (via {@link asCSS}). Yields all
  * themes unless specific theme IDs or filter predicates are provided.
  *
  * @param preds
  */
-export declare const cssThemes: (...preds: ThemePredicate[] | number[]) => Generator<CSSTheme, void, unknown>;
+export declare const cssThemes: (...preds: ThemePredicate[] | number[]) => Generator<string[], void, unknown>;
 /**
  * Yields iterator of packed ARGB integer themes (via {@link asInt}). Yields all
  * themes unless specific theme IDs or filter predicates are provided.
  *
  * @param preds
  */
-export declare const intThemes: (...preds: ThemePredicate[] | number[]) => Generator<IntTheme, void, unknown>;
+export declare const intThemes: (...preds: ThemePredicate[] | number[]) => Generator<number[], void, unknown>;
 /**
  * Yields iterator of LCH themes (via {@link asLCH}). Yields all
  * themes unless specific theme IDs or filter predicates are provided.

package/theme.js

@@ -5,11 +5,13 @@ import { U24 } from "@thi.ng/hex";
 import { BINARY, NUM_THEMES } from "./binary.js";
 import { compFilter } from "./filter.js";
 /**
- * Returns theme for given ID as CSS hex colors.
+ * Returns theme for given ID as CSS hex colors. If `reverse` is true (default:
+ * false), the theme colors will be returned in reverse order.
  *
  * @param id
+ * @param reverse
  */
-export const asCSS = (id) => {
+export const asCSS = (id, reverse = false) => {
     __ensureID(id);
     const theme = [];
     // (<any>theme).__id = id;
@@ -18,15 +20,17 @@ export const asCSS = (id) => {
         theme.push("#" +
             U24((BINARY[id] << 16) | (BINARY[id + 1] << 8) | BINARY[id + 2]));
     }
-    return theme;
+    return reverse ? theme.reverse() : theme;
 };
 /**
  * Returns theme for given ID as packed ARGB integers (alpha channel will always
- * be set to 0xff).
+ * be set to 0xff). If `reverse` is true (default: false), the theme colors will
+ * be returned in reverse order.
  *
  * @param id
+ * @param reverse
  */
-export const asInt = (id) => {
+export const asInt = (id, reverse = false) => {
     __ensureID(id);
     const theme = [];
     id *= 18;
@@ -37,20 +41,24 @@ export const asInt = (id) => {
             BINARY[id + 2]) >>>
             0);
     }
-    return theme;
+    return reverse ? theme.reverse() : theme;
 };
 /**
- * Returns theme for given ID as thi.ng/color LCH color vectors.
+ * Returns theme for given ID as thi.ng/color LCH color vectors. If `reverse` is
+ * true (default: false), the theme colors will be returned in reverse order.
  *
  * @param id
+ * @param reverse
  */
-export const asLCH = (id) => asRGB(id).map((x) => lch(x));
+export const asLCH = (id, reverse = false) => asRGB(id, reverse).map((x) => lch(x));
 /**
- * Returns theme for given ID as thi.ng/color sRGB color vectors.
+ * Returns theme for given ID as thi.ng/color sRGB color vectors. If `reverse`
+ * is true (default: false), the theme colors will be returned in reverse order.
  *
  * @param id
+ * @param reverse
  */
-export const asRGB = (id) => {
+export const asRGB = (id, reverse = false) => {
     __ensureID(id);
     const theme = [];
     // (<any>theme).__id = id;
@@ -58,7 +66,7 @@ export const asRGB = (id) => {
     for (let i = 0; i < 6; i++, id += 3) {
         theme.push(srgb(BINARY[id] / 255, BINARY[id + 1] / 255, BINARY[id + 2] / 255, 1));
     }
-    return theme;
+    return reverse ? theme.reverse() : theme;
 };
 /**
  * Yields iterator of CSS themes (via {@link asCSS}). Yields all