@design-edito/tools 0.3.0 → 1.0.1

package/agnostic/colors/types.d.ts

@@ -1,188 +0,0 @@
-/**
- * Represents a hexadecimal color string (e.g., "#FF5733").
- */
-export type Hex = `#${string}`;
-/**
- * Represents a color in the RGBA color space.
- * @property {number} r - Red channel (0-255).
- * @property {number} g - Green channel (0-255).
- * @property {number} b - Blue channel (0-255).
- * @property {number} [a] - Alpha channel (0-1), optional.
- */
-export type Rgba = {
-    r: number;
-    g: number;
-    b: number;
-    a?: number;
-};
-/**
- * Represents a color in the HSLA color space.
- * @property {number} h - Hue (0-360).
- * @property {number} s - Saturation (0-100).
- * @property {number} l - Lightness (0-100).
- * @property {number} [a] - Alpha channel (0-1), optional.
- */
-export type Hsla = {
-    h: number;
-    s: number;
-    l: number;
-    a?: number;
-};
-/**
- * Represents a color in the HSBA (HSB/HSV) color space.
- * @property {number} h - Hue (0-360).
- * @property {number} s - Saturation (0-100).
- * @property {number} b - Brightness (0-100).
- * @property {number} [a] - Alpha channel (0-1), optional.
- */
-export type Hsba = {
-    h: number;
-    s: number;
-    b: number;
-    a?: number;
-};
-/**
- * Represents a color in the CIELAB color space.
- * @property {number} l - Lightness (0-100).
- * @property {number} a - Green-red axis (approximately -128 to 127).
- * @property {number} b - Blue-yellow axis (approximately -128 to 127).
- * @property {number} [al] - Alpha channel (0-1), optional.
- */
-export type Laba = {
-    l: number;
-    a: number;
-    b: number;
-    al?: number;
-};
-/**
- * Represents a color in the CIELCh color space.
- * @property {number} l - Lightness (0-100).
- * @property {number} c - Chroma (0 to approximately 150).
- * @property {number} h - Hue (0-360).
- * @property {number} [a] - Alpha channel (0-1), optional.
- */
-export type Lcha = {
-    l: number;
-    c: number;
-    h: number;
-    a?: number;
-};
-/**
- * Represents a color in the CMYK color space.
- * @property {number} c - Cyan (0-100).
- * @property {number} m - Magenta (0-100).
- * @property {number} y - Yellow (0-100).
- * @property {number} k - Black (0-100).
- * @property {number} [a] - Alpha channel (0-1), optional.
- */
-export type Cmyka = {
-    c: number;
-    m: number;
-    y: number;
-    k: number;
-    a?: number;
-};
-/**
- * Represents a color in the CIE XYZ color space.
- * @property {number} x - X tristimulus value (approximately 0-95.047).
- * @property {number} y - Y tristimulus value (approximately 0-100).
- * @property {number} z - Z tristimulus value (approximately 0-108.883).
- * @property {number} [a] - Alpha channel (0-1), optional.
- */
-export type Xyza = {
-    x: number;
-    y: number;
-    z: number;
-    a?: number;
-};
-/**
- * Union type of all valid CSS named colors.
- */
-export type CssColor = 'aliceblue' | 'antiquewhite' | 'aqua' | 'aquamarine' | 'azure' | 'beige' | 'bisque' | 'black' | 'blanchedalmond' | 'blue' | 'blueviolet' | 'brown' | 'burlywood' | 'cadetblue' | 'chartreuse' | 'chocolate' | 'coral' | 'cornflowerblue' | 'cornsilk' | 'crimson' | 'cyan' | 'darkblue' | 'darkcyan' | 'darkgoldenrod' | 'darkgray' | 'darkgreen' | 'darkgrey' | 'darkkhaki' | 'darkmagenta' | 'darkolivegreen' | 'darkorange' | 'darkorchid' | 'darkred' | 'darksalmon' | 'darkseagreen' | 'darkslateblue' | 'darkslategray' | 'darkslategrey' | 'darkturquoise' | 'darkviolet' | 'deeppink' | 'deepskyblue' | 'dimgray' | 'dimgrey' | 'dodgerblue' | 'firebrick' | 'floralwhite' | 'forestgreen' | 'fuchsia' | 'gainsboro' | 'ghostwhite' | 'gold' | 'goldenrod' | 'gray' | 'green' | 'greenyellow' | 'grey' | 'honeydew' | 'hotpink' | 'indianred' | 'indigo' | 'ivory' | 'khaki' | 'lavender' | 'lavenderblush' | 'lawngreen' | 'lemonchiffon' | 'lightblue' | 'lightcoral' | 'lightcyan' | 'lightgoldenrodyellow' | 'lightgray' | 'lightgreen' | 'lightgrey' | 'lightpink' | 'lightsalmon' | 'lightseagreen' | 'lightskyblue' | 'lightslategray' | 'lightslategrey' | 'lightsteelblue' | 'lightyellow' | 'lime' | 'limegreen' | 'linen' | 'magenta' | 'maroon' | 'mediumaquamarine' | 'mediumblue' | 'mediumorchid' | 'mediumpurple' | 'mediumseagreen' | 'mediumslateblue' | 'mediumspringgreen' | 'mediumturquoise' | 'mediumvioletred' | 'midnightblue' | 'mintcream' | 'mistyrose' | 'moccasin' | 'navajowhite' | 'navy' | 'oldlace' | 'olive' | 'olivedrab' | 'orange' | 'orangered' | 'orchid' | 'palegoldenrod' | 'palegreen' | 'paleturquoise' | 'palevioletred' | 'papayawhip' | 'peachpuff' | 'peru' | 'pink' | 'plum' | 'powderblue' | 'purple' | 'rebeccapurple' | 'red' | 'rosybrown' | 'royalblue' | 'saddlebrown' | 'salmon' | 'sandybrown' | 'seagreen' | 'seashell' | 'sienna' | 'silver' | 'skyblue' | 'slateblue' | 'slategray' | 'slategrey' | 'snow' | 'springgreen' | 'steelblue' | 'tan' | 'teal' | 'thistle' | 'tomato' | 'turquoise' | 'violet' | 'wheat' | 'white' | 'whitesmoke' | 'yellow' | 'yellowgreen';
-type CssColorMap = {
-    [K in CssColor]: Rgba;
-};
-/**
- * Map of CSS named colors to their corresponding RGBA values.
- */
-export declare const cssColors: CssColorMap;
-/**
- * Union type representing any supported color format.
- */
-export type Color = Hex | Rgba | Hsla | Hsba | Laba | Lcha | Cmyka | Xyza | CssColor;
-/**
- * Conditional type that maps a color type to its corresponding transformed type.
- * CSS colors are transformed to RGBA, while other formats remain unchanged.
- * @template C - The input color type.
- */
-export type TransformedColor<C extends Color> = C extends CssColor ? Rgba : C extends Hex ? Hex : C extends Rgba ? Rgba : C extends Hsla ? Hsla : C extends Hsba ? Hsba : C extends Cmyka ? Cmyka : C extends Xyza ? Xyza : C extends Laba ? Laba : C extends Lcha ? Lcha : never;
-/**
- * Union type of all available color channel names across different color spaces.
- */
-export type Channel = 'red' | 'green' | 'blue' | 'alpha' | 'hue' | 'saturation' | 'lightness' | 'brightness' | 'cyan' | 'magenta' | 'yellow' | 'black' | 'x' | 'y' | 'z' | 'lightnessLab' | 'aLab' | 'bLab' | 'chroma' | 'hueLch';
-/**
- * Available methods for inverting colors.
- */
-export type InvertMethod = 'rgb' | 'lab' | 'lch';
-/**
- * Available methods for rotating color hues.
- */
-export type RotateMethod = 'hsl' | 'lab' | 'lch';
-type PaletteMap<C extends Color> = {
-    'complementary': readonly [TransformedColor<C>];
-    'complementary-lab': readonly [TransformedColor<C>];
-    'complementary-lch': readonly [TransformedColor<C>];
-    'split-complementary': readonly [TransformedColor<C>, TransformedColor<C>];
-    'split-complementary-lab': readonly [TransformedColor<C>, TransformedColor<C>];
-    'split-complementary-lch': readonly [TransformedColor<C>, TransformedColor<C>];
-    'triadic': readonly [TransformedColor<C>, TransformedColor<C>];
-    'triadic-lab': readonly [TransformedColor<C>, TransformedColor<C>];
-    'triadic-lch': readonly [TransformedColor<C>, TransformedColor<C>];
-    'tetradic': readonly [TransformedColor<C>, TransformedColor<C>, TransformedColor<C>];
-    'tetradic-lab': readonly [TransformedColor<C>, TransformedColor<C>, TransformedColor<C>];
-    'tetradic-lch': readonly [TransformedColor<C>, TransformedColor<C>, TransformedColor<C>];
-};
-/**
- * Union type of all available color palette generation schemes.
- */
-export type PaletteType = keyof PaletteMap<Color>;
-/**
- * Represents a generated color palette of a specific type.
- * @template C - The input color type.
- * @template T - The palette generation scheme.
- */
-export type Palette<C extends Color, T extends PaletteType> = PaletteMap<C>[T];
-/**
- * Available methods for converting colors to grayscale.
- */
-export type GrayscaleMethod = 'rgb-avg' | 'rgb-weighted-avg' | 'rgb-min-channel' | 'rgb-max-channel' | 'rgb-via-red' | 'rgb-via-green' | 'rgb-via-blue' | 'cmyk-avg' | 'cmyk-no-black-avg' | 'cmyk-min-channel' | 'cmyk-min-no-black-channel' | 'cmyk-max-channel' | 'cmyk-max-no-black-channel' | 'cmyk-via-cyan' | 'cmyk-via-magenta' | 'cmyk-via-yellow' | 'cmyk-via-black' | 'cmyk-perceptual' | 'hsl' | 'hsb' | 'xyz' | 'lab' | 'lch';
-/**
- * Represents a color in the linear sRGB color space.
- * @property {number} linearR - Linear red channel (0-1).
- * @property {number} linearG - Linear green channel (0-1).
- * @property {number} linearB - Linear blue channel (0-1).
- * @property {number} [a] - Alpha channel (0-1), optional.
- */
-export type Srgba = {
-    linearR: number;
-    linearG: number;
-    linearB: number;
-    a?: number;
-};
-/**
- * Available methods for calculating color luminance.
- */
-export type LuminanceMethod = 'rgb' | 'xyz' | 'lab';
-/**
- * Available methods for calculating color distance.
- */
-export type DistanceMethod = 'ciede2000';
-/**
- * Available methods for calculating color contrast ratios.
- */
-export type ContrastMethod = 'wcag';
-/**
- * Available methods for interpolating (lerping) between colors.
- */
-export type LerpMethod = 'rgb' | 'lab' | 'lch' | 'hsl' | 'hsb' | 'rgb-linear' | 'xyz';
-export {};

package/agnostic/colors/types.js

@@ -1,7 +0,0 @@
-import {
-  cssColors
-} from "../../chunks/chunk-KRYJVBO5.js";
-import "../../chunks/chunk-XCBH6NLF.js";
-export {
-  cssColors
-};

package/agnostic/css/bem/index.d.ts

@@ -1,30 +0,0 @@
-export declare function getNamesArr(arg: any): string[];
-export interface Block {
-    name: string;
-    modifiers: string[];
-}
-export declare class BEM {
-    constructor();
-    addBlock(blockNameArg: any): BEM;
-    addElement(elementNameArg: any): BEM;
-    addModifier(modifierNameArg: any): BEM;
-    copy(): BEM;
-    block(blockNameArg: any): BEM;
-    element(elementNameArg: any): BEM;
-    modifier(modifierNameArg: any): BEM;
-    blk(blockNameArg: any): BEM;
-    elt(elementNameArg: any): BEM;
-    mod(modifierNameArg: any): BEM;
-    cp(): BEM;
-    get value(): string;
-    get val(): string;
-    private blocks;
-    private findBlockByName;
-    private addSingleBlock;
-    private addSingleElement;
-    private addSingleModifier;
-    private setCurrentBlockByName;
-    private createBlockByName;
-    private getCurrentBlock;
-}
-export declare function bem(blockNameArg: any): BEM;

package/agnostic/css/bem/index.js

@@ -1,159 +0,0 @@
-import {
-  isValidClassName
-} from "../../../chunks/chunk-W5A2TON3.js";
-import {
-  isFalsy
-} from "../../../chunks/chunk-QXAJXTXV.js";
-import "../../../chunks/chunk-HC6ZOHCS.js";
-import "../../../chunks/chunk-XCBH6NLF.js";
-
-// src/agnostic/css/bem/index.ts
-function getNamesArr(arg) {
-  const returned = [];
-  if (typeof arg === "string") {
-    arg.trim().split(/\s+/gm).forEach((name) => {
-      if (isValidClassName(name)) returned.push(name);
-    });
-  } else if (Array.isArray(arg)) {
-    arg.forEach((elt) => returned.push(...getNamesArr(elt)));
-  } else if (typeof arg === "object" && arg !== null) {
-    Object.entries(arg).forEach(([key, val]) => {
-      if (!isFalsy(val)) returned.push(...getNamesArr(key));
-    });
-  }
-  return returned;
-}
-var BEM = class _BEM {
-  constructor() {
-    this.findBlockByName = this.findBlockByName.bind(this);
-    this.addBlock = this.addBlock.bind(this);
-    this.addElement = this.addElement.bind(this);
-    this.addModifier = this.addModifier.bind(this);
-    this.copy = this.copy.bind(this);
-    this.block = this.block.bind(this);
-    this.element = this.element.bind(this);
-    this.modifier = this.modifier.bind(this);
-    this.blk = this.blk.bind(this);
-    this.elt = this.elt.bind(this);
-    this.mod = this.mod.bind(this);
-    this.cp = this.cp.bind(this);
-    this.addSingleBlock = this.addSingleBlock.bind(this);
-    this.addSingleElement = this.addSingleElement.bind(this);
-    this.addSingleModifier = this.addSingleModifier.bind(this);
-    this.setCurrentBlockByName = this.setCurrentBlockByName.bind(this);
-    this.createBlockByName = this.createBlockByName.bind(this);
-    this.getCurrentBlock = this.getCurrentBlock.bind(this);
-  }
-  addBlock(blockNameArg) {
-    const blocksNames = getNamesArr(blockNameArg);
-    blocksNames.forEach(this.addSingleBlock);
-    return this;
-  }
-  addElement(elementNameArg) {
-    const elementsNames = getNamesArr(elementNameArg);
-    elementsNames.forEach(this.addSingleElement);
-    return this;
-  }
-  addModifier(modifierNameArg) {
-    const currentBlock = this.getCurrentBlock();
-    if (currentBlock === void 0) return this;
-    const modifiersNames = getNamesArr(modifierNameArg);
-    modifiersNames.forEach(this.addSingleModifier);
-    return this;
-  }
-  copy() {
-    const copy = new _BEM();
-    this.blocks.forEach((block) => {
-      copy.addBlock(block.name);
-      block.modifiers.forEach(copy.addModifier);
-    });
-    return copy;
-  }
-  block(blockNameArg) {
-    return this.copy().addBlock(blockNameArg);
-  }
-  element(elementNameArg) {
-    return this.copy().addElement(elementNameArg);
-  }
-  modifier(modifierNameArg) {
-    return this.copy().addModifier(modifierNameArg);
-  }
-  blk(blockNameArg) {
-    return this.block(blockNameArg);
-  }
-  elt(elementNameArg) {
-    return this.element(elementNameArg);
-  }
-  mod(modifierNameArg) {
-    return this.modifier(modifierNameArg);
-  }
-  cp() {
-    return this.copy();
-  }
-  get value() {
-    return this.blocks.map((block) => {
-      return [block.name, ...block.modifiers.map((modifier) => {
-        return `${block.name}_${modifier}`;
-      })].join(" ");
-    }).join(" ");
-  }
-  get val() {
-    return this.value;
-  }
-  blocks = [];
-  findBlockByName(name) {
-    return this.blocks.find((block) => block.name === name);
-  }
-  addSingleBlock(blockName) {
-    if (this.findBlockByName(blockName) !== void 0) {
-      this.setCurrentBlockByName(blockName);
-    } else {
-      const block = this.createBlockByName(blockName);
-      this.blocks.push(block);
-    }
-    return this;
-  }
-  addSingleElement(elementName) {
-    const currentBlock = this.getCurrentBlock();
-    if (currentBlock === void 0) this.addBlock(elementName);
-    else {
-      currentBlock.name = currentBlock.name + "__" + elementName;
-    }
-    return this;
-  }
-  addSingleModifier(modifierName) {
-    const currentBlock = this.getCurrentBlock();
-    if (currentBlock !== void 0) {
-      currentBlock.modifiers.push(modifierName);
-    }
-    return this;
-  }
-  setCurrentBlockByName(blockName) {
-    const block = this.findBlockByName(blockName);
-    if (block !== void 0) {
-      const blockPos = this.blocks.indexOf(block);
-      this.blocks = [
-        ...this.blocks.slice(0, blockPos),
-        ...this.blocks.slice(blockPos + 1),
-        block
-      ];
-    }
-    return this;
-  }
-  createBlockByName(blockName) {
-    return { name: blockName, modifiers: [] };
-  }
-  getCurrentBlock() {
-    return this.blocks.slice(-1)[0];
-  }
-};
-function bem(blockNameArg) {
-  const bem2 = new BEM();
-  if (blockNameArg instanceof BEM) return blockNameArg.copy();
-  return bem2.addBlock(blockNameArg);
-}
-export {
-  BEM,
-  bem,
-  getNamesArr
-};

package/agnostic/css/generate-nice-color/index.d.ts

@@ -1,8 +0,0 @@
-/**
- * Array of aesthetically pleasing CSS named colors.
- */
-export declare const niceColors: readonly ["fuchsia", "teal", "aliceblue", "bisque", "blueviolet", "burlywood", "chocolate", "coral", "cornflowerblue", "crimson", "darkblue", "darkgoldenrod", "darkkhaki", "darkmagenta", "darkolivegreen", "darkorange", "darkorchid", "darkred", "darksalmon", "darkslateblue", "darkslategray", "darkviolet", "deeppink", "deepskyblue", "dodgerblue", "firebrick", "floralwhite", "gainsboro", "gold", "hotpink", "indianred", "indigo", "khaki", "lavender", "lightcoral", "lightgreen", "lightsalmon", "lightsteelblue", "limegreen", "magenta", "mediumseagreen", "mediumspringgreen", "mediumvioletred", "moccasin", "orangered", "orchid", "palegoldenrod", "palevioletred", "peachpuff", "peru", "plum", "royalblue", "sandybrown", "springgreen", "tan", "thistle", "tomato", "violet", "wheat", "yellowgreen"];
-/**
- * Generates a random aesthetically pleasing CSS named color.
- */
-export declare const generateNiceColor: () => (typeof niceColors)[number];

package/agnostic/css/generate-nice-color/index.js

@@ -1,74 +0,0 @@
-import "../../../chunks/chunk-XCBH6NLF.js";
-
-// src/agnostic/css/generate-nice-color/index.ts
-var niceColors = [
-  "fuchsia",
-  "teal",
-  "aliceblue",
-  "bisque",
-  "blueviolet",
-  "burlywood",
-  "chocolate",
-  "coral",
-  "cornflowerblue",
-  "crimson",
-  "darkblue",
-  "darkgoldenrod",
-  "darkkhaki",
-  "darkmagenta",
-  "darkolivegreen",
-  "darkorange",
-  "darkorchid",
-  "darkred",
-  "darksalmon",
-  "darkslateblue",
-  "darkslategray",
-  "darkviolet",
-  "deeppink",
-  "deepskyblue",
-  "dodgerblue",
-  "firebrick",
-  "floralwhite",
-  "gainsboro",
-  "gold",
-  "hotpink",
-  "indianred",
-  "indigo",
-  "khaki",
-  "lavender",
-  "lightcoral",
-  "lightgreen",
-  "lightsalmon",
-  "lightsteelblue",
-  "limegreen",
-  "magenta",
-  "mediumseagreen",
-  "mediumspringgreen",
-  "mediumvioletred",
-  "moccasin",
-  "orangered",
-  "orchid",
-  "palegoldenrod",
-  "palevioletred",
-  "peachpuff",
-  "peru",
-  "plum",
-  "royalblue",
-  "sandybrown",
-  "springgreen",
-  "tan",
-  "thistle",
-  "tomato",
-  "violet",
-  "wheat",
-  "yellowgreen"
-];
-var generateNiceColor = () => {
-  const pos = Math.floor(Math.random() * niceColors.length);
-  const found = niceColors[pos];
-  return found;
-};
-export {
-  generateNiceColor,
-  niceColors
-};

package/agnostic/css/generate-nice-color/index.test.d.ts

@@ -1 +0,0 @@
-export {};

package/agnostic/css/is-valid-css-class-name/index.d.ts

@@ -1,13 +0,0 @@
-/**
- * Regular expression pattern for validating CSS class names.
- * Matches class names that start with an optional hyphen, followed by a letter or underscore,
- * then any combination of letters, numbers, underscores, or hyphens.
- */
-export declare const classNameRegex: RegExp;
-/**
- * Checks if a string is a valid CSS class name.
- *
- * @param {string} string - The string to validate.
- * @returns {boolean} True if the string is a valid CSS class name, false otherwise.
- */
-export declare function isValidClassName(string: string): boolean;

package/agnostic/css/is-valid-css-class-name/index.js

@@ -1,9 +0,0 @@
-import {
-  classNameRegex,
-  isValidClassName
-} from "../../../chunks/chunk-W5A2TON3.js";
-import "../../../chunks/chunk-XCBH6NLF.js";
-export {
-  classNameRegex,
-  isValidClassName
-};

package/agnostic/css/is-valid-css-class-name/index.test.d.ts

@@ -1 +0,0 @@
-export {};

package/agnostic/css/styles-set/index.d.ts

@@ -1,39 +0,0 @@
-import { Component } from 'react';
-export type StylesSetItem = {
-    type: 'string' | 'url';
-    content: string;
-    id?: string;
-    position?: number;
-    onLoad?: () => void;
-};
-export declare class StylesSet {
-    static defaultPrivateIDAttribute: string;
-    static defaultPublicIDAttribute: string;
-    tagsPrivateIDAttribute: string;
-    tagsPublicIDAttribute: string;
-    private _items;
-    get items(): Map<string, StylesSetItem>;
-    private getTargetPosition;
-    setTagsPrivateIDAttribute(str: string): this;
-    setTagsPublicIDAttribute(str: string): this;
-    getById(id: string): StylesSetItem | undefined;
-    generateUniquePrivateId(): string;
-    private _rendered;
-    render(element: Element): this;
-    unmount(element: Element): this;
-    updateRendered(): this;
-    addItem(item: StylesSetItem, abortIfIdExists?: boolean): this;
-    removeItem(idOrPosition: string | number): this;
-    getDomString(documentObj?: Document): Promise<string>;
-}
-export type StylesSetCompProps = {
-    items?: StylesSet['items'];
-    privateIDAttribute?: StylesSet['tagsPrivateIDAttribute'];
-    publicIDAttribute?: StylesSet['tagsPublicIDAttribute'];
-    onRendered?: (...any: any[]) => any;
-};
-export declare class StylesSetComp extends Component<StylesSetCompProps> {
-    componentDidMount(): void;
-    componentDidUpdate(): void;
-    render(): import("react/jsx-runtime").JSX.Element;
-}