@golemui/gui-shared 0.0.2 → 0.12.1

package/lib/dx/core/sharedSensibleDefaults.service.d.ts

@@ -0,0 +1,35 @@
+import { Localizable } from '@golemui/core';
+/**
+ * Config interface for types that support automatic labels.
+ */
+export interface LabelSensibleDefaultsConfig {
+    suppressAutomaticLabels?: boolean;
+}
+/**
+ * Config interface for types that support automatic placeholders.
+ */
+export interface PlaceholderSensibleDefaultsConfig {
+    suppressAutomaticPlaceholders?: boolean;
+}
+export declare function pathToLabel(path: string | undefined): string;
+/**
+ * Auto-generate a label from the field path if none is explicitly set.
+ * Reusable across inputs, calendar, and future input-like types.
+ *
+ * Behavior must match existing `inputSensibleDefaults.service.ts` and
+ * `calendarSensibleDefaults.service.ts` exactly.
+ */
+export declare function processAutoLabel<D extends {
+    path?: string;
+    label?: Localizable | null;
+}>(def: D, config: LabelSensibleDefaultsConfig): D;
+/**
+ * Auto-generate a placeholder from the field path if none is explicitly set.
+ * Reusable across inputs, textarea, password, and future input-like types.
+ *
+ * Behavior must match existing `inputSensibleDefaults.service.ts` exactly.
+ */
+export declare function processAutoPlaceholder<D extends {
+    path?: string;
+    placeholder?: string;
+}>(def: D, config: PlaceholderSensibleDefaultsConfig): D;

package/lib/dx/core/stateExpansion.service.d.ts

@@ -0,0 +1,31 @@
+import { NonFunctionWidget } from '@golemui/core';
+import { GslLeafSelector, MergeResult } from './dx.domain';
+import { EventIdGenerator, EventRegistry } from './itemTypeRegistry';
+export interface StateData {
+    stateOverrides: Record<string, Record<string, any>>;
+}
+export declare class StateExpansionService {
+    /**
+     * Extracts `states` from a merge result, combining with state-targeted
+     * GSL leaf selectors from `_gslStates`.
+     *
+     * Returns a cleaned merge result (no states) and accumulated state data.
+     */
+    extractFromMergeResult(mergeResult: MergeResult, stateLeafs: GslLeafSelector[]): {
+        cleanedResult: MergeResult;
+        stateData: StateData;
+    };
+    /**
+     * Applies state overrides to a core widget. Each override produces:
+     * - `visible: true/false` → `include: { in }` / `exclude: { from }`
+     * - Core suffixable props → `'prop.stateName': value` at widget root
+     * - Event handlers → `on: { 'eventType.stateName': eventId }` with registry wiring
+     * - Custom props → `props: { 'prop.stateName': value }`
+     */
+    applyToWidget(widget: NonFunctionWidget, stateData: StateData, eventRegistry: EventRegistry, eventIdGenerator: EventIdGenerator): NonFunctionWidget;
+    hasStateData(stateData: StateData): boolean;
+    private applyVisibility;
+    private applyStateEvent;
+}
+declare const stateExpansionService: StateExpansionService;
+export default stateExpansionService;

package/lib/dx/core/widgetMapper.service.d.ts

@@ -0,0 +1,13 @@
+import { FormWidget, NonFunctionWidget, UiState } from '@golemui/core';
+import { GslItemType, MergeResult } from './dx.domain';
+export declare class WidgetMapper {
+    mapToWidget<StateKeys extends UiState = never, FormData extends Record<string, any> = any>(mergeResult: MergeResult, itemType: GslItemType): FormWidget<StateKeys, FormData>;
+    mapStaticDef<StateKeys extends UiState = never, FormData extends Record<string, any> = any>(def: Record<string, any>, itemType: GslItemType): NonFunctionWidget<StateKeys, FormData>;
+    /**
+     * Injects BaseWidget-level fields that all widget types share.
+     * Centralized here so individual mappers don't need to repeat the pattern.
+     */
+    private applyBaseWidgetFields;
+}
+declare const widgetMapper: WidgetMapper;
+export default widgetMapper;

package/lib/dx/core/widgetMerger.service.d.ts

@@ -0,0 +1,14 @@
+import { GslItemType, MergeResult, ResolvedSelectors, RuntimeFunction } from './dx.domain';
+import { ObjectUtils } from '../../utils/objectUtils.service';
+export declare class WidgetMerger {
+    private readonly objectUtils;
+    constructor(objectUtils: ObjectUtils);
+    merge(baseDef: Record<string, any> | RuntimeFunction, itemType: GslItemType, resolved: ResolvedSelectors): MergeResult;
+    private collectDecorators;
+    private applySensibleDefaults;
+    private createPromotedFunction;
+    private wrapWithSensibleDefaults;
+    private composeRuntimeFunctions;
+}
+declare const widgetMerger: WidgetMerger;
+export default widgetMerger;

package/lib/dx/dx.service.d.ts

@@ -0,0 +1,40 @@
+import { UiState } from '@golemui/core';
+import { DxDefinitions, DxResult } from './formDef.domain';
+import { DxFormConfig, GslSelectorsInput } from './core/dx.domain';
+import { SelectorNormalizer } from './core/selectorNormalizer.service';
+import { EventWiringService } from './core/eventWiring.service';
+import { ItemWalker } from './core/itemWalker.service';
+/**
+ * Transforms a developer-friendly form definition into a fully-fledged form definition
+ * usable by the framework ({@link Form}<STATE_KEYS, FORM_DATA>).
+ *
+ * Orchestrates: prepareForm → walkAndMap → buildResult.
+ */
+export declare class DxService {
+    private readonly selectorNormalizer;
+    private readonly eventWiring;
+    private readonly walker;
+    constructor(selectorNormalizer: SelectorNormalizer, eventWiring: EventWiringService, walker: ItemWalker);
+    processDxFacade<STATE_KEYS extends UiState = never, FORM_DATA extends Record<string, any> = any>(dxDefinitionsRaw: DxDefinitions, gslSelectorsInput?: GslSelectorsInput, formConfigInput?: DxFormConfig<STATE_KEYS>): DxResult<STATE_KEYS, FORM_DATA>;
+    /**
+     * Normalizes raw form definitions and applies form-level defaults.
+     *
+     * Steps:
+     *  1. Normalize definitions — ensure a flat array; convert bare functions to display widgets.
+     *  2. Normalize selectors — convert mixed leaf/aggregated selectors into a uniform
+     *     aggregated shape, and extract form-level config (see {@link FormConfig}).
+     *  3. Auto-submit — unless suppressed, append a submit button if none was declared.
+     *     Throws if more than one submit button is found.
+     *  4. Auto-stack — unless suppressed, wrap all definitions in a synthetic root
+     *     flex column layout so the form renders as a single vertical container.
+     */
+    private prepareForm;
+    /**
+     * Converts DX `$`-separated state names to core's `:`-separated names.
+     * E.g. `{ register$adult: 'expr' }` → `{ 'register:adult': 'expr' }`.
+     */
+    private convertStateNames;
+    private buildResult;
+}
+declare const formDefs: DxService;
+export { formDefs };

package/lib/dx/formDef.domain.d.ts

@@ -0,0 +1,52 @@
+import { ValidateOn } from '@golemui/core';
+import { ValidGuiShortcut } from './core/dx.domain';
+import { DxCommonFields, DxInternalFields } from './core/dxBase.types';
+import { DxRuntimeParams } from './core/dxUtilityTypes';
+import { Dependencies } from '../shared';
+import * as Core from '@golemui/core';
+export type GslItemType = string;
+/**
+ * @deprecated Use DxCommonFields (+ kind-specific DxInputBase/DxActionBase/etc.)
+ * for public decorator interfaces. Use DxInternalFields & DxCommonFields for
+ * pipeline-internal code that needs the full set.
+ *
+ * This type is kept as an alias for backward compatibility with pipeline internals.
+ */
+export type WidgetItemDecorator = DxInternalFields & DxCommonFields;
+export type DxDisplayRenderFn = (params: DxRuntimeParams) => any;
+export type DxDefinitionItem = ValidGuiShortcut | DxDisplayRenderFn;
+export type DxDefinitions = DxDefinitionItem | DxDefinitionItem[];
+export type FormEvents = (event: Core.FormEvent) => void;
+export interface DxResult<S extends Core.UiState = never, F extends Record<string, any> = any> {
+    form: Core.Form<S, F>;
+    events?: FormEvents;
+    dependencies?: Dependencies;
+    widgetLoaders?: Record<string, () => Promise<unknown>>;
+    validateOn?: ValidateOn;
+    itemRenderers?: Record<string, unknown>;
+}
+export type { DxEventHandler, DxInternalFields, DxCommonFields, DxInputBase, DxActionBase, DxLayoutBase, DxDisplayBase, } from './core/dxBase.types';
+export type { DataInputDecorator, NumberDataInputValidator, NumberDataInputDecorator, TextDataInputValidator, TextDataInputDecorator, BooleanDataInputDecorator, InputDecorator, ValidShortcutType, DxRuntimeParams, InputTags, } from './shortcuts/inputs/inputs.domain';
+export type { ActionDecorator, ActionDefCallback, ActionDefOrCallback, } from './shortcuts/actions/actions.domain';
+export type { PasswordDecorator } from './shortcuts/password/password.domain';
+export type { CheckboxDecorator } from './shortcuts/checkbox/checkbox.domain';
+export type { DateInputDecorator } from './shortcuts/date-input/dateInput.domain';
+export type { CurrencyDecorator } from './shortcuts/currency/currency.domain';
+export type { RangeCalendarDecorator } from './shortcuts/range-calendar/rangeCalendar.domain';
+export type { SelectDecorator } from './shortcuts/select/select.domain';
+export type { RadiogroupDecorator } from './shortcuts/radiogroup/radiogroup.domain';
+export type { TabsDecorator } from './shortcuts/tabs/tabs.domain';
+export type { ListDecorator } from './shortcuts/list/list.domain';
+export type { AlertDecorator } from './shortcuts/alert/alert.domain';
+export type { DatePickerDecorator } from './shortcuts/date-picker/datePicker.domain';
+export type { DropdownDecorator } from './shortcuts/dropdown/dropdown.domain';
+export type { AccordionDecorator } from './shortcuts/accordion/accordion.domain';
+export type { RepeaterDecorator } from './shortcuts/repeater/repeater.domain';
+export type { MarkdownDecorator } from './shortcuts/markdown/markdown.domain';
+export type { RangeDateInputDecorator } from './shortcuts/range-date-input/rangeDateInput.domain';
+export type { RangeDatePickerDecorator } from './shortcuts/range-date-picker/rangeDatePicker.domain';
+export type { GslDecoratorCallback, DefOrCallback, GslConfigBase, GuiShortcutOf, } from './core/dxUtilityTypes';
+export { createGslSelector } from './core/dxUtilityTypes';
+export { defineShortcutType } from './core/defineShortcutType';
+export type { LabelSensibleDefaultsConfig, PlaceholderSensibleDefaultsConfig, } from './core/sharedSensibleDefaults.service';
+export { processAutoLabel, processAutoPlaceholder } from './core/sharedSensibleDefaults.service';

package/lib/dx/gui.d.ts

@@ -0,0 +1,74 @@
+import { _guiTextInput } from './shortcuts/inputs/guiTextInput.impl';
+import { _guiNumberInput } from './shortcuts/inputs/guiNumberInput.impl';
+import { _guiBooleanInput } from './shortcuts/inputs/guiBooleanInput.impl';
+import { _guiSelect } from './shortcuts/select/guiSelect.impl';
+import { _guiDropdown } from './shortcuts/dropdown/guiDropdown.impl';
+import { _guiRadiogroup } from './shortcuts/radiogroup/guiRadiogroup.impl';
+import { _guiCheckbox } from './shortcuts/checkbox/guiCheckbox.impl';
+import { _guiTextarea } from './shortcuts/textarea/guiTextarea.impl';
+import { _guiPassword } from './shortcuts/password/guiPassword.impl';
+import { _guiCurrency } from './shortcuts/currency/guiCurrency.impl';
+import { _guiMarkdown } from './shortcuts/markdown/guiMarkdown.impl';
+import { _guiList } from './shortcuts/list/guiList.impl';
+import { _guiCalendar } from './shortcuts/calendar/guiCalendar.impl';
+import { _guiDateInput } from './shortcuts/date-input/guiDateInput.impl';
+import { _guiDatePicker } from './shortcuts/date-picker/guiDatePicker.impl';
+import { _guiRangeCalendar } from './shortcuts/range-calendar/guiRangeCalendar.impl';
+import { _guiRangeDateInput } from './shortcuts/range-date-input/guiRangeDateInput.impl';
+import { _guiRangeDatePicker } from './shortcuts/range-date-picker/guiRangeDatePicker.impl';
+import { _guiCustomInput } from './shortcuts/custom-input/guiCustomInput.impl';
+import { _guiButton } from './shortcuts/actions/guiActions.impl';
+import { _guiCustomAction } from './shortcuts/custom-action/guiCustomAction.impl';
+import { _guiAlert } from './shortcuts/alert/guiAlert.impl';
+import { _guiCustomDisplay } from './shortcuts/custom-display/guiCustomDisplay.impl';
+import { _guiTabs } from './shortcuts/tabs/guiTabs.impl';
+import { _guiAccordion } from './shortcuts/accordion/guiAccordion.impl';
+import { _guiCustomLayout } from './shortcuts/custom-layout/guiCustomLayout.impl';
+import { _guiRepeater } from './shortcuts/repeater/guiRepeater.impl';
+import { ScopeChain } from './shortcuts/scopes/scopeChain';
+export declare const gui: {
+    readonly inputs: {
+        readonly textInput: typeof _guiTextInput;
+        readonly numberInput: typeof _guiNumberInput;
+        readonly booleanInput: typeof _guiBooleanInput;
+        readonly select: typeof _guiSelect;
+        readonly dropdown: typeof _guiDropdown;
+        readonly radiogroup: typeof _guiRadiogroup;
+        readonly checkbox: typeof _guiCheckbox;
+        readonly textarea: typeof _guiTextarea;
+        readonly password: typeof _guiPassword;
+        readonly currency: typeof _guiCurrency;
+        readonly markdown: typeof _guiMarkdown;
+        readonly list: typeof _guiList;
+        readonly calendar: typeof _guiCalendar;
+        readonly dateInput: typeof _guiDateInput;
+        readonly datePicker: typeof _guiDatePicker;
+        readonly rangeCalendar: typeof _guiRangeCalendar;
+        readonly rangeDateInput: typeof _guiRangeDateInput;
+        readonly rangeDatePicker: typeof _guiRangeDatePicker;
+        readonly repeater: typeof _guiRepeater;
+        readonly custom: typeof _guiCustomInput;
+    };
+    readonly actions: {
+        readonly button: typeof _guiButton;
+        readonly submitButton: (defs?: import('./formDef.domain').ActionDecorator | import('./formDef.domain').ActionDefOrCallback) => import('./shortcuts/actions/actions.domain').GuiActionsShortcut;
+        readonly custom: typeof _guiCustomAction;
+    };
+    readonly displays: {
+        readonly display: (render: (params: import('./formDef.domain').DxRuntimeParams) => any, tags?: string[]) => import('./shortcuts/display/display.domain').GuiDisplayItemsShortcut;
+        readonly alert: typeof _guiAlert;
+        readonly custom: typeof _guiCustomDisplay;
+    };
+    readonly layouts: {
+        readonly flex: (children: import('./core/dx.domain').ValidGuiShortcut[], props?: import('./shortcuts/layouts/layouts.domain').FlexFamilyProps, tags?: string[]) => import('./shortcuts/layouts/layouts.domain').GuiLayoutItemsShortcut;
+        readonly horizontalFlex: (children: import('./core/dx.domain').ValidGuiShortcut[], props?: Omit<import('./shortcuts/layouts/layouts.domain').FlexFamilyProps, "direction">, tags?: string[]) => import('./shortcuts/layouts/layouts.domain').GuiLayoutItemsShortcut;
+        readonly verticalFlex: (children: import('./core/dx.domain').ValidGuiShortcut[], props?: Omit<import('./shortcuts/layouts/layouts.domain').FlexFamilyProps, "direction">, tags?: string[]) => import('./shortcuts/layouts/layouts.domain').GuiLayoutItemsShortcut;
+        readonly grid: (children: import('./core/dx.domain').ValidGuiShortcut[], props?: import('./shortcuts/layouts/layouts.domain').GridFamilyProps, tags?: string[]) => import('./shortcuts/layouts/layouts.domain').GuiLayoutItemsShortcut;
+        readonly horizontalGrid: (children: import('./core/dx.domain').ValidGuiShortcut[], props?: Omit<import('./shortcuts/layouts/layouts.domain').GridFamilyProps, "direction">, tags?: string[]) => import('./shortcuts/layouts/layouts.domain').GuiLayoutItemsShortcut;
+        readonly verticalGrid: (children: import('./core/dx.domain').ValidGuiShortcut[], props?: Omit<import('./shortcuts/layouts/layouts.domain').GridFamilyProps, "direction">, tags?: string[]) => import('./shortcuts/layouts/layouts.domain').GuiLayoutItemsShortcut;
+        readonly tabs: typeof _guiTabs;
+        readonly accordion: typeof _guiAccordion;
+        readonly custom: typeof _guiCustomLayout;
+    };
+    readonly selectors: ScopeChain;
+};

package/lib/dx/index.d.ts

@@ -0,0 +1,100 @@
+export { gui } from './gui';
+export { _guiAccordion } from './shortcuts/accordion/guiAccordion.impl';
+export { _guiButton, _guiSubmitButton } from './shortcuts/actions/guiActions.impl';
+export { _guiAlert } from './shortcuts/alert/guiAlert.impl';
+export { _guiCalendar } from './shortcuts/calendar/guiCalendar.impl';
+export { _guiCheckbox } from './shortcuts/checkbox/guiCheckbox.impl';
+export { _guiCurrency } from './shortcuts/currency/guiCurrency.impl';
+export { _guiCustomAction } from './shortcuts/custom-action/guiCustomAction.impl';
+export { _guiCustomDisplay } from './shortcuts/custom-display/guiCustomDisplay.impl';
+export { _guiCustomInput } from './shortcuts/custom-input/guiCustomInput.impl';
+export { _guiCustomLayout } from './shortcuts/custom-layout/guiCustomLayout.impl';
+export { _guiDateInput } from './shortcuts/date-input/guiDateInput.impl';
+export { _guiDatePicker } from './shortcuts/date-picker/guiDatePicker.impl';
+export { _guiDisplay } from './shortcuts/display/guiDisplay.impl';
+export { _guiDropdown } from './shortcuts/dropdown/guiDropdown.impl';
+export { _guiBooleanInput } from './shortcuts/inputs/guiBooleanInput.impl';
+export { _guiNumberInput } from './shortcuts/inputs/guiNumberInput.impl';
+export { _guiTextInput } from './shortcuts/inputs/guiTextInput.impl';
+export { _guiFlex, _guiGrid, _guiHorizontalFlex, _guiHorizontalGrid, _guiVerticalFlex, _guiVerticalGrid, } from './shortcuts/layouts/guiFlex.impl';
+export { _guiList } from './shortcuts/list/guiList.impl';
+export { _guiMarkdown } from './shortcuts/markdown/guiMarkdown.impl';
+export { _guiPassword } from './shortcuts/password/guiPassword.impl';
+export { _guiRadiogroup } from './shortcuts/radiogroup/guiRadiogroup.impl';
+export { _guiRangeCalendar } from './shortcuts/range-calendar/guiRangeCalendar.impl';
+export { _guiRangeDateInput } from './shortcuts/range-date-input/guiRangeDateInput.impl';
+export { _guiRangeDatePicker } from './shortcuts/range-date-picker/guiRangeDatePicker.impl';
+export { _guiRepeater } from './shortcuts/repeater/guiRepeater.impl';
+export { _guiSelect } from './shortcuts/select/guiSelect.impl';
+export { _guiTabs } from './shortcuts/tabs/guiTabs.impl';
+export { _guiTextarea } from './shortcuts/textarea/guiTextarea.impl';
+export { _gslAccordionByUid, _gslAccordions } from './shortcuts/accordion/register';
+export { _gslActionByUid, _gslActions } from './shortcuts/actions/register';
+export { _gslAlertByUid, _gslAlerts } from './shortcuts/alert/register';
+export { _gslCalendarByUid, _gslCalendars } from './shortcuts/calendar/register';
+export { _gslCheckboxByUid, _gslCheckboxes } from './shortcuts/checkbox/register';
+export { _gslCurrencies, _gslCurrencyByUid } from './shortcuts/currency/register';
+export { _gslCustomActionByUid, _gslCustomActions } from './shortcuts/custom-action/register';
+export { _gslCustomDisplayByUid, _gslCustomDisplays } from './shortcuts/custom-display/register';
+export { _gslCustomInputByUid, _gslCustomInputs } from './shortcuts/custom-input/register';
+export { _gslCustomLayoutByUid, _gslCustomLayouts } from './shortcuts/custom-layout/register';
+export { _gslDateInputByUid, _gslDateInputs } from './shortcuts/date-input/register';
+export { _gslDatePickerByUid, _gslDatePickers } from './shortcuts/date-picker/register';
+export { _gslDisplayByUid, _gslDisplays } from './shortcuts/display/register';
+export { _gslDropdownByUid, _gslDropdowns } from './shortcuts/dropdown/register';
+export { _gslBooleanInputs, _gslNumberInputs, _gslTextInputs, } from './shortcuts/inputs/gslInputSubtypes';
+export { _gslInputByUid, _gslInputs } from './shortcuts/inputs/register';
+export { _gslLayoutByUid, _gslLayouts } from './shortcuts/layouts/register';
+export { _gslListByUid, _gslLists } from './shortcuts/list/register';
+export { _gslMarkdownByUid, _gslMarkdowns } from './shortcuts/markdown/register';
+export { _gslPasswordByUid, _gslPasswords } from './shortcuts/password/register';
+export { _gslRadiogroupByUid, _gslRadiogroups } from './shortcuts/radiogroup/register';
+export { _gslRangeCalendarByUid, _gslRangeCalendars } from './shortcuts/range-calendar/register';
+export { _gslRangeDateInputByUid, _gslRangeDateInputs, } from './shortcuts/range-date-input/register';
+export { _gslRangeDatePickerByUid, _gslRangeDatePickers, } from './shortcuts/range-date-picker/register';
+export { _gslRepeaterByUid, _gslRepeaters } from './shortcuts/repeater/register';
+export { _gslSelectByUid, _gslSelects } from './shortcuts/select/register';
+export { _gslTabs, _gslTabsByUid } from './shortcuts/tabs/register';
+export { _gslTextareaByUid, _gslTextareas } from './shortcuts/textarea/register';
+export { _gslStates } from './shortcuts/scopes/gslStates.impl';
+export { _gslTag } from './shortcuts/scopes/gslTag.impl';
+export type { DxFormConfig, FormConfig, GslSelectorsInput } from './core/dx.domain';
+export type { DxRuntimeParams } from './core/dxUtilityTypes';
+export { formDefs } from './dx.service';
+export type { DxDefinitionItem, DxDefinitions, DxDisplayRenderFn, DxResult, FormEvents, } from './formDef.domain';
+export { isDxDefinitions, resolveFormInput } from './resolveFormInput';
+export type { FormInput, GuiFormInitConfig, ResolvedFormInput } from './resolveFormInput';
+export type { AccordionDecorator, GslAccordionConfig, } from './shortcuts/accordion/accordion.domain';
+export type { ActionDecorator, GslActionsConfig } from './shortcuts/actions/actions.domain';
+export type { AlertDecorator, GslAlertsConfig } from './shortcuts/alert/alert.domain';
+export type { CalendarDecorator, GslCalendarConfig } from './shortcuts/calendar/calendar.domain';
+export type { CheckboxDecorator, GslCheckboxConfig } from './shortcuts/checkbox/checkbox.domain';
+export type { CurrencyDecorator, GslCurrencyConfig } from './shortcuts/currency/currency.domain';
+export type { CustomActionDecorator, GslCustomActionConfig, } from './shortcuts/custom-action/customAction.domain';
+export type { CustomDisplayDecorator, GslCustomDisplayConfig, } from './shortcuts/custom-display/customDisplay.domain';
+export type { CustomInputDecorator, GslCustomInputConfig, } from './shortcuts/custom-input/customInput.domain';
+export type { CustomLayoutDecorator, GslCustomLayoutConfig, } from './shortcuts/custom-layout/customLayout.domain';
+export type { DateInputDecorator, GslDateInputConfig, } from './shortcuts/date-input/dateInput.domain';
+export type { DatePickerDecorator, GslDatePickerConfig, } from './shortcuts/date-picker/datePicker.domain';
+export type { DisplayDecorator, GslDisplaysConfig } from './shortcuts/display/display.domain';
+export type { DropdownDecorator, GslDropdownConfig } from './shortcuts/dropdown/dropdown.domain';
+export type { BooleanDataInputDecorator, GslInputsConfig, InputDecorator, InputTags, NumberDataInputDecorator, SimpleFieldDef, TextDataInputDecorator, ValidShortcutType, } from './shortcuts/inputs/inputs.domain';
+export type { GslLayoutsConfig, LayoutDecorator } from './shortcuts/layouts/layouts.domain';
+export type { GslListConfig, ListDecorator } from './shortcuts/list/list.domain';
+export type { GslMarkdownConfig, MarkdownDecorator } from './shortcuts/markdown/markdown.domain';
+export type { GslPasswordConfig, PasswordDecorator } from './shortcuts/password/password.domain';
+export type { GslRadiogroupConfig, RadiogroupDecorator, } from './shortcuts/radiogroup/radiogroup.domain';
+export type { GslRangeCalendarConfig, RangeCalendarDecorator, } from './shortcuts/range-calendar/rangeCalendar.domain';
+export type { GslRangeDateInputConfig, RangeDateInputDecorator, } from './shortcuts/range-date-input/rangeDateInput.domain';
+export type { GslRangeDatePickerConfig, RangeDatePickerDecorator, } from './shortcuts/range-date-picker/rangeDatePicker.domain';
+export type { GslRepeaterConfig, RepeaterDecorator } from './shortcuts/repeater/repeater.domain';
+export type { GslSelectConfig, SelectDecorator } from './shortcuts/select/select.domain';
+export type { GslTabsConfig, TabsDecorator } from './shortcuts/tabs/tabs.domain';
+export type { GslTextareaConfig, TextareaDecorator } from './shortcuts/textarea/textarea.domain';
+export { defineShortcutType } from './core/defineShortcutType';
+export type { ShortcutTypeSelectors } from './core/defineShortcutType';
+export type { DxActionBase, DxCommonFields, DxDisplayBase, DxFormEvent, DxInputBase, DxInternalFields, DxLayoutBase, } from './core/dxBase.types';
+export { extractWidgetProps } from './core/dxPropsHelper';
+export { createGslSelector } from './core/dxUtilityTypes';
+export type { DefOrCallback, GslConfigBase, GslDecoratorCallback, GuiShortcutOf, } from './core/dxUtilityTypes';
+export { processAutoLabel, processAutoPlaceholder } from './core/sharedSensibleDefaults.service';

package/lib/dx/resolveFormInput.d.ts

@@ -0,0 +1,37 @@
+import { ValidateOn } from '@golemui/core';
+import { CustomValidatorSchemas } from '@golemui/gui-validators';
+import { Dependencies } from '../shared';
+import { DxFormConfig, GslSelectorsInput } from './core/dx.domain';
+import { DxDefinitions, FormEvents } from './formDef.domain';
+import * as Core from '@golemui/core';
+export type FormInput = string | Record<string, any> | DxDefinitions;
+export interface GuiFormInitConfig {
+    formDef: FormInput;
+    formSelectors?: GslSelectorsInput;
+    formConfig?: DxFormConfig;
+    customWidgetLoaders?: Record<string, () => Promise<unknown>>;
+    customValidators?: CustomValidatorSchemas;
+    data?: Record<string, any>;
+    meta?: Record<string, any>;
+    middlewares?: Core.Middleware<Core.State, Core.Action>[];
+    validateOn?: ValidateOn;
+    itemRenderers?: Record<string, unknown>;
+    localization?: Core.I18nTranslator;
+    dependencies?: Dependencies;
+    formName?: string;
+}
+export interface ResolvedFormInput<FormData extends Record<string, any> = any> {
+    formDef: string | Record<string, any> | Core.Form<any, FormData>;
+    formEvent?: FormEvents;
+    dependencies?: Dependencies;
+    widgetLoaders?: Record<string, () => Promise<unknown>>;
+    validateOn?: ValidateOn;
+    itemRenderers?: Record<string, unknown>;
+}
+/**
+ * Heuristic discriminator: a DX bundle is an array of `_gui*` shortcuts (each
+ * carrying `type: 'ITEMS'`) or a single such shortcut. JSON form defs are
+ * either strings or plain objects with `kind`/`type` at the top level.
+ */
+export declare function isDxDefinitions(input: unknown): input is DxDefinitions;
+export declare function resolveFormInput<FormData extends Record<string, any> = any>(formDef: FormInput | undefined, formSelectors?: GslSelectorsInput, formConfig?: DxFormConfig): ResolvedFormInput<FormData>;

package/lib/dx/shortcuts/accordion/accordion.domain.d.ts

@@ -0,0 +1,20 @@
+import { DxCommonFields, DxLayoutBase } from '../../core/dxBase.types';
+import { DefOrCallback, GslConfigBase, GuiShortcutOf } from '../../core/dxUtilityTypes';
+import { ValidGuiShortcut } from '../../core/dx.domain';
+export interface AccordionDecorator extends DxLayoutBase, DxCommonFields {
+    sections: {
+        label: string;
+        uid: string;
+    }[];
+    singleOpen?: boolean;
+    defaultOpen?: {
+        [key: string]: boolean;
+    };
+    renderMode?: 'all' | 'activeOnly';
+}
+export type GslAccordionConfig = GslConfigBase<AccordionDecorator>;
+export type AccordionEntry = {
+    def: DefOrCallback<AccordionDecorator>;
+    children: ValidGuiShortcut[];
+};
+export type GuiAccordionShortcut = GuiShortcutOf<'ACCORDION', AccordionEntry>;

package/lib/dx/shortcuts/accordion/guiAccordion.impl.d.ts

@@ -0,0 +1,12 @@
+import { ValidGuiShortcut } from '../../core/dx.domain';
+import { AccordionDecorator, GuiAccordionShortcut } from './accordion.domain';
+type AccordionFactoryProps = Omit<AccordionDecorator, 'sections'>;
+export interface AccordionSection {
+    label: string;
+    children: ValidGuiShortcut[];
+    uid?: string;
+}
+export declare function _guiAccordion(sections: AccordionSection[]): GuiAccordionShortcut;
+export declare function _guiAccordion(sections: AccordionSection[], props: AccordionFactoryProps): GuiAccordionShortcut;
+export declare function _guiAccordion(sections: AccordionSection[], props: AccordionFactoryProps, tags: string[]): GuiAccordionShortcut;
+export {};

package/lib/dx/shortcuts/accordion/register.d.ts

@@ -0,0 +1,2 @@
+import { AccordionDecorator, GslAccordionConfig } from './accordion.domain';
+export declare const _gslAccordions: (config: GslAccordionConfig, matcher?: ((decorator: AccordionDecorator) => boolean) | undefined) => import('../../core/dx.domain').GslLeafSelector, _gslAccordionByUid: (uid: string, config: GslAccordionConfig) => import('../../core/dx.domain').GslLeafSelector;

package/lib/dx/shortcuts/actions/actions.domain.d.ts

@@ -0,0 +1,21 @@
+import { ButtonProps } from '../../../widget.props';
+import { DxActionBase, DxCommonFields, DxInternalFields } from '../../core/dxBase.types';
+import { DxRuntimeParams, DefOrCallback, GslConfigBase, GuiShortcutOf } from '../../core/dxUtilityTypes';
+export interface ActionDecorator extends DxActionBase, DxCommonFields, Partial<ButtonProps> {
+    data?: any | null;
+    type?: 'button';
+    on?: {
+        click: string;
+    };
+    onClick?: ((data: any) => void) | string;
+}
+/**
+ * Full decorator type including pipeline-internal fields.
+ */
+export type ActionDecoratorFull = ActionDecorator & DxInternalFields;
+export type ActionDefCallback = (params: DxRuntimeParams) => Partial<ActionDecorator>;
+export type ActionDefOrCallback = DefOrCallback<ActionDecorator>;
+export type ActionSensibleDefaultsConfig = Record<string, never>;
+export type GslActionsConfig = GslConfigBase<ActionDecorator>;
+export type ActionEntry = ActionDefOrCallback;
+export type GuiActionsShortcut = GuiShortcutOf<'ACTIONS', ActionEntry>;

package/lib/dx/shortcuts/actions/guiActions.impl.d.ts

@@ -0,0 +1,7 @@
+import { DxRuntimeParams } from '../../core/dxUtilityTypes';
+import { ActionDecorator, ActionDefOrCallback, GuiActionsShortcut } from './actions.domain';
+export declare function _guiButton(props: ActionDecorator): GuiActionsShortcut;
+export declare function _guiButton(props: ActionDecorator, tags: string[]): GuiActionsShortcut;
+export declare function _guiButton(callback: (params: DxRuntimeParams) => Partial<ActionDecorator>): GuiActionsShortcut;
+export declare function _guiButton(callback: (params: DxRuntimeParams) => Partial<ActionDecorator>, tags: string[]): GuiActionsShortcut;
+export declare const _guiSubmitButton: (defs?: ActionDecorator | ActionDefOrCallback) => GuiActionsShortcut;

package/lib/dx/shortcuts/actions/register.d.ts

@@ -0,0 +1,2 @@
+import { ActionDecorator, GslActionsConfig } from './actions.domain';
+export declare const _gslActions: (config: GslActionsConfig, matcher?: ((decorator: ActionDecorator) => boolean) | undefined) => import('../../core/dx.domain').GslLeafSelector, _gslActionByUid: (uid: string, config: GslActionsConfig) => import('../../core/dx.domain').GslLeafSelector;

package/lib/dx/shortcuts/alert/alert.domain.d.ts

@@ -0,0 +1,9 @@
+import { AlertProps } from '../../../widget.props';
+import { DxCommonFields } from '../../core/dxBase.types';
+import { DefOrCallback, GslConfigBase, GuiShortcutOf } from '../../core/dxUtilityTypes';
+export interface AlertDecorator extends DxCommonFields, Partial<AlertProps> {
+    text: string;
+}
+export type GslAlertsConfig = GslConfigBase<AlertDecorator>;
+export type AlertEntry = DefOrCallback<AlertDecorator>;
+export type GuiAlertShortcut = GuiShortcutOf<'ALERTS', AlertEntry>;

package/lib/dx/shortcuts/alert/guiAlert.impl.d.ts

@@ -0,0 +1,6 @@
+import { DxRuntimeParams } from '../../core/dxUtilityTypes';
+import { AlertDecorator, GuiAlertShortcut } from './alert.domain';
+type AlertFactoryProps = AlertDecorator;
+export declare function _guiAlert(props: AlertFactoryProps, tags?: string[]): GuiAlertShortcut;
+export declare function _guiAlert(callback: (params: DxRuntimeParams) => AlertFactoryProps, tags?: string[]): GuiAlertShortcut;
+export {};

package/lib/dx/shortcuts/alert/register.d.ts

@@ -0,0 +1,2 @@
+import { AlertDecorator, GslAlertsConfig } from './alert.domain';
+export declare const _gslAlerts: (config: GslAlertsConfig, matcher?: ((decorator: AlertDecorator) => boolean) | undefined) => import('../../core/dx.domain').GslLeafSelector, _gslAlertByUid: (uid: string, config: GslAlertsConfig) => import('../../core/dx.domain').GslLeafSelector;

package/lib/dx/shortcuts/calendar/calendar.domain.d.ts

@@ -0,0 +1,21 @@
+import { StringValidator } from '@golemui/gui-validators';
+import { CalendarProps } from '../../../widget.props';
+import { DxCommonFields, DxInputBase, DxInternalFields } from '../../core/dxBase.types';
+import { DefOrCallback, GslConfigBase, GuiShortcutOf } from '../../core/dxUtilityTypes';
+export interface CalendarDecorator extends DxInputBase, DxCommonFields, Partial<CalendarProps> {
+    type: 'calendar';
+    validator?: Omit<StringValidator, 'type'>;
+}
+/**
+ * Full decorator type including pipeline-internal fields.
+ * Used by the pipeline only — form authors use CalendarDecorator.
+ */
+export type CalendarDecoratorFull = CalendarDecorator & DxInternalFields;
+export interface CalendarSensibleDefaultsConfig {
+    suppressAutomaticLabels?: boolean;
+}
+export interface GslCalendarConfig extends GslConfigBase<CalendarDecorator> {
+    suppressAutomaticLabels?: boolean;
+}
+export type CalendarEntry = DefOrCallback<CalendarDecorator>;
+export type GuiCalendarShortcut = GuiShortcutOf<'CALENDAR', CalendarEntry>;

package/lib/dx/shortcuts/calendar/calendarSensibleDefaults.service.d.ts

@@ -0,0 +1,6 @@
+import { CalendarDecorator, CalendarSensibleDefaultsConfig } from './calendar.domain';
+export declare class CalendarSensibleDefaultsService {
+    processAutomaticLabels(item: CalendarDecorator, currentConfig: CalendarSensibleDefaultsConfig): CalendarDecorator;
+}
+declare const calendarSensibleDefaultsService: CalendarSensibleDefaultsService;
+export default calendarSensibleDefaultsService;

package/lib/dx/shortcuts/calendar/guiCalendar.impl.d.ts

@@ -0,0 +1,6 @@
+import { DxRuntimeParams } from '../../core/dxUtilityTypes';
+import { GuiCalendarShortcut, CalendarDecorator } from './calendar.domain';
+export declare function _guiCalendar(path: string): GuiCalendarShortcut;
+export declare function _guiCalendar(path: string, props: Partial<Omit<CalendarDecorator, 'type'>>): GuiCalendarShortcut;
+export declare function _guiCalendar(path: string, props: Partial<Omit<CalendarDecorator, 'type'>>, tags: string[]): GuiCalendarShortcut;
+export declare function _guiCalendar(path: string, callback: (params: DxRuntimeParams) => Partial<Omit<CalendarDecorator, 'type'>>, tags?: string[]): GuiCalendarShortcut;

package/lib/dx/shortcuts/calendar/register.d.ts

@@ -0,0 +1,2 @@
+import { CalendarDecorator, GslCalendarConfig } from './calendar.domain';
+export declare const _gslCalendars: (config: GslCalendarConfig, matcher?: ((decorator: CalendarDecorator) => boolean) | undefined) => import('../../core/dx.domain').GslLeafSelector, _gslCalendarByUid: (uid: string, config: GslCalendarConfig) => import('../../core/dx.domain').GslLeafSelector;

package/lib/dx/shortcuts/checkbox/checkbox.domain.d.ts

@@ -0,0 +1,16 @@
+import { BooleanValidator } from '@golemui/gui-validators';
+import { CheckboxProps } from '../../../widget.props';
+import { DxCommonFields, DxInputBase } from '../../core/dxBase.types';
+import { DefOrCallback, GslConfigBase, GuiShortcutOf } from '../../core/dxUtilityTypes';
+export interface CheckboxDecorator extends DxInputBase, DxCommonFields, Partial<CheckboxProps> {
+    type: 'checkbox';
+    validator?: Omit<BooleanValidator, 'type'>;
+}
+export interface GslCheckboxConfig extends GslConfigBase<CheckboxDecorator> {
+    suppressAutomaticLabels?: boolean;
+}
+export type CheckboxEntry = {
+    key: string;
+    def: DefOrCallback<CheckboxDecorator>;
+};
+export type GuiCheckboxShortcut = GuiShortcutOf<'CHECKBOX', CheckboxEntry>;

package/lib/dx/shortcuts/checkbox/guiCheckbox.impl.d.ts

@@ -0,0 +1,6 @@
+import { DxRuntimeParams } from '../../core/dxUtilityTypes';
+import { CheckboxDecorator, GuiCheckboxShortcut } from './checkbox.domain';
+export declare function _guiCheckbox(path: string): GuiCheckboxShortcut;
+export declare function _guiCheckbox(path: string, props: Partial<Omit<CheckboxDecorator, 'type'>>): GuiCheckboxShortcut;
+export declare function _guiCheckbox(path: string, props: Partial<Omit<CheckboxDecorator, 'type'>>, tags: string[]): GuiCheckboxShortcut;
+export declare function _guiCheckbox(path: string, callback: (params: DxRuntimeParams) => Partial<Omit<CheckboxDecorator, 'type'>>, tags?: string[]): GuiCheckboxShortcut;

package/lib/dx/shortcuts/checkbox/register.d.ts

@@ -0,0 +1,2 @@
+import { CheckboxDecorator, GslCheckboxConfig } from './checkbox.domain';
+export declare const _gslCheckboxes: (config: GslCheckboxConfig, matcher?: ((decorator: CheckboxDecorator) => boolean) | undefined) => import('../../core/dx.domain').GslLeafSelector, _gslCheckboxByUid: (uid: string, config: GslCheckboxConfig) => import('../../core/dx.domain').GslLeafSelector;

package/lib/dx/shortcuts/currency/currency.domain.d.ts

@@ -0,0 +1,17 @@
+import { NumberValidator } from '@golemui/gui-validators';
+import { CurrencyProps } from '../../../widget.props';
+import { DxCommonFields, DxInputBase } from '../../core/dxBase.types';
+import { DefOrCallback, GslConfigBase, GuiShortcutOf } from '../../core/dxUtilityTypes';
+export interface CurrencyDecorator extends DxInputBase, DxCommonFields, Partial<CurrencyProps> {
+    type: 'currency';
+    validator?: Omit<NumberValidator, 'type'>;
+}
+export interface GslCurrencyConfig extends GslConfigBase<CurrencyDecorator> {
+    suppressAutomaticLabels?: boolean;
+    suppressAutomaticPlaceholders?: boolean;
+}
+export type CurrencyEntry = {
+    key: string;
+    def: DefOrCallback<CurrencyDecorator>;
+};
+export type GuiCurrencyShortcut = GuiShortcutOf<'CURRENCY', CurrencyEntry>;

package/lib/dx/shortcuts/currency/guiCurrency.impl.d.ts

@@ -0,0 +1,6 @@
+import { DxRuntimeParams } from '../../core/dxUtilityTypes';
+import { CurrencyDecorator, GuiCurrencyShortcut } from './currency.domain';
+export declare function _guiCurrency(path: string): GuiCurrencyShortcut;
+export declare function _guiCurrency(path: string, props: Partial<Omit<CurrencyDecorator, 'type'>>): GuiCurrencyShortcut;
+export declare function _guiCurrency(path: string, props: Partial<Omit<CurrencyDecorator, 'type'>>, tags: string[]): GuiCurrencyShortcut;
+export declare function _guiCurrency(path: string, callback: (params: DxRuntimeParams) => Partial<Omit<CurrencyDecorator, 'type'>>, tags?: string[]): GuiCurrencyShortcut;

package/lib/dx/shortcuts/currency/register.d.ts

@@ -0,0 +1,2 @@
+import { CurrencyDecorator, GslCurrencyConfig } from './currency.domain';
+export declare const _gslCurrencies: (config: GslCurrencyConfig, matcher?: ((decorator: CurrencyDecorator) => boolean) | undefined) => import('../../core/dx.domain').GslLeafSelector, _gslCurrencyByUid: (uid: string, config: GslCurrencyConfig) => import('../../core/dx.domain').GslLeafSelector;