@marianmeres/stuic 3.14.0 → 3.16.0

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.
Files changed (110) hide show
  1. package/AGENTS.md +22 -18
  2. package/API.md +481 -424
  3. package/README.md +36 -33
  4. package/dist/README.md +14 -14
  5. package/dist/actions/dim-behind/dim-behind.svelte.js +1 -1
  6. package/dist/actions/popover/README.md +79 -65
  7. package/dist/actions/spotlight/index.css +3 -1
  8. package/dist/actions/tooltip/README.md +47 -56
  9. package/dist/components/Accordion/AccordionItem.svelte +2 -10
  10. package/dist/components/Accordion/README.md +36 -36
  11. package/dist/components/Accordion/index.css +2 -4
  12. package/dist/components/AlertConfirmPrompt/README.md +74 -74
  13. package/dist/components/AlertConfirmPrompt/index.css +20 -4
  14. package/dist/components/AnimatedElipsis/README.md +8 -8
  15. package/dist/components/AppShell/README.md +54 -56
  16. package/dist/components/AssetsPreview/AssetsPreview.svelte +1 -1
  17. package/dist/components/AssetsPreview/README.md +75 -82
  18. package/dist/components/Avatar/README.md +42 -48
  19. package/dist/components/Backdrop/README.md +47 -62
  20. package/dist/components/Book/Book.svelte +146 -93
  21. package/dist/components/Book/Book.svelte.d.ts +9 -0
  22. package/dist/components/Book/README.md +62 -62
  23. package/dist/components/Button/README.md +40 -42
  24. package/dist/components/ButtonGroupRadio/README.md +71 -72
  25. package/dist/components/Carousel/README.md +46 -46
  26. package/dist/components/Cart/Cart.svelte +53 -104
  27. package/dist/components/Cart/README.md +132 -136
  28. package/dist/components/Checkout/CheckoutCartReview.svelte +25 -17
  29. package/dist/components/Checkout/CheckoutConfirmStep.svelte +5 -7
  30. package/dist/components/Checkout/CheckoutDeliveryOptions.svelte +30 -15
  31. package/dist/components/Checkout/CheckoutGuestForm.svelte +2 -11
  32. package/dist/components/Checkout/CheckoutLoginForm.svelte +1 -7
  33. package/dist/components/Checkout/CheckoutOrderConfirmation.svelte +13 -3
  34. package/dist/components/Checkout/CheckoutOrderReview.svelte +57 -30
  35. package/dist/components/Checkout/CheckoutProgress.svelte +1 -6
  36. package/dist/components/Checkout/CheckoutReviewStep.svelte +3 -4
  37. package/dist/components/Checkout/CheckoutShippingStep.svelte +5 -3
  38. package/dist/components/Checkout/_internal/checkout-i18n-defaults.d.ts +1 -1
  39. package/dist/components/Checkout/_internal/checkout-i18n-defaults.js +2 -2
  40. package/dist/components/Checkout/_internal/checkout-utils.js +7 -1
  41. package/dist/components/Checkout/index.css +6 -2
  42. package/dist/components/Circle/README.md +30 -34
  43. package/dist/components/Collapsible/README.md +39 -43
  44. package/dist/components/ColorScheme/README.md +8 -8
  45. package/dist/components/CommandMenu/README.md +67 -66
  46. package/dist/components/DataTable/README.md +54 -60
  47. package/dist/components/DataTable/index.css +8 -4
  48. package/dist/components/DismissibleMessage/README.md +59 -76
  49. package/dist/components/Drawer/README.md +54 -56
  50. package/dist/components/DropdownMenu/README.md +246 -245
  51. package/dist/components/DropdownMenu/index.css +2 -1
  52. package/dist/components/H/H.svelte +58 -0
  53. package/dist/components/H/H.svelte.d.ts +22 -0
  54. package/dist/components/H/README.md +78 -0
  55. package/dist/components/H/index.css +66 -0
  56. package/dist/components/H/index.d.ts +1 -0
  57. package/dist/components/H/index.js +1 -0
  58. package/dist/components/HoverExpandableWidth/README.md +41 -46
  59. package/dist/components/Input/FieldCheckbox.svelte +2 -14
  60. package/dist/components/Input/FieldFile.svelte +1 -4
  61. package/dist/components/Input/FieldRadios.svelte +1 -7
  62. package/dist/components/Input/README.md +196 -230
  63. package/dist/components/Input/_internal/FieldRadioInternal.svelte +1 -9
  64. package/dist/components/KbdShortcut/README.md +37 -41
  65. package/dist/components/ListItemButton/README.md +96 -100
  66. package/dist/components/Modal/README.md +61 -71
  67. package/dist/components/ModalDialog/README.md +65 -72
  68. package/dist/components/Nav/Nav.svelte +23 -13
  69. package/dist/components/Nav/README.md +184 -182
  70. package/dist/components/Notifications/README.md +114 -119
  71. package/dist/components/Progress/README.md +43 -64
  72. package/dist/components/Progress/_internal/Bar.svelte +7 -1
  73. package/dist/components/Progress/_internal/Circle.svelte +5 -1
  74. package/dist/components/Separator/Separator.svelte +48 -0
  75. package/dist/components/Separator/Separator.svelte.d.ts +18 -0
  76. package/dist/components/Separator/index.css +31 -0
  77. package/dist/components/Separator/index.d.ts +1 -0
  78. package/dist/components/Separator/index.js +1 -0
  79. package/dist/components/Skeleton/README.md +39 -39
  80. package/dist/components/SlidingPanels/README.md +68 -68
  81. package/dist/components/Spinner/README.md +63 -60
  82. package/dist/components/Spinner/Spinner.svelte +2 -1
  83. package/dist/components/Spinner/SpinnerCircle.svelte +5 -1
  84. package/dist/components/Spinner/SpinnerCircleOscillate.svelte +3 -1
  85. package/dist/components/Switch/README.md +52 -52
  86. package/dist/components/TabbedMenu/README.md +38 -38
  87. package/dist/components/TabbedMenu/TabbedMenu.svelte +4 -2
  88. package/dist/components/Thc/README.md +30 -31
  89. package/dist/components/ThemePreview/README.md +85 -83
  90. package/dist/components/ThemePreview/ThemePreview.svelte +9 -3
  91. package/dist/components/TwCheck/README.md +12 -11
  92. package/dist/components/TypeaheadInput/README.md +57 -61
  93. package/dist/components/WithSidePanel/README.md +51 -51
  94. package/dist/components/X/README.md +12 -15
  95. package/dist/index.css +2 -0
  96. package/dist/index.d.ts +2 -0
  97. package/dist/index.js +2 -0
  98. package/dist/themes/tailwind-color-pairs.md +13 -13
  99. package/dist/utils/design-tokens.js +10 -2
  100. package/dist/utils/preload-img.d.ts +13 -10
  101. package/dist/utils/preload-img.js +15 -14
  102. package/docs/TAILWIND_V4_CSS_VARIABLES.md +192 -186
  103. package/docs/architecture.md +19 -19
  104. package/docs/conventions.md +74 -70
  105. package/docs/domains/actions.md +75 -69
  106. package/docs/domains/components.md +131 -108
  107. package/docs/domains/theming.md +73 -65
  108. package/docs/domains/utils.md +71 -71
  109. package/docs/tasks.md +77 -66
  110. package/package.json +1 -1
package/AGENTS.md CHANGED
@@ -6,13 +6,13 @@
6
6
 
7
7
  ## Quick Reference
8
8
 
9
- | | Command |
10
- |---|---------|
11
- | **Dev** | `npm run dev` |
12
- | **Build** | `npm run build` |
13
- | **Test** | `npm run test` |
14
- | **Check** | `npm run check` |
15
- | **Lint** | `npm run lint` |
9
+ | | Command |
10
+ | ---------- | ---------------- |
11
+ | **Dev** | `npm run dev` |
12
+ | **Build** | `npm run build` |
13
+ | **Test** | `npm run test` |
14
+ | **Check** | `npm run check` |
15
+ | **Lint** | `npm run lint` |
16
16
  | **Format** | `npm run format` |
17
17
 
18
18
  **Stack:** Svelte 5 (runes) · Tailwind CSS v4 · SvelteKit (library mode) · Vite
@@ -23,10 +23,10 @@
23
23
 
24
24
  ```
25
25
  src/lib/
26
- ├── components/ # 39 UI components
26
+ ├── components/ # 44 UI components
27
27
  ├── actions/ # 14 Svelte actions
28
28
  ├── utils/ # 42 utility functions
29
- ├── themes/ # 26 theme definitions (.ts) + generated CSS (css/)
29
+ ├── themes/ # 29 theme definitions (.ts) + generated CSS (css/)
30
30
  ├── icons/ # Icon re-exports
31
31
  ├── index.css # Centralized CSS imports
32
32
  └── index.ts # Main exports
@@ -67,17 +67,20 @@ src/lib/
67
67
  ## Documentation Index
68
68
 
69
69
  ### Core Docs
70
+
70
71
  - [Architecture](./docs/architecture.md) — System design, data flow
71
72
  - [Conventions](./docs/conventions.md) — Code standards, patterns
72
73
  - [Tasks](./docs/tasks.md) — Common procedures
73
74
 
74
75
  ### Domain Docs
75
- - [Components](./docs/domains/components.md) — 38 components, Props pattern, snippets
76
+
77
+ - [Components](./docs/domains/components.md) — 44 components, Props pattern, snippets
76
78
  - [Theming](./docs/domains/theming.md) — CSS tokens, dark mode, themes
77
79
  - [Actions](./docs/domains/actions.md) — 14 Svelte directives
78
80
  - [Utils](./docs/domains/utils.md) — 42 utility functions
79
81
 
80
82
  ### Reference
83
+
81
84
  - [Design Tokens Manual](./docs/DESIGN_TOKENS_MANUAL.md) — Token philosophy
82
85
  - [Tailwind v4 Variables](./docs/TAILWIND_V4_CSS_VARIABLES.md) — CSS variable reference
83
86
 
@@ -85,15 +88,15 @@ src/lib/
85
88
 
86
89
  ## Key Files
87
90
 
88
- | File | Purpose |
89
- |------|---------|
90
- | `src/lib/index.css` | CSS entry point |
91
- | `src/lib/index.ts` | JS entry point |
91
+ | File | Purpose |
92
+ | -------------------------------- | ---------------------------------------------------------------------- |
93
+ | `src/lib/index.css` | CSS entry point |
94
+ | `src/lib/index.ts` | JS entry point |
92
95
  | `src/lib/utils/design-tokens.ts` | Theme types + CSS generation (`ThemeSchema`, `generateThemeCss`, etc.) |
93
- | `src/lib/themes/*.ts` | Theme definitions (26 themes, `TokenSchema`-typed) |
94
- | `src/lib/themes/css/stone.css` | Default theme (generated) |
95
- | `src/lib/components/Button/` | Reference component |
96
- | `scripts/generate-theme.ts` | CLI: `pnpm run build:theme:all` |
96
+ | `src/lib/themes/*.ts` | Theme definitions (29 themes, `TokenSchema`-typed) |
97
+ | `src/lib/themes/css/stone.css` | Default theme (generated) |
98
+ | `src/lib/components/Button/` | Reference component |
99
+ | `scripts/generate-theme.ts` | CLI: `pnpm run build:theme:all` |
97
100
 
98
101
  ---
99
102
 
@@ -103,6 +106,7 @@ You have access to the Svelte MCP server providing comprehensive Svelte 5 docume
103
106
  This is a **component library**, not a SvelteKit application — skip SvelteKit-specific guidance (routing, load functions, hooks, adapters, etc.).
104
107
 
105
108
  ### Available Tools
109
+
106
110
  1. **list-sections**: Call FIRST to discover available documentation sections.
107
111
  2. **get-documentation**: Fetch full docs for specific sections (runes, lifecycle, snippets, etc.).
108
112
  3. **svelte-autofixer**: Validate Svelte code for correctness — always run before finalizing component changes.