@codeleap/styles 6.3.0 → 7.0.0

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

@@ -0,0 +1 @@
+{"version":3,"file":"store.d.ts","sourceRoot":"","sources":["../../src/types/store.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,GAAG,GAAG,IAAI,CAAA;IACrC,OAAO,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,GAAG,KAAK,IAAI,CAAA;IAC3C,UAAU,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAA;CACnC"}

package/dist/types/style.d.ts

@@ -0,0 +1,42 @@
+import { DynamicVariants } from '../variants/dynamicVariants';
+import { DefaultVariants } from '../variants/defaultVariants';
+import { IAppVariants, IBreakpoints, ICSS, IEffects, ITheme } from './core';
+import { Multiplier, Spacing } from './spacing';
+type Inset = `top:${Multiplier}` | `bottom:${Multiplier}` | `left:${Multiplier}` | `right:${Multiplier}`;
+/**
+ * Union of all built-in variant string literals accepted anywhere a style variant
+ * name is valid: spacing shorthands, inset offsets, dynamic token variants (color,
+ * border, cursor, etc.), the static `defaultVariants` keys, app-defined variants,
+ * and named effect tokens.
+ */
+export type CommonVariants = Spacing | Inset | DynamicVariants | keyof DefaultVariants | keyof IAppVariants | `effect:${keyof IEffects}`;
+type StyleAtom<Composition extends string = string, Variants = string, HasBreakpoints = string, HasComposition = string> = ICSS | Variants | CommonVariants | boolean | null | undefined | '' | (HasBreakpoints extends string ? {
+    'breakpoints': Partial<Record<keyof IBreakpoints, StyleAtom<Composition, Variants, boolean, string> | StyleAtom<Composition, Variants, boolean, string>[]>>;
+} : null) | (HasComposition extends string ? Partial<Record<Composition, StyleAtom<Composition, Variants, boolean, boolean> | StyleAtom<Composition, Variants, boolean, boolean>[]>> : null) | Array<Variants | ICSS | Partial<Record<Composition, StyleAtom<Composition, Variants, boolean, boolean> | StyleAtom<Composition, Variants, boolean, boolean>[]>>>;
+/**
+ * The value accepted by any component's `style` prop. Supports:
+ * - A raw `ICSS` object applied to the root element.
+ * - A variant string (or array of strings) resolved through the registry.
+ * - A composition object mapping sub-element names to their own `StyleAtom`.
+ * - A `{ breakpoints: { [key]: StyleAtom } }` object for responsive overrides.
+ * - An array mixing any of the above — processed left-to-right, last write wins.
+ */
+export type StyleProp<Composition extends string = string, Variants = string> = StyleAtom<Composition, Variants> | StyleAtom<Composition, Variants>[];
+/**
+ * Loosely typed variant stylesheet — a record mapping variant names to their style
+ * definitions. Used as the input to `createStyles` and `registerVariants`.
+ */
+export type VariantStyleSheet = Record<string, any>;
+/** Alias for `StyleProp<T>` scoped to a specific set of composition keys. */
+export type StyledProp<T extends string> = StyleProp<T>;
+/**
+ * Post-processing function that receives the merged theme and fully resolved variant
+ * styles and returns a (potentially transformed) style record. Useful for injecting
+ * cross-variant logic such as conditional overrides that depend on multiple variant
+ * states simultaneously.
+ */
+export type StyleAggregator<T extends string = any> = (theme: ITheme, style: Record<T, ICSS>) => Record<T, ICSS>;
+/** Typed record mapping composition/element keys to their resolved `ICSS` values. */
+export type StyleRecord<K extends string> = Record<K, ICSS>;
+export {};
+//# sourceMappingURL=style.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"style.d.ts","sourceRoot":"","sources":["../../src/types/style.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,6BAA6B,CAAA;AAE7D,OAAO,EAAE,eAAe,EAAE,MAAM,6BAA6B,CAAA;AAC7D,OAAO,EAAa,YAAY,EAAE,YAAY,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAA;AACtF,OAAO,EAAE,UAAU,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AAE/C,KAAK,KAAK,GACN,OAAO,UAAU,EAAE,GACnB,UAAU,UAAU,EAAE,GACtB,QAAQ,UAAU,EAAE,GACpB,SAAS,UAAU,EAAE,CAAA;AAEzB;;;;;GAKG;AACH,MAAM,MAAM,cAAc,GACxB,OAAO,GACP,KAAK,GACL,eAAe,GACf,MAAM,eAAe,GACrB,MAAM,YAAY,GAClB,UAAU,MAAM,QAAQ,EAAE,CAAA;AAE5B,KAAK,SAAS,CAAC,WAAW,SAAS,MAAM,GAAG,MAAM,EAAE,QAAQ,GAAG,MAAM,EAAE,cAAc,GAAG,MAAM,EAAE,cAAc,GAAG,MAAM,IACrH,IAAI,GACJ,QAAQ,GACR,cAAc,GACd,OAAO,GACP,IAAI,GACJ,SAAS,GACT,EAAE,GAEF,CAAC,cAAc,SAAS,MAAM,GAAG;IAC/B,aAAa,EAAE,OAAO,CACpB,MAAM,CAAC,MAAM,YAAY,EACvB,SAAS,CAAC,WAAW,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,CAAC,GACjD,SAAS,CAAC,WAAW,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,CAAC,EAAE,CAAC,CACrD,CAAA;CACJ,GAAG,IAAI,CAAC,GACT,CAAC,cAAc,SAAS,MAAM,GAC1B,OAAO,CAAC,MAAM,CACZ,WAAW,EACX,SAAS,CAAC,WAAW,EAAE,QAAQ,EAAE,OAAO,EAAE,OAAO,CAAC,GAClD,SAAS,CAAC,WAAW,EAAE,QAAQ,EAAE,OAAO,EAAE,OAAO,CAAC,EAAE,CACrD,CAAC,GACA,IAAI,CACT,GACC,KAAK,CAAC,QAAQ,GAAG,IAAI,GAAG,OAAO,CAC/B,MAAM,CACJ,WAAW,EACX,SAAS,CAAC,WAAW,EAAE,QAAQ,EAAE,OAAO,EAAE,OAAO,CAAC,GAClD,SAAS,CAAC,WAAW,EAAE,QAAQ,EAAE,OAAO,EAAE,OAAO,CAAC,EAAE,CACrD,CACF,CAAC,CAAA;AAEJ;;;;;;;GAOG;AACH,MAAM,MAAM,SAAS,CACnB,WAAW,SAAS,MAAM,GAAG,MAAM,EACnC,QAAQ,GAAG,MAAM,IACf,SAAS,CAAC,WAAW,EAAE,QAAQ,CAAC,GAAG,SAAS,CAAC,WAAW,EAAE,QAAQ,CAAC,EAAE,CAAA;AAEzE;;;GAGG;AACH,MAAM,MAAM,iBAAiB,GAAG,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAA;AAEnD,6EAA6E;AAC7E,MAAM,MAAM,UAAU,CAAC,CAAC,SAAS,MAAM,IAAI,SAAS,CAAC,CAAC,CAAC,CAAA;AAEvD;;;;;GAKG;AACH,MAAM,MAAM,eAAe,CAAC,CAAC,SAAS,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,CAAE,CAAC,EAAE,IAAI,CAAC,KAAK,MAAM,CAAE,CAAC,EAAE,IAAI,CAAC,CAAA;AAElH,qFAAqF;AACrF,MAAM,MAAM,WAAW,CAAC,CAAC,SAAS,MAAM,IAAI,MAAM,CAAC,CAAC,EAAE,IAAI,CAAC,CAAA"}

package/dist/types/theme.d.ts

@@ -0,0 +1,109 @@
+import { BorderCreator } from '../variants/borderCreator';
+import { MediaQueries } from '../variants/mediaQuery';
+import type { DefaultVariants } from '../variants/defaultVariants';
+import { MultiplierFunction, Spacings } from '../variants/spacing';
+import { ICSS, IEffect } from './core';
+type AnyMap = {
+    [key: string]: any;
+};
+/**
+ * Flat or nested color token map passed to `createTheme`.
+ * This type is intentionally empty so that `validateTheme` and the CSS-var
+ * machinery can accept any shape; strong typing comes via `IColors` augmentation.
+ */
+export type ColorMap = {};
+/**
+ * Maps breakpoint names to pixel widths. Used by `createMediaQueries` to generate
+ * `@media screen and (min/max-width: <N>px)` strings. Breakpoints not in this map
+ * fall back to `Infinity` (treated as unbounded).
+ */
+type BreakpointMap = {
+    [key: string]: number;
+};
+/** Map of named effect tokens (shadows, filters, etc.) to their effect shapes. */
+type EffectsMap = {
+    [key: string]: IEffect;
+};
+/**
+ * The full spacing API attached to every `AppTheme`. Combines the long-form
+ * (`margin`, `padding` with variant suffixes) and short-form (`m`, `p`) factories,
+ * plus `gap`. Each property is a `MultiplierFunction` that scales by `baseSpacing`.
+ */
+export type SpacingMap = Spacings<'margin'> & Spacings<'padding'> & Spacings<'m', string> & Spacings<'p', string> & {
+    gap: MultiplierFunction;
+};
+/**
+ * Position-offset functions (`top`, `bottom`, `left`, `right`) attached to `AppTheme`.
+ * Each function multiplies its argument by `baseSpacing` and returns an `ICSS` object.
+ */
+export type InsetMap = {
+    bottom: MultiplierFunction;
+    top: MultiplierFunction;
+    left: MultiplierFunction;
+    right: MultiplierFunction;
+};
+/**
+ * Raw theme definition passed to `createTheme`. After processing, the resolved object
+ * is an `AppTheme<T>` with additional runtime methods (`setColorScheme`, `spacing`, etc.).
+ *
+ * - `baseColors` — primitive palette tokens merged into both `colors` and every alternate scheme.
+ * - `colors` — semantic/alias tokens for the default color scheme.
+ * - `alternateColors` — named overrides; each must supply all keys present in `colors`.
+ * - `baseSpacing` — the multiplier used by spacing/inset factories (default: 1).
+ * - `isBrowser` — when `true`, enables CSS custom-property mode for colors and browser-only styles.
+ */
+export type Theme = {
+    baseColors: ColorMap;
+    colors: ColorMap;
+    alternateColors?: {
+        [key: string]: ColorMap;
+    };
+    breakpoints?: BreakpointMap;
+    baseSpacing?: number;
+    presets?: AnyMap;
+    radius?: AnyMap;
+    stroke?: AnyMap;
+    size?: AnyMap;
+    effects?: EffectsMap;
+    typography: AnyMap;
+    icons: AnyMap;
+    values?: AnyMap;
+    isBrowser?: boolean;
+};
+/** The reserved name for the primary (non-alternate) color scheme. */
+export type DefaultColorSchemeName = 'default';
+/** Union of `'default'` and all keys defined in `T['alternateColors']`. */
+export type ColorScheme<T extends Theme = Theme> = DefaultColorSchemeName | keyof T['alternateColors'];
+type PredefinedThemeDerivedValues<T extends Theme> = {
+    baseColors: T['baseColors'];
+    colors: T['colors'];
+    breakpoints: T['breakpoints'];
+    presets: DefaultVariants & T['presets'];
+    radius: T['radius'];
+    stroke: T['stroke'];
+    size: T['size'];
+    effects: T['effects'];
+    typography: T['typography'];
+    icons: T['icons'];
+    values: T['values'];
+};
+type PredefinedAppTheme<T extends Theme> = PredefinedThemeDerivedValues<T> & {
+    setColorScheme: (colorScheme: string) => void;
+    currentColorScheme: () => ColorScheme<T>;
+    injectColorScheme: (name: string, colorMap: ColorMap) => void;
+    ejectColorScheme: (name: string) => void;
+    getCssVariables: (schemeName?: string) => Record<string, string>;
+    currentSchemeColors: T['colors'];
+    spacing: SpacingMap;
+    media: MediaQueries;
+    border: BorderCreator;
+    inset: InsetMap;
+    baseSpacing: number;
+    value: (multiplier: number) => number;
+    sized: (size: number | string) => ICSS;
+};
+export type AppTheme<T extends Theme> = PredefinedAppTheme<T> & {
+    [P in Exclude<keyof T, keyof PredefinedThemeDerivedValues<T>>]: T[P];
+};
+export {};
+//# sourceMappingURL=theme.d.ts.map

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

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

package/dist/utils.d.ts

@@ -0,0 +1,40 @@
+import { ICSS, StyledProp } from './types';
+/**
+ * Uppercases (or lowercases when `reverse = true`) the first character of a string.
+ * Returns the input unchanged when it is falsy or empty.
+ */
+export declare function capitalize(str: string, reverse?: boolean): string;
+/**
+ * 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 declare const spacingKeys: string[];
+/** Returns `true` if `key` is one of the pre-built spacing property names. */
+export declare function isSpacingKey(key: string): boolean;
+/**
+ * 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 declare function getNestedStylesByKey<T extends string>(match: string, styles: Partial<Record<T, ICSS>>): Record<string, any>;
+/**
+ * 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 declare const mergeStyles: (styles: Array<any>) => {};
+/**
+ * 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 declare const ignoredStyleKeys: string[];
+/**
+ * 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 declare const concatStyles: <T extends string>(styles: Array<StyledProp<T>>) => StyledProp<T>;
+//# sourceMappingURL=utils.d.ts.map

package/dist/utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../src/utils.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,UAAU,EAAE,MAAM,SAAS,CAAA;AAI1C;;;GAGG;AACH,wBAAgB,UAAU,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,UAAQ,UAItD;AAED;;;;GAIG;AACH,eAAO,MAAM,WAAW,UAMvB,CAAA;AAcD,8EAA8E;AAC9E,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,WAIvC;AAED;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAAC,CAAC,SAAS,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC,uBAWrG;AAED;;;GAGG;AACH,eAAO,MAAM,WAAW,GAAI,QAAQ,KAAK,CAAC,GAAG,CAAC,OAI7C,CAAA;AAED;;;;;GAKG;AACH,eAAO,MAAM,gBAAgB,UAQ5B,CAAA;AAED;;;;GAIG;AACH,eAAO,MAAM,YAAY,GAAI,CAAC,SAAS,MAAM,EAAE,QAAQ,KAAK,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,KAAG,UAAU,CAAC,CAAC,CAYzF,CAAA"}

package/dist/variants/borderCreator.d.ts

@@ -0,0 +1,22 @@
+import { IColors, ICSS } from '../types';
+import { borderDirection } from './dynamicVariants';
+/** Arguments for `borderCreator`. */
+type BorderCreatorArgs = {
+    color: keyof IColors | (string & {});
+    width?: number | string;
+    directions?: typeof borderDirection[number][];
+    style?: "dashed" | "dotted" | "double" | "groove" | "hidden" | "inset" | "none" | "outset" | "ridge" | "solid";
+};
+/** Function signature of the `border` helper attached to `AppTheme`. */
+export type BorderCreator = (args: BorderCreatorArgs) => ICSS;
+/**
+ * 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 declare const borderCreator: BorderCreator;
+export {};
+//# sourceMappingURL=borderCreator.d.ts.map

package/dist/variants/borderCreator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"borderCreator.d.ts","sourceRoot":"","sources":["../../src/variants/borderCreator.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,UAAU,CAAA;AACxC,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAA;AAInD,qCAAqC;AACrC,KAAK,iBAAiB,GAAG;IACvB,KAAK,EAAE,MAAM,OAAO,GAAG,CAAC,MAAM,GAAG,EAAE,CAAC,CAAA;IACpC,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM,CAAA;IACvB,UAAU,CAAC,EAAE,OAAO,eAAe,CAAC,MAAM,CAAC,EAAE,CAAA;IAC7C,KAAK,CAAC,EAAE,QAAQ,GAAG,QAAQ,GAAG,QAAQ,GAAG,QAAQ,GAAG,QAAQ,GAAG,OAAO,GAAG,MAAM,GAAG,QAAQ,GAAG,OAAO,GAAG,OAAO,CAAC;CAChH,CAAA;AAED,wEAAwE;AACxE,MAAM,MAAM,aAAa,GAAG,CAAC,IAAI,EAAE,iBAAiB,KAAK,IAAI,CAAA;AAE7D;;;;;;;GAOG;AACH,eAAO,MAAM,aAAa,EAAE,aAuB3B,CAAA"}

package/dist/variants/createAppVariants.d.ts

@@ -0,0 +1,18 @@
+import { ICSS, ITheme } from '../types';
+type AppVariantsMap = {
+    [x: string]: ICSS | ((theme: ITheme) => ICSS);
+};
+/**
+ * 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 declare function createAppVariants<T extends AppVariantsMap>(variants: T): T;
+export {};
+//# sourceMappingURL=createAppVariants.d.ts.map

package/dist/variants/createAppVariants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"createAppVariants.d.ts","sourceRoot":"","sources":["../../src/variants/createAppVariants.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,UAAU,CAAA;AAGvC,KAAK,cAAc,GAAG;IACpB,CAAC,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,CAAC,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC,CAAA;CAC9C,CAAA;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,iBAAiB,CAAC,CAAC,SAAS,cAAc,EAAE,QAAQ,EAAE,CAAC,KAItE"}

package/dist/variants/defaultVariants.d.ts

@@ -0,0 +1,140 @@
+import { ICSS } from '../types';
+/**
+ * Static built-in style variants available to every component without any registration.
+ * These are merged as the lowest-priority layer in `commonVariants`, so app-defined
+ * variants and dynamic variants can override them.
+ *
+ * Notable entries:
+ * - `grow` — sets `flex: 1` (not `display: flex`; use `row`/`column` for flex containers).
+ * - `inset` — shorthand for `{ top:0, bottom:0, left:0, right:0 }` (useful with `absolute`).
+ * - `insetX` / `insetY` — pin to horizontal or vertical edges only.
+ * - `centerChildren` — centers children via `alignItems`/`justifyContent`; requires a flex container.
+ * - `'visibility:hidden'` / `'display:none'` — use quoted keys in style arrays.
+ */
+export declare const defaultVariants: {
+    readonly block: {
+        readonly display: "block";
+    };
+    readonly grow: {
+        readonly flex: 1;
+    };
+    readonly absolute: {
+        readonly position: "absolute";
+    };
+    readonly relative: {
+        readonly position: "relative";
+    };
+    readonly fixed: {
+        readonly position: "fixed";
+    };
+    readonly sticky: {
+        readonly position: "sticky";
+    };
+    readonly insetX: {
+        readonly left: 0;
+        readonly right: 0;
+    };
+    readonly insetY: {
+        readonly top: 0;
+        readonly bottom: 0;
+    };
+    readonly full: {
+        readonly width: "100%";
+        readonly height: "100%";
+    };
+    readonly noWrap: {
+        readonly whiteSpace: "nowrap";
+    };
+    readonly fullWidth: {
+        readonly width: "100%";
+    };
+    readonly fullHeight: {
+        readonly height: "100%";
+    };
+    readonly inset: {
+        readonly top: 0;
+        readonly bottom: 0;
+        readonly left: 0;
+        readonly right: 0;
+    };
+    readonly centerRow: {
+        readonly display: "flex";
+        readonly flexDirection: "row";
+        readonly alignItems: "center";
+    };
+    readonly row: {
+        readonly display: "flex";
+        readonly flexDirection: "row";
+    };
+    readonly column: {
+        readonly display: "flex";
+        readonly flexDirection: "column";
+    };
+    readonly centerChildren: {
+        readonly alignItems: "center";
+        readonly justifyContent: "center";
+    };
+    readonly alignStart: {
+        readonly alignItems: "flex-start";
+    };
+    readonly alignEnd: {
+        readonly alignItems: "flex-end";
+    };
+    readonly alignCenter: {
+        readonly alignItems: "center";
+    };
+    readonly alignStretch: {
+        readonly alignItems: "stretch";
+    };
+    readonly alignSelfCenter: {
+        readonly alignSelf: "center";
+    };
+    readonly alignSelfStart: {
+        readonly alignSelf: "flex-start";
+    };
+    readonly alignSelfStretch: {
+        readonly alignSelf: "stretch";
+    };
+    readonly alignSelfEnd: {
+        readonly alignSelf: "flex-end";
+    };
+    readonly justifyStart: {
+        readonly justifyContent: "flex-start";
+    };
+    readonly justifyEnd: {
+        readonly justifyContent: "flex-end";
+    };
+    readonly justifyCenter: {
+        readonly justifyContent: "center";
+    };
+    readonly justifySpaceBetween: {
+        readonly justifyContent: "space-between";
+    };
+    readonly justifySpaceAround: {
+        readonly justifyContent: "space-around";
+    };
+    readonly textRight: {
+        readonly textAlign: "right";
+    };
+    readonly textLeft: {
+        readonly textAlign: "left";
+    };
+    readonly textCenter: {
+        readonly textAlign: "center";
+    };
+    readonly flexWrap: {
+        readonly flexWrap: "wrap";
+    };
+    readonly 'visibility:hidden': {
+        readonly visibility: "hidden";
+    };
+    readonly 'visibility:visible': {
+        readonly visibility: "visible";
+    };
+    readonly 'display:none': {
+        readonly display: "none";
+    };
+};
+/** Typed record mapping every built-in variant name to an `ICSS` value. */
+export type DefaultVariants = Record<keyof typeof defaultVariants, ICSS>;
+//# sourceMappingURL=defaultVariants.d.ts.map

package/dist/variants/defaultVariants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"defaultVariants.d.ts","sourceRoot":"","sources":["../../src/variants/defaultVariants.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,UAAU,CAAA;AAE/B;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,eAAe;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA4HlB,CAAA;AAEV,2EAA2E;AAC3E,MAAM,MAAM,eAAe,GAAG,MAAM,CAAC,MAAM,OAAO,eAAe,EAAE,IAAI,CAAC,CAAA"}

package/dist/variants/dynamicVariants.d.ts

@@ -0,0 +1,43 @@
+import { IBorderRadius, IColors, ISizes } from '../types';
+/** Callback shape for a variant that receives a raw value and returns a style fragment. */
+export type VariantFunction = (value: any) => any;
+/** CSS properties that accept a color token: `backgroundColor` and `color`. */
+export declare const colorVariants: readonly ["backgroundColor", "color"];
+/** Horizontal border directions used when generating per-corner radius variants. */
+export declare const borderXDirection: readonly ["left", "right"];
+/** Vertical border directions used when generating per-corner radius variants. */
+export declare const borderYDirection: readonly ["bottom", "top"];
+/** All four border directions plus the un-suffixed (all-sides) form. */
+export declare const borderDirection: readonly ["bottom", "top", "left", "right", ""];
+/** Border sub-properties generated for each direction. */
+export declare const borderProperties: readonly ["color", "radius", "width"];
+/** CSS cursor values surfaced as `cursor:<value>` style variants. */
+export declare const cursorTypes: readonly ["not-allowed", "help", "pointer", "wait", ""];
+/** Numeric value or the empty-string terminator used in `scale:` variant templates. */
+export type Value = number | '';
+type MatchKeysByValue<T extends Record<string, any>, Values> = {
+    [K in keyof T]: T[K] extends Values ? K : never;
+}[keyof T];
+type Color = MatchKeysByValue<IColors, string>;
+type Sizes = keyof ISizes;
+/**
+ * Union of all parametric variant strings resolved at runtime by looking up the
+ * provided value in the theme. Examples: `"color:primary"`, `"bg:neutral"`,
+ * `"borderRadius:sm"`, `"cursor:pointer"`, `"scale:0.95"`, `"size:icon"`.
+ * The part before `:` is the variant name; the part after is the token key or raw value.
+ */
+export type DynamicVariants = `color:${Color}` | `border${Capitalize<typeof borderDirection[number]>}Width:${keyof IBorderRadius}` | `border${Capitalize<typeof borderDirection[number]>}Color:${Color}` | `borderRadius:${keyof IBorderRadius}` | `border${Capitalize<typeof borderYDirection[number]>}${Capitalize<typeof borderXDirection[number]>}Radius:${keyof IBorderRadius}` | `border${Capitalize<typeof borderYDirection[number]>}Radius:${keyof IBorderRadius}` | `border${Capitalize<typeof borderXDirection[number]>}Radius:${keyof IBorderRadius}` | `cursor:${typeof cursorTypes[number]}` | `bg:${Color}` | `br:${keyof IBorderRadius}` | `scale:${Value}` | `size:${Sizes}`;
+/**
+ * Builds the dynamic variant registry object at module initialisation time.
+ * Each entry is a function `(theme, value) => ICSS` keyed by the variant name
+ * (the part before `:` in the variant string). The registry is consumed by
+ * `CodeleapStyleRegistry.computeCommonVariantStyle`.
+ */
+export declare const createDynamicVariants: () => Record<string, any>;
+/**
+ * Pre-built dynamic variant registry used by the `CodeleapStyleRegistry`.
+ * Created once at module load; re-creation would lose the closed-over variant map.
+ */
+export declare const dynamicVariants: Record<string, any>;
+export {};
+//# sourceMappingURL=dynamicVariants.d.ts.map

package/dist/variants/dynamicVariants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dynamicVariants.d.ts","sourceRoot":"","sources":["../../src/variants/dynamicVariants.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,OAAO,EAAY,MAAM,EAAU,MAAM,UAAU,CAAA;AAG3E,2FAA2F;AAC3F,MAAM,MAAM,eAAe,GAAG,CAAC,KAAK,EAAE,GAAG,KAAK,GAAG,CAAA;AAEjD,+EAA+E;AAC/E,eAAO,MAAM,aAAa,uCAAwC,CAAA;AAElE,oFAAoF;AACpF,eAAO,MAAM,gBAAgB,4BAA6B,CAAA;AAC1D,kFAAkF;AAClF,eAAO,MAAM,gBAAgB,4BAA6B,CAAA;AAC1D,wEAAwE;AACxE,eAAO,MAAM,eAAe,iDAA0D,CAAA;AACtF,0DAA0D;AAC1D,eAAO,MAAM,gBAAgB,uCAAwC,CAAA;AAErE,qEAAqE;AACrE,eAAO,MAAM,WAAW,yDAMd,CAAA;AAEV,uFAAuF;AACvF,MAAM,MAAM,KAAK,GACb,MAAM,GACN,EAAE,CAAA;AAEN,KAAK,gBAAgB,CACnB,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAC7B,MAAM,IACJ;KAAG,CAAC,IAAI,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,SAAS,MAAM,GAAG,CAAC,GAAG,KAAK;CAAE,CAAC,MAAM,CAAC,CAAC,CAAA;AAKhE,KAAK,KAAK,GAAG,gBAAgB,CAAC,OAAO,EAAE,MAAM,CAAC,CAAA;AAE9C,KAAK,KAAK,GAAG,MAAM,MAAM,CAAA;AAEzB;;;;;GAKG;AACH,MAAM,MAAM,eAAe,GACzB,SAAS,KAAK,EAAE,GAChB,SAAS,UAAU,CAAC,OAAO,eAAe,CAAC,MAAM,CAAC,CAAC,SAAS,MAAM,aAAa,EAAE,GACjF,SAAS,UAAU,CAAC,OAAO,eAAe,CAAC,MAAM,CAAC,CAAC,SAAS,KAAK,EAAE,GACnE,gBAAgB,MAAM,aAAa,EAAE,GACrC,SAAS,UAAU,CAAC,OAAO,gBAAgB,CAAC,MAAM,CAAC,CAAC,GAAG,UAAU,CAAC,OAAO,gBAAgB,CAAC,MAAM,CAAC,CAAC,UAAU,MAAM,aAAa,EAAE,GACjI,SAAS,UAAU,CAAC,OAAO,gBAAgB,CAAC,MAAM,CAAC,CAAC,UAAU,MAAM,aAAa,EAAE,GACnF,SAAS,UAAU,CAAC,OAAO,gBAAgB,CAAC,MAAM,CAAC,CAAC,UAAU,MAAM,aAAa,EAAE,GACnF,UAAU,OAAO,WAAW,CAAC,MAAM,CAAC,EAAE,GACtC,MAAM,KAAK,EAAE,GACb,MAAM,MAAM,aAAa,EAAE,GAC3B,SAAS,KAAK,EAAE,GAChB,QAAQ,KAAK,EAAE,CAAA;AAEjB;;;;;GAKG;AACH,eAAO,MAAM,qBAAqB,2BA8EjC,CAAA;AAED;;;GAGG;AACH,eAAO,MAAM,eAAe,qBAA0B,CAAA"}

package/dist/variants/index.d.ts

@@ -0,0 +1,7 @@
+export * from './borderCreator';
+export * from './createAppVariants';
+export * from './defaultVariants';
+export * from './dynamicVariants';
+export * from './mediaQuery';
+export * from './spacing';
+//# sourceMappingURL=index.d.ts.map

package/dist/variants/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/variants/index.ts"],"names":[],"mappings":"AAAA,cAAc,iBAAiB,CAAA;AAC/B,cAAc,qBAAqB,CAAA;AACnC,cAAc,mBAAmB,CAAA;AACjC,cAAc,mBAAmB,CAAA;AACjC,cAAc,cAAc,CAAA;AAC5B,cAAc,WAAW,CAAA"}

package/dist/variants/mediaQuery.d.ts

@@ -0,0 +1,30 @@
+import { Breakpoint } from '../types';
+/**
+ * The four directional media-query helpers. Each returns a complete `@media` string
+ * that can be used as a nested style key.
+ * - `up` — `min-width` (at and above the breakpoint).
+ * - `down` — `max-width` (at and below the breakpoint).
+ * - `is` — exact match (`min-width` AND `max-width` at the same value).
+ * - `not` — negated exact match.
+ */
+export type Queries = {
+    up: (breakpoint: string) => string;
+    down: (breakpoint: Breakpoint) => string;
+    is: (breakpoint: string) => string;
+    not: (breakpoint: string) => string;
+};
+/**
+ * Extends `Queries` with `renderToPlatformQuery`, which inverts the query direction
+ * for React Native's platform-query rendering: `up` becomes `down`, `is` becomes `not`,
+ * etc. This is how responsive styles declared for web are translated to RN media conditions.
+ */
+export type MediaQueries = Queries & {
+    renderToPlatformQuery: (props: Record<keyof Queries, any>) => string;
+};
+/**
+ * Produces a `MediaQueries` object bound to the provided `breakpoints` map.
+ * Unknown breakpoints (not in the map) fall back to `Infinity`, making `up(unknown)`
+ * match all widths and `down(unknown)` match none.
+ */
+export declare function createMediaQueries<T extends any>(breakpoints: T): MediaQueries;
+//# sourceMappingURL=mediaQuery.d.ts.map

package/dist/variants/mediaQuery.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mediaQuery.d.ts","sourceRoot":"","sources":["../../src/variants/mediaQuery.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,UAAU,CAAA;AAErC;;;;;;;GAOG;AACH,MAAM,MAAM,OAAO,GAAG;IACpB,EAAE,EAAE,CAAC,UAAU,EAAE,MAAM,KAAK,MAAM,CAAA;IAClC,IAAI,EAAE,CAAC,UAAU,EAAE,UAAU,KAAK,MAAM,CAAA;IACxC,EAAE,EAAE,CAAC,UAAU,EAAE,MAAM,KAAK,MAAM,CAAA;IAClC,GAAG,EAAE,CAAC,UAAU,EAAE,MAAM,KAAK,MAAM,CAAA;CACpC,CAAA;AAED;;;;GAIG;AACH,MAAM,MAAM,YAAY,GAAG,OAAO,GAAG;IACnC,qBAAqB,EAAE,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,OAAO,EAAE,GAAG,CAAC,KAAK,MAAM,CAAA;CACrE,CAAA;AAUD;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,CAAC,SAAS,GAAG,EAAE,WAAW,EAAE,CAAC,GAAG,YAAY,CAgD9E"}

package/dist/variants/spacing.d.ts

@@ -0,0 +1,26 @@
+import { ICSS } from '../types';
+import { SpacingVariants, SpacingShortVariants } from '../types/spacing';
+/** Function returned by a spacing factory entry; accepts a multiplier and returns a style fragment. */
+export type MultiplierFunction = (multiplier: number | string) => ICSS;
+/**
+ * Typed shape of the spacing object produced by `spacingFactory` for a given property.
+ * When `S` is `boolean`, the direction variants are long-form (`SpacingVariants`);
+ * when `S` is `string`, they are short-form (`SpacingShortVariants`).
+ */
+export type Spacings<T extends string, S = boolean> = {
+    [Property in (S extends boolean ? SpacingVariants : SpacingShortVariants) as `${T}${string & Property}`]: MultiplierFunction;
+} & {
+    [Property in T]: (multiplier: number) => ICSS;
+} & {
+    value: (multiplier: number) => number;
+};
+/**
+ * Builds a spacing variant map for a CSS property (`'padding'`, `'margin'`, `'p'`, `'m'`).
+ * Each key in the returned object is a callable that multiplies its argument by `base`.
+ * Passing `isShort = true` uses single-letter direction suffixes and maps them to their
+ * long-form equivalents before producing the CSS property name.
+ * The `'Horizontal'` and `'Vertical'` (or `'x'`/`'y'`) directions expand to two
+ * properties each; the empty-string direction produces all four sides at once.
+ */
+export declare function spacingFactory<T extends string>(base: number, spacingProperty: T, isShort?: boolean): any;
+//# sourceMappingURL=spacing.d.ts.map

package/dist/variants/spacing.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"spacing.d.ts","sourceRoot":"","sources":["../../src/variants/spacing.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,UAAU,CAAA;AAC/B,OAAO,EAAyC,eAAe,EAAE,oBAAoB,EAAE,MAAM,kBAAkB,CAAA;AAE/G,uGAAuG;AACvG,MAAM,MAAM,kBAAkB,GAAG,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,KAAK,IAAI,CAAA;AAEtE;;;;GAIG;AACH,MAAM,MAAM,QAAQ,CAAC,CAAC,SAAS,MAAM,EAAE,CAAC,GAAG,OAAO,IAAI;KACnD,QAAQ,IAAI,CAAC,CAAC,SAAS,OAAO,GAAG,eAAe,GAAG,oBAAoB,CAAC,IAAI,GAAG,CAAC,GAAG,MAAM,GAAG,QAAQ,EAAE,GAAG,kBAAkB;CAC7H,GAAG;KACC,QAAQ,IAAI,CAAC,GAAG,CAAC,UAAU,EAAE,MAAM,KAAK,IAAI;CAC9C,GAAG;IACF,KAAK,EAAE,CAAC,UAAU,EAAE,MAAM,KAAK,MAAM,CAAA;CACtC,CAAA;AAsBH;;;;;;;GAOG;AACH,wBAAgB,cAAc,CAAC,CAAC,SAAS,MAAM,EAC7C,IAAI,EAAE,MAAM,EACZ,eAAe,EAAE,CAAC,EAClB,OAAO,GAAE,OAAe,GACvB,GAAG,CA0DL"}

package/package.json

@@ -1,7 +1,20 @@
 {
   "name": "@codeleap/styles",
-  "version": "6.3.0",
+  "version": "7.0.0",
   "main": "src/index.ts",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "source": "./src/index.ts",
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "default": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "src"
+  ],
   "license": "UNLICENSED",
   "repository": {
     "url": "https://github.com/codeleap-uk/internal-libs-monorepo.git",
@@ -9,11 +22,12 @@
     "directory": "packages/styles"
   },
   "devDependencies": {
-    "@codeleap/config": "6.3.0",
+    "@codeleap/config": "7.0.0",
     "ts-node-dev": "^1.1.8"
   },
   "scripts": {
-    "build": "echo 'No build needed'"
+    "build": "tsc --build tsconfig.build.json",
+    "typecheck": "bun tsc --noEmit -p ./tsconfig.json"
   },
   "peerDependencies": {
     "react": "19.1.0",
@@ -24,7 +38,7 @@
     "@nanostores/react": "1.0.0",
     "js-sha256": "0.11.1",
     "lz-string": "1.5.0",
-    "nanostores": "1.0.1",
+    "nanostores": "1.3.0",
     "rfdc": "1.4.1"
   }
-}
+}

package/src/classes/Cacher.ts

@@ -26,7 +26,7 @@ export class Cache<T extends any = any> {
   cache: Record<string, T> = {}
 
   /** Debounce timer for batch persistence */
-  private persistTimer: NodeJS.Timer | null = null
+  private persistTimer: ReturnType<typeof setTimeout> | null = null
 
   /** Debounce delay in milliseconds */
   private persistDelay: number = 4500
@@ -55,7 +55,7 @@ export class Cache<T extends any = any> {
    */
   constructor(
     public registryName: CacheType,
-    private storage: StateStorage = null,
+    private storage: StateStorage | null | undefined = undefined,
     public persistCache: boolean = !!storage,
   ) {
     if (!persistCache || !StyleConstants.STORE_CACHE_ENABLED) return
@@ -155,8 +155,8 @@ export class Cache<T extends any = any> {
   loadStorage() {
     if (!this.persistCache) return { persistedStaleTime: generateStaleTime(), persistedCache: {} }
 
-    const persistedStaleTime = this.storage.getItem(this.persistKeyStaleTime)
-    const persistedCache = this.storage.getItem(this.persistKeyCache)
+    const persistedStaleTime = this.storage!.getItem(this.persistKeyStaleTime)
+    const persistedCache = this.storage!.getItem(this.persistKeyCache)
 
     return {
       persistedStaleTime: !persistedStaleTime ? generateStaleTime() : new Date(persistedStaleTime),
@@ -170,19 +170,19 @@ export class Cache<T extends any = any> {
   clearStorage() {
     if (!this.persistCache) return
 
-    this.storage.removeItem(this.persistKeyStaleTime)
-    this.storage.removeItem(this.persistKeyCache)
+    this.storage!.removeItem(this.persistKeyStaleTime)
+    this.storage!.removeItem(this.persistKeyCache)
   }
 
   /**
    * Stores cache data to persistent storage
    * @param {Record<string, T>} [cache=null] - Cache data to store (uses current cache if not provided)
    */
-  storeCache(cache: Record<string, T> = null) {
+  storeCache(cache: Record<string, T> | undefined = undefined) {
     if (!this.persistCache) return
 
     const value = cache ?? this.cache
-    this.storage.setItem(this.persistKeyCache, value)
+    this.storage!.setItem(this.persistKeyCache, value)
   }
 
   /**
@@ -193,6 +193,6 @@ export class Cache<T extends any = any> {
     if (!this.persistCache) return
 
     const value = staleTime.toISOString()
-    this.storage.setItem(this.persistKeyStaleTime, value)
+    this.storage!.setItem(this.persistKeyStaleTime, value)
   }
 }