ux4g-components-web 1.4.0 → 1.5.0

package/dist/dom-generators/dom-generators/stepper.d.ts

@@ -0,0 +1,21 @@
+import { NodeDescriptor } from './types.js';
+import { StepperOrientation, StepperVariant, StepperSize } from '../types.js';
+export interface StepperGeneratorProps {
+    steps: Array<{
+        label: string;
+        description?: string;
+    }>;
+    activeStep: number;
+    orientation?: StepperOrientation;
+    variant?: StepperVariant;
+    size?: StepperSize;
+}
+/**
+ * Generates a complete Stepper DOM descriptor tree.
+ *
+ * Produces step indicators with completed/current/pending states.
+ * Steps before `activeStep` are marked as completed, the step at
+ * `activeStep` has `aria-current="step"`, and subsequent steps
+ * are marked as pending.
+ */
+export declare function generateStepperDOM(props: StepperGeneratorProps): NodeDescriptor;

package/dist/dom-generators/dom-generators/table.d.ts

@@ -0,0 +1,23 @@
+import { NodeDescriptor } from './types.js';
+import { TableSize, TableDivider, TableZebra } from '../types.js';
+export interface TableGeneratorProps {
+    columns: Array<{
+        key: string;
+        label: string;
+        sortable?: boolean;
+        width?: string;
+    }>;
+    data: Array<Record<string, unknown>>;
+    size?: TableSize;
+    divider?: TableDivider;
+    zebra?: TableZebra;
+    interactive?: boolean;
+}
+/**
+ * Generates a complete Table DOM descriptor tree.
+ *
+ * Produces a `<table>` with `<thead>` containing one `<th>` per column
+ * and `<tbody>` containing one `<tr>` per data row, each with one `<td>` per column.
+ * Sortable columns receive `aria-sort="none"` on their `<th>`.
+ */
+export declare function generateTableDOM(props: TableGeneratorProps): NodeDescriptor;

package/dist/dom-generators/dom-generators/tabs.d.ts

@@ -0,0 +1,21 @@
+import { NodeDescriptor } from './types.js';
+import { TabVariant, TabSize } from '../types.js';
+export interface TabsGeneratorProps {
+    tabs: Array<{
+        label: string;
+        content: string;
+        disabled?: boolean;
+    }>;
+    activeIndex?: number;
+    variant?: TabVariant;
+    size?: TabSize;
+    vertical?: boolean;
+}
+/**
+ * Generates a complete Tabs DOM descriptor tree.
+ *
+ * Produces a tablist container with `role="tablist"`, individual tabs with
+ * `role="tab"` and `aria-selected`, and corresponding panels with
+ * `role="tabpanel"` and `aria-labelledby`.
+ */
+export declare function generateTabsDOM(props: TabsGeneratorProps): NodeDescriptor;

package/dist/dom-generators/dom-generators/time-picker.d.ts

@@ -0,0 +1,18 @@
+import { NodeDescriptor } from './types.js';
+export interface TimePickerGeneratorProps {
+    value?: string;
+    min?: string;
+    max?: string;
+    step?: number;
+    format?: '12h' | '24h';
+}
+/**
+ * Generates a complete TimePicker DOM descriptor tree.
+ *
+ * Produces hour, minute, and (for 12h format) period spinbutton elements
+ * with appropriate ARIA attributes: `role="spinbutton"`, `aria-valuemin`,
+ * `aria-valuemax`, `aria-valuenow`, and `aria-label`.
+ *
+ * The root element uses CSS classes from `buildDateTimePickerClasses('time')`.
+ */
+export declare function generateTimePickerDOM(props: TimePickerGeneratorProps): NodeDescriptor;

package/dist/dom-generators/dom-generators/tooltip.d.ts

@@ -0,0 +1,17 @@
+import { NodeDescriptor } from './types.js';
+import { TooltipPlacement, TooltipSize } from '../types.js';
+export interface TooltipGeneratorProps {
+    text: string;
+    placement?: TooltipPlacement;
+    size?: TooltipSize;
+    triggerId?: string;
+}
+/**
+ * Generates a complete Tooltip DOM descriptor tree.
+ *
+ * Produces a tooltip container with `role="tooltip"`, an arrow element,
+ * `data-ux4g-tooltip` on the trigger element, `data-placement` for positioning,
+ * and `aria-describedby` on the trigger referencing the tooltip ID.
+ * Compatible with Runtime_JS MutationObserver-based initialization.
+ */
+export declare function generateTooltipDOM(props: TooltipGeneratorProps): NodeDescriptor;

package/dist/dom-generators/dom-generators/types.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Represents a single DOM element in a tree structure.
+ * DOM Generator functions return trees of NodeDescriptor objects
+ * which framework wrappers convert to rendered output.
+ */
+export interface NodeDescriptor {
+    tag: string;
+    props: {
+        className?: string;
+        id?: string;
+        role?: string;
+        tabIndex?: number;
+        [key: string]: string | boolean | number | undefined;
+    };
+    children: (NodeDescriptor | string)[];
+}
+/**
+ * Error thrown when a DOM Generator receives an invalid prop value.
+ * Provides detailed context about which component, prop, and value caused the issue.
+ */
+export declare class DOMGeneratorValidationError extends Error {
+    componentName: string;
+    propName: string;
+    propValue: unknown;
+    expectedType: string;
+    constructor(componentName: string, propName: string, propValue: unknown, expectedType: string);
+}

package/dist/dom-generators/dom-generators/validate.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Throws if the value is null or undefined.
+ */
+export declare function validateRequired(componentName: string, propName: string, value: unknown): void;
+/**
+ * Throws if typeof value does not match the expected type string.
+ */
+export declare function validateType(componentName: string, propName: string, value: unknown, expectedType: string): void;
+/**
+ * Throws if the value is not a member of the allowed values set.
+ */
+export declare function validateEnum(componentName: string, propName: string, value: unknown, allowedValues: readonly unknown[]): void;
+/**
+ * Throws if the numeric value is outside the given [min, max] range (inclusive).
+ */
+export declare function validateRange(componentName: string, propName: string, value: unknown, min: number, max: number): void;
+/**
+ * Throws if the value is not an array.
+ */
+export declare function validateArray(componentName: string, propName: string, value: unknown): void;

package/dist/dom-generators/drawer.d.ts

@@ -0,0 +1,19 @@
+import { NodeDescriptor } from './types';
+import { DrawerPlacement } from '../types.js';
+export interface DrawerGeneratorProps {
+    open?: boolean;
+    placement?: DrawerPlacement;
+    title?: string;
+    closable?: boolean;
+}
+/**
+ * Generates a complete Drawer DOM descriptor tree.
+ *
+ * Produces a backdrop element and a drawer panel with `role="dialog"`,
+ * `aria-modal="true"`, an optional close button with `data-ux4g-drawer-close`,
+ * and an optional title heading. Compatible with Runtime_JS
+ * MutationObserver-based initialization.
+ */
+export declare function generateDrawerDOM(props: DrawerGeneratorProps): NodeDescriptor;
+
+

package/dist/dom-generators/dropdown.d.ts

@@ -0,0 +1,28 @@
+import { NodeDescriptor } from './types';
+import { DropdownSize, DropdownState } from '../types.js';
+export interface DropdownGeneratorProps {
+    options: Array<{
+        label: string;
+        value: string;
+        disabled?: boolean;
+        group?: string;
+    }>;
+    value?: string | string[];
+    placeholder?: string;
+    searchable?: boolean;
+    multiple?: boolean;
+    disabled?: boolean;
+    size?: DropdownSize;
+    state?: DropdownState;
+    open?: boolean;
+}
+/**
+ * Generates a complete Dropdown DOM descriptor tree.
+ *
+ * Produces a trigger button with `data-ux4g-dropdown-toggle`, a menu container
+ * with `role="listbox"`, and option items with `role="option"` and `aria-selected`.
+ * Compatible with Runtime_JS MutationObserver-based initialization.
+ */
+export declare function generateDropdownDOM(props: DropdownGeneratorProps): NodeDescriptor;
+
+

package/dist/dom-generators/file-upload.d.ts

@@ -0,0 +1,22 @@
+import { NodeDescriptor } from './types';
+import { FileUploadState } from '../types.js';
+export interface FileUploadGeneratorProps {
+    files?: Array<{
+        name: string;
+        size: number;
+    }>;
+    accept?: string;
+    maxSizeBytes?: number;
+    multiple?: boolean;
+    state?: FileUploadState;
+}
+/**
+ * Generates a complete FileUpload DOM descriptor tree.
+ *
+ * Produces a drop zone with `role="button"`, a visually hidden file input,
+ * and a file list displaying name and size of each selected file.
+ * Compatible with Runtime_JS MutationObserver-based initialization.
+ */
+export declare function generateFileUploadDOM(props: FileUploadGeneratorProps): NodeDescriptor;
+
+

package/dist/dom-generators/id-generator.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Generates a unique ID by combining the given prefix with an incrementing counter.
+ * Produces IDs like `ux4g-dropdown-1`, `ux4g-tab-panel-2`, etc.
+ */
+export declare function generateId(prefix: string): string;
+/**
+ * Resets the ID counter to zero. Useful for testing to ensure deterministic output.
+ */
+export declare function resetIdCounter(): void;