@nice2dev/icons 1.0.0 → 1.0.3

package/dist/esm/tailwind-plugin.js

@@ -0,0 +1,337 @@
+/**
+ * @file tailwind-plugin.ts
+ * @description Tailwind CSS Plugin for @nice2dev/icons
+ *
+ * Enables Tailwind CSS utility classes directly on NiceToDev icons:
+ * <NtdHome className="text-blue-500 w-6 h-6 hover:text-blue-700" />
+ *
+ * @version 1.0.0
+ * @since 2026-03
+ * @license MIT
+ */
+const defaultSizes = {
+    xs: '0.75rem',
+    sm: '1rem',
+    md: '1.5rem',
+    lg: '2rem',
+    xl: '3rem',
+    '2xl': '4rem',
+};
+/**
+ * Tailwind CSS Plugin for NiceToDev Icons
+ *
+ * @example
+ * // tailwind.config.js
+ * import { ntdIconPlugin } from '@nice2dev/icons/tailwind';
+ *
+ * export default {
+ *   plugins: [
+ *     ntdIconPlugin({
+ *       prefix: 'ntd-icon',
+ *       animations: true,
+ *     }),
+ *   ],
+ * };
+ *
+ * @example
+ * // Usage in components
+ * <NtdHome className="ntd-icon-md text-blue-500 hover:ntd-icon-bounce" />
+ * <NtdStar className="ntd-icon-lg ntd-icon-spin text-yellow-400" />
+ */
+const ntdIconPlugin = (options = {}) => {
+    const { prefix = 'ntd-icon', sizes = defaultSizes, animations = true, variantUtilities = true, } = options;
+    return function ({ addUtilities, addComponents, theme, matchUtilities }) {
+        // ─────────────────────────────────────────────────────────────────────
+        // SIZE UTILITIES
+        // ─────────────────────────────────────────────────────────────────────
+        const sizeUtilities = {};
+        Object.entries(sizes).forEach(([key, value]) => {
+            sizeUtilities[`.${prefix}-${key}`] = {
+                width: value,
+                height: value,
+            };
+        });
+        addUtilities(sizeUtilities);
+        // Dynamic sizing using Tailwind's spacing scale
+        matchUtilities({
+            [`${prefix}-size`]: (value) => ({
+                width: value,
+                height: value,
+            }),
+        }, { values: theme('spacing') });
+        // ─────────────────────────────────────────────────────────────────────
+        // COLOR UTILITIES (for SVG icons)
+        // ─────────────────────────────────────────────────────────────────────
+        const colorUtilities = {
+            // Primary color (main icon color)
+            [`.${prefix}-current`]: {
+                color: 'currentColor',
+                '--ntd-primary-color': 'currentColor',
+            },
+            // For duotone: secondary color
+            [`.${prefix}-secondary-current`]: {
+                '--ntd-secondary-color': 'currentColor',
+            },
+            // Opacity for secondary color in duotone
+            [`.${prefix}-secondary-opacity-25`]: {
+                '--ntd-secondary-opacity': '0.25',
+            },
+            [`.${prefix}-secondary-opacity-50`]: {
+                '--ntd-secondary-opacity': '0.5',
+            },
+            [`.${prefix}-secondary-opacity-75`]: {
+                '--ntd-secondary-opacity': '0.75',
+            },
+        };
+        addUtilities(colorUtilities);
+        // Dynamic color matching using Tailwind's color palette
+        matchUtilities({
+            [`${prefix}-primary`]: (value) => ({
+                '--ntd-primary-color': value,
+            }),
+            [`${prefix}-secondary`]: (value) => ({
+                '--ntd-secondary-color': value,
+            }),
+        }, { values: flattenColorPalette(theme('colors')) });
+        // ─────────────────────────────────────────────────────────────────────
+        // STROKE WIDTH UTILITIES
+        // ─────────────────────────────────────────────────────────────────────
+        const strokeUtilities = {
+            [`.${prefix}-stroke-thin`]: {
+                '--ntd-stroke-width': '1',
+            },
+            [`.${prefix}-stroke-normal`]: {
+                '--ntd-stroke-width': '1.5',
+            },
+            [`.${prefix}-stroke-medium`]: {
+                '--ntd-stroke-width': '2',
+            },
+            [`.${prefix}-stroke-thick`]: {
+                '--ntd-stroke-width': '2.5',
+            },
+            [`.${prefix}-stroke-bold`]: {
+                '--ntd-stroke-width': '3',
+            },
+        };
+        addUtilities(strokeUtilities);
+        matchUtilities({
+            [`${prefix}-stroke`]: (value) => ({
+                '--ntd-stroke-width': value,
+            }),
+        }, { values: { '0.5': '0.5', '1': '1', '1.5': '1.5', '2': '2', '2.5': '2.5', '3': '3' } });
+        // ─────────────────────────────────────────────────────────────────────
+        // VARIANT UTILITIES
+        // ─────────────────────────────────────────────────────────────────────
+        if (variantUtilities) {
+            const variantClasses = {
+                [`.${prefix}-solid`]: {
+                    '--ntd-variant': 'solid',
+                },
+                [`.${prefix}-outline`]: {
+                    '--ntd-variant': 'outline',
+                },
+                [`.${prefix}-duotone`]: {
+                    '--ntd-variant': 'duotone',
+                },
+                [`.${prefix}-flat`]: {
+                    '--ntd-variant': 'flat',
+                },
+            };
+            addUtilities(variantClasses);
+        }
+        // ─────────────────────────────────────────────────────────────────────
+        // ANIMATION UTILITIES
+        // ─────────────────────────────────────────────────────────────────────
+        if (animations) {
+            const animationUtilities = {
+                // Spin animation
+                [`.${prefix}-spin`]: {
+                    animation: `${prefix}-spin 1s linear infinite`,
+                },
+                [`.${prefix}-spin-slow`]: {
+                    animation: `${prefix}-spin 2s linear infinite`,
+                },
+                [`.${prefix}-spin-fast`]: {
+                    animation: `${prefix}-spin 0.5s linear infinite`,
+                },
+                // Pulse animation
+                [`.${prefix}-pulse`]: {
+                    animation: `${prefix}-pulse 2s ease-in-out infinite`,
+                },
+                // Bounce animation
+                [`.${prefix}-bounce`]: {
+                    animation: `${prefix}-bounce 1s ease-in-out infinite`,
+                },
+                // Shake animation (for errors/alerts)
+                [`.${prefix}-shake`]: {
+                    animation: `${prefix}-shake 0.5s ease-in-out`,
+                },
+                // Fade in
+                [`.${prefix}-fade-in`]: {
+                    animation: `${prefix}-fade-in 0.3s ease-out`,
+                },
+                // Scale up
+                [`.${prefix}-scale-in`]: {
+                    animation: `${prefix}-scale-in 0.2s ease-out`,
+                },
+                // Wiggle (for attention)
+                [`.${prefix}-wiggle`]: {
+                    animation: `${prefix}-wiggle 0.5s ease-in-out`,
+                },
+                // Float (subtle up/down)
+                [`.${prefix}-float`]: {
+                    animation: `${prefix}-float 3s ease-in-out infinite`,
+                },
+                // Glow effect
+                [`.${prefix}-glow`]: {
+                    filter: 'drop-shadow(0 0 8px currentColor)',
+                    animation: `${prefix}-glow 2s ease-in-out infinite alternate`,
+                },
+            };
+            addUtilities(animationUtilities);
+            // Keyframes for animations
+            addComponents({
+                [`@keyframes ${prefix}-spin`]: {
+                    from: { transform: 'rotate(0deg)' },
+                    to: { transform: 'rotate(360deg)' },
+                },
+                [`@keyframes ${prefix}-pulse`]: {
+                    '0%, 100%': { opacity: '1' },
+                    '50%': { opacity: '0.5' },
+                },
+                [`@keyframes ${prefix}-bounce`]: {
+                    '0%, 100%': { transform: 'translateY(0)' },
+                    '50%': { transform: 'translateY(-25%)' },
+                },
+                [`@keyframes ${prefix}-shake`]: {
+                    '0%, 100%': { transform: 'translateX(0)' },
+                    '10%, 30%, 50%, 70%, 90%': { transform: 'translateX(-4px)' },
+                    '20%, 40%, 60%, 80%': { transform: 'translateX(4px)' },
+                },
+                [`@keyframes ${prefix}-fade-in`]: {
+                    from: { opacity: '0' },
+                    to: { opacity: '1' },
+                },
+                [`@keyframes ${prefix}-scale-in`]: {
+                    from: { transform: 'scale(0.8)', opacity: '0' },
+                    to: { transform: 'scale(1)', opacity: '1' },
+                },
+                [`@keyframes ${prefix}-wiggle`]: {
+                    '0%, 100%': { transform: 'rotate(0deg)' },
+                    '25%': { transform: 'rotate(-5deg)' },
+                    '75%': { transform: 'rotate(5deg)' },
+                },
+                [`@keyframes ${prefix}-float`]: {
+                    '0%, 100%': { transform: 'translateY(0)' },
+                    '50%': { transform: 'translateY(-10%)' },
+                },
+                [`@keyframes ${prefix}-glow`]: {
+                    from: { filter: 'drop-shadow(0 0 4px currentColor)' },
+                    to: { filter: 'drop-shadow(0 0 12px currentColor)' },
+                },
+            });
+            // Hover animations
+            const hoverAnimations = {
+                [`.hover\\:${prefix}-bounce:hover`]: {
+                    animation: `${prefix}-bounce 0.5s ease-in-out`,
+                },
+                [`.hover\\:${prefix}-shake:hover`]: {
+                    animation: `${prefix}-shake 0.5s ease-in-out`,
+                },
+                [`.hover\\:${prefix}-wiggle:hover`]: {
+                    animation: `${prefix}-wiggle 0.5s ease-in-out`,
+                },
+                [`.hover\\:${prefix}-scale:hover`]: {
+                    transform: 'scale(1.1)',
+                    transition: 'transform 0.2s ease-out',
+                },
+                [`.hover\\:${prefix}-glow:hover`]: {
+                    filter: 'drop-shadow(0 0 8px currentColor)',
+                },
+            };
+            addUtilities(hoverAnimations);
+        }
+        // ─────────────────────────────────────────────────────────────────────
+        // TRANSITION UTILITIES
+        // ─────────────────────────────────────────────────────────────────────
+        const transitionUtilities = {
+            [`.${prefix}-transition`]: {
+                transition: 'all 0.2s ease-out',
+            },
+            [`.${prefix}-transition-fast`]: {
+                transition: 'all 0.1s ease-out',
+            },
+            [`.${prefix}-transition-slow`]: {
+                transition: 'all 0.3s ease-out',
+            },
+            [`.${prefix}-transition-colors`]: {
+                transition: 'color 0.2s ease-out, fill 0.2s ease-out, stroke 0.2s ease-out',
+            },
+        };
+        addUtilities(transitionUtilities);
+        // ─────────────────────────────────────────────────────────────────────
+        // ACCESSIBILITY UTILITIES
+        // ─────────────────────────────────────────────────────────────────────
+        const a11yUtilities = {
+            // Reduced motion support
+            [`@media (prefers-reduced-motion: reduce)`]: {
+                [`.${prefix}-spin, .${prefix}-spin-slow, .${prefix}-spin-fast, .${prefix}-pulse, .${prefix}-bounce, .${prefix}-shake, .${prefix}-wiggle, .${prefix}-float, .${prefix}-glow`]: {
+                    animation: 'none !important',
+                },
+            },
+            // Focus visible outline
+            [`.${prefix}-focus-visible:focus-visible`]: {
+                outline: '2px solid currentColor',
+                outlineOffset: '2px',
+            },
+            // High contrast mode
+            [`@media (forced-colors: active)`]: {
+                [`.${prefix}-high-contrast`]: {
+                    forcedColorAdjust: 'auto',
+                },
+            },
+        };
+        addComponents(a11yUtilities);
+    };
+};
+/**
+ * Helper to flatten color palette for matchUtilities
+ */
+function flattenColorPalette(colors) {
+    const result = {};
+    function flatten(obj, prefix = '') {
+        for (const [key, value] of Object.entries(obj)) {
+            if (typeof value === 'string') {
+                result[prefix ? `${prefix}-${key}` : key] = value;
+            }
+            else if (typeof value === 'object' && value !== null) {
+                flatten(value, prefix ? `${prefix}-${key}` : key);
+            }
+        }
+    }
+    flatten(colors);
+    return result;
+}
+/**
+ * Preset for common icon configurations
+ */
+const ntdIconPreset = {
+    theme: {
+        extend: {
+            colors: {
+                'ntd': {
+                    primary: '#3B82F6',
+                    secondary: '#64748B',
+                    accent: '#8B5CF6',
+                    success: '#22C55E',
+                    warning: '#F59E0B',
+                    error: '#EF4444',
+                    info: '#06B6D4',
+                },
+            },
+        },
+    },
+};
+
+export { ntdIconPlugin, ntdIconPreset };
+//# sourceMappingURL=tailwind-plugin.js.map

package/dist/esm/tailwind-plugin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tailwind-plugin.js","sources":["../../src/tailwind-plugin.ts"],"sourcesContent":[null],"names":[],"mappings":"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"}

package/dist/esm/types.js

@@ -1,3 +1,39 @@
+/**
+ * Default colors for semantic color variants.
+ * These are used when CSS variables are not defined.
+ */
+const SEMANTIC_COLOR_DEFAULTS = {
+    success: '#22c55e', // Green 500
+    warning: '#f59e0b', // Amber 500
+    error: '#ef4444', // Red 500
+    info: '#3b82f6', // Blue 500
+    muted: '#6b7280', // Gray 500
+    primary: '#6366f1', // Indigo 500
+    secondary: '#8b5cf6', // Violet 500
+    accent: '#ec4899', // Pink 500
+};
+/**
+ * CSS variable names for semantic colors.
+ * Define these in your CSS to customize icon colors globally.
+ *
+ * @example
+ * ```css
+ * :root {
+ *   --ntd-icon-success: #10b981;
+ *   --ntd-icon-error: #dc2626;
+ * }
+ * ```
+ */
+const SEMANTIC_COLOR_VARS = {
+    success: '--ntd-icon-success',
+    warning: '--ntd-icon-warning',
+    error: '--ntd-icon-error',
+    info: '--ntd-icon-info',
+    muted: '--ntd-icon-muted',
+    primary: '--ntd-icon-primary',
+    secondary: '--ntd-icon-secondary',
+    accent: '--ntd-icon-accent',
+};
 /** Gradient preset color stops. */
 const GRADIENT_PRESETS = {
     sunset: ['#ff6b6b', '#feca57', '#ff9ff3'],
@@ -40,5 +76,5 @@ const SIZE_MAP = {
     xxxl: 128,
 };
 
-export { GRADIENT_PRESETS, SIZE_MAP };
+export { GRADIENT_PRESETS, SEMANTIC_COLOR_DEFAULTS, SEMANTIC_COLOR_VARS, SIZE_MAP };
 //# sourceMappingURL=types.js.map

package/dist/esm/types.js.map

@@ -1 +1 @@
-{"version":3,"file":"types.js","sources":["../../src/types.ts"],"sourcesContent":[null],"names":[],"mappings":"AA2LA;AACO,MAAM,gBAAgB,GAA8C;AACzE,IAAA,MAAM,EAAS,CAAC,SAAS,EAAE,SAAS,EAAE,SAAS,CAAC;AAChD,IAAA,KAAK,EAAU,CAAC,SAAS,EAAE,SAAS,EAAE,SAAS,CAAC;AAChD,IAAA,MAAM,EAAS,CAAC,SAAS,EAAE,SAAS,EAAE,SAAS,CAAC;AAChD,IAAA,IAAI,EAAW,CAAC,SAAS,EAAE,SAAS,EAAE,SAAS,CAAC;AAChD,IAAA,GAAG,EAAY,CAAC,SAAS,EAAE,SAAS,EAAE,SAAS,CAAC;AAChD,IAAA,IAAI,EAAW,CAAC,SAAS,EAAE,SAAS,EAAE,SAAS,CAAC;AAChD,IAAA,IAAI,EAAW,CAAC,SAAS,EAAE,SAAS,EAAE,SAAS,CAAC;AAChD,IAAA,aAAa,EAAE,CAAC,SAAS,EAAE,SAAS,EAAE,SAAS,CAAC;IAChD,MAAM,EAAS,CAAC,SAAS,EAAE,SAAS,EAAE,SAAS,EAAE,SAAS,CAAC;AAC3D,IAAA,QAAQ,EAAO,CAAC,SAAS,EAAE,SAAS,EAAE,SAAS,CAAC;AAChD,IAAA,KAAK,EAAU,CAAC,SAAS,EAAE,SAAS,EAAE,SAAS,CAAC;AAChD,IAAA,KAAK,EAAU,CAAC,SAAS,EAAE,SAAS,EAAE,SAAS,CAAC;;AAgGlD;;;;;;;;;;;;;;;AAeG;AACI,MAAM,QAAQ,GAA2B;AAC9C,IAAA,EAAE,EAAE,EAAE;AACN,IAAA,EAAE,EAAE,EAAE;AACN,IAAA,EAAE,EAAE,EAAE;AACN,IAAA,EAAE,EAAE,EAAE;AACN,IAAA,EAAE,EAAE,EAAE;AACN,IAAA,KAAK,EAAE,EAAE;AACT,IAAA,GAAG,EAAE,EAAE;AACP,IAAA,IAAI,EAAE,GAAG;;;;;"}
+{"version":3,"file":"types.js","sources":["../../src/types.ts"],"sourcesContent":[null],"names":[],"mappings":"AAkNA;;;AAGG;AACI,MAAM,uBAAuB,GAAkC;IACpE,OAAO,EAAE,SAAS;IAClB,OAAO,EAAE,SAAS;IAClB,KAAK,EAAE,SAAS;IAChB,IAAI,EAAE,SAAS;IACf,KAAK,EAAE,SAAS;IAChB,OAAO,EAAE,SAAS;IAClB,SAAS,EAAE,SAAS;IACpB,MAAM,EAAE,SAAS;;AAGnB;;;;;;;;;;;AAWG;AACI,MAAM,mBAAmB,GAAkC;AAChE,IAAA,OAAO,EAAE,oBAAoB;AAC7B,IAAA,OAAO,EAAE,oBAAoB;AAC7B,IAAA,KAAK,EAAE,kBAAkB;AACzB,IAAA,IAAI,EAAE,iBAAiB;AACvB,IAAA,KAAK,EAAE,kBAAkB;AACzB,IAAA,OAAO,EAAE,oBAAoB;AAC7B,IAAA,SAAS,EAAE,sBAAsB;AACjC,IAAA,MAAM,EAAE,mBAAmB;;AAG7B;AACO,MAAM,gBAAgB,GAA8C;AACzE,IAAA,MAAM,EAAS,CAAC,SAAS,EAAE,SAAS,EAAE,SAAS,CAAC;AAChD,IAAA,KAAK,EAAU,CAAC,SAAS,EAAE,SAAS,EAAE,SAAS,CAAC;AAChD,IAAA,MAAM,EAAS,CAAC,SAAS,EAAE,SAAS,EAAE,SAAS,CAAC;AAChD,IAAA,IAAI,EAAW,CAAC,SAAS,EAAE,SAAS,EAAE,SAAS,CAAC;AAChD,IAAA,GAAG,EAAY,CAAC,SAAS,EAAE,SAAS,EAAE,SAAS,CAAC;AAChD,IAAA,IAAI,EAAW,CAAC,SAAS,EAAE,SAAS,EAAE,SAAS,CAAC;AAChD,IAAA,IAAI,EAAW,CAAC,SAAS,EAAE,SAAS,EAAE,SAAS,CAAC;AAChD,IAAA,aAAa,EAAE,CAAC,SAAS,EAAE,SAAS,EAAE,SAAS,CAAC;IAChD,MAAM,EAAS,CAAC,SAAS,EAAE,SAAS,EAAE,SAAS,EAAE,SAAS,CAAC;AAC3D,IAAA,QAAQ,EAAO,CAAC,SAAS,EAAE,SAAS,EAAE,SAAS,CAAC;AAChD,IAAA,KAAK,EAAU,CAAC,SAAS,EAAE,SAAS,EAAE,SAAS,CAAC;AAChD,IAAA,KAAK,EAAU,CAAC,SAAS,EAAE,SAAS,EAAE,SAAS,CAAC;;AAoLlD;;;;;;;;;;;;;;;AAeG;AACI,MAAM,QAAQ,GAA2B;AAC9C,IAAA,EAAE,EAAE,EAAE;AACN,IAAA,EAAE,EAAE,EAAE;AACN,IAAA,EAAE,EAAE,EAAE;AACN,IAAA,EAAE,EAAE,EAAE;AACN,IAAA,EAAE,EAAE,EAAE;AACN,IAAA,KAAK,EAAE,EAAE;AACT,IAAA,GAAG,EAAE,EAAE;AACP,IAAA,IAAI,EAAE,GAAG;;;;;"}

package/dist/esm/variantProps.js

@@ -0,0 +1,68 @@
+/**
+ * @file variantProps.ts
+ * @description Discriminated unions and strict prop validation per icon variant.
+ *
+ * Provides narrowed prop types for each icon variant (solid, outline, duotone, flat,
+ * sharp, rounded, mini, 3d) with variant-specific required/optional props.
+ *
+ * @example
+ * ```tsx
+ * // Narrows to DuotoneIconProps — guarantees secondaryColor is accepted
+ * const props: VariantIconProps = {
+ *   variant: 'duotone',
+ *   primaryColor: '#3b82f6',
+ *   secondaryColor: '#93c5fd',
+ *   secondaryOpacity: 0.4,
+ * };
+ *
+ * // Type guard usage
+ * if (isDuotoneProps(props)) {
+ *   props.secondaryColor; // string — narrowed
+ * }
+ * ```
+ */
+/* ────────────────────────────────────────────────────────────────────────────
+   TYPE GUARDS
+───────────────────────────────────────────────────────────────────────────── */
+/** Narrows to `SolidIconProps` when `variant === 'solid'`. */
+function isSolidProps(props) {
+    return props.variant === 'solid';
+}
+/** Narrows to `OutlineIconProps` when `variant === 'outline'`. */
+function isOutlineProps(props) {
+    return props.variant === 'outline';
+}
+/** Narrows to `DuotoneIconProps` when `variant === 'duotone'`. */
+function isDuotoneProps(props) {
+    return props.variant === 'duotone';
+}
+/** Narrows to `FlatIconProps` when `variant === 'flat'`. */
+function isFlatProps(props) {
+    return props.variant === 'flat';
+}
+/** Narrows to `SharpIconProps` when `variant === 'sharp'`. */
+function isSharpProps(props) {
+    return props.variant === 'sharp';
+}
+/** Narrows to `RoundedIconProps` when `variant === 'rounded'`. */
+function isRoundedProps(props) {
+    return props.variant === 'rounded';
+}
+/** Narrows to `MiniIconProps` when `variant === 'mini'`. */
+function isMiniProps(props) {
+    return props.variant === 'mini';
+}
+/** Narrows to `ThreeDIconProps` when `variant === '3d'`. */
+function isThreeDProps(props) {
+    return props.variant === '3d';
+}
+/**
+ * Converts a discriminated `VariantIconProps` into the general `NtdIconProps`.
+ * Useful when passing narrowed props to actual icon components.
+ */
+function toIconProps(props) {
+    return props;
+}
+
+export { isDuotoneProps, isFlatProps, isMiniProps, isOutlineProps, isRoundedProps, isSharpProps, isSolidProps, isThreeDProps, toIconProps };
+//# sourceMappingURL=variantProps.js.map

package/dist/esm/variantProps.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"variantProps.js","sources":["../../src/variantProps.ts"],"sourcesContent":[null],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;AAsBG;AA0GH;;AAEgF;AAEhF;AACM,SAAU,YAAY,CAAC,KAAuB,EAAA;AAClD,IAAA,OAAO,KAAK,CAAC,OAAO,KAAK,OAAO;AAClC;AAEA;AACM,SAAU,cAAc,CAAC,KAAuB,EAAA;AACpD,IAAA,OAAO,KAAK,CAAC,OAAO,KAAK,SAAS;AACpC;AAEA;AACM,SAAU,cAAc,CAAC,KAAuB,EAAA;AACpD,IAAA,OAAO,KAAK,CAAC,OAAO,KAAK,SAAS;AACpC;AAEA;AACM,SAAU,WAAW,CAAC,KAAuB,EAAA;AACjD,IAAA,OAAO,KAAK,CAAC,OAAO,KAAK,MAAM;AACjC;AAEA;AACM,SAAU,YAAY,CAAC,KAAuB,EAAA;AAClD,IAAA,OAAO,KAAK,CAAC,OAAO,KAAK,OAAO;AAClC;AAEA;AACM,SAAU,cAAc,CAAC,KAAuB,EAAA;AACpD,IAAA,OAAO,KAAK,CAAC,OAAO,KAAK,SAAS;AACpC;AAEA;AACM,SAAU,WAAW,CAAC,KAAuB,EAAA;AACjD,IAAA,OAAO,KAAK,CAAC,OAAO,KAAK,MAAM;AACjC;AAEA;AACM,SAAU,aAAa,CAAC,KAAuB,EAAA;AACnD,IAAA,OAAO,KAAK,CAAC,OAAO,KAAK,IAAI;AAC/B;AAEA;;;AAGG;AACG,SAAU,WAAW,CAAC,KAAuB,EAAA;AACjD,IAAA,OAAO,KAAqB;AAC9B;;;;"}