@avento-space/ts-ui 1.2.2 → 1.2.4

package/README.md

@@ -129,23 +129,16 @@ function App() {
 
 ## Styling
 
-All components use **Shadow DOM** for style encapsulation. Override styles via:
+Components use **Shadow DOM**, so global CSS (Tailwind, modules, etc.) cannot style internal elements. Use **CSS custom properties** for design tokens and **`::part()` selectors** for targeting specific internal elements.
 
-```css
-/* CSS parts */
-u-button::part(button) { font-weight: 700; }
-u-modal::part(modal-wrapper) { border-radius: 16px; }
-```
-
-Design tokens are available as CSS custom properties:
+> 📖 **Full documentation:** [`docs/theming.md`](./docs/theming.md) — includes the complete token table, stacking/z-index guide, React patterns, migration notes, and the optional [Tailwind plugin](docs/theming.md#7-optional-tailwind-plugin) for autocomplete-friendly `--u-*` utilities.
 
 ```css
-:root {
-  --u-color-primary: #3b82f6;
-  --u-color-text: #111827;
-  --u-color-text-muted: #4b5563;
-  --u-radius-2xl: 12px;
-}
+/* Token override — affects all components */
+:root { --u-color-primary: #7c3aed; }
+
+/* Part selector — styles the internal <button> */
+u-button::part(button) { font-weight: 700; text-transform: uppercase; }
 ```
 
 ---

package/dist/{card.wc-pFLgjfwm.d.ts → card.wc-83Ws3o27.d.ts}

@@ -104,6 +104,7 @@ interface ListProps {
     emptyState?: string;
 }
 declare class UList extends UElement {
+    static get observedAttributes(): string[];
     private _items;
     private _renderItem;
     private _emptyText;
@@ -115,6 +116,9 @@ declare class UList extends UElement {
     get emptyState(): string;
     set emptyState(val: string);
     private _renderList;
+    connectedCallback(): void;
+    attributeChangedCallback(name: string, oldVal: string | null, newVal: string | null): void;
+    private _sync;
     _mount(): void;
 }
 interface VirtualListProps {
@@ -213,6 +217,7 @@ declare class UStack extends UElement {
     private _align;
     private _justify;
     private _wrap;
+    protected _direction: string;
     constructor();
     get gap(): number;
     set gap(val: number);
@@ -794,6 +799,7 @@ declare class UCollection extends UElement {
     clearSelection(): void;
     connectedCallback(): void;
     attributeChangedCallback(name: string, oldVal: string | null, newVal: string | null): void;
+    private _sync;
     private _updateItems;
     private _dispatchChange;
     _mount(): void;
@@ -814,8 +820,11 @@ declare class UTree extends UElement {
     static get observedAttributes(): string[];
     private _items;
     constructor();
+    connectedCallback(): void;
+    attributeChangedCallback(name: string, oldVal: string | null, newVal: string | null): void;
     get items(): TreeNodeData[];
     set items(val: TreeNodeData[]);
+    private _sync;
     private _render;
     private _renderNode;
     private _onClick;
@@ -848,6 +857,7 @@ declare class UTable extends UElement {
     set rows(val: Record<string, any>[]);
     connectedCallback(): void;
     attributeChangedCallback(name: string, oldVal: string | null, newVal: string | null): void;
+    private _sync;
     private _render;
     private _renderHeader;
     private _renderBody;
@@ -884,6 +894,7 @@ declare class UBreadcrumb extends UElement {
     set separator(val: string);
     connectedCallback(): void;
     attributeChangedCallback(name: string, oldVal: string | null, newVal: string | null): void;
+    private _sync;
     private _render;
     _mount(): void;
 }
@@ -924,7 +935,11 @@ interface VisuallyHiddenProps {
     class?: string;
 }
 declare class UVisuallyHidden extends UElement {
+    static get observedAttributes(): string[];
     constructor();
+    connectedCallback(): void;
+    attributeChangedCallback(name: string, oldVal: string | null, newVal: string | null): void;
+    private _sync;
     _mount(): void;
 }
 
@@ -1004,6 +1019,7 @@ declare class UPresence extends UElement {
     set animation(val: PresenceAnimation);
     connectedCallback(): void;
     attributeChangedCallback(name: string, oldVal: string | null, newVal: string | null): void;
+    private _sync;
     private _enter;
     private _leave;
     _mount(): void;
@@ -1165,6 +1181,7 @@ declare class UPopover extends UElement {
     toggle(): void;
     connectedCallback(): void;
     attributeChangedCallback(name: string, oldVal: string | null, newVal: string | null): void;
+    private _sync;
     private _updateOpenState;
     private _position;
     private _handleOutsideClick;
@@ -1214,6 +1231,7 @@ declare class UDropdown extends UElement {
     toggle(): void;
     connectedCallback(): void;
     attributeChangedCallback(name: string, oldVal: string | null, newVal: string | null): void;
+    private _sync;
     private _renderItems;
     private _updateSelected;
     private _updateOpenState;
@@ -1246,6 +1264,7 @@ declare class UAccordion extends UElement {
     set multiple(val: boolean);
     connectedCallback(): void;
     attributeChangedCallback(name: string, oldVal: string | null, newVal: string | null): void;
+    private _sync;
     private _initItems;
     toggle(key: string): void;
     private _syncItems;
@@ -1267,6 +1286,7 @@ declare class UAccordionItem extends UElement {
     set open(val: boolean);
     connectedCallback(): void;
     attributeChangedCallback(name: string, oldVal: string | null, newVal: string | null): void;
+    private _sync;
     _mount(): void;
 }
 
@@ -1331,6 +1351,7 @@ declare class UCalendar extends UElement {
     set value(val: string);
     connectedCallback(): void;
     attributeChangedCallback(name: string, oldVal: string | null, newVal: string | null): void;
+    private _sync;
     private _renderDayNames;
     private _render;
     private _navigate;
@@ -1377,6 +1398,7 @@ declare class UDataTable extends UElement {
     set pageSize(val: number);
     connectedCallback(): void;
     attributeChangedCallback(name: string, oldVal: string | null, newVal: string | null): void;
+    private _sync;
     private _getProcessedData;
     private _getPageData;
     private _render;
@@ -1473,6 +1495,7 @@ interface ContextMenuProps {
     onSelect?: (value: string) => void;
 }
 declare class UContextMenu extends UElement {
+    static get observedAttributes(): string[];
     private _items;
     private _open;
     private _selectedIndex;
@@ -1480,8 +1503,10 @@ declare class UContextMenu extends UElement {
     get items(): ContextMenuItem[];
     set items(val: ContextMenuItem[]);
     connectedCallback(): void;
+    attributeChangedCallback(name: string, oldVal: string | null, newVal: string | null): void;
     private _parseSlotItems;
     private _renderItems;
+    private _sync;
     private _openMenu;
     private _closeMenu;
     private _focusFirst;
@@ -1507,6 +1532,7 @@ declare class USortable extends UElement {
     private _offsetY;
     private _dragClone;
     constructor();
+    attributeChangedCallback(name: string, oldVal: string | null, newVal: string | null): void;
     get disabled(): boolean;
     set disabled(val: boolean);
     get handleSelector(): string;
@@ -1517,6 +1543,8 @@ declare class USortable extends UElement {
     private _onPointerDown;
     private _onPointerMove;
     private _onPointerUp;
+    connectedCallback(): void;
+    private _sync;
     _mount(): void;
 }
 
@@ -1527,8 +1555,12 @@ interface FormProps {
 }
 declare class UForm extends UElement {
     private _fields;
+    static get observedAttributes(): string[];
     constructor();
+    attributeChangedCallback(name: string, oldVal: string | null, newVal: string | null): void;
+    connectedCallback(): void;
     get form(): HTMLFormElement | null;
+    private _sync;
     validate(): boolean;
     getValues(): Record<string, string>;
     reset(): void;
@@ -1592,4 +1624,4 @@ declare class UCard extends UElement {
     _mount(): void;
 }
 
-export { type TreeProps as $, type AccordionProps as A, type BadgeProps as B, type CalendarProps as C, type DataTableProps as D, type RouterViewProps as E, type FieldProps as F, type GridProps as G, type HoverableProps as H, type InputProps as I, type SelectProps as J, type KeyboardNavigationProps as K, type LabelProps as L, type ModalProps as M, type SortableProps as N, type OverlayProps as O, type PopoverProps as P, type SpacerProps as Q, type RadioGroupProps as R, type StackProps as S, type SwitchProps as T, type TableProps as U, type TabsProps as V, type TextProps as W, type TextareaProps as X, type ToastProps as Y, type TooltipRootProps as Z, type TransitionProps as _, type AnimateProps as a, UModal as a$, type VirtualListProps as a0, type VisuallyHiddenProps as a1, type AccordionItemProps as a2, type AnimatePreset as a3, type BadgeSize as a4, type BadgeVariant as a5, type BoxAs as a6, type BreadcrumbItem as a7, type CardPadding as a8, type CardVariant as a9, UCalendar as aA, UCard as aB, UCheckbox as aC, UCollection as aD, UCombobox as aE, UCommandPalette as aF, UContainer as aG, UContextMenu as aH, UDataTable as aI, UDialogRoot as aJ, UDismissableLayer as aK, UDrawer as aL, UDropdown as aM, UField as aN, UFocusManager as aO, UFocusScope as aP, UFocusTrap as aQ, UForm as aR, UGrid as aS, UHStack as aT, UHoverable as aU, UInput as aV, UKeyboardNavigation as aW, ULabel as aX, ULink as aY, UList as aZ, ULiveRegion as a_, type CollectionSelection as aa, type ComboboxOption as ab, type CommandItem as ac, type ContextMenuItem as ad, type DataTableColumn as ae, type DrawerSide as af, type DropdownItem as ag, type LiveRegionPoliteness as ah, type PopperPlacement as ai, type PresenceAnimation as aj, type RadioProps as ak, type SelectOption as al, type TableColumn as am, type TextColor as an, type TextSize as ao, type TextWeight as ap, type ToastOptions as aq, type TransitionType as ar, type TreeNodeData as as, UAccordion as at, UAccordionItem as au, UAnimate as av, UBadge as aw, UBox as ax, UBreadcrumb as ay, UButton as az, type BoxProps as b, UOverlay as b0, UPopover as b1, UPopper as b2, UPortal as b3, UPresence as b4, UPressable as b5, URadio as b6, URadioGroup as b7, URouterView as b8, USelect as b9, USortable as ba, USpacer as bb, UStack as bc, USwitch as bd, UTable as be, UTabs as bf, UText as bg, UTextarea as bh, UToast as bi, UTooltipRoot as bj, UTransition as bk, UTree as bl, UVirtualList as bm, UVisuallyHidden as bn, createControlledInput as bo, setPortalRoot as bp, type BreadcrumbProps as c, type ButtonProps as d, type CardProps as e, type CheckboxProps as f, type CollectionProps as g, type ComboboxProps as h, type CommandPaletteProps as i, type ContainerProps as j, type ContextMenuProps as k, type DialogRootProps as l, type DismissableLayerProps as m, type DrawerProps as n, type DropdownProps as o, type FocusManagerProps as p, type FocusScopeProps as q, type FocusTrapProps as r, type FormProps as s, type LinkProps as t, type ListProps as u, type LiveRegionProps as v, type PopperProps as w, type PortalProps as x, type PresenceProps as y, type PressableProps as z };
+export { type PortalProps as $, type AccordionItemProps as A, type BadgeProps as B, type CalendarProps as C, type DataTableColumn as D, type DrawerProps as E, type DrawerSide as F, type DropdownItem as G, type DropdownProps as H, type FieldProps as I, type FocusManagerProps as J, type FocusScopeProps as K, type FocusTrapProps as L, type FormProps as M, type GridProps as N, type HoverableProps as O, type InputProps as P, type KeyboardNavigationProps as Q, type LabelProps as R, type LinkProps as S, type ListProps as T, type LiveRegionPoliteness as U, type LiveRegionProps as V, type ModalProps as W, type OverlayProps as X, type PopoverProps as Y, type PopperPlacement as Z, type PopperProps as _, type AccordionProps as a, UPopover as a$, type PresenceAnimation as a0, type PresenceProps as a1, type PressableProps as a2, type RadioGroupProps as a3, type RadioProps as a4, type RouterViewProps as a5, type SelectOption as a6, type SelectProps as a7, type SortableProps as a8, type SpacerProps as a9, UCheckbox as aA, UCollection as aB, UCombobox as aC, UCommandPalette as aD, UContainer as aE, UContextMenu as aF, UDataTable as aG, UDialogRoot as aH, UDismissableLayer as aI, UDrawer as aJ, UDropdown as aK, UField as aL, UFocusManager as aM, UFocusScope as aN, UFocusTrap as aO, UForm as aP, UGrid as aQ, UHStack as aR, UHoverable as aS, UInput as aT, UKeyboardNavigation as aU, ULabel as aV, ULink as aW, UList as aX, ULiveRegion as aY, UModal as aZ, UOverlay as a_, type StackProps as aa, type SwitchProps as ab, type TableColumn as ac, type TableProps as ad, type TabsProps as ae, type TextColor as af, type TextProps as ag, type TextSize as ah, type TextWeight as ai, type TextareaProps as aj, type ToastOptions as ak, type ToastProps as al, type TooltipRootProps as am, type TransitionProps as an, type TransitionType as ao, type TreeNodeData as ap, type TreeProps as aq, UAccordion as ar, UAccordionItem as as, UAnimate as at, UBadge as au, UBox as av, UBreadcrumb as aw, UButton as ax, UCalendar as ay, UCard as az, type AnimatePreset as b, UPopper as b0, UPortal as b1, UPresence as b2, UPressable as b3, URadio as b4, URadioGroup as b5, URouterView as b6, USelect as b7, USortable as b8, USpacer as b9, UStack as ba, USwitch as bb, UTable as bc, UTabs as bd, UText as be, UTextarea as bf, UToast as bg, UTooltipRoot as bh, UTransition as bi, UTree as bj, UVirtualList as bk, UVisuallyHidden as bl, type VirtualListProps as bm, type VisuallyHiddenProps as bn, createControlledInput as bo, setPortalRoot as bp, type AnimateProps as c, type BadgeSize as d, type BadgeVariant as e, type BoxAs as f, type BoxProps as g, type BreadcrumbItem as h, type BreadcrumbProps as i, type ButtonProps as j, type CardPadding as k, type CardProps as l, type CardVariant as m, type CheckboxProps as n, type CollectionProps as o, type CollectionSelection as p, type ComboboxOption as q, type ComboboxProps as r, type CommandItem as s, type CommandPaletteProps as t, type ContainerProps as u, type ContextMenuItem as v, type ContextMenuProps as w, type DataTableProps as x, type DialogRootProps as y, type DismissableLayerProps as z };