@golemui/gui-shared 0.0.2 → 0.12.1

package/index.umd.cjs

@@ -1 +1 @@
-(function(i,l){typeof exports=="object"&&typeof module<"u"?l(exports):typeof define=="function"&&define.amd?define(["exports"],l):(i=typeof globalThis<"u"?globalThis:i||self,l(i["gui-shared"]={}))})(this,(function(i){"use strict";class l{create(e){return{states:e.states,form:{uid:"gui-root-uid",type:"flex",kind:"layout",children:e.form}}}}function s(){return new l}const u=["calendar","checkbox","currency","dateInput","datePicker","dropdown","list","number","password","radiogroup","rangeCalendar","repeater","select","textarea","textinput","toggle"],o=["accordion","flex","tabs"],d=["alert","renderer"],c=["button"],f=[...u,...o,...d,...c],a={textinput:({config:t,props:e,validator:n})=>({uid:"",kind:"input",type:"textinput",...e&&{props:e},...n&&{validator:n},...t}),password:({config:t,props:e,validator:n})=>({uid:"",kind:"input",type:"password",...e&&{props:e},...n&&{validator:n},...t}),numberinput:({config:t,props:e,validator:n})=>({uid:"",kind:"input",type:"numberinput",...e&&{props:e},...n&&{validator:n},...t}),checkbox:({config:t,props:e,validator:n})=>({uid:"",kind:"input",type:"checkbox",...e&&{props:e},...n&&{validator:n},...t}),select:({config:t,props:e,validator:n})=>({uid:"",kind:"input",type:"select",...e&&{props:e},...n&&{validator:n},...t}),flex:(t,e)=>({uid:"",kind:"layout",type:"flex",...e&&{props:e},...t}),tabs:(t,e)=>({uid:"",kind:"layout",type:"tabs",...e&&{props:e},...t}),alert:(t,e)=>({uid:"",kind:"display",type:"alert",...e&&{props:e},...t})},r=t=>t!==null&&typeof t=="object"&&Object.prototype.hasOwnProperty.call(t,"label")&&Object.prototype.hasOwnProperty.call(t,"value");function m(t){return r(t)?t:{label:t,value:t}}const b=t=>({string:(e,n)=>a.textinput({config:{path:n}}),enum:(e,n)=>a.select({config:{path:n},props:{options:e.enum?.map(m)??[]},validator:t.stringValidator()}),boolean:(e,n)=>a.checkbox({config:{path:n},validator:t.booleanValidator()}),number:(e,n)=>a.numberinput({config:{path:n},validator:t.numberValidator()}),integer:(e,n)=>a.numberinput({config:{path:n},validator:t.integerValidator()}),object:(e,n)=>a.flex({children:n}),oneOf:(e,n)=>a.tabs({children:n}),anyOf:(e,n)=>a.tabs({children:n}),fallback:e=>a.alert({},{text:`❌ Unsupported Json Schema field ${JSON.stringify(e)}`,level:"error"})});i.Vanilla=a,i.actionWidgets=c,i.displayWidgets=d,i.golemForm=s,i.inputWidgets=u,i.isOption=r,i.layoutWidgets=o,i.vanillaSchemaToFieldMap=b,i.vanillaWidgets=f,Object.defineProperty(i,Symbol.toStringTag,{value:"Module"})}));
+(function(r,b){typeof exports=="object"&&typeof module<"u"?b(exports):typeof define=="function"&&define.amd?define(["exports"],b):(r=typeof globalThis<"u"?globalThis:r||self,b(r["gui-shared"]={}))})(this,(function(r){"use strict";const b={INPUTS:"INPUTS",ACTIONS:"ACTIONS",LAYOUTS:"LAYOUTS",DISPLAYS:"DISPLAYS"};function Y(e,t,n){if(typeof t=="function"){const i=t;return{items:[{key:e,def:a=>({type:"text",...i(a)})}],type:"ITEMS",itemType:b.INPUTS,tags:n??[]}}const s={type:"text",...t};return{items:[{key:e,def:s}],type:"ITEMS",itemType:b.INPUTS,tags:n??[]}}function z(e,t,n){if(typeof t=="function"){const i=t;return{items:[{key:e,def:a=>({type:"number",...i(a)})}],type:"ITEMS",itemType:b.INPUTS,tags:n??[]}}const s={type:"number",...t};return{items:[{key:e,def:s}],type:"ITEMS",itemType:b.INPUTS,tags:n??[]}}function G(e,t,n){if(typeof t=="function"){const i=t;return{items:[{key:e,def:a=>({type:"boolean",...i(a)})}],type:"ITEMS",itemType:b.INPUTS,tags:n??[]}}const s={type:"boolean",...t};return{items:[{key:e,def:s}],type:"ITEMS",itemType:b.INPUTS,tags:n??[]}}function K(e,t,n){if(typeof t=="function"){const l=t;return{type:"ITEMS",itemType:"SELECT",items:[{key:e,def:o=>({type:"select",...l(o)})}],tags:n??[]}}const s={type:"select",...t};return{type:"ITEMS",itemType:"SELECT",items:[{key:e,def:s}],tags:n??[]}}function V(e,t,n){if(typeof t=="function"){const l=t;return{type:"ITEMS",itemType:"DROPDOWN",items:[{key:e,def:o=>({type:"dropdown",...l(o)})}],tags:n??[]}}const s={type:"dropdown",...t};return{type:"ITEMS",itemType:"DROPDOWN",items:[{key:e,def:s}],tags:n??[]}}function H(e,t,n){if(typeof t=="function"){const l=t;return{type:"ITEMS",itemType:"RADIOGROUP",items:[{key:e,def:o=>({type:"radiogroup",...l(o)})}],tags:n??[]}}const s={type:"radiogroup",...t};return{type:"ITEMS",itemType:"RADIOGROUP",items:[{key:e,def:s}],tags:n??[]}}function X(e,t,n){if(typeof t=="function"){const l=t;return{type:"ITEMS",itemType:"CHECKBOX",items:[{key:e,def:o=>({type:"checkbox",...l(o)})}],tags:n??[]}}const s={type:"checkbox",...t};return{type:"ITEMS",itemType:"CHECKBOX",items:[{key:e,def:s}],tags:n??[]}}function Z(e,t,n){if(typeof t=="function"){const l=t;return{type:"ITEMS",itemType:"TEXTAREA",items:[{key:e,def:o=>({type:"textarea",...l(o)})}],tags:n??[]}}const s={type:"textarea",...t};return{type:"ITEMS",itemType:"TEXTAREA",items:[{key:e,def:s}],tags:n??[]}}function q(e,t,n){if(typeof t=="function"){const l=t;return{type:"ITEMS",itemType:"PASSWORD",items:[{key:e,def:o=>({type:"password",...l(o)})}],tags:n??[]}}const s={type:"password",...t};return{type:"ITEMS",itemType:"PASSWORD",items:[{key:e,def:s}],tags:n??[]}}function Q(e,t,n){if(typeof t=="function"){const l=t;return{type:"ITEMS",itemType:"CURRENCY",items:[{key:e,def:o=>({type:"currency",...l(o)})}],tags:n??[]}}const s={type:"currency",...t};return{type:"ITEMS",itemType:"CURRENCY",items:[{key:e,def:s}],tags:n??[]}}function J(e,t,n){if(typeof t=="function"){const l=t;return{type:"ITEMS",itemType:"MARKDOWN",items:[{key:e,def:o=>({type:"markdown",...l(o)})}],tags:n??[]}}const s={type:"markdown",...t};return{type:"ITEMS",itemType:"MARKDOWN",items:[{key:e,def:s}],tags:n??[]}}function x(e,t,n){if(typeof t=="function"){const l=t;return{type:"ITEMS",itemType:"LIST",items:[{key:e,def:o=>({type:"list",...l(o)})}],tags:n??[]}}const s={type:"list",...t};return{type:"ITEMS",itemType:"LIST",items:[{key:e,def:s}],tags:n??[]}}function ee(e,t,n){if(typeof t=="function"){const i=t;return{items:[a=>({type:"calendar",path:e,...i(a)})],type:"ITEMS",itemType:"CALENDAR",tags:n??[]}}return{items:[{type:"calendar",path:e,...t}],type:"ITEMS",itemType:"CALENDAR",tags:n??[]}}function te(e,t,n){if(typeof t=="function"){const l=t;return{type:"ITEMS",itemType:"DATE_INPUT",items:[{key:e,def:o=>({type:"dateInput",...l(o)})}],tags:n??[]}}const s={type:"dateInput",...t};return{type:"ITEMS",itemType:"DATE_INPUT",items:[{key:e,def:s}],tags:n??[]}}function ne(e,t,n){if(typeof t=="function"){const l=t;return{type:"ITEMS",itemType:"DATE_PICKER",items:[{key:e,def:o=>({type:"datePicker",...l(o)})}],tags:n??[]}}const s={type:"datePicker",...t};return{type:"ITEMS",itemType:"DATE_PICKER",items:[{key:e,def:s}],tags:n??[]}}function se(e,t,n){if(typeof t=="function"){const l=t;return{type:"ITEMS",itemType:"RANGE_CALENDAR",items:[{key:e,def:o=>({type:"rangeCalendar",...l(o)})}],tags:n??[]}}const s={type:"rangeCalendar",...t};return{type:"ITEMS",itemType:"RANGE_CALENDAR",items:[{key:e,def:s}],tags:n??[]}}function ie(e,t,n){if(typeof t=="function"){const l=t;return{type:"ITEMS",itemType:"RANGE_DATE_INPUT",items:[{key:e,def:o=>({type:"rangeDateInput",...l(o)})}],tags:n??[]}}const s={type:"rangeDateInput",...t};return{type:"ITEMS",itemType:"RANGE_DATE_INPUT",items:[{key:e,def:s}],tags:n??[]}}function le(e,t,n){if(typeof t=="function"){const l=t;return{type:"ITEMS",itemType:"RANGE_DATE_PICKER",items:[{key:e,def:o=>({type:"rangeDatePicker",...l(o)})}],tags:n??[]}}const s={type:"rangeDatePicker",...t};return{type:"ITEMS",itemType:"RANGE_DATE_PICKER",items:[{key:e,def:s}],tags:n??[]}}function ae(e,t,n,s){if(typeof n=="function"){const a=n;return{type:"ITEMS",itemType:"CUSTOM_INPUT",items:[{key:t,def:c=>({customType:e,...a(c)})}],tags:s??[]}}const i={customType:e,...n};return{type:"ITEMS",itemType:"CUSTOM_INPUT",items:[{key:t,def:i}],tags:s??[]}}class Ft{deepMerge(t,n){if(n==null)return t;if(t==null||typeof t!="object"||typeof n!="object"||Array.isArray(t)||Array.isArray(n))return n;const s={...t};for(const i in n)Object.prototype.hasOwnProperty.call(n,i)&&(typeof n[i]=="object"&&!Array.isArray(n[i])&&n[i]!==null&&typeof t[i]=="object"&&!Array.isArray(t[i])&&t[i]!==null?s[i]=this.deepMerge(t[i],n[i]):s[i]=n[i]);return s}}const re=new Ft;function v(e,t){return{items:[e],type:"ITEMS",itemType:b.ACTIONS,tags:t??[]}}const M=e=>{const t={uid:"#submit",label:"Submit"},n=e!=null?re.deepMerge(t,e):t;return v(n)};function oe(e,t,n){if(typeof t=="function"){const l=t;return{type:"ITEMS",itemType:"CUSTOM_ACTION",items:[u=>({customType:e,...l(u)})],tags:n??[]}}return{type:"ITEMS",itemType:"CUSTOM_ACTION",items:[{customType:e,...t}],tags:n??[]}}const R=(e,t)=>({type:"ITEMS",itemType:b.DISPLAYS,items:[{render:e}],tags:t??[]});function ue(e,t){return{type:"ITEMS",itemType:"ALERTS",items:[e],tags:t??[]}}function ce(e,t,n){if(typeof t=="function"){const u=t;return{type:"ITEMS",itemType:"CUSTOM_DISPLAY",items:[c=>({customType:e,...u(c)})],tags:n??[]}}const{uid:s,...i}=t??{};return{type:"ITEMS",itemType:"CUSTOM_DISPLAY",items:[{customType:e,...s!=null?{uid:s}:{},props:Object.keys(i).length>0?i:void 0}],tags:n??[]}}const D=(e,t,n)=>({type:"ITEMS",itemType:b.LAYOUTS,items:[{def:{widgetName:"flex",...t??{}},children:e}],tags:n??[]}),de=(e,t,n)=>D(e,{direction:"row",...t??{}},n),pe=(e,t,n)=>D(e,{direction:"column",...t??{}},n),C=(e,t,n)=>({type:"ITEMS",itemType:b.LAYOUTS,items:[{def:{widgetName:"grid",direction:"row",autoFit:!0,...t??{}},children:e}],tags:n??[]}),ye=(e,t,n)=>C(e,{direction:"row",...t??{}},n),me=(e,t,n)=>C(e,{direction:"column",...t??{}},n);function ge(e){return e.toLowerCase().replace(/[^a-z0-9]+/g,"-").replace(/(^-|-$)/g,"")}function be(e,t,n){const s=e.map(a=>({label:a.label,uid:a.uid??ge(a.label)})),i=e.map(a=>({type:"ITEMS",itemType:b.LAYOUTS,items:[{def:{uid:a.uid??ge(a.label),direction:"column",widgetName:"flex"},children:a.children}],tags:[]}));return{type:"ITEMS",itemType:"TABS",items:[{def:{tabs:s,...t},children:i}],tags:n??[]}}function fe(e){return e.toLowerCase().replace(/[^a-z0-9]+/g,"-").replace(/(^-|-$)/g,"")}function he(e,t,n){const s=e.map(a=>({label:a.label,uid:a.uid??fe(a.label)})),i=e.map(a=>({type:"ITEMS",itemType:b.LAYOUTS,items:[{def:{uid:a.uid??fe(a.label),direction:"column",widgetName:"flex"},children:a.children}],tags:[]}));return{type:"ITEMS",itemType:"ACCORDION",items:[{def:{sections:s,...t},children:i}],tags:n??[]}}function Te(e,t,n,s){if(typeof n=="function"){const a=n;return{type:"ITEMS",itemType:"CUSTOM_LAYOUT",items:[{def:c=>({customType:e,...a(c)}),children:t}],tags:s??[]}}return{type:"ITEMS",itemType:"CUSTOM_LAYOUT",items:[{def:{customType:e,...n},children:t}],tags:s??[]}}function _e(e,t,n){const{template:s,...i}=t;return{type:"ITEMS",itemType:"REPEATER",items:[{key:e,def:i,children:s}],tags:n??[]}}function O(e){return function(t,n=()=>!0){return{kind:"leaf",selectorType:e,matcher:n,config:t}}}const P=new Map;function Se(e,t){if(P.has(e))throw new Error(`Item type "${e}" is already registered.`);P.set(e,t)}function U(e){const t=P.get(e);if(!t)throw new Error(`No handler registered for item type "${e}". Did you forget to import the registration module?`);return t}function Ae(e){return P.has(e)}function p(e){const t=u=>{if(!e.sensibleDefaults)return{};let o={...e.sensibleDefaults.base};for(const c of u){const d=c.config;for(const m of e.sensibleDefaults.fields){const y=m;d[y]!=null&&(o={...o,[y]:d[y]})}}return o},n=(u,o)=>e.sensibleDefaults?e.sensibleDefaults.apply(u,o):u,s=u=>{switch(e.entryShape){case"bare":return{baseDef:u};case"keyed":{const o=u;return{baseDef:o.def,path:o.key}}case"compound":{const o=u;return{baseDef:o.def,children:o.children}}}},i={rollUpSensibleDefaults:t,applySensibleDefaults:n,mapToWidget:e.mapToWidget,parseEntry:s,...e.afterMerge?{afterMerge:e.afterMerge}:{},...e.buildCustomWidget?{buildCustomWidget:e.buildCustomWidget}:{},...e.getChildren?{getChildren:e.getChildren}:{}};Se(e.itemType,i);const l=O(e.itemType);return{gsl:l,gslByUid:(u,o)=>l(o,(c=>c.uid===u))}}function g(e){const{uid:t,path:n,label:s,disabled:i,readonly:l,defaultValue:a,tags:u,type:o,size:c,onLoad:d,onChange:m,onFilter:y,on:_,states:w,include:L,exclude:Ot,validator:Wt,...I}=e;return I}function h(e,t){return typeof e=="function"?e:{type:t,...e??{}}}function jt(e){return e?e.replace(/([a-z0-9])([A-Z])/g,"$1 $2").replace(/[_-]+/g," ").replace(/\s+/g," ").trim().replace(/\b\w/g,t=>t.toUpperCase()):""}function f(e,t){return e.label!=null||t.suppressAutomaticLabels||!e.path?e:{...e,label:jt(e.path)}}function S(e,t){return e.placeholder!=null||t.suppressAutomaticPlaceholders||!e.path?e:{...e,placeholder:e.path}}function $t(e){switch(e.type){case"text":return zt(e);case"number":return Gt(e);case"boolean":return Yt(e);default:throw new Error(`Unsupported field type "${e.type}"`)}}function Yt(e){const t=g(e);return{uid:e.uid??"",kind:"input",type:"toggle",path:e.path??"",...e.label!=null?{label:e.label}:{},...e.disabled!=null?{disabled:e.disabled}:{},...e.readonly!=null?{readonly:e.readonly}:{},...e.validator!=null?{validator:h(e.validator,"boolean")}:{},props:t}}function zt(e){const t=g(e);return{uid:e.uid??"",kind:"input",type:"textinput",path:e.path??"",...e.label!=null?{label:e.label}:{},...e.disabled!=null?{disabled:e.disabled}:{},...e.readonly!=null?{readonly:e.readonly}:{},props:{placeholder:t.placeholder??"",...t},validator:h(e.validator,"string")}}function Gt(e){const t=g(e);return{uid:e.uid??"",kind:"input",type:"number",path:e.path??"",...e.label!=null?{label:e.label}:{},...e.disabled!=null?{disabled:e.disabled}:{},...e.readonly!=null?{readonly:e.readonly}:{},props:{placeholder:t.placeholder??"",...t},validator:h(e.validator,"number")}}const{gsl:E,gslByUid:ke}=p({itemType:"INPUTS",entryShape:"keyed",sensibleDefaults:{base:{suppressAutomaticLabels:!1,suppressAutomaticPlaceholders:!1},fields:["suppressAutomaticLabels","suppressAutomaticPlaceholders"],apply:(e,t)=>{let n=f(e,t);return n=S(n,t),n}},mapToWidget:$t}),Ie=e=>E(e,t=>t.type==="text"),Ue=e=>E(e,t=>t.type==="number"),Ee=e=>E(e,t=>t.type==="boolean"),{gsl:De,gslByUid:Ce}=p({itemType:"SELECT",entryShape:"keyed",sensibleDefaults:{base:{suppressAutomaticLabels:!1,suppressAutomaticPlaceholders:!1},fields:["suppressAutomaticLabels","suppressAutomaticPlaceholders"],apply:(e,t)=>S(f(e,t),t)},mapToWidget:e=>({uid:e.uid??"",kind:"input",type:"select",path:e.path??"",...e.label!=null?{label:e.label}:{},...e.disabled!=null?{disabled:e.disabled}:{},...e.readonly!=null?{readonly:e.readonly}:{},...e.validator!=null?{validator:e.validator}:{},props:g(e)})}),{gsl:Pe,gslByUid:Be}=p({itemType:"DROPDOWN",entryShape:"keyed",sensibleDefaults:{base:{suppressAutomaticLabels:!1,suppressAutomaticPlaceholders:!1},fields:["suppressAutomaticLabels","suppressAutomaticPlaceholders"],apply:(e,t)=>S(f(e,t),t)},mapToWidget:e=>({uid:e.uid??"",kind:"input",type:"dropdown",path:e.path??"",...e.label!=null?{label:e.label}:{},...e.disabled!=null?{disabled:e.disabled}:{},...e.readonly!=null?{readonly:e.readonly}:{},...e.validator!=null?{validator:e.validator}:{},props:g(e)})}),{gsl:we,gslByUid:Le}=p({itemType:"RADIOGROUP",entryShape:"keyed",sensibleDefaults:{base:{suppressAutomaticLabels:!1},fields:["suppressAutomaticLabels"],apply:(e,t)=>f(e,t)},mapToWidget:e=>({uid:e.uid??"",kind:"input",type:"radiogroup",path:e.path??"",...e.label!=null?{label:e.label}:{},...e.disabled!=null?{disabled:e.disabled}:{},...e.readonly!=null?{readonly:e.readonly}:{},...e.validator!=null?{validator:e.validator}:{},props:g(e)})}),{gsl:ve,gslByUid:Me}=p({itemType:"CHECKBOX",entryShape:"keyed",sensibleDefaults:{base:{suppressAutomaticLabels:!1},fields:["suppressAutomaticLabels"],apply:(e,t)=>f(e,t)},mapToWidget:e=>({uid:e.uid??"",kind:"input",type:"checkbox",path:e.path??"",...e.label!=null?{label:e.label}:{},...e.disabled!=null?{disabled:e.disabled}:{},...e.readonly!=null?{readonly:e.readonly}:{},...e.validator!=null?{validator:h(e.validator,"boolean")}:{},props:g(e)})}),{gsl:Re,gslByUid:Oe}=p({itemType:"TEXTAREA",entryShape:"keyed",sensibleDefaults:{base:{suppressAutomaticLabels:!1,suppressAutomaticPlaceholders:!1},fields:["suppressAutomaticLabels","suppressAutomaticPlaceholders"],apply:(e,t)=>S(f(e,t),t)},mapToWidget:e=>({uid:e.uid??"",kind:"input",type:"textarea",path:e.path??"",...e.label!=null?{label:e.label}:{},...e.disabled!=null?{disabled:e.disabled}:{},...e.readonly!=null?{readonly:e.readonly}:{},...e.validator!=null?{validator:h(e.validator,"string")}:{},props:g(e)})}),{gsl:We,gslByUid:Ne}=p({itemType:"PASSWORD",entryShape:"keyed",sensibleDefaults:{base:{suppressAutomaticLabels:!1,suppressAutomaticPlaceholders:!1},fields:["suppressAutomaticLabels","suppressAutomaticPlaceholders"],apply:(e,t)=>S(f(e,t),t)},mapToWidget:e=>({uid:e.uid??"",kind:"input",type:"password",path:e.path??"",...e.label!=null?{label:e.label}:{},...e.disabled!=null?{disabled:e.disabled}:{},...e.readonly!=null?{readonly:e.readonly}:{},...e.validator!=null?{validator:h(e.validator,"string")}:{},props:g(e)})}),{gsl:Fe,gslByUid:je}=p({itemType:"CURRENCY",entryShape:"keyed",sensibleDefaults:{base:{suppressAutomaticLabels:!1,suppressAutomaticPlaceholders:!1},fields:["suppressAutomaticLabels","suppressAutomaticPlaceholders"],apply:(e,t)=>S(f(e,t),t)},mapToWidget:e=>({uid:e.uid??"",kind:"input",type:"currency",path:e.path??"",...e.label!=null?{label:e.label}:{},...e.disabled!=null?{disabled:e.disabled}:{},...e.readonly!=null?{readonly:e.readonly}:{},...e.validator!=null?{validator:h(e.validator,"number")}:{},props:g(e)})}),{gsl:$e,gslByUid:Ye}=p({itemType:"MARKDOWN",entryShape:"keyed",sensibleDefaults:{base:{suppressAutomaticLabels:!1,suppressAutomaticPlaceholders:!1},fields:["suppressAutomaticLabels","suppressAutomaticPlaceholders"],apply:(e,t)=>S(f(e,t),t)},mapToWidget:e=>({uid:e.uid??"",kind:"input",type:"markdown",path:e.path??"",...e.label!=null?{label:e.label}:{},...e.disabled!=null?{disabled:e.disabled}:{},...e.readonly!=null?{readonly:e.readonly}:{},...e.validator!=null?{validator:h(e.validator,"string")}:{},props:g(e)})}),{gsl:ze,gslByUid:Ge}=p({itemType:"LIST",entryShape:"keyed",sensibleDefaults:{base:{suppressAutomaticLabels:!1},fields:["suppressAutomaticLabels"],apply:(e,t)=>f(e,t)},mapToWidget:e=>({uid:e.uid??"",kind:"input",type:"list",path:e.path??"",...e.label!=null?{label:e.label}:{},...e.disabled!=null?{disabled:e.disabled}:{},...e.readonly!=null?{readonly:e.readonly}:{},...e.validator!=null?{validator:e.validator}:{},props:g(e)})}),{gsl:Ke,gslByUid:Ve}=p({itemType:"CALENDAR",entryShape:"bare",sensibleDefaults:{base:{suppressAutomaticLabels:!1},fields:["suppressAutomaticLabels"],apply:(e,t)=>f(e,t)},mapToWidget:e=>({uid:e.uid??"",kind:"input",type:"calendar",path:e.path??"",...e.label!=null?{label:e.label}:{},...e.disabled!=null?{disabled:e.disabled}:{},...e.readonly!=null?{readonly:e.readonly}:{},...e.validator!=null?{validator:h(e.validator,"string")}:{},props:g(e)})}),{gsl:He,gslByUid:Xe}=p({itemType:"DATE_INPUT",entryShape:"keyed",sensibleDefaults:{base:{suppressAutomaticLabels:!1},fields:["suppressAutomaticLabels"],apply:(e,t)=>f(e,t)},mapToWidget:e=>({uid:e.uid??"",kind:"input",type:"dateInput",path:e.path??"",...e.label!=null?{label:e.label}:{},...e.disabled!=null?{disabled:e.disabled}:{},...e.readonly!=null?{readonly:e.readonly}:{},...e.validator!=null?{validator:h(e.validator,"string")}:{},props:g(e)})}),{gsl:Ze,gslByUid:qe}=p({itemType:"DATE_PICKER",entryShape:"keyed",sensibleDefaults:{base:{suppressAutomaticLabels:!1,suppressAutomaticPlaceholders:!1},fields:["suppressAutomaticLabels","suppressAutomaticPlaceholders"],apply:(e,t)=>S(f(e,t),t)},mapToWidget:e=>({uid:e.uid??"",kind:"input",type:"datePicker",path:e.path??"",...e.label!=null?{label:e.label}:{},...e.disabled!=null?{disabled:e.disabled}:{},...e.readonly!=null?{readonly:e.readonly}:{},...e.validator!=null?{validator:h(e.validator,"string")}:{},props:g(e)})}),{gsl:Qe,gslByUid:Je}=p({itemType:"RANGE_CALENDAR",entryShape:"keyed",sensibleDefaults:{base:{suppressAutomaticLabels:!1},fields:["suppressAutomaticLabels"],apply:(e,t)=>f(e,t)},mapToWidget:e=>({uid:e.uid??"",kind:"input",type:"rangeCalendar",path:e.path??"",...e.label!=null?{label:e.label}:{},...e.disabled!=null?{disabled:e.disabled}:{},...e.readonly!=null?{readonly:e.readonly}:{},...e.validator!=null?{validator:h(e.validator,"array")}:{},props:g(e)})}),{gsl:xe,gslByUid:et}=p({itemType:"RANGE_DATE_INPUT",entryShape:"keyed",sensibleDefaults:{base:{suppressAutomaticLabels:!1},fields:["suppressAutomaticLabels"],apply:(e,t)=>f(e,t)},mapToWidget:e=>({uid:e.uid??"",kind:"input",type:"rangeDateInput",path:e.path??"",...e.label!=null?{label:e.label}:{},...e.disabled!=null?{disabled:e.disabled}:{},...e.readonly!=null?{readonly:e.readonly}:{},...e.validator!=null?{validator:h(e.validator,"array")}:{},props:g(e)})}),{gsl:tt,gslByUid:nt}=p({itemType:"RANGE_DATE_PICKER",entryShape:"keyed",sensibleDefaults:{base:{suppressAutomaticLabels:!1,suppressAutomaticPlaceholders:!1},fields:["suppressAutomaticLabels","suppressAutomaticPlaceholders"],apply:(e,t)=>S(f(e,t),t)},mapToWidget:e=>({uid:e.uid??"",kind:"input",type:"rangeDatePicker",path:e.path??"",...e.label!=null?{label:e.label}:{},...e.disabled!=null?{disabled:e.disabled}:{},...e.readonly!=null?{readonly:e.readonly}:{},...e.validator!=null?{validator:h(e.validator,"array")}:{},props:g(e)})});function Kt(e){const t={};return e.addLabel!=null&&(t.addLabel=e.addLabel),e.removeLabel!=null&&(t.removeLabel=e.removeLabel),e.limit!=null&&(t.limit=e.limit),e.title!=null&&(t.title=e.title),e.addButtonIcon!=null&&(t.addButtonIcon=e.addButtonIcon),e.removeButtonIcon!=null&&(t.removeButtonIcon=e.removeButtonIcon),t}function Vt(e){return{uid:e.uid??"",kind:"input",type:"repeater",path:e.path??"",...e.label!=null?{label:e.label}:{},...e.disabled!=null?{disabled:e.disabled}:{},...e.readonly!=null?{readonly:e.readonly}:{},...e.validator!=null?{validator:h(e.validator,"array")}:{},props:{...Kt(e),template:{kind:"layout",type:"flex",children:[],props:{direction:"column"}}}}}function W(e,t){for(const n of e){if(typeof n=="function")continue;const s=n;typeof s.path=="string"&&s.path&&(s.path=t+s.path),"children"in s&&Array.isArray(s.children)&&W(s.children,t);const i=s.props;i?.template?.children&&Array.isArray(i.template.children)&&W(i.template.children,t)}}function Ht(e,t){const n=t.walkChildren(t.children??[]),s=e.kind==="static"?e.def.path??"":e.fn({})?.path??"";s&&W(n,s+".items.");const i={kind:"layout",type:"flex",uid:"",children:n,props:{direction:"column"}};if(e.kind==="static"){const a=t.mapStaticDef(e.def,"REPEATER");return{...a,props:{...a.props,template:i}}}const l=e.fn;return(a=>{const u=l(a),o=t.mapStaticDef(u,"REPEATER");return{...o,props:{...o.props,template:i}}})}function Xt(e){return{baseDef:e.def,path:e.key,children:e.children}}function Zt(e){return e.children}Se("REPEATER",{parseEntry:Xt,rollUpSensibleDefaults:()=>({}),applySensibleDefaults:e=>e,mapToWidget:Vt,buildCustomWidget:Ht,getChildren:Zt});const N=O("REPEATER"),st=(e,t)=>N(t,(n=>n.uid===e)),it={onLoad:"load",onChange:"change",onFilter:"filter",onBlur:"blur"},qt=Object.keys(it);class Qt{extractOnClickFromMergeResult(t,n,s,i){if(t.kind==="dynamic"){const u=t.fn;return{kind:"dynamic",fn:c=>{const d=u(c);return this.wireOnClick(d,n,s,i)}}}const l=t.def;return{kind:"static",def:this.wireOnClick(l,n,s,i)}}countSubmitButtons(t){let n=0;for(const s of t){if(s.type!=="ITEMS")continue;const i=U(s.itemType);for(const l of s.items){const a=i.getChildren?.(l);if(a&&(n+=this.countSubmitButtons(a)),s.itemType===b.ACTIONS){if(typeof l=="function")continue;const u=l;(u.uid==="#submit"||u.onClick==="submit")&&n++}}}return n}wireOnClick(t,n,s,i){const l=t.uid==="#submit"||t.onClick==="submit",a=l?"#submit":i.next(),u=l?"submit":a,o=t.onClick,d=(typeof o=="function"?o:void 0)??(l?s.onSubmit:void 0);if(d){n.set(u,_=>d(_.data));const{onClick:m,...y}=t;return{...y,uid:a,on:{click:u}}}if(l){const{onClick:m,...y}=t;return{...y,uid:a,on:{click:"submit"}}}if(typeof o=="string"){const{onClick:m,...y}=t;return{...y,uid:a,on:{click:o}}}return{...t,uid:a}}wireInputLayoutEvents(t,n,s){if(t.kind==="dynamic"){const l=t.fn;return{kind:"dynamic",fn:u=>{const o=l(u);return this.wireEventProperties(o,n,s)}}}return{kind:"static",def:this.wireEventProperties(t.def,n,s)}}wireEventProperties(t,n,s){const i={...t.on||{}};let l=!1;const a={...t};for(const u of qt){const o=t[u];if(o==null)continue;const c=it[u];if(typeof o=="function"){const d=s.next();n.set(d,o),i[c]=d,l=!0}else typeof o=="string"&&(i[c]=o,l=!0);delete a[u]}return l&&(a.on=i),a}}const B=new Qt;function Jt(e){const{uid:t,label:n,disabled:s,on:i,onClick:l,data:a,type:u,tags:o,size:c,include:d,exclude:m,states:y,..._}=e;return{uid:t??"",kind:"action",type:"button",disabled:s,label:n,...i!=null?{on:i}:{},props:_}}const{gsl:lt,gslByUid:at}=p({itemType:"ACTIONS",entryShape:"bare",mapToWidget:Jt,afterMerge:(e,t)=>B.extractOnClickFromMergeResult(e,t.eventRegistry,t.formConfig,t.eventIdGenerator)});function xt(e){const{uid:t,widgetName:n,tags:s,size:i,onChange:l,include:a,exclude:u,...o}=e,{on:c,...d}=o;return{uid:t??"",kind:"layout",type:n??"flex",props:{direction:d.direction??"column",...d},children:[]}}function en(e,t){const n=t.walkChildren(t.children??[]);if(e.kind==="static")return{...t.mapStaticDef(e.def,"LAYOUTS"),children:n};const s=e.fn;return(i=>{const l=s(i);return{...t.mapStaticDef(l,"LAYOUTS"),children:n}})}function tn(e){return e.children}const{gsl:rt,gslByUid:ot}=p({itemType:"LAYOUTS",entryShape:"compound",mapToWidget:xt,buildCustomWidget:en,getChildren:tn});function nn(e){return{uid:"",kind:"display",type:"renderer",props:{render:e.render}}}function sn(e,t){if(e.kind==="static"){const s=e.def;return(i=>({uid:"",kind:"display",type:"renderer",...s.include!=null?{include:s.include}:{},...s.exclude!=null?{exclude:s.exclude}:{},props:{render:s.render(i??{})}}))}const n=e.fn;return(s=>{const i=n(s);return{uid:"",kind:"display",type:"renderer",...i.include!=null?{include:i.include}:{},...i.exclude!=null?{exclude:i.exclude}:{},props:{render:i.render(s??{})}}})}const{gsl:ut,gslByUid:ct}=p({itemType:"DISPLAYS",entryShape:"bare",mapToWidget:nn,buildCustomWidget:sn}),{gsl:dt,gslByUid:pt}=p({itemType:"ALERTS",entryShape:"bare",mapToWidget:e=>({uid:e.uid??"",kind:"display",type:"alert",props:{text:e.text,...e.level!=null?{level:e.level}:{}}})});function ln(e){return{uid:e.uid??"",kind:"layout",type:"tabs",props:{tabs:e.tabs,renderMode:e.renderMode??"all",...e.defaultOpen!=null?{defaultOpen:e.defaultOpen}:{}},children:[]}}function an(e,t){const n=t.walkChildren(t.children??[]);if(e.kind==="static")return{...t.mapStaticDef(e.def,"TABS"),children:n};const s=e.fn;return(i=>{const l=s(i);return{...t.mapStaticDef(l,"TABS"),children:n}})}function rn(e){return e.children}const{gsl:yt,gslByUid:mt}=p({itemType:"TABS",entryShape:"compound",mapToWidget:ln,buildCustomWidget:an,getChildren:rn});function on(e){return{uid:e.uid??"",kind:"layout",type:"accordion",props:{sections:e.sections,renderMode:e.renderMode??"all",...e.singleOpen!=null?{singleOpen:e.singleOpen}:{},...e.defaultOpen!=null?{defaultOpen:e.defaultOpen}:{}},children:[]}}function un(e,t){const n=t.walkChildren(t.children??[]);if(e.kind==="static")return{...t.mapStaticDef(e.def,"ACCORDION"),children:n};const s=e.fn;return(i=>{const l=s(i);return{...t.mapStaticDef(l,"ACCORDION"),children:n}})}function cn(e){return e.children}const{gsl:gt,gslByUid:bt}=p({itemType:"ACCORDION",entryShape:"compound",mapToWidget:on,buildCustomWidget:un,getChildren:cn}),{gsl:ft,gslByUid:ht}=p({itemType:"CUSTOM_INPUT",entryShape:"keyed",sensibleDefaults:{base:{suppressAutomaticLabels:!1},fields:["suppressAutomaticLabels"],apply:(e,t)=>f(e,t)},mapToWidget:e=>({uid:e.uid??"",kind:"input",type:e.customType,path:e.path??"",...e.label!=null?{label:e.label}:{},...e.disabled!=null?{disabled:e.disabled}:{},...e.readonly!=null?{readonly:e.readonly}:{},...e.defaultValue!=null?{defaultValue:e.defaultValue}:{},...e.validator!=null?{validator:e.validator}:{},props:e.props??{}})}),{gsl:Tt,gslByUid:_t}=p({itemType:"CUSTOM_ACTION",entryShape:"bare",mapToWidget:e=>{const{uid:t,label:n,disabled:s,on:i,onClick:l,data:a,customType:u,tags:o,size:c,include:d,exclude:m,states:y,props:_,...w}=e;return{uid:t??"",kind:"action",type:e.customType,label:n,disabled:s,...i!=null?{on:i}:{},props:{..._,...w}}},afterMerge:(e,t)=>B.extractOnClickFromMergeResult(e,t.eventRegistry,t.formConfig,t.eventIdGenerator)}),{gsl:St,gslByUid:At}=p({itemType:"CUSTOM_DISPLAY",entryShape:"bare",mapToWidget:e=>({uid:e.uid??"",kind:"display",type:e.customType,props:e.props??{}})});function dn(e){return{uid:e.uid??"",kind:"layout",type:e.customType,props:e.props??{},children:[]}}function pn(e,t){const n=t.walkChildren(t.children??[]);if(e.kind==="static")return{...t.mapStaticDef(e.def,"CUSTOM_LAYOUT"),children:n};const s=e.fn;return(i=>{const l=s(i);return{...t.mapStaticDef(l,"CUSTOM_LAYOUT"),children:n}})}function yn(e){return e.children}const{gsl:kt,gslByUid:It}=p({itemType:"CUSTOM_LAYOUT",entryShape:"compound",mapToWidget:dn,buildCustomWidget:pn,getChildren:yn});class k{constructor(t){this.conditions=t}static root(){return new k([])}tag(t){return new k([...this.conditions,{kind:"tagsAnd",tags:[t]}])}state(t){return new k([...this.conditions,{kind:"state",name:t}])}tagsAnd(t){return new k([...this.conditions,{kind:"tagsAnd",tags:t}])}tagsOr(t){return new k([...this.conditions,{kind:"tagsOr",tags:t}])}apply(t){if(this.conditions.length===0)return t;const n=this.conditions.find(l=>l.kind==="state"),s=this.conditions.filter(l=>l.kind!=="state"),i=t.matcher;return{...t,matcher:l=>{if(!i(l))return!1;for(const a of s){const u=l.tags??[];if(a.kind==="tagsAnd"){for(const o of a.tags)if(!u.includes(o))return!1}else{if(a.tags.length===0)continue;if(!a.tags.some(o=>u.includes(o)))return!1}}return!0},...n?{targetState:n.name}:{}}}inputs(t){return this.apply(E(t))}inputByUid(t,n){return this.apply(ke(t,n))}textInputs(t){return this.apply(Ie(t))}numberInputs(t){return this.apply(Ue(t))}booleanInputs(t){return this.apply(Ee(t))}selects(t){return this.apply(De(t))}selectByUid(t,n){return this.apply(Ce(t,n))}dropdowns(t){return this.apply(Pe(t))}dropdownByUid(t,n){return this.apply(Be(t,n))}radiogroups(t){return this.apply(we(t))}radiogroupByUid(t,n){return this.apply(Le(t,n))}checkboxes(t){return this.apply(ve(t))}checkboxByUid(t,n){return this.apply(Me(t,n))}textareas(t){return this.apply(Re(t))}textareaByUid(t,n){return this.apply(Oe(t,n))}passwords(t){return this.apply(We(t))}passwordByUid(t,n){return this.apply(Ne(t,n))}currencies(t){return this.apply(Fe(t))}currencyByUid(t,n){return this.apply(je(t,n))}markdowns(t){return this.apply($e(t))}markdownByUid(t,n){return this.apply(Ye(t,n))}lists(t){return this.apply(ze(t))}listByUid(t,n){return this.apply(Ge(t,n))}calendars(t){return this.apply(Ke(t))}calendarByUid(t,n){return this.apply(Ve(t,n))}dateInputs(t){return this.apply(He(t))}dateInputByUid(t,n){return this.apply(Xe(t,n))}datePickers(t){return this.apply(Ze(t))}datePickerByUid(t,n){return this.apply(qe(t,n))}rangeCalendars(t){return this.apply(Qe(t))}rangeCalendarByUid(t,n){return this.apply(Je(t,n))}rangeDateInputs(t){return this.apply(xe(t))}rangeDateInputByUid(t,n){return this.apply(et(t,n))}rangeDatePickers(t){return this.apply(tt(t))}rangeDatePickerByUid(t,n){return this.apply(nt(t,n))}repeaters(t){return this.apply(N(t))}repeaterByUid(t,n){return this.apply(st(t,n))}actions(t){return this.apply(lt(t))}actionByUid(t,n){return this.apply(at(t,n))}layouts(t){return this.apply(rt(t))}layoutByUid(t,n){return this.apply(ot(t,n))}displays(t){return this.apply(ut(t))}displayByUid(t,n){return this.apply(ct(t,n))}alerts(t){return this.apply(dt(t))}alertByUid(t,n){return this.apply(pt(t,n))}tabs(t){return this.apply(yt(t))}tabsByUid(t,n){return this.apply(mt(t,n))}accordions(t){return this.apply(gt(t))}accordionByUid(t,n){return this.apply(bt(t,n))}customInputs(t){return this.apply(ft(t))}customInputByUid(t,n){return this.apply(ht(t,n))}customActions(t){return this.apply(Tt(t))}customActionByUid(t,n){return this.apply(_t(t,n))}customDisplays(t){return this.apply(St(t))}customDisplayByUid(t,n){return this.apply(At(t,n))}customLayouts(t){return this.apply(kt(t))}customLayoutByUid(t,n){return this.apply(It(t,n))}}const mn={inputs:{textInput:Y,numberInput:z,booleanInput:G,select:K,dropdown:V,radiogroup:H,checkbox:X,textarea:Z,password:q,currency:Q,markdown:J,list:x,calendar:ee,dateInput:te,datePicker:ne,rangeCalendar:se,rangeDateInput:ie,rangeDatePicker:le,repeater:_e,custom:ae},actions:{button:v,submitButton:M,custom:oe},displays:{display:R,alert:ue,custom:ce},layouts:{flex:D,horizontalFlex:de,verticalFlex:pe,grid:C,horizontalGrid:ye,verticalGrid:me,tabs:be,accordion:he,custom:Te},selectors:k.root()};function gn(e,...t){return t.map(n=>({...n,targetState:e}))}function bn(e,...t){return{kind:"aggregated",matcher:n=>n.tags?.includes(e)??!1,children:t}}const Ut={INPUTS:new Set(["INPUTS","TEXTAREA","PASSWORD","SELECT","DROPDOWN","RADIOGROUP","CHECKBOX","CALENDAR","DATE_INPUT","DATE_PICKER","RANGE_CALENDAR","RANGE_DATE_INPUT","RANGE_DATE_PICKER","CURRENCY","MARKDOWN","LIST","CUSTOM_INPUT","REPEATER"]),ACTIONS:new Set(["ACTIONS","CUSTOM_ACTION"]),DISPLAYS:new Set(["DISPLAYS","ALERTS","CUSTOM_DISPLAY"]),LAYOUTS:new Set(["LAYOUTS","TABS","ACCORDION","CUSTOM_LAYOUT"])};function fn(e,t){const n=Ut[e];return n?n.has(t):e===t}class hn{resolve(t,n){const s=[];for(const l of n)l.kind==="aggregated"?this.collectFromAggregated(l,t,s):this.collectFromLeaf(l,t,s);const i=this.rollUpSensibleDefaults(s);return{leafSelectors:s,sensibleDefaults:i}}collectFromAggregated(t,n,s){if(t.matcher(n))for(const i of t.children)this.collectFromLeaf(i,n,s)}collectFromLeaf(t,n,s){fn(t.selectorType,n.itemType??"")&&t.matcher(n)&&s.push(t)}rollUpSensibleDefaults(t){const n=new Map,s=(l,a)=>{const u=n.get(l)??[];u.push(a),n.set(l,u)};for(const l of t){const a=Ut[l.selectorType];if(a)for(const u of a)s(u,l);else s(l.selectorType,l)}const i={};for(const[l,a]of n)Ae(l)&&(i[l]=U(l).rollUpSensibleDefaults(a));return i}}const Tn=new hn;class _n{constructor(t){this.objectUtils=t}merge(t,n,s){let i={},l=null;typeof t=="function"&&(l=t);const a=this.collectDecorators(s);for(const c of a){if(l!=null){l=this.composeRuntimeFunctions(l,c);continue}if(typeof c=="function"){const d=c({...i,...typeof t=="function"?{}:t});if(typeof d=="function"){l=this.createPromotedFunction(i,t,d,n,s);continue}i=this.objectUtils.deepMerge(i,d)}else i=this.objectUtils.deepMerge(i,c)}if(l!=null)return{kind:"dynamic",fn:this.wrapWithSensibleDefaults(l,i,n,s)};const u=this.objectUtils.deepMerge(t,i);return{kind:"static",def:this.applySensibleDefaults({...u},n,s)}}collectDecorators(t){const n=[];for(const s of t.leafSelectors){const i=s.config;i.override!=null&&n.push(i.override)}return n}applySensibleDefaults(t,n,s){if(!Ae(n))return t;const i=s.sensibleDefaults[n]??{};return U(n).applySensibleDefaults(t,i)}createPromotedFunction(t,n,s,i,l){return a=>{const u=s(a);let o=this.objectUtils.deepMerge(t,u);return o=this.objectUtils.deepMerge(o,n),this.applySensibleDefaults(o,i,l)}}wrapWithSensibleDefaults(t,n,s,i){return l=>{let a=t(l);return Object.keys(n).length>0&&(a=this.objectUtils.deepMerge(n,a)),this.applySensibleDefaults(a,s,i)}}composeRuntimeFunctions(t,n){return typeof n=="function"?s=>{const i=t(s),l=n(i);return typeof l=="function"?l(s):this.objectUtils.deepMerge(l,i)}:s=>{const i=t(s);return this.objectUtils.deepMerge(i,n)}}}const Sn=new _n(re);class An{mapToWidget(t,n){if(t.kind==="dynamic"){const s=t.fn;return(i=>{const l=s(i);return this.mapStaticDef(l,n)})}return this.mapStaticDef(t.def,n)}mapStaticDef(t,n){const s=U(n).mapToWidget(t);return this.applyBaseWidgetFields(s,t)}applyBaseWidgetFields(t,n){return n.size!=null&&(t.size=n.size),n.defaultValue!=null&&t.kind==="input"&&(t.defaultValue=n.defaultValue),n.on!=null&&(t.on=n.on),n.include!=null&&(t.include=n.include),n.exclude!=null&&(t.exclude=n.exclude),t}}const kn=new An;class In{normalizeSelectors(t){const n=Array.isArray(t)?t:[t],s=[],i=[];for(const l of n)l.kind==="leaf"?i.push(l):s.push(l);return i.length>0&&s.unshift({kind:"aggregated",matcher:()=>!0,children:i}),s}extractFormConfig(){return{suppressAutomaticStack:!1,suppressAutomaticSubmit:!1,onSubmit:t=>console.log("Form submitted:",t)}}}const Un=new In;function En(){let e=0;return{next:()=>`event_${e++}`}}class Dn{constructor(t,n,s,i,l){this.resolver=t,this.merger=n,this.mapper=s,this.eventWiring=i,this.stateExpansion=l}walkAndMap(t,n,s){const i=new Map,l=En(),a={value:0},u=new Set;return{widgets:this.walkItems(t,n,i,s,l,a,u),eventRegistry:i}}walkItems(t,n,s,i,l,a,u){return t.flatMap(o=>{if(o.type!=="ITEMS")throw new Error("Unexpected gui shortcut type");return o.items.map(c=>this.processItem(c,o.itemType,o.tags,n,s,i,l,a,u))})}processItem(t,n,s,i,l,a,u,o,c){const d=n,m=U(n),y=m.parseEntry(t),_=this.buildBaseDef(y),w=this.buildDecoratorForMatching(_,d,s),L=this.resolver.resolve(w,i),Ot=L.leafSelectors.filter(T=>T.targetState!=null),Wt={leafSelectors:L.leafSelectors.filter(T=>T.targetState==null),sensibleDefaults:L.sensibleDefaults};let I=this.merger.merge(_,d,Wt);m.afterMerge&&(I=m.afterMerge(I,{eventRegistry:l,formConfig:a,eventIdGenerator:u})),I=this.eventWiring.wireInputLayoutEvents(I,l,u);const{cleanedResult:Nt,stateData:$}=this.stateExpansion.extractFromMergeResult(I,Ot);let A;if(m.buildCustomWidget){const T=this.buildCustomWidgetContext(y.children,i,l,a,u,o,c);A=this.buildCustomWidget(m,Nt,T)}else A=this.mapper.mapToWidget(Nt,d);if(typeof A!="function"){const T=A;T.uid||(T.path&&!c.has(T.path)?(T.uid=T.path,c.add(T.path)):T.uid=`dx_${o.value++}`)}if(this.stateExpansion.hasStateData($))if(typeof A=="function"){const T=A;A=(Gn=>{const Kn=T(Gn);return this.stateExpansion.applyToWidget(Kn,$,l,u)})}else A=this.stateExpansion.applyToWidget(A,$,l,u);return A}buildCustomWidgetContext(t,n,s,i,l,a,u){return{children:t,mapStaticDef:(o,c)=>this.mapper.mapStaticDef(o,c),walkChildren:o=>this.walkItems(o,n,s,i,l,a,u)}}buildCustomWidget(t,n,s){return t.buildCustomWidget(n,s)}buildBaseDef(t){const n=t.baseDef;return typeof n=="function"?s=>{const l=n(s??{});return t.path!=null?{...l,path:t.path}:l}:t.path!=null?{...n,path:t.path}:n}buildDecoratorForMatching(t,n,s){if(typeof t=="function")return{itemType:n,tags:[...s]};const i=[...s,..."tags"in t&&t.tags?t.tags:[]],l="uid"in t?t.uid:void 0,a="type"in t?t.type:void 0;return{itemType:n,tags:i,uid:l,type:a}}}const Cn={input:new Set(["disabled","readonly","label","validator","size"]),action:new Set(["disabled","label","size"]),layout:new Set(["size"]),display:new Set([])},Et={onChange:"change",onLoad:"load",onFilter:"filter",onClick:"click"};class Pn{extractFromMergeResult(t,n){const s={};for(const u of n){const o=u.targetState,c=u.config,d=c.override&&typeof c.override!="function"?c.override:c;s[o]={...s[o]||{},...d}}if(t.kind==="dynamic"){const u=t.fn;return{cleanedResult:{kind:"dynamic",fn:c=>{const d=u(c),{states:m,...y}=d;return y}},stateData:{stateOverrides:s}}}const{states:i,...l}=t.def,a={};for(const[u,o]of Object.entries(s))a[u]={...o};if(i)for(const[u,o]of Object.entries(i))a[u]={...a[u]||{},...o};return{cleanedResult:{kind:"static",def:l},stateData:{stateOverrides:a}}}applyToWidget(t,n,s,i){const{stateOverrides:l}=n;if(Object.keys(l).length===0)return t;const a={...t},u=t.kind,o=Cn[u]||new Set;t.props&&(a.props={...t.props}),t.on&&(a.on={...t.on});for(const[c,d]of Object.entries(l))for(const[m,y]of Object.entries(d))m==="visible"?this.applyVisibility(a,c,y):Et[m]?this.applyStateEvent(a,c,m,y,s,i):o.has(m)?a[`${m}.${c}`]=y:(a.props||(a.props={}),a.props[`${m}.${c}`]=y);return a}hasStateData(t){return Object.keys(t.stateOverrides).length>0}applyVisibility(t,n,s){if(s){const i=t.include?.in||[];t.include={...t.include||{},in:[...i,n]}}else{const i=t.exclude?.from||[];t.exclude={...t.exclude||{},from:[...i,n]}}}applyStateEvent(t,n,s,i,l,a){const u=Et[s];if(t.on||(t.on={}),typeof i=="function"){const o=a.next();l.set(o,i),t.on[`${u}.${n}`]=o}else typeof i=="string"&&(t.on[`${u}.${n}`]=i)}}const Bn=new Pn;class wn{constructor(t,n,s){this.selectorNormalizer=t,this.eventWiring=n,this.walker=s}processDxFacade(t,n=[],s){const{defs:i,gslSelectors:l,formConfig:a}=this.prepareForm(t,n,s),{widgets:u,eventRegistry:o}=this.walker.walkAndMap(i,l,a),c=u[0];return this.buildResult({form:c},o,a)}prepareForm(t,n,s){const l=(Array.isArray(t)?[...t]:[t]).map(c=>typeof c=="function"?R(c):c),a=this.selectorNormalizer.normalizeSelectors(n),u={...this.selectorNormalizer.extractFormConfig(),...s},o=this.eventWiring.countSubmitButtons(l);if(o>1)throw new Error(`Only one submit button is allowed per form, but ${o} were found. A button is a submit button if it has uid: '#submit' or onClick: 'submit'.`);if(!u.suppressAutomaticSubmit&&o===0&&l.push(M()),!u.suppressAutomaticStack){const c={def:{uid:"#root",direction:"column",widgetName:"flex"},children:l};return{defs:[{type:"ITEMS",itemType:b.LAYOUTS,items:[c],tags:[]}],gslSelectors:a,formConfig:u}}return{defs:l,gslSelectors:a,formConfig:u}}convertStateNames(t){const n={};for(const[s,i]of Object.entries(t))n[s.replace(/\$/g,":")]=i;return n}buildResult(t,n,s){s.states&&Object.keys(s.states).length>0&&(t={...t,states:this.convertStateNames(s.states)});const i={form:t};return n.size>0&&(i.events=l=>{const a=n.get(l.name);if(a){const u=c=>{if(c&&typeof c=="object"&&"path"in c&&!("type"in c)){const{path:d,...m}=c;for(const[y,_]of Object.entries(m))l.callback({type:"OVERRIDE_WIDGET_PROP",payload:{path:d,prop:y,value:_}})}else l.callback(c)},o={...l,callback:u,update:u};a(o)}}),s.dependencies&&(i.dependencies=s.dependencies),s.widgetLoaders&&(i.widgetLoaders=s.widgetLoaders),s.validateOn&&(i.validateOn=s.validateOn),s.itemRenderers&&(i.itemRenderers=s.itemRenderers),i}}const Ln=new Dn(Tn,Sn,kn,B,Bn),Dt=new wn(Un,B,Ln);function Ct(e){return typeof e=="function"?!0:Array.isArray(e)?e.length===0||e.every(Pt):Pt(e)}function Pt(e){if(typeof e=="function")return!0;if(e===null||typeof e!="object")return!1;const t=e;return t.type==="ITEMS"&&typeof t.itemType=="string"}const Bt=Object.freeze({}),vn=Object.freeze({}),wt=new WeakMap;function F(e,t){return e==null?t:typeof e=="object"?e:{}}function Mn(e,t,n){if(!Ct(e))return{formDef:e};const s=F(e,Bt),i=F(t,Bt),l=F(n,vn);let a=wt.get(s);a||(a=new WeakMap,wt.set(s,a));let u=a.get(i);u||(u=new WeakMap,a.set(i,u));const o=u.get(l);if(o)return o;const c=Dt.processDxFacade(e,t,n),d={formDef:c.form,formEvent:c.events,dependencies:c.dependencies,widgetLoaders:c.widgetLoaders,validateOn:c.validateOn,itemRenderers:c.itemRenderers};return u.set(l,d),d}class Rn{create(t){return{states:t.states,form:{uid:"gui-root-uid",type:"flex",kind:"layout",children:t.form}}}}function On(){return new Rn}const Wn=e=>e!==null&&typeof e=="object"&&Object.prototype.hasOwnProperty.call(e,"label")&&Object.prototype.hasOwnProperty.call(e,"value");function Nn(e,t){if(e!=null&&typeof e=="object"&&"__rid"in e)return e.__rid;const n=t();return Object.defineProperty(e,"__rid",{value:n,enumerable:!1,configurable:!1}),n}function Fn(e){return typeof e=="object"&&e!==null&&"$ref"in e&&typeof e.$ref=="string"&&Object.keys(e).length===1}async function jn(e,t){const n=new URL(e,t).href,s=await fetch(n);if(!s.ok)throw new Error(`Failed to load form chunk ${n}: ${s.status}`);const{$schema:i,...l}=await s.json();return j(l,n)}async function j(e,t){if(Fn(e))return jn(e.$ref,t);const n=e;if(Array.isArray(n.children)){const s=await Promise.all(n.children.map(i=>j(i,t)));return{...n,children:s}}return e}async function $n(e,t){const n=await Promise.all(e.form.map(s=>j(s,t)));return{...e,form:n}}const Yn={textinput:({config:e,props:t,validator:n})=>({uid:"",kind:"input",type:"textinput",...t&&{props:t},...n&&{validator:n},...e}),password:({config:e,props:t,validator:n})=>({uid:"",kind:"input",type:"password",...t&&{props:t},...n&&{validator:n},...e}),numberinput:({config:e,props:t,validator:n})=>({uid:"",kind:"input",type:"numberinput",...t&&{props:t},...n&&{validator:n},...e}),checkbox:({config:e,props:t,validator:n})=>({uid:"",kind:"input",type:"checkbox",...t&&{props:t},...n&&{validator:n},...e}),select:({config:e,props:t,validator:n})=>({uid:"",kind:"input",type:"select",...t&&{props:t},...n&&{validator:n},...e}),flex:(e,t)=>({uid:"",kind:"layout",type:"flex",...t&&{props:t},...e}),grid:(e,t)=>({uid:"",kind:"layout",type:"grid",...t&&{props:t},...e}),tabs:(e,t)=>({uid:"",kind:"layout",type:"tabs",...t&&{props:t},...e}),alert:(e,t)=>({uid:"",kind:"display",type:"alert",...t&&{props:t},...e}),markdownText:(e,t)=>({uid:"",kind:"display",type:"markdownText",...t&&{props:t},...e})},Lt=["calendar","checkbox","currency","dateInput","datePicker","dropdown","list","markdown","number","password","radiogroup","rangeCalendar","rangeDateInput","rangeDatePicker","repeater","select","textarea","textinput","toggle"],vt=["accordion","flex","grid","tabs"],Mt=["alert","markdownText","renderer"],Rt=["button"],zn=[...Lt,...vt,...Mt,...Rt];r.GolemWidgets=Yn,r._gslAccordionByUid=bt,r._gslAccordions=gt,r._gslActionByUid=at,r._gslActions=lt,r._gslAlertByUid=pt,r._gslAlerts=dt,r._gslBooleanInputs=Ee,r._gslCalendarByUid=Ve,r._gslCalendars=Ke,r._gslCheckboxByUid=Me,r._gslCheckboxes=ve,r._gslCurrencies=Fe,r._gslCurrencyByUid=je,r._gslCustomActionByUid=_t,r._gslCustomActions=Tt,r._gslCustomDisplayByUid=At,r._gslCustomDisplays=St,r._gslCustomInputByUid=ht,r._gslCustomInputs=ft,r._gslCustomLayoutByUid=It,r._gslCustomLayouts=kt,r._gslDateInputByUid=Xe,r._gslDateInputs=He,r._gslDatePickerByUid=qe,r._gslDatePickers=Ze,r._gslDisplayByUid=ct,r._gslDisplays=ut,r._gslDropdownByUid=Be,r._gslDropdowns=Pe,r._gslInputByUid=ke,r._gslInputs=E,r._gslLayoutByUid=ot,r._gslLayouts=rt,r._gslListByUid=Ge,r._gslLists=ze,r._gslMarkdownByUid=Ye,r._gslMarkdowns=$e,r._gslNumberInputs=Ue,r._gslPasswordByUid=Ne,r._gslPasswords=We,r._gslRadiogroupByUid=Le,r._gslRadiogroups=we,r._gslRangeCalendarByUid=Je,r._gslRangeCalendars=Qe,r._gslRangeDateInputByUid=et,r._gslRangeDateInputs=xe,r._gslRangeDatePickerByUid=nt,r._gslRangeDatePickers=tt,r._gslRepeaterByUid=st,r._gslRepeaters=N,r._gslSelectByUid=Ce,r._gslSelects=De,r._gslStates=gn,r._gslTabs=yt,r._gslTabsByUid=mt,r._gslTag=bn,r._gslTextInputs=Ie,r._gslTextareaByUid=Oe,r._gslTextareas=Re,r._guiAccordion=he,r._guiAlert=ue,r._guiBooleanInput=G,r._guiButton=v,r._guiCalendar=ee,r._guiCheckbox=X,r._guiCurrency=Q,r._guiCustomAction=oe,r._guiCustomDisplay=ce,r._guiCustomInput=ae,r._guiCustomLayout=Te,r._guiDateInput=te,r._guiDatePicker=ne,r._guiDisplay=R,r._guiDropdown=V,r._guiFlex=D,r._guiGrid=C,r._guiHorizontalFlex=de,r._guiHorizontalGrid=ye,r._guiList=x,r._guiMarkdown=J,r._guiNumberInput=z,r._guiPassword=q,r._guiRadiogroup=H,r._guiRangeCalendar=se,r._guiRangeDateInput=ie,r._guiRangeDatePicker=le,r._guiRepeater=_e,r._guiSelect=K,r._guiSubmitButton=M,r._guiTabs=be,r._guiTextInput=Y,r._guiTextarea=Z,r._guiVerticalFlex=pe,r._guiVerticalGrid=me,r.actionWidgets=Rt,r.createGslSelector=O,r.defineShortcutType=p,r.displayWidgets=Mt,r.extractWidgetProps=g,r.formDefs=Dt,r.getItemKey=Nn,r.golemForm=On,r.golemWidgets=zn,r.gui=mn,r.inputWidgets=Lt,r.isDxDefinitions=Ct,r.isOption=Wn,r.layoutWidgets=vt,r.processAutoLabel=f,r.processAutoPlaceholder=S,r.resolveChunkRefs=$n,r.resolveFormInput=Mn,Object.defineProperty(r,Symbol.toStringTag,{value:"Module"})}));

package/lib/dx/__tests__/helpers.d.ts

@@ -0,0 +1,30 @@
+import { FormWidget, FunctionWidgetParams, LayoutWidget, NonFunctionWidget } from '@golemui/core';
+import { DxDefinitions } from '../formDef.domain';
+import { FormConfig, GslSelectorsInput } from '../core/dx.domain';
+/**
+ * Process a form definition through the full DX pipeline.
+ *
+ * Returns the root layout widget with its children.
+ * Strips the auto-injected submit button for cleaner assertions
+ * (it's always the last child if present).
+ *
+ * IMPORTANT: Asserts that the root widget IS a layout with uid '#root'
+ * before unwrapping. This makes the helper a canary for auto-stack
+ * changes — if Phase 2 subtly alters auto-stack wiring, this assertion
+ * fails loudly instead of silently masking a regression.
+ */
+export declare function processDx(defs: DxDefinitions, selectors?: GslSelectorsInput, formConfig?: FormConfig): LayoutWidget;
+/**
+ * Get a static (non-function) child widget from a layout by index.
+ * Throws if the child is a function widget — use resolveDynamic for those.
+ */
+export declare function getStaticChild(layout: LayoutWidget, index: number): NonFunctionWidget;
+/**
+ * Get a raw child from a layout by index (could be static or function).
+ */
+export declare function getRawChild(layout: LayoutWidget, index: number): FormWidget;
+/**
+ * Resolve a function widget (dynamic) by calling it with given params.
+ * Returns the resolved static widget.
+ */
+export declare function resolveDynamic(widget: FormWidget, params?: Partial<FunctionWidgetParams<any>>): NonFunctionWidget;

package/lib/dx/core/defineShortcutType.d.ts

@@ -0,0 +1,38 @@
+import { NonFunctionWidget, FormWidget } from '@golemui/core';
+import { GslLeafSelector, MergeResult } from './dx.domain';
+import { GslConfigBase } from './dxUtilityTypes';
+import { AfterMergeContext, BuildWidgetContext } from './itemTypeRegistry';
+import { DxCommonFields } from './dxBase.types';
+type EntryShape = 'bare' | 'keyed' | 'compound';
+interface SensibleDefaultsSpec<TDecorator, TConfig> {
+    base: TConfig;
+    fields: (keyof TConfig)[];
+    apply: (def: TDecorator, config: TConfig) => TDecorator;
+}
+interface ShortcutTypeConfig<TEntry, TDecorator, TConfig> {
+    itemType: string;
+    entryShape: EntryShape;
+    mapToWidget: (def: TDecorator) => NonFunctionWidget;
+    sensibleDefaults?: SensibleDefaultsSpec<TDecorator, TConfig>;
+    afterMerge?: (mergeResult: MergeResult, context: AfterMergeContext) => MergeResult;
+    buildCustomWidget?: (mergeResult: MergeResult, context: BuildWidgetContext) => FormWidget;
+    getChildren?: (entry: TEntry) => any[] | undefined;
+}
+export interface ShortcutTypeSelectors<TDecorator, TConfig extends GslConfigBase<TDecorator>> {
+    gsl: (config: TConfig, matcher?: (decorator: TDecorator) => boolean) => GslLeafSelector;
+    gslByUid: (uid: string, config: TConfig) => GslLeafSelector;
+}
+/**
+ * Convenience factory for registering a new widget type into the DX pipeline.
+ *
+ * Accepts a simple config object (entry shape, mapToWidget, optional hooks) and
+ * assembles a full {@link ItemTypeHandler} from it — generating `parseEntry`,
+ * `rollUpSensibleDefaults`, and `applySensibleDefaults` automatically.
+ * The handler is registered in the global registry so the pipeline can look it up
+ * by `itemType` at runtime.
+ *
+ * Returns GSL selector factories (`gsl`, `gslByUid`) for styling/configuring
+ * widgets of this type.
+ */
+export declare function defineShortcutType<TEntry, TDecorator extends DxCommonFields, TConfig extends GslConfigBase<TDecorator> = GslConfigBase<TDecorator>>(config: ShortcutTypeConfig<TEntry, TDecorator, TConfig>): ShortcutTypeSelectors<TDecorator, TConfig>;
+export {};

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

@@ -0,0 +1,76 @@
+import { FunctionWidgetParams, ValidateOn } from '@golemui/core';
+import { WidgetItemDecorator, GslItemType } from '../formDef.domain';
+import { Dependencies } from '../../shared';
+export type { GslItemType } from '../formDef.domain';
+export type RuntimeFunction = (params: FunctionWidgetParams<any>) => any;
+export type GuiItemType = string;
+export declare const GuiItemTypes: {
+    readonly INPUTS: "INPUTS";
+    readonly ACTIONS: "ACTIONS";
+    readonly LAYOUTS: "LAYOUTS";
+    readonly DISPLAYS: "DISPLAYS";
+    readonly CUSTOM_DISPLAY: "CUSTOM_DISPLAY";
+    readonly CUSTOM_INPUT: "CUSTOM_INPUT";
+    readonly CUSTOM_ACTION: "CUSTOM_ACTION";
+    readonly CUSTOM_LAYOUT: "CUSTOM_LAYOUT";
+};
+export interface GuiItemsShortcut {
+    type: 'ITEMS';
+    itemType: GuiItemType;
+    items: unknown[];
+    tags: string[];
+}
+export type ValidGuiShortcut = GuiItemsShortcut;
+export type GslMatcher = (decorator: WidgetItemDecorator) => boolean;
+export type GslLeafConfig = Record<string, any>;
+export interface GslLeafSelector {
+    kind: 'leaf';
+    selectorType: GslItemType;
+    matcher: (decorator: any) => boolean;
+    config: GslLeafConfig;
+    /** When set by `_gslStates`, config is applied as state-suffixed overrides. */
+    targetState?: string;
+}
+export interface FormConfig {
+    suppressAutomaticStack?: boolean;
+    suppressAutomaticSubmit?: boolean;
+    onSubmit?: (data: any) => void;
+    dependencies?: Dependencies;
+    widgetLoaders?: Record<string, () => Promise<unknown>>;
+    validateOn?: ValidateOn;
+    states?: Record<string, string>;
+    /**
+     * Framework-specific item renderers (e.g. ReactItemRenderer / AngularItemRenderer / LitItemRenderer).
+     * Forwarded to the unified <gui-form>; the type is intentionally framework-agnostic
+     * here and gets narrowed at the framework wrapper boundary.
+     */
+    itemRenderers?: Record<string, unknown>;
+}
+/**
+ * Public-facing form config type for `processDxFacade`'s third argument.
+ * Generic over state keys — TypeScript enforces that every declared state name
+ * has a corresponding expression.
+ *
+ * Usage: `processDxFacade<typeof states[number], FormData>(defs, selectors, formConfig)`
+ */
+export type DxFormConfig<S extends string = string> = Omit<FormConfig, 'states'> & {
+    states?: Record<S, string>;
+};
+export interface GslAggregatedSelector {
+    kind: 'aggregated';
+    matcher: GslMatcher;
+    children: GslLeafSelector[];
+}
+export type GslSelector = GslAggregatedSelector | GslLeafSelector;
+export type GslSelectorsInput = GslSelector | GslSelector[];
+export interface ResolvedSelectors {
+    leafSelectors: GslLeafSelector[];
+    sensibleDefaults: Record<string, Record<string, any>>;
+}
+export type MergeResult = {
+    kind: 'static';
+    def: Record<string, any>;
+} | {
+    kind: 'dynamic';
+    fn: RuntimeFunction;
+};

package/lib/dx/core/dxBase.types.d.ts

@@ -0,0 +1,107 @@
+import { FormEvent, Localizable, ReactiveExpression } from '@golemui/core';
+/**
+ * DX-enriched FormEvent. Extends the core FormEvent with `update()` — the
+ * recommended way for DX event handlers to push widget property changes.
+ *
+ * `update({ path: 'widget', options: [...] })` translates to OVERRIDE_WIDGET_PROP
+ * dispatches under the hood. `callback` is also available for raw/backward-compat use.
+ */
+export type DxFormEvent = FormEvent & {
+    update: (arg: {
+        path: string;
+        [prop: string]: any;
+    }) => void;
+};
+/**
+ * Event handler type for DX event properties.
+ * - Function: handler invoked with a DxFormEvent (use event.update to push widget changes).
+ * - String: pass-through event name for host-managed dispatch.
+ */
+export type DxEventHandler = string | ((event: DxFormEvent) => void);
+/**
+ * INTERNAL decorator fields — used by the pipeline, NOT by form authors.
+ * Contains fields that the pipeline needs but users should never set.
+ */
+export interface DxInternalFields {
+    itemType?: string;
+    removeField?: boolean;
+    /**
+     * Sub-type discriminator on the decorator (e.g. `'text' | 'number' | 'boolean'`
+     * for inputs that share the `INPUTS` itemType, `'password'`, `'dropdown'`, etc.
+     * for top-level itemTypes). Carried into the matching phase so sub-type
+     * matchers like `_gslTextInputs((d) => d.type === 'text')` work.
+     */
+    type?: string;
+}
+/**
+ * Conditional inclusion: state-list or reactive expression form.
+ * Mirrors core's `include` shape on `BaseWidget`.
+ */
+export type DxIncludeCondition = {
+    in: string[];
+} | {
+    when: ReactiveExpression;
+};
+/**
+ * Conditional exclusion: state-list or reactive expression form.
+ * Mirrors core's `exclude` shape on `BaseWidget`.
+ */
+export type DxExcludeCondition = {
+    from: string[];
+} | {
+    when: ReactiveExpression;
+};
+/**
+ * User-settable common fields available on ALL decorator types.
+ */
+export interface DxCommonFields {
+    uid?: string;
+    tags?: string[];
+    size?: number;
+    /** Per-state property overrides. Keys are state names (use `:` for hierarchy). */
+    states?: Record<string, Record<string, any>>;
+    /** Conditionally include the widget — by active state list or reactive expression. */
+    include?: DxIncludeCondition;
+    /** Conditionally exclude the widget — by active state list or reactive expression. */
+    exclude?: DxExcludeCondition;
+}
+/**
+ * PUBLIC base for input-like decorators.
+ * Clean projection of InputWidget properties — no generics, no SomeSuffixable.
+ */
+export interface DxInputBase {
+    path?: string;
+    label?: Localizable | null;
+    disabled?: boolean | {
+        when: ReactiveExpression;
+    };
+    readonly?: boolean | {
+        when: ReactiveExpression;
+    };
+    defaultValue?: unknown;
+    onLoad?: DxEventHandler;
+    onChange?: DxEventHandler;
+    onFilter?: DxEventHandler;
+    onBlur?: DxEventHandler;
+}
+/**
+ * PUBLIC base for action decorators.
+ */
+export interface DxActionBase {
+    label?: Localizable;
+    disabled?: boolean | {
+        when: ReactiveExpression;
+    };
+}
+/**
+ * PUBLIC base for layout decorators.
+ */
+export interface DxLayoutBase {
+    onChange?: DxEventHandler;
+}
+/**
+ * PUBLIC base for display decorators.
+ * Displays are render-function-only — no shared properties beyond uid.
+ */
+export interface DxDisplayBase {
+}

package/lib/dx/core/dxPropsHelper.d.ts

@@ -0,0 +1,9 @@
+import { DxCommonFields, DxInputBase } from './dxBase.types';
+type DxBaseKeys = keyof DxInputBase | keyof DxCommonFields | 'type';
+/**
+ * Extract widget-specific props from a flattened decorator.
+ * Strips DxInputBase + DxCommonFields fields, event properties,
+ * and pipeline-internal `on` from the output.
+ */
+export declare function extractWidgetProps<D extends DxInputBase & DxCommonFields>(def: D): Omit<D, DxBaseKeys>;
+export {};

package/lib/dx/core/dxUtilityTypes.d.ts

@@ -0,0 +1,40 @@
+import { FunctionWidgetParams } from '@golemui/core';
+import { RuntimeFunction, GuiItemsShortcut, GslLeafSelector } from './dx.domain';
+export type DxRuntimeParams<FormData = any> = FunctionWidgetParams<FormData>;
+/**
+ * Generic GSL decorator callback — same structure for every type.
+ * Usage: replace per-type `GslCalendarDecoratorCallback`, `GslInputDecoratorCallback`, etc.
+ */
+export type GslDecoratorCallback<D> = (current: D) => Partial<D> | RuntimeFunction;
+/**
+ * A field definition can be a static decorator or a runtime callback.
+ * Usage: replace per-type `CalendarDefOrCallback`, `ActionDefOrCallback`, etc.
+ */
+export type DefOrCallback<D, TForm = any> = D | ((params: DxRuntimeParams<TForm>) => Partial<D>);
+/**
+ * Standard GSL config shape — override + optional suppress flags.
+ * Extend this for types that have additional GSL config fields.
+ * Usage: replace per-type `GslCalendarConfig`, `GslInputConfig`, etc. base shape.
+ */
+export interface GslConfigBase<D> {
+    override?: Partial<D> | GslDecoratorCallback<D>;
+}
+/**
+ * Typed GUI shortcut sub-interface.
+ * Usage: replace per-type `GuiCalendarShortcut`, `GuiInputsShortcut`, etc.
+ */
+export interface GuiShortcutOf<TItemType extends string, TEntry> extends GuiItemsShortcut {
+    itemType: TItemType;
+    items: TEntry[];
+}
+/**
+ * Creates a GSL selector factory for a given shortcut type.
+ * Eliminates the need for per-type gsl*.impl.ts files.
+ *
+ * @example
+ * ```ts
+ * export const _gslCalendars = createGslSelector<CalendarDecorator, GslCalendarConfig>('CALENDAR');
+ * // Equivalent to the hand-written gslCalendar.impl.ts factory
+ * ```
+ */
+export declare function createGslSelector<D, TConfig extends GslConfigBase<D> = GslConfigBase<D>>(selectorType: string): (config: TConfig, matcher?: (decorator: D) => boolean) => GslLeafSelector;

package/lib/dx/core/dxValidatorHelper.d.ts

@@ -0,0 +1,18 @@
+import { Validator } from '@golemui/gui-validators';
+type ValidatorFn = (api: any) => Partial<Validator>;
+/**
+ * Build a fixed-type validator from a user-supplied partial validator and a
+ * known JSON-schema type. The DX layer uses this for widgets whose value
+ * shape is fixed (e.g. password is always string, currency always number,
+ * calendar always string-with-format, repeater always array).
+ *
+ * Runtime-function validators are passed through unchanged — the function's
+ * return value is responsible for setting `type` itself. The function is
+ * evaluated by the engine on every form-data change.
+ *
+ * When `validator` is `undefined`, returns a no-op typed validator
+ * (`{ type }` with no rules). Callers can still gate the call with a null
+ * check when they only want to emit `validator` if the user supplied one.
+ */
+export declare function buildTypedValidator(validator: Record<string, unknown> | ValidatorFn | undefined, type: Validator['type']): Validator | ValidatorFn;
+export {};

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

@@ -0,0 +1,22 @@
+import { FormEvent } from '@golemui/core';
+import { FormConfig, MergeResult, ValidGuiShortcut } from './dx.domain';
+import { EventIdGenerator } from './itemTypeRegistry';
+export type EventRegistry = Map<string, (event: FormEvent) => void>;
+/**
+ * Generalisation of ActionOnClickService.
+ *
+ * Two entry points:
+ * - `extractOnClickFromMergeResult` — action-specific: handles onClick + submit promotion.
+ *   Called from the actions afterMerge hook.
+ * - `wireInputLayoutEvents` — universal: handles onLoad, onChange, onFilter on any widget.
+ *   Called from ItemWalker.processItem for every item.
+ */
+export declare class EventWiringService {
+    extractOnClickFromMergeResult(mergeResult: MergeResult, eventRegistry: EventRegistry, formConfig: FormConfig, eventIdGenerator: EventIdGenerator): MergeResult;
+    countSubmitButtons(defs: ValidGuiShortcut[]): number;
+    private wireOnClick;
+    wireInputLayoutEvents(mergeResult: MergeResult, eventRegistry: EventRegistry, eventIdGenerator: EventIdGenerator): MergeResult;
+    private wireEventProperties;
+}
+declare const eventWiringService: EventWiringService;
+export default eventWiringService;

package/lib/dx/core/itemTypeRegistry.d.ts

@@ -0,0 +1,82 @@
+import { FormWidget, NonFunctionWidget, UiState, FormEvent } from '@golemui/core';
+import { DxRuntimeParams } from './dxUtilityTypes';
+import { GslLeafSelector, FormConfig, MergeResult, ValidGuiShortcut, GslItemType } from './dx.domain';
+import { DxCommonFields } from './dxBase.types';
+export interface ParsedEntry<TDecorator extends DxCommonFields = DxCommonFields> {
+    baseDef: TDecorator | ((params: DxRuntimeParams) => Partial<TDecorator>);
+    path?: string;
+    children?: ValidGuiShortcut[];
+}
+export type EventRegistry = Map<string, (event: FormEvent) => void>;
+export interface EventIdGenerator {
+    next(): string;
+}
+export interface AfterMergeContext {
+    eventRegistry: EventRegistry;
+    formConfig: FormConfig;
+    eventIdGenerator: EventIdGenerator;
+}
+export interface BuildWidgetContext {
+    children?: ValidGuiShortcut[];
+    mapStaticDef: (def: Record<string, any>, itemType: GslItemType) => NonFunctionWidget;
+    walkChildren: (children: ValidGuiShortcut[]) => FormWidget[];
+}
+/**
+ * Strategy interface for a widget type (inputs, actions, layouts, calendars, etc.).
+ *
+ * The DX pipeline (`ItemWalker.processItem`) is generic — it walks the widget tree,
+ * resolves selectors, merges definitions, and maps to framework widgets. But each
+ * widget type has its own entry shape, its own sensible defaults, and sometimes
+ * custom post-merge or widget-building logic. The handler provides these type-specific
+ * behaviors at well-defined extension points in the pipeline:
+ *
+ *   1. `parseEntry`             — parse raw entry into a normalized `ParsedEntry`
+ *   2. `rollUpSensibleDefaults` — aggregate config from matching leaf selectors
+ *   3. `applySensibleDefaults`  — apply aggregated config to a merged decorator
+ *   4. `mapToWidget`            — map a decorator to a core `FormWidget`
+ *   5. `afterMerge` (optional)  — post-merge hook (e.g. actions use this to wire onClick)
+ *   6. `buildCustomWidget` (optional) — custom widget building for compound types (e.g. layouts
+ *                                  that need to recursively walk children)
+ *
+ * Shortcut authors do NOT implement this interface directly. Instead, they call
+ * {@link defineShortcutType} with a simple config object, and it assembles the full
+ * handler and registers it in the global registry.
+ *
+ * Entry shape taxonomy:
+ *
+ * 1. Keyed entries — { key, def } — path derived from key
+ *    Used by: inputs, future select/radiogroup
+ *
+ * 2. Bare entries — decorator | callback directly
+ *    Used by: actions, calendar, displays
+ *
+ * 3. Compound entries — { def, children } — container with nested shortcuts
+ *    Used by: layouts, future tabs/accordion
+ *
+ * Each handler declares TEntry to match its shape.
+ * There is no shared base type — the shapes are intentionally different.
+ * parseEntry(entry: TEntry) is the type-safe boundary.
+ */
+export interface ItemTypeHandler<TEntry = any, TDecorator extends DxCommonFields = DxCommonFields, TConfig = Record<string, any>> {
+    rollUpSensibleDefaults(leafSelectors: GslLeafSelector[]): TConfig;
+    applySensibleDefaults(def: TDecorator, config: TConfig): TDecorator;
+    mapToWidget<StateKeys extends UiState = never, FormData extends Record<string, any> = any>(def: TDecorator): NonFunctionWidget<StateKeys, FormData>;
+    parseEntry(entry: TEntry): ParsedEntry<TDecorator>;
+    afterMerge?(mergeResult: MergeResult, context: AfterMergeContext): MergeResult;
+    /**
+     * Optional override for widget types that need custom construction beyond the
+     * generic mapToWidget path. Two flavors:
+     *
+     * - Compound types (layouts, accordion, tabs, repeater): use `context.walkChildren`
+     *   to recursively process child widgets and attach them to the result.
+     * - Custom rendering (displays): wrap a render function into a specialized widget
+     *   shape that the generic mapper can't produce.
+     *
+     * If not provided, the pipeline falls back to `mapToWidget` for simple leaf types.
+     */
+    buildCustomWidget?(mergeResult: MergeResult, context: BuildWidgetContext): FormWidget;
+    getChildren?(entry: TEntry): ValidGuiShortcut[] | undefined;
+}
+export declare function registerItemType(itemType: string, handler: ItemTypeHandler<any, any, any>): void;
+export declare function getItemTypeHandler(itemType: string): ItemTypeHandler<any, any, any>;
+export declare function hasItemTypeHandler(itemType: string): boolean;

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

@@ -0,0 +1,31 @@
+import { FormWidget, UiState } from '@golemui/core';
+import { FormConfig, GslSelector, ValidGuiShortcut } from './dx.domain';
+import { SelectorResolver } from './selectorResolver.service';
+import { WidgetMerger } from './widgetMerger.service';
+import { WidgetMapper } from './widgetMapper.service';
+import { EventRegistry } from './itemTypeRegistry';
+import { EventWiringService } from './eventWiring.service';
+import { StateExpansionService } from './stateExpansion.service';
+export interface WalkResult<StateKeys extends UiState = never, FormData extends Record<string, any> = any> {
+    widgets: FormWidget<StateKeys, FormData>[];
+    eventRegistry: EventRegistry;
+}
+export declare class ItemWalker {
+    private readonly resolver;
+    private readonly merger;
+    private readonly mapper;
+    private readonly eventWiring;
+    private readonly stateExpansion;
+    constructor(resolver: SelectorResolver, merger: WidgetMerger, mapper: WidgetMapper, eventWiring: EventWiringService, stateExpansion: StateExpansionService);
+    walkAndMap<StateKeys extends UiState = never, FormData extends Record<string, any> = any>(guiShortcuts: ValidGuiShortcut[], gslSelectors: GslSelector[], formConfig: FormConfig): WalkResult<StateKeys, FormData>;
+    private walkItems;
+    private processItem;
+    private buildCustomWidgetContext;
+    private buildCustomWidget;
+    /**
+     * Resolves the base definition from a parsed entry, injecting the path for keyed entries.
+     * For runtime (function) providers, wraps them to inject the path at evaluation time.
+     */
+    private buildBaseDef;
+    private buildDecoratorForMatching;
+}

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

@@ -0,0 +1,15 @@
+import { FormConfig, GslSelector, GslSelectorsInput } from './dx.domain';
+export declare class SelectorNormalizer {
+    /**
+     * Ensures the output is always a uniform GslSelector[] of aggregated selectors.
+     *
+     * Callers can pass flat leaf selectors (single styling rules) or pre-grouped
+     * aggregated selectors. This method separates them into two buckets, then wraps
+     * any bare leaves into a catch-all aggregated selector so downstream code only
+     * deals with one shape.
+     */
+    normalizeSelectors(input: GslSelectorsInput): GslSelector[];
+    extractFormConfig(): FormConfig;
+}
+declare const selectorNormalizer: SelectorNormalizer;
+export default selectorNormalizer;

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

@@ -0,0 +1,11 @@
+import { GslSelector, ResolvedSelectors } from './dx.domain';
+import { DxCommonFields, DxInternalFields } from './dxBase.types';
+type DecoratorForMatching = DxInternalFields & DxCommonFields;
+export declare class SelectorResolver {
+    resolve(decorator: DecoratorForMatching, allSelectors: GslSelector[]): ResolvedSelectors;
+    private collectFromAggregated;
+    private collectFromLeaf;
+    private rollUpSensibleDefaults;
+}
+declare const selectorResolver: SelectorResolver;
+export default selectorResolver;