web-signature 0.1.3 → 0.1.4

package/bundle/d/index.d.ts

@@ -91,15 +91,93 @@ declare abstract class Component implements Component$1 {
 }
 type ComponentConstructor = new () => Component;
 
+type LibMeta = {
+    name: string;
+    version?: string;
+    author?: string;
+    components: string[];
+    dependencies: Record<string, LibMeta>;
+};
+declare class Library {
+    readonly name: string;
+    readonly version?: string;
+    readonly author?: string;
+    libs: Record<string, LibMeta>;
+    private components;
+    /**
+     * @param {string} name The name of the library.
+     * @param {string} [author] Optional author of the library.
+     * @param {string} [version] Optional version of the library.
+     */
+    constructor(name: string, author?: string, version?: string);
+    /**
+     * Registers a component in the library.
+     * @param {ComponentConstructor} component The component to register.
+     * @param {string} [name] Optional name for the component. If not provided, uses the component's name property.
+     */
+    add(component: ComponentConstructor, name?: string): void;
+    /**
+     * Registers a library.
+     * @import {Library} from "./Library.js";
+     * @param {Library} library The library to register.
+     * @param {string[]} exclude Optional array of component names to exclude from the library registration.
+     */
+    register(library: Library, ...exclude: string[]): void;
+    /**
+     * Retrieves a component by its name.
+     * @param {string} name The name of the component to retrieve.
+     * @return {ComponentConstructor | undefined} The component associated with the name, or undefined if it does not exist.
+     */
+    get(name: string): ComponentConstructor | undefined;
+    /**
+     * Returns a library.
+     * @param {string} name The name of the library.
+     * @return {LibMeta}
+     */
+    lib(name: string): LibMeta | undefined;
+    /**
+     * Lists all registered components in the library.
+     * @return {Array<{ component: ComponentConstructor, name: string }>} An array of objects containing component constructors and their names.
+     */
+    list(): Array<{
+        component: ComponentConstructor;
+        name: string;
+    }>;
+}
+
+type ResolvedLib = {
+    components: string[];
+    dependencies: Record<string, ResolvedLib>;
+};
 declare class Signature {
     private components;
     private refs;
+    private libs;
     constructor();
     /**
      * Adds a component to the signature.
      * @param {ComponentConstructor} component The component to add.
+     * @param {string} name Optional name for the component. If not provided, uses the component's name property.
+     */
+    add(component: ComponentConstructor, name?: string): void;
+    /**
+     * Registers a library in the signature.
+     * @import {Library} from "./Library.js";
+     * @param {Library} library The library to register.
+     * @param {string[]} exclude Optional array of component names to exclude from the library registration.
+     */
+    register(library: Library, ...exclude: string[]): void;
+    /**
+     * Returns a library.
+     * @param {string} name The name of the library.
+     * @return {LibMeta}
+     */
+    lib(name: string): LibMeta | undefined;
+    /**
+     * Returns a formatted object of all libraries in the signature.
+     * @return {Record<string, ResolvedLib>} A object of formatted libraries with their components and dependencies.
      */
-    add(component: ComponentConstructor): void;
+    libraries(): Record<string, ResolvedLib>;
     /**
      * Returns a reference.
      * @param {string} name The name of the reference.
@@ -141,4 +219,4 @@ declare class Prop<T extends keyof TypesMap> implements Prop$1 {
 
 declare function export_default(): Signature;
 
-export { Component, Prop, Signature, export_default as default };
+export { Component, Library, Prop, Signature, export_default as default };

package/bundle/index.js

@@ -22,17 +22,79 @@ let _counter = 0;
 class Signature {
     components = {};
     refs = {};
+    libs = {};
     constructor() {
     }
     /**
      * Adds a component to the signature.
      * @param {ComponentConstructor} component The component to add.
+     * @param {string} name Optional name for the component. If not provided, uses the component's name property.
      */
-    add(component) {
-        if (this.components[component.name]) {
-            console.warn(new Error(`Component with name ${component.name} already exists.`));
+    add(component, name) {
+        const key = typeof name === "string" ? name : component.name;
+        if (this.components[key]) {
+            console.warn(new Error(`Component with name ${key} already exists.`));
         }
-        this.components[component.name] = component;
+        this.components[key] = component;
+    }
+    /**
+     * Registers a library in the signature.
+     * @import {Library} from "./Library.js";
+     * @param {Library} library The library to register.
+     * @param {string[]} exclude Optional array of component names to exclude from the library registration.
+     */
+    register(library, ...exclude) {
+        if (this.libs[library.name]) {
+            console.warn(new Error(`Library with name ${library.name} already exists.`));
+        }
+        const components = library.list().filter(com => !(com.name in exclude));
+        this.libs[library.name] = {
+            name: library.name,
+            version: library.version,
+            author: library.author,
+            components: components.map(com => com.name),
+            dependencies: library.libs
+        };
+        for (const com of components) {
+            this.add(com.component, `${library.name}-${com.name}`);
+        }
+    }
+    /**
+     * Returns a library.
+     * @param {string} name The name of the library.
+     * @return {LibMeta}
+     */
+    lib(name) {
+        return this.libs[name];
+    }
+    /**
+     * Returns a formatted object of all libraries in the signature.
+     * @return {Record<string, ResolvedLib>} A object of formatted libraries with their components and dependencies.
+     */
+    libraries() {
+        const formatKey = (lib) => {
+            let key = lib.name;
+            if (lib.version)
+                key += `@${lib.version}`;
+            if (lib.author)
+                key += `#${lib.author}`;
+            return key;
+        };
+        const resolve = (libs, visited = new Set()) => {
+            const result = {};
+            for (const [_, lib] of Object.entries(libs)) {
+                const key = formatKey(lib);
+                if (visited.has(key))
+                    continue;
+                visited.add(key);
+                result[key] = {
+                    components: lib.components,
+                    dependencies: resolve(lib.dependencies, visited)
+                };
+            }
+            return result;
+        };
+        return resolve(this.libs);
     }
     /**
      * Returns a reference.
@@ -276,8 +338,87 @@ class Prop {
     }
 }
 
+class Library {
+    name;
+    version;
+    author;
+    libs = {};
+    components = {};
+    /**
+     * @param {string} name The name of the library.
+     * @param {string} [author] Optional author of the library.
+     * @param {string} [version] Optional version of the library.
+     */
+    constructor(name, author, version) {
+        this.name = name;
+        // optional properties
+        this.author = author;
+        this.version = version;
+    }
+    /**
+     * Registers a component in the library.
+     * @param {ComponentConstructor} component The component to register.
+     * @param {string} [name] Optional name for the component. If not provided, uses the component's name property.
+     */
+    add(component, name) {
+        const key = typeof name === "string" ? name : component.name;
+        if (this.components[key]) {
+            console.warn(new Error(`Component with name ${key} already exists.`));
+        }
+        this.components[key] = component;
+    }
+    /**
+     * Registers a library.
+     * @import {Library} from "./Library.js";
+     * @param {Library} library The library to register.
+     * @param {string[]} exclude Optional array of component names to exclude from the library registration.
+     */
+    register(library, ...exclude) {
+        if (this.libs[library.name]) {
+            console.warn(new Error(`Library with name ${library.name} already exists in ${this.name}.`));
+        }
+        const components = library.list().filter(com => !(com.name in exclude));
+        this.libs[library.name] = {
+            name: library.name,
+            version: library.version,
+            author: library.author,
+            components: components.map(com => com.name),
+            dependencies: library.libs
+        };
+        for (const com of components) {
+            this.add(com.component, `${library.name}-${com.name}`);
+        }
+    }
+    /**
+     * Retrieves a component by its name.
+     * @param {string} name The name of the component to retrieve.
+     * @return {ComponentConstructor | undefined} The component associated with the name, or undefined if it does not exist.
+     */
+    get(name) {
+        return this.components[name];
+    }
+    /**
+     * Returns a library.
+     * @param {string} name The name of the library.
+     * @return {LibMeta}
+     */
+    lib(name) {
+        return this.libs[name];
+    }
+    /**
+     * Lists all registered components in the library.
+     * @return {Array<{ component: ComponentConstructor, name: string }>} An array of objects containing component constructors and their names.
+     */
+    list() {
+        return Object.entries(this.components).map(([name, component]) => ({
+            component,
+            name
+        }));
+    }
+}
+
 function index () {
     return new Signature();
 }
 
-export { Component, Prop, Signature, index as default };
+export { Component, Library, Prop, Signature, index as default };

package/bundle/index.min.js

@@ -1 +1 @@
-class e{element;instance;constructor(e,t){this.instance=e,this.element=t}}const t={"element-not-found":"Element not found for selector: #selector","prop-is-required":"Property '#prop' in component '#component' is required but not provided.","unsupported-type-for-property":"Unsupported type for property '#prop' in component '#component': #type","invalid-value-for-property":"Invalid value for property '#prop' in component '#component': #value (value: #attr)","multiple-root-elements":"Component '#component' must render a single root element. \n\t#elements","ref-collision":"Ref collision detected for ref '#ref' in component '#component'.",unknown:"An unknown error occurred.","unknown-from":"An unknown error occurred in component '#from'."};let n=0;class r{components={};refs={};constructor(){}add(e){this.components[e.name]&&console.warn(new Error(`Component with name ${e.name} already exists.`)),this.components[e.name]=e}ref(e){return this.refs[e]?.element}contactWith(e,...t){const n=this.refs[e];if(!n)throw new Error(`Ref with name ${e} does not exist.`);const r=n.instance;return r.onContact?.(...t)}updateRef(e){const t=this.refs[e];if(!t)throw new Error(`Ref with name ${e} does not exist.`);const n=t.instance,r=n.render().trim(),o=document.createElement("template");if(o.innerHTML=r,1!==o.content.children.length)throw new Error(`Component '${n.name}' must render a single root element.`);const i=o.content.firstElementChild;this.render(o),n.onRender?.(),t.element.replaceWith(i),t.element=i,n.onMount?.(i)}contact(e){new Promise((t,n)=>{try{const t=document.querySelector(e);if(!t)return void n({id:"element-not-found",selector:e});const r=document.createElement("div");r.innerHTML=t.innerHTML,this.render(r),t.replaceChildren(...Array.from(r.childNodes))}catch(e){e instanceof Error?n({id:"unknown",err:e}):n(e)}}).then(()=>{}).catch(e=>{let n=t[e.id];throw Object.keys(e).filter(e=>!(e in["id","err"])).forEach(t=>{n=n.replace(`#${t}`,String(e[t]))}),e.id in["unknown","unknown-from"]?console.error(`[${e.id}] ${n}`,e.err):console.error(`[${e.id}] ${n}`),"Page rendering was interrupted by Signature due to the above error."})}render(t){for(const r of Object.keys(this.components)){const o=this.components[r];for(const i of Array.from(t.querySelectorAll(r))){const t=new o;if(t.onInit?.(),i instanceof HTMLElement){t.content=i.innerHTML.trim();for(const e of Object.keys(t.props)){const n=i.getAttribute(e);if(null===n){if(t.props[e].required)throw{id:"prop-is-required",component:r,prop:e};t.data[e]=null}else if(""===n){if(t.props[e].required)throw{id:"prop-is-required",component:r,prop:e};t.props[e].isValid(n)&&(t.data[e]=null)}else{let o;switch(t.props[e].type){case"boolean":o=Boolean(n);break;case"number":o=Number(n);break;case"string":o=String(n);break;default:if(t.props[e].required)throw{id:"unsupported-type-for-property",component:r,prop:e,type:t.props[e].type}}if(void 0!==o){if(!t.props[e].isValid(o))throw{id:"invalid-value-for-property",component:r,prop:e,value:o,attr:n};if(t.props[e].validate&&!t.props[e].validate(o))throw{id:"invalid-value-for-property",component:r,prop:e,value:o,attr:n};t.data[e]=o,t.onPropParsed?.(t.props[e],o)}}}t.onPropsParsed?.()}const s=document.createElement("template");try{s.innerHTML=t.render().trim()}catch(e){if(e instanceof Error)throw{id:"unknown-from",from:t.name,err:e}}if(s.content.children.length>1)throw{id:"multiple-root-elements",component:r,elements:s.innerHTML};this.render(s),t.onRender?.();const p=s.content.firstElementChild;if(i.hasAttribute("ref")){let o=i.getAttribute("ref");if(n++,""===o&&(o=`r${n}${Math.random().toString(36).substring(2,15)}${n}`),this.refs[o])throw{id:"ref-collision",ref:o,component:r};this.refs[o]=new e(t,p),p.setAttribute("ref",o)}i.replaceWith(s.content),t.onMount?.(p)}}}}class o{content;props={};data={}}class i{type;required=!0;validate;constructor(e,t=!0,n){this.type=e,this.required=t,this.validate=n||(()=>!0)}isValid(e){switch(this.type){case"boolean":return"boolean"==typeof e;case"number":return"number"==typeof e&&!isNaN(e);case"string":return"string"==typeof e;case"null":return null===e;default:return!1}}}function s(){return new r}export{o as Component,i as Prop,r as Signature,s as default};
+class e{element;instance;constructor(e,n){this.instance=e,this.element=n}}const n={"element-not-found":"Element not found for selector: #selector","prop-is-required":"Property '#prop' in component '#component' is required but not provided.","unsupported-type-for-property":"Unsupported type for property '#prop' in component '#component': #type","invalid-value-for-property":"Invalid value for property '#prop' in component '#component': #value (value: #attr)","multiple-root-elements":"Component '#component' must render a single root element. \n\t#elements","ref-collision":"Ref collision detected for ref '#ref' in component '#component'.",unknown:"An unknown error occurred.","unknown-from":"An unknown error occurred in component '#from'."};let t=0;class r{components={};refs={};libs={};constructor(){}add(e,n){const t="string"==typeof n?n:e.name;this.components[t]&&console.warn(new Error(`Component with name ${t} already exists.`)),this.components[t]=e}register(e,...n){this.libs[e.name]&&console.warn(new Error(`Library with name ${e.name} already exists.`));const t=e.list().filter(e=>!(e.name in n));this.libs[e.name]={name:e.name,version:e.version,author:e.author,components:t.map(e=>e.name),dependencies:e.libs};for(const n of t)this.add(n.component,`${e.name}-${n.name}`)}lib(e){return this.libs[e]}libraries(){const e=e=>{let n=e.name;return e.version&&(n+=`@${e.version}`),e.author&&(n+=`#${e.author}`),n},n=(t,r=new Set)=>{const o={};for(const[i,s]of Object.entries(t)){const t=e(s);r.has(t)||(r.add(t),o[t]={components:s.components,dependencies:n(s.dependencies,r)})}return o};return n(this.libs)}ref(e){return this.refs[e]?.element}contactWith(e,...n){const t=this.refs[e];if(!t)throw new Error(`Ref with name ${e} does not exist.`);const r=t.instance;return r.onContact?.(...n)}updateRef(e){const n=this.refs[e];if(!n)throw new Error(`Ref with name ${e} does not exist.`);const t=n.instance,r=t.render().trim(),o=document.createElement("template");if(o.innerHTML=r,1!==o.content.children.length)throw new Error(`Component '${t.name}' must render a single root element.`);const i=o.content.firstElementChild;this.render(o),t.onRender?.(),n.element.replaceWith(i),n.element=i,t.onMount?.(i)}contact(e){new Promise((n,t)=>{try{const n=document.querySelector(e);if(!n)return void t({id:"element-not-found",selector:e});const r=document.createElement("div");r.innerHTML=n.innerHTML,this.render(r),n.replaceChildren(...Array.from(r.childNodes))}catch(e){e instanceof Error?t({id:"unknown",err:e}):t(e)}}).then(()=>{}).catch(e=>{let t=n[e.id];throw Object.keys(e).filter(e=>!(e in["id","err"])).forEach(n=>{t=t.replace(`#${n}`,String(e[n]))}),e.id in["unknown","unknown-from"]?console.error(`[${e.id}] ${t}`,e.err):console.error(`[${e.id}] ${t}`),"Page rendering was interrupted by Signature due to the above error."})}render(n){for(const r of Object.keys(this.components)){const o=this.components[r];for(const i of Array.from(n.querySelectorAll(r))){const n=new o;if(n.onInit?.(),i instanceof HTMLElement){n.content=i.innerHTML.trim();for(const e of Object.keys(n.props)){const t=i.getAttribute(e);if(null===t){if(n.props[e].required)throw{id:"prop-is-required",component:r,prop:e};n.data[e]=null}else if(""===t){if(n.props[e].required)throw{id:"prop-is-required",component:r,prop:e};n.props[e].isValid(t)&&(n.data[e]=null)}else{let o;switch(n.props[e].type){case"boolean":o=Boolean(t);break;case"number":o=Number(t);break;case"string":o=String(t);break;default:if(n.props[e].required)throw{id:"unsupported-type-for-property",component:r,prop:e,type:n.props[e].type}}if(void 0!==o){if(!n.props[e].isValid(o))throw{id:"invalid-value-for-property",component:r,prop:e,value:o,attr:t};if(n.props[e].validate&&!n.props[e].validate(o))throw{id:"invalid-value-for-property",component:r,prop:e,value:o,attr:t};n.data[e]=o,n.onPropParsed?.(n.props[e],o)}}}n.onPropsParsed?.()}const s=document.createElement("template");try{s.innerHTML=n.render().trim()}catch(e){if(e instanceof Error)throw{id:"unknown-from",from:n.name,err:e}}if(s.content.children.length>1)throw{id:"multiple-root-elements",component:r,elements:s.innerHTML};this.render(s),n.onRender?.();const a=s.content.firstElementChild;if(i.hasAttribute("ref")){let o=i.getAttribute("ref");if(t++,""===o&&(o=`r${t}${Math.random().toString(36).substring(2,15)}${t}`),this.refs[o])throw{id:"ref-collision",ref:o,component:r};this.refs[o]=new e(n,a),a.setAttribute("ref",o)}i.replaceWith(s.content),n.onMount?.(a)}}}}class o{content;props={};data={}}class i{type;required=!0;validate;constructor(e,n=!0,t){this.type=e,this.required=n,this.validate=t||(()=>!0)}isValid(e){switch(this.type){case"boolean":return"boolean"==typeof e;case"number":return"number"==typeof e&&!isNaN(e);case"string":return"string"==typeof e;case"null":return null===e;default:return!1}}}class s{name;version;author;libs={};components={};constructor(e,n,t){this.name=e,this.author=n,this.version=t}add(e,n){const t="string"==typeof n?n:e.name;this.components[t]&&console.warn(new Error(`Component with name ${t} already exists.`)),this.components[t]=e}register(e,...n){this.libs[e.name]&&console.warn(new Error(`Library with name ${e.name} already exists in ${this.name}.`));const t=e.list().filter(e=>!(e.name in n));this.libs[e.name]={name:e.name,version:e.version,author:e.author,components:t.map(e=>e.name),dependencies:e.libs};for(const n of t)this.add(n.component,`${e.name}-${n.name}`)}get(e){return this.components[e]}lib(e){return this.libs[e]}list(){return Object.entries(this.components).map(([e,n])=>({component:n,name:e}))}}function a(){return new r}export{o as Component,s as Library,i as Prop,r as Signature,a as default};

package/dist/Library.js

@@ -0,0 +1,78 @@
+export default class Library {
+    name;
+    version;
+    author;
+    libs = {};
+    components = {};
+    /**
+     * @param {string} name The name of the library.
+     * @param {string} [author] Optional author of the library.
+     * @param {string} [version] Optional version of the library.
+     */
+    constructor(name, author, version) {
+        this.name = name;
+        // optional properties
+        this.author = author;
+        this.version = version;
+    }
+    /**
+     * Registers a component in the library.
+     * @param {ComponentConstructor} component The component to register.
+     * @param {string} [name] Optional name for the component. If not provided, uses the component's name property.
+     */
+    add(component, name) {
+        const key = typeof name === "string" ? name : component.name;
+        if (this.components[key]) {
+            console.warn(new Error(`Component with name ${key} already exists.`));
+        }
+        this.components[key] = component;
+    }
+    /**
+     * Registers a library.
+     * @import {Library} from "./Library.js";
+     * @param {Library} library The library to register.
+     * @param {string[]} exclude Optional array of component names to exclude from the library registration.
+     */
+    register(library, ...exclude) {
+        if (this.libs[library.name]) {
+            console.warn(new Error(`Library with name ${library.name} already exists in ${this.name}.`));
+        }
+        const components = library.list().filter(com => !(com.name in exclude));
+        this.libs[library.name] = {
+            name: library.name,
+            version: library.version,
+            author: library.author,
+            components: components.map(com => com.name),
+            dependencies: library.libs
+        };
+        for (const com of components) {
+            this.add(com.component, `${library.name}-${com.name}`);
+        }
+    }
+    /**
+     * Retrieves a component by its name.
+     * @param {string} name The name of the component to retrieve.
+     * @return {ComponentConstructor | undefined} The component associated with the name, or undefined if it does not exist.
+     */
+    get(name) {
+        return this.components[name];
+    }
+    /**
+     * Returns a library.
+     * @param {string} name The name of the library.
+     * @return {LibMeta}
+     */
+    lib(name) {
+        return this.libs[name];
+    }
+    /**
+     * Lists all registered components in the library.
+     * @return {Array<{ component: ComponentConstructor, name: string }>} An array of objects containing component constructors and their names.
+     */
+    list() {
+        return Object.entries(this.components).map(([name, component]) => ({
+            component,
+            name
+        }));
+    }
+}

package/dist/Signature.js

@@ -4,17 +4,79 @@ let _counter = 0;
 export default class Signature {
     components = {};
     refs = {};
+    libs = {};
     constructor() {
     }
     /**
      * Adds a component to the signature.
      * @param {ComponentConstructor} component The component to add.
+     * @param {string} name Optional name for the component. If not provided, uses the component's name property.
      */
-    add(component) {
-        if (this.components[component.name]) {
-            console.warn(new Error(`Component with name ${component.name} already exists.`));
+    add(component, name) {
+        const key = typeof name === "string" ? name : component.name;
+        if (this.components[key]) {
+            console.warn(new Error(`Component with name ${key} already exists.`));
         }
-        this.components[component.name] = component;
+        this.components[key] = component;
+    }
+    /**
+     * Registers a library in the signature.
+     * @import {Library} from "./Library.js";
+     * @param {Library} library The library to register.
+     * @param {string[]} exclude Optional array of component names to exclude from the library registration.
+     */
+    register(library, ...exclude) {
+        if (this.libs[library.name]) {
+            console.warn(new Error(`Library with name ${library.name} already exists.`));
+        }
+        const components = library.list().filter(com => !(com.name in exclude));
+        this.libs[library.name] = {
+            name: library.name,
+            version: library.version,
+            author: library.author,
+            components: components.map(com => com.name),
+            dependencies: library.libs
+        };
+        for (const com of components) {
+            this.add(com.component, `${library.name}-${com.name}`);
+        }
+    }
+    /**
+     * Returns a library.
+     * @param {string} name The name of the library.
+     * @return {LibMeta}
+     */
+    lib(name) {
+        return this.libs[name];
+    }
+    /**
+     * Returns a formatted object of all libraries in the signature.
+     * @return {Record<string, ResolvedLib>} A object of formatted libraries with their components and dependencies.
+     */
+    libraries() {
+        const formatKey = (lib) => {
+            let key = lib.name;
+            if (lib.version)
+                key += `@${lib.version}`;
+            if (lib.author)
+                key += `#${lib.author}`;
+            return key;
+        };
+        const resolve = (libs, visited = new Set()) => {
+            const result = {};
+            for (const [_, lib] of Object.entries(libs)) {
+                const key = formatKey(lib);
+                if (visited.has(key))
+                    continue;
+                visited.add(key);
+                result[key] = {
+                    components: lib.components,
+                    dependencies: resolve(lib.dependencies, visited)
+                };
+            }
+            return result;
+        };
+        return resolve(this.libs);
     }
     /**
      * Returns a reference.

package/dist/d/Library.d.ts

@@ -0,0 +1,55 @@
+import { ComponentConstructor } from "./Component.js";
+type LibMeta = {
+    name: string;
+    version?: string;
+    author?: string;
+    components: string[];
+    dependencies: Record<string, LibMeta>;
+};
+export default class Library {
+    readonly name: string;
+    readonly version?: string;
+    readonly author?: string;
+    libs: Record<string, LibMeta>;
+    private components;
+    /**
+     * @param {string} name The name of the library.
+     * @param {string} [author] Optional author of the library.
+     * @param {string} [version] Optional version of the library.
+     */
+    constructor(name: string, author?: string, version?: string);
+    /**
+     * Registers a component in the library.
+     * @param {ComponentConstructor} component The component to register.
+     * @param {string} [name] Optional name for the component. If not provided, uses the component's name property.
+     */
+    add(component: ComponentConstructor, name?: string): void;
+    /**
+     * Registers a library.
+     * @import {Library} from "./Library.js";
+     * @param {Library} library The library to register.
+     * @param {string[]} exclude Optional array of component names to exclude from the library registration.
+     */
+    register(library: Library, ...exclude: string[]): void;
+    /**
+     * Retrieves a component by its name.
+     * @param {string} name The name of the component to retrieve.
+     * @return {ComponentConstructor | undefined} The component associated with the name, or undefined if it does not exist.
+     */
+    get(name: string): ComponentConstructor | undefined;
+    /**
+     * Returns a library.
+     * @param {string} name The name of the library.
+     * @return {LibMeta}
+     */
+    lib(name: string): LibMeta | undefined;
+    /**
+     * Lists all registered components in the library.
+     * @return {Array<{ component: ComponentConstructor, name: string }>} An array of objects containing component constructors and their names.
+     */
+    list(): Array<{
+        component: ComponentConstructor;
+        name: string;
+    }>;
+}
+export { LibMeta };

package/dist/d/Signature.d.ts

@@ -1,13 +1,38 @@
 import { ComponentConstructor } from "./Component.js";
+import Library, { LibMeta } from "./Library.js";
+type ResolvedLib = {
+    components: string[];
+    dependencies: Record<string, ResolvedLib>;
+};
 export default class Signature {
     private components;
     private refs;
+    private libs;
     constructor();
     /**
      * Adds a component to the signature.
      * @param {ComponentConstructor} component The component to add.
+     * @param {string} name Optional name for the component. If not provided, uses the component's name property.
      */
-    add(component: ComponentConstructor): void;
+    add(component: ComponentConstructor, name?: string): void;
+    /**
+     * Registers a library in the signature.
+     * @import {Library} from "./Library.js";
+     * @param {Library} library The library to register.
+     * @param {string[]} exclude Optional array of component names to exclude from the library registration.
+     */
+    register(library: Library, ...exclude: string[]): void;
+    /**
+     * Returns a library.
+     * @param {string} name The name of the library.
+     * @return {LibMeta}
+     */
+    lib(name: string): LibMeta | undefined;
+    /**
+     * Returns a formatted object of all libraries in the signature.
+     * @return {Record<string, ResolvedLib>} A object of formatted libraries with their components and dependencies.
+     */
+    libraries(): Record<string, ResolvedLib>;
     /**
      * Returns a reference.
      * @param {string} name The name of the reference.
@@ -32,3 +57,4 @@ export default class Signature {
     contact(selector: string): void;
     private render;
 }
+export {};

package/dist/d/index.d.ts

@@ -3,3 +3,4 @@ export default function (): Signature;
 export { default as Signature } from './Signature.js';
 export { default as Component } from './Component.js';
 export { default as Prop } from './Prop.js';
+export { default as Library } from './Library.js';

package/dist/index.js

@@ -5,3 +5,4 @@ export default function () {
 export { default as Signature } from './Signature.js';
 export { default as Component } from './Component.js';
 export { default as Prop } from './Prop.js';
+export { default as Library } from './Library.js';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "web-signature",
-  "version": "0.1.3",
+  "version": "0.1.4",
   "description": "Primitive and fast framework for rendering web interfaces",
   "license": "ISC",
   "author": "PinBib",

package/src/Library.ts

@@ -0,0 +1,108 @@
+import {ComponentConstructor} from "./Component.js";
+
+type LibMeta = {
+	name: string,
+	version?: string,
+	author?: string,
+	components: string[],
+	dependencies: Record<string, LibMeta>
+};
+
+export default class Library {
+	public readonly name: string;
+	public readonly version?: string;
+	public readonly author?: string;
+
+	public libs: Record<string, LibMeta> = {};
+
+	private components: Record<string, ComponentConstructor> = {};
+
+	/**
+	 * @param {string} name The name of the library.
+	 * @param {string} [author] Optional author of the library.
+	 * @param {string} [version] Optional version of the library.
+	 */
+	constructor(name: string, author?: string, version?: string) {
+		this.name = name;
+
+		// optional properties
+		this.author = author;
+		this.version = version;
+	}
+
+	/**
+	 * Registers a component in the library.
+	 * @param {ComponentConstructor} component The component to register.
+	 * @param {string} [name] Optional name for the component. If not provided, uses the component's name property.
+	 */
+	public add(component: ComponentConstructor, name?: string): void {
+		const key = typeof name === "string" ? name : component.name;
+
+		if (this.components[key]) {
+			console.warn(new Error(`Component with name ${key} already exists.`));
+		}
+
+		this.components[key] = component;
+	}
+
+	/**
+	 * Registers a library.
+	 * @import {Library} from "./Library.js";
+	 * @param {Library} library The library to register.
+	 * @param {string[]} exclude Optional array of component names to exclude from the library registration.
+	 */
+	public register(library: Library, ...exclude: string[]): void {
+		if (this.libs[library.name]) {
+			console.warn(new Error(`Library with name ${library.name} already exists in ${this.name}.`));
+		}
+
+		const components: Array<{
+			component: ComponentConstructor,
+			name: string
+		}> = library.list().filter(com => !(com.name in exclude));
+
+		this.libs[library.name] = {
+			name: library.name,
+			version: library.version,
+			author: library.author,
+			components: components.map(com => com.name),
+			dependencies: library.libs
+		};
+
+		for (const com of components) {
+			this.add(com.component, `${library.name}-${com.name}`);
+		}
+	}
+
+	/**
+	 * Retrieves a component by its name.
+	 * @param {string} name The name of the component to retrieve.
+	 * @return {ComponentConstructor | undefined} The component associated with the name, or undefined if it does not exist.
+	 */
+	public get(name: string): ComponentConstructor | undefined {
+		return this.components[name];
+	}
+
+	/**
+	 * Returns a library.
+	 * @param {string} name The name of the library.
+	 * @return {LibMeta}
+	 */
+	public lib(name: string): LibMeta | undefined {
+		return this.libs[name];
+	}
+
+	/**
+	 * Lists all registered components in the library.
+	 * @return {Array<{ component: ComponentConstructor, name: string }>} An array of objects containing component constructors and their names.
+	 */
+	public list(): Array<{ component: ComponentConstructor, name: string }> {
+		return Object.entries(this.components).map(([name, component]) => ({
+			component,
+			name
+		}));
+	}
+
+}
+
+export {LibMeta};

package/src/Signature.ts

@@ -2,12 +2,19 @@ import Component, {ComponentConstructor} from "./Component.js";
 import Ref from "./Ref.js";
 import ErrorUnion from "./types/Errors.js";
 import Errors from "./Errors.js";
+import Library, {LibMeta} from "./Library.js";
 
 let _counter = 0;
 
+type ResolvedLib = {
+	components: string[],
+	dependencies: Record<string, ResolvedLib>
+};
+
 export default class Signature {
 	private components: Record<string, ComponentConstructor> = {};
 	private refs: Record<string, Ref> = {};
+	private libs: Record<string, LibMeta> = {};
 
 	constructor() {
 	}
@@ -15,13 +22,89 @@ export default class Signature {
 	/**
 	 * Adds a component to the signature.
 	 * @param {ComponentConstructor} component The component to add.
+	 * @param {string} name Optional name for the component. If not provided, uses the component's name property.
 	 */
-	public add(component: ComponentConstructor): void {
-		if (this.components[component.name]) {
-			console.warn(new Error(`Component with name ${component.name} already exists.`));
+	public add(component: ComponentConstructor, name?: string): void {
+		const key = typeof name === "string" ? name : component.name;
+
+		if (this.components[key]) {
+			console.warn(new Error(`Component with name ${key} already exists.`));
 		}
 
-		this.components[component.name] = component;
+		this.components[key] = component;
+	}
+
+	/**
+	 * Registers a library in the signature.
+	 * @import {Library} from "./Library.js";
+	 * @param {Library} library The library to register.
+	 * @param {string[]} exclude Optional array of component names to exclude from the library registration.
+	 */
+	public register(library: Library, ...exclude: string[]): void {
+		if (this.libs[library.name]) {
+			console.warn(new Error(`Library with name ${library.name} already exists.`));
+		}
+
+		const components: Array<{
+			component: ComponentConstructor,
+			name: string
+		}> = library.list().filter(com => !(com.name in exclude));
+
+		this.libs[library.name] = {
+			name: library.name,
+			version: library.version,
+			author: library.author,
+			components: components.map(com => com.name),
+			dependencies: library.libs
+		};
+
+		for (const com of components) {
+			this.add(com.component, `${library.name}-${com.name}`);
+		}
+	}
+
+	/**
+	 * Returns a library.
+	 * @param {string} name The name of the library.
+	 * @return {LibMeta}
+	 */
+	public lib(name: string): LibMeta | undefined {
+		return this.libs[name];
+	}
+
+	/**
+	 * Returns a formatted object of all libraries in the signature.
+	 * @return {Record<string, ResolvedLib>} A object of formatted libraries with their components and dependencies.
+	 */
+	public libraries(): Record<string, ResolvedLib> {
+		const formatKey = (lib: LibMeta): string => {
+			let key = lib.name;
+
+			if (lib.version) key += `@${lib.version}`;
+			if (lib.author) key += `#${lib.author}`;
+
+			return key;
+		};
+
+		const resolve = (libs: Record<string, LibMeta>, visited = new Set<string>()): Record<string, ResolvedLib> => {
+			const result: Record<string, ResolvedLib> = {};
+
+			for (const [_, lib] of Object.entries(libs)) {
+				const key = formatKey(lib);
+
+				if (visited.has(key)) continue;
+				visited.add(key);
+
+				result[key] = {
+					components: lib.components,
+					dependencies: resolve(lib.dependencies, visited)
+				};
+			}
+
+			return result;
+		};
+
+		return resolve(this.libs);
 	}
 
 	/**

package/src/index.ts

@@ -6,4 +6,5 @@ export default function (): Signature {
 
 export {default as Signature} from './Signature.js';
 export {default as Component} from './Component.js';
-export {default as Prop} from './Prop.js';
+export {default as Prop} from './Prop.js';
+export {default as Library} from './Library.js';