@twobirds/microcomponents 0.0.66 → 0.0.67

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.
Files changed (93) hide show
  1. package/README.md +10 -6
  2. package/assets/{test.html → test/test.html} +3 -3
  3. package/package.json +4 -4
  4. package/public/documentation/MC.md +588 -0
  5. package/public/documentation/ajaxian-1.png +0 -0
  6. package/public/documentation/ajaxian-2.png +0 -0
  7. package/public/documentation/ajaxian-3.png +0 -0
  8. package/public/documentation/elements.md +278 -0
  9. package/public/documentation/functional_requirements.md +8 -0
  10. package/public/documentation/history.md +436 -0
  11. package/public/documentation/magic.md +29 -0
  12. package/public/documentation/observables.md +107 -0
  13. package/public/documentation/rnd0023-1.jpg +0 -0
  14. package/public/documentation/rnd0023-2.jpg +0 -0
  15. package/public/documentation/rnd0023-3.jpg +0 -0
  16. package/public/documentation/tB_react.md +207 -0
  17. package/public/documentation/usage.md +142 -0
  18. package/public/documentation/why.md +25 -0
  19. package/public/fiddle/MicroComponents.svg +15 -0
  20. package/public/fiddle/fiddle.css +0 -0
  21. package/public/fiddle/fiddle.js +0 -0
  22. package/public/fiddle/index.html +0 -0
  23. package/public/src/MC.ts +605 -0
  24. package/public/src/McEvent.ts +96 -0
  25. package/public/src/elements.ts +76 -0
  26. package/public/src/formValues.ts +233 -0
  27. package/public/src/helpers.ts +149 -0
  28. package/public/src/microcomponents.ts +8 -0
  29. package/public/src/observables.ts +401 -0
  30. package/public/src/selectors.ts +1634 -0
  31. package/public/src/test.ts +193 -0
  32. package/public/test/child.js +15 -0
  33. package/public/test/child.js.map +1 -0
  34. package/public/test/grandchild.js +15 -0
  35. package/public/test/grandchild.js.map +1 -0
  36. package/public/test/grandparent.css +13 -0
  37. package/public/test/grandparent.js +1 -0
  38. package/public/test/grandparent.js.map +1 -0
  39. package/public/test/greatgrandchild.js +29 -0
  40. package/public/test/greatgrandchild.js.map +1 -0
  41. package/public/test/my-tag.css +19 -0
  42. package/public/test/parent.js +15 -0
  43. package/public/test/parent.js.map +1 -0
  44. package/public/test/test.html +27 -0
  45. package/public/test/testform.js +1 -0
  46. package/public/test/testform.js.map +1 -0
  47. package/public/test/testmc.js +10 -0
  48. package/public/test/testmc.js.map +1 -0
  49. package/public/typedoc/.nojekyll +1 -0
  50. package/public/{classes → typedoc/classes}/MC.DC.html +2 -2
  51. package/public/{classes → typedoc/classes}/MC.MC.html +2 -2
  52. package/public/{classes → typedoc/classes}/MC.McBase.html +2 -2
  53. package/public/{classes → typedoc/classes}/MC.McEvent.html +2 -2
  54. package/public/{functions → typedoc/functions}/MC.addListener.html +1 -1
  55. package/public/{functions → typedoc/functions}/MC.autoload.html +1 -1
  56. package/public/{functions → typedoc/functions}/MC.removeListener.html +1 -1
  57. package/public/{functions → typedoc/functions}/elements.defineCE.html +1 -1
  58. package/public/{functions → typedoc/functions}/elements.getCE.html +1 -1
  59. package/public/{functions → typedoc/functions}/formValues.formValues.html +1 -1
  60. package/public/{functions → typedoc/functions}/observables.observe.html +1 -1
  61. package/public/{functions → typedoc/functions}/selectors._d.html +1 -1
  62. package/public/{functions → typedoc/functions}/selectors._t.html +1 -1
  63. package/public/{index.html → typedoc/index.html} +8 -6
  64. package/public/{interfaces → typedoc/interfaces}/MC.HTMLMcElement.html +2 -2
  65. package/public/{interfaces → typedoc/interfaces}/selectors.DSelector.html +2 -2
  66. package/public/{interfaces → typedoc/interfaces}/selectors.TSelector.html +2 -2
  67. package/public/typedoc/media/MicroComponents.svg +15 -0
  68. package/public/{modules → typedoc/modules}/MC.html +1 -1
  69. package/public/{modules → typedoc/modules}/elements.html +1 -1
  70. package/public/{modules → typedoc/modules}/formValues.html +1 -1
  71. package/public/{modules → typedoc/modules}/observables.html +1 -1
  72. package/public/{modules → typedoc/modules}/selectors.html +1 -1
  73. package/public/{types → typedoc/types}/observables.Observable.html +1 -1
  74. package/public/{types → typedoc/types}/selectors.selection.html +1 -1
  75. package/public/{types → typedoc/types}/selectors.singleSelector.html +1 -1
  76. package/src/test/testmc.ts +0 -6
  77. package/typedoc.json +1 -1
  78. package/webpack.config.js +1 -1
  79. package/assets/3d.html +0 -42
  80. package/public/microcomponents.min.js +0 -1
  81. /package/assets/{grandparent.css → test/grandparent.css} +0 -0
  82. /package/assets/{my-tag.css → test/my-tag.css} +0 -0
  83. /package/dist/{microcomponents.min.js → microcomponents.js} +0 -0
  84. /package/public/{media/MicroComponents.svg → MicroComponents.svg} +0 -0
  85. /package/public/{assets → typedoc/assets}/highlight.css +0 -0
  86. /package/public/{assets → typedoc/assets}/icons.js +0 -0
  87. /package/public/{assets → typedoc/assets}/icons.svg +0 -0
  88. /package/public/{assets → typedoc/assets}/main.js +0 -0
  89. /package/public/{assets → typedoc/assets}/navigation.js +0 -0
  90. /package/public/{assets → typedoc/assets}/search.js +0 -0
  91. /package/public/{assets → typedoc/assets}/style.css +0 -0
  92. /package/public/{hierarchy.html → typedoc/hierarchy.html} +0 -0
  93. /package/public/{modules.html → typedoc/modules.html} +0 -0
@@ -0,0 +1,76 @@
1
+ 'use strict';
2
+
3
+ import { DC } from './MC.js';
4
+ import { kebabToPascal } from './helpers.js';
5
+
6
+ class CeBaseClass extends HTMLElement {
7
+ constructor() {
8
+ super();
9
+ }
10
+
11
+ connectedCallback() {
12
+ (DC as any).trigger(this, 'Connected');
13
+ }
14
+
15
+ disconnectedCallback() {
16
+ (DC as any).trigger(this, 'Disconnected');
17
+ }
18
+
19
+ adoptedCallback() {
20
+ (DC as any).trigger(this, 'Adopted');
21
+ }
22
+
23
+ attributeChangedCallback(name: string, oldValue: any, newValue: any) {
24
+ (DC as any).trigger(this, 'AttributeChanged', { name, oldValue, newValue });
25
+ }
26
+ }
27
+
28
+ function createNamedClass(
29
+ name: string,
30
+ ClassBody: { new (...args: any[]): any }
31
+ ) {
32
+ return Object.defineProperty(ClassBody, 'name', { value: name });
33
+ }
34
+
35
+ export function defineCE(
36
+ tagName: string,
37
+ DefinitionClass: { new (...args: any[]): any },
38
+ observedAttributes: string[] = []
39
+ ) {
40
+ if (customElements.get(tagName)) {
41
+ console.warn(`IGNORED: Custom element "${tagName}" is already defined!`);
42
+ return;
43
+ }
44
+
45
+ if (!tagName.includes('-')) {
46
+ throw new Error(
47
+ 'createCustomElement: tagName must contain at least one hyphen ("-").'
48
+ );
49
+ }
50
+
51
+ let name = kebabToPascal(tagName);
52
+
53
+ customElements.define(
54
+ tagName,
55
+ createNamedClass(
56
+ name,
57
+ class extends CeBaseClass {
58
+ instance: any;
59
+
60
+ constructor(data?: any) {
61
+ super();
62
+ let instance = new DefinitionClass(this, data);
63
+ DC.add(this, name, instance);
64
+ }
65
+
66
+ static get observedAttributes() {
67
+ return observedAttributes;
68
+ }
69
+ }
70
+ )
71
+ );
72
+ }
73
+
74
+ export function getCE(tagName: string): CustomElementConstructor | undefined {
75
+ return customElements.get(tagName);
76
+ }
@@ -0,0 +1,233 @@
1
+ 'use strict';
2
+
3
+ import { LooseObject, copyGettersSetters } from './helpers.js';
4
+ import { DC, addListener } from './MC.js';
5
+ import { observe } from './observables.js';
6
+
7
+ type inputTypes = HTMLInputElement | HTMLSelectElement | HTMLTextAreaElement;
8
+
9
+ const getInputName = (
10
+ e: HTMLInputElement | HTMLSelectElement | HTMLTextAreaElement
11
+ ): string => {
12
+ return e.tagName.toLowerCase();
13
+ };
14
+
15
+ abstract class InputBase {
16
+ constructor(e: inputTypes) {}
17
+
18
+ abstract get val(): any;
19
+
20
+ abstract set val(value: any);
21
+ }
22
+
23
+ class RadioHandler extends InputBase {
24
+ #e: HTMLInputElement;
25
+
26
+ constructor(e: HTMLInputElement) {
27
+ super(e);
28
+ this.#e = e;
29
+ }
30
+
31
+ get val(): string {
32
+ let ret = new FormData(this.#e.form as HTMLFormElement).get(this.#e.name);
33
+
34
+ //console.log('radio[', this.#e.name, '] = "' + ret + '"');
35
+ return ret as string;
36
+ }
37
+
38
+ set val(value: string) {
39
+ let arr = [
40
+ ...(this.#e.form as HTMLFormElement).querySelectorAll(
41
+ `input[type="radio"][name="${this.#e.name}"]`
42
+ ),
43
+ ] as HTMLInputElement[];
44
+
45
+ (
46
+ arr
47
+ .filter((e) => e.getAttribute('value') === value)
48
+ .shift() as HTMLInputElement
49
+ ).checked = true;
50
+ }
51
+ }
52
+
53
+ class CheckboxHandler extends InputBase {
54
+ #e: HTMLInputElement;
55
+
56
+ constructor(e: HTMLInputElement) {
57
+ super(e);
58
+ this.#e = e;
59
+ }
60
+
61
+ get val(): boolean {
62
+ return this.#e.checked;
63
+ }
64
+
65
+ set val(value: boolean) {
66
+ this.#e.checked = value;
67
+ }
68
+ }
69
+
70
+ class InputHandler extends InputBase {
71
+ #e: HTMLInputElement;
72
+
73
+ constructor(e: HTMLInputElement) {
74
+ super(e);
75
+ this.#e = e;
76
+ }
77
+
78
+ get val(): string {
79
+ return this.#e.value;
80
+ }
81
+
82
+ set val(value: string) {
83
+ this.#e.value = value;
84
+ }
85
+ }
86
+
87
+ class SelectHandler extends InputBase {
88
+ #e: HTMLSelectElement;
89
+ #multi: boolean = false;
90
+
91
+ constructor(e: HTMLSelectElement) {
92
+ super(e);
93
+ this.#e = e;
94
+ this.#multi = e.multiple;
95
+ }
96
+
97
+ get val(): string[] | string {
98
+ const that = this,
99
+ ret: string[] = [];
100
+
101
+ // get all options
102
+ [...that.#e.querySelectorAll('option')]
103
+ .filter((o) => o.selected)
104
+ .forEach((o) => {
105
+ ret.push(o.value);
106
+ });
107
+
108
+ if (this.#multi) return ret;
109
+ return ret.length ? ret[0] : '';
110
+ }
111
+
112
+ set val(value: string[] | string) {
113
+ const that = this;
114
+
115
+ value = typeof value === 'string' ? [value] : value;
116
+
117
+ // set all options
118
+ [...that.#e.querySelectorAll('option')].forEach((o) => {
119
+ if (value.indexOf(o.value) > -1) {
120
+ o.selected = true;
121
+ } else {
122
+ o.selected = false;
123
+ }
124
+ });
125
+ }
126
+ }
127
+
128
+ class TextAreaHandler extends InputBase {
129
+ #e: HTMLTextAreaElement;
130
+ constructor(e: HTMLTextAreaElement) {
131
+ super(e);
132
+ this.#e = e;
133
+ }
134
+
135
+ get val(): string {
136
+ return this.#e.value || '';
137
+ }
138
+
139
+ set val(value: string) {
140
+ this.#e.value = value;
141
+ }
142
+ }
143
+
144
+ const getInputHandlers = (e: HTMLElement | ShadowRoot): LooseObject => {
145
+ let inputList = [
146
+ ...(e || document).querySelectorAll('input,select,textarea'),
147
+ ],
148
+ handlers: LooseObject = {};
149
+
150
+ inputList.forEach((i) => {
151
+ const name: string | null = (i as inputTypes).getAttribute('name');
152
+ if (name) {
153
+ let handler: any = false;
154
+ switch (getInputName(i as inputTypes)) {
155
+ case 'input':
156
+ switch ((i as HTMLInputElement).type) {
157
+ case 'radio':
158
+ handler = new RadioHandler(i as HTMLInputElement);
159
+ break;
160
+ case 'checkbox':
161
+ handler = new CheckboxHandler(i as HTMLInputElement);
162
+ break;
163
+ default:
164
+ handler = new InputHandler(i as HTMLInputElement);
165
+ }
166
+ break;
167
+ case 'select':
168
+ handler = new SelectHandler(i as HTMLSelectElement);
169
+ break;
170
+ case 'textarea':
171
+ handler = new TextAreaHandler(i as HTMLTextAreaElement);
172
+ break;
173
+ default:
174
+ console.warn(
175
+ 'handler missing:',
176
+ name,
177
+ 'for',
178
+ i.tagName.toLowerCase(),
179
+ i
180
+ );
181
+ break;
182
+ }
183
+
184
+ if (handler) {
185
+ DC.add(i, name, handler);
186
+ Object.defineProperty(handlers, name, {
187
+ enumerable: true,
188
+ configurable: true,
189
+ get: (): any => {
190
+ return handler.val;
191
+ },
192
+ set: (value: any) => {
193
+ if (handler.val !== value) {
194
+ handler.val = value;
195
+ }
196
+ },
197
+ });
198
+ }
199
+ }
200
+ });
201
+
202
+ return handlers;
203
+ };
204
+
205
+ export function formValues(
206
+ targetObject: LooseObject,
207
+ propertyName: string,
208
+ dom: HTMLElement | ShadowRoot
209
+ ) {
210
+ let handlers = getInputHandlers(dom);
211
+
212
+ targetObject[propertyName] = Object.assign({}, handlers);
213
+
214
+ observe(targetObject, propertyName);
215
+
216
+ copyGettersSetters(handlers, targetObject[propertyName]);
217
+
218
+ [...dom.querySelectorAll('input, textarea, select')].forEach((input) => {
219
+ addListener(input as inputTypes, 'keyup', (ev: Event) => {
220
+ //console.log('keyup', ev);
221
+ targetObject[propertyName].notify();
222
+ });
223
+ addListener(input as HTMLElement, 'change', (ev: Event) => {
224
+ //console.log('change', ev);
225
+ targetObject[propertyName].notify();
226
+ });
227
+ addListener(input as inputTypes, 'select', (ev: Event) => {
228
+ //console.log('select', ev);
229
+ targetObject[propertyName].notify();
230
+ });
231
+ });
232
+ }
233
+
@@ -0,0 +1,149 @@
1
+ 'use strict';
2
+
3
+ export interface LooseObject {
4
+ [key: string | symbol]: any;
5
+ }
6
+
7
+ export function isNativeObject(value: any): boolean {
8
+ return value && value['constructor'] && value.constructor === Object;
9
+ }
10
+
11
+ export function sortObject(o: LooseObject): LooseObject {
12
+ let result: LooseObject = {},
13
+ keys = [...Object.keys(o)].sort();
14
+
15
+ keys.forEach((key) => {
16
+ if (isNativeObject(o[key])) {
17
+ result[key] = sortObject(o[key]);
18
+ } else {
19
+ result[key] = o[key];
20
+ }
21
+ });
22
+
23
+ return result;
24
+ }
25
+
26
+ export function flattenObject(
27
+ o: LooseObject,
28
+ doSort: boolean = true
29
+ ): LooseObject {
30
+ let result: LooseObject = {};
31
+
32
+ [...Object.getOwnPropertyNames(o)].forEach((propName) => {
33
+ if (
34
+ o[propName] &&
35
+ o[propName]['constructor'] &&
36
+ o[propName].constructor === Object
37
+ ) {
38
+ const temp = flattenObject(o[propName], false);
39
+ for (const j in temp) {
40
+ result[propName + '.' + j] = temp[j];
41
+ }
42
+ } else {
43
+ result[propName] = o[propName];
44
+ }
45
+ });
46
+
47
+ return doSort ? sortObject(result) : result;
48
+ }
49
+
50
+ export function deepEqual(o1: LooseObject, o2: LooseObject): boolean {
51
+ return (
52
+ JSON.stringify(flattenObject(o1)) === JSON.stringify(flattenObject(o2))
53
+ );
54
+ }
55
+
56
+ export function nameSpace(ns: string | string[], obj: LooseObject = {}): any {
57
+ let nsa = ns.constructor === String ? ns.split('.') : ns;
58
+
59
+ if (!obj || !nsa[0] || !obj[nsa[0]]) {
60
+ console.warn('ns', nsa[0], 'not in', obj);
61
+ return;
62
+ }
63
+ if (obj[nsa[0]].constructor === Object && nsa.length > 1) {
64
+ return nameSpace((nsa as string[]).splice(1), obj[nsa[0]]);
65
+ }
66
+ return obj[nsa[0]];
67
+ }
68
+
69
+ export function parse(what: string | Object | any[], parseThis: Object) {
70
+ var args = Array.from(arguments);
71
+
72
+ if (args.length > 2) {
73
+ while (args.length > 1) {
74
+ args[0] = parse(args[0], args[1]);
75
+ args.splice(1, 1);
76
+ }
77
+ return args[0];
78
+ }
79
+
80
+ if (typeof what === 'string') {
81
+ what.match(/\{[^\{\}]*\}/g)?.forEach(function (pPropname) {
82
+ var propname = pPropname.substring(1, pPropname.length - 1),
83
+ value = nameSpace(propname, parseThis);
84
+ //console.log(propname, value);
85
+ if (typeof value !== 'undefined') {
86
+ what = (what as string).replace(pPropname, value);
87
+ }
88
+ });
89
+ } else if (isNativeObject(what)) {
90
+ switch (what.constructor) {
91
+ case Object:
92
+ Object.keys(what).forEach(function (pKey) {
93
+ if (what.hasOwnProperty(pKey)) {
94
+ (what as LooseObject)[pKey] = parse(
95
+ (what as LooseObject)[pKey],
96
+ parseThis
97
+ );
98
+ }
99
+ });
100
+ break;
101
+ case Array:
102
+ (what as Array<any>).forEach(function (pValue, pKey, original) {
103
+ original[pKey] = parse((what as any)[pKey], parseThis);
104
+ });
105
+ break;
106
+ }
107
+ }
108
+
109
+ return what;
110
+ }
111
+
112
+ export function kebabToPascal(str: string) {
113
+ return str
114
+ .split('-') // Split by hyphens
115
+ .map((word) => word.charAt(0).toUpperCase() + word.slice(1)) // Capitalize each part
116
+ .join(''); // Join without spaces
117
+ }
118
+
119
+ export function debounce(func: Function, milliseconds: number): Function {
120
+ let timeout: any;
121
+ return () => {
122
+ clearTimeout(timeout);
123
+
124
+ timeout = setTimeout(function () {
125
+ func(...arguments);
126
+ }, milliseconds);
127
+ };
128
+ }
129
+
130
+ export function htmlToElements(html: string): HTMLElement[] {
131
+ let template = document.createElement('template');
132
+
133
+ html = html.replace(/<([A-Za-z0-9\-]*)([^>\/]*)(\/>)/gi, '<$1$2></$1>'); // replace XHTML closing tags by full closing tags
134
+
135
+ template.innerHTML = html;
136
+
137
+ template.content.normalize();
138
+
139
+ return Array.from(template.content.childNodes) as HTMLElement[];
140
+ }
141
+
142
+ export function copyGettersSetters(source: LooseObject, target: LooseObject) {
143
+ const descriptors = Object.getOwnPropertyDescriptors(source);
144
+ for (const [key, descriptor] of Object.entries(descriptors)) {
145
+ if ('get' in descriptor || 'set' in descriptor) {
146
+ Object.defineProperty(target, key, descriptor);
147
+ }
148
+ }
149
+ }
@@ -0,0 +1,8 @@
1
+ "use strict";
2
+ export * from './helpers.js';
3
+ export * from './MC.js';
4
+ export * from './McEvent.js';
5
+ export * from './elements.js';
6
+ export * from './observables.js';
7
+ export * from './selectors.js';
8
+ export * from './formValues.js';