@tenphi/tasty 2.0.2 → 2.0.4

package/dist/types.d.ts

@@ -1,184 +0,0 @@
-import { CSSProperties as CSSProperties$1 } from "./utils/css-types.js";
-import { Styles } from "./styles/types.js";
-import { BASE_STYLES, BLOCK_INNER_STYLES, BLOCK_OUTER_STYLES, BLOCK_STYLES, COLOR_STYLES, CONTAINER_STYLES, DIMENSION_STYLES, FLOW_STYLES, INNER_STYLES, OUTER_STYLES, POSITION_STYLES, TEXT_STYLES } from "./styles/list.js";
-import { AllHTMLAttributes, ComponentType } from "react";
-
-//#region src/types.d.ts
-interface GlobalStyledProps {
-  breakpoints?: number[];
-}
-/**
- * Extensible interface for theme names.
- * Augment this interface to register project-specific theme names for autocomplete.
- *
- * @example
- * ```typescript
- * declare module '@tenphi/tasty' {
- *   interface TastyThemeNames {
- *     danger: true;
- *     success: true;
- *   }
- * }
- * ```
- */
-interface TastyThemeNames {}
-type ThemeNameKey = Extract<keyof TastyThemeNames, string>;
-type ThemeName = [ThemeNameKey] extends [never] ? string : ThemeNameKey;
-/** Allowed mod value types */
-type ModValue = boolean | string | number | undefined | null;
-/**
- * Type for element modifiers (mods prop).
- * Can be used as a generic to define known modifiers with autocomplete:
- * @example
- * type ButtonMods = Mods<{
- *   loading?: boolean;
- *   selected?: boolean;
- * }>;
- */
-type Mods<T extends Record<string, ModValue> = Record<string, ModValue>> = T & Record<string, ModValue>;
-/**
- * Token value: string or number (processed), boolean for special handling, undefined/null (skipped).
- * For color tokens (#name), boolean `true` is converted to `transparent`.
- * For non-color tokens ($name), boolean `true` results in an empty string value.
- * Boolean `false` results in no CSS output (token is skipped).
- */
-type TokenValue = string | number | boolean | undefined | null;
-/**
- * Tokens definition for inline CSS custom properties.
- * - `$name` keys become `--name` CSS properties
- * - `#name` keys become `--name-color` and `--name-color-{colorSpace}` CSS properties
- */
-type Tokens = Record<`$${string}` | `#${string}`, TokenValue>;
-type Caps = 'A' | 'B' | 'C' | 'D' | 'E' | 'F' | 'G' | 'H' | 'I' | 'J' | 'K' | 'L' | 'M' | 'N' | 'O' | 'P' | 'Q' | 'R' | 'S' | 'T' | 'U' | 'V' | 'W' | 'X' | 'Y' | 'Z';
-interface BasePropsWithoutChildren<K extends TagName = TagName> extends Pick<AllHTMLAttributes<HTMLElement>, 'className' | 'role' | 'id'> {
-  /** The HTML tag or React component to render as */
-  as?: K | ComponentType<any>;
-  /** QA ID for e2e testing. An alias for `data-qa` attribute. */
-  qa?: string;
-  /** QA value for e2e testing. An alias for `data-qaval` attribute. */
-  qaVal?: string | number;
-  /** Inner element name */
-  element?: `${Caps}${string}`;
-  /** The style map */
-  styles?: Styles;
-  /** The list of responsive points in pixels */
-  breakpoints?: number[];
-  /** Whether the element has the block layout outside */
-  block?: boolean;
-  /** Whether the element has the inline layout outside */
-  inline?: boolean;
-  /** The list of element modifiers **/
-  mods?: Mods;
-  /** Whether the element is hidden (`hidden` attribute is set) */
-  isHidden?: boolean;
-  /** Whether the element is disabled (`disabled` attribute is set) */
-  isDisabled?: boolean;
-  /** Plain css for the element */
-  css?: string;
-  /** The CSS style map */
-  style?: CSSProperties$1 | (CSSProperties$1 & Record<string, string | number | null | undefined>);
-  /** User-defined theme for the element. Mapped to `data-theme` attribute. Augment `TastyThemeNames` to register project-specific themes for autocomplete. */
-  theme?: ThemeName | (string & {});
-  /** CSS custom property tokens rendered as inline styles */
-  tokens?: Tokens;
-}
-interface BaseProps<K extends TagName = TagName> extends BasePropsWithoutChildren<K>, Pick<AllHTMLAttributes<HTMLElementTagNameMap[K]>, 'children'> {}
-interface AllBaseProps<K extends TagName = TagName> extends BaseProps<K>, Omit<AllHTMLAttributes<HTMLElementTagNameMap[K]>, 'style' | 'disabled' | 'hidden' | 'css' | 'content' | 'translate' | 'as' | 'form' | 'bgcolor' | 'background' | 'align' | 'border' | 'color' | 'height' | 'size' | 'width' | 'prefix'> {}
-type BaseStyleProps = Pick<Styles, (typeof BASE_STYLES)[number]>;
-type PositionStyleProps = Pick<Styles, (typeof POSITION_STYLES)[number]>;
-type BlockStyleProps = Pick<Styles, (typeof BLOCK_STYLES)[number]>;
-type BlockInnerStyleProps = Pick<Styles, (typeof BLOCK_INNER_STYLES)[number]>;
-type BlockOuterStyleProps = Pick<Styles, (typeof BLOCK_OUTER_STYLES)[number]>;
-type ColorStyleProps = Pick<Styles, (typeof COLOR_STYLES)[number]>;
-type TextStyleProps = Pick<Styles, (typeof TEXT_STYLES)[number]>;
-type DimensionStyleProps = Pick<Styles, (typeof DIMENSION_STYLES)[number]>;
-type FlowStyleProps = Pick<Styles, (typeof FLOW_STYLES)[number]>;
-type ContainerStyleProps = Pick<Styles, (typeof CONTAINER_STYLES)[number]>;
-type OuterStyleProps = Pick<Styles, (typeof OUTER_STYLES)[number]>;
-type InnerStyleProps = Pick<Styles, (typeof INNER_STYLES)[number]>;
-interface ShortGridStyles {
-  template?: Styles['gridTemplate'];
-  columns?: Styles['gridColumns'];
-  rows?: Styles['gridRows'];
-  areas?: Styles['gridAreas'];
-}
-type Props = Record<string, any>;
-type TagName = keyof HTMLElementTagNameMap;
-/**
- * Configuration type for tasty.config.ts files.
- * Used by the Tasty VSCode extension for validation and autocomplete.
- *
- * @example
- * ```typescript
- * import type { TastyExtensionConfig } from '@tenphi/tasty';
- *
- * const config: TastyExtensionConfig = {
- *   tokens: ['#primary', '#danger', '$spacing'],
- *   units: ['x', 'r', 'bw'],
- *   states: ['@mobile', '@tablet', '@dark'],
- *   presets: ['h1', 'h2', 't1', 't2'],
- * };
- *
- * export default config;
- * ```
- */
-interface TastyExtensionConfig {
-  /**
-   * Extend another config file. Path is relative to this config file.
-   * The extended config is merged first, then this config's values are added.
-   * @example '../tasty.config.ts'
-   */
-  extends?: string;
-  /**
-   * Valid token names for validation and autocomplete.
-   * Use # prefix for colors, $ prefix for custom properties.
-   * Set to `false` to disable token validation (overrides parent).
-   * @example ['#primary', '#danger', '$spacing', '$gap']
-   */
-  tokens?: false | string[];
-  /**
-   * Valid custom unit names.
-   * Set to `false` to disable unit validation (overrides parent).
-   * @example ['x', 'r', 'bw', 'cols']
-   */
-  units?: false | string[];
-  /**
-   * Valid custom function names.
-   * Set to `false` to disable function validation (overrides parent).
-   * @example ['clamp', 'double']
-   */
-  funcs?: false | string[];
-  /**
-   * State alias names for autocomplete.
-   * Must start with @ prefix.
-   * @example ['@mobile', '@tablet', '@dark']
-   */
-  states?: string[];
-  /**
-   * Valid preset names for the `preset` style property.
-   * Tasty has no built-in presets - they are project-specific.
-   * @example ['h1', 'h2', 'h3', 't1', 't2', 't3', 'tag']
-   */
-  presets?: string[];
-  /**
-   * Custom style property names added via configure({ handlers }).
-   * Suppresses "unknown property" warnings for these names.
-   * @example ['myGradient', 'customLayout', 'brandBorder']
-   */
-  styles?: string[];
-  /**
-   * Descriptions for presets, shown on hover in the extension.
-   * Maps preset names to human-readable descriptions.
-   * @example { h1: 'Heading 1 (36px/44px, semibold)', t1: 'Text large (18px/24px)' }
-   */
-  presetDescriptions?: Record<string, string>;
-  /**
-   * Descriptions for state aliases, shown on hover in the extension.
-   * Maps state names to human-readable descriptions.
-   * @example { '@mobile': 'Mobile viewport (width < 768px)' }
-   */
-  stateDescriptions?: Record<string, string>;
-}
-//#endregion
-export { AllBaseProps, BaseProps, BasePropsWithoutChildren, BaseStyleProps, BlockInnerStyleProps, BlockOuterStyleProps, BlockStyleProps, ColorStyleProps, ContainerStyleProps, DimensionStyleProps, FlowStyleProps, GlobalStyledProps, InnerStyleProps, ModValue, Mods, OuterStyleProps, PositionStyleProps, Props, ShortGridStyles, TagName, TastyExtensionConfig, TastyThemeNames, TextStyleProps, TokenValue, Tokens };
-//# sourceMappingURL=types.d.ts.map

package/dist/utils/cache-wrapper.js

@@ -1,21 +0,0 @@
-import { Lru } from "../parser/lru.js";
-//#region src/utils/cache-wrapper.ts
-/**
-* Create a function that caches the result with LRU eviction.
-*/
-function cacheWrapper(handler, limit = 1e3) {
-	const cache = new Lru(limit);
-	return (firstArg, secondArg) => {
-		const key = typeof firstArg === "string" && secondArg == null ? firstArg : JSON.stringify([firstArg, secondArg]);
-		let result = cache.get(key);
-		if (result === void 0) {
-			result = secondArg == null ? handler(firstArg) : handler(firstArg, secondArg);
-			cache.set(key, result);
-		}
-		return result;
-	};
-}
-//#endregion
-export { cacheWrapper };
-
-//# sourceMappingURL=cache-wrapper.js.map

package/dist/utils/cache-wrapper.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"cache-wrapper.js","names":[],"sources":["../../src/utils/cache-wrapper.ts"],"sourcesContent":["import { Lru } from '../parser/lru';\n\n/**\n * Create a function that caches the result with LRU eviction.\n */\nexport function cacheWrapper<A, B, R>(\n  handler: (firstArg: A, secondArg?: B) => R,\n  limit = 1000,\n): (firstArg: A, secondArg?: B) => R {\n  const cache = new Lru<string, R>(limit);\n\n  return (firstArg: A, secondArg?: B) => {\n    const key =\n      typeof firstArg === 'string' && secondArg == null\n        ? firstArg\n        : JSON.stringify([firstArg, secondArg]);\n\n    let result = cache.get(key);\n    if (result === undefined) {\n      result =\n        secondArg == null ? handler(firstArg) : handler(firstArg, secondArg);\n      cache.set(key, result);\n    }\n    return result;\n  };\n}\n"],"mappings":";;;;;AAKA,SAAgB,aACd,SACA,QAAQ,KAC2B;CACnC,MAAM,QAAQ,IAAI,IAAe,MAAM;AAEvC,SAAQ,UAAa,cAAkB;EACrC,MAAM,MACJ,OAAO,aAAa,YAAY,aAAa,OACzC,WACA,KAAK,UAAU,CAAC,UAAU,UAAU,CAAC;EAE3C,IAAI,SAAS,MAAM,IAAI,IAAI;AAC3B,MAAI,WAAW,KAAA,GAAW;AACxB,YACE,aAAa,OAAO,QAAQ,SAAS,GAAG,QAAQ,UAAU,UAAU;AACtE,SAAM,IAAI,KAAK,OAAO;;AAExB,SAAO"}

package/dist/utils/case-converter.js

@@ -1,8 +0,0 @@
-//#region src/utils/case-converter.ts
-function camelToKebab(str) {
-	return str.replace(/([a-z0-9])([A-Z])/g, "$1-$2").toLowerCase();
-}
-//#endregion
-export { camelToKebab };
-
-//# sourceMappingURL=case-converter.js.map

package/dist/utils/case-converter.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"case-converter.js","names":[],"sources":["../../src/utils/case-converter.ts"],"sourcesContent":["export function camelToKebab(str: string): string {\n  return str.replace(/([a-z0-9])([A-Z])/g, '$1-$2').toLowerCase();\n}\n"],"mappings":";AAAA,SAAgB,aAAa,KAAqB;AAChD,QAAO,IAAI,QAAQ,sBAAsB,QAAQ,CAAC,aAAa"}

package/dist/utils/color-math.d.ts

@@ -1,46 +0,0 @@
-//#region src/utils/color-math.d.ts
-/**
- * Consolidated color conversion math.
- *
- * Single source of truth for all color space conversions used across the
- * library: sRGB gamma, HSL, OKLab, OKLCH, OKHSL, hex parsing, named
- * colors, and CSS string converters.
- *
- * This module has zero internal imports — it is a leaf dependency.
- *
- * Reference: https://bottosson.github.io/posts/oklab/
- */
-type Vec3 = [number, number, number];
-/**
- * HSL to RGB.
- * Algorithm from CSS Color 4 spec.
- *
- * @param h - Hue in degrees (0-360)
- * @param s - Saturation (0-1)
- * @param l - Lightness (0-1)
- * @returns RGB values in 0-255 range (may have fractional values)
- */
-declare function hslToRgbValues(h: number, s: number, l: number): Vec3;
-declare function getNamedColorHex(): Map<string, string>;
-/**
- * Convert hex color string to `rgb()` CSS string.
- * Supports 3, 4, 6, and 8 character hex values (with or without `#`).
- */
-declare function hexToRgb(hex: string): string | null;
-/**
- * Extract RGB values from an `rgb()`/`rgba()` string.
- * Supports comma-separated, space-separated, fractional, percentage,
- * and slash alpha notation.
- *
- * @returns Array of RGB values (0-255 range), converting percentages as needed.
- */
-declare function getRgbValuesFromRgbaString(str: string): number[];
-/**
- * Convert any recognized color string to an `rgb()` CSS string.
- * Handles hex, `okhsl()`, `hsl()`/`hsla()`, named CSS colors,
- * and `rgb()`/`rgba()` pass-through.
- */
-declare function strToRgb(color: string, _ignoreAlpha?: boolean): string | null | undefined;
-//#endregion
-export { getNamedColorHex, getRgbValuesFromRgbaString, hexToRgb, hslToRgbValues, strToRgb };
-//# sourceMappingURL=color-math.d.ts.map