@central-design-system/components 3.0.0-beta.0 → 3.0.0-beta.10

package/dist/utils/colors.d.ts

@@ -0,0 +1,368 @@
+declare const _default: Readonly<{
+    red: Readonly<{
+        lighten10: "#faecec";
+        lighten50: "#fdcfcf";
+        lighten100: "ffb2b2";
+        lighten200: "#ff6666";
+        lighten300: "#f23838";
+        lighten400: "#eb0000";
+        lighten500: "#ca0000";
+        lighten600: "#aa0000";
+        lighten700: "#890000";
+        lighten800: "#680000";
+        lighten900: "#470000";
+        darken10: "#1f0000";
+        darken50: "#290000";
+        darken100: "#370000";
+        darken200: "#4F0000";
+        darken300: "#680000";
+        darken400: "#800000";
+        darken500: "#980C0C";
+        darken600: "#b13434";
+        darken700: "#c96767";
+        darken800: "#e2a4a4";
+        darken900: "#f5e7e7";
+    }>;
+    chocolate: Readonly<{
+        lighten10: "#faf0ec";
+        lighten50: "#f9ded2";
+        lighten100: "#f7cbb8";
+        lighten200: "#ec9f7f";
+        lighten300: "#e1774a";
+        lighten400: "#d6511a";
+        lighten500: "#b93b06";
+        lighten600: "#9d3104";
+        lighten700: "#802802";
+        lighten800: "#641e01";
+        lighten900: "#471500";
+        darken10: "#1f0900";
+        darken50: "#290c00";
+        darken100: "#371000";
+        darken200: "#4F1800";
+        darken300: "#681f00";
+        darken400: "#802600";
+        darken500: "#98360c";
+        darken600: "#b15a34";
+        darken700: "#c98467";
+        darken800: "#e2b7a4";
+        darken900: "#f5ebe7";
+    }>;
+    orange: Readonly<{
+        lighten10: "#fff7f1";
+        lighten50: "#ffe8d7";
+        lighten100: "#ffdec1";
+        lighten200: "#ffbc89";
+        lighten300: "#ff9b52";
+        lighten400: "#f67b1d";
+        lighten500: "#d35f06";
+        lighten600: "#b04f04";
+        lighten700: "#8d3e02";
+        lighten800: "#6a2f01";
+        lighten900: "#471f00";
+        darken10: "#1f0d00";
+        darken50: "#291100";
+        darken100: "#371800";
+        darken200: "#4F2200";
+        darken300: "#682d00";
+        darken400: "#803700";
+        darken500: "#98490c";
+        darken600: "#b16a34";
+        darken700: "#c99267";
+        darken800: "#e2bfa4";
+        darken900: "#f5ede7";
+    }>;
+    yellow: Readonly<{
+        lighten10: "#fffbf1";
+        lighten50: "#fff1c3";
+        lighten100: "#ffeb98";
+        lighten200: "#ffd54b";
+        lighten300: "#ffc000";
+        lighten400: "#e0a900";
+        lighten500: "#c29200";
+        lighten600: "#a37b00";
+        lighten700: "#856400";
+        lighten800: "#664d00";
+        lighten900: "#473600";
+        darken10: "#1f1700";
+        darken50: "#291e00";
+        darken100: "#372900";
+        darken200: "#4f3c00";
+        darken300: "#684e00";
+        darken400: "#806000";
+        darken500: "#98750c";
+        darken600: "#b19234";
+        darken700: "#c9b167";
+        darken800: "#e2d2a4";
+        darken900: "#f5f1e7";
+    }>;
+    lemon: Readonly<{
+        lighten10: "#fffef1";
+        lighten50: "#fefcc9";
+        lighten100: "#ffffa5";
+        lighten200: "#fcf75f";
+        lighten300: "#f6ef1d";
+        lighten400: "#d9d200";
+        lighten500: "#bcb600";
+        lighten600: "#9f9900";
+        lighten700: "#827d00";
+        lighten800: "#656100";
+        lighten900: "#474500";
+        darken10: "#1f1e00";
+        darken50: "#292700";
+        darken100: "#373500";
+        darken200: "#4f4d00";
+        darken300: "#686400";
+        darken400: "#807c00";
+        darken500: "#98940c";
+        darken600: "#b1ad34";
+        darken700: "#c9c667";
+        darken800: "#e2dfa4";
+        darken900: "#f5f4e7";
+    }>;
+    lime: Readonly<{
+        lighten10: "#fcfff1";
+        lighten50: "#f2fec9";
+        lighten100: "#ecffa5";
+        lighten200: "#d7fc5f";
+        lighten300: "#c3f61d";
+        lighten400: "#a6d900";
+        lighten500: "#90bc00";
+        lighten600: "#7a9f00";
+        lighten700: "#638200";
+        lighten800: "#4d6500";
+        lighten900: "#374700";
+        darken10: "#1f1f00";
+        darken50: "#1e2900";
+        darken100: "#2a3700";
+        darken200: "#3d4f00";
+        darken300: "#506800";
+        darken400: "#628000";
+        darken500: "#78980c";
+        darken600: "#94b134";
+        darken700: "#b2c967";
+        darken800: "#d3e2a4";
+        darken900: "#f2f5e7";
+    }>;
+    green: Readonly<{
+        lighten10: "#eefaec";
+        lighten50: "#cbefc4";
+        lighten100: "#aae59f";
+        lighten200: "#72d161";
+        lighten300: "#42bc2c";
+        lighten400: "#1aa800";
+        lighten500: "#179500";
+        lighten600: "#148100";
+        lighten700: "#116e00";
+        lighten800: "#0e5b00";
+        lighten900: "#0b4700";
+        darken10: "#051f00";
+        darken50: "#072900";
+        darken100: "#083700";
+        darken200: "#0c4f00";
+        darken300: "#106800";
+        darken400: "#138000";
+        darken500: "#21980c";
+        darken600: "#47b134";
+        darken700: "#76c967";
+        darken800: "#ade2a4";
+        darken900: "#e9f5e7";
+    }>;
+    cyan: Readonly<{
+        lighten10: "#ecfaf8";
+        lighten50: "#c9fef5";
+        lighten100: "#a5fff2";
+        lighten200: "#5ffce2";
+        lighten300: "#1df6d2";
+        lighten400: "#00d9b5";
+        lighten500: "#00bc9d";
+        lighten600: "#009f84";
+        lighten700: "#00826c";
+        lighten800: "#006554";
+        lighten900: "#00473c";
+        darken10: "#001f1a";
+        darken50: "#002922";
+        darken100: "#00372c";
+        darken200: "#004f42";
+        darken300: "#006856";
+        darken400: "#00806b";
+        darken500: "#0c9881";
+        darken600: "#34b19c";
+        darken700: "#67c9b9";
+        darken800: "#a4e2d7";
+        darken900: "#e7f5f3";
+    }>;
+    lightBlue: Readonly<{
+        lighten10: "#ecf4fa";
+        lighten50: "#d2edff";
+        lighten100: "#b7e5ff";
+        lighten200: "#7acaff";
+        lighten300: "#3da2e5";
+        lighten400: "#0b7ecb";
+        lighten500: "#006ab0";
+        lighten600: "#005a96";
+        lighten700: "#004a7c";
+        lighten800: "#003b62";
+        lighten900: "#002b47";
+        darken10: "#00121f";
+        darken50: "#001829";
+        darken100: "#002137";
+        darken200: "#00304f";
+        darken300: "#003e68";
+        darken400: "#004d80";
+        darken500: "#0c6098";
+        darken600: "#347fb1";
+        darken700: "#67a2c9";
+        darken800: "#a4c9e2";
+        darken900: "#e7eff5";
+    }>;
+    teal: Readonly<{
+        lighten10: "#ecf9fa";
+        lighten50: "#b1f4fc";
+        lighten100: "#76f0fe";
+        lighten200: "#1de0f6";
+        lighten300: "#00c7dd";
+        lighten400: "#00b0c4";
+        lighten500: "#009aab";
+        lighten600: "#008492";
+        lighten700: "#006d79";
+        lighten800: "#005760";
+        lighten900: "#004047";
+        darken10: "#00161f";
+        darken50: "#001d29";
+        darken100: "#002737";
+        darken200: "#00394f";
+        darken300: "#004a68";
+        darken400: "#005c80";
+        darken500: "#0c7198";
+        darken600: "#348eb1";
+        darken700: "#67adc9";
+        darken800: "#a4d0e2";
+        darken900: "#e7f0f5";
+    }>;
+    blue: Readonly<{
+        lighten10: "#ecf1fa";
+        lighten50: "#d7e6ff";
+        lighten100: "#c1daff";
+        lighten200: "#89b5ff";
+        lighten300: "#5291fb";
+        lighten400: "#1d6ef6";
+        lighten500: "#0653d3";
+        lighten600: "#0444b0";
+        lighten700: "#02368d";
+        lighten800: "#01286a";
+        lighten900: "#001a47";
+        darken10: "#000b1f";
+        darken50: "#000e29";
+        darken100: "#001437";
+        darken200: "#001d4f";
+        darken300: "#002668";
+        darken400: "#002f80";
+        darken500: "#0c4098";
+        darken600: "#3462b1";
+        darken700: "#678bc9";
+        darken800: "#a4bbe2";
+        darken900: "#e7ecf5";
+    }>;
+    indigo: Readonly<{
+        lighten10: "#eeecfa";
+        lighten50: "#ded7ff";
+        lighten100: "#cdc1ff";
+        lighten200: "#9c89ff";
+        lighten300: "#6e52fb";
+        lighten400: "#411df6";
+        lighten500: "#2806d3";
+        lighten600: "#2104b0";
+        lighten700: "#19028d";
+        lighten800: "#12016a";
+        lighten900: "#0c0047";
+        darken10: "#05001f";
+        darken50: "#070029";
+        darken100: "#090037";
+        darken200: "#0d004f";
+        darken300: "#100068";
+        darken400: "#150080";
+        darken500: "#240c98";
+        darken600: "#4934b1";
+        darken700: "#7767c9";
+        darken800: "#aea4e2";
+        darken900: "#e9e7f5";
+    }>;
+    purple: Readonly<{
+        lighten10: "#f2ecfa";
+        lighten50: "#e8d7ff";
+        lighten100: "#d3c1ff";
+        lighten200: "#bc89ff";
+        lighten300: "#9b52fb";
+        lighten400: "#7b1df6";
+        lighten500: "#5f06d3";
+        lighten600: "#4f04b0";
+        lighten700: "#3e028d";
+        lighten800: "#2f016a";
+        lighten900: "#1f0047";
+        darken10: "#0d001f";
+        darken50: "#110029";
+        darken100: "#180037";
+        darken200: "#22004f";
+        darken300: "#2d0068";
+        darken400: "#370080";
+        darken500: "#490c98";
+        darken600: "#6a34b1";
+        darken700: "#9267c9";
+        darken800: "#bfa4e2";
+        darken900: "#ede7f5";
+    }>;
+    lightPurple: Readonly<{
+        lighten10: "#f6ecfa";
+        lighten50: "#f3d7ff";
+        lighten100: "#f0c1ff";
+        lighten200: "#dc89ff";
+        lighten300: "#c852fb";
+        lighten400: "#b51df6";
+        lighten500: "#9606d3";
+        lighten600: "#7d04b0";
+        lighten700: "#64028d";
+        lighten800: "#4b016a";
+        lighten900: "#320047";
+        darken10: "#15001f";
+        darken50: "#1c0029";
+        darken100: "#260037";
+        darken200: "#38004f";
+        darken300: "#490068";
+        darken400: "#5a0080";
+        darken500: "#6c0c98";
+        darken600: "#8b34b1";
+        darken700: "#ac67c9";
+        darken800: "#cfa4e2";
+        darken900: "#f1e7f5";
+    }>;
+    gray: Readonly<{
+        lighten10: "#f5f5f5";
+        lighten50: "#ebebeb";
+        lighten100: "#e5e5e5";
+        lighten200: "#dadada";
+        lighten300: "#bebebe";
+        lighten400: "#999999";
+        lighten500: "#858585";
+        lighten600: "#555555";
+        lighten700: "#333333";
+        lighten800: "#222222";
+        lighten900: "#111111";
+        darken10: "#0d0d0d";
+        darken50: "#171717";
+        darken100: "#1f1f1f";
+        darken200: "#2d2d2d";
+        darken300: "#3b3b3b";
+        darken400: "#494949";
+        darken500: "#575757";
+        darken600: "#656565";
+        darken700: "#737373";
+        darken800: "#818181";
+        darken900: "#8f8f8f";
+    }>;
+    shades: Readonly<{
+        black: "#000000";
+        white: "#ffffff";
+        transparent: "#ffffff00";
+    }>;
+}>;
+export default _default;

package/dist/utils/colorsUtils/APCA.d.ts

@@ -0,0 +1,7 @@
+/**
+ * WCAG 3.0 APCA perceptual contrast algorithm from https://github.com/Myndex/SAPC-APCA
+ * @licence https://www.w3.org/Consortium/Legal/2015/copyright-software-and-document
+ * @see https://www.w3.org/WAI/GL/task-forces/silver/wiki/Visual_Contrast_of_Text_Subgroup
+ */
+import type { RGB } from './utils';
+export declare function APCAcontrast(text: RGB, background: RGB): number;

package/dist/utils/colorsUtils/index.d.ts

@@ -0,0 +1 @@
+export * from './utils';

package/dist/utils/colorsUtils/transformCIELAB.d.ts

@@ -0,0 +1,3 @@
+import type { LAB, XYZ } from './utils';
+export declare function fromXYZ(xyz: XYZ): LAB;
+export declare function toXYZ(lab: LAB): XYZ;

package/dist/utils/colorsUtils/transformSRGB.d.ts

@@ -0,0 +1,3 @@
+import type { RGB, XYZ } from './utils';
+export declare function fromXYZ(xyz: XYZ): RGB;
+export declare function toXYZ({ r, g, b }: RGB): XYZ;

package/dist/utils/colorsUtils/utils.d.ts

@@ -0,0 +1,41 @@
+export declare type XYZ = [number, number, number];
+export declare type LAB = [number, number, number];
+export declare type HSV = {
+    h: number;
+    s: number;
+    v: number;
+    a?: number;
+};
+export declare type RGB = {
+    r: number;
+    g: number;
+    b: number;
+    a?: number;
+};
+export declare type HSL = {
+    h: number;
+    s: number;
+    l: number;
+    a?: number;
+};
+export declare type Hex = string & {
+    __hexBrand: never;
+};
+export declare type Color = string | number | HSV | RGB | HSL;
+export declare function isCssColor(color?: string | null | false): boolean;
+export declare function parseColor(color: Color): RGB;
+export declare function lighten(value: RGB, amount: number): RGB;
+export declare function darken(value: RGB, amount: number): RGB;
+export declare function RGBtoHex({ r, g, b, a }: RGB): Hex;
+export declare function HexToRGB(hex: Hex): RGB;
+export declare function parseHex(hex: string): Hex;
+export declare function HSLtoHSV(hsl: HSL): HSV;
+/** Converts HSVA to RGBA. Based on formula from https://en.wikipedia.org/wiki/HSL_and_HSV */
+export declare function HSVtoRGB(hsva: HSV): RGB;
+export declare function HSLtoRGB(hsla: HSL): RGB;
+/**
+ * Calculate the relative luminance of a given color
+ * @see https://www.w3.org/TR/WCAG20/#relativeluminancedef
+ */
+export declare function getLuma(color: Color): number;
+export declare function getForeground(color: Color): "#fff" | "#000";

package/dist/utils/date/date.d.ts

@@ -30,21 +30,21 @@ export declare type TDateLocale = {
  * @param __forcedYear
  * @param __forcedTimezoneOffset
  */
-export declare function formatDate(value: any, mask: string, dateLocale: TDateLocale, __forcedYear: number, __forcedTimezoneOffset: number): string | undefined;
+export declare function formatDate(value: any, mask: string, dateLocale?: TDateLocale, __forcedYear?: number, __forcedTimezoneOffset?: number): string | undefined;
 /**
  * Set a specific year, month and day to a date.
  * @param date
  * @param rawModified
  * @param utc
  */
-export declare function adjustDate(date: Date, rawModified: IRawDate, utc: boolean): Date;
+export declare function adjustDate(date: Date, rawModified: IRawDate, utc?: boolean): Date;
 /**
  * Parse any string into a date object based on the format passed.
  * @param str
  * @param mask
  * @param dateLocale
  */
-export declare function extractDate(str: string, mask: string, dateLocale: TDateLocale): Date;
+export declare function extractDate(str: string, mask: string, dateLocale?: TDateLocale): Date;
 /**
  * Split date by mask.
  * @param str
@@ -57,13 +57,13 @@ export declare function splitDate(str?: string | any, mask?: string, dateLocale?
  * Check a date string for validity.
  * @param date
  */
-export declare function isValid(date: any): boolean;
+export declare function isValidDate(date: any): boolean;
 /**
  * The following method is just a wrapper to help you in cases where you just need current time but with a different year, or month, or second etc.
  * @param modified
  * @param utc
  */
-export declare function buildDate(modified: IRawDate, utc: boolean): Date;
+export declare function buildDate(modified: IRawDate, utc?: boolean): Date;
 /**
  * Get the day number in week for a given date.
  * @param date
@@ -86,10 +86,10 @@ export declare function getDayOfYear(date: Date): number | undefined;
  * @param to
  * @param opts
  */
-export declare function isBetweenDates(date: Date, from: Date, to: Date, opts: {
-    onlyDate: boolean;
-    inclusiveFrom: boolean;
-    inclusiveTo: boolean;
+export declare function isBetweenDates(date: Date, from: Date, to: Date, opts?: {
+    onlyDate?: boolean;
+    inclusiveFrom?: boolean;
+    inclusiveTo?: boolean;
 }): boolean;
 /**
  * Add a given date/time unit from a given date.
@@ -164,11 +164,11 @@ export declare function daysInMonth(date: Date): number;
  * Cloning date object.
  * @param date
  */
-export declare function clone(date: Date): Date;
+export declare function cloneDate(date: Date): Date;
 declare const _default: {
     formatDate: typeof formatDate;
-    clone: typeof clone;
-    isValid: typeof isValid;
+    cloneDate: typeof cloneDate;
+    isValidDate: typeof isValidDate;
     buildDate: typeof buildDate;
     getDayOfWeek: typeof getDayOfWeek;
     getWeekOfYear: typeof getWeekOfYear;

package/dist/utils/helpers.d.ts

@@ -99,6 +99,22 @@ export declare function getNestedValue(obj: any, path: (string | number)[], fall
  * @param fallback
  */
 export declare function getObjectValueByPath(obj: any, path: string, fallback?: any): any;
+/**
+ * This function is used to get the value of a property from an item. The property can be a string, an array, a function, or a boolean.
+ * If the property is a string, it will be used as a path to retrieve the value from the item.
+ * If the property is an array, it will be used as a nested path to retrieve the value from the item.
+ * If the property is a function, it will be called with the item and the fallback value as arguments, and its return value will be used.
+ * If the property is a boolean, and it's true, the item itself will be returned.
+ * If the property is null, undefined, or a boolean that's not true, the fallback value will be returned.
+ * If the item is not an object, and the property is not a function, the fallback value will be returned.
+ * If the property is not a string, an array, or a function, the fallback value will be returned.
+ * If the value retrieved from the item is undefined, the fallback value will be returned.
+ *
+ * @param item - The item from which to get the property value.
+ * @param property - The property to get from the item. Can be a string, an array, a function, or a boolean.
+ * @param fallback - The value to return if the property is not found or its value is undefined.
+ * @returns The value of the property from the item, or the fallback value.
+ */
 export declare function getPropertyFromItem(item: any, property: SelectItemKey, fallback?: any): any;
 /**
  * This function is used to return the scroll position of the given element.
@@ -142,6 +158,7 @@ export declare const isOn: (key: string) => boolean;
 export declare const EventProp: PropType<(...args: any[]) => any>;
 export declare function isComponentInstance(obj: any): obj is ComponentPublicInstance;
 export declare function isFixedPosition(el?: HTMLElement): boolean;
+export declare function padEnd(str: string, length: number, char?: string): string;
 export declare function padStart(string: number | string, targetLength: number, padString: string): string;
 export declare function pad(n: string | number, length?: number): string;
 export declare function refElement<T extends Record<string, any> | undefined>(obj: T): Exclude<T, ComponentPublicInstance> | HTMLElement;
@@ -163,6 +180,18 @@ export declare function matchesSelector<T>(el: T | Element | undefined, selector
  * @param delay
  */
 export declare function debounce(fn: Function, delay: number): (...args: any[]) => void;
+/**
+ * Pluralize a word based on a number.
+ * @param n
+ * @param opts
+ */
+export declare function plurals(n: number, opts: string[]): string;
+/**
+ * Chunk a string into an array of strings.
+ * @param str
+ * @param size
+ */
+export declare function chunk(str: string, size?: number): string[];
 export declare function noop(): void;
 /**
  * Types
@@ -182,4 +211,5 @@ export declare type ComponentProps<C extends Component> = C extends new (...args
  * ```
  */
 export declare type MaybeRefOrGetter<T> = MaybeRef<T> | (() => T);
+export declare type UnionToIntersection<U> = (U extends any ? (k: U) => void : never) extends (k: infer I) => void ? I : never;
 export {};

package/dist/utils/index.d.ts

@@ -22,3 +22,5 @@ export * from './dom/wrapperRaf';
 export * from './dom/warn';
 export * from './dom/classNames';
 export * from './dom/hRender';
+export * from './colorsUtils';
+export { default as colors } from './colors';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@central-design-system/components",
-  "version": "3.0.0-beta.0",
+  "version": "3.0.0-beta.10",
   "description": "Central Design System on the Vue 3.0 and TypeScript",
   "author": "magersoft",
   "license": "ISC",

package/src/scss/modules/grid/_mixins.scss

@@ -188,10 +188,12 @@
 
       .#{$prefix}-col-auto,
       .#{$prefix}-col#{$infix}-auto {
-        width: auto;
+        @include -make-col-ready($gutter);
+
         // Reset earlier grid tiers
+        width: auto;
         max-width: 100%;
-        flex: 1 0 0;
+        flex: 0 0 auto;
       }
 
       @for $i from 0 through $columns {

package/src/scss/themes/index.ts

@@ -1,6 +1,6 @@
 /**
  * Automatically generated by CDS CLI
- * Generated on 9/27/2023, 11:09:06 AM
+ * Generated on 1/18/2024, 2:08:21 PM
  **/
 
 /**

package/src/scss/utility/display.scss

@@ -1,13 +1,64 @@
-@import "variables";
+@import "./variables";
 
-@each $name, $display in $displays {
+/*
+ * При добавлении утилитарных классов необходимо разделять переменные/формирование. Переменные хранятся в папке ./variables и также используются для формирования документации.
+ * Для всех утилитарных классов необходимо указывать !important
+ * Также, в данном файле необходимо указывать классы как без брейкпоинтов, так и с ними. Пример ниже.
+ * Чтобы утилитарные стили начали работать, необходимо экспортировать этот файл в index.scss, который в дальнейшем окажется в основном бандле.
+ */
+
+// Без брейкпоинтов
+@each $name, $value in $displays {
+  .cds-#{$name} {
+    display: $value !important;
+  }
+}
+
+@each $name, $value in $overflow {
+  .cds-overflow-#{$name} {
+    overflow: $value !important;
+  }
+}
+
+@each $name, $value in $positions {
   .cds-#{$name} {
-    display: $display !important;
+    position: $value !important;
   }
 }
 
-@each $name, $visibility in $visibility {
+@each $name, $value in $visibility {
   .cds-#{$name} {
-    visibility: $visibility !important;
+    visibility: $value !important;
+  }
+}
+
+// С брейкпоинтами
+@each $breakpoint, $map in $grid-breakpoints {
+  $width: map-get($map, 'width');
+
+  @media (min-width: $width) {
+    @each $name, $value in $displays {
+      .#{$breakpoint}\:cds-#{$name} {
+        display: $value !important;
+      }
+    }
+
+    @each $name, $value in $overflow {
+      .#{$breakpoint}\:cds-overflow-#{$name} {
+        overflow: $value !important;
+      }
+    }
+
+    @each $name, $value in $visibility {
+      .#{$breakpoint}\cds-#{$name} {
+        visibility: $value !important;
+      }
+    }
+
+    @each $name, $value in $positions {
+      .#{$breakpoint}\:cds-#{$name} {
+        position: $value !important;
+      }
+    }
   }
 }