@vaneui/ui 0.3.1-alpha.20251117134835.2318245 → 0.3.1-alpha.20251129115555.bcd1100

package/dist/components/ui/badge.d.ts

@@ -1,3 +1,190 @@
 import { BadgeProps } from './props';
+/**
+ * Badge - A small label for status, categories, counts, or notifications
+ *
+ * @example
+ * ```tsx
+ * // Basic badge
+ * <Badge>New</Badge>
+ *
+ * // Status badge with appearance and variant
+ * <Badge success filled pill>Active</Badge>
+ *
+ * // Count badge
+ * <Badge danger filled>3</Badge>
+ *
+ * // As a link
+ * <Badge href="/notifications" primary outlined>5 New</Badge>
+ * ```
+ *
+ * @param props - Badge props
+ * @param props.children - Badge content
+ * @param props.className - Additional CSS classes to merge with theme classes
+ *
+
+ * SIZE PROPS:
+ * @param props.xs - Extra small size
+ * @param props.sm - Small size
+ * @param props.md - Medium size (default)
+ * @param props.lg - Large size
+ * @param props.xl - Extra large size
+ *
+
+ * ALIGNMENT PROPS (Cross-axis):
+ * @param props.itemsStart - Align items to start (top/left)
+ * @param props.itemsEnd - Align items to end (bottom/right)
+ * @param props.itemsCenter - Align items to center
+ * @param props.itemsBaseline - Align items to baseline
+ * @param props.itemsStretch - Stretch items to fill container
+ *
+
+ * ALIGNMENT PROPS (Main-axis):
+ * @param props.justifyStart - Justify content to start
+ * @param props.justifyEnd - Justify content to end
+ * @param props.justifyCenter - Justify content to center
+ * @param props.justifyBetween - Space between items
+ * @param props.justifyAround - Space around items
+ * @param props.justifyEvenly - Space evenly between items
+ *
+
+ * POSITION PROPS:
+ * @param props.relative - Relative positioning
+ * @param props.absolute - Absolute positioning
+ * @param props.fixed - Fixed positioning
+ * @param props.sticky - Sticky positioning
+ * @param props.static - Static positioning
+ *
+
+ * DISPLAY PROPS:
+ * @param props.flex - Display as flex container
+ * @param props.block - Display as block
+ * @param props.inline - Display as inline
+ * @param props.inlineBlock - Display as inline-block
+ * @param props.inlineFlex - Display as inline-flex
+ * @param props.grid - Display as grid
+ * @param props.inlineGrid - Display as inline-grid
+ * @param props.contents - Display as contents
+ * @param props.hidden - Hide element (display: none)
+ *
+
+ * OVERFLOW PROPS:
+ * @param props.overflowAuto - Auto overflow on both axes
+ * @param props.overflowHidden - Hidden overflow on both axes
+ * @param props.overflowVisible - Visible overflow on both axes
+ * @param props.overflowScroll - Scrollable overflow on both axes
+ * @param props.overflowXAuto - Auto overflow on X axis
+ * @param props.overflowYAuto - Auto overflow on Y axis
+ * @param props.overflowXHidden - Hidden overflow on X axis
+ * @param props.overflowYHidden - Hidden overflow on Y axis
+ *
+
+ * FLEXBOX PROPS:
+ * @param props.wrap - Enable flex wrap
+ * @param props.reverse - Reverse the order of children
+ *
+
+ * LAYOUT PROPS:
+ * @param props.gap - Enable gap spacing between children
+ * @param props.noGap - Disable gap spacing
+ * @param props.padding - Enable internal padding
+ * @param props.noPadding - Disable internal padding
+ *
+
+ * FLEXBOX DIRECTION PROPS:
+ * @param props.row - Flex direction row (horizontal)
+ * @param props.column - Flex direction column (vertical)
+ * @param props.rowReverse - Flex direction row-reverse
+ * @param props.columnReverse - Flex direction column-reverse
+ *
+
+ * APPEARANCE PROPS:
+ * @param props.default - Default color appearance
+ * @param props.primary - Primary color appearance (blue)
+ * @param props.secondary - Secondary color appearance (gray)
+ * @param props.tertiary - Tertiary color appearance
+ * @param props.accent - Accent color appearance (rose)
+ * @param props.success - Success color appearance (green)
+ * @param props.danger - Danger color appearance (red)
+ * @param props.warning - Warning color appearance (amber)
+ * @param props.info - Info color appearance (cyan)
+ * @param props.link - Link color appearance
+ *
+
+ * BORDER PROPS:
+ * @param props.border - Enable border on all sides
+ * @param props.borderT - Enable border on top
+ * @param props.borderB - Enable border on bottom
+ * @param props.borderL - Enable border on left
+ * @param props.borderR - Enable border on right
+ * @param props.borderX - Enable border on left and right
+ * @param props.borderY - Enable border on top and bottom
+ * @param props.noBorder - Disable all borders
+ *
+
+ * VISUAL DECORATION PROPS:
+ * @param props.shadow - Enable drop shadow
+ * @param props.noShadow - Disable drop shadow
+ * @param props.ring - Enable focus ring
+ * @param props.noRing - Disable focus ring
+ * @param props.focusVisible - Enable focus-visible outline
+ * @param props.noFocusVisible - Disable focus-visible outline
+ *
+
+ * SHAPE PROPS:
+ * @param props.rounded - Medium rounded corners (default)
+ * @param props.pill - Fully rounded corners (circular)
+ * @param props.sharp - No rounded corners (square)
+ *
+
+ * FONT WEIGHT PROPS:
+ * @param props.thin - Thin font weight (100)
+ * @param props.extralight - Extra light font weight (200)
+ * @param props.light - Light font weight (300)
+ * @param props.normal - Normal font weight (400)
+ * @param props.medium - Medium font weight (500)
+ * @param props.semibold - Semibold font weight (600)
+ * @param props.bold - Bold font weight (700)
+ * @param props.extrabold - Extra bold font weight (800)
+ * @param props.black - Black font weight (900)
+ *
+
+ * FONT STYLE PROPS:
+ * @param props.italic - Italic font style
+ * @param props.notItalic - Not italic (normal) font style
+ *
+
+ * TEXT DECORATION PROPS:
+ * @param props.underline - Underline text decoration
+ * @param props.lineThrough - Line-through text decoration
+ * @param props.noUnderline - No text decoration
+ *
+
+ * TEXT TRANSFORM PROPS:
+ * @param props.uppercase - Transform text to uppercase
+ * @param props.lowercase - Transform text to lowercase
+ * @param props.capitalize - Capitalize first letter of each word
+ * @param props.normalCase - Normal text case (no transformation)
+ *
+
+ * FONT FAMILY PROPS:
+ * @param props.sans - Sans-serif font family (default)
+ * @param props.serif - Serif font family
+ * @param props.mono - Monospace font family
+ *
+
+ * TEXT ALIGNMENT PROPS:
+ * @param props.textLeft - Align text to left
+ * @param props.textCenter - Align text to center
+ * @param props.textRight - Align text to right
+ * @param props.textJustify - Justify text
+ *
+
+ * VARIANT PROPS:
+ * @param props.filled - Filled variant with solid background
+ * @param props.outlined - Outlined variant with border only
+ * @param props.ghost - Ghost variant with minimal styling
+ *
+ * @see {@link BadgeProps} for the complete type definition
+ */
 export declare const Badge: import("react").ForwardRefExoticComponent<BadgeProps & import("react").RefAttributes<HTMLSpanElement>>;
 //# sourceMappingURL=badge.d.ts.map

package/dist/components/ui/badge.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"badge.d.ts","sourceRoot":"","sources":["../../../src/components/ui/badge.tsx"],"names":[],"mappings":"AACA,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAIrC,eAAO,MAAM,KAAK,wGAKjB,CAAA"}
+{"version":3,"file":"badge.d.ts","sourceRoot":"","sources":["../../../src/components/ui/badge.tsx"],"names":[],"mappings":"AACA,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAIrC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA0LG;AACH,eAAO,MAAM,KAAK,wGAKjB,CAAA"}

package/dist/components/ui/button.d.ts

@@ -1,3 +1,190 @@
 import { ButtonProps } from './props';
+/**
+ * Button - A clickable button element with customizable appearance and behavior
+ *
+ * @example
+ * ```tsx
+ * // Basic button
+ * <Button>Click me</Button>
+ *
+ * // With size, appearance, and variant
+ * <Button lg primary filled>Submit</Button>
+ *
+ * // Outlined button
+ * <Button outlined secondary>Cancel</Button>
+ *
+ * // As a link
+ * <Button href="/about">Learn More</Button>
+ * ```
+ *
+ * @param props - Button props
+ * @param props.children - Button content
+ * @param props.className - Additional CSS classes to merge with theme classes
+ *
+
+ * SIZE PROPS:
+ * @param props.xs - Extra small size
+ * @param props.sm - Small size
+ * @param props.md - Medium size (default)
+ * @param props.lg - Large size
+ * @param props.xl - Extra large size
+ *
+
+ * ALIGNMENT PROPS (Cross-axis):
+ * @param props.itemsStart - Align items to start (top/left)
+ * @param props.itemsEnd - Align items to end (bottom/right)
+ * @param props.itemsCenter - Align items to center
+ * @param props.itemsBaseline - Align items to baseline
+ * @param props.itemsStretch - Stretch items to fill container
+ *
+
+ * ALIGNMENT PROPS (Main-axis):
+ * @param props.justifyStart - Justify content to start
+ * @param props.justifyEnd - Justify content to end
+ * @param props.justifyCenter - Justify content to center
+ * @param props.justifyBetween - Space between items
+ * @param props.justifyAround - Space around items
+ * @param props.justifyEvenly - Space evenly between items
+ *
+
+ * POSITION PROPS:
+ * @param props.relative - Relative positioning
+ * @param props.absolute - Absolute positioning
+ * @param props.fixed - Fixed positioning
+ * @param props.sticky - Sticky positioning
+ * @param props.static - Static positioning
+ *
+
+ * DISPLAY PROPS:
+ * @param props.flex - Display as flex container
+ * @param props.block - Display as block
+ * @param props.inline - Display as inline
+ * @param props.inlineBlock - Display as inline-block
+ * @param props.inlineFlex - Display as inline-flex
+ * @param props.grid - Display as grid
+ * @param props.inlineGrid - Display as inline-grid
+ * @param props.contents - Display as contents
+ * @param props.hidden - Hide element (display: none)
+ *
+
+ * OVERFLOW PROPS:
+ * @param props.overflowAuto - Auto overflow on both axes
+ * @param props.overflowHidden - Hidden overflow on both axes
+ * @param props.overflowVisible - Visible overflow on both axes
+ * @param props.overflowScroll - Scrollable overflow on both axes
+ * @param props.overflowXAuto - Auto overflow on X axis
+ * @param props.overflowYAuto - Auto overflow on Y axis
+ * @param props.overflowXHidden - Hidden overflow on X axis
+ * @param props.overflowYHidden - Hidden overflow on Y axis
+ *
+
+ * FLEXBOX PROPS:
+ * @param props.wrap - Enable flex wrap
+ * @param props.reverse - Reverse the order of children
+ *
+
+ * LAYOUT PROPS:
+ * @param props.gap - Enable gap spacing between children
+ * @param props.noGap - Disable gap spacing
+ * @param props.padding - Enable internal padding
+ * @param props.noPadding - Disable internal padding
+ *
+
+ * FLEXBOX DIRECTION PROPS:
+ * @param props.row - Flex direction row (horizontal)
+ * @param props.column - Flex direction column (vertical)
+ * @param props.rowReverse - Flex direction row-reverse
+ * @param props.columnReverse - Flex direction column-reverse
+ *
+
+ * APPEARANCE PROPS:
+ * @param props.default - Default color appearance
+ * @param props.primary - Primary color appearance (blue)
+ * @param props.secondary - Secondary color appearance (gray)
+ * @param props.tertiary - Tertiary color appearance
+ * @param props.accent - Accent color appearance (rose)
+ * @param props.success - Success color appearance (green)
+ * @param props.danger - Danger color appearance (red)
+ * @param props.warning - Warning color appearance (amber)
+ * @param props.info - Info color appearance (cyan)
+ * @param props.link - Link color appearance
+ *
+
+ * BORDER PROPS:
+ * @param props.border - Enable border on all sides
+ * @param props.borderT - Enable border on top
+ * @param props.borderB - Enable border on bottom
+ * @param props.borderL - Enable border on left
+ * @param props.borderR - Enable border on right
+ * @param props.borderX - Enable border on left and right
+ * @param props.borderY - Enable border on top and bottom
+ * @param props.noBorder - Disable all borders
+ *
+
+ * VISUAL DECORATION PROPS:
+ * @param props.shadow - Enable drop shadow
+ * @param props.noShadow - Disable drop shadow
+ * @param props.ring - Enable focus ring
+ * @param props.noRing - Disable focus ring
+ * @param props.focusVisible - Enable focus-visible outline
+ * @param props.noFocusVisible - Disable focus-visible outline
+ *
+
+ * SHAPE PROPS:
+ * @param props.rounded - Medium rounded corners (default)
+ * @param props.pill - Fully rounded corners (circular)
+ * @param props.sharp - No rounded corners (square)
+ *
+
+ * FONT WEIGHT PROPS:
+ * @param props.thin - Thin font weight (100)
+ * @param props.extralight - Extra light font weight (200)
+ * @param props.light - Light font weight (300)
+ * @param props.normal - Normal font weight (400)
+ * @param props.medium - Medium font weight (500)
+ * @param props.semibold - Semibold font weight (600)
+ * @param props.bold - Bold font weight (700)
+ * @param props.extrabold - Extra bold font weight (800)
+ * @param props.black - Black font weight (900)
+ *
+
+ * FONT STYLE PROPS:
+ * @param props.italic - Italic font style
+ * @param props.notItalic - Not italic (normal) font style
+ *
+
+ * TEXT DECORATION PROPS:
+ * @param props.underline - Underline text decoration
+ * @param props.lineThrough - Line-through text decoration
+ * @param props.noUnderline - No text decoration
+ *
+
+ * TEXT TRANSFORM PROPS:
+ * @param props.uppercase - Transform text to uppercase
+ * @param props.lowercase - Transform text to lowercase
+ * @param props.capitalize - Capitalize first letter of each word
+ * @param props.normalCase - Normal text case (no transformation)
+ *
+
+ * FONT FAMILY PROPS:
+ * @param props.sans - Sans-serif font family (default)
+ * @param props.serif - Serif font family
+ * @param props.mono - Monospace font family
+ *
+
+ * TEXT ALIGNMENT PROPS:
+ * @param props.textLeft - Align text to left
+ * @param props.textCenter - Align text to center
+ * @param props.textRight - Align text to right
+ * @param props.textJustify - Justify text
+ *
+
+ * VARIANT PROPS:
+ * @param props.filled - Filled variant with solid background
+ * @param props.outlined - Outlined variant with border only
+ * @param props.ghost - Ghost variant with minimal styling
+ *
+ * @see {@link ButtonProps} for the complete type definition
+ */
 export declare const Button: import("react").ForwardRefExoticComponent<ButtonProps & import("react").RefAttributes<HTMLButtonElement>>;
 //# sourceMappingURL=button.d.ts.map

package/dist/components/ui/button.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"button.d.ts","sourceRoot":"","sources":["../../../src/components/ui/button.tsx"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAItC,eAAO,MAAM,MAAM,2GAKlB,CAAC"}
+{"version":3,"file":"button.d.ts","sourceRoot":"","sources":["../../../src/components/ui/button.tsx"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAItC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA0LG;AACH,eAAO,MAAM,MAAM,2GAKlB,CAAC"}

package/dist/components/ui/docs/propDocs.d.ts

@@ -0,0 +1,151 @@
+/**
+ * Reusable JSDoc documentation blocks for component props.
+ *
+ * This file provides pre-written JSDoc sections that can be composed
+ * into component documentation, eliminating copy-paste duplication.
+ *
+ * @example
+ * import { SIZE_PROPS, APPEARANCE_PROPS_UI, VARIANT_PROPS } from './docs/propDocs';
+ *
+ * // Then use in template literals when building JSDoc
+ */
+/**
+ * Common props documentation
+ */
+export declare const COMMON_PROPS = "\n * @param props - Component props\n * @param props.children - Component content\n * @param props.className - Additional CSS classes to merge with theme classes";
+/**
+ * Size props documentation (xs, sm, md, lg, xl)
+ */
+export declare const SIZE_PROPS = "\n * SIZE PROPS:\n * @param props.xs - Extra small size\n * @param props.sm - Small size\n * @param props.md - Medium size (default)\n * @param props.lg - Large size\n * @param props.xl - Extra large size";
+/**
+ * Appearance props for UI components (primary, secondary, etc.)
+ */
+export declare const APPEARANCE_PROPS_UI = "\n * APPEARANCE PROPS:\n * @param props.default - Default color appearance\n * @param props.primary - Primary color appearance (blue)\n * @param props.secondary - Secondary color appearance (gray)\n * @param props.tertiary - Tertiary color appearance\n * @param props.accent - Accent color appearance (rose)\n * @param props.success - Success color appearance (green)\n * @param props.danger - Danger color appearance (red)\n * @param props.warning - Warning color appearance (amber)\n * @param props.info - Info color appearance (cyan)\n * @param props.link - Link color appearance";
+/**
+ * Appearance props for layout components (background only)
+ */
+export declare const APPEARANCE_PROPS_LAYOUT = "\n * APPEARANCE PROPS (Background):\n * @param props.default - Default background color\n * @param props.primary - Primary background color\n * @param props.secondary - Secondary background color\n * @param props.tertiary - Tertiary background color";
+/**
+ * Appearance props for typography (text color)
+ */
+export declare const APPEARANCE_PROPS_TEXT = "\n * APPEARANCE PROPS (Text Color):\n * @param props.default - Default text color (gray-900)\n * @param props.primary - Primary text color (blue-600)\n * @param props.secondary - Secondary text color (gray-600)\n * @param props.tertiary - Tertiary text color (gray-500)\n * @param props.accent - Accent text color (rose-700)\n * @param props.success - Success text color (emerald-600)\n * @param props.danger - Danger text color (red-600)\n * @param props.warning - Warning text color (amber-600)\n * @param props.info - Info text color (cyan-600)\n * @param props.link - Link text color (blue-600)";
+/**
+ * Variant props (filled, outlined, ghost)
+ */
+export declare const VARIANT_PROPS = "\n * VARIANT PROPS:\n * @param props.filled - Filled variant with solid background\n * @param props.outlined - Outlined variant with border only\n * @param props.ghost - Ghost variant with minimal styling";
+/**
+ * Shape props (rounded, pill, sharp)
+ */
+export declare const SHAPE_PROPS = "\n * SHAPE PROPS:\n * @param props.rounded - Medium rounded corners (default)\n * @param props.pill - Fully rounded corners (circular)\n * @param props.sharp - No rounded corners (square)";
+/**
+ * Font family props
+ */
+export declare const FONT_FAMILY_PROPS = "\n * FONT FAMILY PROPS:\n * @param props.sans - Sans-serif font family (default)\n * @param props.serif - Serif font family\n * @param props.mono - Monospace font family";
+/**
+ * Font weight props
+ */
+export declare const FONT_WEIGHT_PROPS = "\n * FONT WEIGHT PROPS:\n * @param props.thin - Thin font weight (100)\n * @param props.extralight - Extra light font weight (200)\n * @param props.light - Light font weight (300)\n * @param props.normal - Normal font weight (400)\n * @param props.medium - Medium font weight (500)\n * @param props.semibold - Semibold font weight (600)\n * @param props.bold - Bold font weight (700)\n * @param props.extrabold - Extra bold font weight (800)\n * @param props.black - Black font weight (900)";
+/**
+ * Font style props
+ */
+export declare const FONT_STYLE_PROPS = "\n * FONT STYLE PROPS:\n * @param props.italic - Italic font style\n * @param props.notItalic - Not italic (normal) font style";
+/**
+ * Text decoration props
+ */
+export declare const TEXT_DECORATION_PROPS = "\n * TEXT DECORATION PROPS:\n * @param props.underline - Underline text decoration\n * @param props.lineThrough - Line-through text decoration\n * @param props.noUnderline - No text decoration";
+/**
+ * Text transform props
+ */
+export declare const TEXT_TRANSFORM_PROPS = "\n * TEXT TRANSFORM PROPS:\n * @param props.uppercase - Transform text to uppercase\n * @param props.lowercase - Transform text to lowercase\n * @param props.capitalize - Capitalize first letter of each word\n * @param props.normalCase - Normal text case (no transformation)";
+/**
+ * Text alignment props
+ */
+export declare const TEXT_ALIGN_PROPS = "\n * TEXT ALIGNMENT PROPS:\n * @param props.textLeft - Align text to left\n * @param props.textCenter - Align text to center\n * @param props.textRight - Align text to right\n * @param props.textJustify - Justify text";
+/**
+ * Visual decoration props (shadow, ring, focus)
+ */
+export declare const VISUAL_DECORATION_PROPS = "\n * VISUAL DECORATION PROPS:\n * @param props.shadow - Enable drop shadow\n * @param props.noShadow - Disable drop shadow\n * @param props.ring - Enable focus ring\n * @param props.noRing - Disable focus ring\n * @param props.focusVisible - Enable focus-visible outline\n * @param props.noFocusVisible - Disable focus-visible outline";
+/**
+ * Layout props (gap, padding)
+ */
+export declare const LAYOUT_PROPS = "\n * LAYOUT PROPS:\n * @param props.gap - Enable gap spacing between children\n * @param props.noGap - Disable gap spacing\n * @param props.padding - Enable internal padding\n * @param props.noPadding - Disable internal padding";
+/**
+ * Flexbox direction props
+ */
+export declare const FLEX_DIRECTION_PROPS = "\n * FLEXBOX DIRECTION PROPS:\n * @param props.row - Flex direction row (horizontal)\n * @param props.column - Flex direction column (vertical)\n * @param props.rowReverse - Flex direction row-reverse\n * @param props.columnReverse - Flex direction column-reverse";
+/**
+ * Flexbox props (wrap, reverse)
+ */
+export declare const FLEX_PROPS = "\n * FLEXBOX PROPS:\n * @param props.wrap - Enable flex wrap\n * @param props.reverse - Reverse the order of children";
+/**
+ * Alignment props (items)
+ */
+export declare const ITEMS_PROPS = "\n * ALIGNMENT PROPS (Cross-axis):\n * @param props.itemsStart - Align items to start (top/left)\n * @param props.itemsEnd - Align items to end (bottom/right)\n * @param props.itemsCenter - Align items to center\n * @param props.itemsBaseline - Align items to baseline\n * @param props.itemsStretch - Stretch items to fill container";
+/**
+ * Alignment props (justify)
+ */
+export declare const JUSTIFY_PROPS = "\n * ALIGNMENT PROPS (Main-axis):\n * @param props.justifyStart - Justify content to start\n * @param props.justifyEnd - Justify content to end\n * @param props.justifyCenter - Justify content to center\n * @param props.justifyBetween - Space between items\n * @param props.justifyAround - Space around items\n * @param props.justifyEvenly - Space evenly between items";
+/**
+ * Responsive breakpoint props
+ */
+export declare const BREAKPOINT_PROPS = "\n * RESPONSIVE BREAKPOINT PROPS:\n * @param props.mobileCol - Switch to column layout on mobile and below (max-mobile: 40rem)\n * @param props.tabletCol - Switch to column layout on tablet and below (max-tablet: 48rem)\n * @param props.laptopCol - Switch to column layout on laptop and below (max-laptop: 64rem)\n * @param props.desktopCol - Switch to column layout on desktop and below (max-desktop: 80rem)";
+/**
+ * Border props
+ */
+export declare const BORDER_PROPS = "\n * BORDER PROPS:\n * @param props.border - Enable border on all sides\n * @param props.borderT - Enable border on top\n * @param props.borderB - Enable border on bottom\n * @param props.borderL - Enable border on left\n * @param props.borderR - Enable border on right\n * @param props.borderX - Enable border on left and right\n * @param props.borderY - Enable border on top and bottom\n * @param props.noBorder - Disable all borders";
+/**
+ * Display props
+ */
+export declare const DISPLAY_PROPS = "\n * DISPLAY PROPS:\n * @param props.flex - Display as flex container\n * @param props.block - Display as block\n * @param props.inline - Display as inline\n * @param props.inlineBlock - Display as inline-block\n * @param props.inlineFlex - Display as inline-flex\n * @param props.grid - Display as grid\n * @param props.inlineGrid - Display as inline-grid\n * @param props.contents - Display as contents\n * @param props.hidden - Hide element (display: none)";
+/**
+ * Position props
+ */
+export declare const POSITION_PROPS = "\n * POSITION PROPS:\n * @param props.relative - Relative positioning\n * @param props.absolute - Absolute positioning\n * @param props.fixed - Fixed positioning\n * @param props.sticky - Sticky positioning\n * @param props.static - Static positioning";
+/**
+ * Overflow props
+ */
+export declare const OVERFLOW_PROPS = "\n * OVERFLOW PROPS:\n * @param props.overflowAuto - Auto overflow on both axes\n * @param props.overflowHidden - Hidden overflow on both axes\n * @param props.overflowVisible - Visible overflow on both axes\n * @param props.overflowScroll - Scrollable overflow on both axes\n * @param props.overflowXAuto - Auto overflow on X axis\n * @param props.overflowYAuto - Auto overflow on Y axis\n * @param props.overflowXHidden - Hidden overflow on X axis\n * @param props.overflowYHidden - Hidden overflow on Y axis";
+/**
+ * Link/Tag polymorphism props
+ */
+export declare const LINK_TAG_PROPS = "\n * LINK & TAG PROPS:\n * @param props.href - URL to navigate to (renders component as anchor tag)\n * @param props.tag - Custom HTML tag or React component to render as";
+/**
+ * Tag only props (for components without link mode)
+ */
+export declare const TAG_PROPS = "\n * TAG PROPS:\n * @param props.tag - Custom HTML tag to render as";
+/**
+ * Transparent props
+ */
+export declare const TRANSPARENT_PROPS = "\n * TRANSPARENCY PROPS:\n * @param props.transparent - Transparent background/border";
+/**
+ * List style props
+ */
+export declare const LIST_STYLE_PROPS = "\n * LIST STYLE PROPS:\n * @param props.disc - Bullet point list style\n * @param props.decimal - Numbered list style";
+/**
+ * Visibility props (hide at breakpoints)
+ */
+export declare const VISIBILITY_PROPS = "\n * VISIBILITY PROPS:\n * @param props.xsHide - Hide on extra small screens\n * @param props.smHide - Hide on small screens\n * @param props.mdHide - Hide on medium screens\n * @param props.lgHide - Hide on large screens\n * @param props.xlHide - Hide on extra large screens";
+/**
+ * Commonly used prop combinations
+ */
+export declare const TYPOGRAPHY_STYLE_PROPS: string;
+export declare const ALIGNMENT_PROPS: string;
+export declare const COMPLETE_FLEX_PROPS: string;
+/**
+ * Helper function to build component JSDoc from sections
+ */
+export declare function buildComponentDoc(config: {
+    name: string;
+    description: string;
+    examples: string[];
+    propSections: string[];
+    propsType: string;
+    notes?: string[];
+}): string;
+/**
+ * Pre-configured documentation builders for common component types
+ */
+export declare const UI_COMPONENT_SECTIONS: string[];
+export declare const LAYOUT_COMPONENT_SECTIONS: string[];
+export declare const TYPOGRAPHY_COMPONENT_SECTIONS: string[];
+//# sourceMappingURL=propDocs.d.ts.map

package/dist/components/ui/docs/propDocs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"propDocs.d.ts","sourceRoot":"","sources":["../../../../src/components/ui/docs/propDocs.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH;;GAEG;AACH,eAAO,MAAM,YAAY,sKAGsD,CAAC;AAEhF;;GAEG;AACH,eAAO,MAAM,UAAU,iNAMe,CAAC;AAEvC;;GAEG;AACH,eAAO,MAAM,mBAAmB,2kBAWa,CAAC;AAE9C;;GAEG;AACH,eAAO,MAAM,uBAAuB,8PAKiB,CAAC;AAEtD;;GAEG;AACH,eAAO,MAAM,qBAAqB,2lBAWgB,CAAC;AAEnD;;GAEG;AACH,eAAO,MAAM,aAAa,iNAIiC,CAAC;AAE5D;;GAEG;AACH,eAAO,MAAM,WAAW,gMAI4B,CAAC;AAErD;;GAEG;AACH,eAAO,MAAM,iBAAiB,8KAIe,CAAC;AAE9C;;GAEG;AACH,eAAO,MAAM,iBAAiB,+eAUkB,CAAC;AAEjD;;GAEG;AACH,eAAO,MAAM,gBAAgB,mIAG8B,CAAC;AAE5D;;GAEG;AACH,eAAO,MAAM,qBAAqB,qMAIe,CAAC;AAElD;;GAEG;AACH,eAAO,MAAM,oBAAoB,uRAKiC,CAAC;AAEnE;;GAEG;AACH,eAAO,MAAM,gBAAgB,8NAKc,CAAC;AAE5C;;GAEG;AACH,eAAO,MAAM,uBAAuB,mVAO2B,CAAC;AAEhE;;GAEG;AACH,eAAO,MAAM,YAAY,wOAK4B,CAAC;AAEtD;;GAEG;AACH,eAAO,MAAM,oBAAoB,4QAK6B,CAAC;AAE/D;;GAEG;AACH,eAAO,MAAM,UAAU,0HAGiC,CAAC;AAEzD;;GAEG;AACH,eAAO,MAAM,WAAW,iVAMuC,CAAC;AAEhE;;GAEG;AACH,eAAO,MAAM,aAAa,qXAOiC,CAAC;AAE5D;;GAEG;AACH,eAAO,MAAM,gBAAgB,6ZAKkE,CAAC;AAEhG;;GAEG;AACH,eAAO,MAAM,YAAY,wbASsB,CAAC;AAEhD;;GAEG;AACH,eAAO,MAAM,aAAa,gdAU4B,CAAC;AAEvD;;GAEG;AACH,eAAO,MAAM,cAAc,gQAMiB,CAAC;AAE7C;;GAEG;AACH,eAAO,MAAM,cAAc,mgBASiC,CAAC;AAE7D;;GAEG;AACH,eAAO,MAAM,cAAc,+KAG2C,CAAC;AAEvE;;GAEG;AACH,eAAO,MAAM,SAAS,wEAE6B,CAAC;AAEpD;;GAEG;AACH,eAAO,MAAM,iBAAiB,0FAE8B,CAAC;AAE7D;;GAEG;AACH,eAAO,MAAM,gBAAgB,0HAGiB,CAAC;AAE/C;;GAEG;AACH,eAAO,MAAM,gBAAgB,wRAMwB,CAAC;AAEtD;;GAEG;AAGH,eAAO,MAAM,sBAAsB,QAOnB,CAAC;AAGjB,eAAO,MAAM,eAAe,QAA8C,CAAC;AAG3E,eAAO,MAAM,mBAAmB,QAKhB,CAAC;AAEjB;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE;IACxC,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;CAClB,GAAG,MAAM,CA4BT;AAED;;GAEG;AAEH,eAAO,MAAM,qBAAqB,UAUjC,CAAC;AAEF,eAAO,MAAM,yBAAyB,UASrC,CAAC;AAEF,eAAO,MAAM,6BAA6B,UAKzC,CAAC"}