ux4g-components-web 1.4.0 → 1.5.0

package/dist/types.js

@@ -0,0 +1,552 @@
+// Maps variant → CSS class
+export const VARIANT_CLASS_MAP = {
+    'primary': 'ux4g-btn-primary',
+    'outline-primary': 'ux4g-btn-outline-primary',
+    'text-primary': 'ux4g-btn-text-primary',
+    'tonal-primary': 'ux4g-btn-tonal-primary',
+    'danger': 'ux4g-btn-danger',
+    'outline-danger': 'ux4g-btn-outline-danger',
+    'text-danger': 'ux4g-btn-text-danger',
+    'tonal-danger': 'ux4g-btn-tonal-danger',
+    'outline-neutral': 'ux4g-btn-outline-neutral',
+    'text-neutral': 'ux4g-btn-text-neutral',
+};
+// Maps size → CSS class
+export const SIZE_CLASS_MAP = {
+    'xl': 'ux4g-btn-xl',
+    'lg': 'ux4g-btn-lg',
+    'md': 'ux4g-btn-md',
+    'sm': 'ux4g-btn-sm',
+    'xs': 'ux4g-btn-xs',
+};
+// Pure utility — used by both React and Angular wrappers
+export function buildButtonClasses(variant, size, disabled, loading, shape, extra) {
+    const classes = [VARIANT_CLASS_MAP[variant]];
+    const sizeClass = SIZE_CLASS_MAP[size];
+    if (sizeClass)
+        classes.push(sizeClass);
+    if (shape === 'pill')
+        classes.push('ux4g-btn-pill');
+    if (disabled)
+        classes.push('ux4g-btn-disabled');
+    if (loading)
+        classes.push('ux4g-btn-loading');
+    if (extra)
+        classes.push(extra);
+    return classes.join(' ');
+}
+export const SPINNER_VARIANT_CLASS_PART = {
+    primary: 'primary',
+    inverse: 'inverse',
+    danger: 'danger',
+};
+export const SPINNER_SIZE_CLASS_PART = {
+    xl: 'xl',
+    lg: 'lg',
+    md: 'md',
+    sm: 'sm',
+    xs: 'xs',
+};
+export const SPINNER_TYPE_CLASS_PART = {
+    full: 'full',
+    split: 'split',
+    partial: 'partial',
+};
+/** Returns the CSS class(es) for a spinner.
+ *  Base class: `ux4g-spinner-{variant}-{type}` (always present)
+ *  Size class:  `ux4g-spinner-{size}` (omitted when size is 'md' — the default)
+ *  e.g. `ux4g-spinner-primary-full` (md default)
+ *       `ux4g-spinner-primary-full ux4g-spinner-xl` (xl size)
+ */
+export function buildSpinnerClasses(variant, size, type, extra) {
+    const base = `ux4g-spinner-${variant}-${type}`;
+    const sizeClass = size !== 'md' ? `ux4g-spinner-${size}` : null;
+    const parts = [base];
+    if (sizeClass)
+        parts.push(sizeClass);
+    if (extra)
+        parts.push(extra);
+    return parts.join(' ');
+}
+export function buildLinkClasses(variant, size, extra) {
+    const base = variant === 'neutral'
+        ? `ux4g-text-link-neutral-${size}`
+        : `ux4g-text-link-${size}`;
+    return extra ? `${base} ${extra}` : base;
+}
+export function buildBadgeClasses(type, color, size, extra) {
+    const parts = [`ux4g-badge-${type}-${color}`];
+    if (size)
+        parts.push(`ux4g-badge-${size}`);
+    if (extra)
+        parts.push(extra);
+    return parts.join(' ');
+}
+export function buildAvatarClasses(avatarType, size, extra) {
+    if (avatarType === 'group') {
+        return extra ? `ux4g-avatar-group ${extra}` : 'ux4g-avatar-group';
+    }
+    const parts = ['ux4g-avatar', `ux4g-avatar-${avatarType}`];
+    if (size)
+        parts.push(`ux4g-avatar-${size}`);
+    if (extra)
+        parts.push(extra);
+    return parts.join(' ');
+}
+export function buildImageContainerClasses(ratio, rounded, overlay, extra) {
+    const parts = [];
+    if (overlay)
+        parts.push('ux4g-img-overlay');
+    if (rounded)
+        parts.push('ux4g-img-rounded');
+    if (ratio)
+        parts.push(`ux4g-ratio-${ratio}`);
+    if (extra)
+        parts.push(extra);
+    return parts.join(' ');
+}
+export function buildChipClasses(chipType, size, active, extra) {
+    // xs is only valid for input chips; filter and choice clamp to sm
+    const effectiveSize = (chipType !== 'input' && size === 'xs') ? 'sm' : size;
+    const parts = [`ux4g-${chipType}-chip-${effectiveSize}`];
+    if (active)
+        parts.push('active');
+    if (extra)
+        parts.push(extra);
+    return parts.join(' ');
+}
+export function buildTagClasses(variant, color, small, extra) {
+    const parts = [`ux4g-tag-${variant}-${color}`];
+    if (small)
+        parts.push('ux4g-tag-s');
+    if (extra)
+        parts.push(extra);
+    return parts.join(' ');
+}
+export function buildDividerClasses(orientation, extra) {
+    const base = `ux4g-divider-${orientation}`;
+    return extra ? `${base} ${extra}` : base;
+}
+export function buildBreadcrumbClasses(separator, extra) {
+    const base = `ux4g-breadcrumb ux4g-breadcrumb-${separator}`;
+    return extra ? `${base} ${extra}` : base;
+}
+export function buildCheckboxClasses(size, error, extra) {
+    const parts = ['ux4g-checkbox', `ux4g-checkbox-${size}`];
+    if (error)
+        parts.push('ux4g-checkbox-error');
+    if (extra)
+        parts.push(extra);
+    return parts.join(' ');
+}
+export function buildRadioClasses(size, error, extra) {
+    const parts = ['ux4g-radio', `ux4g-radio-${size}`];
+    if (error)
+        parts.push('ux4g-radio-error');
+    if (extra)
+        parts.push(extra);
+    return parts.join(' ');
+}
+export function buildSwitchClasses(size, extra) {
+    const base = `ux4g-switch ux4g-switch-${size}`;
+    return extra ? `${base} ${extra}` : base;
+}
+export function buildCardClasses(variant, layout, extra) {
+    const parts = ['ux4g-card', `ux4g-card-${variant}`, `ux4g-card-${layout}`];
+    if (extra)
+        parts.push(extra);
+    return parts.join(' ');
+}
+export function buildInputContainerClasses(size, state, extra) {
+    const parts = ['ux4g-input-container', `ux4g-input-${size}`, `ux4g-input-${state}`];
+    if (extra)
+        parts.push(extra);
+    return parts.join(' ');
+}
+export function buildListClasses(variant, size, extra) {
+    const parts = ['ux4g-list', `ux4g-list-${variant}`, `ux4g-list-${size}`];
+    if (extra)
+        parts.push(extra);
+    return parts.join(' ');
+}
+export function buildDropdownClasses(type, mode, size, state, open, extra) {
+    const parts = [
+        'ux4g-dropdown',
+        `ux4g-dropdown-${type}`,
+        `ux4g-dropdown-${mode}`,
+        `ux4g-dropdown-${size}`,
+        `ux4g-dropdown-${state}`,
+    ];
+    if (open)
+        parts.push('is-open');
+    if (extra)
+        parts.push(extra);
+    return parts.join(' ');
+}
+export function buildComboboxClasses(type, size, state, open, extra) {
+    const parts = [
+        'ux4g-combobox',
+        `ux4g-combobox-${type}`,
+        `ux4g-combobox-${size}`,
+        `ux4g-combobox-${state}`,
+    ];
+    if (open)
+        parts.push('is-open');
+    if (extra)
+        parts.push(extra);
+    return parts.join(' ');
+}
+export function buildModalBackdropClasses(opacity, blur, open, extra) {
+    const parts = ['ux4g-modal-backdrop', `ux4g-modal-backdrop-${opacity}`];
+    if (blur)
+        parts.push('ux4g-modal-backdrop-blur');
+    if (open)
+        parts.push('is-open');
+    if (extra)
+        parts.push(extra);
+    return parts.join(' ');
+}
+export function buildModalBoxClasses(size, centerContent, extra) {
+    const parts = ['ux4g-modal-box', `ux4g-modal-${size}`];
+    if (centerContent)
+        parts.push('ux4g-modal-center-content');
+    if (extra)
+        parts.push(extra);
+    return parts.join(' ');
+}
+export function buildAlertClasses(variant, layout, extra) {
+    const parts = ['ux4g-alert', `ux4g-alert-${variant}`];
+    if (layout === 'center')
+        parts.push('ux4g-alert-center');
+    else if (layout === 'wide')
+        parts.push('ux4g-alert-wide');
+    if (extra)
+        parts.push(extra);
+    return parts.join(' ');
+}
+export function buildContextAlertClasses(variant, extra) {
+    const parts = ['ux4g-context-alert', `ux4g-alert-${variant}`];
+    if (extra)
+        parts.push(extra);
+    return parts.join(' ');
+}
+export function buildAlertContainerClasses(position, extra) {
+    const parts = ['ux4g-alert-container', `ux4g-alert-${position}`];
+    if (extra)
+        parts.push(extra);
+    return parts.join(' ');
+}
+export function buildSearchContainerClasses(size, extra) {
+    const base = `ux4g-search-container ux4g-search-${size}`;
+    return extra ? `${base} ${extra}` : base;
+}
+export function buildPaginationClasses(variant, paginationStyle, extra) {
+    const parts = ['ux4g-pagination'];
+    if (variant === 'dotted') {
+        parts.push('ux4g-pagination-dotted');
+        if (paginationStyle === 'solid')
+            parts.push('ux4g-pagination-solid');
+        else if (paginationStyle === 'translucent')
+            parts.push('ux4g-pagination-translucent');
+    }
+    if (extra)
+        parts.push(extra);
+    return parts.join(' ');
+}
+export function buildTableClasses(size, divider, zebra, interactive, sortable, resizable, headerBrand, extra) {
+    const parts = ['ux4g-table', `ux4g-table-${size}`];
+    if (divider === 'column')
+        parts.push('ux4g-table-column-dividers');
+    else if (divider === 'none')
+        parts.push('ux4g-table-no-row-dividers');
+    if (zebra === 'rows')
+        parts.push('ux4g-table-zebra-rows');
+    else if (zebra === 'cols')
+        parts.push('ux4g-table-zebra-cols');
+    if (interactive)
+        parts.push('ux4g-table-interactive');
+    if (sortable)
+        parts.push('ux4g-table-sortable');
+    if (resizable)
+        parts.push('ux4g-table-resizable');
+    if (headerBrand)
+        parts.push('ux4g-table-header-brand');
+    if (extra)
+        parts.push(extra);
+    return parts.join(' ');
+}
+export function buildPopoverClasses(placement, show, extra) {
+    const parts = ['ux4g-popover', `ux4g-popover-${placement}`];
+    if (show)
+        parts.push('show');
+    if (extra)
+        parts.push(extra);
+    return parts.join(' ');
+}
+export function buildTooltipClasses(placement, size, extra) {
+    const parts = ['ux4g-tooltip', `ux4g-tooltip-${placement}`, `ux4g-tooltip-${size}`];
+    if (extra)
+        parts.push(extra);
+    return parts.join(' ');
+}
+export function buildTabClasses(variant, size, vertical, extra) {
+    const parts = ['ux4g-tab', `ux4g-tab-${variant}`, `ux4g-tab-${size}`];
+    if (vertical)
+        parts.push('ux4g-tab-vertical');
+    if (extra)
+        parts.push(extra);
+    return parts.join(' ');
+}
+export function buildIconButtonClasses(variant, size, pill, extra) {
+    const parts = ['ux4g-icon-btn', `ux4g-icon-btn-${variant}`, `ux4g-icon-btn-${size}`];
+    if (pill)
+        parts.push('ux4g-icon-btn-pill');
+    if (extra)
+        parts.push(extra);
+    return parts.join(' ');
+}
+// -- Accessibility Bar --------------------------------------------------------
+export function buildAccessibilityBarClasses(extra) {
+    return extra ? `ux4g-topbar ${extra}` : 'ux4g-topbar';
+}
+export function buildAccordionClasses(arrowPosition, variant, extra) {
+    const parts = ['ux4g-accordion'];
+    if (arrowPosition === 'right')
+        parts.push('ux4g-accordion-arrow-right');
+    else if (arrowPosition === 'left')
+        parts.push('ux4g-accordion-arrow-left');
+    if (variant === 'bordered')
+        parts.push('ux4g-accordion-bordered');
+    if (extra)
+        parts.push(extra);
+    return parts.join(' ');
+}
+export function buildStepperClasses(orientation, alignment, variant, size, extra) {
+    const parts = ['ux4g-stepper'];
+    if (orientation === 'vertical') {
+        parts.push('ux4g-stepper-vertical');
+    }
+    else {
+        // horizontal (default) — only add classes if alignment is non-default
+        if (alignment === 'center') {
+            parts.push('ux4g-stepper-horizontal');
+            parts.push('ux4g-stepper-center');
+        }
+        else if (alignment === 'left') {
+            parts.push('ux4g-stepper-horizontal');
+            parts.push('ux4g-stepper-left');
+        }
+    }
+    if (variant === 'bottom-line')
+        parts.push('ux4g-stepper-bottom-line');
+    else if (variant === 'bottom-line-fill') {
+        parts.push('ux4g-stepper-bottom-line');
+        parts.push('ux4g-stepper-bottom-line-fill');
+    }
+    else if (variant === 'mobile')
+        parts.push('ux4g-stepper-mobile');
+    else if (variant === 'progress')
+        parts.push('ux4g-stepper-progress');
+    if (size === 's')
+        parts.push('ux4g-stepper-s');
+    if (extra)
+        parts.push(extra);
+    return parts.join(' ');
+}
+export function buildSliderFieldClasses(size, extra) {
+    const parts = ['ux4g-slider-field'];
+    if (size === 'md')
+        parts.push('ux4g-slider-md');
+    if (extra)
+        parts.push(extra);
+    return parts.join(' ');
+}
+export function buildDrawerClasses(placement, open, extra) {
+    const parts = ['ux4g-drawer', `ux4g-drawer-${placement}`];
+    if (open)
+        parts.push('ux4g-drawer-open');
+    if (extra)
+        parts.push(extra);
+    return parts.join(' ');
+}
+export function buildDateTimePickerClasses(mode, extra) {
+    const base = mode === 'date' ? 'ux4g-date-picker-container' : 'ux4g-time-picker-container';
+    return extra ? `${base} ${extra}` : base;
+}
+export function buildStatusPipelineClasses(orientation, alignment, variant, size, extra) {
+    const parts = ['ux4g-status-pipeline-stepper'];
+    if (orientation === 'vertical') {
+        parts.push('ux4g-status-pipeline-vertical');
+        // alignment is IGNORED when orientation='vertical'
+    }
+    else {
+        // horizontal (default) — only add classes if alignment is non-default
+        if (alignment === 'center') {
+            parts.push('ux4g-status-pipeline-horizontal');
+            parts.push('ux4g-status-pipeline-center');
+        }
+        else if (alignment === 'left') {
+            parts.push('ux4g-status-pipeline-horizontal');
+            parts.push('ux4g-status-pipeline-left');
+        }
+    }
+    if (variant === 'bottom-line') {
+        parts.push('ux4g-status-pipeline-bottom-line');
+    }
+    else if (variant === 'bottom-line-fill') {
+        parts.push('ux4g-status-pipeline-bottom-line');
+        parts.push('ux4g-status-pipeline-bottom-line-fill');
+    }
+    else if (variant === 'mobile') {
+        parts.push('ux4g-status-pipeline-mobile');
+    }
+    else if (variant === 'progress') {
+        parts.push('ux4g-status-pipeline-progress');
+    }
+    if (size === 's')
+        parts.push('ux4g-status-pipeline-s');
+    if (extra)
+        parts.push(extra);
+    return parts.join(' ');
+}
+export function buildJourneyTimelineClasses(orientation, extra) {
+    const effectiveOrientation = orientation ?? 'vertical';
+    const base = `ux4g-journey-timeline ux4g-journey-timeline--${effectiveOrientation}`;
+    return extra ? `${base} ${extra}` : base;
+}
+// -- Form Field Group ---------------------------------------------------------
+export function buildFormFieldGroupClasses(extra) {
+    return extra ? `ux4g-form-group ${extra}` : 'ux4g-form-group';
+}
+export function buildOtpInputClasses(state, extra) {
+    const parts = ['ux4g-otp'];
+    if (state && state !== 'default')
+        parts.push(`ux4g-otp-${state}`);
+    if (extra)
+        parts.push(extra);
+    return parts.join(' ');
+}
+export function buildFileUploadClasses(state, extra) {
+    const parts = ['ux4g-upload'];
+    if (state)
+        parts.push(`ux4g-upload-state-${state}`);
+    if (extra)
+        parts.push(extra);
+    return parts.join(' ');
+}
+export function buildProgressIndicatorClasses(type, extra) {
+    const base = type === 'bar' ? 'ux4g-progress-bar' : 'ux4g-progress-circle';
+    return extra ? `${base} ${extra}` : base;
+}
+// -- Feedback -----------------------------------------------------------------
+export function buildFeedbackClasses(extra) {
+    return extra ? `ux4g-feedback ${extra}` : 'ux4g-feedback';
+}
+export function buildDraftStatusBannerClasses(variant, extra) {
+    let base;
+    if (variant === 'auto') {
+        base = 'ux4g-auto-daft-staus-bar';
+    }
+    else if (variant === 'success') {
+        base = 'ux4g-success-daft-staus-bar';
+    }
+    else {
+        // 'default' or undefined
+        base = 'ux4g-daft-staus-bar';
+    }
+    return extra ? `${base} ${extra}` : base;
+}
+export function buildSlaProgressIndicatorClasses(type, extra) {
+    const base = `ux4g-sla-${type}`;
+    return extra ? `${base} ${extra}` : base;
+}
+// -- Carousel -----------------------------------------------------------------
+export function buildCarouselClasses(extra) {
+    return extra ? `ux4g-carousel ${extra}` : 'ux4g-carousel';
+}
+// -- Empty State --------------------------------------------------------------
+export function buildEmptyStateClasses(extra) {
+    return extra ? `ux4g-empty-state ${extra}` : 'ux4g-empty-state';
+}
+export function buildChipGroupClasses(variant, active, extra) {
+    const base = variant === 'choice' ? 'ux4g-choice-chip-group' : 'ux4g-filter-chip-group';
+    const parts = [base];
+    if (active)
+        parts.push('active');
+    if (extra)
+        parts.push(extra);
+    return parts.join(' ');
+}
+// -- Navbar -------------------------------------------------------------------
+export function buildNavbarClasses(extra) {
+    return extra ? `ux4g-navbar ${extra}` : 'ux4g-navbar';
+}
+export function buildSocialLinksClasses(size, extra) {
+    let gapClass;
+    if (size === 'sm') {
+        gapClass = 'ux4g-gap-xs';
+    }
+    else if (size === 'lg') {
+        gapClass = 'ux4g-gap-m';
+    }
+    else {
+        // 'md' or undefined (default)
+        gapClass = 'ux4g-gap-s';
+    }
+    const base = `ux4g-d-flex ${gapClass}`;
+    return extra ? `${base} ${extra}` : base;
+}
+export function buildSlotGridClasses(variant, extra) {
+    const base = variant === 'compact'
+        ? 'ux4g-time-slot-compact-container'
+        : 'ux4g-time-slot-weekly-container';
+    return extra ? `${base} ${extra}` : base;
+}
+export function buildFooterClasses(theme, extra) {
+    let base;
+    if (theme === 'primary')
+        base = 'ux4g-footer-primary';
+    else if (theme === 'dark')
+        base = 'ux4g-footer-dark';
+    else
+        base = '';
+    if (extra)
+        return base ? `${base} ${extra}` : extra;
+    return base;
+}
+export function buildResultListRowClasses(variation, extra) {
+    const parts = ['ux4g-result-list'];
+    if (variation && variation !== 'default')
+        parts.push(`ux4g-result-list-${variation}`);
+    if (extra)
+        parts.push(extra);
+    return parts.join(' ');
+}
+// ── Mega Menu ─────────────────────────────────────────────────────────────────
+/** Returns the CSS class string for the mega-menu root element.
+ *  Base class: `ux4g-mega-menu` (always present)
+ *  Dropdown:   `ux4g-mega-menu--dropdown` (when dropdown is true)
+ *  Right:      `ux4g-mega-menu--dropdown-right` (only when BOTH dropdown AND dropdownRight are true)
+ */
+export function buildMegaMenuClasses(dropdown, dropdownRight, extra) {
+    const parts = ['ux4g-mega-menu'];
+    if (dropdown)
+        parts.push('ux4g-mega-menu--dropdown');
+    if (dropdown && dropdownRight)
+        parts.push('ux4g-mega-menu--dropdown-right');
+    if (extra)
+        parts.push(extra);
+    return parts.join(' ');
+}
+/** Returns the CSS class string for the mega-menu wrapper element (dropdown positioning context).
+ *  Base class: `ux4g-mega-menu-wrapper` (always present)
+ *  Active:     `ux4g-mega-menu-wrapper--active` (when active is true)
+ */
+export function buildMegaMenuWrapperClasses(active, extra) {
+    const parts = ['ux4g-mega-menu-wrapper'];
+    if (active)
+        parts.push('ux4g-mega-menu-wrapper--active');
+    if (extra)
+        parts.push(extra);
+    return parts.join(' ');
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ux4g-components-web",
-  "version": "1.4.0",
+  "version": "1.5.0",
   "type": "module",
   "description": "UX4G Design System — CSS bundle, design tokens, utilities, and shared Class_Builder types",
   "scripts": {
@@ -20,6 +20,12 @@
       "require": "./dist/types/index.cjs",
       "default": "./dist/types/index.mjs"
     },
+    "./dom-generators": {
+      "types": "./dist/dom-generators/index.d.ts",
+      "import": "./dist/dom-generators/index.mjs",
+      "require": "./dist/dom-generators/index.cjs",
+      "default": "./dist/dom-generators/index.mjs"
+    },
     "./runtime": {
       "types": "./dist/runtime/index.d.ts",
       "import": "./dist/runtime/index.mjs",
@@ -38,6 +44,9 @@
       "types": [
         "./dist/types/index.d.ts"
       ],
+      "dom-generators": [
+        "./dist/dom-generators/index.d.ts"
+      ],
       "runtime": [
         "./dist/runtime/index.d.ts"
       ],
@@ -50,7 +59,8 @@
     "styles/ux4g.css",
     "styles/cascade-fixes.css",
     "dist/",
-    "dist/runtime/"
+    "dist/runtime/",
+    "dist/dom-generators/"
   ],
   "devDependencies": {
     "@rollup/plugin-replace": "^6.0.3",