@xaendar/core 0.0.4 → 0.1.6

package/package.json

@@ -1,11 +1,21 @@
-{
-  "name": "@xaendar/core",
-  "version": "0.0.4",
-  "type": "module",
-  "author": "Kaitenjo",
-  "license": "MIT",
-  "description": "A library containing core utils such as webcomponent base classes and theming support",
-  "dependencies": {
-    "@xaendar/common": "0.0.3"
-  }
-}
+{
+  "name": "@xaendar/core",
+  "version": "0.1.6",
+  "description": "A library containing core utils such as webcomponent base classes and theming support",
+  "type": "module",
+  "main": "./xaendar-core.es.js",
+  "module": "./xaendar-core.es.js",
+  "types": "./xaendar-core.es.d.ts",
+  "exports": {
+    ".": {
+      "import": {
+        "types": "./xaendar-core.es.d.ts",
+        "default": "./xaendar-core.es.js"
+      }
+    }
+  },
+  "peerDependencies": {},
+  "dependencies": {
+    "@xaendar/common": "0.1.6"
+  }
+}

package/xaendar-core.es.d.ts

@@ -0,0 +1,100 @@
+import { AccessorDecorator } from '@xaendar/common';
+import { Beautify } from '@xaendar/common';
+import { ClassDecorator as ClassDecorator_2 } from '@xaendar/common';
+import { RequireOne } from '@xaendar/common';
+import { VoidFunction as VoidFunction_2 } from '@xaendar/common';
+
+/**
+ * Base class for all Web Components in the framework
+ *
+ * This class internally has an `observedAttributes` property
+ * add programmaticaly by the @WebComponent decorator.
+ * It won't appear by intellisense but it's there.
+ */
+export declare class BaseWebComponent extends HTMLElement {
+    static rendererTimes: number;
+    /**
+     * Flag to track if the component has been initialized
+     * When istance is created, the flag is false
+     * After the connectedCallback has been called and all the attributes
+     * have been reflected on the relatives properties, the flag is set to true
+     *
+     * This prevents the render method to be called by the properties setters
+     * before the component is fully initialized.
+     *
+     * Otherwise the render function would be called N times where N is the
+     * number of properties decorated with @Property and specified as attributes
+     * on the CustomElement tag in the HTML
+     */
+    private _initialized;
+    private readonly _root;
+    constructor();
+    /* Excluded from this release type: internalRender */
+    /**
+     * Method automatically called by the JavascriptEngine when an attribute
+     * on the host element is changed
+     *
+     * This method runs before the connectedCallback method if any observed attribute
+     * is specified on the CustomElement tag in the HTML
+     *
+     * @param name Name of the attribute changed
+     * @param _oldValue Old value of the attribute
+     * @param newValue New value of the attribute
+     */
+    private attributeChangedCallback;
+    /**
+     * Method automatically called by the JavascriptEngine when a CustomElement
+     * is added to the DOM
+     *
+     * This method is called EVERY time the element is added
+     */
+    private connectedCallback;
+    /**
+     * Method automatically called by the JavascriptEngine when a CustomElement
+     * is removed from the DOM
+     *
+     * This method is called EVERY time the element is removed
+     *
+     * We use this method to reset the _initialized flag
+     * so that if the element is re-added to the DOM
+     * the properties initialization won't call the render method
+     */
+    private disconnectedCallback;
+}
+
+declare function Event_2<Class extends BaseWebComponent, Field, Data = void>(params?: EventParams): AccessorDecorator<Class, Field, Output<Data>>;
+export { Event_2 as Event }
+
+/**
+ * Rapresent the options to configure an @Event Decorator in a Web Component.
+ */
+export declare type EventParams = Beautify<RequireOne<Omit<CustomEventInit, 'detail'>>>;
+
+/**
+ * Rapresent the output type returned by an @Event Decorator in a Web Component.
+ *
+ * Function type `emit` can be used to emit the event with the specified value and options.
+ * @param Value - The type of the value to be emitted with the event. Default is `void`.
+ * @param EventParams - The type of the event parameters to configure the event emission.
+ * This object's properties override the default event parameters defined in the decorator.
+ */
+export declare type Output<Value = void> = {
+    emit: VoidFunction_2<Value extends void ? ([EventParams] | []) : ([Value, EventParams] | [Value])>;
+};
+
+export declare function Property<Class extends BaseWebComponent, Field>(params?: PropertyDecoratorParams): AccessorDecorator<Class, Field>;
+
+export declare type PropertyDecoratorParams = {
+    required: true;
+};
+
+/**
+ * Decorator to define a web component
+ * @param selector Name or names of the custom element
+ */
+export declare function WebComponent<T extends BaseWebComponent>(options: {
+    selector: string | string[];
+    templateUrl: string;
+}): ClassDecorator_2<T>;
+
+export { }

package/xaendar-core.es.js

@@ -0,0 +1,91 @@
+//#region ../packages/core/src/decorators/event.decorator.ts
+function e(e) {
+	return !!e && typeof e == "object" && ("bubbles" in e || "cancelable" in e || "composed" in e);
+}
+function t(t) {
+	return (n, r) => {
+		let i = { emit: (e, t) => {} };
+		return { get() {
+			return i.emit = (n, i) => {
+				let a = {};
+				a = e(n) ? {
+					...t,
+					...n
+				} : {
+					...t,
+					...i,
+					detail: n
+				};
+				let o = new CustomEvent(r.name, a);
+				this.dispatchEvent(o);
+			}, i;
+		} };
+	};
+}
+var n = "⛔observedAttributes";
+//#endregion
+//#region ../packages/core/src/decorators/property.decorator.ts
+function r(e) {
+	return function(t, r) {
+		r.metadata[n] ??= [], r.metadata[n].push(r.name);
+		let i = r.name, a = `⛔${i}`;
+		return {
+			get() {
+				return this[`⛔${i}`];
+			},
+			set(t) {
+				let n = this;
+				if (e?.required && !t) throw Error(`Property '${i}' is required, current value: ${t}`);
+				n[a] !== t && (n[a] = t, n.internalRender());
+			},
+			init(e) {
+				let t = this;
+				return t[a] = e, e;
+			}
+		};
+	};
+}
+//#endregion
+//#region ../packages/core/src/decorators/web-component/web-component.decorator.ts
+function i(e) {
+	return function(t, n) {
+		a(t, n), o(t, e.selector);
+	};
+}
+function a(e, t) {
+	Object.defineProperty(e, "observedAttributes", {
+		get: () => t.metadata[n],
+		configurable: !1,
+		enumerable: !1
+	});
+}
+function o(e, t) {
+	Array.isArray(t) ? t.forEach((t) => customElements.define(t, e)) : customElements.define(t, e);
+}
+//#endregion
+//#region ../packages/core/src/directives/base-web-component.ts
+var s = class e extends HTMLElement {
+	static rendererTimes = 0;
+	_initialized = !1;
+	_root;
+	constructor() {
+		super(), this._root = this.attachShadow({ mode: "open" });
+	}
+	internalRender() {
+		this._initialized && console.warn("Render times:", ++e.rendererTimes);
+	}
+	attributeChangedCallback(e, t, n) {
+		let r = this;
+		r[e] = n;
+	}
+	connectedCallback() {
+		this._initialized = !0, this.internalRender();
+	}
+	disconnectedCallback() {
+		this._initialized = !1;
+	}
+};
+//#endregion
+export { s as BaseWebComponent, t as Event, r as Property, i as WebComponent };
+
+//# sourceMappingURL=xaendar-core.es.js.map

package/xaendar-core.es.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"xaendar-core.es.js","names":[],"sources":["../../../packages/core/src/decorators/event.decorator.ts","../../../packages/core/src/costants.ts","../../../packages/core/src/decorators/property.decorator.ts","../../../packages/core/src/decorators/web-component/web-component.decorator.ts","../../../packages/core/src/directives/base-web-component.ts"],"sourcesContent":["import { AccessorDecorator, ClassAccessorDecoratorValue } from '@xaendar/common';\r\nimport { BaseWebComponent } from '../directives/base-web-component';\r\nimport { EventParams } from '../models/event/event-params.type';\r\nimport { Output } from '../models/event/output.type';\r\n\r\nfunction isEventParams(value: EventParams | unknown): value is EventParams {\r\n  return !!value && typeof value === 'object' && ('bubbles' in value || 'cancelable' in value || 'composed' in value);\r\n}\r\n\r\nexport function Event<\r\n  Class extends BaseWebComponent,\r\n  Field,\r\n  Data = void,\r\n>(params?: EventParams): AccessorDecorator<Class, Field, Output<Data>> {\r\n  return (_value: ClassAccessorDecoratorValue<Field>, context: ClassAccessorDecoratorContext<Class, Output<Data>>): ReturnType<AccessorDecorator<Class, Field, Output<Data>>> => {\r\n    const output: Output<Data> = {\r\n      emit: (_valueOrOverrideParams?: Data | EventParams, _overrideParams?: EventParams) => { }\r\n     };\r\n\r\n    return {\r\n      get(): Output<Data> {\r\n        output.emit = (valueOrOverrideParams?: Data | EventParams, overrideParams?: EventParams) => {\r\n          let eventParams: CustomEventInit<Data> = {};\r\n\r\n            eventParams = isEventParams(valueOrOverrideParams)\r\n              ? { ...params, ...valueOrOverrideParams } \r\n              : { ...params, ...overrideParams, detail: valueOrOverrideParams }\r\n\r\n            const event = new CustomEvent(context.name as string, eventParams);\r\n            const classInstance = (this as Class);\r\n            classInstance.dispatchEvent(event);\r\n          };\r\n          return output;\r\n        }\r\n      }\r\n    }\r\n  }","export const INTERNAL_PREFIX = '⛔';\r\nexport const INTERNAL_OBSERVED_ATTRIBUTES = `${INTERNAL_PREFIX}observedAttributes`;","import { AccessorDecorator, ClassAccessorDecoratorValue, Constructor } from '@xaendar/common';\r\nimport { INTERNAL_OBSERVED_ATTRIBUTES, INTERNAL_PREFIX } from '../costants';\r\nimport { BaseWebComponent } from '../directives/base-web-component';\r\nimport { PropertyDecoratorParams } from '../models/property-decorator-params.type';\r\n\r\nexport function Property<\r\n  Class extends BaseWebComponent,\r\n  Field\r\n  >(params?: PropertyDecoratorParams): AccessorDecorator<Class, Field> {\r\n  return function (_value: ClassAccessorDecoratorValue<Field>, context: ClassAccessorDecoratorContext<Class, Field>): ReturnType<AccessorDecorator<Class, Field>> {\r\n    context.metadata![INTERNAL_OBSERVED_ATTRIBUTES] ??= new Array<string>;\r\n    (context.metadata![INTERNAL_OBSERVED_ATTRIBUTES] as string[]).push(context.name as string);\r\n  \r\n    const propertyKey = context.name as string;\r\n    const internalPropertyKey = `${INTERNAL_PREFIX}${propertyKey}`\r\n    \r\n    return {\r\n      get() {\r\n        const classInstance = (this as BaseWebComponent & Record<typeof internalPropertyKey, Field>);\r\n        return classInstance[`${INTERNAL_PREFIX}${propertyKey}`]!;\r\n      },\r\n      set(value: Field) {\r\n        const classInstance = (this as BaseWebComponent & Record<typeof internalPropertyKey, Field>);\r\n\r\n        if (params?.required && !value) {\r\n          throw new Error(`Property '${propertyKey}' is required, current value: ${value}`);\r\n        }\r\n\r\n        const oldValue = classInstance[internalPropertyKey]!;\r\n        if (oldValue !== value) {\r\n          classInstance[internalPropertyKey] = value;\r\n          classInstance.internalRender();\r\n        }\r\n      },\r\n      init(initialValue: Field) {\r\n        const classInstance = (this as BaseWebComponent & Record<typeof internalPropertyKey, Field>);\r\n        classInstance[internalPropertyKey] = initialValue;\r\n        return initialValue;\r\n      }\r\n    };\r\n  }\r\n}\r\n","import { ClassDecorator, Constructor } from '@xaendar/common';\r\nimport { INTERNAL_OBSERVED_ATTRIBUTES } from '../../costants';\r\nimport { BaseWebComponent } from '../../directives/base-web-component';\r\n\r\n/**\r\n * Decorator to define a web component\r\n * @param selector Name or names of the custom element\r\n */\r\nexport function WebComponent<T extends BaseWebComponent>(options: { selector: string | string[], templateUrl: string }): ClassDecorator<T> {\r\n  return function (klass: Constructor<T>, context: ClassDecoratorContext<Constructor<T>>): void {\r\n    defineObservedAttributes(klass, context);\r\n    setSelectors(klass, options.selector);\r\n  };\r\n}\r\n\r\n/**\r\n * Function to define the observedAttributes static property on the class.\r\n * We define static get observedAttributes programmatically\r\n * to abstract the manual definition from the user.\r\n *\r\n * We could not define the property in the base class due to the fact\r\n * that is static and each derived class would override the value of the others\r\n * @param klass The class to set the observedAttributes on\r\n * @param attributes The attributes to observe\r\n */\r\nfunction defineObservedAttributes<T extends BaseWebComponent>(klass: Constructor<T>, context: ClassDecoratorContext<Constructor<T>>): void {\r\n  Object.defineProperty(klass, 'observedAttributes', {\r\n    get: () => context.metadata![INTERNAL_OBSERVED_ATTRIBUTES],\r\n    configurable: false,\r\n    enumerable: false\r\n  });\r\n}\r\n\r\n/**\r\n * Function to add the custom element definition to the browser using the passed selectors.\r\n * @param klass The class to define as a web component\r\n * @param selectors The selector or selectors to reference the web component in HTML\r\n */\r\nfunction setSelectors<T extends BaseWebComponent>(klass: Constructor<T>, selectors: string | string[]): void {\r\n  Array.isArray(selectors)\r\n    ? selectors.forEach(selector => customElements.define(selector, klass))\r\n    : customElements.define(selectors, klass);\r\n}","/**\r\n * Base class for all Web Components in the framework\r\n * \r\n * This class internally has an `observedAttributes` property\r\n * add programmaticaly by the @WebComponent decorator. \r\n * It won't appear by intellisense but it's there.\r\n */\r\nexport class BaseWebComponent extends HTMLElement {\r\n\r\n  public static rendererTimes = 0;\r\n\r\n  /**\r\n   * Flag to track if the component has been initialized\r\n   * When istance is created, the flag is false\r\n   * After the connectedCallback has been called and all the attributes\r\n   * have been reflected on the relatives properties, the flag is set to true\r\n   * \r\n   * This prevents the render method to be called by the properties setters\r\n   * before the component is fully initialized.\r\n   * \r\n   * Otherwise the render function would be called N times where N is the\r\n   * number of properties decorated with @Property and specified as attributes\r\n   * on the CustomElement tag in the HTML\r\n  */\r\n  private _initialized = false;\r\n\r\n  private readonly _root: ShadowRoot;\r\n\r\n  constructor() {\r\n    super();\r\n    this._root = this.attachShadow({ mode: 'open' });\r\n  }\r\n\r\n  /**\r\n   * Method called by the @Property decorator to\r\n   * update the rendering of the component\r\n   * @internal \r\n   */\r\n  public internalRender(): void {\r\n    if (this._initialized) {\r\n      console.warn('Render times:', ++BaseWebComponent.rendererTimes);\r\n    }\r\n  }\r\n\r\n  /**\r\n   * Method automatically called by the JavascriptEngine when an attribute\r\n   * on the host element is changed\r\n   * \r\n   * This method runs before the connectedCallback method if any observed attribute\r\n   * is specified on the CustomElement tag in the HTML\r\n   * \r\n   * @param name Name of the attribute changed\r\n   * @param _oldValue Old value of the attribute\r\n   * @param newValue New value of the attribute\r\n   */\r\n  private attributeChangedCallback(name: string, _oldValue: unknown, newValue: unknown): void {\r\n    /*\r\n      Since the 'Property Decorator add the property key to the ObservedAttributes\r\n      We are sure that the property with the given name exists on the instance of the subclass\r\n    */\r\n    const context = this as BaseWebComponent & Record<string, unknown>;\r\n    context[name] = newValue;\r\n  }\r\n\r\n  /**\r\n   * Method automatically called by the JavascriptEngine when a CustomElement\r\n   * is added to the DOM\r\n   * \r\n   * This method is called EVERY time the element is added\r\n   */\r\n  private connectedCallback(): void {\r\n    this._initialized = true;\r\n    this.internalRender();\r\n  }\r\n\r\n  /**\r\n   * Method automatically called by the JavascriptEngine when a CustomElement\r\n   * is removed from the DOM\r\n   * \r\n   * This method is called EVERY time the element is removed\r\n   * \r\n   * We use this method to reset the _initialized flag\r\n   * so that if the element is re-added to the DOM\r\n   * the properties initialization won't call the render method\r\n   */\r\n  private disconnectedCallback(): void {\r\n    this._initialized = false\r\n  }\r\n}"],"mappings":";AAKA,SAAS,EAAc,GAAoD;AACzE,QAAO,CAAC,CAAC,KAAS,OAAO,KAAU,aAAa,aAAa,KAAS,gBAAgB,KAAS,cAAc;;AAG/G,SAAgB,EAId,GAAqE;AACrE,SAAQ,GAA4C,MAA2H;EAC7K,IAAM,IAAuB,EAC3B,OAAO,GAA6C,MAAkC,IACtF;AAEF,SAAO,EACL,MAAoB;AAYhB,UAXF,EAAO,QAAQ,GAA4C,MAAiC;IAC1F,IAAI,IAAqC,EAAE;AAEzC,QAAc,EAAc,EAAsB,GAC9C;KAAE,GAAG;KAAQ,GAAG;KAAuB,GACvC;KAAE,GAAG;KAAQ,GAAG;KAAgB,QAAQ;KAAuB;IAEnE,IAAM,IAAQ,IAAI,YAAY,EAAQ,MAAgB,EAAY;AAElE,SAAc,cAAc,EAAM;MAE7B;KAEV;;;ACjCP,IAAa,IAA+B;;;ACI5C,SAAgB,EAGZ,GAAmE;AACrE,QAAO,SAAU,GAA4C,GAAmG;AAE7J,EADD,EAAQ,SAAU,OAAkC,EAAiB,EACpE,EAAQ,SAAU,GAA2C,KAAK,EAAQ,KAAe;EAE1F,IAAM,IAAc,EAAQ,MACtB,IAAsB,IAAqB;AAEjD,SAAO;GACL,MAAM;AAEJ,WAAO,KAAc,IAAqB;;GAE5C,IAAI,GAAc;IAChB,IAAM,IAAiB;AAEvB,QAAI,GAAQ,YAAY,CAAC,EACvB,OAAU,MAAM,aAAa,EAAY,gCAAgC,IAAQ;AAInF,IADiB,EAAc,OACd,MACf,EAAc,KAAuB,GACrC,EAAc,gBAAgB;;GAGlC,KAAK,GAAqB;IACxB,IAAM,IAAiB;AAEvB,WADA,EAAc,KAAuB,GAC9B;;GAEV;;;;;AC/BL,SAAgB,EAAyC,GAAkF;AACzI,QAAO,SAAU,GAAuB,GAAsD;AAE5F,EADA,EAAyB,GAAO,EAAQ,EACxC,EAAa,GAAO,EAAQ,SAAS;;;AAczC,SAAS,EAAqD,GAAuB,GAAsD;AACzI,QAAO,eAAe,GAAO,sBAAsB;EACjD,WAAW,EAAQ,SAAU;EAC7B,cAAc;EACd,YAAY;EACb,CAAC;;AAQJ,SAAS,EAAyC,GAAuB,GAAoC;AAC3G,OAAM,QAAQ,EAAU,GACpB,EAAU,SAAQ,MAAY,eAAe,OAAO,GAAU,EAAM,CAAC,GACrE,eAAe,OAAO,GAAW,EAAM;;;;AClC7C,IAAa,IAAb,MAAa,UAAyB,YAAY;CAEhD,OAAc,gBAAgB;CAe9B,eAAuB;CAEvB;CAEA,cAAc;AAEZ,EADA,OAAO,EACP,KAAK,QAAQ,KAAK,aAAa,EAAE,MAAM,QAAQ,CAAC;;CAQlD,iBAA8B;AAC5B,EAAI,KAAK,gBACP,QAAQ,KAAK,iBAAiB,EAAE,EAAiB,cAAc;;CAenE,yBAAiC,GAAc,GAAoB,GAAyB;EAK1F,IAAM,IAAU;AAChB,IAAQ,KAAQ;;CASlB,oBAAkC;AAEhC,EADA,KAAK,eAAe,IACpB,KAAK,gBAAgB;;CAavB,uBAAqC;AACnC,OAAK,eAAe"}

package/src/costants.ts

@@ -1,2 +0,0 @@
-export const INTERNAL_PREFIX = '⛔';
-export const INTERNAL_OBSERVED_ATTRIBUTES = `${INTERNAL_PREFIX}observedAttributes`;

package/src/decorators/event.decorator.ts

@@ -1,37 +0,0 @@
-import { AccessorDecorator, ClassAccessorDecoratorValue } from '@xaendar/common';
-import { BaseWebComponent } from '../directives/base-web-component';
-import { EventParams } from '../models/event/event-params.type';
-import { Output } from '../models/event/output.type';
-
-function isEventParams(value: EventParams | unknown): value is EventParams {
-  return !!value && typeof value === 'object' && ('bubbles' in value || 'cancelable' in value || 'composed' in value);
-}
-
-export function Event<
-  Class extends BaseWebComponent,
-  Field,
-  Data = void,
->(params?: EventParams): AccessorDecorator<Class, Field, Output<Data>> {
-  return (_value: ClassAccessorDecoratorValue<Field>, context: ClassAccessorDecoratorContext<Class, Output<Data>>): ReturnType<AccessorDecorator<Class, Field, Output<Data>>> => {
-    const output: Output<Data> = {
-      emit: (_valueOrOverrideParams?: Data | EventParams, _overrideParams?: EventParams) => { }
-     };
-
-    return {
-      get(): Output<Data> {
-        output.emit = (valueOrOverrideParams?: Data | EventParams, overrideParams?: EventParams) => {
-          let eventParams: CustomEventInit<Data> = {};
-
-            eventParams = isEventParams(valueOrOverrideParams)
-              ? { ...params, ...valueOrOverrideParams } 
-              : { ...params, ...overrideParams, detail: valueOrOverrideParams }
-
-            const event = new CustomEvent(context.name as string, eventParams);
-            const classInstance = (this as Class);
-            classInstance.dispatchEvent(event);
-          };
-          return output;
-        }
-      }
-    }
-  }

package/src/decorators/index.ts

@@ -1,3 +0,0 @@
-export * from './event.decorator';
-export * from './property.decorator';
-export * from './web-component/web-component.decorator';

package/src/decorators/property.decorator.ts

@@ -1,42 +0,0 @@
-import { AccessorDecorator, ClassAccessorDecoratorValue, Constructor } from '@xaendar/common';
-import { INTERNAL_OBSERVED_ATTRIBUTES, INTERNAL_PREFIX } from '../costants';
-import { BaseWebComponent } from '../directives/base-web-component';
-import { PropertyDecoratorParams } from '../models/property-decorator-params.type';
-
-export function Property<
-  Class extends BaseWebComponent,
-  Field
-  >(params?: PropertyDecoratorParams): AccessorDecorator<Class, Field> {
-  return function (_value: ClassAccessorDecoratorValue<Field>, context: ClassAccessorDecoratorContext<Class, Field>): ReturnType<AccessorDecorator<Class, Field>> {
-    context.metadata![INTERNAL_OBSERVED_ATTRIBUTES] ??= new Array<string>;
-    (context.metadata![INTERNAL_OBSERVED_ATTRIBUTES] as string[]).push(context.name as string);
-  
-    const propertyKey = context.name as string;
-    const internalPropertyKey = `${INTERNAL_PREFIX}${propertyKey}`
-    
-    return {
-      get() {
-        const classInstance = (this as BaseWebComponent & Record<typeof internalPropertyKey, Field>);
-        return classInstance[`${INTERNAL_PREFIX}${propertyKey}`]!;
-      },
-      set(value: Field) {
-        const classInstance = (this as BaseWebComponent & Record<typeof internalPropertyKey, Field>);
-
-        if (params?.required && !value) {
-          throw new Error(`Property '${propertyKey}' is required, current value: ${value}`);
-        }
-
-        const oldValue = classInstance[internalPropertyKey]!;
-        if (oldValue !== value) {
-          classInstance[internalPropertyKey] = value;
-          classInstance.internalRender();
-        }
-      },
-      init(initialValue: Field) {
-        const classInstance = (this as BaseWebComponent & Record<typeof internalPropertyKey, Field>);
-        classInstance[internalPropertyKey] = initialValue;
-        return initialValue;
-      }
-    };
-  }
-}

package/src/decorators/web-component/web-component.decorator.spec.ts

@@ -1,57 +0,0 @@
-import { BaseWebComponent } from '@xaendar/core';
-import { WebComponent } from './web-component.decorator';
-
-describe('WebComponent decorator', () => {
-  let defineSpy: jest.SpyInstance;
-
-  beforeEach(() => defineSpy = jest.spyOn(customElements, 'define').mockImplementation(() => { }));
-
-  afterEach(() => defineSpy.mockRestore());
-
-  it('should define a web component with a single selector', () => {
-    @WebComponent('single-selector')
-    class SingleSelectorComponent extends BaseWebComponent {
-      public template(): string {
-        throw new Error('Method not implemented.');
-      }
-      public css(): string {
-        throw new Error('Method not implemented.');
-      }
-    }
-
-    expect(defineSpy).toHaveBeenCalledTimes(1);
-    expect(defineSpy).toHaveBeenCalledWith('single-selector', SingleSelectorComponent);
-  });
-
-  it('should define a web component with multiple selectors', () => {
-    @WebComponent(['first-selector', 'second-selector'])
-    class MultipleSelectorComponent extends BaseWebComponent {
-      public template(): string {
-        throw new Error('Method not implemented.');
-      }
-      public css(): string {
-        throw new Error('Method not implemented.');
-      }
-    }
-
-    expect(defineSpy).toHaveBeenCalledTimes(2);
-    expect(defineSpy).toHaveBeenNthCalledWith(1, 'first-selector', MultipleSelectorComponent);
-    expect(defineSpy).toHaveBeenNthCalledWith(2, 'second-selector', MultipleSelectorComponent);
-  });
-
-  it.skip('should define a web component with multiple selectors', () => {
-    @WebComponent('selector')
-    class SingleSelectorComponent extends BaseWebComponent {
-      public template(): string {
-        throw new Error('Method not implemented.');
-      }
-      public css(): string {
-        throw new Error('Method not implemented.');
-      }
-    }
-
-    expect(defineSpy).toHaveBeenCalledTimes(2);
-    expect(defineSpy).toHaveBeenNthCalledWith(1, 'first-selector', SingleSelectorComponent);
-    expect(defineSpy).toHaveBeenNthCalledWith(2, 'second-selector', SingleSelectorComponent);
-  });
-});

package/src/decorators/web-component/web-component.decorator.ts

@@ -1,43 +0,0 @@
-import { ClassDecorator, Constructor } from '@xaendar/common';
-import { INTERNAL_OBSERVED_ATTRIBUTES } from '../../costants';
-import { BaseWebComponent } from '../../directives/base-web-component';
-
-/**
- * Decorator to define a web component
- * @param selector Name or names of the custom element
- */
-export function WebComponent<T extends BaseWebComponent>(options: { selector: string | string[], templateUrl: string }): ClassDecorator<T> {
-  return function (klass: Constructor<T>, context: ClassDecoratorContext<Constructor<T>>): void {
-    defineObservedAttributes(klass, context);
-    setSelectors(klass, options.selector);
-  };
-}
-
-/**
- * Function to define the observedAttributes static property on the class.
- * We define static get observedAttributes programmatically
- * to abstract the manual definition from the user.
- *
- * We could not define the property in the base class due to the fact
- * that is static and each derived class would override the value of the others
- * @param klass The class to set the observedAttributes on
- * @param attributes The attributes to observe
- */
-function defineObservedAttributes<T extends BaseWebComponent>(klass: Constructor<T>, context: ClassDecoratorContext<Constructor<T>>): void {
-  Object.defineProperty(klass, 'observedAttributes', {
-    get: () => context.metadata![INTERNAL_OBSERVED_ATTRIBUTES],
-    configurable: false,
-    enumerable: false
-  });
-}
-
-/**
- * Function to add the custom element definition to the browser using the passed selectors.
- * @param klass The class to define as a web component
- * @param selectors The selector or selectors to reference the web component in HTML
- */
-function setSelectors<T extends BaseWebComponent>(klass: Constructor<T>, selectors: string | string[]): void {
-  Array.isArray(selectors)
-    ? selectors.forEach(selector => customElements.define(selector, klass))
-    : customElements.define(selectors, klass);
-}

package/src/directives/base-web-component.ts

@@ -1,89 +0,0 @@
-/**
- * Base class for all Web Components in the framework
- * 
- * This class internally has an `observedAttributes` property
- * add programmaticaly by the @WebComponent decorator. 
- * It won't appear by intellisense but it's there.
- */
-export class BaseWebComponent extends HTMLElement {
-
-  public static rendererTimes = 0;
-
-  /**
-   * Flag to track if the component has been initialized
-   * When istance is created, the flag is false
-   * After the connectedCallback has been called and all the attributes
-   * have been reflected on the relatives properties, the flag is set to true
-   * 
-   * This prevents the render method to be called by the properties setters
-   * before the component is fully initialized.
-   * 
-   * Otherwise the render function would be called N times where N is the
-   * number of properties decorated with @Property and specified as attributes
-   * on the CustomElement tag in the HTML
-  */
-  private _initialized = false;
-
-  private readonly _root: ShadowRoot;
-
-  constructor() {
-    super();
-    this._root = this.attachShadow({ mode: 'open' });
-  }
-
-  /**
-   * Method called by the @Property decorator to
-   * update the rendering of the component
-   * @internal 
-   */
-  public internalRender(): void {
-    if (this._initialized) {
-      console.warn('Render times:', ++BaseWebComponent.rendererTimes);
-    }
-  }
-
-  /**
-   * Method automatically called by the JavascriptEngine when an attribute
-   * on the host element is changed
-   * 
-   * This method runs before the connectedCallback method if any observed attribute
-   * is specified on the CustomElement tag in the HTML
-   * 
-   * @param name Name of the attribute changed
-   * @param _oldValue Old value of the attribute
-   * @param newValue New value of the attribute
-   */
-  private attributeChangedCallback(name: string, _oldValue: unknown, newValue: unknown): void {
-    /*
-      Since the 'Property Decorator add the property key to the ObservedAttributes
-      We are sure that the property with the given name exists on the instance of the subclass
-    */
-    const context = this as BaseWebComponent & Record<string, unknown>;
-    context[name] = newValue;
-  }
-
-  /**
-   * Method automatically called by the JavascriptEngine when a CustomElement
-   * is added to the DOM
-   * 
-   * This method is called EVERY time the element is added
-   */
-  private connectedCallback(): void {
-    this._initialized = true;
-    this.internalRender();
-  }
-
-  /**
-   * Method automatically called by the JavascriptEngine when a CustomElement
-   * is removed from the DOM
-   * 
-   * This method is called EVERY time the element is removed
-   * 
-   * We use this method to reset the _initialized flag
-   * so that if the element is re-added to the DOM
-   * the properties initialization won't call the render method
-   */
-  private disconnectedCallback(): void {
-    this._initialized = false
-  }
-}

package/src/directives/index.ts

@@ -1 +0,0 @@
-export * from './base-web-component';

package/src/models/base-web-component-constructor.type.ts

@@ -1,8 +0,0 @@
-import { Constructor } from '@xaendar/common';
-import { INTERNAL_OBSERVED_ATTRIBUTES } from '../costants';
-import { BaseWebComponent } from '../directives/base-web-component';
-
-export type BaseWebComponentConstructor = Constructor<BaseWebComponent, {
-  observedAttributes: string[]
-  [INTERNAL_OBSERVED_ATTRIBUTES]: string[]
-}>;

package/src/models/event/event-params.type.ts

@@ -1,6 +0,0 @@
-import { Beautify, RequireOne } from '@xaendar/common';
-
-/**
- * Rapresent the options to configure an @Event Decorator in a Web Component.
- */
-export type EventParams = Beautify<RequireOne<Omit<CustomEventInit, 'detail'>>>;

package/src/models/event/index.ts

@@ -1,2 +0,0 @@
-export * from './event-params.type';
-export * from './output.type';

package/src/models/event/output.type.ts

@@ -1,14 +0,0 @@
-import { VoidFunction } from '@xaendar/common';
-import { EventParams } from './event-params.type';
-
-/**
- * Rapresent the output type returned by an @Event Decorator in a Web Component.
- * 
- * Function type `emit` can be used to emit the event with the specified value and options.
- * @param Value - The type of the value to be emitted with the event. Default is `void`.
- * @param EventParams - The type of the event parameters to configure the event emission.
- * This object's properties override the default event parameters defined in the decorator.
- */
-export type Output<Value = void> = {
-  emit: VoidFunction<Value extends void ? ([EventParams] | []) : ([Value, EventParams] | [Value])>;
-}

package/src/models/index.ts

@@ -1,2 +0,0 @@
-export * from './event';
-export * from './property-decorator-params.type';

package/src/models/property-decorator-params.type.ts

@@ -1,3 +0,0 @@
-export type PropertyDecoratorParams = {
-  required: true;
-};

package/src/public-api.ts

@@ -1,3 +0,0 @@
-export * from './decorators';
-export * from './directives';
-export * from './models';

package/src/testing/mock-web-component.ts

@@ -1,26 +0,0 @@
-import { Event } from '../decorators/event.decorator';
-import { Property } from '../decorators/property.decorator';
-import { WebComponent } from '../decorators/web-component/web-component.decorator';
-import { BaseWebComponent } from '../directives/base-web-component';
-import { Output } from '../models/event/output.type';
-
-@WebComponent({
-  selector: 'mock-web-component',
-  templateUrl: './mock-web-component.html',
-})
-export class MockWebComponent extends BaseWebComponent {
-  
-  @Property()
-  public accessor mockProperty = 'default';
-
-  @Event()
-  public accessor mockEvent!: Output<string>;
-
-  public template(): string {
-    throw new Error('Method not implemented.');
-  }
-
-  public css(): string {
-    throw new Error('Method not implemented.');
-  }
-}

package/tsconfig.json

@@ -1,3 +0,0 @@
-{
-  "extends": "../../tsconfig.json",
-}

package/vite.config.ts

@@ -1,4 +0,0 @@
-import { defineConfig } from 'vite';
-import getViteConfig from '../../vite-config';
-
-export default defineConfig(getViteConfig('@xaendar/core', __dirname));