@simplybuilder/core 2.0.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/AUTHORS ADDED
@@ -0,0 +1,2 @@
1
+ Jamil Services <jamilservices@gmail.com>
2
+ Jamil Services <jamilservicos@gmail.com>
@@ -0,0 +1,35 @@
1
+ ### Contributing to `@simplybuilder/core`
2
+ Thank you for considering contributing to `@simplybuilder/core`!
3
+ This document contains a set of guidelines for contributing to `@simplybuilder/core`.
4
+ These are guidelines, not rules. Use your best judgment and feel free to propose changes to this document in a pull request.
5
+
6
+
7
+
8
+ #### How to Contribute
9
+ **Reporting Bugs**
10
+ Before creating a bug report, please check if it has already been reported. If you find a bug that has not yet been reported, create an issue using the provided template.
11
+
12
+ **When creating a bug report, make sure to include:**
13
+ - A concise description of the issue
14
+ - Steps to reproduce the issue
15
+ - Expected behavior
16
+ - Observed behavior
17
+ - Any additional information that may be helpful
18
+
19
+ **Suggesting Improvements**
20
+ Improvements are always welcome, whether in the form of new features or enhancements to existing ones. Feel free to create an issue to discuss your ideas.
21
+
22
+ #### Pull Requests
23
+ **Want to submit your own code? Great! Here are some simple steps to get started:**
24
+
25
+ - Fork the project: This allows you to have your own copy of the project to work on.
26
+ - Create a branch: Use a descriptive name for your branch, such as feature/new_feature_name or bugfix/bug_description.
27
+ - Make your changes: Make sure to follow the project's coding guidelines.
28
+ - Test your changes: Run the existing tests and add new ones if you are introducing new features.
29
+ - Submit a Pull Request: Include a clear description of what is being proposed and any other relevant information.
30
+
31
+ #### Code of Conduct
32
+ All contributors are expected to follow our Code of Conduct. Please read it before contributing.
33
+
34
+ #### Questions?
35
+ If you have any questions or need assistance, feel free to create an issue.
package/GOVERNANCE.md ADDED
@@ -0,0 +1,10 @@
1
+ The `@simplybuilder/core` project is governed by [@jamilservicos](https://github.com/jamilservicos) which is responsible for high-level guidance of the project.
2
+
3
+ **The [@jamilservicos](https://github.com/jamilservicos) has final authority over this project including:**
4
+
5
+ * Technical direction
6
+ * Project governance and process (including this policy)
7
+ * Contribution policy
8
+ * GitHub repository hosting
9
+ * Conduct guidelines
10
+ * Maintaining the list of additional Collaborators
package/LICENSE ADDED
@@ -0,0 +1,21 @@
1
+ MIT License
2
+
3
+ Copyright (c) 2024 Simply Builder by Jamil Services
4
+
5
+ Permission is hereby granted, free of charge, to any person obtaining a copy
6
+ of this software and associated documentation files (the "Software"), to deal
7
+ in the Software without restriction, including without limitation the rights
8
+ to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
9
+ copies of the Software, and to permit persons to whom the Software is
10
+ furnished to do so, subject to the following conditions:
11
+
12
+ The above copyright notice and this permission notice shall be included in all
13
+ copies or substantial portions of the Software.
14
+
15
+ THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
16
+ IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
17
+ FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
18
+ AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
19
+ LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
20
+ OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
21
+ SOFTWARE.
package/MAINTAINERS.md ADDED
@@ -0,0 +1 @@
1
+ [@jamilservicos](https://github.com/jamilservicos) is the main/default maintainer
package/README.md ADDED
@@ -0,0 +1,47 @@
1
+ # @simplybuilder/core
2
+
3
+ Unified integration layer for @simplybuilder/core-event and @simplybuilder/core-dom. Imports both modules and wires them together via `domModuleExtends(EventModule)` for declarative event binding and memory-safe cleanup.
4
+
5
+ ## Installation
6
+
7
+ ```bash
8
+ pnpm add @simplybuilder/core
9
+ ```
10
+
11
+ ## Usage
12
+
13
+ ```typescript
14
+ import { CoreModule } from '@simplybuilder/core';
15
+
16
+ // Register event actions
17
+ CoreModule.eventRegister('handleClick', (event) => console.log('Clicked!', event));
18
+
19
+ // DOM creation with automatic event binding
20
+ const btn = CoreModule.createFromStruct({
21
+ struct: { element: 'button', event: { type: 'click', action: 'handleClick' }, text: 'Click me' },
22
+ });
23
+ // → Event listener attached automatically via domModuleExtends bridge
24
+
25
+ // Removal with recursive event cleanup
26
+ CoreModule.removeElement(btn);
27
+ // → Cleans up all listeners in element tree, then removes from DOM
28
+ ```
29
+
30
+ ## API
31
+
32
+ All methods are available on the `CoreModule` frozen singleton:
33
+
34
+ - `CoreModule.name` — Module identifier (`"SBCore"`)
35
+ - `CoreModule.version` — Module version
36
+ - `CoreModule.eventRegister(name, fn)` — Register a named action for declarative event binding
37
+ - `CoreModule.eventUnregister(name)` — Remove a named action
38
+ - `CoreModule.getElementFromStore(key)` — Retrieve stored element by key
39
+ - `CoreModule.createFromStruct(struct)` — Build nested DOM trees with automatic event binding
40
+ - `CoreModule.removeElement(element)` — Remove element with recursive event listener cleanup
41
+
42
+ ## Build from Source
43
+
44
+ ```bash
45
+ pnpm install
46
+ pnpm build
47
+ ```
@@ -0,0 +1,39 @@
1
+ /*! SBCore version 2.0.0 */
2
+ 'use strict';Object.defineProperties(exports,{__esModule:{value:true},[Symbol.toStringTag]:{value:'Module'}});/*! SBCoreDom version 2.0.0 */
3
+ const e$1={};function addElementToStore(t){const{key:n,value:r}=t;n&&r&&void 0===e$1[n]&&(e$1[n]=r);}function getElementFromStore(t){if(t)return e$1[t]}function removeElementFromStore(t){const{key:n,mode:r=1,EventModule:o={}}=t;if(!n)return false;try{const t=e$1[n];return !!t&&(1===r&&"function"==typeof o.removeAllEventsFromStore&&o.removeAllEventsFromStore(t),delete e$1[n],!0)}catch{return false}}const t$1={app:{name:"DomModule",version:"2.0.0"},register:{},allow:{SBCoreEvent:{major:2}},clearExtensions(){for(const e of Object.keys(this.register))delete this.register[e];}};function validVersionSupport(e){const{name:n,version:r}=e,o=t$1.allow[n];if(o&&r){const e=r.split(".");if(e.length>=1){if(void 0!==o.major&&e[0]&&o.major>Number(e[0]))return false;if(void 0!==o.minor&&e[1]&&o.minor>Number(e[1]))return false;if(void 0!==o.patch&&e[2]&&o.patch>Number(e[2]))return false}return true}return false}function domModuleExtends(e){try{const{name:n}=e;if(validVersionSupport(e))return t$1.register[n]=e,!0}catch{return false}return false}function getAnyExtension(){for(const e of Object.keys(t$1.register))return t$1.register[e]}function setAttr(e){const{element:t,attrs:n}=e;if(n&&0!==n.length)for(let e=n.length-1;e>=0;e--){const r=n[e];r?.name&&t.setAttribute(r.name,r.value);}}function setAttrNS(e){const{element:t,attrs:n}=e;if(n&&0!==n.length)for(let e=n.length-1;e>=0;e--){const r=n[e];r?.name&&t.setAttributeNS(null,r.name,r.value);}}function setData(e){const{element:t,dataset:n}=e;if(n&&0!==n.length)for(let e=n.length-1;e>=0;e--){const r=n[e];r?.name&&(t.dataset[r.name]=r.value,"state"===r.name&&addElementToStore({key:r.value,value:t}));}}function attachShadow(e,t){return e.attachShadow({mode:t})}function applyAttributes(e,t){t.attr?.length&&setAttr({element:e,attrs:t.attr}),"attrNS"in t&&t.attrNS?.length&&setAttrNS({element:e,attrs:t.attrNS}),t.dataset?.length&&setData({element:e,dataset:t.dataset});}function createHTMLElement(e={}){try{const{parent:t,element:n,shadow:r}=e,o=document.createElement(n.type);applyAttributes(o,n);const a=t??document.body;if((a instanceof HTMLElement||a instanceof SVGElement||a instanceof ShadowRoot)&&a.appendChild(o),r&&o.dataset?.state){const e=function createShadowFromConfig(e,t){if("string"==typeof t)return attachShadow(e,t);if("object"==typeof t&&null!==t&&"mode"in t){const n=t,r=attachShadow(e,n.mode);if(n.styles&&"undefined"!=typeof CSSStyleSheet)try{const e=new CSSStyleSheet;e.replaceSync(n.styles),r.adoptedStyleSheets=[e];}catch{}return r}}(o,r);if(e)return e}return o}catch(e){return void console.error(e)}}function createSVGElement(e={}){try{const{parent:t,element:n}=e,r=document.createElementNS("http://www.w3.org/2000/svg",n.type);return applyAttributes(r,n),t&&(t instanceof HTMLElement||t instanceof SVGElement)&&t.appendChild(r),r}catch(e){return void console.error(e)}}function createEventElement(e){const{struct:t,element:n}=e,r=getAnyExtension();if(r&&t.event?.action&&t.event?.type){const e=r.EventActions;if(e&&e[t.event.action]){const o={element:n,type:t.event.type,handler:e[t.event.action]};t.event.node&&(o.nodeId=t.event.node);(0, r.addEventToStore)(o);}}}function createFromStruct(e){try{if("object"!=typeof e||!e)return !1;const{struct:t,parent:n=document.body}=e;if(!t?.element)return !1;const r=t.type&&"svg"===t.type.toLowerCase(),o=t.attr?Object.entries(t.attr).map(([e,t])=>({name:e,value:t})):[],a=t.dataset?Object.entries(t.dataset).map(([e,t])=>({name:e,value:t})):[];let l;if(r){const e=t.attrNS?Object.entries(t.attrNS).map(([e,t])=>({name:e,value:t})):[];l=createSVGElement({parent:n,element:{type:t.element,attr:o,attrNS:e,dataset:a}});}else {const e=createHTMLElement({parent:n,element:{type:t.element,attr:o,dataset:a},shadow:t.shadow});l=e instanceof ShadowRoot?e.host:e;}if(!l)return !1;if(void 0!==t.text&&(l.textContent=t.text),void 0!==t.html&&(l.innerHTML=t.html),createEventElement({struct:t,element:l}),t.children&&t.children.length>0)for(const e of t.children)createFromStruct({struct:e,parent:l});return l}catch(e){return console.error(e),false}}function removeElementFromStoreOrEvents(e){try{const t=getAnyExtension(),n=e;if(n.dataset?.state)return removeElementFromStore({key:n.dataset.state,mode:t?1:2,EventModule:t}),!0;if(t&&"function"==typeof t.removeAllEventsFromStore){return (0,t.removeAllEventsFromStore)(e),!0}}catch{}return false}function removeElement(e){if(!e)return;removeElementFromStoreOrEvents(e);const t=e.querySelectorAll('[listener="true"]');for(let e=t.length-1;e>=0;e--){const n=t[e];n&&removeElementFromStoreOrEvents(n);}const n=e.querySelectorAll("[data-state]");for(let e=n.length-1;e>=0;e--){const t=n[e];if(t){const e=getAnyExtension();removeElementFromStore({key:t.dataset.state,mode:e?1:2,EventModule:e}),t.removeAttribute("data-state");}}e.remove();}/*! https://simplybuilder.github.io */
4
+ /*! SBCoreEvent version 2.0.0 */
5
+ const e={},t={};function eventRegister(n,r){if(!n||!r)return false;const o=n.toUpperCase();return !e[o]&&(e[o]=n,t[e[o]]=r,true)}function eventUnregister(n){if(!n)return false;const r=n.toUpperCase(),o=e[r];return !!o&&(delete e[r],t[o]&&delete t[o],true)}const n=new Map;function clearEvent(e,t=false){const r=n.get(e);return (t||r&&0===r.length)&&(n.delete(e),e instanceof Element&&e.removeAttribute("listener")),true}function addEventToStore(e){const{element:t,type:r,handler:o,eventId:s,nodeId:i}=e;if(!t||!r||!o)return false;t instanceof Element&&!t.getAttribute("listener")&&t.setAttribute("listener","true"),n.has(t)||n.set(t,[]);const v={type:r,handler:o};return void 0!==i&&(v.nodeId=i),void 0!==s&&(v.eventId=s),n.get(t).push(v),t.addEventListener(r,o,false),true}function removeAllEventsFromStore(e){const t=n.get(e);if(!t||0===t.length)return false;for(let n=t.length-1;n>=0;n--){const r=t[n];r&&e.removeEventListener(r.type,r.handler,false);}return clearEvent(e,true),true}function removeEventIdFromStore(e){const{element:t,eventId:r}=e,o=n.get(t);if(!o)return false;const s=o.findIndex(e=>e.eventId===r);if(-1===s)return false;const[i]=o.splice(s,1);return i&&t.removeEventListener(i.type,i.handler,false),clearEvent(t),true}const r="SBCoreEvent",o="2.0.0",s=Object.freeze({name:r,version:o,EventTypes:e,EventActions:t,eventRegister,eventUnregister,addEventToStore,removeAllEventsFromStore,removeEventIdFromStore});/*! https://simplybuilder.github.io */
6
+ /**
7
+ * @module CoreModule
8
+ * @description
9
+ * Unified integration layer for @simplybuilder/core-event and @simplybuilder/core-dom.
10
+ * On initialization, calls `domModuleExtends(EventModule)` to wire the two modules
11
+ * together, enabling declarative event binding in `createFromStruct` and automatic
12
+ * recursive listener cleanup in `removeElement`.
13
+ */
14
+ domModuleExtends(s);
15
+ const name = "SBCore";
16
+ const version = "2.0.0";
17
+ /**
18
+ * Frozen singleton combining DOM and event capabilities.
19
+ * Automatically integrates both modules via `domModuleExtends` at import time.
20
+ *
21
+ * @type {Object}
22
+ * @property {string} name - Module identifier.
23
+ * @property {string} version - Module version.
24
+ * @property {Function} getElementFromStore - Retrieve element from DOM store by key.
25
+ * @property {Function} createFromStruct - Build DOM tree with declarative event binding.
26
+ * @property {Function} removeElement - Remove element with recursive listener cleanup.
27
+ * @property {Function} eventRegister - Register a named event action.
28
+ * @property {Function} eventUnregister - Remove a named event action.
29
+ */
30
+ const CoreModule = Object.freeze({
31
+ name,
32
+ version,
33
+ getElementFromStore,
34
+ createFromStruct,
35
+ removeElement,
36
+ eventRegister,
37
+ eventUnregister,
38
+ });exports.CoreModule=CoreModule;exports.default=CoreModule;exports.name=name;exports.version=version;
39
+ /*! https://simplybuilder.github.io */
@@ -0,0 +1,6 @@
1
+ /*! SBCore version 2.0.0 */
2
+ Object.defineProperties(exports,{__esModule:{value:!0},[Symbol.toStringTag]:{value:"Module"}});/*! SBCoreDom version 2.0.0 */
3
+ const e={};function addElementToStore(t){const{key:n,value:r}=t;n&&r&&void 0===e[n]&&(e[n]=r)}function removeElementFromStore(t){const{key:n,mode:r=1,EventModule:o={}}=t;if(!n)return!1;try{const t=e[n];return!!t&&(1===r&&"function"==typeof o.removeAllEventsFromStore&&o.removeAllEventsFromStore(t),delete e[n],!0)}catch{return!1}}const t={app:{name:"DomModule",version:"2.0.0"},register:{},allow:{SBCoreEvent:{major:2}},clearExtensions(){for(const e of Object.keys(this.register))delete this.register[e]}};function getAnyExtension(){for(const e of Object.keys(t.register))return t.register[e]}function attachShadow(e,t){return e.attachShadow({mode:t})}function applyAttributes(e,t){t.attr?.length&&function setAttr(e){const{element:t,attrs:n}=e;if(n&&0!==n.length)for(let e=n.length-1;e>=0;e--){const r=n[e];r?.name&&t.setAttribute(r.name,r.value)}}({element:e,attrs:t.attr}),"attrNS"in t&&t.attrNS?.length&&function setAttrNS(e){const{element:t,attrs:n}=e;if(n&&0!==n.length)for(let e=n.length-1;e>=0;e--){const r=n[e];r?.name&&t.setAttributeNS(null,r.name,r.value)}}({element:e,attrs:t.attrNS}),t.dataset?.length&&function setData(e){const{element:t,dataset:n}=e;if(n&&0!==n.length)for(let e=n.length-1;e>=0;e--){const r=n[e];r?.name&&(t.dataset[r.name]=r.value,"state"===r.name&&addElementToStore({key:r.value,value:t}))}}({element:e,dataset:t.dataset})}function removeElementFromStoreOrEvents(e){try{const t=getAnyExtension(),n=e;if(n.dataset?.state)return removeElementFromStore({key:n.dataset.state,mode:t?1:2,EventModule:t}),!0;if(t&&"function"==typeof t.removeAllEventsFromStore)return(0,t.removeAllEventsFromStore)(e),!0}catch{}return!1}/*! https://simplybuilder.github.io */
4
+ /*! SBCoreEvent version 2.0.0 */
5
+ const n={},r={};function eventRegister(e,t){if(!e||!t)return!1;const o=e.toUpperCase();return!n[o]&&(n[o]=e,r[n[o]]=t,!0)}function eventUnregister(e){if(!e)return!1;const t=e.toUpperCase(),o=n[t];return!!o&&(delete n[t],r[o]&&delete r[o],!0)}const o=new Map;function clearEvent(e,t=!1){const n=o.get(e);return(t||n&&0===n.length)&&(o.delete(e),e instanceof Element&&e.removeAttribute("listener")),!0}const s=Object.freeze({name:"SBCoreEvent",version:"2.0.0",EventTypes:n,EventActions:r,eventRegister,eventUnregister,addEventToStore:function addEventToStore(e){const{element:t,type:n,handler:r,eventId:s,nodeId:a}=e;if(!t||!n||!r)return!1;t instanceof Element&&!t.getAttribute("listener")&&t.setAttribute("listener","true"),o.has(t)||o.set(t,[]);const c={type:n,handler:r};return void 0!==a&&(c.nodeId=a),void 0!==s&&(c.eventId=s),o.get(t).push(c),t.addEventListener(n,r,!1),!0},removeAllEventsFromStore:function removeAllEventsFromStore(e){const t=o.get(e);if(!t||0===t.length)return!1;for(let n=t.length-1;n>=0;n--){const r=t[n];r&&e.removeEventListener(r.type,r.handler,!1)}return clearEvent(e,!0),!0},removeEventIdFromStore:function removeEventIdFromStore(e){const{element:t,eventId:n}=e,r=o.get(t);if(!r)return!1;const s=r.findIndex(e=>e.eventId===n);if(-1===s)return!1;const[a]=r.splice(s,1);return a&&t.removeEventListener(a.type,a.handler,!1),clearEvent(t),!0}});/*! https://simplybuilder.github.io */!function domModuleExtends(e){try{const{name:n}=e;if(function validVersionSupport(e){const{name:n,version:r}=e,o=t.allow[n];if(o&&r){const e=r.split(".");if(e.length>=1){if(void 0!==o.major&&e[0]&&o.major>Number(e[0]))return!1;if(void 0!==o.minor&&e[1]&&o.minor>Number(e[1]))return!1;if(void 0!==o.patch&&e[2]&&o.patch>Number(e[2]))return!1}return!0}return!1}(e))return t.register[n]=e,!0}catch{return!1}return!1}(s);const a="SBCore",c="2.0.0",l=Object.freeze({name:a,version:c,getElementFromStore:function getElementFromStore(t){if(t)return e[t]},createFromStruct:function createFromStruct(e){try{if("object"!=typeof e||!e)return!1;const{struct:t,parent:n=document.body}=e;if(!t?.element)return!1;const r=t.type&&"svg"===t.type.toLowerCase(),o=t.attr?Object.entries(t.attr).map(([e,t])=>({name:e,value:t})):[],s=t.dataset?Object.entries(t.dataset).map(([e,t])=>({name:e,value:t})):[];let a;if(r){const e=t.attrNS?Object.entries(t.attrNS).map(([e,t])=>({name:e,value:t})):[];a=function createSVGElement(e={}){try{const{parent:t,element:n}=e,r=document.createElementNS("http://www.w3.org/2000/svg",n.type);return applyAttributes(r,n),t&&(t instanceof HTMLElement||t instanceof SVGElement)&&t.appendChild(r),r}catch(e){return void console.error(e)}}({parent:n,element:{type:t.element,attr:o,attrNS:e,dataset:s}})}else{const e=function createHTMLElement(e={}){try{const{parent:t,element:n,shadow:r}=e,o=document.createElement(n.type);applyAttributes(o,n);const s=t??document.body;if((s instanceof HTMLElement||s instanceof SVGElement||s instanceof ShadowRoot)&&s.appendChild(o),r&&o.dataset?.state){const e=function createShadowFromConfig(e,t){if("string"==typeof t)return attachShadow(e,t);if("object"==typeof t&&null!==t&&"mode"in t){const n=t,r=attachShadow(e,n.mode);if(n.styles&&"undefined"!=typeof CSSStyleSheet)try{const e=new CSSStyleSheet;e.replaceSync(n.styles),r.adoptedStyleSheets=[e]}catch{}return r}}(o,r);if(e)return e}return o}catch(e){return void console.error(e)}}({parent:n,element:{type:t.element,attr:o,dataset:s},shadow:t.shadow});a=e instanceof ShadowRoot?e.host:e}if(!a)return!1;if(void 0!==t.text&&(a.textContent=t.text),void 0!==t.html&&(a.innerHTML=t.html),function createEventElement(e){const{struct:t,element:n}=e,r=getAnyExtension();if(r&&t.event?.action&&t.event?.type){const e=r.EventActions;if(e&&e[t.event.action]){const o={element:n,type:t.event.type,handler:e[t.event.action]};t.event.node&&(o.nodeId=t.event.node),(0,r.addEventToStore)(o)}}}({struct:t,element:a}),t.children&&t.children.length>0)for(const e of t.children)createFromStruct({struct:e,parent:a});return a}catch(e){return console.error(e),!1}},removeElement:function removeElement(e){if(!e)return;removeElementFromStoreOrEvents(e);const t=e.querySelectorAll('[listener="true"]');for(let e=t.length-1;e>=0;e--){const n=t[e];n&&removeElementFromStoreOrEvents(n)}const n=e.querySelectorAll("[data-state]");for(let e=n.length-1;e>=0;e--){const t=n[e];if(t){const e=getAnyExtension();removeElementFromStore({key:t.dataset.state,mode:e?1:2,EventModule:e}),t.removeAttribute("data-state")}}e.remove()},eventRegister,eventUnregister});exports.CoreModule=l,exports.default=l,exports.name=a,exports.version=c;
6
+ /*! https://simplybuilder.github.io */
package/lib/main.d.ts ADDED
@@ -0,0 +1,36 @@
1
+ /**
2
+ * @module CoreModule
3
+ * @description
4
+ * Unified integration layer for @simplybuilder/core-event and @simplybuilder/core-dom.
5
+ * On initialization, calls `domModuleExtends(EventModule)` to wire the two modules
6
+ * together, enabling declarative event binding in `createFromStruct` and automatic
7
+ * recursive listener cleanup in `removeElement`.
8
+ */
9
+ import { getElementFromStore, createFromStruct, removeElement } from '@simplybuilder/core-dom';
10
+ import { eventRegister, eventUnregister } from '@simplybuilder/core-event';
11
+ declare const name = "ModuleLibName";
12
+ declare const version = "ModuleLibVersion";
13
+ /**
14
+ * Frozen singleton combining DOM and event capabilities.
15
+ * Automatically integrates both modules via `domModuleExtends` at import time.
16
+ *
17
+ * @type {Object}
18
+ * @property {string} name - Module identifier.
19
+ * @property {string} version - Module version.
20
+ * @property {Function} getElementFromStore - Retrieve element from DOM store by key.
21
+ * @property {Function} createFromStruct - Build DOM tree with declarative event binding.
22
+ * @property {Function} removeElement - Remove element with recursive listener cleanup.
23
+ * @property {Function} eventRegister - Register a named event action.
24
+ * @property {Function} eventUnregister - Remove a named event action.
25
+ */
26
+ declare const CoreModule: Readonly<{
27
+ name: "ModuleLibName";
28
+ version: "ModuleLibVersion";
29
+ getElementFromStore: typeof getElementFromStore;
30
+ createFromStruct: typeof createFromStruct;
31
+ removeElement: typeof removeElement;
32
+ eventRegister: typeof eventRegister;
33
+ eventUnregister: typeof eventUnregister;
34
+ }>;
35
+ export { name, version, CoreModule };
36
+ export default CoreModule;
@@ -0,0 +1,6 @@
1
+ /*! SBCore version 2.0.0 */
2
+ /*! SBCoreDom version 2.0.0 */
3
+ const e={};function addElementToStore(t){const{key:n,value:r}=t;n&&r&&void 0===e[n]&&(e[n]=r)}function removeElementFromStore(t){const{key:n,mode:r=1,EventModule:o={}}=t;if(!n)return!1;try{const t=e[n];return!!t&&(1===r&&"function"==typeof o.removeAllEventsFromStore&&o.removeAllEventsFromStore(t),delete e[n],!0)}catch{return!1}}const t={app:{name:"DomModule",version:"2.0.0"},register:{},allow:{SBCoreEvent:{major:2}},clearExtensions(){for(const e of Object.keys(this.register))delete this.register[e]}};function getAnyExtension(){for(const e of Object.keys(t.register))return t.register[e]}function attachShadow(e,t){return e.attachShadow({mode:t})}function applyAttributes(e,t){t.attr?.length&&function setAttr(e){const{element:t,attrs:n}=e;if(n&&0!==n.length)for(let e=n.length-1;e>=0;e--){const r=n[e];r?.name&&t.setAttribute(r.name,r.value)}}({element:e,attrs:t.attr}),"attrNS"in t&&t.attrNS?.length&&function setAttrNS(e){const{element:t,attrs:n}=e;if(n&&0!==n.length)for(let e=n.length-1;e>=0;e--){const r=n[e];r?.name&&t.setAttributeNS(null,r.name,r.value)}}({element:e,attrs:t.attrNS}),t.dataset?.length&&function setData(e){const{element:t,dataset:n}=e;if(n&&0!==n.length)for(let e=n.length-1;e>=0;e--){const r=n[e];r?.name&&(t.dataset[r.name]=r.value,"state"===r.name&&addElementToStore({key:r.value,value:t}))}}({element:e,dataset:t.dataset})}function removeElementFromStoreOrEvents(e){try{const t=getAnyExtension(),n=e;if(n.dataset?.state)return removeElementFromStore({key:n.dataset.state,mode:t?1:2,EventModule:t}),!0;if(t&&"function"==typeof t.removeAllEventsFromStore)return(0,t.removeAllEventsFromStore)(e),!0}catch{}return!1}/*! https://simplybuilder.github.io */
4
+ /*! SBCoreEvent version 2.0.0 */
5
+ const n={},r={};function eventRegister(e,t){if(!e||!t)return!1;const o=e.toUpperCase();return!n[o]&&(n[o]=e,r[n[o]]=t,!0)}function eventUnregister(e){if(!e)return!1;const t=e.toUpperCase(),o=n[t];return!!o&&(delete n[t],r[o]&&delete r[o],!0)}const o=new Map;function clearEvent(e,t=!1){const n=o.get(e);return(t||n&&0===n.length)&&(o.delete(e),e instanceof Element&&e.removeAttribute("listener")),!0}const s=Object.freeze({name:"SBCoreEvent",version:"2.0.0",EventTypes:n,EventActions:r,eventRegister,eventUnregister,addEventToStore:function addEventToStore(e){const{element:t,type:n,handler:r,eventId:s,nodeId:a}=e;if(!t||!n||!r)return!1;t instanceof Element&&!t.getAttribute("listener")&&t.setAttribute("listener","true"),o.has(t)||o.set(t,[]);const c={type:n,handler:r};return void 0!==a&&(c.nodeId=a),void 0!==s&&(c.eventId=s),o.get(t).push(c),t.addEventListener(n,r,!1),!0},removeAllEventsFromStore:function removeAllEventsFromStore(e){const t=o.get(e);if(!t||0===t.length)return!1;for(let n=t.length-1;n>=0;n--){const r=t[n];r&&e.removeEventListener(r.type,r.handler,!1)}return clearEvent(e,!0),!0},removeEventIdFromStore:function removeEventIdFromStore(e){const{element:t,eventId:n}=e,r=o.get(t);if(!r)return!1;const s=r.findIndex(e=>e.eventId===n);if(-1===s)return!1;const[a]=r.splice(s,1);return a&&t.removeEventListener(a.type,a.handler,!1),clearEvent(t),!0}});/*! https://simplybuilder.github.io */!function domModuleExtends(e){try{const{name:n}=e;if(function validVersionSupport(e){const{name:n,version:r}=e,o=t.allow[n];if(o&&r){const e=r.split(".");if(e.length>=1){if(void 0!==o.major&&e[0]&&o.major>Number(e[0]))return!1;if(void 0!==o.minor&&e[1]&&o.minor>Number(e[1]))return!1;if(void 0!==o.patch&&e[2]&&o.patch>Number(e[2]))return!1}return!0}return!1}(e))return t.register[n]=e,!0}catch{return!1}return!1}(s);const a="SBCore",c="2.0.0",i=Object.freeze({name:a,version:c,getElementFromStore:function getElementFromStore(t){if(t)return e[t]},createFromStruct:function createFromStruct(e){try{if("object"!=typeof e||!e)return!1;const{struct:t,parent:n=document.body}=e;if(!t?.element)return!1;const r=t.type&&"svg"===t.type.toLowerCase(),o=t.attr?Object.entries(t.attr).map(([e,t])=>({name:e,value:t})):[],s=t.dataset?Object.entries(t.dataset).map(([e,t])=>({name:e,value:t})):[];let a;if(r){const e=t.attrNS?Object.entries(t.attrNS).map(([e,t])=>({name:e,value:t})):[];a=function createSVGElement(e={}){try{const{parent:t,element:n}=e,r=document.createElementNS("http://www.w3.org/2000/svg",n.type);return applyAttributes(r,n),t&&(t instanceof HTMLElement||t instanceof SVGElement)&&t.appendChild(r),r}catch(e){return void console.error(e)}}({parent:n,element:{type:t.element,attr:o,attrNS:e,dataset:s}})}else{const e=function createHTMLElement(e={}){try{const{parent:t,element:n,shadow:r}=e,o=document.createElement(n.type);applyAttributes(o,n);const s=t??document.body;if((s instanceof HTMLElement||s instanceof SVGElement||s instanceof ShadowRoot)&&s.appendChild(o),r&&o.dataset?.state){const e=function createShadowFromConfig(e,t){if("string"==typeof t)return attachShadow(e,t);if("object"==typeof t&&null!==t&&"mode"in t){const n=t,r=attachShadow(e,n.mode);if(n.styles&&"undefined"!=typeof CSSStyleSheet)try{const e=new CSSStyleSheet;e.replaceSync(n.styles),r.adoptedStyleSheets=[e]}catch{}return r}}(o,r);if(e)return e}return o}catch(e){return void console.error(e)}}({parent:n,element:{type:t.element,attr:o,dataset:s},shadow:t.shadow});a=e instanceof ShadowRoot?e.host:e}if(!a)return!1;if(void 0!==t.text&&(a.textContent=t.text),void 0!==t.html&&(a.innerHTML=t.html),function createEventElement(e){const{struct:t,element:n}=e,r=getAnyExtension();if(r&&t.event?.action&&t.event?.type){const e=r.EventActions;if(e&&e[t.event.action]){const o={element:n,type:t.event.type,handler:e[t.event.action]};t.event.node&&(o.nodeId=t.event.node),(0,r.addEventToStore)(o)}}}({struct:t,element:a}),t.children&&t.children.length>0)for(const e of t.children)createFromStruct({struct:e,parent:a});return a}catch(e){return console.error(e),!1}},removeElement:function removeElement(e){if(!e)return;removeElementFromStoreOrEvents(e);const t=e.querySelectorAll('[listener="true"]');for(let e=t.length-1;e>=0;e--){const n=t[e];n&&removeElementFromStoreOrEvents(n)}const n=e.querySelectorAll("[data-state]");for(let e=n.length-1;e>=0;e--){const t=n[e];if(t){const e=getAnyExtension();removeElementFromStore({key:t.dataset.state,mode:e?1:2,EventModule:e}),t.removeAttribute("data-state")}}e.remove()},eventRegister,eventUnregister});export{i as CoreModule,i as default,a as name,c as version};
6
+ /*! https://simplybuilder.github.io */
@@ -0,0 +1,39 @@
1
+ /*! SBCore version 2.0.0 */
2
+ /*! SBCoreDom version 2.0.0 */
3
+ const e$1={};function addElementToStore(t){const{key:n,value:r}=t;n&&r&&void 0===e$1[n]&&(e$1[n]=r);}function getElementFromStore(t){if(t)return e$1[t]}function removeElementFromStore(t){const{key:n,mode:r=1,EventModule:o={}}=t;if(!n)return false;try{const t=e$1[n];return !!t&&(1===r&&"function"==typeof o.removeAllEventsFromStore&&o.removeAllEventsFromStore(t),delete e$1[n],!0)}catch{return false}}const t$1={app:{name:"DomModule",version:"2.0.0"},register:{},allow:{SBCoreEvent:{major:2}},clearExtensions(){for(const e of Object.keys(this.register))delete this.register[e];}};function validVersionSupport(e){const{name:n,version:r}=e,o=t$1.allow[n];if(o&&r){const e=r.split(".");if(e.length>=1){if(void 0!==o.major&&e[0]&&o.major>Number(e[0]))return false;if(void 0!==o.minor&&e[1]&&o.minor>Number(e[1]))return false;if(void 0!==o.patch&&e[2]&&o.patch>Number(e[2]))return false}return true}return false}function domModuleExtends(e){try{const{name:n}=e;if(validVersionSupport(e))return t$1.register[n]=e,!0}catch{return false}return false}function getAnyExtension(){for(const e of Object.keys(t$1.register))return t$1.register[e]}function setAttr(e){const{element:t,attrs:n}=e;if(n&&0!==n.length)for(let e=n.length-1;e>=0;e--){const r=n[e];r?.name&&t.setAttribute(r.name,r.value);}}function setAttrNS(e){const{element:t,attrs:n}=e;if(n&&0!==n.length)for(let e=n.length-1;e>=0;e--){const r=n[e];r?.name&&t.setAttributeNS(null,r.name,r.value);}}function setData(e){const{element:t,dataset:n}=e;if(n&&0!==n.length)for(let e=n.length-1;e>=0;e--){const r=n[e];r?.name&&(t.dataset[r.name]=r.value,"state"===r.name&&addElementToStore({key:r.value,value:t}));}}function attachShadow(e,t){return e.attachShadow({mode:t})}function applyAttributes(e,t){t.attr?.length&&setAttr({element:e,attrs:t.attr}),"attrNS"in t&&t.attrNS?.length&&setAttrNS({element:e,attrs:t.attrNS}),t.dataset?.length&&setData({element:e,dataset:t.dataset});}function createHTMLElement(e={}){try{const{parent:t,element:n,shadow:r}=e,o=document.createElement(n.type);applyAttributes(o,n);const a=t??document.body;if((a instanceof HTMLElement||a instanceof SVGElement||a instanceof ShadowRoot)&&a.appendChild(o),r&&o.dataset?.state){const e=function createShadowFromConfig(e,t){if("string"==typeof t)return attachShadow(e,t);if("object"==typeof t&&null!==t&&"mode"in t){const n=t,r=attachShadow(e,n.mode);if(n.styles&&"undefined"!=typeof CSSStyleSheet)try{const e=new CSSStyleSheet;e.replaceSync(n.styles),r.adoptedStyleSheets=[e];}catch{}return r}}(o,r);if(e)return e}return o}catch(e){return void console.error(e)}}function createSVGElement(e={}){try{const{parent:t,element:n}=e,r=document.createElementNS("http://www.w3.org/2000/svg",n.type);return applyAttributes(r,n),t&&(t instanceof HTMLElement||t instanceof SVGElement)&&t.appendChild(r),r}catch(e){return void console.error(e)}}function createEventElement(e){const{struct:t,element:n}=e,r=getAnyExtension();if(r&&t.event?.action&&t.event?.type){const e=r.EventActions;if(e&&e[t.event.action]){const o={element:n,type:t.event.type,handler:e[t.event.action]};t.event.node&&(o.nodeId=t.event.node);(0, r.addEventToStore)(o);}}}function createFromStruct(e){try{if("object"!=typeof e||!e)return !1;const{struct:t,parent:n=document.body}=e;if(!t?.element)return !1;const r=t.type&&"svg"===t.type.toLowerCase(),o=t.attr?Object.entries(t.attr).map(([e,t])=>({name:e,value:t})):[],a=t.dataset?Object.entries(t.dataset).map(([e,t])=>({name:e,value:t})):[];let l;if(r){const e=t.attrNS?Object.entries(t.attrNS).map(([e,t])=>({name:e,value:t})):[];l=createSVGElement({parent:n,element:{type:t.element,attr:o,attrNS:e,dataset:a}});}else {const e=createHTMLElement({parent:n,element:{type:t.element,attr:o,dataset:a},shadow:t.shadow});l=e instanceof ShadowRoot?e.host:e;}if(!l)return !1;if(void 0!==t.text&&(l.textContent=t.text),void 0!==t.html&&(l.innerHTML=t.html),createEventElement({struct:t,element:l}),t.children&&t.children.length>0)for(const e of t.children)createFromStruct({struct:e,parent:l});return l}catch(e){return console.error(e),false}}function removeElementFromStoreOrEvents(e){try{const t=getAnyExtension(),n=e;if(n.dataset?.state)return removeElementFromStore({key:n.dataset.state,mode:t?1:2,EventModule:t}),!0;if(t&&"function"==typeof t.removeAllEventsFromStore){return (0,t.removeAllEventsFromStore)(e),!0}}catch{}return false}function removeElement(e){if(!e)return;removeElementFromStoreOrEvents(e);const t=e.querySelectorAll('[listener="true"]');for(let e=t.length-1;e>=0;e--){const n=t[e];n&&removeElementFromStoreOrEvents(n);}const n=e.querySelectorAll("[data-state]");for(let e=n.length-1;e>=0;e--){const t=n[e];if(t){const e=getAnyExtension();removeElementFromStore({key:t.dataset.state,mode:e?1:2,EventModule:e}),t.removeAttribute("data-state");}}e.remove();}/*! https://simplybuilder.github.io */
4
+ /*! SBCoreEvent version 2.0.0 */
5
+ const e={},t={};function eventRegister(n,r){if(!n||!r)return false;const o=n.toUpperCase();return !e[o]&&(e[o]=n,t[e[o]]=r,true)}function eventUnregister(n){if(!n)return false;const r=n.toUpperCase(),o=e[r];return !!o&&(delete e[r],t[o]&&delete t[o],true)}const n=new Map;function clearEvent(e,t=false){const r=n.get(e);return (t||r&&0===r.length)&&(n.delete(e),e instanceof Element&&e.removeAttribute("listener")),true}function addEventToStore(e){const{element:t,type:r,handler:o,eventId:s,nodeId:i}=e;if(!t||!r||!o)return false;t instanceof Element&&!t.getAttribute("listener")&&t.setAttribute("listener","true"),n.has(t)||n.set(t,[]);const v={type:r,handler:o};return void 0!==i&&(v.nodeId=i),void 0!==s&&(v.eventId=s),n.get(t).push(v),t.addEventListener(r,o,false),true}function removeAllEventsFromStore(e){const t=n.get(e);if(!t||0===t.length)return false;for(let n=t.length-1;n>=0;n--){const r=t[n];r&&e.removeEventListener(r.type,r.handler,false);}return clearEvent(e,true),true}function removeEventIdFromStore(e){const{element:t,eventId:r}=e,o=n.get(t);if(!o)return false;const s=o.findIndex(e=>e.eventId===r);if(-1===s)return false;const[i]=o.splice(s,1);return i&&t.removeEventListener(i.type,i.handler,false),clearEvent(t),true}const r="SBCoreEvent",o="2.0.0",s=Object.freeze({name:r,version:o,EventTypes:e,EventActions:t,eventRegister,eventUnregister,addEventToStore,removeAllEventsFromStore,removeEventIdFromStore});/*! https://simplybuilder.github.io */
6
+ /**
7
+ * @module CoreModule
8
+ * @description
9
+ * Unified integration layer for @simplybuilder/core-event and @simplybuilder/core-dom.
10
+ * On initialization, calls `domModuleExtends(EventModule)` to wire the two modules
11
+ * together, enabling declarative event binding in `createFromStruct` and automatic
12
+ * recursive listener cleanup in `removeElement`.
13
+ */
14
+ domModuleExtends(s);
15
+ const name = "SBCore";
16
+ const version = "2.0.0";
17
+ /**
18
+ * Frozen singleton combining DOM and event capabilities.
19
+ * Automatically integrates both modules via `domModuleExtends` at import time.
20
+ *
21
+ * @type {Object}
22
+ * @property {string} name - Module identifier.
23
+ * @property {string} version - Module version.
24
+ * @property {Function} getElementFromStore - Retrieve element from DOM store by key.
25
+ * @property {Function} createFromStruct - Build DOM tree with declarative event binding.
26
+ * @property {Function} removeElement - Remove element with recursive listener cleanup.
27
+ * @property {Function} eventRegister - Register a named event action.
28
+ * @property {Function} eventUnregister - Remove a named event action.
29
+ */
30
+ const CoreModule = Object.freeze({
31
+ name,
32
+ version,
33
+ getElementFromStore,
34
+ createFromStruct,
35
+ removeElement,
36
+ eventRegister,
37
+ eventUnregister,
38
+ });export{CoreModule,CoreModule as default,name,version};
39
+ /*! https://simplybuilder.github.io */
@@ -0,0 +1,2 @@
1
+ import { name, version, CoreModule } from "./main";
2
+ export { name, version, CoreModule };
package/package.json ADDED
@@ -0,0 +1,100 @@
1
+ {
2
+ "name": "@simplybuilder/core",
3
+ "version": "2.0.0",
4
+ "main": "lib/main.commonjs.min.cjs",
5
+ "module": "lib/main.esm.min.mjs",
6
+ "types": "lib/sb-core.d.ts",
7
+ "typings": "lib/sb-core.d.ts",
8
+ "exports": {
9
+ "./commonjs-module": {
10
+ "require": "./lib/main.commonjs.min.cjs"
11
+ },
12
+ "./esm-module": {
13
+ "import": "./lib/main.esm.min.mjs"
14
+ },
15
+ "./dts": {
16
+ "types": "./lib/main.d.ts"
17
+ },
18
+ "./sb-core": {
19
+ "types": "./lib/sb-core.d.ts"
20
+ },
21
+ ".": {
22
+ "types": "./lib/main.d.ts",
23
+ "import": "./lib/main.esm.min.mjs",
24
+ "require": "./lib/main.commonjs.min.cjs"
25
+ }
26
+ },
27
+ "files": [
28
+ "AUTHORS",
29
+ "CONTRIBUTING.md",
30
+ "GOVERNANCE.md",
31
+ "MAINTAINERS.md",
32
+ "lib/main.commonjs.cjs",
33
+ "lib/main.commonjs.min.cjs",
34
+ "lib/main.esm.min.mjs",
35
+ "lib/main.esm.mjs",
36
+ "lib/**/*.d.ts"
37
+ ],
38
+ "homepage": "https://simplybuilder.github.io",
39
+ "repository": {
40
+ "type": "git",
41
+ "url": "git+https://github.com/SimplyBuilder/sb-core-v2.git"
42
+ },
43
+ "bugs": {
44
+ "url": "https://github.com/SimplyBuilder/sb-core-v2/issues"
45
+ },
46
+ "author": "Jamil Services <jamilservicos@gmail.com> (https://github.com/jamilservicos)",
47
+ "funding": [
48
+ {
49
+ "type": "kofi",
50
+ "url": "https://ko-fi.com/juliojamil"
51
+ },
52
+ {
53
+ "type": "github",
54
+ "url": "https://github.com/sponsors/jamilservicos"
55
+ }
56
+ ],
57
+ "dependencies": {
58
+ "@simplybuilder/core-dom": "2.0.0",
59
+ "@simplybuilder/core-event": "2.0.0"
60
+ },
61
+ "devDependencies": {
62
+ "typescript": "^5.7.0",
63
+ "vitest": "^3.0.0"
64
+ },
65
+ "engines": {
66
+ "node": ">=18.0.0"
67
+ },
68
+ "license": "MIT",
69
+ "keywords": [
70
+ "jamilservicos",
71
+ "jamilservices",
72
+ "node",
73
+ "nodejs",
74
+ "node.js",
75
+ "javascript",
76
+ "typescript",
77
+ "simply-builder",
78
+ "simplybuilder",
79
+ "simply",
80
+ "builder",
81
+ "module",
82
+ "core",
83
+ "front",
84
+ "frontend",
85
+ "front-end",
86
+ "dom",
87
+ "event"
88
+ ],
89
+ "scripts": {
90
+ "clean": "rm -rf lib && rm -rf audit",
91
+ "build:js": "tsc -p tsconfig-audit.json",
92
+ "build:types": "tsc -p tsconfig-types.json",
93
+ "build:pre": "pnpm run clean && pnpm run build:js && pnpm run build:types",
94
+ "build:deps": "cd ../event && pnpm build && cd ../dom && pnpm build",
95
+ "build": "pnpm run build:deps && pnpm run build:pre && rollup -c ./rollup.config.js ",
96
+ "test": "vitest run",
97
+ "publish:pre": "pnpm build && pnpm test",
98
+ "publish:pack": "pnpm build && tar tvf $(npm pack)"
99
+ }
100
+ }