@jbroll/jscad-modeling 2.12.7

package/package.json

@@ -0,0 +1,66 @@
+{
+  "name": "@jbroll/jscad-modeling",
+  "version": "2.12.7",
+  "description": "Constructive Solid Geometry (CSG) Library for JSCAD (performance-optimized fork)",
+  "homepage": "https://github.com/jbroll/OpenJSCAD.org",
+  "repository": "https://github.com/jbroll/OpenJSCAD.org",
+  "main": "src/index.js",
+  "types": "src/index.d.ts",
+  "unpkg": "dist/jscad-modeling.min.js",
+  "scripts": {
+    "bench": "node benchmarks/run.js",
+    "build": "browserify src/index.js -o dist/jscad-modeling.min.js -g uglifyify --standalone jscadModeling",
+    "coverage": "nyc --all --reporter=html --reporter=text npm test",
+    "test": "ava 'src/**/*.test.js' --verbose --timeout 2m",
+    "test:tsd": "tsd",
+    "version": "npm run build && git add dist"
+  },
+  "contributors": [
+    {
+      "name": "Alexandre Girard",
+      "url": "https://github.com/alx"
+    },
+    {
+      "name": "Evan Wallace",
+      "url": "http://evanw.github.com/csg.js/"
+    },
+    {
+      "name": "Joost Nieuwenhuijse",
+      "email": "joost@newhouse.nl"
+    },
+    {
+      "name": "Eduard Bespalov",
+      "url": "http://evanw.github.com/csg.js/"
+    },
+    {
+      "name": "bebbi",
+      "email": "elghatta@gmail.com"
+    },
+    {
+      "name": "Spiritdude Rene K Mueller",
+      "url": "http://renekmueller.com"
+    },
+    {
+      "name": "Jeff Gay",
+      "url": "http://www.z3d.jp"
+    }
+  ],
+  "keywords": [
+    "csg",
+    "parametric",
+    "modeling",
+    "openjscad",
+    "jscad"
+  ],
+  "license": "MIT",
+  "publishConfig": {
+    "access": "public"
+  },
+  "devDependencies": {
+    "ava": "3.15.0",
+    "browserify": "16.5.1",
+    "nyc": "15.1.0",
+    "uglifyify": "5.0.2"
+  },
+  "gitHead": "a90b9bad95a417661c619dc733e62c587dc71a4a"
+}

package/src/colors/colorNameToRgb.d.ts

@@ -0,0 +1,5 @@
+import { RGB } from './types'
+
+export default colorNameToRgb
+
+declare function colorNameToRgb(s: string): RGB

package/src/colors/colorNameToRgb.js

@@ -0,0 +1,14 @@
+const cssColors = require('./cssColors')
+
+/**
+ * Converts a CSS color name to RGB color.
+ *
+ * @param {String} s - the CSS color name
+ * @return {Array} the RGB color, or undefined if not found
+ * @alias module:modeling/colors.colorNameToRgb
+ * @example
+ * let mysphere = colorize(colorNameToRgb('lightblue'), sphere())
+ */
+const colorNameToRgb = (s) => cssColors[s.toLowerCase()]
+
+module.exports = colorNameToRgb

package/src/colors/colorNameToRgb.test.js

@@ -0,0 +1,14 @@
+const test = require('ava')
+
+const { colorNameToRgb } = require('./index')
+
+test('colorNameToRgb', (t) => {
+  let obs = colorNameToRgb('bad')
+
+  t.is(obs, undefined)
+
+  obs = colorNameToRgb('lightblue')
+  const exp = [0.6784313725490196, 0.8470588235294118, 0.9019607843137255]
+
+  t.deepEqual(obs, exp)
+})

package/src/colors/colorize.d.ts

@@ -0,0 +1,14 @@
+import { Colored, Geometry } from '../geometries/types'
+import RecursiveArray from '../utils/recursiveArray'
+
+import { RGB, RGBA } from './types'
+
+export default colorize
+
+// Single Geom3 returns Colored Geom3
+declare function colorize<T extends Geometry>(color: RGB | RGBA, object: T): T & Colored
+
+// List of Geom3 returns list of Colored Geom3
+declare function colorize<T extends Geometry>(color: RGB | RGBA, ...objects: RecursiveArray<T>): Array<T & Colored>
+// List of mixed geometries returns list of colored geometries
+declare function colorize(color: RGB | RGBA, ...objects: RecursiveArray<Geometry>): Array<Geometry & Colored>

package/src/colors/colorize.js

@@ -0,0 +1,65 @@
+const flatten = require('../utils/flatten')
+
+const geom2 = require('../geometries/geom2')
+const geom3 = require('../geometries/geom3')
+const path2 = require('../geometries/path2')
+const poly3 = require('../geometries/poly3')
+
+const colorGeom2 = (color, object) => {
+  const newgeom2 = geom2.clone(object)
+  newgeom2.color = color
+  return newgeom2
+}
+
+const colorGeom3 = (color, object) => {
+  const newgeom3 = geom3.clone(object)
+  newgeom3.color = color
+  return newgeom3
+}
+
+const colorPath2 = (color, object) => {
+  const newpath2 = path2.clone(object)
+  newpath2.color = color
+  return newpath2
+}
+
+const colorPoly3 = (color, object) => {
+  const newpoly = poly3.clone(object)
+  newpoly.color = color
+  return newpoly
+}
+
+/**
+ * Assign the given color to the given objects.
+ * @param {Array} color - RGBA color values, where each value is between 0 and 1.0
+ * @param {Object|Array} objects - the objects of which to apply the given color
+ * @return {Object|Array} new object, or list of new objects with an additional attribute 'color'
+ * @alias module:modeling/colors.colorize
+ *
+ * @example
+ * let redSphere = colorize([1,0,0], sphere()) // red
+ * let greenCircle = colorize([0,1,0,0.8], circle()) // green transparent
+ * let blueArc = colorize([0,0,1], arc()) // blue
+ * let wildcylinder = colorize(colorNameToRgb('fuchsia'), cylinder()) // CSS color
+ */
+const colorize = (color, ...objects) => {
+  if (!Array.isArray(color)) throw new Error('color must be an array')
+  if (color.length < 3) throw new Error('color must contain R, G and B values')
+  if (color.length === 3) color = [color[0], color[1], color[2], 1.0] // add alpha
+
+  objects = flatten(objects)
+  if (objects.length === 0) throw new Error('wrong number of arguments')
+
+  const results = objects.map((object) => {
+    if (geom2.isA(object)) return colorGeom2(color, object)
+    if (geom3.isA(object)) return colorGeom3(color, object)
+    if (path2.isA(object)) return colorPath2(color, object)
+    if (poly3.isA(object)) return colorPoly3(color, object)
+
+    object.color = color
+    return object
+  })
+  return results.length === 1 ? results[0] : results
+}
+
+module.exports = colorize

package/src/colors/colorize.test.js

@@ -0,0 +1,72 @@
+const test = require('ava')
+
+const { geom2, geom3, path2, poly3 } = require('../geometries')
+
+const { colorize } = require('./index')
+
+test('color (rgb on objects)', (t) => {
+  const obj1 = {}
+  const obj2 = [{ id: 'a' }, { id: 'b' }]
+
+  const obs = colorize([1, 0, 0], obj1, obj2)
+  const exp1 = { color: [1, 0, 0, 1] }
+  const exp2 = { id: 'a', color: [1, 0, 0, 1] }
+
+  t.is(obs.length, 3)
+  t.deepEqual(obs[0], exp1)
+  t.deepEqual(obs[1], exp2)
+
+  const obs3 = colorize([1, 0, 0], obj1)
+  const exp3 = { color: [1, 0, 0, 1] }
+  t.deepEqual(obs3, exp3)
+})
+
+test('color (rgba on objects)', (t) => {
+  const obj1 = {}
+  const obj2 = [{ id: 'a' }, { id: 'b' }]
+
+  const obs = colorize([1, 1, 0.5, 0.8], obj1, obj2)
+  const exp1 = { color: [1, 1, 0.5, 0.8] }
+  const exp2 = { id: 'a', color: [1, 1, 0.5, 0.8] }
+
+  t.is(obs.length, 3)
+  t.deepEqual(obs[0], exp1)
+  t.deepEqual(obs[1], exp2)
+})
+
+test('color (rgba on geometry)', (t) => {
+  const obj0 = geom2.fromPoints([[0, 0], [1, 0], [0, 1]])
+  const obj1 = geom3.fromPoints([[[0, 0, 0], [1, 0, 0], [1, 0, 1]]])
+  const obj2 = path2.fromPoints({ closed: true }, [[0, 0], [1, 0], [1, 1]])
+  const obj3 = poly3.create([[0, 0, 0], [1, 0, 0], [1, 1, 0]])
+
+  const obs = colorize([1, 1, 0.5, 0.8], obj0, obj1, obj2, obj3)
+  t.is(obs.length, 4)
+
+  t.not(obj0, obs[0])
+  t.deepEqual(obs[0].color, [1, 1, 0.5, 0.8])
+
+  t.not(obj1, obs[1])
+  t.deepEqual(obs[1].color, [1, 1, 0.5, 0.8])
+
+  t.not(obj2, obs[2])
+  t.deepEqual(obs[2].color, [1, 1, 0.5, 0.8])
+
+  t.not(obj3, obs[3])
+  t.deepEqual(obs[3].color, [1, 1, 0.5, 0.8])
+})
+
+test('color (returns new object)', (t) => {
+  const obj0 = geom2.fromPoints([[0, 0], [1, 0], [0, 1]])
+  // const obj1 = geom2.fromPoints([[0, 0], [1, 0], [0, 1]])
+  // const obj2 = geom2.fromPoints([[0, 0], [1, 0], [0, 1]])
+  const obj3 = geom2.fromPoints([[0, 0], [1, 0], [0, 1]])
+
+  const obs = colorize([1, 1, 1, 0.8], obj0, obj3)
+  t.not(obj0, obs[0])
+  t.deepEqual(obs[0].color, [1, 1, 1, 0.8])
+  t.is(obj0.color, undefined)
+  t.not(obj3, obs[1])
+  t.deepEqual(obs[1].color, [1, 1, 1, 0.8])
+  t.is(obj3.color, undefined)
+})

package/src/colors/cssColors.d.ts

@@ -0,0 +1,149 @@
+import { RGB } from './types'
+
+export const black: RGB
+export const silver: RGB
+export const gray: RGB
+export const white: RGB
+export const maroon: RGB
+export const red: RGB
+export const purple: RGB
+export const fuchsia: RGB
+export const green: RGB
+export const lime: RGB
+export const olive: RGB
+export const yellow: RGB
+export const navy: RGB
+export const blue: RGB
+export const teal: RGB
+export const aqua: RGB
+export const aliceblue: RGB
+export const antiquewhite: RGB
+export const aquamarine: RGB
+export const azure: RGB
+export const beige: RGB
+export const bisque: RGB
+export const blanchedalmond: RGB
+export const blueviolet: RGB
+export const brown: RGB
+export const burlywood: RGB
+export const cadetblue: RGB
+export const chartreuse: RGB
+export const chocolate: RGB
+export const coral: RGB
+export const cornflowerblue: RGB
+export const cornsilk: RGB
+export const crimson: RGB
+export const cyan: RGB
+export const darkblue: RGB
+export const darkcyan: RGB
+export const darkgoldenrod: RGB
+export const darkgray: RGB
+export const darkgreen: RGB
+export const darkgrey: RGB
+export const darkkhaki: RGB
+export const darkmagenta: RGB
+export const darkolivegreen: RGB
+export const darkorange: RGB
+export const darkorchid: RGB
+export const darkred: RGB
+export const darksalmon: RGB
+export const darkseagreen: RGB
+export const darkslateblue: RGB
+export const darkslategray: RGB
+export const darkslategrey: RGB
+export const darkturquoise: RGB
+export const darkviolet: RGB
+export const deeppink: RGB
+export const deepskyblue: RGB
+export const dimgray: RGB
+export const dimgrey: RGB
+export const dodgerblue: RGB
+export const firebrick: RGB
+export const floralwhite: RGB
+export const forestgreen: RGB
+export const gainsboro: RGB
+export const ghostwhite: RGB
+export const gold: RGB
+export const goldenrod: RGB
+export const greenyellow: RGB
+export const grey: RGB
+export const honeydew: RGB
+export const hotpink: RGB
+export const indianred: RGB
+export const indigo: RGB
+export const ivory: RGB
+export const khaki: RGB
+export const lavender: RGB
+export const lavenderblush: RGB
+export const lawngreen: RGB
+export const lemonchiffon: RGB
+export const lightblue: RGB
+export const lightcoral: RGB
+export const lightcyan: RGB
+export const lightgoldenrodyellow: RGB
+export const lightgray: RGB
+export const lightgreen: RGB
+export const lightgrey: RGB
+export const lightpink: RGB
+export const lightsalmon: RGB
+export const lightseagreen: RGB
+export const lightskyblue: RGB
+export const lightslategray: RGB
+export const lightslategrey: RGB
+export const lightsteelblue: RGB
+export const lightyellow: RGB
+export const limegreen: RGB
+export const linen: RGB
+export const magenta: RGB
+export const mediumaquamarine: RGB
+export const mediumblue: RGB
+export const mediumorchid: RGB
+export const mediumpurple: RGB
+export const mediumseagreen: RGB
+export const mediumslateblue: RGB
+export const mediumspringgreen: RGB
+export const mediumturquoise: RGB
+export const mediumvioletred: RGB
+export const midnightblue: RGB
+export const mintcream: RGB
+export const mistyrose: RGB
+export const moccasin: RGB
+export const navajowhite: RGB
+export const oldlace: RGB
+export const olivedrab: RGB
+export const orange: RGB
+export const orangered: RGB
+export const orchid: RGB
+export const palegoldenrod: RGB
+export const palegreen: RGB
+export const paleturquoise: RGB
+export const palevioletred: RGB
+export const papayawhip: RGB
+export const peachpuff: RGB
+export const peru: RGB
+export const pink: RGB
+export const plum: RGB
+export const powderblue: RGB
+export const rosybrown: RGB
+export const royalblue: RGB
+export const saddlebrown: RGB
+export const salmon: RGB
+export const sandybrown: RGB
+export const seagreen: RGB
+export const seashell: RGB
+export const sienna: RGB
+export const skyblue: RGB
+export const slateblue: RGB
+export const slategray: RGB
+export const slategrey: RGB
+export const snow: RGB
+export const springgreen: RGB
+export const steelblue: RGB
+export const tan: RGB
+export const thistle: RGB
+export const tomato: RGB
+export const turquoise: RGB
+export const violet: RGB
+export const wheat: RGB
+export const whitesmoke: RGB
+export const yellowgreen: RGB

package/src/colors/cssColors.js

@@ -0,0 +1,176 @@
+/**
+ * @alias module:modeling/colors.cssColors
+ * @see CSS color table from http://www.w3.org/TR/css3-color/
+ * @enum {Array}
+ * @example
+ * let newshape = colorize(cssColors.red, oldshape)
+ */
+const cssColors = {
+  // basic color keywords
+  black: [0 / 255, 0 / 255, 0 / 255],
+  silver: [192 / 255, 192 / 255, 192 / 255],
+  gray: [128 / 255, 128 / 255, 128 / 255],
+  white: [255 / 255, 255 / 255, 255 / 255],
+  maroon: [128 / 255, 0 / 255, 0 / 255],
+  red: [255 / 255, 0 / 255, 0 / 255],
+  purple: [128 / 255, 0 / 255, 128 / 255],
+  fuchsia: [255 / 255, 0 / 255, 255 / 255],
+  green: [0 / 255, 128 / 255, 0 / 255],
+  lime: [0 / 255, 255 / 255, 0 / 255],
+  olive: [128 / 255, 128 / 255, 0 / 255],
+  yellow: [255 / 255, 255 / 255, 0 / 255],
+  navy: [0 / 255, 0 / 255, 128 / 255],
+  blue: [0 / 255, 0 / 255, 255 / 255],
+  teal: [0 / 255, 128 / 255, 128 / 255],
+  aqua: [0 / 255, 255 / 255, 255 / 255],
+  // extended color keywords
+  aliceblue: [240 / 255, 248 / 255, 255 / 255],
+  antiquewhite: [250 / 255, 235 / 255, 215 / 255],
+  // 'aqua': [ 0 / 255, 255 / 255, 255 / 255 ],
+  aquamarine: [127 / 255, 255 / 255, 212 / 255],
+  azure: [240 / 255, 255 / 255, 255 / 255],
+  beige: [245 / 255, 245 / 255, 220 / 255],
+  bisque: [255 / 255, 228 / 255, 196 / 255],
+  // 'black': [ 0 / 255, 0 / 255, 0 / 255 ],
+  blanchedalmond: [255 / 255, 235 / 255, 205 / 255],
+  // 'blue': [ 0 / 255, 0 / 255, 255 / 255 ],
+  blueviolet: [138 / 255, 43 / 255, 226 / 255],
+  brown: [165 / 255, 42 / 255, 42 / 255],
+  burlywood: [222 / 255, 184 / 255, 135 / 255],
+  cadetblue: [95 / 255, 158 / 255, 160 / 255],
+  chartreuse: [127 / 255, 255 / 255, 0 / 255],
+  chocolate: [210 / 255, 105 / 255, 30 / 255],
+  coral: [255 / 255, 127 / 255, 80 / 255],
+  cornflowerblue: [100 / 255, 149 / 255, 237 / 255],
+  cornsilk: [255 / 255, 248 / 255, 220 / 255],
+  crimson: [220 / 255, 20 / 255, 60 / 255],
+  cyan: [0 / 255, 255 / 255, 255 / 255],
+  darkblue: [0 / 255, 0 / 255, 139 / 255],
+  darkcyan: [0 / 255, 139 / 255, 139 / 255],
+  darkgoldenrod: [184 / 255, 134 / 255, 11 / 255],
+  darkgray: [169 / 255, 169 / 255, 169 / 255],
+  darkgreen: [0 / 255, 100 / 255, 0 / 255],
+  darkgrey: [169 / 255, 169 / 255, 169 / 255],
+  darkkhaki: [189 / 255, 183 / 255, 107 / 255],
+  darkmagenta: [139 / 255, 0 / 255, 139 / 255],
+  darkolivegreen: [85 / 255, 107 / 255, 47 / 255],
+  darkorange: [255 / 255, 140 / 255, 0 / 255],
+  darkorchid: [153 / 255, 50 / 255, 204 / 255],
+  darkred: [139 / 255, 0 / 255, 0 / 255],
+  darksalmon: [233 / 255, 150 / 255, 122 / 255],
+  darkseagreen: [143 / 255, 188 / 255, 143 / 255],
+  darkslateblue: [72 / 255, 61 / 255, 139 / 255],
+  darkslategray: [47 / 255, 79 / 255, 79 / 255],
+  darkslategrey: [47 / 255, 79 / 255, 79 / 255],
+  darkturquoise: [0 / 255, 206 / 255, 209 / 255],
+  darkviolet: [148 / 255, 0 / 255, 211 / 255],
+  deeppink: [255 / 255, 20 / 255, 147 / 255],
+  deepskyblue: [0 / 255, 191 / 255, 255 / 255],
+  dimgray: [105 / 255, 105 / 255, 105 / 255],
+  dimgrey: [105 / 255, 105 / 255, 105 / 255],
+  dodgerblue: [30 / 255, 144 / 255, 255 / 255],
+  firebrick: [178 / 255, 34 / 255, 34 / 255],
+  floralwhite: [255 / 255, 250 / 255, 240 / 255],
+  forestgreen: [34 / 255, 139 / 255, 34 / 255],
+  // 'fuchsia': [ 255 / 255, 0 / 255, 255 / 255 ],
+  gainsboro: [220 / 255, 220 / 255, 220 / 255],
+  ghostwhite: [248 / 255, 248 / 255, 255 / 255],
+  gold: [255 / 255, 215 / 255, 0 / 255],
+  goldenrod: [218 / 255, 165 / 255, 32 / 255],
+  // 'gray': [ 128 / 255, 128 / 255, 128 / 255 ],
+  // 'green': [ 0 / 255, 128 / 255, 0 / 255 ],
+  greenyellow: [173 / 255, 255 / 255, 47 / 255],
+  grey: [128 / 255, 128 / 255, 128 / 255],
+  honeydew: [240 / 255, 255 / 255, 240 / 255],
+  hotpink: [255 / 255, 105 / 255, 180 / 255],
+  indianred: [205 / 255, 92 / 255, 92 / 255],
+  indigo: [75 / 255, 0 / 255, 130 / 255],
+  ivory: [255 / 255, 255 / 255, 240 / 255],
+  khaki: [240 / 255, 230 / 255, 140 / 255],
+  lavender: [230 / 255, 230 / 255, 250 / 255],
+  lavenderblush: [255 / 255, 240 / 255, 245 / 255],
+  lawngreen: [124 / 255, 252 / 255, 0 / 255],
+  lemonchiffon: [255 / 255, 250 / 255, 205 / 255],
+  lightblue: [173 / 255, 216 / 255, 230 / 255],
+  lightcoral: [240 / 255, 128 / 255, 128 / 255],
+  lightcyan: [224 / 255, 255 / 255, 255 / 255],
+  lightgoldenrodyellow: [250 / 255, 250 / 255, 210 / 255],
+  lightgray: [211 / 255, 211 / 255, 211 / 255],
+  lightgreen: [144 / 255, 238 / 255, 144 / 255],
+  lightgrey: [211 / 255, 211 / 255, 211 / 255],
+  lightpink: [255 / 255, 182 / 255, 193 / 255],
+  lightsalmon: [255 / 255, 160 / 255, 122 / 255],
+  lightseagreen: [32 / 255, 178 / 255, 170 / 255],
+  lightskyblue: [135 / 255, 206 / 255, 250 / 255],
+  lightslategray: [119 / 255, 136 / 255, 153 / 255],
+  lightslategrey: [119 / 255, 136 / 255, 153 / 255],
+  lightsteelblue: [176 / 255, 196 / 255, 222 / 255],
+  lightyellow: [255 / 255, 255 / 255, 224 / 255],
+  // 'lime': [ 0 / 255, 255 / 255, 0 / 255 ],
+  limegreen: [50 / 255, 205 / 255, 50 / 255],
+  linen: [250 / 255, 240 / 255, 230 / 255],
+  magenta: [255 / 255, 0 / 255, 255 / 255],
+  // 'maroon': [ 128 / 255, 0 / 255, 0 / 255 ],
+  mediumaquamarine: [102 / 255, 205 / 255, 170 / 255],
+  mediumblue: [0 / 255, 0 / 255, 205 / 255],
+  mediumorchid: [186 / 255, 85 / 255, 211 / 255],
+  mediumpurple: [147 / 255, 112 / 255, 219 / 255],
+  mediumseagreen: [60 / 255, 179 / 255, 113 / 255],
+  mediumslateblue: [123 / 255, 104 / 255, 238 / 255],
+  mediumspringgreen: [0 / 255, 250 / 255, 154 / 255],
+  mediumturquoise: [72 / 255, 209 / 255, 204 / 255],
+  mediumvioletred: [199 / 255, 21 / 255, 133 / 255],
+  midnightblue: [25 / 255, 25 / 255, 112 / 255],
+  mintcream: [245 / 255, 255 / 255, 250 / 255],
+  mistyrose: [255 / 255, 228 / 255, 225 / 255],
+  moccasin: [255 / 255, 228 / 255, 181 / 255],
+  navajowhite: [255 / 255, 222 / 255, 173 / 255],
+  // 'navy': [ 0 / 255, 0 / 255, 128 / 255 ],
+  oldlace: [253 / 255, 245 / 255, 230 / 255],
+  // 'olive': [ 128 / 255, 128 / 255, 0 / 255 ],
+  olivedrab: [107 / 255, 142 / 255, 35 / 255],
+  orange: [255 / 255, 165 / 255, 0 / 255],
+  orangered: [255 / 255, 69 / 255, 0 / 255],
+  orchid: [218 / 255, 112 / 255, 214 / 255],
+  palegoldenrod: [238 / 255, 232 / 255, 170 / 255],
+  palegreen: [152 / 255, 251 / 255, 152 / 255],
+  paleturquoise: [175 / 255, 238 / 255, 238 / 255],
+  palevioletred: [219 / 255, 112 / 255, 147 / 255],
+  papayawhip: [255 / 255, 239 / 255, 213 / 255],
+  peachpuff: [255 / 255, 218 / 255, 185 / 255],
+  peru: [205 / 255, 133 / 255, 63 / 255],
+  pink: [255 / 255, 192 / 255, 203 / 255],
+  plum: [221 / 255, 160 / 255, 221 / 255],
+  powderblue: [176 / 255, 224 / 255, 230 / 255],
+  // 'purple': [ 128 / 255, 0 / 255, 128 / 255 ],
+  // 'red': [ 255 / 255, 0 / 255, 0 / 255 ],
+  rosybrown: [188 / 255, 143 / 255, 143 / 255],
+  royalblue: [65 / 255, 105 / 255, 225 / 255],
+  saddlebrown: [139 / 255, 69 / 255, 19 / 255],
+  salmon: [250 / 255, 128 / 255, 114 / 255],
+  sandybrown: [244 / 255, 164 / 255, 96 / 255],
+  seagreen: [46 / 255, 139 / 255, 87 / 255],
+  seashell: [255 / 255, 245 / 255, 238 / 255],
+  sienna: [160 / 255, 82 / 255, 45 / 255],
+  // 'silver': [ 192 / 255, 192 / 255, 192 / 255 ],
+  skyblue: [135 / 255, 206 / 255, 235 / 255],
+  slateblue: [106 / 255, 90 / 255, 205 / 255],
+  slategray: [112 / 255, 128 / 255, 144 / 255],
+  slategrey: [112 / 255, 128 / 255, 144 / 255],
+  snow: [255 / 255, 250 / 255, 250 / 255],
+  springgreen: [0 / 255, 255 / 255, 127 / 255],
+  steelblue: [70 / 255, 130 / 255, 180 / 255],
+  tan: [210 / 255, 180 / 255, 140 / 255],
+  // 'teal': [ 0 / 255, 128 / 255, 128 / 255 ],
+  thistle: [216 / 255, 191 / 255, 216 / 255],
+  tomato: [255 / 255, 99 / 255, 71 / 255],
+  turquoise: [64 / 255, 224 / 255, 208 / 255],
+  violet: [238 / 255, 130 / 255, 238 / 255],
+  wheat: [245 / 255, 222 / 255, 179 / 255],
+  // 'white': [ 255 / 255, 255 / 255, 255 / 255 ],
+  whitesmoke: [245 / 255, 245 / 255, 245 / 255],
+  // 'yellow': [ 255 / 255, 255 / 255, 0 / 255 ],
+  yellowgreen: [154 / 255, 205 / 255, 50 / 255]
+}
+
+module.exports = cssColors

package/src/colors/hexToRgb.d.ts

@@ -0,0 +1,5 @@
+import { RGB, RGBA } from './types'
+
+export default hexToRgb
+
+declare function hexToRgb(hex: string): RGB | RGBA

package/src/colors/hexToRgb.js

@@ -0,0 +1,26 @@
+/**
+ * Converts CSS color notations (string of hex values) to RGB values.
+ *
+ * @see https://www.w3.org/TR/css-color-3/
+ * @param {String} notation - color notation
+ * @return {Array} RGB color values
+ * @alias module:modeling/colors.hexToRgb
+ *
+ * @example
+ * let mysphere = colorize(hexToRgb('#000080'), sphere()) // navy blue
+ */
+const hexToRgb = (notation) => {
+  notation = notation.replace('#', '')
+  if (notation.length < 6) throw new Error('the given notation must contain 3 or more hex values')
+
+  const r = parseInt(notation.substring(0, 2), 16) / 255
+  const g = parseInt(notation.substring(2, 4), 16) / 255
+  const b = parseInt(notation.substring(4, 6), 16) / 255
+  if (notation.length >= 8) {
+    const a = parseInt(notation.substring(6, 8), 16) / 255
+    return [r, g, b, a]
+  }
+  return [r, g, b]
+}
+
+module.exports = hexToRgb

package/src/colors/hexToRgb.test.js

@@ -0,0 +1,37 @@
+const test = require('ava')
+
+const { hexToRgb } = require('./index')
+
+test('hexToRgb (RGB notations)', (t) => {
+  let obs = hexToRgb('#ff007f')
+  let exp = [1, 0, 0.4980392156862745]
+
+  t.deepEqual(obs, exp)
+
+  obs = hexToRgb('#FF007F')
+  exp = [1, 0, 0.4980392156862745]
+
+  t.deepEqual(obs, exp)
+
+  obs = hexToRgb('FF007F')
+  exp = [1, 0, 0.4980392156862745]
+
+  t.deepEqual(obs, exp)
+})
+
+test('hexToRgb (RGBA notations)', (t) => {
+  let obs = hexToRgb('#ff007f01')
+  let exp = [1, 0, 0.4980392156862745, 0.00392156862745098]
+
+  t.deepEqual(obs, exp)
+
+  obs = hexToRgb('#FF007F01')
+  exp = [1, 0, 0.4980392156862745, 0.00392156862745098]
+
+  t.deepEqual(obs, exp)
+
+  obs = hexToRgb('FF007F01')
+  exp = [1, 0, 0.4980392156862745, 0.00392156862745098]
+
+  t.deepEqual(obs, exp)
+})

package/src/colors/hslToRgb.d.ts

@@ -0,0 +1,8 @@
+import { HSL, HSLA, RGB, RGBA } from './types'
+
+export default hslToRgb
+
+declare function hslToRgb(hsl:  HSL): RGB
+declare function hslToRgb(hsl:  HSLA): RGBA
+declare function hslToRgb(...hsl:  HSL): RGB
+declare function hslToRgb(...hsl:  HSLA): RGBA