@codeleap/styles 7.0.0 → 7.0.1

package/dist/tools/colors.js

@@ -0,0 +1,138 @@
+/**
+ * Expects a 7-character hex string (`#rrggbb`). Shorter forms (3-char, no hash) are
+ * not handled and will produce NaN channels. Returns h in [0, 360], s and l in [0, 100],
+ * all rounded to integers via `Math.round`.
+ */
+export function hexToHSL(hex) {
+    const r = parseInt(hex.slice(1, 3), 16) / 255;
+    const g = parseInt(hex.slice(3, 5), 16) / 255;
+    const b = parseInt(hex.slice(5, 7), 16) / 255;
+    const max = Math.max(r, g, b), min = Math.min(r, g, b);
+    let h = 0, s = 0, l = (max + min) / 2;
+    if (max !== min) {
+        const d = max - min;
+        s = l > 0.5 ? d / (2 - max - min) : d / (max + min);
+        switch (max) {
+            case r:
+                h = (g - b) / d + (g < b ? 6 : 0);
+                break;
+            case g:
+                h = (b - r) / d + 2;
+                break;
+            case b:
+                h = (r - g) / d + 4;
+                break;
+        }
+        h /= 6;
+    }
+    return {
+        h: Math.round(h * 360),
+        s: Math.round(s * 100),
+        l: Math.round(l * 100),
+    };
+}
+/**
+ * Uses the HSL-to-RGB CSS Color 4 formula (single-pass, no separate hue helper).
+ * Inputs h in [0, 360], s and l in [0, 100]; channels are clamped implicitly by
+ * `Math.min`/`Math.max`. Each channel is individually rounded before hex encoding,
+ * so the round-trip `hexToHSL → hslToHex` may differ by ±1 in the last hex digit.
+ */
+export function hslToHex(h, s, l) {
+    s /= 100;
+    l /= 100;
+    const k = (n) => (n + h / 30) % 12;
+    const a = s * Math.min(l, 1 - l);
+    const f = (n) => Math.round(255 * (l - a * Math.max(-1, Math.min(k(n) - 3, Math.min(9 - k(n), 1)))));
+    return `#${[f(0), f(8), f(4)].map(x => x.toString(16).padStart(2, '0')).join('')}`;
+}
+/**
+ * Parses only the 6-digit `#rrggbb` form via `parseInt(..., 16)`.
+ * No alpha channel is extracted. Channels are returned as integers in [0, 255].
+ */
+export function hexToRGB(hex) {
+    const r = parseInt(hex.slice(1, 3), 16);
+    const g = parseInt(hex.slice(3, 5), 16);
+    const b = parseInt(hex.slice(5, 7), 16);
+    return { r, g, b };
+}
+/**
+ * Shares the same formula as `hslToHex` but returns separate integer r/g/b channels
+ * instead of a hex string. Useful when you need numeric channels for `rgba(...)` output.
+ * Input ranges: h [0, 360], s [0, 100], l [0, 100].
+ */
+export function hslToRGB(h, s, l) {
+    s /= 100;
+    l /= 100;
+    const k = (n) => (n + h / 30) % 12;
+    const a = s * Math.min(l, 1 - l);
+    const f = (n) => Math.round(255 * (l - a * Math.max(-1, Math.min(k(n) - 3, Math.min(9 - k(n), 1)))));
+    return {
+        r: f(0),
+        g: f(8),
+        b: f(4),
+    };
+}
+/**
+ * Inverse of `hslToRGB`. Normalises each channel from [0, 255] to [0, 1] before
+ * computing. When max === min (achromatic), hue is fixed at 0. All output values are
+ * rounded, so the round-trip `hslToRGB → rgbToHSL` is not guaranteed to be lossless.
+ */
+export function rgbToHSL(rgb) {
+    const r = rgb.r / 255;
+    const g = rgb.g / 255;
+    const b = rgb.b / 255;
+    const max = Math.max(r, g, b);
+    const min = Math.min(r, g, b);
+    let h = 0;
+    let s = 0;
+    const l = (max + min) / 2;
+    if (max !== min) {
+        const d = max - min;
+        s = l > 0.5 ? d / (2 - max - min) : d / (max + min);
+        switch (max) {
+            case r:
+                h = (g - b) / d + (g < b ? 6 : 0);
+                break;
+            case g:
+                h = (b - r) / d + 2;
+                break;
+            case b:
+                h = (r - g) / d + 4;
+                break;
+        }
+        h /= 6;
+    }
+    return {
+        h: Math.round(h * 360),
+        s: Math.round(s * 100),
+        l: Math.round(l * 100)
+    };
+}
+/**
+ * Implements WCAG 2.x relative luminance (https://www.w3.org/TR/WCAG20/#relativeluminancedef).
+ * Channels are linearised with the sRGB transfer function: values ≤ 0.03928 use
+ * the linear segment (C / 12.92); values above use the gamma curve ((C + 0.055) / 1.055)^2.4.
+ * The luminance coefficients are 0.2126 R + 0.7152 G + 0.0722 B, reflecting the
+ * eye's greater sensitivity to green. Returns a value in [0, 1].
+ */
+export function getLuminance({ r, g, b }) {
+    const [R, G, B] = [r, g, b].map(c => {
+        const channel = c / 255;
+        return channel <= 0.03928
+            ? channel / 12.92
+            : Math.pow((channel + 0.055) / 1.055, 2.4);
+    });
+    return 0.2126 * R + 0.7152 * G + 0.0722 * B;
+}
+/**
+ * Uses a luminance threshold of **0.5** (not the WCAG 4.5:1 contrast ratio) to pick
+ * between two text colours. Backgrounds with luminance > 0.5 are treated as light and
+ * receive `darkColor`; all others receive `lightColor`. This is a perceptual shortcut —
+ * use explicit contrast-ratio checks for accessibility-critical situations.
+ */
+export function getTextColor(backgroundHex, darkColor = 'black', lightColor = 'white') {
+    const rgb = hexToRGB(backgroundHex);
+    const luminance = getLuminance(rgb);
+    return luminance > 0.5 ? darkColor : lightColor;
+}
+//# sourceMappingURL=colors.js.map

package/dist/tools/colors.js.map

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

package/dist/tools/deepClone.js

@@ -0,0 +1,8 @@
+import rfdc from 'rfdc';
+/**
+ * rfdc clone function configured with default options (no circular-reference support,
+ * proto: false). Does not handle `Date`, `RegExp`, or `Buffer` fields — they are copied
+ * by reference. Use only on plain style/theme objects.
+ */
+export const deepClone = rfdc();
+//# sourceMappingURL=deepClone.js.map

package/dist/tools/deepClone.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"deepClone.js","sourceRoot":"","sources":["../../src/tools/deepClone.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,MAAM,CAAA;AAEvB;;;;GAIG;AACH,MAAM,CAAC,MAAM,SAAS,GAAG,IAAI,EAAE,CAAA"}

package/dist/tools/deepmerge.js

@@ -0,0 +1,13 @@
+/**
+ * Re-exports `@fastify/deepmerge`'s factory function. Call it once with options
+ * (e.g., `deepmerge({ all: true })`) to obtain a variadic merge function.
+ * Passing `{ all: true }` merges arrays by index rather than concatenating them —
+ * this is the mode used throughout the style registry for variant merging.
+ * The returned merger is not idempotent: source properties always overwrite target.
+ *
+ * @example
+ * const merge = deepmerge({ all: true })
+ * const result = merge(base, override1, override2)
+ */
+export { default as deepmerge } from '@fastify/deepmerge';
+//# sourceMappingURL=deepmerge.js.map

package/dist/tools/deepmerge.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"deepmerge.js","sourceRoot":"","sources":["../../src/tools/deepmerge.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,OAAO,EAAE,OAAO,IAAI,SAAS,EAAE,MAAM,oBAAoB,CAAA"}

package/dist/tools/hashKey.js

@@ -0,0 +1,16 @@
+var _a;
+import { sha256 } from 'js-sha256';
+const styleKey = '@styles-version';
+const version = (_a = require('../../package.json')) === null || _a === void 0 ? void 0 : _a.version;
+/**
+ * Mutates the input array by appending `{ '@styles-version': <pkg.version> }` before
+ * hashing — meaning callers must not rely on the array being unchanged after the call.
+ * The version injection ensures any cache key computed against an older package version
+ * is automatically invalid after a library upgrade.
+ */
+export const hashKey = (value) => {
+    value.push({ [styleKey]: version });
+    const str = JSON.stringify(value);
+    return sha256(str);
+};
+//# sourceMappingURL=hashKey.js.map

package/dist/tools/hashKey.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hashKey.js","sourceRoot":"","sources":["../../src/tools/hashKey.ts"],"names":[],"mappings":";AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,WAAW,CAAA;AAElC,MAAM,QAAQ,GAAG,iBAAiB,CAAA;AAClC,MAAM,OAAO,GAAG,MAAA,OAAO,CAAC,oBAAoB,CAAC,0CAAE,OAAO,CAAA;AAEtD;;;;;GAKG;AACH,MAAM,CAAC,MAAM,OAAO,GAAG,CAAC,KAAiB,EAAU,EAAE;IACnD,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,QAAQ,CAAC,EAAE,OAAO,EAAE,CAAC,CAAA;IAEnC,MAAM,GAAG,GAAG,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAA;IAEjC,OAAO,MAAM,CAAC,GAAG,CAAC,CAAA;AACpB,CAAC,CAAA"}

package/dist/tools/index.js

@@ -0,0 +1,7 @@
+export * as colorTools from './colors';
+export * from './hashKey';
+export * from './minifier';
+export * from './multiplierProperty';
+export * from './deepClone';
+export * from './deepmerge';
+//# sourceMappingURL=index.js.map

package/dist/tools/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/tools/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,UAAU,MAAM,UAAU,CAAA;AACtC,cAAc,WAAW,CAAA;AACzB,cAAc,YAAY,CAAA;AAC1B,cAAc,sBAAsB,CAAA;AACpC,cAAc,aAAa,CAAA;AAC3B,cAAc,aAAa,CAAA"}

package/dist/tools/minifier.js

@@ -0,0 +1,34 @@
+import { compressToBase64, decompressFromBase64 } from 'lz-string';
+/**
+ * Serialises `value` with `JSON.stringify` then LZ-compresses to a Base64 string.
+ * Returns the value unchanged (without throwing) when it is falsy, so callers
+ * do not need to guard against `null`/`undefined`/`''` inputs.
+ * Non-serialisable values (functions, `undefined` inside objects, circular refs)
+ * will be silently dropped by `JSON.stringify`.
+ */
+export function compress(value) {
+    if (!value)
+        return value;
+    return compressToBase64(JSON.stringify(value));
+}
+/**
+ * Reverses `compress`: LZ-decompresses the Base64 string then parses the JSON.
+ * Returns the value unchanged when falsy. Will throw if `value` is a non-empty
+ * string that is not valid LZ-Base64, or if the decompressed payload is not
+ * valid JSON — callers should guard accordingly.
+ */
+export function decompress(value) {
+    if (!value)
+        return value;
+    const decoded = decompressFromBase64(value);
+    return JSON.parse(decoded);
+}
+/**
+ * Convenience namespace so callsites can import a single symbol and call
+ * `minifier.compress` / `minifier.decompress` without named imports.
+ */
+export const minifier = {
+    compress,
+    decompress,
+};
+//# sourceMappingURL=minifier.js.map

package/dist/tools/minifier.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"minifier.js","sourceRoot":"","sources":["../../src/tools/minifier.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,oBAAoB,EAAE,MAAM,WAAW,CAAA;AAElE;;;;;;GAMG;AACH,MAAM,UAAU,QAAQ,CAAC,KAAU;IACjC,IAAI,CAAC,KAAK;QAAE,OAAO,KAAK,CAAA;IAExB,OAAO,gBAAgB,CAAC,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,CAAA;AAChD,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,UAAU,CAAC,KAAU;IACnC,IAAI,CAAC,KAAK;QAAE,OAAO,KAAK,CAAA;IAExB,MAAM,OAAO,GAAG,oBAAoB,CAAC,KAAK,CAAC,CAAA;IAE3C,OAAO,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAA;AAC5B,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,MAAM,QAAQ,GAAG;IACtB,QAAQ;IACR,UAAU;CACX,CAAA"}

package/dist/tools/multiplierProperty.js

@@ -0,0 +1,9 @@
+export function multiplierProperty(base, property) {
+    return (multiplier) => {
+        const value = base * Number(multiplier);
+        return {
+            [property]: value,
+        };
+    };
+}
+//# sourceMappingURL=multiplierProperty.js.map

package/dist/tools/multiplierProperty.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"multiplierProperty.js","sourceRoot":"","sources":["../../src/tools/multiplierProperty.ts"],"names":[],"mappings":"AACA,MAAM,UAAU,kBAAkB,CAChC,IAAY,EACZ,QAAW;IAEX,OAAO,CAAC,UAA2B,EAAE,EAAE;QACrC,MAAM,KAAK,GAAG,IAAI,GAAG,MAAM,CAAC,UAAU,CAAC,CAAA;QAEvC,OAAO;YACL,CAAC,QAAQ,CAAC,EAAE,KAAK;SAClB,CAAA;IACH,CAAC,CAAA;AACH,CAAC"}

package/dist/types/cache.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=cache.js.map

package/dist/types/cache.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cache.js","sourceRoot":"","sources":["../../src/types/cache.ts"],"names":[],"mappings":""}

package/dist/types/component.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=component.js.map

package/dist/types/component.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"component.js","sourceRoot":"","sources":["../../src/types/component.ts"],"names":[],"mappings":""}

package/dist/types/core.js

@@ -0,0 +1,3 @@
+/* eslint-disable @typescript-eslint/no-empty-interface */
+export {};
+//# sourceMappingURL=core.js.map

package/dist/types/core.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"core.js","sourceRoot":"","sources":["../../src/types/core.ts"],"names":[],"mappings":"AAAA,0DAA0D"}

package/dist/types/icon.js

@@ -0,0 +1,3 @@
+/* eslint-disable @typescript-eslint/no-empty-interface */
+export {};
+//# sourceMappingURL=icon.js.map

package/dist/types/icon.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"icon.js","sourceRoot":"","sources":["../../src/types/icon.ts"],"names":[],"mappings":"AAAA,0DAA0D"}

package/dist/types/index.js

@@ -0,0 +1,6 @@
+export * from './core';
+export * from './style';
+export * from './theme';
+export * from './icon';
+export * from './component';
+//# sourceMappingURL=index.js.map

package/dist/types/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":"AAAA,cAAc,QAAQ,CAAA;AACtB,cAAc,SAAS,CAAA;AACvB,cAAc,SAAS,CAAA;AACvB,cAAc,QAAQ,CAAA;AACtB,cAAc,aAAa,CAAA"}

package/dist/types/spacing.js

@@ -0,0 +1,28 @@
+/**
+ * Long-form spacing direction suffixes used with `margin` and `padding`.
+ * The empty string `''` represents the un-suffixed property (e.g., `padding`).
+ */
+export const spacingVariants = [
+    'Vertical',
+    'Horizontal',
+    'Bottom',
+    'Top',
+    'Left',
+    'Right',
+    '',
+];
+/**
+ * Short-form spacing direction suffixes used with `m` and `p`.
+ * Maps to the long-form via `shortPositionMap` inside `spacingFactory`.
+ * The empty string `''` represents the un-suffixed property (e.g., `p`).
+ */
+export const spacingShortVariants = [
+    'y',
+    'x',
+    'b',
+    't',
+    'l',
+    'r',
+    '',
+];
+//# sourceMappingURL=spacing.js.map

package/dist/types/spacing.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"spacing.js","sourceRoot":"","sources":["../../src/types/spacing.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,CAAC,MAAM,eAAe,GAAG;IAC7B,UAAU;IACV,YAAY;IACZ,QAAQ;IACR,KAAK;IACL,MAAM;IACN,OAAO;IACP,EAAE;CACM,CAAA;AAEV;;;;GAIG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAG;IAClC,GAAG;IACH,GAAG;IACH,GAAG;IACH,GAAG;IACH,GAAG;IACH,GAAG;IACH,EAAE;CACM,CAAA"}

package/dist/types/store.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=store.js.map

package/dist/types/store.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"store.js","sourceRoot":"","sources":["../../src/types/store.ts"],"names":[],"mappings":""}

package/dist/types/style.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=style.js.map

package/dist/types/style.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"style.js","sourceRoot":"","sources":["../../src/types/style.ts"],"names":[],"mappings":""}

package/dist/types/theme.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=theme.js.map

package/dist/types/theme.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"theme.js","sourceRoot":"","sources":["../../src/types/theme.ts"],"names":[],"mappings":""}

package/dist/utils.js

@@ -0,0 +1,97 @@
+import { spacingShortVariants, spacingVariants } from './types/spacing';
+import { deepmerge } from './tools';
+/**
+ * Uppercases (or lowercases when `reverse = true`) the first character of a string.
+ * Returns the input unchanged when it is falsy or empty.
+ */
+export function capitalize(str, reverse = false) {
+    if (!(str === null || str === void 0 ? void 0 : str.length))
+        return str;
+    const firstChar = reverse ? str[0].toLowerCase() : str[0].toUpperCase();
+    return firstChar + str.substring(1);
+}
+/**
+ * Complete list of CSS/RN spacing-related property names that the style registry treats
+ * specially (resolved via the spacing factory rather than passed through as raw ICSS).
+ * Built eagerly at module load time by iterating `spacingVariants` and `spacingShortVariants`.
+ */
+export const spacingKeys = [
+    'gap',
+    'top',
+    'left',
+    'right',
+    'bottom',
+];
+for (const longProperty of ['padding', 'margin']) {
+    for (const variant of spacingVariants) {
+        spacingKeys.push(`${longProperty}${capitalize(variant)}`);
+    }
+}
+for (const shortProperty of ['p', 'm']) {
+    for (const shortVariant of spacingShortVariants) {
+        spacingKeys.push(shortProperty + shortVariant);
+    }
+}
+/** Returns `true` if `key` is one of the pre-built spacing property names. */
+export function isSpacingKey(key) {
+    if (!key)
+        return false;
+    return spacingKeys === null || spacingKeys === void 0 ? void 0 : spacingKeys.includes(key);
+}
+/**
+ * Extracts all entries whose key starts with `match`, stripping the prefix and
+ * lowercasing the first character of the remainder. Used by composition hooks to
+ * slice a flat `{ wrapperText: ..., wrapperIcon: ... }` record into a nested
+ * `{ text: ..., icon: ... }` map for a single composition element.
+ */
+export function getNestedStylesByKey(match, styles) {
+    const stylesByKey = {};
+    for (const [key, value] of Object.entries(styles)) {
+        if (key.startsWith(match)) {
+            const partName = capitalize(key.replace(match, ''), true);
+            stylesByKey[partName] = value;
+        }
+    }
+    return stylesByKey;
+}
+/**
+ * Merges an array of style objects into one using `@fastify/deepmerge` with `all: true`.
+ * Falsy entries are filtered out before merging. Later entries overwrite earlier ones.
+ */
+export const mergeStyles = (styles) => {
+    const style = styles === null || styles === void 0 ? void 0 : styles.filter(s => !!s);
+    return deepmerge({ all: true })(...style);
+};
+/**
+ * Style property names that collide with CSS keywords and must not be treated as
+ * composition-element prefixes by the registry. Without this list, a style object
+ * like `{ textAlign: 'center' }` would be misidentified as a composition key starting
+ * with `text`.
+ */
+export const ignoredStyleKeys = [
+    'textAlign',
+    'textDecoration',
+    'textOverflow',
+    'left',
+    'top',
+    'right',
+    'bottom',
+];
+/**
+ * Flattens nested arrays of `StyledProp` into a single flat array. Useful when
+ * assembling the final `style` prop from multiple sources (e.g., variant defaults
+ * plus overrides), without losing the order-dependent merge semantics of `StyleProp`.
+ */
+export const concatStyles = (styles) => {
+    const results = [];
+    for (const style of styles) {
+        if (Array.isArray(style)) {
+            results.push(...style);
+        }
+        else {
+            results.push(style);
+        }
+    }
+    return results;
+};
+//# sourceMappingURL=utils.js.map

package/dist/utils.js.map

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

package/dist/variants/borderCreator.js

@@ -0,0 +1,26 @@
+import { themeStore } from '../theme';
+import { capitalize } from '../utils';
+/**
+ * Resolves `color` from `theme.colors` (falls back to the raw string if not found),
+ * then emits `border{Direction}Color`, `border{Direction}Width`, and — on web only —
+ * `border{Direction}Style` for each requested direction.
+ * Defaults: all four sides, width 1, style `'solid'`.
+ * `borderStyle` is omitted on React Native because RN requires it on individual sides
+ * and `isBrowser` guards that path.
+ */
+export const borderCreator = (args) => {
+    var _a, _b;
+    const { color: colorKey, width = 1, style = 'solid', directions = ['left', 'top', 'bottom', 'right'], } = args;
+    const theme = themeStore.themeTyped;
+    const color = (_b = (_a = theme === null || theme === void 0 ? void 0 : theme.colors) === null || _a === void 0 ? void 0 : _a[colorKey]) !== null && _b !== void 0 ? _b : colorKey;
+    let borderStyles = {};
+    for (const direction of directions) {
+        const property = `border${capitalize(direction)}`;
+        borderStyles[`${property}Color`] = color;
+        borderStyles[`${property}Width`] = width;
+        if (theme === null || theme === void 0 ? void 0 : theme.isBrowser)
+            borderStyles[`${property}Style`] = style;
+    }
+    return borderStyles;
+};
+//# sourceMappingURL=borderCreator.js.map

package/dist/variants/borderCreator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"borderCreator.js","sourceRoot":"","sources":["../../src/variants/borderCreator.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,UAAU,EAAE,MAAM,UAAU,CAAA;AACrC,OAAO,EAAE,UAAU,EAAE,MAAM,UAAU,CAAA;AAarC;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,aAAa,GAAkB,CAAC,IAAI,EAAE,EAAE;;IACnD,MAAM,EACJ,KAAK,EAAE,QAAQ,EACf,KAAK,GAAG,CAAC,EACT,KAAK,GAAG,OAAO,EACf,UAAU,GAAG,CAAC,MAAM,EAAE,KAAK,EAAE,QAAQ,EAAE,OAAO,CAAC,GAChD,GAAG,IAAI,CAAA;IAER,MAAM,KAAK,GAAG,UAAU,CAAC,UAAU,CAAA;IAEnC,MAAM,KAAK,GAAG,MAAA,MAAC,KAAK,aAAL,KAAK,uBAAL,KAAK,CAAE,MAA8B,0CAAG,QAAQ,CAAC,mCAAI,QAAQ,CAAA;IAE5E,IAAI,YAAY,GAAwB,EAAE,CAAA;IAE1C,KAAK,MAAM,SAAS,IAAI,UAAU,EAAE,CAAC;QACnC,MAAM,QAAQ,GAAG,SAAS,UAAU,CAAC,SAAS,CAAC,EAAE,CAAA;QAEjD,YAAY,CAAC,GAAG,QAAQ,OAAO,CAAC,GAAG,KAAK,CAAA;QACxC,YAAY,CAAC,GAAG,QAAQ,OAAO,CAAC,GAAG,KAAK,CAAA;QACxC,IAAI,KAAK,aAAL,KAAK,uBAAL,KAAK,CAAE,SAAS;YAAE,YAAY,CAAC,GAAG,QAAQ,OAAO,CAAC,GAAG,KAAK,CAAA;IAChE,CAAC;IAED,OAAO,YAAoB,CAAA;AAC7B,CAAC,CAAA"}

package/dist/variants/createAppVariants.js

@@ -0,0 +1,17 @@
+import { themeStore } from '../theme';
+/**
+ * Registers app-specific style variants with the global `themeStore`.
+ * Call this once during app initialisation (before any component mounts) with the
+ * variants object that extends the base variant set. The variants are merged into
+ * `commonVariants` when `CodeleapStyleRegistry` initialises.
+ *
+ * Each entry can be either a static `ICSS` object (applied unconditionally) or a
+ * function `(theme: ITheme) => ICSS` (resolved lazily using the current theme).
+ *
+ * @returns The same `variants` object — useful for typing augmentation of `IAppVariants`.
+ */
+export function createAppVariants(variants) {
+    themeStore.setVariants(variants);
+    return variants;
+}
+//# sourceMappingURL=createAppVariants.js.map

package/dist/variants/createAppVariants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"createAppVariants.js","sourceRoot":"","sources":["../../src/variants/createAppVariants.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,UAAU,EAAE,MAAM,UAAU,CAAA;AAMrC;;;;;;;;;;GAUG;AACH,MAAM,UAAU,iBAAiB,CAA2B,QAAW;IACrE,UAAU,CAAC,WAAW,CAAC,QAAQ,CAAC,CAAA;IAEhC,OAAO,QAAQ,CAAA;AACjB,CAAC"}