@golemui/gui-shared 0.0.2 → 0.12.1

package/lib/dx/shortcuts/range-date-picker/guiRangeDatePicker.impl.d.ts

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

package/lib/dx/shortcuts/range-date-picker/rangeDatePicker.domain.d.ts

@@ -0,0 +1,17 @@
+import { ArrayValidator } from '@golemui/gui-validators';
+import { RangeDatePickerProps } from '../../../widget.props';
+import { DxCommonFields, DxInputBase } from '../../core/dxBase.types';
+import { DefOrCallback, GslConfigBase, GuiShortcutOf } from '../../core/dxUtilityTypes';
+export interface RangeDatePickerDecorator extends DxInputBase, DxCommonFields, Partial<RangeDatePickerProps> {
+    type: 'rangeDatePicker';
+    validator?: Omit<ArrayValidator, 'type'>;
+}
+export interface GslRangeDatePickerConfig extends GslConfigBase<RangeDatePickerDecorator> {
+    suppressAutomaticLabels?: boolean;
+    suppressAutomaticPlaceholders?: boolean;
+}
+export type RangeDatePickerEntry = {
+    key: string;
+    def: DefOrCallback<RangeDatePickerDecorator>;
+};
+export type GuiRangeDatePickerShortcut = GuiShortcutOf<'RANGE_DATE_PICKER', RangeDatePickerEntry>;

package/lib/dx/shortcuts/range-date-picker/register.d.ts

@@ -0,0 +1,2 @@
+import { GslRangeDatePickerConfig, RangeDatePickerDecorator } from './rangeDatePicker.domain';
+export declare const _gslRangeDatePickers: (config: GslRangeDatePickerConfig, matcher?: ((decorator: RangeDatePickerDecorator) => boolean) | undefined) => import('../../core/dx.domain').GslLeafSelector, _gslRangeDatePickerByUid: (uid: string, config: GslRangeDatePickerConfig) => import('../../core/dx.domain').GslLeafSelector;

package/lib/dx/shortcuts/repeater/guiRepeater.impl.d.ts

@@ -0,0 +1,6 @@
+import { ValidGuiShortcut } from '../../core/dx.domain';
+import { RepeaterDecorator, GuiRepeaterShortcut } from './repeater.domain';
+export interface RepeaterProps extends Omit<Partial<RepeaterDecorator>, 'template'> {
+    template: ValidGuiShortcut[];
+}
+export declare function _guiRepeater(path: string, props: RepeaterProps, tags?: string[]): GuiRepeaterShortcut;

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

@@ -0,0 +1,3 @@
+import { RepeaterDecorator, GslRepeaterConfig } from './repeater.domain';
+export declare const _gslRepeaters: (config: GslRepeaterConfig, matcher?: (decorator: RepeaterDecorator) => boolean) => import('../../core/dx.domain').GslLeafSelector;
+export declare const _gslRepeaterByUid: (id: string, config: GslRepeaterConfig) => import('../../core/dx.domain').GslLeafSelector;

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

@@ -0,0 +1,21 @@
+import { ArrayValidator } from '@golemui/gui-validators';
+import { DxCommonFields } from '../../core/dxBase.types';
+import { DefOrCallback, GslConfigBase, GuiShortcutOf } from '../../core/dxUtilityTypes';
+import { ValidGuiShortcut } from '../../core/dx.domain';
+export interface RepeaterDecorator extends DxCommonFields {
+    label?: string;
+    addLabel?: string;
+    removeLabel?: string;
+    limit?: number;
+    title?: string;
+    addButtonIcon?: string;
+    removeButtonIcon?: string;
+    validator?: Omit<ArrayValidator, 'type'>;
+}
+export type GslRepeaterConfig = GslConfigBase<RepeaterDecorator>;
+export type RepeaterEntry = {
+    key: string;
+    def: DefOrCallback<RepeaterDecorator>;
+    children: ValidGuiShortcut[];
+};
+export type GuiRepeaterShortcut = GuiShortcutOf<'REPEATER', RepeaterEntry>;

package/lib/dx/shortcuts/scopes/gslStates.impl.d.ts

@@ -0,0 +1,11 @@
+import { GslLeafSelector } from '../../core/dx.domain';
+/**
+ * Internal underscore-era state-targeting primitive. Pending focus-closeout
+ * removal — the spec entrance is `gui.selectors.state(name).<typeSelector>(config)`.
+ *
+ * Wraps leaf selectors and marks them as targeting a specific state name.
+ * When resolved, matching configs are applied as state-suffixed overrides
+ * rather than base property overrides. Returns an array of leaves; spread
+ * into the `formSelectors` array since `_gslRoot` is gone.
+ */
+export declare function _gslStates(stateName: string, ...children: GslLeafSelector[]): GslLeafSelector[];

package/lib/dx/shortcuts/scopes/gslTag.impl.d.ts

@@ -0,0 +1,2 @@
+import { GslAggregatedSelector, GslLeafSelector } from '../../core/dx.domain';
+export declare function _gslTag(tag: string, ...children: GslLeafSelector[]): GslAggregatedSelector;

package/lib/dx/shortcuts/scopes/scopeChain.d.ts

@@ -0,0 +1,99 @@
+import { GslLeafSelector } from '../../core/dx.domain';
+import { _gslInputs, _gslInputByUid } from '../inputs/register';
+import { _gslTextInputs, _gslNumberInputs, _gslBooleanInputs } from '../inputs/gslInputSubtypes';
+import { _gslSelects, _gslSelectByUid } from '../select/register';
+import { _gslDropdowns, _gslDropdownByUid } from '../dropdown/register';
+import { _gslRadiogroups, _gslRadiogroupByUid } from '../radiogroup/register';
+import { _gslCheckboxes, _gslCheckboxByUid } from '../checkbox/register';
+import { _gslTextareas, _gslTextareaByUid } from '../textarea/register';
+import { _gslPasswords, _gslPasswordByUid } from '../password/register';
+import { _gslCurrencies, _gslCurrencyByUid } from '../currency/register';
+import { _gslMarkdowns, _gslMarkdownByUid } from '../markdown/register';
+import { _gslLists, _gslListByUid } from '../list/register';
+import { _gslCalendars, _gslCalendarByUid } from '../calendar/register';
+import { _gslDateInputs, _gslDateInputByUid } from '../date-input/register';
+import { _gslDatePickers, _gslDatePickerByUid } from '../date-picker/register';
+import { _gslRangeCalendars, _gslRangeCalendarByUid } from '../range-calendar/register';
+import { _gslRangeDateInputs, _gslRangeDateInputByUid } from '../range-date-input/register';
+import { _gslRangeDatePickers, _gslRangeDatePickerByUid } from '../range-date-picker/register';
+import { _gslRepeaters, _gslRepeaterByUid } from '../repeater/register';
+import { _gslActions, _gslActionByUid } from '../actions/register';
+import { _gslLayouts, _gslLayoutByUid } from '../layouts/register';
+import { _gslDisplays, _gslDisplayByUid } from '../display/register';
+import { _gslAlerts, _gslAlertByUid } from '../alert/register';
+import { _gslTabs, _gslTabsByUid } from '../tabs/register';
+import { _gslAccordions, _gslAccordionByUid } from '../accordion/register';
+import { _gslCustomInputs, _gslCustomInputByUid } from '../custom-input/register';
+import { _gslCustomActions, _gslCustomActionByUid } from '../custom-action/register';
+import { _gslCustomDisplays, _gslCustomDisplayByUid } from '../custom-display/register';
+import { _gslCustomLayouts, _gslCustomLayoutByUid } from '../custom-layout/register';
+type CfgGsl<F> = F extends (config: infer C, matcher?: any) => GslLeafSelector ? C : never;
+type CfgByUid<F> = F extends (uid: string, config: infer C) => GslLeafSelector ? C : never;
+export declare class ScopeChain {
+    private readonly conditions;
+    private constructor();
+    static root(): ScopeChain;
+    tag(name: string): ScopeChain;
+    state(name: string): ScopeChain;
+    tagsAnd(names: string[]): ScopeChain;
+    tagsOr(names: string[]): ScopeChain;
+    private apply;
+    inputs(config: CfgGsl<typeof _gslInputs>): GslLeafSelector;
+    inputByUid(uid: string, config: CfgByUid<typeof _gslInputByUid>): GslLeafSelector;
+    textInputs(config: Parameters<typeof _gslTextInputs>[0]): GslLeafSelector;
+    numberInputs(config: Parameters<typeof _gslNumberInputs>[0]): GslLeafSelector;
+    booleanInputs(config: Parameters<typeof _gslBooleanInputs>[0]): GslLeafSelector;
+    selects(config: CfgGsl<typeof _gslSelects>): GslLeafSelector;
+    selectByUid(uid: string, config: CfgByUid<typeof _gslSelectByUid>): GslLeafSelector;
+    dropdowns(config: CfgGsl<typeof _gslDropdowns>): GslLeafSelector;
+    dropdownByUid(uid: string, config: CfgByUid<typeof _gslDropdownByUid>): GslLeafSelector;
+    radiogroups(config: CfgGsl<typeof _gslRadiogroups>): GslLeafSelector;
+    radiogroupByUid(uid: string, config: CfgByUid<typeof _gslRadiogroupByUid>): GslLeafSelector;
+    checkboxes(config: CfgGsl<typeof _gslCheckboxes>): GslLeafSelector;
+    checkboxByUid(uid: string, config: CfgByUid<typeof _gslCheckboxByUid>): GslLeafSelector;
+    textareas(config: CfgGsl<typeof _gslTextareas>): GslLeafSelector;
+    textareaByUid(uid: string, config: CfgByUid<typeof _gslTextareaByUid>): GslLeafSelector;
+    passwords(config: CfgGsl<typeof _gslPasswords>): GslLeafSelector;
+    passwordByUid(uid: string, config: CfgByUid<typeof _gslPasswordByUid>): GslLeafSelector;
+    currencies(config: CfgGsl<typeof _gslCurrencies>): GslLeafSelector;
+    currencyByUid(uid: string, config: CfgByUid<typeof _gslCurrencyByUid>): GslLeafSelector;
+    markdowns(config: CfgGsl<typeof _gslMarkdowns>): GslLeafSelector;
+    markdownByUid(uid: string, config: CfgByUid<typeof _gslMarkdownByUid>): GslLeafSelector;
+    lists(config: CfgGsl<typeof _gslLists>): GslLeafSelector;
+    listByUid(uid: string, config: CfgByUid<typeof _gslListByUid>): GslLeafSelector;
+    calendars(config: CfgGsl<typeof _gslCalendars>): GslLeafSelector;
+    calendarByUid(uid: string, config: CfgByUid<typeof _gslCalendarByUid>): GslLeafSelector;
+    dateInputs(config: CfgGsl<typeof _gslDateInputs>): GslLeafSelector;
+    dateInputByUid(uid: string, config: CfgByUid<typeof _gslDateInputByUid>): GslLeafSelector;
+    datePickers(config: CfgGsl<typeof _gslDatePickers>): GslLeafSelector;
+    datePickerByUid(uid: string, config: CfgByUid<typeof _gslDatePickerByUid>): GslLeafSelector;
+    rangeCalendars(config: CfgGsl<typeof _gslRangeCalendars>): GslLeafSelector;
+    rangeCalendarByUid(uid: string, config: CfgByUid<typeof _gslRangeCalendarByUid>): GslLeafSelector;
+    rangeDateInputs(config: CfgGsl<typeof _gslRangeDateInputs>): GslLeafSelector;
+    rangeDateInputByUid(uid: string, config: CfgByUid<typeof _gslRangeDateInputByUid>): GslLeafSelector;
+    rangeDatePickers(config: CfgGsl<typeof _gslRangeDatePickers>): GslLeafSelector;
+    rangeDatePickerByUid(uid: string, config: CfgByUid<typeof _gslRangeDatePickerByUid>): GslLeafSelector;
+    repeaters(config: CfgGsl<typeof _gslRepeaters>): GslLeafSelector;
+    repeaterByUid(uid: string, config: CfgByUid<typeof _gslRepeaterByUid>): GslLeafSelector;
+    actions(config: CfgGsl<typeof _gslActions>): GslLeafSelector;
+    actionByUid(uid: string, config: CfgByUid<typeof _gslActionByUid>): GslLeafSelector;
+    layouts(config: CfgGsl<typeof _gslLayouts>): GslLeafSelector;
+    layoutByUid(uid: string, config: CfgByUid<typeof _gslLayoutByUid>): GslLeafSelector;
+    displays(config: CfgGsl<typeof _gslDisplays>): GslLeafSelector;
+    displayByUid(uid: string, config: CfgByUid<typeof _gslDisplayByUid>): GslLeafSelector;
+    alerts(config: CfgGsl<typeof _gslAlerts>): GslLeafSelector;
+    alertByUid(uid: string, config: CfgByUid<typeof _gslAlertByUid>): GslLeafSelector;
+    tabs(config: CfgGsl<typeof _gslTabs>): GslLeafSelector;
+    tabsByUid(uid: string, config: CfgByUid<typeof _gslTabsByUid>): GslLeafSelector;
+    accordions(config: CfgGsl<typeof _gslAccordions>): GslLeafSelector;
+    accordionByUid(uid: string, config: CfgByUid<typeof _gslAccordionByUid>): GslLeafSelector;
+    customInputs(config: CfgGsl<typeof _gslCustomInputs>): GslLeafSelector;
+    customInputByUid(uid: string, config: CfgByUid<typeof _gslCustomInputByUid>): GslLeafSelector;
+    customActions(config: CfgGsl<typeof _gslCustomActions>): GslLeafSelector;
+    customActionByUid(uid: string, config: CfgByUid<typeof _gslCustomActionByUid>): GslLeafSelector;
+    customDisplays(config: CfgGsl<typeof _gslCustomDisplays>): GslLeafSelector;
+    customDisplayByUid(uid: string, config: CfgByUid<typeof _gslCustomDisplayByUid>): GslLeafSelector;
+    customLayouts(config: CfgGsl<typeof _gslCustomLayouts>): GslLeafSelector;
+    customLayoutByUid(uid: string, config: CfgByUid<typeof _gslCustomLayoutByUid>): GslLeafSelector;
+}
+export {};

package/lib/dx/shortcuts/select/guiSelect.impl.d.ts

@@ -0,0 +1,7 @@
+import { DxRuntimeParams } from '../../core/dxUtilityTypes';
+import { GuiSelectShortcut, SelectDecorator } from './select.domain';
+type SelectFactoryProps = Omit<SelectDecorator, 'type'>;
+export declare function _guiSelect(path: string, props: SelectFactoryProps): GuiSelectShortcut;
+export declare function _guiSelect(path: string, props: SelectFactoryProps, tags: string[]): GuiSelectShortcut;
+export declare function _guiSelect(path: string, callback: (params: DxRuntimeParams) => SelectFactoryProps, tags?: string[]): GuiSelectShortcut;
+export {};

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

@@ -0,0 +1,2 @@
+import { GslSelectConfig, SelectDecorator } from './select.domain';
+export declare const _gslSelects: (config: GslSelectConfig, matcher?: ((decorator: SelectDecorator) => boolean) | undefined) => import('../../core/dx.domain').GslLeafSelector, _gslSelectByUid: (uid: string, config: GslSelectConfig) => import('../../core/dx.domain').GslLeafSelector;

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

@@ -0,0 +1,18 @@
+import { Validator } from '@golemui/gui-validators';
+import { Option, OptionValue, SelectProps } from '../../../widget.props';
+import { DxCommonFields, DxInputBase } from '../../core/dxBase.types';
+import { DefOrCallback, GslConfigBase, GuiShortcutOf } from '../../core/dxUtilityTypes';
+export interface SelectDecorator extends DxInputBase, DxCommonFields, Partial<Omit<SelectProps, 'options'>> {
+    type: 'select';
+    options?: Option[] | OptionValue[] | Record<string, unknown>[];
+    validator?: Validator;
+}
+export interface GslSelectConfig extends GslConfigBase<SelectDecorator> {
+    suppressAutomaticLabels?: boolean;
+    suppressAutomaticPlaceholders?: boolean;
+}
+export type SelectEntry = {
+    key: string;
+    def: DefOrCallback<SelectDecorator>;
+};
+export type GuiSelectShortcut = GuiShortcutOf<'SELECT', SelectEntry>;

package/lib/dx/shortcuts/tabs/guiTabs.impl.d.ts

@@ -0,0 +1,12 @@
+import { ValidGuiShortcut } from '../../core/dx.domain';
+import { GuiTabsShortcut, TabsDecorator } from './tabs.domain';
+type TabsFactoryProps = Omit<TabsDecorator, 'tabs'>;
+export interface TabSection {
+    label: string;
+    children: ValidGuiShortcut[];
+    uid?: string;
+}
+export declare function _guiTabs(sections: TabSection[]): GuiTabsShortcut;
+export declare function _guiTabs(sections: TabSection[], props: TabsFactoryProps): GuiTabsShortcut;
+export declare function _guiTabs(sections: TabSection[], props: TabsFactoryProps, tags: string[]): GuiTabsShortcut;
+export {};

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

@@ -0,0 +1,2 @@
+import { GslTabsConfig, TabsDecorator } from './tabs.domain';
+export declare const _gslTabs: (config: GslTabsConfig, matcher?: ((decorator: TabsDecorator) => boolean) | undefined) => import('../../core/dx.domain').GslLeafSelector, _gslTabsByUid: (uid: string, config: GslTabsConfig) => import('../../core/dx.domain').GslLeafSelector;

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

@@ -0,0 +1,17 @@
+import { DxCommonFields, DxLayoutBase } from '../../core/dxBase.types';
+import { DefOrCallback, GslConfigBase, GuiShortcutOf } from '../../core/dxUtilityTypes';
+import { ValidGuiShortcut } from '../../core/dx.domain';
+export interface TabsDecorator extends DxLayoutBase, DxCommonFields {
+    tabs: {
+        label: string;
+        uid: string;
+    }[];
+    renderMode?: 'all' | 'activeOnly';
+    defaultOpen?: string;
+}
+export type GslTabsConfig = GslConfigBase<TabsDecorator>;
+export type TabsEntry = {
+    def: DefOrCallback<TabsDecorator>;
+    children: ValidGuiShortcut[];
+};
+export type GuiTabsShortcut = GuiShortcutOf<'TABS', TabsEntry>;

package/lib/dx/shortcuts/textarea/guiTextarea.impl.d.ts

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

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

@@ -0,0 +1,2 @@
+import { GslTextareaConfig, TextareaDecorator } from './textarea.domain';
+export declare const _gslTextareas: (config: GslTextareaConfig, matcher?: ((decorator: TextareaDecorator) => boolean) | undefined) => import('../../core/dx.domain').GslLeafSelector, _gslTextareaByUid: (uid: string, config: GslTextareaConfig) => import('../../core/dx.domain').GslLeafSelector;

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

@@ -0,0 +1,17 @@
+import { StringValidator } from '@golemui/gui-validators';
+import { TextareaProps } from '../../../widget.props';
+import { DxCommonFields, DxInputBase } from '../../core/dxBase.types';
+import { DefOrCallback, GslConfigBase, GuiShortcutOf } from '../../core/dxUtilityTypes';
+export interface TextareaDecorator extends DxInputBase, DxCommonFields, Partial<TextareaProps> {
+    type: 'textarea';
+    validator?: Omit<StringValidator, 'type'>;
+}
+export interface GslTextareaConfig extends GslConfigBase<TextareaDecorator> {
+    suppressAutomaticLabels?: boolean;
+    suppressAutomaticPlaceholders?: boolean;
+}
+export type TextareaEntry = {
+    key: string;
+    def: DefOrCallback<TextareaDecorator>;
+};
+export type GuiTextareaShortcut = GuiShortcutOf<'TEXTAREA', TextareaEntry>;

package/lib/golem-form.d.ts

@@ -71,7 +71,7 @@ declare class GolemFormBuilder<FormType extends Record<string, any>, CustomWidge
  *     {
  *       kind: 'layout',
  *       type: 'flex',
- *       props: { direction: 'horizontal' },
+ *       props: { direction: 'row' },
  *       children: [
  *         {
  *           kind: 'input',
@@ -92,14 +92,14 @@ declare class GolemFormBuilder<FormType extends Record<string, any>, CustomWidge
  * ```
  */
 export declare function golemForm<FormType extends Record<string, any>, CustomWidget extends Core.FormWidget<any, FormType> = never>(): GolemFormBuilder<FormType, CustomWidget>;
-type GolemWidget<FormType extends Record<string, any>, States extends string, V, CustomWidget extends Core.FormWidget<any, FormType> = never> = GuiAccordion<FormType, States, V, CustomWidget> | GuiAlert<FormType, States> | GuiButton<FormType, States> | GuiCalendar<FormType, States, V> | GuiCheckbox<FormType, States, V> | GuiCurrency<FormType, States, V> | GuiDateinput<FormType, States, V> | GuiDatePicker<FormType, States, V> | GuiDropdown<FormType, States, V> | GuiFunctionWidget<FormType, States, V, CustomWidget> | GuiList<FormType, States, V> | GuiNumberinput<FormType, States, V> | GuiPassword<FormType, States, V> | GuiRadiogroup<FormType, States, V> | GuiRangeCalendar<FormType, States, V> | GuiRepeater<FormType, States, V, CustomWidget> | GuiSelect<FormType, States, V> | GuiFlex<FormType, States, V, CustomWidget> | GuiTabs<FormType, States, V, CustomWidget> | GuiTextarea<FormType, States, V> | GuiTextInput<FormType, States, V> | GuiToggle<FormType, States, V> | CustomWidget;
+type GolemWidget<FormType extends Record<string, any>, States extends string, V, CustomWidget extends Core.FormWidget<any, FormType> = never> = GuiAccordion<FormType, States, V, CustomWidget> | GuiAlert<FormType, States> | GuiButton<FormType, States> | GuiCalendar<FormType, States, V> | GuiCheckbox<FormType, States, V> | GuiCurrency<FormType, States, V> | GuiDateinput<FormType, States, V> | GuiDatePicker<FormType, States, V> | GuiDropdown<FormType, States, V> | GuiFunctionWidget<FormType, States, V, CustomWidget> | GuiList<FormType, States, V> | GuiMarkdown<FormType, States, V> | GuiMarkdownText<FormType, States> | GuiNumberinput<FormType, States, V> | GuiPassword<FormType, States, V> | GuiRadiogroup<FormType, States, V> | GuiRangeCalendar<FormType, States, V> | GuiRangeDateInput<FormType, States, V> | GuiRangeDatePicker<FormType, States, V> | GuiRepeater<FormType, States, V, CustomWidget> | GuiSelect<FormType, States, V> | GuiFlex<FormType, States, V, CustomWidget> | GuiGrid<FormType, States, V, CustomWidget> | GuiTabs<FormType, States, V, CustomWidget> | GuiTextarea<FormType, States, V> | GuiTextInput<FormType, States, V> | GuiToggle<FormType, States, V> | CustomWidget;
 type GuiAccordion<FormType extends Record<string, any>, States extends string, V, CustomWidget extends Core.FormWidget<any, FormType>> = Core.LayoutWidget<States, FormType, Props.AccordionProps, GolemWidget<FormType, States, V, CustomWidget>[]> & {
     type: 'accordion';
 };
 type GuiAlert<FormType extends Record<string, any>, States extends string> = Core.DisplayWidget<States, FormType, Props.AlertProps> & {
     type: 'alert';
 };
-type GuiButton<FormType extends Record<string, any>, States extends string> = Core.ActionWidget<States, FormType, never> & {
+type GuiButton<FormType extends Record<string, any>, States extends string> = Core.ActionWidget<States, FormType, Props.ButtonProps> & {
     type: 'button';
 };
 type GuiCalendar<FormType extends Record<string, any>, States extends string, V> = Core.InputWidget<string, States, FormType, Props.CalendarProps, V> & {
@@ -124,6 +124,12 @@ type GuiFunctionWidget<FormType extends Record<string, any>, States extends stri
 type GuiList<FormType extends Record<string, any>, States extends string, V> = Core.InputWidget<Props.OptionValue, States, FormType, Props.ListProps<unknown>, V> & {
     type: 'list';
 };
+type GuiMarkdown<FormType extends Record<string, any>, States extends string, V> = Core.InputWidget<number, States, FormType, Props.MarkdownProps, V> & {
+    type: 'markdown';
+};
+type GuiMarkdownText<FormType extends Record<string, any>, States extends string> = Core.DisplayWidget<States, FormType, Props.MarkdownTextProps> & {
+    type: 'markdownText';
+};
 type GuiNumberinput<FormType extends Record<string, any>, States extends string, V> = Core.InputWidget<number, States, FormType, Props.NumberinputProps, V> & {
     type: 'number';
 };
@@ -133,6 +139,12 @@ type GuiRadiogroup<FormType extends Record<string, any>, States extends string,
 type GuiRangeCalendar<FormType extends Record<string, any>, States extends string, V> = Core.InputWidget<string, States, FormType, Props.RangeCalendarProps, V> & {
     type: 'rangeCalendar';
 };
+type GuiRangeDateInput<FormType extends Record<string, any>, States extends string, V> = Core.InputWidget<Props.DateRange[], States, FormType, Props.RangeDateInputProps, V> & {
+    type: 'rangeDateInput';
+};
+type GuiRangeDatePicker<FormType extends Record<string, any>, States extends string, V> = Core.InputWidget<Props.DateRange[], States, FormType, Props.RangeDatePickerProps, V> & {
+    type: 'rangeDatePicker';
+};
 type GuiRepeater<FormType extends Record<string, any>, States extends string, V, CustomWidget extends Core.FormWidget<any, FormType>> = Core.InputWidget<Record<string, unknown>[], States, FormType, Props.RepeaterProps<Core.LayoutWidget<States, FormType, Props.AccordionProps, GolemWidget<FormType, States, V, CustomWidget>[]>>, V> & {
     type: 'repeater';
 };
@@ -142,6 +154,9 @@ type GuiSelect<FormType extends Record<string, any>, States extends string, V> =
 type GuiFlex<FormType extends Record<string, any>, States extends string, V, CustomWidget extends Core.FormWidget<any, FormType>> = Core.LayoutWidget<States, FormType, Props.FlexProps, GolemWidget<FormType, States, V, CustomWidget>[]> & {
     type: 'flex';
 };
+type GuiGrid<FormType extends Record<string, any>, States extends string, V, CustomWidget extends Core.FormWidget<any, FormType>> = Core.LayoutWidget<States, FormType, Props.GridProps, GolemWidget<FormType, States, V, CustomWidget>[]> & {
+    type: 'grid';
+};
 type GuiTabs<FormType extends Record<string, any>, States extends string, V, CustomWidget extends Core.FormWidget<any, FormType>> = Core.LayoutWidget<States, FormType, Props.TabsProps, GolemWidget<FormType, States, V, CustomWidget>[]> & {
     type: 'tabs';
 };

package/lib/shared.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Dependencies are any 3rd party service components may need internally.
+ * e.g. a markdown parser for the Markdown component
+ */
+export type Dependencies = {
+    /**
+     * The markdown parser used by the markdown component
+     * Popular options are Snarkdown, Micromark and Marked.
+     */
+    markdown?: {
+        parse: (markdown: string) => string;
+    };
+};

package/lib/utils/index.d.ts

@@ -1 +1,3 @@
 export * from './one-of';
+export * from './repeater';
+export * from './schema';

package/lib/utils/objectUtils.service.d.ts

@@ -0,0 +1,11 @@
+export declare class ObjectUtils {
+    /**
+     * Deep merges two objects, with right taking precedence over left when properties conflict.
+     * Arrays are replaced, not merged.
+     * @param left - The base object
+     * @param right - The object whose properties take precedence
+     * @returns A new merged object
+     */
+    deepMerge<T = any>(left: any, right?: any): T;
+}
+export declare const objectUtils: ObjectUtils;

package/lib/utils/repeater.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Returns a stable unique key for a repeater data item.
+ * Assigns a non-enumerable `__rid` property on first access so the ID
+ * survives array operations (splice, filter, spread) without polluting
+ * serialised output (JSON.stringify, Object.keys).
+ *
+ * @param idIncrementer function that increments the lexically-scoped id.
+ */
+export declare function getItemKey(item: Record<string, unknown>, idIncrementer: () => number): number;

package/lib/utils/schema.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Traverses a raw form JSON object and replaces every `{ "$ref": "path" }` widget
+ * with the content of the referenced `.form-chunk.json` file, fetched asynchronously.
+ *
+ * Refs are resolved relative to `baseUrl`, so nested chunks resolve their own refs
+ * relative to their own URL. The `$schema` key is stripped from loaded chunks as it
+ * is editor-only metadata not expected by the form decoder.
+ *
+ * @param formJson - The parsed form JSON (top-level `{ states?, form: [...] }` object).
+ * @param baseUrl - Base URL used to resolve relative `$ref` paths — typically the URL
+ *   of the form JSON file itself (e.g. `import.meta.resolve('./my-form.form.json')`).
+ * @returns A new object with all chunk refs inlined. The input is not mutated.
+ */
+export declare function resolveChunkRefs(formJson: Record<string, unknown>, baseUrl: string): Promise<Record<string, unknown>>;

package/lib/widget.factory.d.ts

@@ -4,9 +4,9 @@ type InputWidgetConfig<T> = Omit<Core.InputWidget<T>, 'kind' | 'type' | 'uid' |
 type LayoutWidgetConfig = Omit<Core.LayoutWidget, 'kind' | 'type' | 'uid' | 'props'>;
 type DisplayWidgetConfig = Omit<Core.BaseWidget, 'kind' | 'type' | 'uid' | 'props'>;
 /**
- * Vanilla widget factory
+ * Golem widget factory
  */
-export declare const Vanilla: {
+export declare const GolemWidgets: {
     textinput: <StateKeys extends Core.UiState = string, V = any>({ config, props, validator, }: {
         config: InputWidgetConfig<string>;
         props?: Props.TextinputProps;
@@ -33,7 +33,9 @@ export declare const Vanilla: {
         validator?: V;
     }) => Core.InputWidget<string, StateKeys>;
     flex: <StateKeys extends Core.UiState = string>(config: LayoutWidgetConfig, props?: Props.FlexProps) => Core.LayoutWidget<StateKeys>;
+    grid: <StateKeys extends Core.UiState = string>(config: LayoutWidgetConfig, props?: Props.GridProps) => Core.LayoutWidget<StateKeys>;
     tabs: <StateKeys extends Core.UiState = string>(config: LayoutWidgetConfig, props?: Props.TabsProps) => Core.LayoutWidget<StateKeys>;
     alert: <StateKeys extends Core.UiState = string>(config: DisplayWidgetConfig, props?: Props.AlertProps) => Core.DisplayWidget<StateKeys>;
+    markdownText: <StateKeys extends Core.UiState = string>(config: DisplayWidgetConfig, props?: Props.MarkdownTextProps) => Core.DisplayWidget<StateKeys>;
 };
 export {};