@tenphi/tasty 0.1.0

package/dist/utils/styles.d.mts

@@ -0,0 +1,18 @@
+//#region src/utils/styles.d.ts
+type StyleValue<T = string> = T | boolean | number | null | undefined;
+type StyleValueStateMap<T = string> = Record<string, StyleValue<T> | '@inherit'>;
+type CSSMap = {
+  $?: string | string[];
+} & Record<string, string | string[]>;
+type StyleHandlerResult = CSSMap | CSSMap[] | void;
+type RawStyleHandler = (value: StyleValueStateMap) => StyleHandlerResult;
+/**
+ * Handler definition forms for configure() and plugins.
+ * - Function only: lookup styles inferred from key name
+ * - Single property tuple: ['styleName', handler]
+ * - Multi-property tuple: [['style1', 'style2'], handler]
+ */
+type StyleHandlerDefinition = RawStyleHandler | [string, RawStyleHandler] | [string[], RawStyleHandler];
+//#endregion
+export { StyleHandlerDefinition, StyleValue, StyleValueStateMap };
+//# sourceMappingURL=styles.d.mts.map

package/dist/utils/styles.d.ts

@@ -0,0 +1,183 @@
+import { ProcessedStyle, StyleDetails } from "../parser/types.js";
+import { StyleParser } from "../parser/parser.js";
+import { AtRuleContext, ParsedAdvancedState, StateParserContext } from "../states/index.js";
+import { Styles } from "../styles/types.js";
+
+//#region src/utils/styles.d.ts
+type StyleValue<T = string> = T | boolean | number | null | undefined;
+/**
+ * Normalize a color token value.
+ * - Boolean `true` is converted to `'transparent'`
+ * - Boolean `false` returns `null` (signals the token should be skipped)
+ * - Other values are returned as-is
+ *
+ * @param value - The raw token value
+ * @returns Normalized value or null if the token should be skipped
+ */
+declare function normalizeColorTokenValue<T>(value: T | boolean): T | 'transparent' | null;
+type StyleValueStateMap<T = string> = Record<string, StyleValue<T> | '@inherit'>;
+/**
+ * Combined type for style values that can be either a direct value or a state map.
+ * Use this for component props that accept style values.
+ */
+type StylePropValue<T = string> = StyleValue<T> | StyleValueStateMap<T>;
+type ComputeModel = string | number;
+type CSSMap = {
+  $?: string | string[];
+} & Record<string, string | string[]>;
+type StyleHandlerResult = CSSMap | CSSMap[] | void;
+type RawStyleHandler = (value: StyleValueStateMap) => StyleHandlerResult;
+type StyleHandler = RawStyleHandler & {
+  __lookupStyles: string[];
+};
+/**
+ * Handler definition forms for configure() and plugins.
+ * - Function only: lookup styles inferred from key name
+ * - Single property tuple: ['styleName', handler]
+ * - Multi-property tuple: [['style1', 'style2'], handler]
+ */
+type StyleHandlerDefinition = RawStyleHandler | [string, RawStyleHandler] | [string[], RawStyleHandler];
+interface StyleStateData {
+  model?: ComputeModel;
+  tokens?: string[];
+  value: StyleValue | StyleValueStateMap | StyleStateData;
+  /** The list of mods to apply */
+  mods: string[];
+  /** The list of **not** mods to apply (e.g. `:not(:hover)`) */
+  notMods: string[];
+  /** Advanced states (media queries, container queries, etc.) */
+  advancedStates?: ParsedAdvancedState[];
+  /** At-rule context for CSS generation */
+  atRuleContext?: AtRuleContext;
+  /** Own mods for sub-element states (from @own()) - applied to sub-element selector */
+  ownMods?: string[];
+  /** Negated own mods for sub-element states */
+  negatedOwnMods?: string[];
+}
+interface ParsedColor {
+  color?: string;
+  name?: string;
+  opacity?: number;
+}
+type StyleStateDataList = StyleStateData[];
+type StyleStateDataListMap = Record<string, StyleStateDataList>;
+type StyleMap = Record<string, StyleValue | StyleValueStateMap>;
+type StyleStateMap = Record<string, StyleStateData>;
+declare const CUSTOM_UNITS: {
+  r: string;
+  cr: string;
+  bw: string;
+  ow: string;
+  x: string;
+  fs: string;
+  lh: string;
+  sf: (num: any) => string;
+};
+declare const DIRECTIONS: string[];
+declare function getModSelector(modName: string): string;
+declare function customFunc(name: string, fn: (groups: StyleDetails[]) => string): void;
+/**
+ * Get the global StyleParser instance.
+ * Used by configure() to apply parser configuration.
+ */
+declare function getGlobalParser(): StyleParser;
+/**
+ * Get the current custom functions registry.
+ * Used by configure() to merge with new functions.
+ */
+declare function getGlobalFuncs(): Record<string, (groups: StyleDetails[]) => string>;
+/**
+ * Set global predefined tokens.
+ * Called from configure() after processing token values.
+ * Merges with existing tokens (new tokens override existing ones with same key).
+ * Keys are normalized to lowercase (parser lowercases input before classification).
+ * @internal
+ */
+declare function setGlobalPredefinedTokens(tokens: Record<string, string>): void;
+/**
+ * Get the current global predefined tokens.
+ * Returns null if no tokens are configured.
+ */
+declare function getGlobalPredefinedTokens(): Record<string, string> | null;
+/**
+ * Reset global predefined tokens.
+ * Used for testing.
+ * @internal
+ */
+declare function resetGlobalPredefinedTokens(): void;
+/**
+ *
+ * @param {String} value
+ * @param {Number} mode
+ * @returns {Object<String,String|Array>}
+ */
+declare function parseStyle(value: StyleValue): ProcessedStyle;
+/**
+ * Parse color. Find it value, name and opacity.
+ * Optimized to avoid heavy parseStyle calls for simple color patterns.
+ */
+declare function parseColor(val: string, ignoreError?: boolean): ParsedColor;
+declare function strToRgb(color: any, _ignoreAlpha?: boolean): any;
+/**
+ * Extract RGB values from an rgb()/rgba() string.
+ * Supports all modern CSS syntax variations:
+ * - Comma-separated: rgb(255, 128, 0)
+ * - Space-separated: rgb(255 128 0)
+ * - Fractional: rgb(128.5, 64.3, 32.1)
+ * - Percentages: rgb(50%, 25%, 75%)
+ * - Slash alpha notation: rgb(255 128 0 / 0.5)
+ *
+ * Returns array of RGB values (0-255 range), converting percentages as needed.
+ */
+declare function getRgbValuesFromRgbaString(str: string): number[];
+declare function hexToRgb(hex: any): string | null;
+declare function filterMods(mods: any, allowedMods: any): any;
+declare function extendStyles(defaultStyles: any, newStyles: any): {};
+/**
+ * Split properties into style and non-style properties.
+ * @param props - Component prop map.
+ * @param [styleList] - List of all style properties.
+ * @param [defaultStyles] - Default style map of the component.
+ * @param [propMap] - Props to style alias map.
+ * @param [ignoreList] - A list of properties to ignore.
+ */
+declare function extractStyles(props: Record<string, unknown>, styleList?: readonly string[], defaultStyles?: Styles, propMap?: Record<string, string>, ignoreList?: readonly string[]): Styles;
+/**
+ * Check if a token is an advanced state (starts with @)
+ */
+declare function isAdvancedStateToken(token: string): boolean;
+declare const STATE_OPERATORS: {
+  NOT: string;
+  AND: string;
+  OR: string;
+  XOR: string;
+};
+declare const STATE_OPERATOR_LIST: string[];
+declare const parseStateNotation: (firstArg: string, secondArg?: string | number | boolean | StyleValueStateMap<string> | StyleStateData | null | undefined) => StyleStateData;
+/**
+ * Build an AtRuleContext from parsed advanced states
+ */
+declare function buildAtRuleContext(advancedStates: ParsedAdvancedState[], negatedStates: Set<string>): AtRuleContext | undefined;
+/**
+ * Parse state notation and return tokens, modifiers and compute model.
+ * Enhanced to detect and extract advanced states.
+ */
+declare function styleStateMapToStyleStateDataList(styleStateMap: StyleStateMap | StyleValue | StyleValueStateMap, parserContext?: StateParserContext): {
+  states: StyleStateDataList;
+  mods: string[];
+  hasAdvancedStates: boolean;
+};
+declare const COMPUTE_FUNC_MAP: {
+  '!': (a: any) => boolean;
+  '^': (a: any, b: any) => any;
+  '|': (a: any, b: any) => any;
+  '&': (a: any, b: any) => any;
+};
+/**
+ * Compute a result based on a model and incoming map.
+ */
+declare function computeState(computeModel: ComputeModel, valueMap: (number | boolean)[] | Record<string, boolean> | ((...args: unknown[]) => unknown)): any;
+declare function stringifyStyles(styles: unknown): string;
+//#endregion
+export { COMPUTE_FUNC_MAP, CSSMap, CUSTOM_UNITS, ComputeModel, DIRECTIONS, ParsedColor, RawStyleHandler, STATE_OPERATORS, STATE_OPERATOR_LIST, StyleHandler, StyleHandlerDefinition, StyleHandlerResult, StyleMap, StylePropValue, StyleStateData, StyleStateDataList, StyleStateDataListMap, StyleStateMap, StyleValue, StyleValueStateMap, buildAtRuleContext, computeState, customFunc, extendStyles, extractStyles, filterMods, getGlobalFuncs, getGlobalParser, getGlobalPredefinedTokens, getModSelector, getRgbValuesFromRgbaString, hexToRgb, isAdvancedStateToken, normalizeColorTokenValue, parseColor, parseStateNotation, parseStyle, resetGlobalPredefinedTokens, setGlobalPredefinedTokens, strToRgb, stringifyStyles, styleStateMapToStyleStateDataList };
+//# sourceMappingURL=styles.d.ts.map