zuljaman-banner-components 1.0.6 → 1.0.7

package/dist/components/styles/utils/calculations.js

@@ -0,0 +1,69 @@
+"use strict";
+/**
+ * Platform-agnostic calculation utilities
+ * Common mathematical operations and conversions used across all banner styles
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.lerp = exports.clamp = exports.percentStringToPixels = exports.parsePercent = exports.percentToPixels = exports.remToPixels = void 0;
+const defaults_1 = require("../../../constants/defaults");
+/**
+ * Convert rem units to pixels
+ * @param rem - Value in rem units
+ * @returns Value in pixels
+ */
+const remToPixels = (rem) => {
+    return rem * defaults_1.REM_TO_PIXELS;
+};
+exports.remToPixels = remToPixels;
+/**
+ * Convert percentage to pixels based on container size
+ * @param percent - Percentage value (0-100)
+ * @param containerSize - Container size in pixels
+ * @returns Value in pixels
+ */
+const percentToPixels = (percent, containerSize) => {
+    return (percent / 100) * containerSize;
+};
+exports.percentToPixels = percentToPixels;
+/**
+ * Parse a percentage string to a number
+ * @param percentString - String like "50%" or "10.5%"
+ * @returns Numeric percentage value (e.g., 50, 10.5)
+ */
+const parsePercent = (percentString) => {
+    return parseFloat(percentString.replace('%', ''));
+};
+exports.parsePercent = parsePercent;
+/**
+ * Calculate the pixel position from a percentage string and container size
+ * @param percentString - String like "50%" or "10%"
+ * @param containerSize - Container size in pixels
+ * @returns Position in pixels
+ */
+const percentStringToPixels = (percentString, containerSize) => {
+    const percent = (0, exports.parsePercent)(percentString);
+    return (0, exports.percentToPixels)(percent, containerSize);
+};
+exports.percentStringToPixels = percentStringToPixels;
+/**
+ * Clamp a value between min and max
+ * @param value - Value to clamp
+ * @param min - Minimum value
+ * @param max - Maximum value
+ * @returns Clamped value
+ */
+const clamp = (value, min, max) => {
+    return Math.min(Math.max(value, min), max);
+};
+exports.clamp = clamp;
+/**
+ * Linear interpolation between two values
+ * @param start - Start value
+ * @param end - End value
+ * @param t - Interpolation factor (0-1)
+ * @returns Interpolated value
+ */
+const lerp = (start, end, t) => {
+    return start + (end - start) * t;
+};
+exports.lerp = lerp;

package/dist/components/styles/utils/defaultsUtils.d.ts

@@ -0,0 +1,54 @@
+/**
+ * Default value utilities
+ * Provides helper functions for working with default values and fallbacks
+ */
+/**
+ * Get value with fallback to default
+ * @param value - Optional value
+ * @param defaultValue - Default value to use if value is undefined or null
+ * @returns Value or default
+ */
+export declare const getWithDefault: <T>(value: T | undefined | null, defaultValue: T) => T;
+/**
+ * Get numeric value with fallback to default
+ * @param value - Optional numeric value
+ * @param defaultValue - Default numeric value
+ * @returns Number or default
+ */
+export declare const getNumberWithDefault: (value: number | undefined | null, defaultValue: number) => number;
+/**
+ * Get string value with fallback to default
+ * @param value - Optional string value
+ * @param defaultValue - Default string value
+ * @returns String or default
+ */
+export declare const getStringWithDefault: (value: string | undefined | null, defaultValue: string) => string;
+/**
+ * Get boolean value with fallback to default
+ * @param value - Optional boolean value
+ * @param defaultValue - Default boolean value
+ * @returns Boolean or default
+ */
+export declare const getBooleanWithDefault: (value: boolean | undefined | null, defaultValue: boolean) => boolean;
+/**
+ * Merge two objects, with values from source overriding those in target
+ * @param target - Base object
+ * @param source - Object with override values
+ * @returns Merged object
+ */
+export declare const mergeDefaults: <T extends Record<string, any>>(target: T, source: Partial<T>) => T;
+/**
+ * Parse a string value to float with fallback
+ * @param value - String to parse
+ * @param defaultValue - Default value if parsing fails
+ * @returns Parsed float or default
+ */
+export declare const parseFloatWithDefault: (value: string | undefined | null, defaultValue: number) => number;
+/**
+ * Parse a string value to integer with fallback
+ * @param value - String to parse
+ * @param defaultValue - Default value if parsing fails
+ * @returns Parsed integer or default
+ */
+export declare const parseIntWithDefault: (value: string | undefined | null, defaultValue: number) => number;
+//# sourceMappingURL=defaultsUtils.d.ts.map

package/dist/components/styles/utils/defaultsUtils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"defaultsUtils.d.ts","sourceRoot":"","sources":["../../../../src/components/styles/utils/defaultsUtils.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;;;;GAKG;AACH,eAAO,MAAM,cAAc,GAAI,CAAC,EAAE,OAAO,CAAC,GAAG,SAAS,GAAG,IAAI,EAAE,cAAc,CAAC,KAAG,CAEhF,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,oBAAoB,GAAI,OAAO,MAAM,GAAG,SAAS,GAAG,IAAI,EAAE,cAAc,MAAM,KAAG,MAE7F,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,oBAAoB,GAAI,OAAO,MAAM,GAAG,SAAS,GAAG,IAAI,EAAE,cAAc,MAAM,KAAG,MAE7F,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,qBAAqB,GAAI,OAAO,OAAO,GAAG,SAAS,GAAG,IAAI,EAAE,cAAc,OAAO,KAAG,OAEhG,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,aAAa,GAAI,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAAE,QAAQ,CAAC,EAAE,QAAQ,OAAO,CAAC,CAAC,CAAC,KAAG,CAE5F,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,qBAAqB,GAAI,OAAO,MAAM,GAAG,SAAS,GAAG,IAAI,EAAE,cAAc,MAAM,KAAG,MAI9F,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,mBAAmB,GAAI,OAAO,MAAM,GAAG,SAAS,GAAG,IAAI,EAAE,cAAc,MAAM,KAAG,MAI5F,CAAC"}

package/dist/components/styles/utils/defaultsUtils.js

@@ -0,0 +1,83 @@
+"use strict";
+/**
+ * Default value utilities
+ * Provides helper functions for working with default values and fallbacks
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.parseIntWithDefault = exports.parseFloatWithDefault = exports.mergeDefaults = exports.getBooleanWithDefault = exports.getStringWithDefault = exports.getNumberWithDefault = exports.getWithDefault = void 0;
+/**
+ * Get value with fallback to default
+ * @param value - Optional value
+ * @param defaultValue - Default value to use if value is undefined or null
+ * @returns Value or default
+ */
+const getWithDefault = (value, defaultValue) => {
+    return value !== null && value !== void 0 ? value : defaultValue;
+};
+exports.getWithDefault = getWithDefault;
+/**
+ * Get numeric value with fallback to default
+ * @param value - Optional numeric value
+ * @param defaultValue - Default numeric value
+ * @returns Number or default
+ */
+const getNumberWithDefault = (value, defaultValue) => {
+    return value !== null && value !== void 0 ? value : defaultValue;
+};
+exports.getNumberWithDefault = getNumberWithDefault;
+/**
+ * Get string value with fallback to default
+ * @param value - Optional string value
+ * @param defaultValue - Default string value
+ * @returns String or default
+ */
+const getStringWithDefault = (value, defaultValue) => {
+    return value !== null && value !== void 0 ? value : defaultValue;
+};
+exports.getStringWithDefault = getStringWithDefault;
+/**
+ * Get boolean value with fallback to default
+ * @param value - Optional boolean value
+ * @param defaultValue - Default boolean value
+ * @returns Boolean or default
+ */
+const getBooleanWithDefault = (value, defaultValue) => {
+    return value !== null && value !== void 0 ? value : defaultValue;
+};
+exports.getBooleanWithDefault = getBooleanWithDefault;
+/**
+ * Merge two objects, with values from source overriding those in target
+ * @param target - Base object
+ * @param source - Object with override values
+ * @returns Merged object
+ */
+const mergeDefaults = (target, source) => {
+    return { ...target, ...source };
+};
+exports.mergeDefaults = mergeDefaults;
+/**
+ * Parse a string value to float with fallback
+ * @param value - String to parse
+ * @param defaultValue - Default value if parsing fails
+ * @returns Parsed float or default
+ */
+const parseFloatWithDefault = (value, defaultValue) => {
+    if (value === undefined || value === null)
+        return defaultValue;
+    const parsed = parseFloat(value);
+    return isNaN(parsed) ? defaultValue : parsed;
+};
+exports.parseFloatWithDefault = parseFloatWithDefault;
+/**
+ * Parse a string value to integer with fallback
+ * @param value - String to parse
+ * @param defaultValue - Default value if parsing fails
+ * @returns Parsed integer or default
+ */
+const parseIntWithDefault = (value, defaultValue) => {
+    if (value === undefined || value === null)
+        return defaultValue;
+    const parsed = parseInt(value, 10);
+    return isNaN(parsed) ? defaultValue : parsed;
+};
+exports.parseIntWithDefault = parseIntWithDefault;

package/dist/components/styles/utils/fontSizeUtils.d.ts

@@ -0,0 +1,32 @@
+/**
+ * Font size calculation utilities
+ * Handles font size calculations and conversions across all banner styles
+ */
+/**
+ * Calculate font size in rem units
+ * @param multiplier - Font size multiplier (e.g., 1.0 for base size, 1.5 for 150%)
+ * @param baseRem - Optional custom base size in rem (defaults to DEFAULT_BASE_FONT_SIZE_REM)
+ * @returns Font size in rem units as a string (e.g., "6rem")
+ */
+export declare const calculateFontSize: (multiplier: number, baseRem?: number) => string;
+/**
+ * Calculate font sizes for multiple copies
+ * @param fontSizeMultipliers - Array of font size multipliers for each copy
+ * @param baseRem - Optional custom base size in rem
+ * @returns Array of font size strings
+ */
+export declare const calculateFontSizes: (fontSizeMultipliers: number[], baseRem?: number) => string[];
+/**
+ * Convert font weight name to CSS font-weight value
+ * @param weight - Font weight name ('thin', 'normal', or 'bold')
+ * @returns CSS font-weight value as string
+ */
+export declare const getFontWeight: (weight: "thin" | "normal" | "bold") => string;
+/**
+ * Get font size multiplier with fallback to default
+ * @param multiplier - Font size multiplier or undefined
+ * @param defaultMultiplier - Default multiplier to use if undefined (defaults to 1.0)
+ * @returns Font size multiplier
+ */
+export declare const getFontSizeMultiplier: (multiplier?: number, defaultMultiplier?: number) => number;
+//# sourceMappingURL=fontSizeUtils.d.ts.map

package/dist/components/styles/utils/fontSizeUtils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fontSizeUtils.d.ts","sourceRoot":"","sources":["../../../../src/components/styles/utils/fontSizeUtils.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH;;;;;GAKG;AACH,eAAO,MAAM,iBAAiB,GAAI,YAAY,MAAM,EAAE,UAAS,MAAmC,KAAG,MAEpG,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,kBAAkB,GAC7B,qBAAqB,MAAM,EAAE,EAC7B,UAAS,MAAmC,KAC3C,MAAM,EAER,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,aAAa,GAAI,QAAQ,MAAM,GAAG,QAAQ,GAAG,MAAM,KAAG,MAOlE,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,qBAAqB,GAAI,aAAa,MAAM,EAAE,oBAAmB,MAAY,KAAG,MAE5F,CAAC"}

package/dist/components/styles/utils/fontSizeUtils.js

@@ -0,0 +1,52 @@
+"use strict";
+/**
+ * Font size calculation utilities
+ * Handles font size calculations and conversions across all banner styles
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getFontSizeMultiplier = exports.getFontWeight = exports.calculateFontSizes = exports.calculateFontSize = void 0;
+const defaults_1 = require("../../../constants/defaults");
+/**
+ * Calculate font size in rem units
+ * @param multiplier - Font size multiplier (e.g., 1.0 for base size, 1.5 for 150%)
+ * @param baseRem - Optional custom base size in rem (defaults to DEFAULT_BASE_FONT_SIZE_REM)
+ * @returns Font size in rem units as a string (e.g., "6rem")
+ */
+const calculateFontSize = (multiplier, baseRem = defaults_1.DEFAULT_BASE_FONT_SIZE_REM) => {
+    return `${baseRem * multiplier}rem`;
+};
+exports.calculateFontSize = calculateFontSize;
+/**
+ * Calculate font sizes for multiple copies
+ * @param fontSizeMultipliers - Array of font size multipliers for each copy
+ * @param baseRem - Optional custom base size in rem
+ * @returns Array of font size strings
+ */
+const calculateFontSizes = (fontSizeMultipliers, baseRem = defaults_1.DEFAULT_BASE_FONT_SIZE_REM) => {
+    return fontSizeMultipliers.map(multiplier => (0, exports.calculateFontSize)(multiplier, baseRem));
+};
+exports.calculateFontSizes = calculateFontSizes;
+/**
+ * Convert font weight name to CSS font-weight value
+ * @param weight - Font weight name ('thin', 'normal', or 'bold')
+ * @returns CSS font-weight value as string
+ */
+const getFontWeight = (weight) => {
+    switch (weight) {
+        case 'thin': return '300';
+        case 'normal': return '400';
+        case 'bold': return '700';
+        default: return '400';
+    }
+};
+exports.getFontWeight = getFontWeight;
+/**
+ * Get font size multiplier with fallback to default
+ * @param multiplier - Font size multiplier or undefined
+ * @param defaultMultiplier - Default multiplier to use if undefined (defaults to 1.0)
+ * @returns Font size multiplier
+ */
+const getFontSizeMultiplier = (multiplier, defaultMultiplier = 1.0) => {
+    return multiplier !== null && multiplier !== void 0 ? multiplier : defaultMultiplier;
+};
+exports.getFontSizeMultiplier = getFontSizeMultiplier;

package/dist/components/styles/utils/positioningUtils.d.ts

@@ -0,0 +1,38 @@
+/**
+ * Auto-positioning utility functions
+ * Handles automatic positioning of elements relative to anchor elements
+ * Adapted for absolute positioning system (x, y coordinates from center)
+ */
+import { SubstyleConfig, AutoPositioningConfig } from '../types/substyleTypes';
+/**
+ * Calculate auto-positioning offset for 'up' direction
+ * Target element will be positioned above the anchor with a gap
+ * @param gapRem - Gap in rem units
+ * @param anchorHeight - Height of anchor element in pixels
+ * @param targetHeight - Height of target element in pixels
+ * @param anchorHasCenterOrigin - Whether anchor is positioned from center (true) or top-left (false)
+ * @returns Offset in pixels (negative value to move up)
+ */
+export declare const calculateUpOffset: (gapRem: number, anchorHeight: number, targetHeight: number, anchorHasCenterOrigin: boolean) => number;
+/**
+ * Calculate auto-positioning offset for 'down' direction
+ * Target element will be positioned below the anchor with a gap
+ * @param gapRem - Gap in rem units
+ * @param anchorHeight - Height of anchor element in pixels
+ * @param targetHeight - Height of target element in pixels
+ * @param anchorHasCenterOrigin - Whether anchor is positioned from center (true) or top-left (false)
+ * @returns Offset in pixels (positive value to move down)
+ */
+export declare const calculateDownOffset: (gapRem: number, anchorHeight: number, targetHeight: number, anchorHasCenterOrigin: boolean) => number;
+/**
+ * Calculate auto-positioning offset based on direction
+ * Works with absolute positioning system where elements have x, y coordinates from center
+ * @param config - Substyle configuration
+ * @param autoConfig - Auto-positioning configuration
+ * @param anchorHeight - Height of anchor element in pixels
+ * @param targetHeight - Height of target element in pixels
+ * @param anchorHasCenterOrigin - Whether anchor is positioned from center (true) or top-left (false)
+ * @returns Offset in pixels (Y-axis only for now)
+ */
+export declare const calculateAutoPositionOffset: (config: SubstyleConfig, autoConfig: AutoPositioningConfig, anchorHeight: number, targetHeight: number, anchorHasCenterOrigin?: boolean) => number;
+//# sourceMappingURL=positioningUtils.d.ts.map

package/dist/components/styles/utils/positioningUtils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"positioningUtils.d.ts","sourceRoot":"","sources":["../../../../src/components/styles/utils/positioningUtils.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,cAAc,EAAE,qBAAqB,EAAE,MAAM,wBAAwB,CAAC;AAG/E;;;;;;;;GAQG;AACH,eAAO,MAAM,iBAAiB,GAAI,QAAQ,MAAM,EAAE,cAAc,MAAM,EAAE,cAAc,MAAM,EAAE,uBAAuB,OAAO,KAAG,MAY9H,CAAC;AAEF;;;;;;;;GAQG;AACH,eAAO,MAAM,mBAAmB,GAAI,QAAQ,MAAM,EAAE,cAAc,MAAM,EAAE,cAAc,MAAM,EAAE,uBAAuB,OAAO,KAAG,MAYhI,CAAC;AAEF;;;;;;;;;GASG;AACH,eAAO,MAAM,2BAA2B,GACtC,QAAQ,cAAc,EACtB,YAAY,qBAAqB,EACjC,cAAc,MAAM,EACpB,cAAc,MAAM,EACpB,wBAAuB,OAAc,KACpC,MAYF,CAAC"}

package/dist/components/styles/utils/positioningUtils.js

@@ -0,0 +1,79 @@
+"use strict";
+/**
+ * Auto-positioning utility functions
+ * Handles automatic positioning of elements relative to anchor elements
+ * Adapted for absolute positioning system (x, y coordinates from center)
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.calculateAutoPositionOffset = exports.calculateDownOffset = exports.calculateUpOffset = void 0;
+const defaults_1 = require("../../../constants/defaults");
+/**
+ * Calculate auto-positioning offset for 'up' direction
+ * Target element will be positioned above the anchor with a gap
+ * @param gapRem - Gap in rem units
+ * @param anchorHeight - Height of anchor element in pixels
+ * @param targetHeight - Height of target element in pixels
+ * @param anchorHasCenterOrigin - Whether anchor is positioned from center (true) or top-left (false)
+ * @returns Offset in pixels (negative value to move up)
+ */
+const calculateUpOffset = (gapRem, anchorHeight, targetHeight, anchorHasCenterOrigin) => {
+    const gapPixels = gapRem * defaults_1.REM_TO_PIXELS;
+    // Target always has centerOrigin=true (positioned from center)
+    const targetOffset = targetHeight / 2;
+    if (anchorHasCenterOrigin) {
+        // Anchor positioned from center: offset from center to center
+        return -((anchorHeight / 2) + gapPixels + targetOffset);
+    }
+    else {
+        // Anchor positioned from top-left: offset from top edge to center of target
+        return -(gapPixels + targetOffset);
+    }
+};
+exports.calculateUpOffset = calculateUpOffset;
+/**
+ * Calculate auto-positioning offset for 'down' direction
+ * Target element will be positioned below the anchor with a gap
+ * @param gapRem - Gap in rem units
+ * @param anchorHeight - Height of anchor element in pixels
+ * @param targetHeight - Height of target element in pixels
+ * @param anchorHasCenterOrigin - Whether anchor is positioned from center (true) or top-left (false)
+ * @returns Offset in pixels (positive value to move down)
+ */
+const calculateDownOffset = (gapRem, anchorHeight, targetHeight, anchorHasCenterOrigin) => {
+    const gapPixels = gapRem * defaults_1.REM_TO_PIXELS;
+    // Target always has centerOrigin=true (positioned from center)
+    const targetOffset = targetHeight / 2;
+    if (anchorHasCenterOrigin) {
+        // Anchor positioned from center: offset from center to center
+        return (anchorHeight / 2) + gapPixels + targetOffset;
+    }
+    else {
+        // Anchor positioned from top-left: offset from bottom edge to center of target
+        return anchorHeight + gapPixels + targetOffset;
+    }
+};
+exports.calculateDownOffset = calculateDownOffset;
+/**
+ * Calculate auto-positioning offset based on direction
+ * Works with absolute positioning system where elements have x, y coordinates from center
+ * @param config - Substyle configuration
+ * @param autoConfig - Auto-positioning configuration
+ * @param anchorHeight - Height of anchor element in pixels
+ * @param targetHeight - Height of target element in pixels
+ * @param anchorHasCenterOrigin - Whether anchor is positioned from center (true) or top-left (false)
+ * @returns Offset in pixels (Y-axis only for now)
+ */
+const calculateAutoPositionOffset = (config, autoConfig, anchorHeight, targetHeight, anchorHasCenterOrigin = true) => {
+    var _a;
+    const { direction } = autoConfig;
+    const gapRem = (_a = config.gapRem) !== null && _a !== void 0 ? _a : 0;
+    if (direction === 'up') {
+        return (0, exports.calculateUpOffset)(gapRem, anchorHeight, targetHeight, anchorHasCenterOrigin);
+    }
+    else if (direction === 'down') {
+        return (0, exports.calculateDownOffset)(gapRem, anchorHeight, targetHeight, anchorHasCenterOrigin);
+    }
+    // Note: left/right directions would need X-axis offset (not implemented yet, only Y-axis)
+    return 0;
+};
+exports.calculateAutoPositionOffset = calculateAutoPositionOffset;

package/dist/components/styles/utils/substyleUtils.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Shared utility functions for substyle configurations
+ * Provides common getter and helper functions used across all styles
+ */
+import { SubstyleConfig } from '../types/substyleTypes';
+/**
+ * Get configuration for a specific substyle with fallback to default
+ * @param configs - Record of substyle configurations
+ * @param substyle - Substyle number to retrieve
+ * @param defaultSubstyle - Default substyle to use if specified substyle not found (default: 1)
+ * @returns SubstyleConfig for the specified substyle
+ */
+export declare const getSubstyleConfig: (configs: Record<number, SubstyleConfig>, substyle: number, defaultSubstyle?: number) => SubstyleConfig;
+//# sourceMappingURL=substyleUtils.d.ts.map

package/dist/components/styles/utils/substyleUtils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"substyleUtils.d.ts","sourceRoot":"","sources":["../../../../src/components/styles/utils/substyleUtils.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAExD;;;;;;GAMG;AACH,eAAO,MAAM,iBAAiB,GAC5B,SAAS,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,EACvC,UAAU,MAAM,EAChB,kBAAiB,MAAU,KAC1B,cAEF,CAAC"}

package/dist/components/styles/utils/substyleUtils.js

@@ -0,0 +1,18 @@
+"use strict";
+/**
+ * Shared utility functions for substyle configurations
+ * Provides common getter and helper functions used across all styles
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getSubstyleConfig = void 0;
+/**
+ * Get configuration for a specific substyle with fallback to default
+ * @param configs - Record of substyle configurations
+ * @param substyle - Substyle number to retrieve
+ * @param defaultSubstyle - Default substyle to use if specified substyle not found (default: 1)
+ * @returns SubstyleConfig for the specified substyle
+ */
+const getSubstyleConfig = (configs, substyle, defaultSubstyle = 1) => {
+    return configs[substyle] || configs[defaultSubstyle];
+};
+exports.getSubstyleConfig = getSubstyleConfig;

package/dist/components/styles/utils/transformUtils.d.ts

@@ -0,0 +1,36 @@
+/**
+ * Utility functions for CSS transform operations
+ * Provides helpers for building transform strings for rotation, translation, etc.
+ */
+/**
+ * Build a translate transform string
+ * @param x - X translation in pixels
+ * @param y - Y translation in pixels
+ * @returns CSS transform string
+ */
+export declare const buildTranslateTransform: (x?: number, y?: number) => string;
+/**
+ * Build a translateX transform string
+ * @param percent - X translation as percentage string (e.g., "-50%")
+ * @returns CSS transform string
+ */
+export declare const buildTranslateXTransform: (percent: string) => string;
+/**
+ * Build a translateY transform string
+ * @param percent - Y translation as percentage string (e.g., "-50%")
+ * @returns CSS transform string
+ */
+export declare const buildTranslateYTransform: (percent: string) => string;
+/**
+ * Build a rotate transform string
+ * @param degrees - Rotation in degrees
+ * @returns CSS transform string
+ */
+export declare const buildRotateTransform: (degrees: number) => string;
+/**
+ * Combine multiple transform operations into a single transform string
+ * @param transforms - Array of transform strings
+ * @returns Combined CSS transform string
+ */
+export declare const combineTransforms: (...transforms: string[]) => string;
+//# sourceMappingURL=transformUtils.d.ts.map

package/dist/components/styles/utils/transformUtils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"transformUtils.d.ts","sourceRoot":"","sources":["../../../../src/components/styles/utils/transformUtils.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;;;;GAKG;AACH,eAAO,MAAM,uBAAuB,GAAI,IAAG,MAAU,EAAE,IAAG,MAAU,KAAG,MAEtE,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,wBAAwB,GAAI,SAAS,MAAM,KAAG,MAE1D,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,wBAAwB,GAAI,SAAS,MAAM,KAAG,MAE1D,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,oBAAoB,GAAI,SAAS,MAAM,KAAG,MAEtD,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,iBAAiB,GAAI,GAAG,YAAY,MAAM,EAAE,KAAG,MAE3D,CAAC"}

package/dist/components/styles/utils/transformUtils.js

@@ -0,0 +1,53 @@
+"use strict";
+/**
+ * Utility functions for CSS transform operations
+ * Provides helpers for building transform strings for rotation, translation, etc.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.combineTransforms = exports.buildRotateTransform = exports.buildTranslateYTransform = exports.buildTranslateXTransform = exports.buildTranslateTransform = void 0;
+/**
+ * Build a translate transform string
+ * @param x - X translation in pixels
+ * @param y - Y translation in pixels
+ * @returns CSS transform string
+ */
+const buildTranslateTransform = (x = 0, y = 0) => {
+    return `translate(${x}px, ${y}px)`;
+};
+exports.buildTranslateTransform = buildTranslateTransform;
+/**
+ * Build a translateX transform string
+ * @param percent - X translation as percentage string (e.g., "-50%")
+ * @returns CSS transform string
+ */
+const buildTranslateXTransform = (percent) => {
+    return `translateX(${percent})`;
+};
+exports.buildTranslateXTransform = buildTranslateXTransform;
+/**
+ * Build a translateY transform string
+ * @param percent - Y translation as percentage string (e.g., "-50%")
+ * @returns CSS transform string
+ */
+const buildTranslateYTransform = (percent) => {
+    return `translateY(${percent})`;
+};
+exports.buildTranslateYTransform = buildTranslateYTransform;
+/**
+ * Build a rotate transform string
+ * @param degrees - Rotation in degrees
+ * @returns CSS transform string
+ */
+const buildRotateTransform = (degrees) => {
+    return `rotate(${degrees}deg)`;
+};
+exports.buildRotateTransform = buildRotateTransform;
+/**
+ * Combine multiple transform operations into a single transform string
+ * @param transforms - Array of transform strings
+ * @returns Combined CSS transform string
+ */
+const combineTransforms = (...transforms) => {
+    return transforms.filter(Boolean).join(' ');
+};
+exports.combineTransforms = combineTransforms;

package/dist/constants/characterLimits.d.ts

@@ -0,0 +1,97 @@
+/**
+ * Recommended character limits for optimal display in banner styles
+ * Based on maxLengthThreshold values used in font size calculations
+ */
+export interface StyleCharacterLimits {
+    copy1: number;
+    copy2?: number;
+    copyCount: number;
+}
+export interface BannerConfig {
+    copy1: {
+        supported: true;
+        characterLimit: number;
+        isOptional: boolean;
+    };
+    copy2?: {
+        supported: boolean;
+        characterLimit?: number;
+        isOptional?: boolean;
+    };
+    fontSize_01: {
+        supported: true;
+    };
+    fontSize_02?: {
+        supported: boolean;
+    };
+    logoUrl: {
+        supported: true;
+    };
+    backgroundImageUrl: {
+        supported: true;
+    };
+    overlayIntensityMultiplier: {
+        supported: true;
+    };
+    shadowIntensityMultiplier: {
+        supported: boolean;
+    };
+    logoSizeMultiplier: {
+        supported: true;
+    };
+}
+export interface CharacterLimitsConfig {
+    [styleNumber: number]: {
+        [substyleNumber: number]: StyleCharacterLimits;
+    };
+}
+export interface BannerConfigMap {
+    [styleNumber: number]: {
+        [substyleNumber: number]: BannerConfig;
+    };
+}
+/**
+ * Recommended character limits for each style and substyle
+ * These numbers represent the optimal text length for best visual appearance
+ * Updated for 4 styles with 3 substyles each
+ */
+export declare const RECOMMENDED_CHARACTER_LIMITS: CharacterLimitsConfig;
+/**
+ * Get recommended character limits for a specific style and substyle
+ * @param styleNumber - Banner style number (1-4)
+ * @param substyleNumber - Banner substyle number (1-3)
+ * @returns Character limits object or null if not found
+ */
+export declare const getCharacterLimits: (styleNumber: number, substyleNumber: number) => StyleCharacterLimits | null;
+/**
+ * Complete banner configuration for all style combinations
+ * Defines which props each style supports and their character limits
+ * Updated for 4 styles with 3 substyles each
+ */
+export declare const BANNER_CONFIGURATIONS: BannerConfigMap;
+/**
+ * Get complete banner configuration for a specific style combination
+ * @param styleNumber - Banner style number (1-4)
+ * @param substyleNumber - Banner substyle number (1-3)
+ * @returns Complete banner configuration or null if not found
+ */
+export declare const getBannerConfig: (styleNumber: number, substyleNumber: number) => BannerConfig | null;
+/**
+ * Check if text exceeds recommended limits
+ * @param text - Text to check
+ * @param limit - Character limit
+ * @returns true if text exceeds limit
+ */
+export declare const exceedsLimit: (text: string | undefined, limit: number) => boolean;
+/**
+ * Get all available style numbers
+ * @returns Array of available style numbers
+ */
+export declare const getAvailableStyles: () => number[];
+/**
+ * Get all available substyle numbers for a given style
+ * @param styleNumber - Banner style number
+ * @returns Array of available substyle numbers for that style
+ */
+export declare const getAvailableSubstyles: (styleNumber: number) => number[];
+//# sourceMappingURL=characterLimits.d.ts.map

package/dist/constants/characterLimits.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"characterLimits.d.ts","sourceRoot":"","sources":["../../src/constants/characterLimits.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,WAAW,oBAAoB;IACnC,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,YAAY;IAC3B,KAAK,EAAE;QAAE,SAAS,EAAE,IAAI,CAAC;QAAC,cAAc,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,OAAO,CAAA;KAAE,CAAC;IACxE,KAAK,CAAC,EAAE;QAAE,SAAS,EAAE,OAAO,CAAC;QAAC,cAAc,CAAC,EAAE,MAAM,CAAC;QAAC,UAAU,CAAC,EAAE,OAAO,CAAA;KAAE,CAAC;IAC9E,WAAW,EAAE;QAAE,SAAS,EAAE,IAAI,CAAA;KAAE,CAAC;IACjC,WAAW,CAAC,EAAE;QAAE,SAAS,EAAE,OAAO,CAAA;KAAE,CAAC;IACrC,OAAO,EAAE;QAAE,SAAS,EAAE,IAAI,CAAA;KAAE,CAAC;IAC7B,kBAAkB,EAAE;QAAE,SAAS,EAAE,IAAI,CAAA;KAAE,CAAC;IACxC,0BAA0B,EAAE;QAAE,SAAS,EAAE,IAAI,CAAA;KAAE,CAAC;IAChD,yBAAyB,EAAE;QAAE,SAAS,EAAE,OAAO,CAAA;KAAE,CAAC;IAClD,kBAAkB,EAAE;QAAE,SAAS,EAAE,IAAI,CAAA;KAAE,CAAC;CACzC;AAED,MAAM,WAAW,qBAAqB;IACpC,CAAC,WAAW,EAAE,MAAM,GAAG;QACrB,CAAC,cAAc,EAAE,MAAM,GAAG,oBAAoB,CAAC;KAChD,CAAC;CACH;AAED,MAAM,WAAW,eAAe;IAC9B,CAAC,WAAW,EAAE,MAAM,GAAG;QACrB,CAAC,cAAc,EAAE,MAAM,GAAG,YAAY,CAAC;KACxC,CAAC;CACH;AAED;;;;GAIG;AACH,eAAO,MAAM,4BAA4B,EAAE,qBAqB1C,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,kBAAkB,GAC7B,aAAa,MAAM,EACnB,gBAAgB,MAAM,KACrB,oBAAoB,GAAG,IAEzB,CAAC;AA4BF;;;;GAIG;AACH,eAAO,MAAM,qBAAqB,EAAE,eAyBnC,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,eAAe,GAC1B,aAAa,MAAM,EACnB,gBAAgB,MAAM,KACrB,YAAY,GAAG,IAEjB,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,YAAY,GAAI,MAAM,MAAM,GAAG,SAAS,EAAE,OAAO,MAAM,KAAG,OAItE,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,kBAAkB,QAAO,MAAM,EAE3C,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,qBAAqB,GAAI,aAAa,MAAM,KAAG,MAAM,EAIjE,CAAC"}