stoop 0.3.0 → 0.4.0

package/dist/utils/theme-map.d.ts

@@ -1,22 +0,0 @@
-/**
- * ThemeMap utilities for property-aware token resolution.
- * Maps CSS properties to theme scales for deterministic token resolution.
- */
-import type { ThemeScale } from "../types";
-/**
- * Auto-detects theme scale from CSS property name using pattern matching.
- * Used as fallback when property is not in DEFAULT_THEME_MAP.
- *
- * @param property - CSS property name
- * @returns Theme scale name or undefined if no pattern matches
- */
-export declare function autoDetectScale(property: string): ThemeScale | undefined;
-/**
- * Gets the theme scale for a CSS property.
- * Checks user themeMap first, then default themeMap, then pattern matching.
- *
- * @param property - CSS property name
- * @param userThemeMap - Optional user-provided themeMap override
- * @returns Theme scale name or undefined if no mapping found
- */
-export declare function getScaleForProperty(property: string, userThemeMap?: Record<string, ThemeScale>): ThemeScale | undefined;

package/dist/utils/theme-map.js

@@ -1,97 +0,0 @@
-/**
- * ThemeMap utilities for property-aware token resolution.
- * Maps CSS properties to theme scales for deterministic token resolution.
- */
-import { DEFAULT_THEME_MAP } from "../constants";
-/**
- * Auto-detects theme scale from CSS property name using pattern matching.
- * Used as fallback when property is not in DEFAULT_THEME_MAP.
- *
- * @param property - CSS property name
- * @returns Theme scale name or undefined if no pattern matches
- */
-export function autoDetectScale(property) {
-    // Color properties
-    if (property.includes("Color") ||
-        property === "fill" ||
-        property === "stroke" ||
-        property === "accentColor" ||
-        property === "caretColor" ||
-        property === "border" ||
-        property === "outline" ||
-        (property.includes("background") && !property.includes("Size") && !property.includes("Image"))) {
-        return "colors";
-    }
-    // Spacing properties
-    if (/^(margin|padding|gap|inset|top|right|bottom|left|rowGap|columnGap|gridGap|gridRowGap|gridColumnGap)/.test(property) ||
-        property.includes("Block") ||
-        property.includes("Inline")) {
-        return "space";
-    }
-    // Size properties
-    if (/(width|height|size|basis)$/i.test(property) ||
-        property.includes("BlockSize") ||
-        property.includes("InlineSize")) {
-        return "sizes";
-    }
-    // Typography: Font Size
-    if (property === "fontSize" || (property === "font" && !property.includes("Family"))) {
-        return "fontSizes";
-    }
-    // Typography: Font Family
-    if (property === "fontFamily" || property.includes("FontFamily")) {
-        return "fonts";
-    }
-    // Typography: Font Weight
-    if (property === "fontWeight" || property.includes("FontWeight")) {
-        return "fontWeights";
-    }
-    // Typography: Letter Spacing
-    if (property === "letterSpacing" || property.includes("LetterSpacing")) {
-        return "letterSpacings";
-    }
-    // Border Radius
-    if (property.includes("Radius") || property.includes("radius")) {
-        return "radii";
-    }
-    // Shadows
-    if (property.includes("Shadow") ||
-        property.includes("shadow") ||
-        property === "filter" ||
-        property === "backdropFilter") {
-        return "shadows";
-    }
-    // Z-Index
-    if (property === "zIndex" || property.includes("ZIndex") || property.includes("z-index")) {
-        return "zIndices";
-    }
-    // Opacity
-    if (property === "opacity" || property.includes("Opacity")) {
-        return "opacities";
-    }
-    // Transitions and animations
-    if (property.startsWith("transition") ||
-        property.startsWith("animation") ||
-        property.includes("Transition") ||
-        property.includes("Animation")) {
-        return "transitions";
-    }
-    return undefined;
-}
-/**
- * Gets the theme scale for a CSS property.
- * Checks user themeMap first, then default themeMap, then pattern matching.
- *
- * @param property - CSS property name
- * @param userThemeMap - Optional user-provided themeMap override
- * @returns Theme scale name or undefined if no mapping found
- */
-export function getScaleForProperty(property, userThemeMap) {
-    if (userThemeMap && property in userThemeMap) {
-        return userThemeMap[property];
-    }
-    if (property in DEFAULT_THEME_MAP) {
-        return DEFAULT_THEME_MAP[property];
-    }
-    return autoDetectScale(property);
-}

package/dist/utils/theme-validation.d.ts

@@ -1,13 +0,0 @@
-/**
- * Theme validation utilities.
- * Ensures theme objects only contain approved scales.
- */
-import type { DefaultTheme } from "../types";
-/**
- * Validates that a theme object only contains approved scales.
- *
- * @param theme - Theme object to validate
- * @returns Validated theme as DefaultTheme
- * @throws Error if theme contains invalid scales (in development)
- */
-export declare function validateTheme(theme: unknown): DefaultTheme;

package/dist/utils/theme-validation.js

@@ -1,36 +0,0 @@
-/**
- * Theme validation utilities.
- * Ensures theme objects only contain approved scales.
- */
-import { APPROVED_THEME_SCALES } from "../constants";
-/**
- * Validates that a theme object only contains approved scales.
- *
- * @param theme - Theme object to validate
- * @returns Validated theme as DefaultTheme
- * @throws Error if theme contains invalid scales (in development)
- */
-export function validateTheme(theme) {
-    if (!theme || typeof theme !== "object" || Array.isArray(theme)) {
-        throw new Error("[Stoop] Theme must be a non-null object");
-    }
-    if (typeof process !== "undefined" && process.env?.NODE_ENV === "production") {
-        return theme;
-    }
-    const themeObj = theme;
-    const invalidScales = [];
-    for (const key in themeObj) {
-        if (key === "media") {
-            continue;
-        }
-        if (!APPROVED_THEME_SCALES.includes(key)) {
-            invalidScales.push(key);
-        }
-    }
-    if (invalidScales.length > 0) {
-        const errorMessage = `[Stoop] Theme contains invalid scales: ${invalidScales.join(", ")}. ` +
-            `Only these scales are allowed: ${APPROVED_THEME_SCALES.join(", ")}`;
-        throw new Error(errorMessage);
-    }
-    return theme;
-}

package/dist/utils/type-guards.d.ts

@@ -1,26 +0,0 @@
-/**
- * Type guard utilities.
- * Provides runtime type checking for CSS objects, themes, and styled component references.
- */
-import type { CSS, Theme } from "../types";
-/**
- * Type guard for CSS objects.
- *
- * @param value - Value to check
- * @returns True if value is a CSS object
- */
-export declare function isCSSObject(value: unknown): value is CSS;
-/**
- * Type guard for valid CSS objects (excludes styled component references).
- *
- * @param value - Value to check
- * @returns True if value is a valid CSS object
- */
-export declare function isValidCSSObject(value: unknown): value is CSS;
-/**
- * Type guard for theme objects.
- *
- * @param value - Value to check
- * @returns True if value is a theme object
- */
-export declare function isThemeObject(value: unknown): value is Theme;

package/dist/utils/type-guards.js

@@ -1,38 +0,0 @@
-/**
- * Type guard utilities.
- * Provides runtime type checking for CSS objects, themes, and styled component references.
- */
-/**
- * Type guard for CSS objects.
- *
- * @param value - Value to check
- * @returns True if value is a CSS object
- */
-export function isCSSObject(value) {
-    return typeof value === "object" && value !== null;
-}
-function isStyledComponentRef(value) {
-    return (typeof value === "object" &&
-        value !== null &&
-        "__isStoopStyled" in value &&
-        "__stoopClassName" in value &&
-        value.__isStoopStyled === true);
-}
-/**
- * Type guard for valid CSS objects (excludes styled component references).
- *
- * @param value - Value to check
- * @returns True if value is a valid CSS object
- */
-export function isValidCSSObject(value) {
-    return isCSSObject(value) && !isStyledComponentRef(value);
-}
-/**
- * Type guard for theme objects.
- *
- * @param value - Value to check
- * @returns True if value is a theme object
- */
-export function isThemeObject(value) {
-    return typeof value === "object" && value !== null && !Array.isArray(value);
-}

package/dist/utils/utilities.d.ts

@@ -1,14 +0,0 @@
-/**
- * Utility function application.
- * Applies utility functions (e.g., px, py) to transform shorthand properties into CSS.
- * Recursively processes nested CSS objects.
- */
-import type { CSS, UtilityFunction } from "../types";
-/**
- * Applies utility functions to transform shorthand properties into CSS.
- *
- * @param styles - CSS object to process
- * @param utils - Optional utility functions object
- * @returns CSS object with utilities applied
- */
-export declare function applyUtilities(styles: CSS, utils?: Record<string, UtilityFunction>): CSS;

package/dist/utils/utilities.js

@@ -1,43 +0,0 @@
-/**
- * Utility function application.
- * Applies utility functions (e.g., px, py) to transform shorthand properties into CSS.
- * Recursively processes nested CSS objects.
- */
-import { isCSSObject } from "./type-guards";
-/**
- * Applies utility functions to transform shorthand properties into CSS.
- *
- * @param styles - CSS object to process
- * @param utils - Optional utility functions object
- * @returns CSS object with utilities applied
- */
-export function applyUtilities(styles, utils) {
-    if (!utils || !styles || typeof styles !== "object") {
-        return styles;
-    }
-    const result = {};
-    const utilityKeys = Object.keys(utils);
-    for (const key in styles) {
-        const value = styles[key];
-        if (utilityKeys.includes(key) && utils[key]) {
-            try {
-                const utilityResult = utils[key](value);
-                if (utilityResult && typeof utilityResult === "object") {
-                    for (const utilKey in utilityResult) {
-                        result[utilKey] = utilityResult[utilKey];
-                    }
-                }
-            }
-            catch {
-                result[key] = value;
-            }
-        }
-        else if (isCSSObject(value)) {
-            result[key] = applyUtilities(value, utils);
-        }
-        else {
-            result[key] = value;
-        }
-    }
-    return result;
-}