@taybart/corvid 0.2.0 → 0.2.3

package/dist/dom.d.ts

@@ -1,3 +1,4 @@
+import * as style from './style';
 import { logger } from './utils';
 /****************
  *     DOM      *
@@ -17,8 +18,14 @@ export declare function onKey(key: string, cb: (ev: {
     shift: boolean;
 }) => void, verbose?: boolean): () => void;
 export declare function els(query: string, verbose?: boolean): el[];
+/**
+ * Define a custom element. Defining the same name with the same class again is a
+ * no-op rather than a `NotSupportedError`, so a double import or an HMR reload
+ * does not blow up; a *different* class on a taken name is still an error.
+ */
+export declare function registerElement(name: string, ctor: CustomElementConstructor): void;
 /*** element ***/
-type elOpts = {
+export type elOpts = {
     element?: HTMLElement;
     query?: string;
     tag?: string;
@@ -40,7 +47,7 @@ export declare class el {
     constructor(opts: HTMLElement | string | elOpts, verbose?: boolean);
     static query(query: string, verbose?: boolean): el;
     /*** dom manipulation ***/
-    value(update?: string): string | el;
+    value(update?: string): string | this;
     parent(parent: HTMLElement | el): this;
     append(ch: HTMLElement | el | string): this;
     appendChild(ch: HTMLElement | el): this;
@@ -51,22 +58,103 @@ export declare class el {
     content(content: any, { text }?: {
         text?: boolean;
     }): this;
-    html(content: string): void;
+    html(content: string | HTMLElement | el): this;
     src(url: string): this;
     attrs(attrs: Object): this;
     attr(key: string, val: string): this;
     removeAttr(key: string): this;
     /*** Style ***/
-    style(update: Object | string, stringify?: boolean): this | undefined;
+    style(update: Object | string, stringify?: boolean): this;
     hasClass(className: string): boolean;
+    toggleClass(className: string): this;
     addClass(className: string | string[]): this;
     removeClass(className: string | string[]): this;
-    /*** Templates ***/
     /*** Events ***/
     on(event: string, cb: (ev: Event) => void, options?: AddEventListenerOptions | boolean): this;
     listen(event: string, cb: (ev: Event) => void, options?: AddEventListenerOptions | boolean): this;
     removeListeners(event: string): this;
 }
+/**
+ * Create an element and return the node itself, not an `el` wrapper. Takes the
+ * same options as `el`, so a custom element comes back ready to talk to:
+ *
+ *   const form = create({ tag: 'x-search-form', parent: '#query-form' })
+ *   form.onSubmit(...)   // its own methods, no `.el` hop
+ *
+ * Wrap it later with `new el(node)` if you want the chainable helpers.
+ */
+export declare function create<T extends HTMLElement = HTMLElement>(opts: elOpts, verbose?: boolean): T;
+/*** component ***/
+export declare function registerComponents(components: (typeof component)[], verbose?: boolean): void;
+export declare class component extends HTMLElement {
+    #private;
+    /** the name to register as; must contain a hyphen */
+    static tag: string;
+    /**
+     * Injected once at `register()`, scoped to the tag. Written *relative* to the
+     * component — no tag selector of its own — so it always matches whatever name
+     * the class actually registered under.
+     */
+    static styles: style.declarations | null;
+    /**
+     * Opt in to a shadow root: `static shadow = { mode: 'open' }`.
+     *
+     * Without it a component's `styles` are injected at document level and
+     * compile to plain descendant selectors, so an outer component's `ul` or
+     * `.meta` rule reaches an inner component's markup — and only has to name a
+     * property the inner rule leaves unset to take effect. A shadow root ends
+     * that by construction, in both directions.
+     *
+     * What changes for the component: put children in `this.root`, not `this`.
+     * Two things to know before turning it on —
+     *
+     * - light-dom children are not rendered unless the root has a `<slot>`, so a
+     *   component that takes `content` needs one
+     * - a nested custom element loses its document styles inside the root, so
+     *   anything rendered in here has to be shadowed too
+     * DOCS: https://developer.mozilla.org/en-US/docs/Web/API/Web_components/Using_shadow_DOM
+     */
+    static shadow: ShadowRootInit | null;
+    constructor();
+    /**
+     * Where this component's children belong: its shadow root when it has one,
+     * otherwise the element itself. Use it instead of `this` for `append`,
+     * `replaceChildren` and `querySelector`, and the component works either way.
+     */
+    get root(): ShadowRoot | this;
+    /**
+     * Inject this component's styles and define it. Idempotent, so calling it
+     * twice (or after an HMR reload) is harmless.
+     * @param tag - overrides `static tag`
+     */
+    static register(tag?: string, verbose?: boolean): void;
+    /**
+     * Called once, the first time the element is connected. Build the subtree and
+     * wire listeners here — a custom element cannot give itself children before
+     * it is connected, and `connectedCallback` runs again on every re-insertion.
+     */
+    mount(): void;
+    /**
+     * Called every time the element is disconnected. Listeners on this element
+     * and on children it owns go away with it; undo document/window listeners
+     * here, using the removers `on()` and `onKey()` hand back.
+     */
+    unmount(): void;
+    /**
+     * Called for every change to an attribute named in `static observedAttributes`,
+     * and never before `mount()` — changes that arrive earlier (anything set at
+     * creation or parse time, which the platform reports *before*
+     * `connectedCallback`) are held and delivered in order right after mount.
+     *
+     * Attributes are strings. For structured data use a property with a setter
+     * that re-renders; an object put through `setAttribute` becomes
+     * "[object Object]".
+     */
+    onAttr(_name: string, _value: string | null, _prev: string | null): void;
+    connectedCallback(): void;
+    disconnectedCallback(): void;
+    attributeChangedCallback(name: string, prev: string | null, value: string | null): void;
+}
 /**
  * Get a template from a string
  * https://stackoverflow.com/a/41015840
@@ -78,6 +166,9 @@ export declare function interpolate(str: string, params: Object): string;
 declare const _default: {
     el: typeof el;
     els: typeof els;
+    create: typeof create;
+    component: typeof component;
+    registerElement: typeof registerElement;
     ready: typeof ready;
     on: typeof on;
     onKey: typeof onKey;

package/dist/dom.js

@@ -1,11 +1,159 @@
-function strings_toKebab(str) {
+function toKebab(str) {
     return str.replace(/[A-Z]+(?![a-z])|[A-Z]/g, (s, ofs)=>(ofs ? '-' : '') + s.toLowerCase());
 }
 function render(style) {
     let s = '';
-    Object.entries(style).forEach(([k, v])=>s += `${strings_toKebab(k)}:${v};`);
+    Object.entries(style).forEach(([k, v])=>s += `${toKebab(k)}:${v};`);
     return s;
 }
+function splitSelectors(selector) {
+    const out = [];
+    let depth = 0;
+    let quote = '';
+    let current = '';
+    for (const ch of selector){
+        if (quote) {
+            if (ch === quote) quote = '';
+        } else if ('"' === ch || "'" === ch) quote = ch;
+        else if ('(' === ch || '[' === ch) depth++;
+        else if (')' === ch || ']' === ch) depth--;
+        else if (',' === ch && 0 === depth) {
+            if (current.trim()) out.push(current.trim());
+            current = '';
+            continue;
+        }
+        current += ch;
+    }
+    if (current.trim()) out.push(current.trim());
+    return out;
+}
+function hostCompound(selector) {
+    if (!selector.startsWith(':host')) return selector;
+    let i = 5;
+    let inner = '';
+    if ('(' === selector[i]) {
+        const open = i;
+        let depth = 0;
+        let quote = '';
+        while(i < selector.length){
+            const ch = selector[i];
+            if (quote) {
+                if (ch === quote) quote = '';
+            } else if ('"' === ch || "'" === ch) quote = ch;
+            else if ('(' === ch) depth++;
+            else if (')' === ch) {
+                depth--;
+                if (0 === depth) {
+                    i++;
+                    break;
+                }
+            }
+            i++;
+        }
+        inner = selector.slice(open + 1, i - 1);
+    }
+    const start = i;
+    let depth = 0;
+    let quote = '';
+    while(i < selector.length){
+        const ch = selector[i];
+        if (quote) {
+            if (ch === quote) quote = '';
+        } else if ('"' === ch || "'" === ch) quote = ch;
+        else if (0 === depth && (' ' === ch || '>' === ch || '+' === ch || '~' === ch)) break;
+        else if (0 === depth && ':' === ch && ':' === selector[i + 1]) break;
+        else if ('(' === ch || '[' === ch) depth++;
+        else if (')' === ch || ']' === ch) depth--;
+        i++;
+    }
+    const compound = selector.slice(start, i);
+    if (!compound) return selector;
+    return `:host(${inner}${compound})${selector.slice(i)}`;
+}
+function resolve(parents, selector) {
+    const out = [];
+    for (const parent of parents)for (const part of splitSelectors(selector))out.push(hostCompound(part.includes('&') ? part.replaceAll('&', parent) : `${parent} ${part}`));
+    return out;
+}
+function compile(parents, decls, indent = '') {
+    const blocks = [];
+    const props = [];
+    const nested = [];
+    for (const [k, v] of Object.entries(decls))if (null !== v && 'object' == typeof v) nested.push([
+        k,
+        v
+    ]);
+    else props.push(`${indent}  ${toKebab(k)}: ${v};`);
+    if (props.length) blocks.push(`${indent}${parents.join(', ')} {\n${props.join('\n')}\n${indent}}`);
+    for (const [selector, block] of nested){
+        if (selector.startsWith('@')) {
+            const inner = selector.startsWith('@keyframes') ? Object.entries(block).flatMap(([step, d])=>null !== d && 'object' == typeof d ? compile([
+                    step
+                ], d, `${indent}  `) : []) : compile(parents, block, `${indent}  `);
+            if (inner.length) blocks.push(`${indent}${selector} {\n${inner.join('\n')}\n${indent}}`);
+            continue;
+        }
+        blocks.push(...compile(resolve(parents, selector), block, indent));
+    }
+    return blocks;
+}
+function css(selector, style) {
+    return compile(splitSelectors(selector), style).join('\n');
+}
+function registry() {
+    const doc = document;
+    if (!doc.__corvidSheets) doc.__corvidSheets = new Map();
+    return doc.__corvidSheets;
+}
+function adoptable() {
+    return 'undefined' != typeof CSSStyleSheet && 'replaceSync' in CSSStyleSheet.prototype && 'undefined' != typeof Document && 'adoptedStyleSheets' in Document.prototype;
+}
+function styleTag(key) {
+    const tagged = Array.from(document.head.querySelectorAll('style[data-corvid]'));
+    for (const node of tagged)if (node.dataset.corvid === key) return node;
+    const node = document.createElement('style');
+    node.dataset.corvid = key;
+    document.head.appendChild(node);
+    return node;
+}
+function inject(selector, style, { key = selector } = {}) {
+    const rules = css(selector, style);
+    const sheets = registry();
+    const existing = sheets.get(key);
+    if (existing) {
+        if ('replaceSync' in existing) existing.replaceSync(rules);
+        else existing.textContent = rules;
+        return rules;
+    }
+    if (adoptable()) {
+        const sheet = new CSSStyleSheet();
+        sheet.replaceSync(rules);
+        document.adoptedStyleSheets = [
+            ...document.adoptedStyleSheets,
+            sheet
+        ];
+        sheets.set(key, sheet);
+        return rules;
+    }
+    const node = styleTag(key);
+    node.textContent = rules;
+    sheets.set(key, node);
+    return rules;
+}
+function shadowSheet(key, style) {
+    const rules = css(':host', style);
+    if ('undefined' == typeof CSSStyleSheet || !('replaceSync' in CSSStyleSheet.prototype) || 'undefined' == typeof ShadowRoot || !('adoptedStyleSheets' in ShadowRoot.prototype)) return rules;
+    const sheets = registry();
+    const existing = sheets.get(key);
+    if (existing && 'replaceSync' in existing) {
+        existing.replaceSync(rules);
+        return existing;
+    }
+    const sheet = new CSSStyleSheet();
+    sheet.replaceSync(rules);
+    sheets.set(key, sheet);
+    return sheet;
+}
 function _define_property(obj, key, value) {
     if (key in obj) Object.defineProperty(obj, key, {
         value: value,
@@ -61,6 +209,37 @@ class logger {
         });
     }
 }
+function _check_private_redeclaration(obj, privateCollection) {
+    if (privateCollection.has(obj)) throw new TypeError("Cannot initialize the same private elements twice on an object");
+}
+function _class_apply_descriptor_get(receiver, descriptor) {
+    if (descriptor.get) return descriptor.get.call(receiver);
+    return descriptor.value;
+}
+function _class_apply_descriptor_set(receiver, descriptor, value) {
+    if (descriptor.set) descriptor.set.call(receiver, value);
+    else {
+        if (!descriptor.writable) throw new TypeError("attempted to set read only private field");
+        descriptor.value = value;
+    }
+}
+function _class_extract_field_descriptor(receiver, privateMap, action) {
+    if (!privateMap.has(receiver)) throw new TypeError("attempted to " + action + " private field on non-instance");
+    return privateMap.get(receiver);
+}
+function _class_private_field_get(receiver, privateMap) {
+    var descriptor = _class_extract_field_descriptor(receiver, privateMap, "get");
+    return _class_apply_descriptor_get(receiver, descriptor);
+}
+function _class_private_field_init(obj, privateMap, value) {
+    _check_private_redeclaration(obj, privateMap);
+    privateMap.set(obj, value);
+}
+function _class_private_field_set(receiver, privateMap, value) {
+    var descriptor = _class_extract_field_descriptor(receiver, privateMap, "set");
+    _class_apply_descriptor_set(receiver, descriptor, value);
+    return value;
+}
 function dom_define_property(obj, key, value) {
     if (key in obj) Object.defineProperty(obj, key, {
         value: value,
@@ -110,6 +289,14 @@ function onKey(key, cb, verbose = false) {
 function els(query, verbose = false) {
     return Array.from(document.querySelectorAll(query)).map((n)=>new dom_el(n, verbose));
 }
+function registerElement(name, ctor) {
+    const existing = customElements.get(name);
+    if (existing) {
+        if (existing !== ctor) throw new Error(`custom element ${name} is already registered by ${existing.name}`);
+        return;
+    }
+    customElements.define(name, ctor);
+}
 class dom_el {
     static query(query, verbose = false) {
         return new dom_el(query, verbose);
@@ -167,7 +354,11 @@ class dom_el {
     }
     html(content) {
         if (!this.el) throw new Error(`no element from query: ${this.query}`);
-        this.el.innerHTML = content;
+        if ('string' == typeof content) this.el.innerHTML = content;
+        else if (content instanceof dom_el) {
+            if (content.el) this.el.replaceChildren(content.el);
+        } else this.el.replaceChildren(content);
+        return this;
     }
     src(url) {
         if (this.el && 'src' in this.el) this.el.src = url;
@@ -194,7 +385,7 @@ class dom_el {
             else if ('object' == typeof update) {
                 if (!stringify) {
                     for (const [k, v] of Object.entries(update))this.el.style[k] = v;
-                    return;
+                    return this;
                 }
                 const s = render(update);
                 this.log.debug(`set style: ${this.el.style} -> ${s}`);
@@ -207,6 +398,12 @@ class dom_el {
         if (!this.el) throw new Error(`no element from query: ${this.query}`);
         return this.el.classList.contains(className);
     }
+    toggleClass(className) {
+        if (!this.el) throw new Error(`no element from query: ${this.query}`);
+        if (this.el.classList.contains(className)) this.el.classList.remove(className);
+        else this.el.classList.add(className);
+        return this;
+    }
     addClass(className) {
         if (!this.el) throw new Error(`no element from query: ${this.query}`);
         if ('string' == typeof className) this.el.classList.add(className);
@@ -297,6 +494,82 @@ class dom_el {
         }
     }
 }
+function create(opts, verbose = false) {
+    const node = new dom_el(opts, verbose).el;
+    if (!node) throw new Error(`could not create element: ${opts.tag ?? opts.query ?? '?'}`);
+    return node;
+}
+function registerComponents(components, verbose = false) {
+    for (const c of components)c.register(void 0, verbose);
+}
+const dom_sheets = new WeakMap();
+var _mounted = /*#__PURE__*/ new WeakMap(), _root = /*#__PURE__*/ new WeakMap(), _pendingAttrs = /*#__PURE__*/ new WeakMap();
+class component extends HTMLElement {
+    get root() {
+        return _class_private_field_get(this, _root) ?? this;
+    }
+    static register(tag, verbose = false) {
+        const name = tag ?? this.tag;
+        if (!name) throw new Error(`${this.name}: nothing to register as, set \`static tag = 'x-...'\``);
+        if (!name.includes('-')) throw new Error(`${this.name}: '${name}' is not a valid custom element name, it needs a hyphen`);
+        if (this.styles) if (this.shadow) dom_sheets.set(this, shadowSheet(`shadow:${name}`, this.styles));
+        else inject(name, this.styles);
+        if (verbose) console.log(`registering ${name}`);
+        registerElement(name, this);
+    }
+    mount() {}
+    unmount() {}
+    onAttr(_name, _value, _prev) {}
+    connectedCallback() {
+        if (!_class_private_field_get(this, _mounted)) {
+            _class_private_field_set(this, _mounted, true);
+            this.mount();
+            const queued = _class_private_field_get(this, _pendingAttrs);
+            _class_private_field_set(this, _pendingAttrs, []);
+            for (const [name, value, prev] of queued)this.onAttr(name, value, prev);
+        }
+    }
+    disconnectedCallback() {
+        this.unmount();
+    }
+    attributeChangedCallback(name, prev, value) {
+        if (prev === value) return;
+        if (!_class_private_field_get(this, _mounted)) return void _class_private_field_get(this, _pendingAttrs).push([
+            name,
+            value,
+            prev
+        ]);
+        this.onAttr(name, value, prev);
+    }
+    constructor(){
+        super(), _class_private_field_init(this, _mounted, {
+            writable: true,
+            value: false
+        }), _class_private_field_init(this, _root, {
+            writable: true,
+            value: null
+        }), _class_private_field_init(this, _pendingAttrs, {
+            writable: true,
+            value: []
+        });
+        const ctor = this.constructor;
+        if (!ctor.shadow) return;
+        _class_private_field_set(this, _root, this.attachShadow(ctor.shadow));
+        const sheet = dom_sheets.get(ctor);
+        if (void 0 === sheet) return;
+        if ('string' == typeof sheet) {
+            const node = document.createElement('style');
+            node.textContent = sheet;
+            _class_private_field_get(this, _root).append(node);
+        } else _class_private_field_get(this, _root).adoptedStyleSheets = [
+            ..._class_private_field_get(this, _root).adoptedStyleSheets,
+            sheet
+        ];
+    }
+}
+dom_define_property(component, "tag", '');
+dom_define_property(component, "styles", null);
+dom_define_property(component, "shadow", null);
 function interpolate(str, params) {
     let names = Object.keys(params).map((k)=>`_${k}`);
     let vals = Object.values(params);
@@ -305,8 +578,11 @@ function interpolate(str, params) {
 const dom = {
     el: dom_el,
     els,
+    create,
+    component,
+    registerElement,
     ready,
     on,
     onKey
 };
-export { dom as default, dom_el as el, els, interpolate, on, onBlur, onFocus, onKey, ready };
+export { component, create, dom as default, dom_el as el, els, interpolate, on, onBlur, onFocus, onKey, ready, registerComponents, registerElement };