@yelbolt/engine-ui-color-palette 1.10.2

package/dist/types/data.types.d.ts

@@ -0,0 +1,135 @@
+import { AlgorithmVersionConfiguration, ColorConfiguration, ColorSpaceConfiguration, LockedSourceColorsConfiguration, PresetConfiguration, ShiftConfiguration, TextColorsThemeConfiguration, ThemeConfiguration } from './configuration.types';
+import { Channel, ChannelWithAlpha, HexModel } from './color.types';
+export interface PaletteData {
+    name: string;
+    description: string;
+    themes: Array<PaletteDataThemeItem>;
+    type: 'palette';
+}
+export interface LibraryData {
+    id: string;
+    paletteName: string;
+    themeName: string;
+    colorName: string;
+    shadeName: string;
+    hex?: HexModel;
+    description?: string;
+    gl?: ChannelWithAlpha;
+    alpha?: number;
+    collectionId?: string;
+    modeId?: string;
+    variableId?: string;
+    styleId?: string;
+    catalogId?: string;
+    themeId?: string;
+    setId?: string;
+    tokenId?: string;
+}
+export interface PaletteDataThemeItem {
+    id: string;
+    name: string;
+    description: string;
+    colors: Array<PaletteDataColorItem>;
+    textColorsTheme?: TextColorsThemeConfiguration<'HEX'>;
+    type: 'default theme' | 'custom theme';
+}
+export interface PaletteDataColorItem {
+    id: string;
+    name: string;
+    description: string;
+    shades: Array<PaletteDataShadeItem>;
+    type: 'color';
+}
+export interface PaletteDataShadeItem {
+    name: string;
+    description: string;
+    hex: HexModel;
+    rgb: Channel;
+    gl: ChannelWithAlpha;
+    lch: Channel;
+    oklch: Channel;
+    lab: Channel;
+    oklab: Channel;
+    hsl: Channel;
+    hsluv: Channel;
+    hsv: Channel;
+    cmyk: ChannelWithAlpha;
+    alpha?: number;
+    backgroundColor?: Channel;
+    mixedColor?: Channel;
+    contrast: {
+        wcag: {
+            ratio: number;
+            score: 'A' | 'AA' | 'AAA';
+        };
+        apca: {
+            lc: number;
+            recommendedUsage: 'UNKNOWN' | 'AVOID' | 'NON_TEXT' | 'SPOT_TEXT' | 'HEADLINES' | 'BODY_TEXT' | 'CONTENT_TEXT' | 'FLUENT_TEXT';
+        };
+    };
+    textContrast?: {
+        wcag: {
+            light: {
+                ratio: number;
+                score: 'A' | 'AA' | 'AAA';
+            };
+            dark: {
+                ratio: number;
+                score: 'A' | 'AA' | 'AAA';
+            };
+        };
+        apca: {
+            light: {
+                lc: number;
+                recommendedUsage: 'UNKNOWN' | 'AVOID' | 'NON_TEXT' | 'SPOT_TEXT' | 'HEADLINES' | 'BODY_TEXT' | 'CONTENT_TEXT' | 'FLUENT_TEXT';
+            };
+            dark: {
+                lc: number;
+                recommendedUsage: 'UNKNOWN' | 'AVOID' | 'NON_TEXT' | 'SPOT_TEXT' | 'HEADLINES' | 'BODY_TEXT' | 'CONTENT_TEXT' | 'FLUENT_TEXT';
+            };
+        };
+    };
+    isClosestToRef?: boolean;
+    isSourceColorLocked?: boolean;
+    isTransparent?: boolean;
+    type: 'source color' | 'color shade/tint';
+}
+export interface ColourLovers {
+    id: number;
+    apiUrl: string;
+    badgeUrl: string;
+    colors: Array<HexModel>;
+    dateCreated: Date | string;
+    description: string;
+    imageUrl: string;
+    numComments: number;
+    numHearts: number;
+    numViews: number;
+    numVotes: number;
+    rank: number;
+    title: string;
+    url: string;
+    userName: string;
+}
+export interface ExternalPalettes {
+    palette_id: string;
+    name: string;
+    description: string;
+    preset: PresetConfiguration;
+    shift: ShiftConfiguration;
+    are_source_colors_locked: LockedSourceColorsConfiguration;
+    colors: Array<ColorConfiguration>;
+    themes: Array<ThemeConfiguration>;
+    color_space: ColorSpaceConfiguration;
+    algorithm_version: AlgorithmVersionConfiguration;
+    is_shared: boolean;
+    creator_id: string;
+    creator_full_name: string;
+    creator_avatar_url: string;
+    org_id?: string;
+    org_name?: string;
+    org_avatar_url?: string;
+    star_count?: number;
+    add_count?: number;
+}
+//# sourceMappingURL=data.types.d.ts.map

package/dist/types/data.types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"data.types.d.ts","sourceRoot":"","sources":["../../src/types/data.types.ts"],"names":[],"mappings":"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"}

package/dist/types/model.types.d.ts

@@ -0,0 +1,3 @@
+import { Channel, ChannelWithAlpha, HexModel } from './color.types';
+export type ColorFormat<T extends 'HEX' | 'RGB'> = T extends 'HEX' ? HexModel : Channel | ChannelWithAlpha;
+//# sourceMappingURL=model.types.d.ts.map

package/dist/types/model.types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"model.types.d.ts","sourceRoot":"","sources":["../../src/types/model.types.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,gBAAgB,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAA;AAEnE,MAAM,MAAM,WAAW,CAAC,CAAC,SAAS,KAAK,GAAG,KAAK,IAAI,CAAC,SAAS,KAAK,GAC9D,QAAQ,GACR,OAAO,GAAG,gBAAgB,CAAA"}

package/dist/types/system.types.d.ts

@@ -0,0 +1,40 @@
+export interface TaxonomyGroupMember {
+    id: string;
+    name: string;
+}
+export interface TaxonomyGroup {
+    id: string;
+    name: string;
+    members: Array<TaxonomyGroupMember>;
+}
+export interface TaxonomySchema {
+    groups: Array<TaxonomyGroup>;
+}
+export interface TaxonomyBinding {
+    path: Array<string>;
+    description?: string;
+    ref: string;
+    overrides?: Record<string, string>;
+    isExcluded?: boolean;
+}
+export interface SystemConfiguration {
+    schema: TaxonomySchema;
+    bindings?: Array<TaxonomyBinding>;
+}
+export interface SystemDataRef {
+    themeId: string;
+    shadeId: string | null;
+}
+export interface SystemDataToken {
+    path: Array<string>;
+    pathNames: Array<string>;
+    description?: string;
+    isExcluded: boolean;
+    refs: Array<SystemDataRef>;
+}
+export interface SystemData {
+    schema: TaxonomySchema;
+    tokens: Array<SystemDataToken>;
+    type: 'system';
+}
+//# sourceMappingURL=system.types.d.ts.map

package/dist/types/system.types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"system.types.d.ts","sourceRoot":"","sources":["../../src/types/system.types.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,mBAAmB;IAClC,EAAE,EAAE,MAAM,CAAA;IACV,IAAI,EAAE,MAAM,CAAA;CACb;AAED,MAAM,WAAW,aAAa;IAC5B,EAAE,EAAE,MAAM,CAAA;IACV,IAAI,EAAE,MAAM,CAAA;IACZ,OAAO,EAAE,KAAK,CAAC,mBAAmB,CAAC,CAAA;CACpC;AAED,MAAM,WAAW,cAAc;IAC7B,MAAM,EAAE,KAAK,CAAC,aAAa,CAAC,CAAA;CAC7B;AAED,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,KAAK,CAAC,MAAM,CAAC,CAAA;IACnB,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,GAAG,EAAE,MAAM,CAAA;IACX,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IAClC,UAAU,CAAC,EAAE,OAAO,CAAA;CACrB;AAED,MAAM,WAAW,mBAAmB;IAClC,MAAM,EAAE,cAAc,CAAA;IACtB,QAAQ,CAAC,EAAE,KAAK,CAAC,eAAe,CAAC,CAAA;CAClC;AAED,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,MAAM,CAAA;IACf,OAAO,EAAE,MAAM,GAAG,IAAI,CAAA;CACvB;AAED,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,KAAK,CAAC,MAAM,CAAC,CAAA;IACnB,SAAS,EAAE,KAAK,CAAC,MAAM,CAAC,CAAA;IACxB,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,UAAU,EAAE,OAAO,CAAA;IACnB,IAAI,EAAE,KAAK,CAAC,aAAa,CAAC,CAAA;CAC3B;AAED,MAAM,WAAW,UAAU;IACzB,MAAM,EAAE,cAAc,CAAA;IACtB,MAAM,EAAE,KAAK,CAAC,eAAe,CAAC,CAAA;IAC9B,IAAI,EAAE,QAAQ,CAAA;CACf"}

package/package.json

@@ -0,0 +1,65 @@
+{
+  "name": "@yelbolt/engine-ui-color-palette",
+  "private": false,
+  "version": "1.10.2",
+  "description": "Core utilities library for UI Color Palette - a color management plugin for design tools. This library provides the foundational color manipulation, contrast calculation, and palette generation features used in the plugin.",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/a-ng-d/engine-ui-color-palette.git"
+  },
+  "keywords": [
+    "color",
+    "contrast",
+    "wcag2",
+    "wcag3",
+    "apca"
+  ],
+  "author": "Aurélien Grimaud",
+  "license": "MIT",
+  "bugs": {
+    "url": "https://github.com/a-ng-d/engine-ui-color-palette/issues"
+  },
+  "homepage": "https://github.com/a-ng-d/engine-ui-color-palette#readme",
+  "type": "module",
+  "files": [
+    "dist"
+  ],
+  "exports": "./dist/index.js",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "scripts": {
+    "build": "tsc && vite build",
+    "test": "vitest",
+    "test:coverage": "vitest run --coverage",
+    "lint": "eslint . --ext ts,tsx --report-unused-disable-directives --max-warnings 0",
+    "lint:fix": "eslint . --ext ts,tsx --fix",
+    "format": "prettier --check .",
+    "format:fix": "prettier --write ."
+  },
+  "devDependencies": {
+    "@types/apca-w3": "^0.1.3",
+    "@types/chroma-js": "^3.1.1",
+    "@types/node": "^22.10.1",
+    "@typescript-eslint/eslint-plugin": "^7.2.0",
+    "@typescript-eslint/parser": "^7.2.0",
+    "@vitest/coverage-v8": "^3.1.4",
+    "dotenv-cli": "^7.4.2",
+    "eslint": "^8.57.0",
+    "eslint-config-prettier": "^9.1.0",
+    "eslint-plugin-import": "^2.31.0",
+    "glob": "^12.0.0",
+    "prettier": "^3.2.5",
+    "typescript": "^5.4.3",
+    "vite": "^6.3.5",
+    "vite-plugin-dts": "^5.0.0",
+    "vite-tsconfig-paths": "^4.3.2",
+    "vitest": "^3.1.4"
+  },
+  "dependencies": {
+    "@unoff/utils": "^0.8.2",
+    "apca-w3": "^0.1.9",
+    "chroma-js": "^2.4.2",
+    "hsluv": "^1.0.1",
+    "uid": "^2.0.2"
+  }
+}