@logimaxx/kgrid 0.2.3 → 0.4.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/dist/kgrid.min.js CHANGED
@@ -1,2 +1,2 @@
1
- /*! @logimaxx/kgrid | (c) Logimaxx System SRL — proprietary | https://logimaxx.ro | built 2026-07-30T15:53:29.364Z */
2
- !function(t){const e={log:function(){},onError:function(t){console.error(t)},confirm:function(t,e,n){"undefined"!=typeof window&&window.confirm(t)?e():n&&n()},deleteConfirm:null,serializeForm:function(t,e){const n=new FormData(t),r={};for(const[t,e]of n.entries())Object.prototype.hasOwnProperty.call(r,t)?(Array.isArray(r[t])||(r[t]=[r[t]]),r[t].push(e)):r[t]=e;return r},customInputTypes:null,fieldTypes:null,kviews:null,filterDebounceMs:300};t._config=Object.assign({},e),t.configure=function(e){return e&&"object"==typeof e&&Object.assign(t._config,e),"function"==typeof t._syncCustomInputTypes&&t._syncCustomInputTypes(),t},t.log=function(){t._config.log.apply(null,arguments)},t.onError=function(e){return t._config.onError(e)},t.confirm=function(e,n,r){return t._config.confirm(e,n,r)},t.DEFAULT_DELETE_CONFIRM_MESSAGE="Delete this record?",t._defaultDeleteConfirm=function(e,n,r){t.confirm(t.DEFAULT_DELETE_CONFIRM_MESSAGE,n,r)},t.runDeleteConfirm=function(e,n,r){const o=e.options&&"function"==typeof e.options.deleteConfirm?e.options.deleteConfirm:null,a="function"==typeof t._config.deleteConfirm?t._config.deleteConfirm:null;return(o||a||t._defaultDeleteConfirm)(e,n,r)},t.serializeForm=function(e,n){return t._config.serializeForm(e,n)},t.getKViews=function(e){const n=[e,t._config.kviews];for(let t=0;t<n.length;t++){const e=n[t];if(e&&"function"==typeof e.createCollectionInstance)return e}const r=("undefined"!=typeof window?window:"undefined"!=typeof globalThis?globalThis:{}).KViews;return r&&"function"==typeof r.createCollectionInstance?r:null},t.KVIEWS_MISSING_MSG="KGrid requires KViews: install peer @logimaxx/kviews, load it before kgrid.js (window.KViews), or call KGrid.configure({ kviews: KViews }). You can also pass kviews in table options: KGrid.init(host, { kviews, ... })."}(window.KGrid=window.KGrid||{}),function(t){t.protoOptions={url:null,type:null,filter:null,features:{filtering:!1,sorting:!1,paging:!1,create:!1,update:!1,delete:!1},defaultInteraction:"view",insertFormRow:{position:"top"},tableAttrs:{class:""},labelsRowAttrs:{},dataRowAttrs:{},filtersRowAttrs:null,pagingPageSizes:[10,25,50,75],pagingDefaultSize:10,emptyRowMessage:null,pagingFooterLabel:"records per page. Total"},t.protoColumnConfig={label:null,name:null,hidden:!1,class:null,columnClass:null,attrs:{},features:{create:!1,update:!1,filter:!1,sort:!1},display:{template:null,events:[]},input:null,insert:{type:"text",default:null,value:null,placeholder:null,disabled:!1,required:!1,options:null,events:[]},update:{type:"text",default:null,value:null,placeholder:null,disabled:!1,required:!1,options:null,template:null,events:[]},filter:{type:"text",operator:"~=~",default:null,placeholder:"",options:null,persist:!1,debounceMs:null}},t.VALID_NATIVE_INPUT_TYPES=["displayonly","text","textarea","number","date","datetime","time","checkbox","radio","file","password","email","url","search","tel","select","hidden"],t.VALID_INPUT_TYPES=t.VALID_NATIVE_INPUT_TYPES.slice(),t.VALID_NATIVE_FILTER_TYPES=t.VALID_NATIVE_INPUT_TYPES.filter(t=>"displayonly"!==t),t.VALID_FILTER_TYPES=t.VALID_NATIVE_FILTER_TYPES.concat(["multi_select","date_range"]),t.isValidInputType=function(e){return t.VALID_NATIVE_INPUT_TYPES.includes(e)||t.isPluggableFieldType(e)},t.isValidFilterType=function(e){return"displayonly"!==e&&(t.VALID_NATIVE_FILTER_TYPES.includes(e)||t.isPluggableFieldType(e))}}(window.KGrid=window.KGrid||{}),function(t){t.isPlainObject=function(t){return null!=t&&"object"==typeof t&&!Array.isArray(t)},t.setDefaultValues=function(e,n){const r={...e||{}};return Object.keys(n||{}).forEach(e=>{t.isPlainObject(n[e])&&t.isPlainObject(r[e])?r[e]=t.setDefaultValues(r[e],n[e]):t.isPlainObject(n[e])&&null==r[e]?r[e]=t.setDefaultValues({},n[e]):r[e]=n[e]}),r},t.normalizeColumnConfig=function(e){let n=e&&"object"==typeof e?{...e}:{};if(t.isPlainObject(n.input)){const e={...n.input};delete n.input,n.insert=t.setDefaultValues(e,n.insert||{}),n.update=t.setDefaultValues(e,n.update||{})}const r=t.setDefaultValues(t.protoColumnConfig,n);return null==r.class&&r.columnClass&&(r.class=r.columnClass),r.update&&"displayonly"===r.update.type&&!r.update.template&&r.display&&r.display.template&&(r.update.template=r.display.template),["display","insert","update"].forEach(t=>{r[t]&&"object"==typeof r[t]&&(Array.isArray(r[t].events)||(r[t].events=[]))}),r}}(window.KGrid),function(t){t.resolveHostElement=function(t){if(null==t)throw new TypeError("KGrid.init(host, opts): host is required");if("object"==typeof t&&t.jquery){if(!t.length)throw new Error("KGrid.init(host, opts): empty jQuery selection");return t}if("object"==typeof t&&1===t.nodeType&&"string"==typeof t.nodeName)return $(t);throw new TypeError("KGrid.init(host, opts): host must be a DOM Element or jQuery object")},t.uuid=function(){return Math.random().toString(36).substring(2,15)+Math.random().toString(36).substring(2,15)},t.hasActionColumn=function(t){const e=t&&t.features;return!!e&&!!(e.delete||e.update||e.create)},t.syncActionColumnColgroup=function(t,e,n){let r=t.children("colgroup.kgrid-colgroup");r.length||(r=$("<colgroup>").addClass("kgrid-colgroup").prependTo(t)),r.empty();for(let t=0;t<e;t++)r.append($("<col>"));n&&r.append($("<col>").addClass("kgrid-row-actions-col"))},t.anchorRowForm=function(t,e){if(!(t&&t.length&&e&&e.length))return t;t.attr("hidden","hidden").attr("aria-hidden","true");const n=e.children("td").first();return n.length&&t.prependTo(n),t},t.filterFormField=function(t,e){if(!t||!e)return $();const n=t.elements&&t.elements.namedItem(e);if(n)return $(n);if(t.id){const n=document.querySelector(`[form="${t.id}"][name="${e}"]`);if(n)return $(n)}return $()},t.columnClassName=function(t){if(!t)return null;const e=null!=t.class&&""!==t.class?t.class:t.columnClass;return null!=e&&""!==e?String(e):null},t.applyColumnCellMeta=function(e,n){if(!e||!e.length||!n)return e;n.name&&e.attr("data-name",n.name);const r=t.columnClassName(n);return r&&e.addClass(r),e}}(window.KGrid),function(t){t.DEFAULT_EMPTY_ROW_MESSAGE="No records match your search.",t.TABLE_SHELL_TEMPLATE='\n<table class="custom-table" style="table-layout: fixed;">\n <thead class="thead-labels">\n <tr>\n <th class="align-top">\n <a class="sort" data-sortfld="" style="cursor: pointer;">\n <span class="column-label"></span>\n <i class="fas fa-sort-up sort-up" style="display: none"></i>\n <i class="fas fa-sort-down sort-down" style="display: none"></i>\n <i class="fas fa-sort sort-default"></i>\n </a>\n </th>\n </tr>\n </thead>\n <thead class="thead-filters"></thead>\n <tbody class="before-main-tbody"></tbody>\n <tbody class="main-tbody"></tbody>\n <tbody class="after-main-tbody"></tbody>\n <tbody class="no-data-tbody">\n <tr><td>{{EMPTY_ROW_MESSAGE}}</td></tr>\n </tbody>\n <tfoot class="paging-footer">\n <tr>\n <td>\n <div class="btn-group pages" data-pagesize="{{PAGES_DATA_PAGESIZE}}">\n <button type="button" name="first" class="btn btn-sm btn-outline-secondary">&lt;&lt;</button>\n <button type="button" name="prev" class="btn btn-sm btn-outline-secondary">&lt;</button>\n <button type="button" name="page" class="btn btn-sm btn-outline-secondary">1</button>\n <button type="button" name="next" class="btn btn-sm btn-outline-secondary">&gt;</button>\n <button type="button" name="last" class="btn btn-sm btn-outline-secondary">&gt;&gt;</button>\n </div>\n <select class="pagesize">\n{{PAGE_SIZE_OPTIONS}}\n </select>\n {{PAGING_FOOTER_LABEL}} <span class="totalrecscount"></span>\n </td>\n </tr>\n </tfoot>\n</table>'.trim(),t._escapeTableShellText=function(t){return String(t).replace(/&/g,"&amp;").replace(/</g,"&lt;").replace(/>/g,"&gt;").replace(/"/g,"&quot;")},t._renderPageSizeOptions=function(t,e){return t.map(t=>{const n=String(t);return` <option value="${n}"${n===String(e)?" selected":""}>${n}</option>`}).join("\n")},t.renderTableShellHtml=function(e,n){const r=Array.isArray(e.pagingPageSizes)?e.pagingPageSizes:[10,25,50,75],o=null!=e.pagingDefaultSize?e.pagingDefaultSize:r[0],a=t._escapeTableShellText(e.emptyRowMessage||t.DEFAULT_EMPTY_ROW_MESSAGE),l=t._escapeTableShellText(e.pagingFooterLabel||"records per page. Total");return(n||t.TABLE_SHELL_TEMPLATE).replace(/\{\{EMPTY_ROW_MESSAGE\}\}/g,a).replace(/\{\{PAGES_DATA_PAGESIZE\}\}/g,String(o)).replace(/\{\{PAGE_SIZE_OPTIONS\}\}/g,t._renderPageSizeOptions(r,o)).replace(/\{\{PAGING_FOOTER_LABEL\}\}/g,l)},t.createTableShell=function(e){const n=t.renderTableShellHtml(e),r=$.parseHTML(n,document,!0),o=$(r).filter("table").first();if(!o.length)throw new Error("KGrid TABLE_SHELL_TEMPLATE must contain a root <table> element");return e.tableAttrs&&t.isPlainObject(e.tableAttrs)&&(Object.keys(e.tableAttrs).forEach(t=>{"class"!==t&&o.attr(t,e.tableAttrs[t])}),"string"==typeof e.tableAttrs.class&&e.tableAttrs.class&&o.addClass(e.tableAttrs.class)),o},t.mountTableShell=function(e,n){const r=e.find("table.custom-table, table").first();if(r.length)return r;const o=t.getTableInteractionHost(e);o.hasClass("custom-table-shell")||o.addClass("custom-table-shell");const a=t.createTableShell(n);return o.append(a),a}}(window.KGrid),function(t){t._fieldTypes=Object.create(null),t._configuredCustomInputTypeNames=[],t.registerFieldType=function(e,n,r){if(!e||"string"!=typeof e)throw new TypeError("registerFieldType(name, plugin): name must be a string");if(!n||"function"!=typeof n.create)throw new TypeError("registerFieldType("+e+"): plugin.create is required");if(t._fieldTypes[e]&&(!r||!r.overwrite))throw new Error("Field type already registered: "+e);return t._fieldTypes[e]=Object.assign({name:e},n),t},t.unregisterFieldType=function(e){return e&&t._fieldTypes[e]&&delete t._fieldTypes[e],t},t.getFieldType=function(e){return e&&t._fieldTypes[e]||null},t.listFieldTypes=function(){return Object.keys(t._fieldTypes)},t.createFieldInput=function({mode:e,col:n,config:r}){const o=r.type??"text",a=t.getFieldType(o);if(!a)return null;"function"==typeof a.validate&&a.validate(r,e,n);const l=a.create({mode:e,col:n,config:r});if(!l||!l.$input||!l.$input.length)throw new Error('Field type "'+o+'" create() must return { $input: jQuery }');return l.$input.attr("data-type",o),l},t.mountField=function(e){const n=e.config?.type??e.type,r=t.getFieldType(n);r&&"function"==typeof r.mount&&r.mount(e)},t.resolveFilterEvents=function({plugin:t,$input:e,createResult:n}){let r;return n&&Object.prototype.hasOwnProperty.call(n,"filterEvents")?r=n.filterEvents:t&&Object.prototype.hasOwnProperty.call(t,"filterEvents")&&(r=t.filterEvents),!1===r||null===r?null:"string"==typeof r&&r.trim()?r.trim():e.is("select")?"change":"input"},t.normalizeFilterDebounceMs=function(t,e){if(!1===t)return 0;if(void 0===t)return e;if(null===t)return e;const n=Number(t);return!Number.isFinite(n)||n<0?0:n},t.resolveFilterDebounceMs=function({filterConfig:e,plugin:n}){return e&&Object.prototype.hasOwnProperty.call(e,"debounceMs")&&null!==e.debounceMs?t.normalizeFilterDebounceMs(e.debounceMs,0):n&&Object.prototype.hasOwnProperty.call(n,"filterDebounceMs")&&null!==n.filterDebounceMs?t.normalizeFilterDebounceMs(n.filterDebounceMs,0):t.normalizeFilterDebounceMs(t._config.filterDebounceMs,0)},t.shouldDebounceFilterSubmit=function(t,e){return!(!e||e<=0)&&!!t},t.bindFieldFilterSubmit=function(e,n,r){const o=t.getFieldType(e);o&&"function"==typeof o.bindFilterSubmit&&o.bindFilterSubmit(n,r)},t.bindFilterInputEvents=function({type:e,$input:n,onSubmit:r,createResult:o,filterConfig:a}){const l=e?t.getFieldType(e):null,i=t.resolveFilterEvents({plugin:l,$input:n,createResult:o}),s=t.resolveFilterDebounceMs({filterConfig:a,plugin:l}),u=t.wrapFilterSubmitHandler(n,r,i,s);i&&n.on(i,u),t.bindFieldFilterSubmit(e,n,u)},t.isPluggableFieldType=function(e){return!!t.getFieldType(e)},t.inputType=function(t,e){if("function"!=typeof t)throw new TypeError("inputType(mount, opts): mount must be a function");if(!e||"string"!=typeof e.element)throw new TypeError("inputType(mount, opts): opts.element is required (HTML string)");return{filterEvents:e.filterEvents,filterDebounceMs:e.filterDebounceMs,validate:e.validate,create({mode:t}){const n=$(e.element);return!e.formInputClass||"insert"!==t&&"update"!==t||n.addClass(e.formInputClass),{$input:n,skipValueAttr:!!e.skipValueAttr}},mount(e){t(e.$input,e.config?.options??e.config,e)},bindFilterSubmit:e.bindFilterSubmit}},t._getCustomInputTypesConfig=function(){return t._config.customInputTypes??t._config.fieldTypes??null},t._syncCustomInputTypes=function(){const e=t._getCustomInputTypesConfig(),n=e&&"object"==typeof e?Object.keys(e).filter(t=>null!=e[t]):[];t._configuredCustomInputTypeNames.forEach(e=>{n.includes(e)||t.unregisterFieldType(e)}),n.forEach(n=>{const r=e[n];if(!r||"object"!=typeof r||"function"!=typeof r.create){if("function"==typeof r)throw new Error("customInputTypes."+n+' is a function — use a plugin, e.g. KGrid.select2(fn) or KGrid.inputType(fn, { element: "..." })');throw new TypeError("customInputTypes."+n+" must be a plugin with create()")}t.registerFieldType(n,r,{overwrite:!0})}),t._configuredCustomInputTypeNames=n.slice()}}(window.KGrid),function(t){t.registerFieldType("multi_select",{create({config:t}){const e=$("<select class='form-select form-select-sm' multiple>");return Array.isArray(t.options)&&t.options.forEach(t=>{$("<option>").text(t.label).attr("value",t.value).appendTo(e)}),{$input:e,skipValueAttr:!0}}}),t.registerFieldType("date_range",{create:()=>({$input:$("<input autocomplete='off' type='date' class='form-control form-control-sm'/>")})})}(window.KGrid),function(t){t.resolveDefaultInteraction=function(t){return"edit"===t.defaultInteraction||"view"===t.defaultInteraction?t.defaultInteraction:!0===t.editmode?"edit":(t.editmode,"view")},t.getTableInteractionHost=function(t){if(t.hasClass("custom-table-shell"))return t;const e=t.find(".custom-table-shell").first();return e.length?e:t},t.applyInteraction=function(e,n,r){const o=t.getTableInteractionHost(e),a="edit"===n?"edit":"view";o.attr("data-interaction",a),r&&"object"==typeof r?(void 0!==r.create&&o.attr("data-allow-insert",r.create?"true":"false"),void 0!==r.update&&o.attr("data-allow-update",r.update?"true":"false"),void 0!==r.delete&&o.attr("data-allow-delete",r.delete?"true":"false")):"edit"===a&&o.removeAttr("data-allow-insert data-allow-update data-allow-delete")}}(window.KGrid),function(t){t.setupLabelsHeader=function(e,n){const r=e.children("tr"),o=r.children(),a=o.first().clone(!0);o.remove();return[...n.columns].forEach(e=>{if(e.hidden)return;let n=a.clone(!0);if(e.attrs&&"object"==typeof e.attrs&&Object.keys(e.attrs).forEach(t=>n.attr(t,e.attrs[t])),t.applyColumnCellMeta(n,e),!e.features?.sort){const o=n.empty().html(e.label??"");return t.applyColumnCellMeta(o,e),void r.append(o)}if(!e.name)throw new Error("Column must have a name when column.sortable is true: \n"+JSON.stringify(e,null,2));n.find("span.column-label").text(e.label??""),n.children("a").attr("data-sortfld",e.name),n.appendTo(r)}),t.hasActionColumn(n)&&$("<th>").addClass("kgrid-row-actions").attr("aria-label","Actions").appendTo(r),r}}(window.KGrid),function(t){const e="kgridFilterDebounceTimer";t.cancelFilterSubmit=function(t){const n=t.data(e);n&&(clearTimeout(n),t.removeData(e))},t.cancelFilterDebounces=function(e){const n=$(e).attr("id");n&&$(document).find("[form='"+n+"']").each(function(){t.cancelFilterSubmit($(this))})},t.flushFilterSubmit=function(t){const n=t.data(e);if(!n)return;clearTimeout(n),t.removeData(e);const r=t[0]&&t[0].form;r&&$(r).trigger("submit")},t.wrapFilterSubmitHandler=function(n,r,o,a){if(!t.shouldDebounceFilterSubmit(o,a))return r;const l=a;return function(){t.cancelFilterSubmit(n);const o=setTimeout(function(){n.removeData(e),r.call(this)}.bind(this),l);n.data(e,o)}},t.filterDefaultValue=function(t){return null!=t&&"object"==typeof t&&null!=t.value?t.value:t},t.columnFilterPersisted=function(t){const e=t&&t.filter?t.filter:{};return!(!t||!t.hidden&&"hidden"!==e.type&&!e.persist)},t.ensureFilterField=function(t,e,n,r){if(!t||!e||null==n||""===n)return null;let o=t.elements&&t.elements.namedItem(e);return o&&null!=o.length&&!o.tagName&&(o=o[0]),o&&o.tagName||(o=document.createElement("input"),o.type="hidden",o.name=e,t.appendChild(o)),o.setAttribute("data-operator",r||"="),o.value=String(n),o.defaultValue=String(n),o},t.applyColumnDefaultFilters=function(e,n){e&&n&&n.forEach(function(n){if(!n.name||n.features&&!1===n.features.filter)return;const r=n.filter;if(!r||null==r.default||""===r.default)return;const o=t.filterDefaultValue(r.default);if(null==o||""===o)return;const a=r.operator||(t.columnFilterPersisted(n)?"=":"~=~"),l=t.filterFormField(e,n.name);!n.hidden&&"hidden"!==r.type&&l.length?l.val()||(l.val(String(o)),l.attr("data-operator",a)):t.ensureFilterField(e,n.name,o,a)})},t.setupDefaultFilters=function(e,n,r){const o=$(e)[0];if(!(o&&n&&n.features&&n.features.filtering))return;const a=n.columns||[];if(t.applyColumnDefaultFilters(o,a),a.some(t.columnFilterPersisted)){let e=!1;$(o).off("reset.kgridDefaultFilters").on("reset.kgridDefaultFilters",function(n){if(!e){n.preventDefault(),t.cancelFilterDebounces(o),e=!0;try{o.reset(),t.applyColumnDefaultFilters(o,a),r&&r.filtering&&"function"==typeof r.filtering.handleSubmit?r.filtering.handleSubmit(o):$(o).trigger("submit")}finally{e=!1}}})}if(!r||!r.filtering)return;const l=a.filter(function(e){return e.name&&e.filter&&null!=e.filter.default&&""!==e.filter.default&&t.columnFilterPersisted(e)});if(!l.length)return;const i=String(r.url&&r.url.parameters&&r.url.parameters.filter||"");l.some(function(t){return-1===i.indexOf(t.name+"=")})&&r.filtering.handleSubmit(o)},t.setupFilterHeader=function(e,n){if(!n.features||!n.features.filtering)return null;const r=e.find(".thead-filters");r.empty();const o=[...n.columns],a=$("<tr>");a.appendTo(r);const l="filter_form_"+t.uuid(),i=$("<form>").attr("id",l).attr("hidden","hidden").attr("aria-hidden","true").addClass("table-filter-form").insertBefore(e);return o.forEach(e=>{const n=e.filter||{};if(e.hidden||"hidden"===n.type){if(e.features&&!1===e.features.filter)return;if(!e.name)return;const r=t.filterDefaultValue(n.default);return void(null!=r&&""!==r?t.ensureFilterField(i[0],e.name,r,n.operator||"="):t.columnFilterPersisted(e)&&t.ensureFilterField(i[0],e.name,"",n.operator||"="))}let r,o=$("<th>").appendTo(a).attr("data-label",e.label);if(t.applyColumnCellMeta(o,e),!1===e.features.filter)return;if(!e.name)throw new Error("Column must have a name when column.features.filter is true: \n"+JSON.stringify(e,null,2));let s=null;const u=t.createFieldInput({mode:"filter",col:e,config:n});if(u)s=u,r=u.$input,r.appendTo(o),t.mountField({mode:"filter",$input:r,col:e,config:n});else if("select"===n.type){if(!n.options)throw new Error("Column must have a filter.options array when column.filter.type is select: \n"+JSON.stringify(e,null,2));if(r=$("<select>").addClass("form-select form-select-sm"),!Array.isArray(n.options))throw new Error("Column must have a filter.options array when column.filter.type is select: \n"+JSON.stringify(e,null,2));n.options.forEach(t=>{if(!t.label||"string"!=typeof t.value)throw new Error("Column must have an filter.options object with label and value when column.filter.type is select: \n"+JSON.stringify(e,null,2));$("<option>").text(t.label).attr("value",t.value).appendTo(r)}),r.appendTo(o)}else{if(!t.isValidFilterType(n.type))throw new Error("Unknown filter type: "+n.type);r=$(`<input autocomplete='off' type='${n.type}' class='form-control form-control-sm'/>`),r.appendTo(o)}r.attr("data-operator",n.operator),r.attr("form",l),r.attr("name",e.name);const c=t.filterDefaultValue(n.default);null==c||""===c||r.val()||(r.val(String(c)),r.attr("data-default",String(c)),r[0]&&(r[0].defaultValue=String(c)));t.bindFilterInputEvents({type:n.type,$input:r,onSubmit:function(){const t=this.form;t&&$(t).trigger("submit")},createResult:s,filterConfig:n})}),t.hasActionColumn(n)&&$("<th>").addClass("kgrid-row-actions").attr("data-label","Actions").appendTo(a),i},t.FilterForm=function(e){this.form=$(e)[0],this.filter=(e,n,r="~=~")=>{if(!this.form)return this;let o=t.filterFormField(this.form,e);if(o.length||(t.ensureFilterField(this.form,e,n,r),o=t.filterFormField(this.form,e)),!o.length)return this;t.flushFilterSubmit(o),o.val(n);const a=o.attr("data-operator");return o.attr("data-operator",r),$(this.form).trigger("submit"),o.attr("data-operator",a),this},this.ensure=(e,n,r="=")=>(t.ensureFilterField(this.form,e,n,r),this),this.reset=()=>(this.form&&(t.cancelFilterDebounces(this.form),this.form.reset()),this)}}(window.KGrid),function(t){t.setupCell=function(e,n){const r=n?n.attr("id"):null,o={...e},a=$("<td>").attr("data-label",e.label);t.applyColumnCellMeta(a,e);const l=o.attrs&&"object"==typeof o.attrs?o.attrs:{};Object.keys(l).forEach(t=>a.attr(t,l[t]));let i=$("<div>").addClass("cell-content");if(i.html(o.display.template??`{{${o.name}}}`),i.appendTo(a),null==n||!e.features.update)return i.clone(!0).removeClass("cell-content").addClass("cell-input").appendTo(a),a;if(!o.name)throw new Error("Column must have a name when column.features.update is true: \n"+JSON.stringify(e,null,2));const s=o.update,u=s.type??"text";let c,f=!1;const d=t.createFieldInput({mode:"update",col:e,config:s});if(d)c=d.$input,f=!!d.skipValueAttr;else{switch(u){case"textarea":c=$(`<textarea class='form-input form-control form-control-sm'>{{${s.value??o.name}}}</textarea>`),f=!0;break;case"select":if(c=$("<select class='form-input form-control form-control-sm'/>"),!Array.isArray(s.options))throw new Error("Select column must have an update.options array when column.features.update is true: \n"+JSON.stringify(e,null,2));s.options.forEach(t=>{if("string"!=typeof t.label||void 0===t.value)throw new Error("Select update.options entries need label and value: \n"+JSON.stringify(e,null,2));$("<option>").text(t.label).attr("value",t.value).appendTo(c)}),f=!0;break;case"hidden":c=$("<input type='hidden' class='form-input form-control form-control-sm'/>");break;case"displayonly":{const t=s.template||o.display.template||`{{${o.name}}}`;return $("<div>").addClass("cell-input").append(t).appendTo(a),a}default:if(!t.isValidInputType(u))throw new Error("Invalid update updateConfig type: "+JSON.stringify(s,null,2));c=$(`<input autocomplete='off' type='${u}' class='form-input form-control form-control-sm'/>`)}c.attr("data-type",u)}if(s.attrs&&"object"==typeof s.attrs&&Object.keys(s.attrs).forEach(t=>c.attr(t,s.attrs[t])),c.attr("form",r),c.attr("name",o.name),!f&&"textarea"!==u){const t=s.value??`{{${o.name}}}`;null!=t&&"object"!=typeof t&&c.attr("value",t)}return o.hidden?(c.attr("type","hidden").appendTo(n),a):(s.disabled&&c.attr("disabled",!0),s.readonly&&c.attr("readonly",!0),s.required&&c.attr("required",!0),s.attrs&&"object"==typeof s.attrs&&Object.keys(s.attrs).forEach(t=>c.attr(t,s.attrs[t])),s.disabled||s.readonly||c.attr("onchange","$(this).parents('tr').addClass('editing')"),$("<div>").addClass("cell-input").append(c).appendTo(a),a)}}(window.KGrid),function(t){t.setupNoDataTbody=function(t,e,n){const r=t.find("td").attr("colspan",n);return e.noDataTemplate&&r.html(e.noDataTemplate),r},t.setupDataBody=function(e,n,r,o,a,l){const i=[...n.columns],s=$("<tr>").appendTo(e);if(n.dataRowAttrs&&"object"!=typeof n.dataRowAttrs)throw new Error("options.dataRowAttrs must be an object");const u={...n.dataRowAttrs??{}};Object.keys(u).forEach(t=>s.attr(t,u[t])),e.data("emptyview",l),n?.features?.sorting&&e.data("sort",r),a&&e.data("paging",a.find(".pages")).data("pagesizeinp",a.find(".pagesize")).data("totalrecscount",a.find(".totalrecscount")),o&&e.data("filter",o),n.type&&e.data("type",n.type);const c="data_row_form_"+t.uuid()+"_{{this.id}}",f=n.features.update?$("<form class='edit-form table-row-form'>").attr("id",c):null;if(i.forEach(e=>{const n=t.setupCell(e,f);e.hidden||n.appendTo(s)}),t.hasActionColumn(n)){const t=$("<td>").addClass("kgrid-row-actions").appendTo(s);if(n.features.delete&&$("<div>").addClass("btn-group delete-item-grp").appendTo(t).append($("<button>").addClass("btn btn-sm btn-danger delete-item").attr("type","button").attr("title","Delete item").append("<i class='fas fa-trash'></i>")),n.features.update){const e=$("<div>").addClass("btn-group edit-item-grp").appendTo(t);$("<button>").addClass("btn btn-sm btn-success save-item").attr("type","submit").attr("name","save").attr("title","Save item").attr("form",c).html("<i class='fas fa-save'></i>").appendTo(e),$("<button>").addClass("btn btn-sm btn-secondary cancel-edit").attr("type","button").attr("name","cancel").attr("title","Cancel edit").attr("form",c).attr("onclick","$(this).parents('[data-type=item]').data().instance.loadFromRemote()").html("<i class='fas fa-undo'></i>").appendTo(e)}}return f&&t.anchorRowForm(f,s),e},t.setupPagingFooter=function(e,n,r){return t.log("setupPagingFooter",e,n,r),n.pagingFooterAttrs&&t.isPlainObject(n.pagingFooterAttrs)&&Object.keys(n.pagingFooterAttrs).forEach(t=>e.attr(t,n.pagingFooterAttrs[t])),t.log("noVisibleCols",r),e.find("td").attr("colspan",r),e}}(window.KGrid),function(t){t.setupNewRecordForm=function(e,n,r){if(!n.insertFormRow||!t.isPlainObject(n.insertFormRow))return e.find(".before-main-tbody").remove(),void e.find(".after-main-tbody").remove();const o=[...n.columns],a=$("<tr>").addClass("new-record-row");"top"===(n.insertFormRow?.position??"top")?(e.find(".after-main-tbody").remove(),a.appendTo(e.find(".before-main-tbody"))):(e.find(".before-main-tbody").remove(),a.appendTo(e.find(".after-main-tbody")));const l="new_record_row_form_"+t.uuid(),i=$("<form class='table-row-form'>").attr("id",l).off("submit").on("submit",e=>{e.preventDefault();const a=t.serializeForm(e.target,o);Object.keys(a).forEach(t=>{o.find(e=>e.name===t)?.insert?.dontsave&&delete a[t]}),r.instance.newItem(a).then(()=>{e.target.reset(),"function"==typeof n.onNewItemCreated&&n.onNewItemCreated(a)}).catch(t.onError)});o.forEach(e=>{if(e.hidden){if(n.features?.create&&e.features?.create){const t=$("<input type='hidden'>").attr("name",e.name).attr("form",l).appendTo(i);e.insert.default&&t.val(e.insert.default)}return}if(!e.features.create){const n=$("<td>").appendTo(a).attr("data-label",e.label);return void t.applyColumnCellMeta(n,e)}const r=e.insert;if(!r||!t.isPlainObject(r))throw new Error("Column must have an insert config object when column.features.create is true: \n"+JSON.stringify(e,null,2));if(!r.type)throw new Error("Column must have an insert.type when column.features.insert is true: \n"+JSON.stringify(e,null,2));let o;const s=r.type??"text",u=t.createFieldInput({mode:"insert",col:e,config:r});if(u)o=u.$input;else switch(s){case"textarea":o=$("<textarea class='form-input form-control form-control-sm'>");break;case"select":if(o=$("<select class='form-input form-control form-control-sm'/>"),!r.options||!Array.isArray(r.options))throw new Error("Column must have an insert.options array when column.features.insert is true: \n"+JSON.stringify(e,null,2));r.options.forEach(t=>{if("string"!=typeof t.label||void 0===t.value)throw new Error("Column must have an insert.options object with label and value when column.features.insert is true: \n"+JSON.stringify(e,null,2));$("<option>").text(t.label).attr("value",t.value).appendTo(o)});break;case"hidden":o=$("<input type='hidden' class='form-input form-control form-control-sm'/>");break;default:if(!t.isValidInputType(s))throw new Error("Invalid type: "+JSON.stringify(r,null,2));o=$(`<input autocomplete='off' type='${s}' class='form-input form-control form-control-sm'/>`),o.attr("data-type",s)}if(null!=r.default&&""!==r.default&&!o.val()){const t="object"==typeof r.default&&null!=r.default.value?r.default.value:r.default;String(t).trim()&&o.val(t).trigger("change")}if(r.attrs&&"object"==typeof r.attrs&&Object.keys(r.attrs).forEach(t=>o.attr(t,r.attrs[t])),o.attr("form",l).attr("name",e.name),r.disabled&&o.attr("disabled",!0),r.readonly&&o.attr("readonly",!0),r.required&&o.attr("required",!0),r.attrs&&"object"==typeof r.attrs&&Object.keys(r.attrs).forEach(t=>o.attr(t,r.attrs[t])),"hidden"!==r.type){const n=$("<td>").append(o).appendTo(a).attr("data-label",e.label);t.applyColumnCellMeta(n,e)}t.mountField({mode:"insert",$input:o,col:e,config:r,formEl:i[0],rowEl:a[0]}),r.events&&Array.isArray(r.events)&&r.events.forEach(t=>{o.off(t.event).on(t.event,function(e,...n){"function"==typeof t.callback&&t.callback(e,i[0],a[0],...n)})})}),t.anchorRowForm(i,a);const s=$("<td>").addClass("kgrid-row-actions").appendTo(a).attr("data-label","action"),u=$("<div>").addClass("btn-group").appendTo(s);return $("<button>").addClass("btn btn-sm btn-primary new-item-btn").html("<i class='fas fa-plus-square'></i>").attr("form",l).attr("type","submit").appendTo(u),"function"==typeof n.onInsertRowReady&&n.onInsertRowReady(i[0],a[0]),a}}(window.KGrid),function(t){t.setupEvents=function(e,n,r,o){const a=e.views[0];r.columns.forEach(n=>{n.display.events.forEach(t=>{if(!t.selector||!t.event||!t.callback)throw new Error("Invalid event: "+JSON.stringify(t,null,2));a.el.find(t.selector).off(t.event).on(t.event,n=>{if("function"!=typeof t.callback)throw new Error("Event callback must be a function: "+JSON.stringify(t,null,2));t.callback(n,e,a)})}),r.features.update&&n.update.events.forEach(r=>{if(!r.event||!r.callback)throw new Error("Invalid event: "+JSON.stringify(r,null,2));a.el.find("[name='"+n.name+"']").off(r.event).on(r.event,function(n,...o){if(t.log("event",r,n,this,o),"function"!=typeof r.callback)throw new Error("Event callback must be a function: "+JSON.stringify(r,null,2));r.callback(n,e,a,...o)})})}),r.features.update&&(a.el.find("[data-type]").each((n,r)=>{const l=r.getAttribute("data-type");if(!t.isPluggableFieldType(l))return;const i=o.get(r.name);i?.update&&t.mountField({mode:"update",$input:$(r),col:i,config:i.update,item:e,view:a})}),a.el.find("select[data-type='select']").each((t,n)=>{const r=o.get(n.name);if(!r)return;const a=e.attributes[r.name];null!=a&&""!==a&&$(n).val("boolean"==typeof a?String(a):a)}),a.el.find("form.edit-form").off("submit").on("submit",e=>{const n=e.target;e.preventDefault();const o=$(n).parents("[data-type=item]").data().instance,a=t.serializeForm(n);Object.keys(a).forEach(t=>{r.columns.find(e=>e.name===t)?.update?.dontsave&&delete a[t]}),o.update(a).catch(t.onError)})),r.features.delete&&a.el.find("button.delete-item").off("click").on("click",n=>{n.preventDefault(),a.el.addClass("confirm-delete");const o=()=>a.el.removeClass("confirm-delete");t.runDeleteConfirm({item:e,view:a,options:r},()=>{e.delete().catch(t.onError).finally(o)},o)}),"function"==typeof r.onRowFields&&r.onRowFields(e,a,n)}}(window.KGrid),function(t){t.init=async function(e,n){const r=t.resolveHostElement(e),o={...t.protoOptions,...n},a=t.mountTableShell(r,o);t.log("table config options",o);const l=t.resolveDefaultInteraction(o);t.applyInteraction(r,l);const i={$host:r,instance:null,filterForm:null,find:t=>r.find(t),setInteraction:(e,n)=>(t.applyInteraction(r,e,n),i),getInteraction:()=>"edit"===t.getTableInteractionHost(r).attr("data-interaction")?"edit":"view",setEditMode(t){if("boolean"!=typeof t)throw new TypeError("setEditMode(editMode) expects a boolean (true = edit, false = view)");return i.setInteraction(t?"edit":"view")},toggleEditMode:t=>(null!=t&&"object"==typeof t&&"function"==typeof t.preventDefault&&(t=void 0),"boolean"==typeof t?i.setInteraction(t?"edit":"view"):i.setInteraction("edit"===i.getInteraction()?"view":"edit"))};o.columns=o.columns.map(e=>t.normalizeColumnConfig(e));const s=o.handlers??{};delete o.handlers,o.columns.forEach(t=>{["insert","update","display"].forEach(e=>{const n=t[e].events;if(!n||!Array.isArray(n))throw new Error("Column "+t.name+" events are not an array");n.forEach(e=>{if("string"==typeof e.callback){const n=s[e.callback]||o.functions&&o.functions[e.callback];if(!n||"function"!=typeof n)throw new Error("Event callback function "+e.callback+" not found for column "+t.name+" or is not a function");e.callback=n}else if("function"!=typeof e.callback)throw new Error("Event callback must be a function for column "+t.name)})});const e=t.display;e&&e.events&&Array.isArray(e.events)&&e.events.forEach(t=>{if("string"==typeof t.callback){const e=s[t.callback]||o.functions&&o.functions[t.callback];e&&"function"==typeof e&&(t.callback=e)}})});const u=new Map;o.columns.forEach(t=>{u.set(t.name,t)});const c=t.setupLabelsHeader(a.find(".thead-labels"),o),f=t.hasActionColumn(o),d=c.find("th").length,p=d-(f?1:0);t.syncActionColumnColgroup(a,p,f);const m=o.filterForm??t.setupFilterHeader(a,o);let y;o.features&&o.features.paging?y=t.setupPagingFooter(a.find(".paging-footer"),o,d):(y=null,a.find(".paging-footer").remove());const b=t.setupNoDataTbody(a.find(".no-data-tbody"),o,d);o.features&&o.features.create&&t.setupNewRecordForm(a,o,i),i.filterForm=new t.FilterForm(m);const g=t.setupDataBody(a.find(".main-tbody"),o,c,m,y,b),h={dontload:!0,setAttrAsId:o.setAttrAsId??!1,itemListeners:{afterrender:e=>t.setupEvents(e,i.find("table"),o,u)}},w=t.getKViews(o.kviews);if(!w)throw new Error(t.KVIEWS_MISSING_MSG);if(i.instance=await w.createCollectionInstance(g,h),o.url){i.instance.setUrl(o.url),o.deleteUrl&&(t.log("set deleteUrl",o.deleteUrl),i.instance.setUrl(o.deleteUrl,"delete")),o.updateUrl&&(t.log("set updateUrl",o.updateUrl),i.instance.setUrl(o.updateUrl,"update")),o.insertUrl&&i.instance.setUrl(o.insertUrl,"insert");try{await i.instance.loadFromRemote()}catch(e){t.onError(e)}}else{if(!o.data||o.data.constructor!==Array)throw new Error("Invalid data: missing datasource url or data for table");{const t=o.data.map(t=>({attributes:t}));i.instance.loadFromData(t)}}return t.setupDefaultFilters(m,o,i.instance),i}}(window.KGrid);
1
+ /*! @logimaxx/kgrid | (c) Logimaxx System SRL — proprietary | https://logimaxx.ro | built 2026-09-02T08:17:18.911Z */
2
+ !function(e){function t(e){const t={},n=e&&e.elements;if(!n)return t;for(let e=0;e<n.length;e++){const r=n[e],o=r.name;if(!o||r.disabled)continue;const a=r.type;if("submit"===a||"button"===a||"reset"===a||"file"===a)continue;if("checkbox"===a){t[o]=r.checked?"1":"0";continue}if("radio"===a){if(!r.checked)continue;t[o]=r.value;continue}if("SELECT"===r.tagName&&r.multiple){t[o]=Array.from(r.selectedOptions).map(function(e){return e.value});continue}const i=r.value;Object.prototype.hasOwnProperty.call(t,o)?(Array.isArray(t[o])||(t[o]=[t[o]]),t[o].push(i)):t[o]=i}return t}e.isFlagOn=function(e){return!0===e||1===e||"1"===e},e.serializeFormDefault=t;const n={log:function(){},onError:function(e){console.error(e)},confirm:function(e,t,n){"undefined"!=typeof window&&window.confirm(e)?t():n&&n()},deleteConfirm:null,serializeForm:t,customInputTypes:null,fieldTypes:null,kviews:null,filterDebounceMs:300,preferencesStorage:null};e._config=Object.assign({},n),e.configure=function(t){return t&&"object"==typeof t&&Object.assign(e._config,t),"function"==typeof e._syncCustomInputTypes&&e._syncCustomInputTypes(),e},e.log=function(){e._config.log.apply(null,arguments)},e.onError=function(t){return e._config.onError(t)},e.confirm=function(t,n,r){return e._config.confirm(t,n,r)},e.DEFAULT_DELETE_CONFIRM_MESSAGE="Delete this record?",e._defaultDeleteConfirm=function(t,n,r){e.confirm(e.DEFAULT_DELETE_CONFIRM_MESSAGE,n,r)},e.runDeleteConfirm=function(t,n,r){const o=t.options&&"function"==typeof t.options.deleteConfirm?t.options.deleteConfirm:null,a="function"==typeof e._config.deleteConfirm?e._config.deleteConfirm:null;return(o||a||e._defaultDeleteConfirm)(t,n,r)},e.serializeForm=function(t,n){return e._config.serializeForm(t,n)},e.getKViews=function(t){const n=[t,e._config.kviews];for(let e=0;e<n.length;e++){const t=n[e];if(t&&"function"==typeof t.createCollectionInstance)return t}const r=("undefined"!=typeof window?window:"undefined"!=typeof globalThis?globalThis:{}).KViews;return r&&"function"==typeof r.createCollectionInstance?r:null},e.KVIEWS_MISSING_MSG="KGrid requires KViews: install peer @logimaxx/kviews, load it before kgrid.js (window.KViews), or call KGrid.configure({ kviews: KViews }). You can also pass kviews in table options: KGrid.init(host, { kviews, ... })."}(window.KGrid=window.KGrid||{}),function(e){e.protoOptions={url:null,type:null,filter:null,features:{filtering:!1,sorting:!1,paging:!1,create:!1,update:!1,delete:!1,clone:!1,columnChooser:!1},storageKey:null,filterStorageScope:null,columnChooserLabel:"Columns",columnChooserResetLabel:"Reset columns",defaultInteraction:"view",insertFormRow:{position:"top"},tableAttrs:{class:""},labelsRowAttrs:{},dataRowAttrs:{},filtersRowAttrs:null,pagingPageSizes:[10,25,50,75],pagingDefaultSize:10,emptyRowMessage:null,pagingFooterLabel:"records per page. Total"},e.protoColumnConfig={label:null,name:null,hidden:!1,locked:!1,userHidden:!1,class:null,columnClass:null,attrs:{},features:{create:!1,update:!1,filter:!1,sort:!1},display:{template:null,events:[]},input:null,insert:{type:"text",default:null,value:null,placeholder:null,disabled:!1,required:!1,options:null,events:[]},update:{type:"text",default:null,value:null,placeholder:null,disabled:!1,required:!1,options:null,template:null,events:[]},filter:{type:"text",operator:"~=~",default:null,placeholder:"",options:null,persist:!1,debounceMs:null}},e.VALID_NATIVE_INPUT_TYPES=["displayonly","text","textarea","number","date","datetime","time","checkbox","radio","file","password","email","url","search","tel","select","hidden"],e.VALID_INPUT_TYPES=e.VALID_NATIVE_INPUT_TYPES.slice(),e.VALID_NATIVE_FILTER_TYPES=e.VALID_NATIVE_INPUT_TYPES.filter(e=>"displayonly"!==e),e.VALID_FILTER_TYPES=e.VALID_NATIVE_FILTER_TYPES.concat(["multi_select","date_range"]),e.isValidInputType=function(t){return e.VALID_NATIVE_INPUT_TYPES.includes(t)||e.isPluggableFieldType(t)},e.isValidFilterType=function(t){return"displayonly"!==t&&(e.VALID_NATIVE_FILTER_TYPES.includes(t)||e.isPluggableFieldType(t))}}(window.KGrid=window.KGrid||{}),function(e){e.isPlainObject=function(e){return null!=e&&"object"==typeof e&&!Array.isArray(e)},e.setDefaultValues=function(t,n){const r={...t||{}};return Object.keys(n||{}).forEach(t=>{e.isPlainObject(n[t])&&e.isPlainObject(r[t])?r[t]=e.setDefaultValues(r[t],n[t]):e.isPlainObject(n[t])&&null==r[t]?r[t]=e.setDefaultValues({},n[t]):r[t]=n[t]}),r},e.normalizeColumnConfig=function(t){let n=t&&"object"==typeof t?{...t}:{};if(e.isPlainObject(n.input)){const t={...n.input};delete n.input,n.insert=e.setDefaultValues(t,n.insert||{}),n.update=e.setDefaultValues(t,n.update||{})}const r=e.setDefaultValues(e.protoColumnConfig,n);return null==r.class&&r.columnClass&&(r.class=r.columnClass),r.update&&"displayonly"===r.update.type&&!r.update.template&&r.display&&r.display.template&&(r.update.template=r.display.template),["display","insert","update"].forEach(e=>{r[e]&&"object"==typeof r[e]&&(Array.isArray(r[e].events)||(r[e].events=[]))}),r}}(window.KGrid),function(e){e.resolveHostElement=function(e){if(null==e)throw new TypeError("KGrid.init(host, opts): host is required");if("object"==typeof e&&e.jquery){if(!e.length)throw new Error("KGrid.init(host, opts): empty jQuery selection");return e}if("object"==typeof e&&1===e.nodeType&&"string"==typeof e.nodeName)return $(e);throw new TypeError("KGrid.init(host, opts): host must be a DOM Element or jQuery object")},e.uuid=function(){return Math.random().toString(36).substring(2,15)+Math.random().toString(36).substring(2,15)},e.hasActionColumn=function(e){const t=e&&e.features;return!!t&&!!(t.delete||t.update||t.create||t.clone)},e.actionColumnWidth=function(e){const t=e&&e.features||{},n=(t.clone?1:0)+(t.delete?1:0),r=t.update?2:0,o=t.create?1:0;return(2.5*Math.max(n,r,o,1)+.75).toFixed(2)+"rem"},e.syncActionColumnColgroup=function(t,n,r,o,a){let i=t.children("colgroup.kgrid-colgroup");i.length||(i=$("<colgroup>").addClass("kgrid-colgroup").prependTo(t)),i.empty();const l=Array.isArray(a)?a:null;if(l&&l.length)l.forEach(function(e){const t=$("<col>");e&&e.name&&t.attr("data-name",e.name),e&&e.userHidden&&t.addClass("kgrid-user-hidden"),i.append(t)});else for(let e=0;e<n;e++)i.append($("<col>"));r&&i.append($("<col>").addClass("kgrid-row-actions-col").css("width",e.actionColumnWidth(o)))},e.anchorRowForm=function(e,t){if(!(e&&e.length&&t&&t.length))return e;e.attr("hidden","hidden").attr("aria-hidden","true");const n=t.children("td").first();return n.length&&e.prependTo(n),e},e.filterFormField=function(e,t){if(!e||!t)return $();const n=e.elements&&e.elements.namedItem(t);if(n)return $(n);if(e.id){const n=document.querySelector(`[form="${e.id}"][name="${t}"]`);if(n)return $(n)}return $()},e.columnClassName=function(e){if(!e)return null;const t=null!=e.class&&""!==e.class?e.class:e.columnClass;return null!=t&&""!==t?String(t):null},e.applyColumnCellMeta=function(t,n){if(!t||!t.length||!n)return t;n.name&&t.attr("data-name",n.name);const r=e.columnClassName(n);return r&&t.addClass(r),t.toggleClass("kgrid-user-hidden",!!n.userHidden),t}}(window.KGrid),function(e){e.DEFAULT_EMPTY_ROW_MESSAGE="No records match your search.",e.TABLE_SHELL_TEMPLATE='\n<table class="custom-table" style="table-layout: fixed;">\n <thead class="thead-labels">\n <tr>\n <th class="align-top">\n <a class="sort" data-sortfld="" style="cursor: pointer;">\n <span class="column-label"></span>\n <i class="fas fa-sort-up sort-up" style="display: none"></i>\n <i class="fas fa-sort-down sort-down" style="display: none"></i>\n <i class="fas fa-sort sort-default"></i>\n </a>\n </th>\n </tr>\n </thead>\n <thead class="thead-filters"></thead>\n <tbody class="before-main-tbody"></tbody>\n <tbody class="main-tbody"></tbody>\n <tbody class="after-main-tbody"></tbody>\n <tbody class="no-data-tbody">\n <tr><td>{{EMPTY_ROW_MESSAGE}}</td></tr>\n </tbody>\n <tfoot class="paging-footer">\n <tr>\n <td>\n <div class="btn-group pages" data-pagesize="{{PAGES_DATA_PAGESIZE}}">\n <button type="button" name="first" class="btn btn-sm btn-outline-secondary">&lt;&lt;</button>\n <button type="button" name="prev" class="btn btn-sm btn-outline-secondary">&lt;</button>\n <button type="button" name="page" class="btn btn-sm btn-outline-secondary">1</button>\n <button type="button" name="next" class="btn btn-sm btn-outline-secondary">&gt;</button>\n <button type="button" name="last" class="btn btn-sm btn-outline-secondary">&gt;&gt;</button>\n </div>\n <select class="pagesize">\n{{PAGE_SIZE_OPTIONS}}\n </select>\n {{PAGING_FOOTER_LABEL}} <span class="totalrecscount"></span>\n </td>\n </tr>\n </tfoot>\n</table>'.trim(),e._escapeTableShellText=function(e){return String(e).replace(/&/g,"&amp;").replace(/</g,"&lt;").replace(/>/g,"&gt;").replace(/"/g,"&quot;")},e._renderPageSizeOptions=function(e,t){return e.map(e=>{const n=String(e);return` <option value="${n}"${n===String(t)?" selected":""}>${n}</option>`}).join("\n")},e.renderTableShellHtml=function(t,n){const r=Array.isArray(t.pagingPageSizes)?t.pagingPageSizes:[10,25,50,75],o=null!=t.pagingDefaultSize?t.pagingDefaultSize:r[0],a=e._escapeTableShellText(t.emptyRowMessage||e.DEFAULT_EMPTY_ROW_MESSAGE),i=e._escapeTableShellText(t.pagingFooterLabel||"records per page. Total");return(n||e.TABLE_SHELL_TEMPLATE).replace(/\{\{EMPTY_ROW_MESSAGE\}\}/g,a).replace(/\{\{PAGES_DATA_PAGESIZE\}\}/g,String(o)).replace(/\{\{PAGE_SIZE_OPTIONS\}\}/g,e._renderPageSizeOptions(r,o)).replace(/\{\{PAGING_FOOTER_LABEL\}\}/g,i)},e.createTableShell=function(t){const n=e.renderTableShellHtml(t),r=$.parseHTML(n,document,!0),o=$(r).filter("table").first();if(!o.length)throw new Error("KGrid TABLE_SHELL_TEMPLATE must contain a root <table> element");return t.tableAttrs&&e.isPlainObject(t.tableAttrs)&&(Object.keys(t.tableAttrs).forEach(e=>{"class"!==e&&o.attr(e,t.tableAttrs[e])}),"string"==typeof t.tableAttrs.class&&t.tableAttrs.class&&o.addClass(t.tableAttrs.class)),o},e.mountTableShell=function(t,n){const r=t.find("table.custom-table, table").first();if(r.length)return r;const o=e.getTableInteractionHost(t);o.hasClass("custom-table-shell")||o.addClass("custom-table-shell");const a=e.createTableShell(n);return o.append(a),a}}(window.KGrid),function(e){e._fieldTypes=Object.create(null),e._configuredCustomInputTypeNames=[],e.registerFieldType=function(t,n,r){if(!t||"string"!=typeof t)throw new TypeError("registerFieldType(name, plugin): name must be a string");if(!n||"function"!=typeof n.create)throw new TypeError("registerFieldType("+t+"): plugin.create is required");if(e._fieldTypes[t]&&(!r||!r.overwrite))throw new Error("Field type already registered: "+t);return e._fieldTypes[t]=Object.assign({name:t},n),e},e.unregisterFieldType=function(t){return t&&e._fieldTypes[t]&&delete e._fieldTypes[t],e},e.getFieldType=function(t){return t&&e._fieldTypes[t]||null},e.listFieldTypes=function(){return Object.keys(e._fieldTypes)},e.createFieldInput=function({mode:t,col:n,config:r}){const o=r.type??"text",a=e.getFieldType(o);if(!a)return null;"function"==typeof a.validate&&a.validate(r,t,n);const i=a.create({mode:t,col:n,config:r});if(!i||!i.$input||!i.$input.length)throw new Error('Field type "'+o+'" create() must return { $input: jQuery }');return i.$input.attr("data-type",o),i},e.mountField=function(t){const n=t.config?.type??t.type,r=e.getFieldType(n);r&&"function"==typeof r.mount&&r.mount(t)},e.resolveFilterEvents=function({plugin:e,$input:t,createResult:n}){let r;return n&&Object.prototype.hasOwnProperty.call(n,"filterEvents")?r=n.filterEvents:e&&Object.prototype.hasOwnProperty.call(e,"filterEvents")&&(r=e.filterEvents),!1===r||null===r?null:"string"==typeof r&&r.trim()?r.trim():t.is("select")?"change":"input"},e.normalizeFilterDebounceMs=function(e,t){if(!1===e)return 0;if(void 0===e)return t;if(null===e)return t;const n=Number(e);return!Number.isFinite(n)||n<0?0:n},e.resolveFilterDebounceMs=function({filterConfig:t,plugin:n}){return t&&Object.prototype.hasOwnProperty.call(t,"debounceMs")&&null!==t.debounceMs?e.normalizeFilterDebounceMs(t.debounceMs,0):n&&Object.prototype.hasOwnProperty.call(n,"filterDebounceMs")&&null!==n.filterDebounceMs?e.normalizeFilterDebounceMs(n.filterDebounceMs,0):e.normalizeFilterDebounceMs(e._config.filterDebounceMs,0)},e.shouldDebounceFilterSubmit=function(e,t){return!(!t||t<=0)&&!!e},e.bindFieldFilterSubmit=function(t,n,r){const o=e.getFieldType(t);o&&"function"==typeof o.bindFilterSubmit&&o.bindFilterSubmit(n,r)},e.bindFilterInputEvents=function({type:t,$input:n,onSubmit:r,createResult:o,filterConfig:a}){const i=t?e.getFieldType(t):null,l=e.resolveFilterEvents({plugin:i,$input:n,createResult:o}),s=e.resolveFilterDebounceMs({filterConfig:a,plugin:i}),u=e.wrapFilterSubmitHandler(n,r,l,s);l&&n.on(l,u),e.bindFieldFilterSubmit(t,n,u)},e.isPluggableFieldType=function(t){return!!e.getFieldType(t)},e.inputType=function(e,t){if("function"!=typeof e)throw new TypeError("inputType(mount, opts): mount must be a function");if(!t||"string"!=typeof t.element)throw new TypeError("inputType(mount, opts): opts.element is required (HTML string)");return{filterEvents:t.filterEvents,filterDebounceMs:t.filterDebounceMs,validate:t.validate,create({mode:e}){const n=$(t.element);return!t.formInputClass||"insert"!==e&&"update"!==e||n.addClass(t.formInputClass),{$input:n,skipValueAttr:!!t.skipValueAttr}},mount(t){e(t.$input,t.config?.options??t.config,t)},bindFilterSubmit:t.bindFilterSubmit}},e._getCustomInputTypesConfig=function(){return e._config.customInputTypes??e._config.fieldTypes??null},e._syncCustomInputTypes=function(){const t=e._getCustomInputTypesConfig(),n=t&&"object"==typeof t?Object.keys(t).filter(e=>null!=t[e]):[];e._configuredCustomInputTypeNames.forEach(t=>{n.includes(t)||e.unregisterFieldType(t)}),n.forEach(n=>{const r=t[n];if(!r||"object"!=typeof r||"function"!=typeof r.create){if("function"==typeof r)throw new Error("customInputTypes."+n+' is a function — use a plugin, e.g. KGrid.select2(fn) or KGrid.inputType(fn, { element: "..." })');throw new TypeError("customInputTypes."+n+" must be a plugin with create()")}e.registerFieldType(n,r,{overwrite:!0})}),e._configuredCustomInputTypeNames=n.slice()}}(window.KGrid),function(e){e.registerFieldType("multi_select",{create({config:e}){const t=$("<select class='form-select form-select-sm' multiple>");return Array.isArray(e.options)&&e.options.forEach(e=>{$("<option>").text(e.label).attr("value",e.value).appendTo(t)}),{$input:t,skipValueAttr:!0}}}),e.registerFieldType("date_range",{create:()=>({$input:$("<input autocomplete='off' type='date' class='form-control form-control-sm'/>")})})}(window.KGrid),function(e){e.resolveDefaultInteraction=function(e){return"edit"===e.defaultInteraction||"view"===e.defaultInteraction?e.defaultInteraction:!0===e.editmode?"edit":(e.editmode,"view")},e.getTableInteractionHost=function(e){if(e.hasClass("custom-table-shell"))return e;const t=e.find(".custom-table-shell").first();return t.length?t:e},e.applyInteraction=function(t,n,r){const o=e.getTableInteractionHost(t),a="edit"===n?"edit":"view";o.attr("data-interaction",a),r&&"object"==typeof r?(void 0!==r.create&&o.attr("data-allow-insert",r.create?"true":"false"),void 0!==r.update&&o.attr("data-allow-update",r.update?"true":"false"),void 0!==r.delete&&o.attr("data-allow-delete",r.delete?"true":"false"),void 0!==r.clone&&o.attr("data-allow-clone",r.clone?"true":"false")):"edit"===a&&o.removeAttr("data-allow-insert data-allow-update data-allow-delete data-allow-clone")}}(window.KGrid),function(e){e.setupLabelsHeader=function(t,n){const r=t.children("tr"),o=r.children(),a=o.first().clone(!0);o.remove();return[...n.columns].forEach(t=>{if(t.hidden)return;let n=a.clone(!0);if(t.attrs&&"object"==typeof t.attrs&&Object.keys(t.attrs).forEach(e=>n.attr(e,t.attrs[e])),e.applyColumnCellMeta(n,t),!t.features?.sort){const o=n.empty().html(t.label??"");return e.applyColumnCellMeta(o,t),void r.append(o)}if(!t.name)throw new Error("Column must have a name when column.sortable is true: \n"+JSON.stringify(t,null,2));n.find("span.column-label").text(t.label??""),n.children("a").attr("data-sortfld",t.name),n.appendTo(r)}),e.hasActionColumn(n)&&$("<th>").addClass("kgrid-row-actions").attr("aria-label","Actions").appendTo(r),r}}(window.KGrid),function(e){const t="kgridFilterDebounceTimer";e.cancelFilterSubmit=function(e){const n=e.data(t);n&&(clearTimeout(n),e.removeData(t))},e.cancelFilterDebounces=function(t){const n=$(t).attr("id");n&&$(document).find("[form='"+n+"']").each(function(){e.cancelFilterSubmit($(this))})},e.flushFilterSubmit=function(e){const n=e.data(t);if(!n)return;clearTimeout(n),e.removeData(t);const r=e[0]&&e[0].form;r&&$(r).trigger("submit")},e.wrapFilterSubmitHandler=function(n,r,o,a){if(!e.shouldDebounceFilterSubmit(o,a))return r;const i=a;return function(){e.cancelFilterSubmit(n);const o=setTimeout(function(){n.removeData(t),r.call(this)}.bind(this),i);n.data(t,o)}},e.filterDefaultValue=function(e){return null!=e&&"object"==typeof e&&null!=e.value?e.value:e},e.columnFilterPersisted=function(e){const t=e&&e.filter?e.filter:{};return!(!e||!e.hidden&&"hidden"!==t.type&&!t.persist)},e.ensureFilterField=function(e,t,n,r){if(!e||!t||null==n||""===n)return null;let o=e.elements&&e.elements.namedItem(t);return o&&null!=o.length&&!o.tagName&&(o=o[0]),o&&o.tagName||(o=document.createElement("input"),o.type="hidden",o.name=t,e.appendChild(o)),o.setAttribute("data-operator",r||"="),o.value=String(n),o.defaultValue=String(n),o},e.applyColumnDefaultFilters=function(t,n){t&&n&&n.forEach(function(n){if(!n.name||n.features&&!1===n.features.filter)return;const r=n.filter;if(!r||null==r.default||""===r.default)return;const o=e.filterDefaultValue(r.default);if(null==o||""===o)return;const a=r.operator||(e.columnFilterPersisted(n)?"=":"~=~"),i=e.filterFormField(t,n.name);!n.hidden&&"hidden"!==r.type&&i.length?i.val()||(i.val(String(o)),i.attr("data-operator",a)):e.ensureFilterField(t,n.name,o,a)})},e.setupDefaultFilters=function(t,n,r,o){const a=$(t)[0];if(!(a&&n&&n.features&&n.features.filtering))return;const i=n.columns||[];if(e.applyColumnDefaultFilters(a,i),i.some(e.columnFilterPersisted)){let t=!1;$(a).off("reset.kgridDefaultFilters").on("reset.kgridDefaultFilters",function(n){if(!t){n.preventDefault(),e.cancelFilterDebounces(a),t=!0;try{a.reset(),e.applyColumnDefaultFilters(a,i),r&&r.filtering&&"function"==typeof r.filtering.handleSubmit?r.filtering.handleSubmit(a):$(a).trigger("submit")}finally{t=!1}}})}if(!r||!r.filtering)return;const l=i.filter(function(t){return t.name&&t.filter&&null!=t.filter.default&&""!==t.filter.default&&e.columnFilterPersisted(t)});if(!l.length)return;const s=String(r.url&&r.url.parameters&&r.url.parameters.filter||"");!l.some(function(e){return-1===s.indexOf(e.name+"=")})||o&&o.skipInitSubmit||r.filtering.handleSubmit(a)},e.setupFilterHeader=function(t,n){if(!n.features||!n.features.filtering)return null;const r=t.find(".thead-filters");r.empty();const o=[...n.columns],a=$("<tr>");a.appendTo(r);const i="filter_form_"+e.uuid(),l=$("<form>").attr("id",i).attr("hidden","hidden").attr("aria-hidden","true").addClass("table-filter-form").insertBefore(t);return o.forEach(t=>{const n=t.filter||{};if(t.hidden||"hidden"===n.type){if(t.features&&!1===t.features.filter)return;if(!t.name)return;const r=e.filterDefaultValue(n.default);return void(null!=r&&""!==r?e.ensureFilterField(l[0],t.name,r,n.operator||"="):e.columnFilterPersisted(t)&&e.ensureFilterField(l[0],t.name,"",n.operator||"="))}let r,o=$("<th>").appendTo(a).attr("data-label",t.label);if(e.applyColumnCellMeta(o,t),!1===t.features.filter)return;if(!t.name)throw new Error("Column must have a name when column.features.filter is true: \n"+JSON.stringify(t,null,2));let s=null;const u=e.createFieldInput({mode:"filter",col:t,config:n});if(u)s=u,r=u.$input,r.appendTo(o),e.mountField({mode:"filter",$input:r,col:t,config:n});else if("select"===n.type){if(!n.options)throw new Error("Column must have a filter.options array when column.filter.type is select: \n"+JSON.stringify(t,null,2));if(r=$("<select>").addClass("form-select form-select-sm"),!Array.isArray(n.options))throw new Error("Column must have a filter.options array when column.filter.type is select: \n"+JSON.stringify(t,null,2));n.options.forEach(e=>{if(!e.label||"string"!=typeof e.value)throw new Error("Column must have an filter.options object with label and value when column.filter.type is select: \n"+JSON.stringify(t,null,2));$("<option>").text(e.label).attr("value",e.value).appendTo(r)}),r.appendTo(o)}else{if(!e.isValidFilterType(n.type))throw new Error("Unknown filter type: "+n.type);r=$(`<input autocomplete='off' type='${n.type}' class='form-control form-control-sm'/>`),r.appendTo(o)}r.attr("data-operator",n.operator),r.attr("form",i),r.attr("name",t.name);const c=e.filterDefaultValue(n.default);null==c||""===c||r.val()||(r.val(String(c)),r.attr("data-default",String(c)),r[0]&&(r[0].defaultValue=String(c)));e.bindFilterInputEvents({type:n.type,$input:r,onSubmit:function(){const e=this.form;e&&$(e).trigger("submit")},createResult:s,filterConfig:n})}),e.hasActionColumn(n)&&$("<th>").addClass("kgrid-row-actions").attr("data-label","Actions").appendTo(a),l},e.syncFormFiltersToCollectionUrl=function(e,t){if(!e||!t||!t.url)return;t.url.parameters||(t.url.parameters={});const n=[],r=e.elements;if(r){for(let e=0;e<r.length;e++){const t=r[e];if(!t||!t.name)continue;const o=$(t),a=o.val();if(null==a||""===a)continue;const i=o.attr("data-operator")||o.data("operator")||"=";n.push(t.name+i+a)}t.offset=0,n.length?t.url.parameters.filter=n.join(","):delete t.url.parameters.filter}},e.FilterForm=function(t){this.form=$(t)[0],this.filter=(t,n,r="~=~")=>{if(!this.form)return this;let o=e.filterFormField(this.form,t);if(o.length||(e.ensureFilterField(this.form,t,n,r),o=e.filterFormField(this.form,t)),!o.length)return this;e.flushFilterSubmit(o),o.val(n);const a=o.attr("data-operator");return o.attr("data-operator",r),$(this.form).trigger("submit"),o.attr("data-operator",a),this},this.ensure=(t,n,r="=")=>(e.ensureFilterField(this.form,t,n,r),this),this.reset=()=>(this.form&&(e.cancelFilterDebounces(this.form),this.form.reset()),this)}}(window.KGrid),function(e){e.wrapFlagSwitch=function(e){return e.attr({type:"checkbox",role:"switch",value:"1"}).removeClass("form-control form-input form-control-sm").addClass("form-check-input"),$("<div class='form-check form-switch kgrid-flag-switch mb-0'>").append(e)},e.setupCell=function(t,n){const r=n?n.attr("id"):null,o={...t},a=$("<td>").attr("data-label",t.label);e.applyColumnCellMeta(a,t);const i=o.attrs&&"object"==typeof o.attrs?o.attrs:{};Object.keys(i).forEach(e=>a.attr(e,i[e]));let l=$("<div>").addClass("cell-content");if(l.html(o.display.template??`{{${o.name}}}`),l.appendTo(a),null==n||!t.features.update)return l.clone(!0).removeClass("cell-content").addClass("cell-input").appendTo(a),a;if(!o.name)throw new Error("Column must have a name when column.features.update is true: \n"+JSON.stringify(t,null,2));const s=o.update,u=s.type??"text";let c,f=!1;const d=e.createFieldInput({mode:"update",col:t,config:s});if(d)c=d.$input,f=!!d.skipValueAttr;else{switch(u){case"textarea":c=$(`<textarea class='form-input form-control form-control-sm'>{{${s.value??o.name}}}</textarea>`),f=!0;break;case"select":if(c=$("<select class='form-input form-control form-control-sm'/>"),!Array.isArray(s.options))throw new Error("Select column must have an update.options array when column.features.update is true: \n"+JSON.stringify(t,null,2));s.options.forEach(e=>{if("string"!=typeof e.label||void 0===e.value)throw new Error("Select update.options entries need label and value: \n"+JSON.stringify(t,null,2));$("<option>").text(e.label).attr("value",e.value).appendTo(c)}),f=!0;break;case"hidden":c=$("<input type='hidden' class='form-input form-control form-control-sm'/>");break;case"displayonly":{const e=s.template||o.display.template||`{{${o.name}}}`;return $("<div>").addClass("cell-input").append(e).appendTo(a),a}case"checkbox":c=$("<input autocomplete='off' type='checkbox' class='form-check-input'/>"),f=!0;break;default:if(!e.isValidInputType(u))throw new Error("Invalid update updateConfig type: "+JSON.stringify(s,null,2));c=$(`<input autocomplete='off' type='${u}' class='form-input form-control form-control-sm'/>`)}c.attr("data-type",u)}if(s.attrs&&"object"==typeof s.attrs&&Object.keys(s.attrs).forEach(e=>c.attr(e,s.attrs[e])),c.attr("form",r),c.attr("name",o.name),!f&&"textarea"!==u){const e=s.value??`{{${o.name}}}`;null!=e&&"object"!=typeof e&&c.attr("value",e)}if(o.hidden)return c.attr("type","hidden").appendTo(n),a;s.disabled&&c.attr("disabled",!0),s.readonly&&c.attr("readonly",!0),s.required&&c.attr("required",!0),s.attrs&&"object"==typeof s.attrs&&Object.keys(s.attrs).forEach(e=>c.attr(e,s.attrs[e])),s.disabled||s.readonly||c.attr("onchange","$(this).parents('tr').addClass('editing')");const p="checkbox"===u?e.wrapFlagSwitch(c):c;return $("<div>").addClass("cell-input").append(p).appendTo(a),a}}(window.KGrid),function(e){e.setupNoDataTbody=function(e,t,n){const r=e.find("td").attr("colspan",n);return t.noDataTemplate&&r.html(t.noDataTemplate),r},e.fillDataRow=function(t,n){const r=[...n.columns],o="data_row_form_"+e.uuid()+"_{{this.id}}",a=n.features&&n.features.update?$("<form class='edit-form table-row-form'>").attr("id",o):null;if(r.forEach(n=>{const r=e.setupCell(n,a);n.hidden||r.appendTo(t)}),e.hasActionColumn(n)){const e=$("<td>").addClass("kgrid-row-actions").appendTo(t);if(n.features.clone&&$("<div>").addClass("btn-group clone-item-grp").appendTo(e).append($("<button>").addClass("btn btn-sm btn-outline-secondary clone-item").attr("type","button").attr("title","Clone item").append("<i class='fa-regular fa-copy'></i>")),n.features.delete&&$("<div>").addClass("btn-group delete-item-grp").appendTo(e).append($("<button>").addClass("btn btn-sm btn-danger delete-item").attr("type","button").attr("title","Delete item").append("<i class='fas fa-trash'></i>")),n.features.update){const t=$("<div>").addClass("btn-group edit-item-grp").appendTo(e);$("<button>").addClass("btn btn-sm btn-success save-item").attr("type","submit").attr("name","save").attr("title","Save item").attr("form",o).html("<i class='fas fa-save'></i>").appendTo(t),$("<button>").addClass("btn btn-sm btn-secondary cancel-edit").attr("type","button").attr("name","cancel").attr("title","Cancel edit").attr("form",o).attr("onclick","$(this).parents('[data-type=item]').data().instance.loadFromRemote()").html("<i class='fas fa-undo'></i>").appendTo(t)}}return a&&e.anchorRowForm(a,t),t},e.setupDataBody=function(t,n,r,o,a,i){const l=$("<tr>").appendTo(t);if(n.dataRowAttrs&&"object"!=typeof n.dataRowAttrs)throw new Error("options.dataRowAttrs must be an object");const s={...n.dataRowAttrs??{}};return Object.keys(s).forEach(e=>l.attr(e,s[e])),t.data("emptyview",i),n?.features?.sorting&&t.data("sort",r),a&&t.data("paging",a.find(".pages")).data("pagesizeinp",a.find(".pagesize")).data("totalrecscount",a.find(".totalrecscount")),o&&t.data("filter",o),n.type&&t.data("type",n.type),e.fillDataRow(l,n),t},e.setupPagingFooter=function(t,n,r){return e.log("setupPagingFooter",t,n,r),n.pagingFooterAttrs&&e.isPlainObject(n.pagingFooterAttrs)&&Object.keys(n.pagingFooterAttrs).forEach(e=>t.attr(e,n.pagingFooterAttrs[e])),e.log("noVisibleCols",r),t.find("td").attr("colspan",r),t}}(window.KGrid),function(e){e.setupNewRecordForm=function(t,n,r){if(!n.insertFormRow||!e.isPlainObject(n.insertFormRow))return t.find(".before-main-tbody").remove(),void t.find(".after-main-tbody").remove();const o=[...n.columns],a=$("<tr>").addClass("new-record-row");"top"===(n.insertFormRow?.position??"top")?(t.find(".after-main-tbody").remove(),a.appendTo(t.find(".before-main-tbody"))):(t.find(".before-main-tbody").remove(),a.appendTo(t.find(".after-main-tbody")));const i="new_record_row_form_"+e.uuid(),l=$("<form class='table-row-form'>").attr("id",i).off("submit").on("submit",t=>{t.preventDefault();const a=e.serializeForm(t.target,o);Object.keys(a).forEach(e=>{o.find(t=>t.name===e)?.insert?.dontsave&&delete a[e]}),r.instance.newItem(a).then(()=>{t.target.reset(),"function"==typeof n.onNewItemCreated&&n.onNewItemCreated(a)}).catch(e.onError)});o.forEach(t=>{if(t.hidden){if(n.features?.create&&t.features?.create){const e=$("<input type='hidden'>").attr("name",t.name).attr("form",i).appendTo(l);t.insert.default&&e.val(t.insert.default)}return}if(!t.features.create){const n=$("<td>").appendTo(a).attr("data-label",t.label);return void e.applyColumnCellMeta(n,t)}const r=t.insert;if(!r||!e.isPlainObject(r))throw new Error("Column must have an insert config object when column.features.create is true: \n"+JSON.stringify(t,null,2));if(!r.type)throw new Error("Column must have an insert.type when column.features.insert is true: \n"+JSON.stringify(t,null,2));let o;const s=r.type??"text",u=e.createFieldInput({mode:"insert",col:t,config:r});if(u)o=u.$input;else switch(s){case"textarea":o=$("<textarea class='form-input form-control form-control-sm'>");break;case"select":if(o=$("<select class='form-input form-control form-control-sm'/>"),!r.options||!Array.isArray(r.options))throw new Error("Column must have an insert.options array when column.features.insert is true: \n"+JSON.stringify(t,null,2));r.options.forEach(e=>{if("string"!=typeof e.label||void 0===e.value)throw new Error("Column must have an insert.options object with label and value when column.features.insert is true: \n"+JSON.stringify(t,null,2));$("<option>").text(e.label).attr("value",e.value).appendTo(o)});break;case"hidden":o=$("<input type='hidden' class='form-input form-control form-control-sm'/>");break;case"checkbox":o=$("<input autocomplete='off' type='checkbox' class='form-check-input'/>"),o.attr("data-type",s);break;default:if(!e.isValidInputType(s))throw new Error("Invalid type: "+JSON.stringify(r,null,2));o=$(`<input autocomplete='off' type='${s}' class='form-input form-control form-control-sm'/>`),o.attr("data-type",s)}const c="object"==typeof r.default&&r.default&&null!=r.default.value?r.default.value:r.default;if("checkbox"===s?o.prop("checked",e.isFlagOn(c)):null==r.default||""===r.default||o.val()||String(c).trim()&&o.val(c).trigger("change"),r.attrs&&"object"==typeof r.attrs&&Object.keys(r.attrs).forEach(e=>o.attr(e,r.attrs[e])),o.attr("form",i).attr("name",t.name),r.disabled&&o.attr("disabled",!0),r.readonly&&o.attr("readonly",!0),r.required&&o.attr("required",!0),r.attrs&&"object"==typeof r.attrs&&Object.keys(r.attrs).forEach(e=>o.attr(e,r.attrs[e])),"hidden"!==r.type){const n="checkbox"===s?e.wrapFlagSwitch(o):o,r=$("<td>").append(n).appendTo(a).attr("data-label",t.label);e.applyColumnCellMeta(r,t)}e.mountField({mode:"insert",$input:o,col:t,config:r,formEl:l[0],rowEl:a[0]}),r.events&&Array.isArray(r.events)&&r.events.forEach(e=>{o.off(e.event).on(e.event,function(t,...n){"function"==typeof e.callback&&e.callback(t,l[0],a[0],...n)})})}),e.anchorRowForm(l,a);const s=$("<td>").addClass("kgrid-row-actions").appendTo(a).attr("data-label","action"),u=$("<div>").addClass("btn-group").appendTo(s);return $("<button>").addClass("btn btn-sm btn-primary new-item-btn").html("<i class='fas fa-plus-square'></i>").attr("form",i).attr("type","submit").appendTo(u),"function"==typeof n.onInsertRowReady&&n.onInsertRowReady(l[0],a[0]),a}}(window.KGrid),function(e){e.setupEvents=function(t,n,r,o){const a=t.views[0];r.columns.forEach(n=>{n.display.events.forEach(e=>{if(!e.selector||!e.event||!e.callback)throw new Error("Invalid event: "+JSON.stringify(e,null,2));a.el.find(e.selector).off(e.event).on(e.event,n=>{if("function"!=typeof e.callback)throw new Error("Event callback must be a function: "+JSON.stringify(e,null,2));e.callback(n,t,a)})}),r.features.update&&n.update.events.forEach(r=>{if(!r.event||!r.callback)throw new Error("Invalid event: "+JSON.stringify(r,null,2));a.el.find("[name='"+n.name+"']").off(r.event).on(r.event,function(n,...o){if(e.log("event",r,n,this,o),"function"!=typeof r.callback)throw new Error("Event callback must be a function: "+JSON.stringify(r,null,2));r.callback(n,t,a,...o)})})}),r.features.update&&(a.el.find("[data-type]").each((n,r)=>{const i=r.getAttribute("data-type");if(!e.isPluggableFieldType(i))return;const l=o.get(r.name);l?.update&&e.mountField({mode:"update",$input:$(r),col:l,config:l.update,item:t,view:a})}),a.el.find("select[data-type='select']").each((e,n)=>{const r=o.get(n.name);if(!r)return;const a=t.attributes[r.name];null!=a&&""!==a&&$(n).val("boolean"==typeof a?String(a):a)}),a.el.find("input[type='checkbox']").each((n,r)=>{const a=o.get(r.name);a&&(r.checked=e.isFlagOn(t.attributes[a.name]))}),a.el.find("form.edit-form").off("submit").on("submit",t=>{const n=t.target;t.preventDefault();const o=$(n).parents("[data-type=item]").data().instance,a=e.serializeForm(n);Object.keys(a).forEach(e=>{r.columns.find(t=>t.name===e)?.update?.dontsave&&delete a[e]}),o.update(a).catch(e.onError)})),r.features.clone&&a.el.find("button.clone-item").off("click").on("click",e=>{e.preventDefault(),"function"==typeof r.onClone&&r.onClone(t,a,e)}),r.features.delete&&a.el.find("button.delete-item").off("click").on("click",n=>{n.preventDefault(),a.el.addClass("confirm-delete");const o=()=>a.el.removeClass("confirm-delete");e.runDeleteConfirm({item:t,view:a,options:r},()=>{t.delete().catch(e.onError).finally(o)},o)}),"function"==typeof r.onRowFields&&r.onRowFields(t,a,n)}}(window.KGrid),function(e){e.PREFERENCES_VERSION=1,e.localStoragePreferences={get:function(e){try{const t="undefined"!=typeof window?window:globalThis,n=t&&t.localStorage;if(!n)return null;const r=n.getItem(e);return r?JSON.parse(r):null}catch(e){return null}},set:function(e,t){try{const n="undefined"!=typeof window?window:globalThis,r=n&&n.localStorage;if(!r)return;if(null==t)return void r.removeItem(e);r.setItem(e,JSON.stringify(t))}catch(e){}}},e.preferencesStorageFor=function(t){return t&&t.preferencesStorage?t.preferencesStorage:e._config&&e._config.preferencesStorage?e._config.preferencesStorage:e.localStoragePreferences},e.layoutStorageKey=function(e){return"kgrid:"+e+":layout"},e.filtersStorageKey=function(e,t){let n="kgrid:"+e+":filters";return null!=t&&""!==String(t)&&(n+=":"+String(t)),n},e.chooserColumns=function(e){return(e||[]).filter(function(e){return e&&e.name&&!e.hidden})},e.layoutFromColumns=function(t){return{v:e.PREFERENCES_VERSION,columns:e.chooserColumns(t).map(function(e){return{name:e.name,hidden:!!e.userHidden}})}},e.parseFilterExpression=function(e){const t=String(e||""),n=["~=~",">=","<=","!=","=",">","<"];for(let e=0;e<n.length;e++){const r=n[e],o=t.indexOf(r);if(o>0)return{name:t.slice(0,o),operator:r,value:t.slice(o+r.length)}}return null},e.isUserFilterColumn=function(e){return!(!e||!e.name||e.hidden||e.features&&!1===e.features.filter)},e.readUserFilters=function(t,n){if(!t)return[];const r=[];return(n||[]).forEach(function(n){if(!e.isUserFilterColumn(n))return;const o=e.filterFormField(t,n.name);if(!o.length)return;const a=o.val();if(null==a||""===a||Array.isArray(a)&&!a.length)return;const i=o.attr("data-operator")||n.filter&&n.filter.operator||"~=~";r.push({name:n.name,value:Array.isArray(a)?a:String(a),operator:i})}),r},e.applyUserFilters=function(t,n,r){t&&r&&Array.isArray(r.filters)&&r.filters.forEach(function(r){if(!r||!r.name)return;const o=(n||[]).find(function(e){return e&&e.name===r.name});if(!e.isUserFilterColumn(o))return;if(null==r.value||""===r.value)return;let a=e.filterFormField(t,r.name);a.length||(e.ensureFilterField(t,r.name,r.value,r.operator),a=e.filterFormField(t,r.name)),a.length&&(a.val(r.value),r.operator&&a.attr("data-operator",r.operator))})},e.ensureUrlFiltersOnForm=function(t,n){if(!(t&&n&&n.url&&n.url.parameters))return;const r=String(n.url.parameters.filter||"");r&&r.split(",").forEach(function(n){const r=e.parseFilterExpression(n.trim());if(!r||!r.name||""===r.value)return;const o=e.filterFormField(t,r.name);return o.length&&o.val()?void 0:o.length?(o.val(r.value),void o.attr("data-operator",r.operator)):void e.ensureFilterField(t,r.name,r.value,r.operator)})},e.preferencesLoadLayout=function(t){if(!t||!t.storageKey)return null;const n=e.preferencesStorageFor(t).get(e.layoutStorageKey(t.storageKey));return n&&n.v===e.PREFERENCES_VERSION&&Array.isArray(n.columns)?n:null},e.preferencesSaveLayout=function(t,n){t&&t.storageKey&&e.preferencesStorageFor(t).set(e.layoutStorageKey(t.storageKey),n)},e.preferencesLoadFilters=function(t){if(!t||!t.storageKey)return null;const n=e.preferencesStorageFor(t).get(e.filtersStorageKey(t.storageKey,t.filterStorageScope));return n&&n.v===e.PREFERENCES_VERSION&&Array.isArray(n.filters)?n:null},e.preferencesSaveFilters=function(t,n){t&&t.storageKey&&e.preferencesStorageFor(t).set(e.filtersStorageKey(t.storageKey,t.filterStorageScope),{v:e.PREFERENCES_VERSION,filters:n||[]})},e.reorderColumns=function(e,t){const n=new Map,r=[];(e||[]).forEach(function(e,t){e&&e.hidden?r.push({col:e,index:t}):e&&e.name&&n.set(e.name,e)});const o=[];(t||[]).forEach(function(e){n.has(e)&&(o.push(n.get(e)),n.delete(e))}),n.forEach(function(e){o.push(e)});const a=o.slice();return r.forEach(function(e){a.splice(Math.min(e.index,a.length),0,e.col)}),a},e.mergeLayoutIntoColumns=function(t,n){const r=(t||[]).slice();r.forEach(function(e){e&&!e.hidden&&(e.userHidden=!1)});const o=e.chooserColumns(r),a=new Map(o.map(function(e){return[e.name,e]})),i=[],l=new Set;(n&&Array.isArray(n.columns)?n.columns:[]).forEach(function(e){if(!e||!e.name||!a.has(e.name))return;const t=a.get(e.name);t.userHidden=!!e.hidden&&!t.locked,i.push(e.name),l.add(e.name)}),o.forEach(function(e){l.has(e.name)||i.push(e.name)});const s=e.reorderColumns(r,i),u=e.chooserColumns(s);if(u.length&&u.every(function(e){return e.userHidden})){(u.find(function(e){return!e.locked})||u[0]).userHidden=!1}return s},e.applyLayoutToDom=function(t,n,r){if(!t||!t.length)return;const o=e.chooserColumns(n).map(function(e){return e.name}),a={};e.chooserColumns(n).forEach(function(e){e.userHidden&&(a[e.name]=!0)});t.find(".thead-labels tr, .thead-filters tr, .before-main-tbody tr, .main-tbody tr, .after-main-tbody tr").each(function(){const e=$(this),t=e.children(".kgrid-row-actions"),n={};e.children("[data-name]").each(function(){n[this.getAttribute("data-name")]=this}),o.forEach(function(r){const o=n[r];o&&(t.length?$(o).insertBefore(t):e.append(o),o.classList.toggle("kgrid-user-hidden",!!a[r]))})});const i=t.find(".kgrid-row-actions").length>0;e.syncActionColumnColgroup(t,o.length,i,r,e.chooserColumns(n))},e.refreshCollectionTemplate=function(t,n){if(!t||!t.instance||"function"!=typeof e.fillDataRow)return;const r=e.getKViews(n&&n.kviews);if(!r||"function"!=typeof r.template)return;const o=$("<tr>");n.dataRowAttrs&&e.isPlainObject(n.dataRowAttrs)&&Object.keys(n.dataRowAttrs).forEach(function(e){o.attr(e,n.dataRowAttrs[e])}),e.fillDataRow(o,n);const a=$("<div>").append(o).html(),i=r.template(a);t.instance.template=i,(t.instance.items||[]).forEach(function(e){(e.views||[]).forEach(function(e){e.template=i})})},e.setupFilterPersistence=function(t,n){t&&n&&n.storageKey&&n.features&&n.features.filtering&&$(t).off("submit.kgridFilterPrefs").on("submit.kgridFilterPrefs",function(){e.preferencesSaveFilters(n,e.readUserFilters(t,n.columns))})},e.applyColumnLayout=function(t,n,r){n.columns=e.mergeLayoutIntoColumns(n.columns,r);const o=t.$host.find("table").first();if(e.applyLayoutToDom(o,n.columns,n),e.refreshCollectionTemplate(t,n),"function"==typeof e.renderColumnChooserPanel){const r=t.$host.find(".kgrid-column-chooser-panel");r.length&&e.renderColumnChooserPanel(r,n,t)}return e.layoutFromColumns(n.columns)}}(window.KGrid),function(e){function t(t){const n=[];return t.find(".kgrid-column-chooser-list li[data-name]").each(function(){const e=this.getAttribute("data-name"),t=$(this).find("input[type='checkbox']").prop("checked");n.push({name:e,hidden:!t})}),{v:e.PREFERENCES_VERSION,columns:n}}e.renderColumnChooserPanel=function(n,r,o){n.empty();const a=$("<ul>").addClass("kgrid-column-chooser-list").appendTo(n);e.chooserColumns(r.columns).forEach(function(e){const t=$("<li>").attr("draggable","true").attr("data-name",e.name).appendTo(a);$("<span>").addClass("kgrid-column-chooser-handle").attr("aria-hidden","true").text("⋮⋮").appendTo(t);const n=$("<label>").appendTo(t),r=$("<input>").attr("type","checkbox").prop("checked",!e.userHidden).appendTo(n);e.locked&&r.prop("disabled",!0).attr("title","This column cannot be hidden"),n.append(document.createTextNode(" "+(e.label||e.name)))}),$("<button>").attr("type","button").addClass("btn btn-sm btn-outline-secondary kgrid-column-chooser-reset").text(r.columnChooserResetLabel||"Reset columns").appendTo(n),n.off("change.kgridChooser").on("change.kgridChooser","input[type='checkbox']",function(){const e=t(n);(function(e){return e.columns.filter(function(e){return!e.hidden}).length})(e)<1?this.checked=!0:o.setLayout(e)}),n.off("click.kgridChooserReset").on("click.kgridChooserReset",".kgrid-column-chooser-reset",function(){o.resetLayout()});let i=null;a.off(".kgridChooserDrag"),a.on("dragstart.kgridChooserDrag","li",function(e){i=this,$(this).addClass("kgrid-column-chooser-dragging"),e.originalEvent&&e.originalEvent.dataTransfer&&(e.originalEvent.dataTransfer.effectAllowed="move",e.originalEvent.dataTransfer.setData("text/plain",this.getAttribute("data-name")))}),a.on("dragend.kgridChooserDrag","li",function(){$(this).removeClass("kgrid-column-chooser-dragging"),i=null}),a.on("dragover.kgridChooserDrag","li",function(e){if(e.preventDefault(),!i||i===this)return;const t=this.getBoundingClientRect(),n=t.top+t.height/2;(e.originalEvent?e.originalEvent.clientY:0)<n?this.parentNode.insertBefore(i,this):this.parentNode.insertBefore(i,this.nextSibling)}),a.on("drop.kgridChooserDrag","li",function(e){e.preventDefault(),o.setLayout(t(n))})},e.setupColumnChooser=function(t,n,r){if(!n.features||!n.features.columnChooser)return;const o=e.getTableInteractionHost(t);o.find(".kgrid-column-chooser").remove();const a=n.columnChooserLabel||"Columns",i=$("<div>").addClass("kgrid-column-chooser"),l=$("<button>").attr("type","button").addClass("kgrid-column-chooser-toggle btn btn-sm btn-outline-secondary").attr("title",a).attr("aria-expanded","false").attr("aria-haspopup","true").html('<i class="fas fa-table-columns" aria-hidden="true"></i><span class="kgrid-column-chooser-toggle-label"> '+$("<div>").text(a).html()+"</span>"),s=$("<div>").addClass("kgrid-column-chooser-panel").attr("hidden","hidden");function u(){s.attr("hidden","hidden"),l.attr("aria-expanded","false")}i.append(l,s),o.prepend(i),e.renderColumnChooserPanel(s,n,r),l.on("click",function(e){e.stopPropagation();!s.attr("hidden")?u():(s.removeAttr("hidden"),l.attr("aria-expanded","true"))});const c="kgridChooser"+e.uuid();$(document).on("pointerdown."+c,function(e){document.body.contains(i[0])?i[0].contains(e.target)||u():$(document).off("pointerdown."+c)})}}(window.KGrid),function(e){e.init=async function(t,n){const r=e.resolveHostElement(t),o={...e.protoOptions,...n},a=e.mountTableShell(r,o);e.log("table config options",o);const i=e.resolveDefaultInteraction(o);e.applyInteraction(r,i);const l={$host:r,instance:null,filterForm:null,find:e=>r.find(e),setInteraction:(t,n)=>(e.applyInteraction(r,t,n),l),getInteraction:()=>"edit"===e.getTableInteractionHost(r).attr("data-interaction")?"edit":"view",setEditMode(e){if("boolean"!=typeof e)throw new TypeError("setEditMode(editMode) expects a boolean (true = edit, false = view)");return l.setInteraction(e?"edit":"view")},toggleEditMode:e=>(null!=e&&"object"==typeof e&&"function"==typeof e.preventDefault&&(e=void 0),"boolean"==typeof e?l.setInteraction(e?"edit":"view"):l.setInteraction("edit"===l.getInteraction()?"view":"edit")),getLayout:()=>e.layoutFromColumns(o.columns),setLayout:t=>(e.applyColumnLayout(l,o,t),e.preferencesSaveLayout(o,l.getLayout()),l.getLayout()),resetLayout(){const t=new Map;return o.columns.forEach(function(e){e&&e.name&&t.set(e.name,e)}),o.columns=s.map(function(e){return t.get(e)}).filter(Boolean),e.preferencesSaveLayout(o,null),e.applyColumnLayout(l,o,null),l.getLayout()}};o.columns=(o.columns||[]).map(t=>e.normalizeColumnConfig(t));const s=o.columns.map(function(e){return e.name});o.columns=e.mergeLayoutIntoColumns(o.columns,e.preferencesLoadLayout(o));const u=o.handlers??{};if(delete o.handlers,"string"==typeof o.onClone){const e=u[o.onClone]||o.functions&&o.functions[o.onClone];if(!e||"function"!=typeof e)throw new Error("onClone handler "+o.onClone+" not found or is not a function");o.onClone=e}o.columns.forEach(e=>{["insert","update","display"].forEach(t=>{const n=e[t].events;if(!n||!Array.isArray(n))throw new Error("Column "+e.name+" events are not an array");n.forEach(t=>{if("string"==typeof t.callback){const n=u[t.callback]||o.functions&&o.functions[t.callback];if(!n||"function"!=typeof n)throw new Error("Event callback function "+t.callback+" not found for column "+e.name+" or is not a function");t.callback=n}else if("function"!=typeof t.callback)throw new Error("Event callback must be a function for column "+e.name)})});const t=e.display;t&&t.events&&Array.isArray(t.events)&&t.events.forEach(e=>{if("string"==typeof e.callback){const t=u[e.callback]||o.functions&&o.functions[e.callback];t&&"function"==typeof t&&(e.callback=t)}})});const c=new Map;o.columns.forEach(e=>{c.set(e.name,e)});const f=e.setupLabelsHeader(a.find(".thead-labels"),o),d=e.hasActionColumn(o),p=f.find("th").length,m=p-(d?1:0);e.syncActionColumnColgroup(a,m,d,o,e.chooserColumns(o.columns));const g=o.filterForm??e.setupFilterHeader(a,o);let y;o.features&&o.features.paging?y=e.setupPagingFooter(a.find(".paging-footer"),o,p):(y=null,a.find(".paging-footer").remove());const h=e.setupNoDataTbody(a.find(".no-data-tbody"),o,p);o.features&&o.features.create&&e.setupNewRecordForm(a,o,l),l.filterForm=new e.FilterForm(g);const b=e.setupDataBody(a.find(".main-tbody"),o,f,g,y,h),w={dontload:!0,setAttrAsId:o.setAttrAsId??!1,itemListeners:{afterrender:t=>e.setupEvents(t,l.find("table"),o,c)}},E=e.getKViews(o.kviews);if(!E)throw new Error(e.KVIEWS_MISSING_MSG);l.instance=await E.createCollectionInstance(b,w),o.url&&(l.instance.setUrl(o.url),o.deleteUrl&&(e.log("set deleteUrl",o.deleteUrl),l.instance.setUrl(o.deleteUrl,"delete")),o.updateUrl&&(e.log("set updateUrl",o.updateUrl),l.instance.setUrl(o.updateUrl,"update")),o.insertUrl&&l.instance.setUrl(o.insertUrl,"insert")),e.setupDefaultFilters(g,o,l.instance,{skipInitSubmit:!0});const v=g&&(g.jquery?g[0]:g);if(e.applyUserFilters(v,o.columns,e.preferencesLoadFilters(o)),e.ensureUrlFiltersOnForm(v,l.instance),e.setupFilterPersistence(v,o),e.setupColumnChooser(r,o,l),o.url)try{o.features&&o.features.filtering&&v&&e.syncFormFiltersToCollectionUrl(v,l.instance),await l.instance.loadFromRemote()}catch(t){e.onError(t)}else{if(!o.data||o.data.constructor!==Array)throw new Error("Invalid data: missing datasource url or data for table");{const e=o.data.map(e=>({attributes:e}));l.instance.loadFromData(e)}}return l}}(window.KGrid);
package/docs/ai-guide.md CHANGED
@@ -21,7 +21,7 @@ Human-readable references: [README](../README.md), [configuration.md](configurat
21
21
  |-------------|--------|
22
22
  | jQuery `>= 3.7.0` | Peer dependency |
23
23
  | `@logimaxx/kviews` | Peer; must expose `createCollectionInstance` |
24
- | `styles/table.css` | **Required** — view/edit modes, row-actions column collapse, cell visibility |
24
+ | `styles/table.css` | **Required** — view/edit modes, row-actions collapse / compact width, cell visibility |
25
25
  | Load order | jQuery → KViews → `kgrid.js` → (optional `kgrid-widgets.js`) → `configure({ customInputTypes })` → `init()` |
26
26
  | Bootstrap + Font Awesome | Recommended (default template uses `btn-*`, `fa-sort-*`) |
27
27
 
@@ -62,7 +62,10 @@ const grid = await KGrid.init(document.getElementById("grid-host"), {
62
62
  create: true,
63
63
  update: true,
64
64
  delete: true,
65
+ columnChooser: true,
65
66
  },
67
+ storageKey: "catalog.products",
68
+ filterStorageScope: companyId,
66
69
  columns: [/* see column shape below */],
67
70
  });
68
71
 
@@ -82,7 +85,7 @@ const grid = await KGrid.init(document.getElementById("grid-host"), {
82
85
  | `onError` | Always in production apps |
83
86
  | `deleteConfirm(context, onConfirm, onCancel)` | Row delete UI (preferred over hardcoded messages) |
84
87
  | `confirm(message, onConfirm, onCancel)` | Generic dialogs; default delete flow uses this if `deleteConfirm` unset |
85
- | `serializeForm(form, columns?)` | Non-flat APIs, checkbox coercion, etc. |
88
+ | `serializeForm(form, columns?)` | Override only for non-flat APIs. Default already emits checkbox flags as `"1"` / `"0"`. |
86
89
  | `customInputTypes` | Map of type name → plugin (`KGrid.select2(fn)`, `KGrid.inputType(…)`, or `{ create, … }`) |
87
90
 
88
91
  Per-table override: pass `deleteConfirm` in `init(host, { deleteConfirm, ... })`.
@@ -101,7 +104,7 @@ Per-table override: pass `deleteConfirm` in `init(host, { deleteConfirm, ... })`
101
104
  **Features** (all default `false`):
102
105
 
103
106
  ```javascript
104
- features: { filtering, sorting, paging, create, update, delete }
107
+ features: { filtering, sorting, paging, create, update, delete, columnChooser }
105
108
  ```
106
109
 
107
110
  **Interaction:**
@@ -128,7 +131,8 @@ Each column in `columns: []` is normalized via `KGrid.normalizeColumnConfig` (pr
128
131
  {
129
132
  name: "sku", // required for filter/sort/update
130
133
  label: "SKU",
131
- hidden: false,
134
+ hidden: false, // schema: omit from UI entirely
135
+ locked: false, // column chooser cannot hide this field
132
136
  class: "col-sku", // CSS on th/td (alias: columnClass); also sets data-name
133
137
  features: { create, update, filter, sort }, // per-column flags
134
138
  // Shared insert+update defaults (explicit insert/update win):
@@ -154,11 +158,13 @@ Each column in `columns: []` is normalized via `KGrid.normalizeColumnConfig` (pr
154
158
 
155
159
  **Hidden / persist filters:** columns with `hidden: true` or `filter.type: "hidden"` get a hidden form field (no filter-row cell). `filter.persist` (or hidden) re-applies `filter.default` on form reset.
156
160
 
161
+ **User column layout + filter reload:** `storageKey` persists layout (all companies) and filter values (`filterStorageScope` suffixes filters, e.g. company id) to `localStorage`. `features.columnChooser` adds a Columns panel (reorder + hide). Schema `hidden` columns stay out of the chooser. `locked: true` columns cannot be hidden. User-hidden columns collapse in the table but keep filter/insert/update inputs. `grid.getLayout()` / `setLayout()` / `resetLayout()`.
162
+
157
163
  ---
158
164
 
159
165
  ## Row actions column (do not break)
160
166
 
161
- When `features.delete || features.update || features.create`:
167
+ When `features.delete || features.update || features.create || features.clone`:
162
168
 
163
169
  - Trailing column: `.kgrid-row-actions` on `th`/`td`
164
170
  - `<colgroup>` with `col.kgrid-row-actions-col` (synced at init)
@@ -200,6 +206,7 @@ grid.filterForm // .filter(name, value, op), .reset()
200
206
  grid.find(sel) // search under $host
201
207
  grid.setInteraction(mode, overrides?)
202
208
  grid.getInteraction() // "view" | "edit"
209
+ grid.getLayout() / setLayout() / resetLayout()
203
210
  ```
204
211
 
205
212
  Deprecated: `setEditMode`, `toggleEditMode` — use `setInteraction`.
@@ -211,6 +218,8 @@ Deprecated: `setEditMode`, `toggleEditMode` — use `setInteraction`.
211
218
  | Task | Approach |
212
219
  |------|----------|
213
220
  | Toggle edit UI | `grid.setInteraction("edit")` / `"view"` |
221
+ | Column chooser | `features.columnChooser` + `storageKey` |
222
+ | Persist filters on reload | `storageKey` (+ optional `filterStorageScope`) |
214
223
  | Programmatic filter | `grid.filterForm.filter("name", "x", "~=~")` |
215
224
  | Reload data | `grid.instance.loadFromRemote()` |
216
225
  | Custom delete modal | `KGrid.configure({ deleteConfirm })` |
@@ -270,4 +279,4 @@ Run demo locally: `npm run demo` in the kgrid package → `http://localhost:5173
270
279
 
271
280
  ## Version
272
281
 
273
- This guide matches **@logimaxx/kgrid@0.2.1** (row lifecycle hooks, `column.class`, persist filters, `input` shorthand). If APIs differ in another version, prefer `docs/api.md` in the installed package.
282
+ This guide matches **@logimaxx/kgrid@0.4.0** (column chooser, persisted layout/filters, row lifecycle hooks, `column.class`, persist filters, `input` shorthand). If APIs differ in another version, prefer `docs/api.md` in the installed package.
package/docs/api.md CHANGED
@@ -12,10 +12,11 @@ Merge host integration hooks. Call before initializing tables.
12
12
  | `onError` | `(err) => void` | `console.error` |
13
13
  | `confirm` | `(message, onConfirm, onCancel?) => void` | `window.confirm` |
14
14
  | `deleteConfirm` | `(context, onConfirm, onCancel?) => void` | `null` — falls back to `confirm` + `DEFAULT_DELETE_CONFIRM_MESSAGE` |
15
- | `serializeForm` | `(form, columns?) => object` | `FormData` → plain object |
15
+ | `serializeForm` | `(form, columns?) => object` | Named fields; checkboxes always `"1"` / `"0"` (unchecked included) |
16
16
  | `kviews` | KViews module | `window.KViews` |
17
17
  | `customInputTypes` | `Record<string, FieldTypePlugin>` | Each value: `{ create, mount?, … }` (use `KGrid.select2(fn)` etc.) |
18
18
  | `filterDebounceMs` | `number` | Default delay (ms) before filter API submit on the resolved submit event (`input` or `change`); `0` = immediate (default `300`) |
19
+ | `preferencesStorage` | `{ get(key), set(key, value\|null) }` | Override `localStorage` for layout/filter prefs (tests) |
19
20
  | `fieldTypes` | same as `customInputTypes` | **Deprecated** alias |
20
21
 
21
22
  Returns `KGrid` (chainable). Re-syncs `customInputTypes` on every call.
@@ -53,7 +54,8 @@ See [field-types.md](field-types.md).
53
54
 
54
55
  **Internal helpers:**
55
56
 
56
- - `KGrid.log`, `onError`, `confirm`, `runDeleteConfirm`, `serializeForm`
57
+ - `KGrid.log`, `onError`, `confirm`, `runDeleteConfirm`, `serializeForm`, `serializeFormDefault`
58
+ - `KGrid.isFlagOn(v)` — `true` / `1` / `"1"` are on; used for checkbox flags
57
59
  - `KGrid.DEFAULT_DELETE_CONFIRM_MESSAGE` — default text when `deleteConfirm` is not set
58
60
 
59
61
  `KGrid.select2.helpers` — Select2 option helpers (after loading `kgrid-widgets.js`).
@@ -80,6 +82,7 @@ Async table initializer.
80
82
  | `filterForm` | `FilterForm` or setup result |
81
83
  | `find(sel)` | ` $host.find(sel)` |
82
84
  | `setInteraction`, `getInteraction`, `toggleEditMode`, `setEditMode` | Interaction mode |
85
+ | `getLayout`, `setLayout`, `resetLayout` | Column order / user-hidden columns |
83
86
 
84
87
  ### Prototypes
85
88
 
@@ -111,8 +114,9 @@ See **[table-shell.md](table-shell.md)** for structure, placeholders, and custom
111
114
 
112
115
  | Symbol | Description |
113
116
  |--------|-------------|
114
- | `KGrid.hasActionColumn(options)` | `true` when `features.delete`, `features.update`, or `features.create` is enabled |
115
- | `KGrid.syncActionColumnColgroup($table, dataColumnCount, hasActions)` | Prepends `<colgroup>` so the actions column can collapse in view mode without reserving width |
117
+ | `KGrid.hasActionColumn(options)` | `true` when `features.delete`, `features.update`, `features.create`, or `features.clone` is enabled |
118
+ | `KGrid.actionColumnWidth(options)` | Compact CSS width for the actions column under `table-layout: fixed` (from max button count) |
119
+ | `KGrid.syncActionColumnColgroup($table, dataColumnCount, hasActions, options?)` | Prepends `<colgroup>` so the actions column can collapse in view mode; sets actions col width from `actionColumnWidth` |
116
120
 
117
121
  Requires `styles/table.css` for view/edit visibility rules on `.kgrid-row-actions` and `col.kgrid-row-actions-col`.
118
122
 
@@ -153,6 +157,18 @@ Use `setInteraction`.
153
157
  - `boolean` → set mode
154
158
  - no arg / DOM event → toggle view ↔ edit
155
159
 
160
+ #### `grid.getLayout()`
161
+
162
+ `{ columns: [{ name, hidden }] }` — chooser columns in display order. `hidden` is user-hidden (schema-hidden columns are omitted).
163
+
164
+ #### `grid.setLayout(layout)`
165
+
166
+ Apply order + visibility, persist when `storageKey` is set, update DOM and the KViews row template.
167
+
168
+ #### `grid.resetLayout()`
169
+
170
+ Restore JSON column order and show all chooser columns; clears stored layout.
171
+
156
172
  ---
157
173
 
158
174
  ## `KGrid.FilterForm`
@@ -154,16 +154,41 @@ features: {
154
154
  create: false,
155
155
  update: false,
156
156
  delete: false,
157
+ clone: false,
158
+ columnChooser: false,
157
159
  }
158
160
  ```
159
161
 
162
+ ### Column chooser and persisted preferences
163
+
164
+ | Option | Type | Description |
165
+ |--------|------|-------------|
166
+ | `storageKey` | `string` | Persist layout (order + user-hidden) and filter values. Layout key: `kgrid:{storageKey}:layout`. Filters: `kgrid:{storageKey}:filters` plus optional scope. |
167
+ | `filterStorageScope` | `string` | Suffix for saved filters only (e.g. company id). Layout is shared across scopes. |
168
+ | `features.columnChooser` | `boolean` | Columns panel (checkbox + drag). Works without `storageKey` (session only). |
169
+ | `columnChooserLabel` | `string` | Button label (default `"Columns"`) |
170
+ | `columnChooserResetLabel` | `string` | Reset button (default `"Reset columns"`) |
171
+ | `preferencesStorage` | `{ get, set }` | Per-table override of `configure({ preferencesStorage })`; default `localStorage` |
172
+
173
+ Column flags:
174
+
175
+ | Field | Meaning |
176
+ |-------|---------|
177
+ | `hidden: true` | Schema — omitted from UI and chooser (e.g. internal `id`) |
178
+ | `locked: true` | Visible; chooser cannot hide it (still reorderable). Use on required list fields such as name. |
179
+ | `userHidden` | Runtime only — set via chooser / `setLayout` |
180
+
181
+ User-hidden columns use `visibility: collapse` so insert/update/filter controls stay in the DOM. Filter values on hidden columns remain until Reset.
182
+
183
+ `filter.persist` still means “keep `filter.default` on form reset” — it is not reload persistence. Reload persistence is `storageKey`.
184
+
160
185
  ### Row actions column
161
186
 
162
- When any of `create`, `update`, or `delete` is enabled, KGrid adds a trailing column for row controls (delete, save/cancel, insert submit). The same rule is used everywhere so header, filter row, data rows, and `colspan` stay aligned:
187
+ When any of `create`, `update`, `delete`, or `clone` is enabled, KGrid adds a trailing column for row controls (clone, delete, save/cancel, insert submit). The same rule is used everywhere so header, filter row, data rows, and `colspan` stay aligned:
163
188
 
164
189
  ```javascript
165
190
  KGrid.hasActionColumn(options)
166
- // true when features.delete || features.update || features.create
191
+ // true when features.delete || features.update || features.create || features.clone
167
192
  ```
168
193
 
169
194
  | Markup | Role |
@@ -171,7 +196,9 @@ KGrid.hasActionColumn(options)
171
196
  | `th` / `td.kgrid-row-actions` | Header, filters, data rows |
172
197
  | `colgroup col.kgrid-row-actions-col` | Width control for `table-layout: fixed` (added at init via `syncActionColumnColgroup`) |
173
198
 
174
- **View vs edit:** In **view** mode (`data-interaction="view"`), the row-actions column is collapsed (`visibility: collapse`, zero width) so data columns use the full table width. In **edit** mode, the column is shown (~100px) with delete / save / cancel buttons and the insert-row submit cell.
199
+ **View vs edit:** In **view** mode (`data-interaction="view"`), the row-actions column is collapsed (`visibility: collapse`, zero width) so data columns use the full table width. In **edit** mode, the column uses a compact width from `KGrid.actionColumnWidth(options)` (based on how many buttons can show) with clone / delete / save / cancel buttons and the insert-row submit cell.
200
+
201
+ `features.clone` (default `false`) adds a clone button. Host must supply `onClone(item, view, event)` — a function, or a string name resolved from `handlers` / `functions` (same as column event callbacks). KGrid does not clone records itself.
175
202
 
176
203
  The new-record row (`.new-record-row`) uses the same `kgrid-row-actions` class on its submit cell; the whole insert row is hidden in view mode via existing CSS.
177
204
 
@@ -243,7 +270,8 @@ Each element of `columns: []`:
243
270
  |-------|------|-------------|
244
271
  | `name` | `string` | Field name (**required** for sort, filter, create, update on that column) |
245
272
  | `label` | `string` | Header text |
246
- | `hidden` | `boolean` | Hide from UI; may still participate in forms (e.g. `id` as `hidden`) |
273
+ | `hidden` | `boolean` | Hide from UI; may still participate in forms (e.g. `id` as `hidden`). Not user-togglable. |
274
+ | `locked` | `boolean` | Column chooser cannot hide this column |
247
275
  | `class` / `columnClass` | `string` | CSS class on label/filter/data/insert cells; sets `data-name` |
248
276
  | `attrs` | `object` | HTML attributes on header/cells |
249
277
  | `input` | `object` | Shared defaults for `insert` + `update` (explicit blocks win) |
@@ -83,6 +83,28 @@ KGrid.configure({
83
83
 
84
84
  See previous sections in this file for `select`, `multi_select`, `date_range`. Native types need no registration.
85
85
 
86
+ ### `checkbox` — boolean flag toggle
87
+
88
+ `filter` / `insert` / `update` `{ type: "checkbox" }` is always a **flag**, not a multi-value checkbox group.
89
+
90
+ - UI: Bootstrap `form-check form-switch` (`role="switch"`).
91
+ - Serialized value is always `"1"` or `"0"`. Unchecked still appears in the payload (unlike `FormData`).
92
+ - On if the record value is `true`, `1`, or `"1"`; everything else is off.
93
+ - Do not set `update.value` from the field (`value: "{{flag}}"`). KGrid sets `checked` from `item.attributes` after render.
94
+
95
+ ```javascript
96
+ {
97
+ name: "lot_tracked",
98
+ display: { template: "{{#if (equals lot_tracked '1')}}Da{{else}}—{{/if}}" },
99
+ insert: { type: "checkbox", default: "0" },
100
+ update: { type: "checkbox" },
101
+ }
102
+ ```
103
+
104
+ `KGrid.isFlagOn(v)` is the same on/off rule used for `checked` and insert defaults.
105
+
106
+ Filter checkboxes are not coerced to `"0"` when empty — filter submit is separate and unchecked means “no filter”.
107
+
86
108
  ## Direct API
87
109
 
88
110
  `KGrid.registerFieldType(name, plugin)` — same plugin shape; useful in tests or dynamic registration.