@julseb-lib/react 1.1.33 → 1.1.35

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -1,6 +1,13 @@
1
1
  import { Dispatch, SetStateAction, ReactNode, FunctionComponent, HTMLAttributes, ElementType, RefObject, CSSProperties as CSSProperties$1, ReactElement as ReactElement$1 } from 'react';
2
2
  import { Property } from 'csstype';
3
3
 
4
+ /**
5
+ * Design tokens used across the component library for consistent styling and theming.
6
+ * Includes color palettes, font sizes, spacers, breakpoints, radii, shadows, and more.
7
+ *
8
+ * @type {object}
9
+ * @see https://julseb-lib.vercel.app/docs/design-tokens
10
+ */
4
11
  declare const designTokens: {
5
12
  readonly libColors: {
6
13
  /**
@@ -209,6 +216,8 @@ declare const designTokens: {
209
216
  readonly "white-80": "white-80";
210
217
  readonly "gradient-black": "gradient-black";
211
218
  readonly "gradient-white": "gradient-white";
219
+ readonly "gradient-theme-bg": "gradient-theme-bg";
220
+ readonly "gradient-theme-text": "gradient-theme-text";
212
221
  };
213
222
  readonly libFontFamilies: {
214
223
  /**
@@ -324,6 +333,15 @@ declare const designTokens: {
324
333
  readonly bold: "bold";
325
334
  readonly black: "black";
326
335
  };
336
+ /**
337
+ * Letter spacing (tracking) values.
338
+ * Tighter — -0.05em
339
+ * Tight — -0.025em
340
+ * Normal — 0em
341
+ * Wide — 0.025em
342
+ * Wider — 0.05em
343
+ * Widest — 0.1em
344
+ */
327
345
  readonly libTracking: {
328
346
  readonly tighter: "tighter";
329
347
  readonly tight: "tight";
@@ -332,6 +350,15 @@ declare const designTokens: {
332
350
  readonly wider: "wider";
333
351
  readonly widest: "widest";
334
352
  };
353
+ /**
354
+ * Line height (leading) values.
355
+ * Tight — 1.25
356
+ * Snug — 1.375
357
+ * Normal — 1.5
358
+ * Relaxed — 1.625
359
+ * Loose — 2
360
+ * None — 1
361
+ */
335
362
  readonly libLeading: {
336
363
  readonly tight: "tight";
337
364
  readonly snug: "snug";
@@ -340,6 +367,18 @@ declare const designTokens: {
340
367
  readonly loose: "loose";
341
368
  readonly none: "none";
342
369
  };
370
+ /**
371
+ * Border radius values.
372
+ * xs — 0.125rem
373
+ * sm — 0.25rem
374
+ * md — 0.375rem
375
+ * lg — 0.5rem
376
+ * xl — 0.75rem
377
+ * 2xl — 1rem
378
+ * 3xl — 1.5rem
379
+ * 4xl — 2rem
380
+ * full — 9999px
381
+ */
343
382
  readonly libRadius: {
344
383
  readonly xs: "xs";
345
384
  readonly sm: "sm";
@@ -351,6 +390,7 @@ declare const designTokens: {
351
390
  readonly "4xl": "4xl";
352
391
  readonly full: "full";
353
392
  };
393
+ /** Box shadow size values. */
354
394
  readonly libShadows: {
355
395
  readonly "2xs": "2xs";
356
396
  readonly xs: "xs";
@@ -361,11 +401,13 @@ declare const designTokens: {
361
401
  readonly "2xl": "2xl";
362
402
  readonly none: "none";
363
403
  };
404
+ /** Inset (inner) shadow size values. */
364
405
  readonly libInsetShadows: {
365
406
  readonly "2xs": "2xs";
366
407
  readonly xs: "xs";
367
408
  readonly sm: "sm";
368
409
  };
410
+ /** Drop shadow filter size values. */
369
411
  readonly libDropShadows: {
370
412
  readonly xs: "xs";
371
413
  readonly sm: "sm";
@@ -374,6 +416,7 @@ declare const designTokens: {
374
416
  readonly xl: "xl";
375
417
  readonly "2xl": "2xl";
376
418
  };
419
+ /** Text shadow size values. */
377
420
  readonly libTextShadow: {
378
421
  readonly "2xs": "2xs";
379
422
  readonly xs: "xs";
@@ -381,17 +424,20 @@ declare const designTokens: {
381
424
  readonly md: "md";
382
425
  readonly lg: "lg";
383
426
  };
427
+ /** CSS transition timing function values. */
384
428
  readonly libTransitionTimingFunctions: {
385
429
  readonly "--ease-in": "--ease-in";
386
430
  readonly "--ease-out": "--ease-out";
387
431
  readonly "--ease-in-out": "--ease-in-out";
388
432
  };
433
+ /** CSS animation presets. */
389
434
  readonly libAnimate: {
390
435
  readonly spin: "spin";
391
436
  readonly ping: "ping";
392
437
  readonly pulse: "pulse";
393
438
  readonly bounce: "bounce";
394
439
  };
440
+ /** Blur filter size values. */
395
441
  readonly libBlur: {
396
442
  readonly xs: "xs";
397
443
  readonly sm: "sm";
@@ -401,6 +447,7 @@ declare const designTokens: {
401
447
  readonly "2xl": "2xl";
402
448
  readonly "3xl": "3xl";
403
449
  };
450
+ /** CSS perspective distance values for 3D transforms. */
404
451
  readonly libPerspective: {
405
452
  readonly dramatic: "dramatic";
406
453
  readonly near: "near";
@@ -408,7 +455,9 @@ declare const designTokens: {
408
455
  readonly midrange: "midrange";
409
456
  readonly distant: "distant";
410
457
  };
458
+ /** Video aspect ratio token (16:9). */
411
459
  readonly libAspectVideo: {};
460
+ /** Display heading tags (h1–h5) reference. */
412
461
  readonly libTextDisplayTags: {
413
462
  h1: string;
414
463
  h2: string;
@@ -416,6 +465,7 @@ declare const designTokens: {
416
465
  h4: string;
417
466
  h5: string;
418
467
  };
468
+ /** Text-level HTML element tags (h6, p, strong, em, small, blockquote, ul, ol, dl). */
419
469
  readonly libTextTags: {
420
470
  readonly h6: "h6";
421
471
  readonly p: "p";
@@ -427,6 +477,7 @@ declare const designTokens: {
427
477
  readonly ol: "ol";
428
478
  readonly dl: "dl";
429
479
  };
480
+ /** CSS transition property targets. */
430
481
  readonly libTransitions: {
431
482
  readonly none: "none";
432
483
  readonly all: "all";
@@ -436,27 +487,33 @@ declare const designTokens: {
436
487
  readonly shadow: "shadow";
437
488
  readonly transform: "transform";
438
489
  };
490
+ /** Color theme modes. */
439
491
  readonly libThemes: {
440
492
  readonly light: "light";
441
493
  readonly dark: "dark";
442
494
  };
495
+ /** Input field border radius variants. */
443
496
  readonly libInputVariants: {
444
497
  readonly rounded: "rounded";
445
498
  readonly pill: "pill";
446
499
  };
500
+ /** Input field background color modes. */
447
501
  readonly libInputBackgrounds: {
448
502
  readonly light: "light";
449
503
  readonly dark: "dark";
450
504
  };
505
+ /** Main content area width presets. */
451
506
  readonly libMainSizes: {
452
507
  readonly default: "default";
453
508
  readonly large: "large";
454
509
  readonly form: "form";
455
510
  };
511
+ /** Aside panel width presets. */
456
512
  readonly libAsideSizes: {
457
513
  readonly default: "default";
458
514
  readonly small: "small";
459
515
  };
516
+ /** Z-index layer values (0–50, with negative counterparts). */
460
517
  readonly libZIndex: {
461
518
  readonly "0": "0";
462
519
  readonly "10": "10";
@@ -471,11 +528,13 @@ declare const designTokens: {
471
528
  readonly "-40": "-40";
472
529
  readonly "-50": "-50";
473
530
  };
531
+ /** CSS position property values. */
474
532
  readonly libPosition: {
475
533
  readonly relative: "relative";
476
534
  readonly absolute: "absolute";
477
535
  readonly fixed: "fixed";
478
536
  };
537
+ /** Minimum height sizing values. */
479
538
  readonly libMinHeights: {
480
539
  readonly px: "px";
481
540
  readonly full: "full";
@@ -492,10 +551,12 @@ declare const designTokens: {
492
551
  readonly fit: "fit";
493
552
  readonly lh: "lh";
494
553
  };
554
+ /** Keyboard Key component size variants. */
495
555
  readonly libKeySizes: {
496
556
  readonly large: "large";
497
557
  readonly small: "small";
498
558
  };
559
+ /** Maximum width sizing values. */
499
560
  readonly libMaxWidths: {
500
561
  readonly "3xs": "3xs";
501
562
  readonly "2xs": "2xs";
@@ -524,43 +585,52 @@ declare const designTokens: {
524
585
  readonly max: "max";
525
586
  readonly fit: "fit";
526
587
  };
588
+ /** Skeleton loading animation styles. */
527
589
  readonly libSkeletonAnimations: {
528
590
  readonly pulse: "pulse";
529
591
  readonly shine: "shine";
530
592
  readonly none: "none";
531
593
  };
594
+ /** Tooltip positioning options. */
532
595
  readonly libTooltipPositions: {
533
596
  readonly top: "top";
534
597
  readonly bottom: "bottom";
535
598
  readonly left: "left";
536
599
  readonly right: "right";
537
600
  };
601
+ /** Tooltip trigger interaction modes. */
538
602
  readonly libTooltipTriggers: {
539
603
  readonly hover: "hover";
540
604
  readonly click: "click";
541
605
  };
606
+ /** Loader spinner visual variants. */
542
607
  readonly libLoaderVariants: {
543
608
  readonly 1: 1;
544
609
  readonly 2: 2;
545
610
  readonly 3: 3;
546
611
  };
612
+ /** Button visual style variants. */
547
613
  readonly libButtonVariants: {
548
614
  readonly plain: "plain";
549
615
  readonly ghost: "ghost";
550
616
  readonly transparent: "transparent";
551
617
  };
618
+ /** Button size presets. */
552
619
  readonly libButtonSize: {
553
620
  readonly default: "default";
554
621
  readonly small: "small";
555
622
  };
623
+ /** ButtonGroup toggle selection modes (single or multi). */
556
624
  readonly libButtonGroupToggle: {
557
625
  readonly single: "single";
558
626
  readonly multi: "multi";
559
627
  };
628
+ /** Tag visual style variants. */
560
629
  readonly libTagVariant: {
561
630
  readonly plain: "plain";
562
631
  readonly outline: "outline";
563
632
  };
633
+ /** HTML input type values supported by the Input component. */
564
634
  readonly libInputTypes: {
565
635
  readonly color: "color";
566
636
  readonly date: "date";
@@ -579,23 +649,28 @@ declare const designTokens: {
579
649
  readonly select: "select";
580
650
  readonly textarea: "textarea";
581
651
  };
652
+ /** Checkbox/radio input visual variants (tile, toggle, selector). */
582
653
  readonly libCheckInputVariants: {
583
654
  readonly tile: "tile";
584
655
  readonly toggle: "toggle";
585
656
  readonly selector: "selector";
586
657
  };
658
+ /** Dropdown list expansion direction. */
587
659
  readonly libListInputDirections: {
588
660
  readonly up: "up";
589
661
  readonly down: "down";
590
662
  };
663
+ /** Accordion visual style variants. */
591
664
  readonly libAccordionVariant: {
592
665
  readonly basic: "basic";
593
666
  readonly rounded: "rounded";
594
667
  };
668
+ /** Accordion expand/collapse icon styles. */
595
669
  readonly libAccordionIcon: {
596
670
  readonly plus: "plus";
597
671
  readonly chevron: "chevron";
598
672
  };
673
+ /** Toast notification status types. */
599
674
  readonly libToastStatus: {
600
675
  readonly success: "success";
601
676
  readonly error: "error";
@@ -603,42 +678,51 @@ declare const designTokens: {
603
678
  readonly info: "info";
604
679
  readonly loading: "loading";
605
680
  };
681
+ /** Tabs button alignment options. */
606
682
  readonly libTabsJustify: {
607
683
  readonly start: "start";
608
684
  readonly stretch: "stretch";
609
685
  };
686
+ /** Tabs visual style variants. */
610
687
  readonly libTabsVariant: {
611
688
  readonly basic: "basic";
612
689
  readonly rounded: "rounded";
613
690
  };
691
+ /** Slideshow pagination indicator styles. */
614
692
  readonly libSlideshowPagination: {
615
693
  readonly dots: "dots";
616
694
  readonly "dots-outline": "dots-outline";
617
695
  readonly bars: "bars";
618
696
  readonly thumbnails: "thumbnails";
619
697
  };
698
+ /** Slideshow pagination placement (inside or outside the slide area). */
620
699
  readonly libSlideshowPaginationPosition: {
621
700
  readonly inside: "inside";
622
701
  readonly outside: "outside";
623
702
  };
703
+ /** Slideshow navigation button alignment. */
624
704
  readonly libSlideshowButtonsPositions: {
625
705
  readonly left: "left";
626
706
  readonly right: "right";
627
707
  };
708
+ /** Slideshow navigation button size presets. */
628
709
  readonly libSlideshowButtonsSizes: {
629
710
  readonly small: "small";
630
711
  readonly large: "large";
631
712
  };
713
+ /** Table visual style variants. */
632
714
  readonly libTableVariants: {
633
715
  readonly bordered: "bordered";
634
716
  readonly stripped: "stripped";
635
717
  readonly "border-bottom": "border-bottom";
636
718
  };
719
+ /** Markdown editor view modes (code, live preview, preview only). */
637
720
  readonly libMdEditorViews: {
638
721
  readonly viewCode: "viewCode";
639
722
  readonly viewLive: "viewLive";
640
723
  readonly viewPreview: "viewPreview";
641
724
  };
725
+ /** Markdown editor toolbar formatting buttons. */
642
726
  readonly libMdEditorButtons: {
643
727
  readonly bold: "bold";
644
728
  readonly italic: "italic";
@@ -654,6 +738,7 @@ declare const designTokens: {
654
738
  readonly comment: "comment";
655
739
  readonly image: "image";
656
740
  };
741
+ /** Markdown editor heading level options (h1–h6). */
657
742
  readonly libMdEditorTitles: {
658
743
  readonly h6: "h6";
659
744
  readonly h1: string;
@@ -662,27 +747,33 @@ declare const designTokens: {
662
747
  readonly h4: string;
663
748
  readonly h5: string;
664
749
  };
750
+ /** Drawer panel slide-in positions. */
665
751
  readonly libDrawerPositions: {
666
752
  readonly left: "left";
667
753
  readonly right: "right";
668
754
  };
755
+ /** Mobile navigation burger button position. */
669
756
  readonly libNavBurgerPositions: {
670
757
  readonly left: "left";
671
758
  readonly right: "right";
672
759
  };
760
+ /** Mobile navigation display variants. */
673
761
  readonly libNavMobileVariants: {
674
762
  readonly full: "full";
675
763
  readonly top: "top";
676
764
  readonly drawer: "drawer";
677
765
  };
766
+ /** Footer links layout direction. */
678
767
  readonly libFooterDirection: {
679
768
  readonly horizontal: "horizontal";
680
769
  readonly vertical: "vertical";
681
770
  };
771
+ /** Footer links separator character styles. */
682
772
  readonly libFooterLinksSeparator: {
683
773
  readonly dot: "dot";
684
774
  readonly dash: "dash";
685
775
  };
776
+ /** ISO 3166-1 alpha-2 country codes for the InputPhone component. */
686
777
  readonly libCountryCodes: {
687
778
  readonly af: "af";
688
779
  readonly ax: "ax";