@sekiui/elements 0.0.28 → 0.0.31

package/dist/collection/components/switch/seki-switch.js

@@ -0,0 +1,294 @@
+import { h, Host } from "@stencil/core";
+/**
+ * @component seki-switch
+ * @description An accessible toggle control for binary on/off states with full keyboard navigation,
+ * ARIA support, form integration, and theme compatibility.
+ * @example
+ * <seki-switch></seki-switch>
+ * <seki-switch checked></seki-switch>
+ * <seki-switch disabled></seki-switch>
+ */
+export class SekiSwitch {
+    constructor() {
+        /**
+         * @description Initial checked state for uncontrolled mode. Ignored if checked prop is provided.
+         */
+        this.defaultChecked = false;
+        /**
+         * @description Disables all interactions when true.
+         */
+        this.disabled = false;
+        /**
+         * @description Marks switch as required for form validation.
+         */
+        this.required = false;
+        /**
+         * @description Value sent in form data when switch is checked. Defaults to 'on'.
+         */
+        this.value = 'on';
+        /**
+         * @description Internal checked state for uncontrolled mode.
+         */
+        this.internalChecked = false;
+        /**
+         * Toggle switch state and emit event
+         */
+        this.toggle = () => {
+            if (this.disabled) {
+                return;
+            }
+            const newCheckedState = !this.isChecked;
+            // Update internal state only in uncontrolled mode
+            if (this.checked === undefined) {
+                this.internalChecked = newCheckedState;
+            }
+            // Always emit event (for both controlled and uncontrolled)
+            this.sekiChange.emit({ checked: newCheckedState });
+        };
+        /**
+         * Handle click events
+         */
+        this.handleClick = () => {
+            this.toggle();
+        };
+    }
+    /**
+     * Initialize internal checked state from defaultChecked
+     */
+    componentWillLoad() {
+        this.internalChecked = this.defaultChecked;
+    }
+    /**
+     * Get current checked state (controlled vs uncontrolled)
+     */
+    get isChecked() {
+        return this.checked !== undefined ? this.checked : this.internalChecked;
+    }
+    /**
+     * Handle keyboard events (Space and Enter keys)
+     */
+    handleKeyDown(event) {
+        if (this.disabled) {
+            return;
+        }
+        // Toggle on Space or Enter
+        if (event.key === ' ' || event.key === 'Enter') {
+            event.preventDefault(); // Prevent page scroll on Space
+            this.toggle();
+        }
+    }
+    render() {
+        const isChecked = this.isChecked;
+        const dataState = isChecked ? 'checked' : 'unchecked';
+        return (h(Host, { key: 'af5412cee9d097e57d8e626522619913b7459e4b', "data-state": dataState, "data-disabled": this.disabled ? '' : null }, h("div", { key: 'a2c15a3f6b33b4e98e215d82c14cba9dd47bd951', class: "switch", part: "switch", role: "switch", "aria-checked": isChecked ? 'true' : 'false', "aria-disabled": this.disabled ? 'true' : undefined, "aria-label": this.ariaLabel || undefined, "aria-required": this.required ? 'true' : undefined, tabindex: this.disabled ? -1 : 0, onClick: this.handleClick }, h("span", { key: '51fb815c2710b8fd5ac12bdc90b09c44a3bf9b24', class: "thumb", part: "thumb" })), this.name && (h("input", { key: '37f059d43e01b82c9fc3e6f1f1df5c894e8a6102', type: "checkbox", name: this.name, value: this.value, checked: isChecked, required: this.required, disabled: this.disabled, style: { display: 'none' }, tabindex: -1, "aria-hidden": "true" }))));
+    }
+    static get is() { return "seki-switch"; }
+    static get encapsulation() { return "shadow"; }
+    static get originalStyleUrls() {
+        return {
+            "$": ["seki-switch.css"]
+        };
+    }
+    static get styleUrls() {
+        return {
+            "$": ["seki-switch.css"]
+        };
+    }
+    static get properties() {
+        return {
+            "checked": {
+                "type": "boolean",
+                "mutable": false,
+                "complexType": {
+                    "original": "boolean",
+                    "resolved": "boolean | undefined",
+                    "references": {}
+                },
+                "required": false,
+                "optional": true,
+                "docs": {
+                    "tags": [{
+                            "name": "description",
+                            "text": "Controlled checked state. When provided, component operates in controlled mode."
+                        }],
+                    "text": ""
+                },
+                "getter": false,
+                "setter": false,
+                "reflect": false,
+                "attribute": "checked"
+            },
+            "defaultChecked": {
+                "type": "boolean",
+                "mutable": false,
+                "complexType": {
+                    "original": "boolean",
+                    "resolved": "boolean",
+                    "references": {}
+                },
+                "required": false,
+                "optional": false,
+                "docs": {
+                    "tags": [{
+                            "name": "description",
+                            "text": "Initial checked state for uncontrolled mode. Ignored if checked prop is provided."
+                        }],
+                    "text": ""
+                },
+                "getter": false,
+                "setter": false,
+                "reflect": false,
+                "attribute": "default-checked",
+                "defaultValue": "false"
+            },
+            "disabled": {
+                "type": "boolean",
+                "mutable": false,
+                "complexType": {
+                    "original": "boolean",
+                    "resolved": "boolean",
+                    "references": {}
+                },
+                "required": false,
+                "optional": false,
+                "docs": {
+                    "tags": [{
+                            "name": "description",
+                            "text": "Disables all interactions when true."
+                        }],
+                    "text": ""
+                },
+                "getter": false,
+                "setter": false,
+                "reflect": false,
+                "attribute": "disabled",
+                "defaultValue": "false"
+            },
+            "required": {
+                "type": "boolean",
+                "mutable": false,
+                "complexType": {
+                    "original": "boolean",
+                    "resolved": "boolean",
+                    "references": {}
+                },
+                "required": false,
+                "optional": false,
+                "docs": {
+                    "tags": [{
+                            "name": "description",
+                            "text": "Marks switch as required for form validation."
+                        }],
+                    "text": ""
+                },
+                "getter": false,
+                "setter": false,
+                "reflect": false,
+                "attribute": "required",
+                "defaultValue": "false"
+            },
+            "name": {
+                "type": "string",
+                "mutable": false,
+                "complexType": {
+                    "original": "string",
+                    "resolved": "string | undefined",
+                    "references": {}
+                },
+                "required": false,
+                "optional": true,
+                "docs": {
+                    "tags": [{
+                            "name": "description",
+                            "text": "Form field name for form integration."
+                        }],
+                    "text": ""
+                },
+                "getter": false,
+                "setter": false,
+                "reflect": false,
+                "attribute": "name"
+            },
+            "value": {
+                "type": "string",
+                "mutable": false,
+                "complexType": {
+                    "original": "string",
+                    "resolved": "string",
+                    "references": {}
+                },
+                "required": false,
+                "optional": false,
+                "docs": {
+                    "tags": [{
+                            "name": "description",
+                            "text": "Value sent in form data when switch is checked. Defaults to 'on'."
+                        }],
+                    "text": ""
+                },
+                "getter": false,
+                "setter": false,
+                "reflect": false,
+                "attribute": "value",
+                "defaultValue": "'on'"
+            },
+            "ariaLabel": {
+                "type": "string",
+                "mutable": false,
+                "complexType": {
+                    "original": "string",
+                    "resolved": "string | undefined",
+                    "references": {}
+                },
+                "required": false,
+                "optional": true,
+                "docs": {
+                    "tags": [{
+                            "name": "description",
+                            "text": "Accessible label for standalone switches without associated label elements."
+                        }],
+                    "text": ""
+                },
+                "getter": false,
+                "setter": false,
+                "reflect": false,
+                "attribute": "aria-label"
+            }
+        };
+    }
+    static get states() {
+        return {
+            "internalChecked": {}
+        };
+    }
+    static get events() {
+        return [{
+                "method": "sekiChange",
+                "name": "sekiChange",
+                "bubbles": true,
+                "cancelable": true,
+                "composed": true,
+                "docs": {
+                    "tags": [{
+                            "name": "description",
+                            "text": "Emitted when checked state changes (user interaction or programmatic)."
+                        }],
+                    "text": ""
+                },
+                "complexType": {
+                    "original": "{ checked: boolean }",
+                    "resolved": "{ checked: boolean; }",
+                    "references": {}
+                }
+            }];
+    }
+    static get listeners() {
+        return [{
+                "name": "keydown",
+                "method": "handleKeyDown",
+                "target": undefined,
+                "capture": false,
+                "passive": false
+            }];
+    }
+}

package/dist/collection/index.js

@@ -1 +1 @@
-export {};
+export { SekiSwitch } from './components/switch/seki-switch';