@c2n/switch 0.0.6 → 0.0.8

package/dist/switch.js

@@ -1,5 +1,6 @@
 import { LitElement, html, unsafeCSS } from "lit";
-import { customElement, property, query, state } from "lit/decorators.js";
+import { property, query, state } from "lit/decorators.js";
+import { customElement } from "@c2n/core/element-helper.js";
 import { classMap } from "lit/directives/class-map.js";
 import { ifDefined } from "lit/directives/if-defined.js";
 import { redispatchEvent } from "@c2n/core/dom-helper.js";
@@ -18,24 +19,76 @@ function __decorate(decorators, target, key, desc) {
 var Switch = class Switch extends LitElement {
 	constructor(..._args) {
 		super(..._args);
+		this.internals = this.attachInternals();
+		this.customValidityMessage = "";
+		this.disabledByForm = false;
+		this.defaultChecked = false;
+		this.defaultCheckedCaptured = false;
 		this.checked = false;
 		this.disabled = false;
 		this.name = "";
 		this.value = "on";
+		this.required = false;
 		this.label = "";
 		this.hasDescription = false;
 		this.dragging = false;
 		this.suppressClick = false;
 	}
+	static {
+		this.formAssociated = true;
+	}
 	static {
 		this.styles = unsafeCSS(switch_default);
 	}
+	connectedCallback() {
+		super.connectedCallback();
+		if (!this.defaultCheckedCaptured) {
+			this.defaultChecked = this.hasAttribute("checked");
+			this.defaultCheckedCaptured = true;
+		}
+	}
+	/** The containing form, when this control is associated with one. */
+	get form() {
+		return this.internals.form;
+	}
+	/** Labels associated with this form control. */
+	get labels() {
+		return this.internals.labels;
+	}
+	get validity() {
+		return this.internals.validity;
+	}
+	get validationMessage() {
+		return this.internals.validationMessage;
+	}
+	get willValidate() {
+		return this.internals.willValidate;
+	}
+	formResetCallback() {
+		this.checked = this.defaultChecked;
+	}
+	formDisabledCallback(disabled) {
+		this.disabledByForm = disabled && !this.hasAttribute("disabled");
+	}
+	formStateRestoreCallback(state) {
+		this.checked = state === "checked";
+	}
+	checkValidity() {
+		return this.internals.checkValidity();
+	}
+	reportValidity() {
+		return this.internals.reportValidity();
+	}
+	setCustomValidity(message) {
+		this.customValidityMessage = message;
+		this.requestUpdate();
+	}
 	focus(options) {
 		this.formElement?.focus(options);
 	}
 	/** Flips the state (or forces it) and fires `change`, as a click would. */
 	toggle(force) {
-		if (this.disabled) return;
+		if (this.effectiveDisabled) return;
 		const next = force ?? !this.checked;
 		if (next === this.checked) return;
 		this.checked = next;
@@ -53,6 +106,16 @@ var Switch = class Switch extends LitElement {
 		if (changed.has("checked") && this.formElement) this.formElement.checked = this.checked;
 		super.update(changed);
 	}
+	updated(_changed) {
+		this.internals.setFormValue(this.checked ? this.value : null, this.checked ? "checked" : "unchecked");
+		const missing = this.required && !this.checked;
+		const flags = this.customValidityMessage ? { customError: true } : missing ? { valueMissing: true } : {};
+		const message = this.customValidityMessage || (missing ? "Please turn on this switch." : "");
+		this.internals.setValidity(flags, message, this.formElement);
+	}
+	get effectiveDisabled() {
+		return this.disabled || this.disabledByForm;
+	}
 	handleDescriptionChange(event) {
 		this.updateDescription(event.target);
 	}
@@ -67,7 +130,7 @@ var Switch = class Switch extends LitElement {
 		return getComputedStyle(this).direction === "rtl";
 	}
 	handlePointerDown(event) {
-		if (this.disabled || event.button !== 0) return;
+		if (this.effectiveDisabled || event.button !== 0) return;
 		const track = this.trackElement;
 		const padding = parseFloat(getComputedStyle(track).paddingLeft) || 0;
 		const travel = Math.max(0, track.clientWidth - 2 * padding - this.thumbElement.getBoundingClientRect().height);
@@ -141,7 +204,8 @@ var Switch = class Switch extends LitElement {
             aria-labelledby=${ifDefined(this.ariaLabelledBy)}
             aria-describedby=${ifDefined(this.ariaDescribedBy)}
             ?checked=${this.checked}
-            ?disabled=${this.disabled}
+            ?disabled=${this.effectiveDisabled}
+            ?required=${this.required}
             @change=${this.handleChange}
             @click=${this.handleClick}
             @pointerdown=${this.handlePointerDown}
@@ -166,6 +230,7 @@ var Switch = class Switch extends LitElement {
     `;
 	}
 };
+__decorate([state()], Switch.prototype, "disabledByForm", void 0);
 __decorate([query("input")], Switch.prototype, "formElement", void 0);
 __decorate([query(".c2-switch-track")], Switch.prototype, "trackElement", void 0);
 __decorate([query(".c2-switch-thumb")], Switch.prototype, "thumbElement", void 0);
@@ -179,6 +244,10 @@ __decorate([property({
 })], Switch.prototype, "disabled", void 0);
 __decorate([property()], Switch.prototype, "name", void 0);
 __decorate([property()], Switch.prototype, "value", void 0);
+__decorate([property({
+	type: Boolean,
+	reflect: true
+})], Switch.prototype, "required", void 0);
 __decorate([property()], Switch.prototype, "label", void 0);
 __decorate([property({
 	type: String,

package/package.json

@@ -1,18 +1,30 @@
 {
   "name": "@c2n/switch",
-  "version": "0.0.6",
+  "version": "0.0.8",
   "type": "module",
   "main": "dist/switch.js",
   "exports": {
     ".": {
-      "default": "./dist/switch.js",
-      "types": "./types/src/switch.d.ts"
+      "types": "./types/src/switch.d.ts",
+      "default": "./dist/switch.js"
+    },
+    "./react": {
+      "types": "./react.d.ts",
+      "default": "./react.js"
+    },
+    "./vue": {
+      "types": "./vue.d.ts",
+      "default": "./vue.js"
     },
     "./custom-elements.json": "./custom-elements.json"
   },
   "files": [
     "dist",
-    "types"
+    "types",
+    "react.d.ts",
+    "react.js",
+    "vue.d.ts",
+    "vue.js"
   ],
   "keywords": [
     "switch",
@@ -50,12 +62,12 @@
     }
   },
   "dependencies": {
-    "@c2n/core": "0.0.6",
+    "@c2n/core": "0.0.8",
     "lit": "3.3.3"
   },
   "devDependencies": {
     "@c2n/config": "*"
   },
   "customElements": "custom-elements.json",
-  "gitHead": "2921054bc75299da66dad11c1e374246ff88a51e"
+  "gitHead": "be59cbccee1d33ca248e39f69b05c0b595ec6c6d"
 }

package/react.d.ts

@@ -0,0 +1,24 @@
+// GENERATED by @c2n/framework-types. Do not edit by hand.
+//
+// JSX types for the custom elements of @c2n/switch. Import once, anywhere in the program:
+//
+//     import '@c2n/switch/react'
+//
+// Register the elements at module scope before React renders, or React writes an object prop as an
+// attribute and it stringifies.
+
+import type { DetailedHTMLProps, HTMLAttributes } from 'react'
+import type { Switch } from '@c2n/switch'
+
+/** Standard React host-element attributes plus the element's own public properties. */
+type C2Props<T> = DetailedHTMLProps<HTMLAttributes<T>, T> & Partial<Omit<T, keyof HTMLElement>>
+
+declare module 'react' {
+  namespace JSX {
+    interface IntrinsicElements {
+      'c2-switch': C2Props<Switch>
+    }
+  }
+}
+
+export {}

package/react.js

@@ -0,0 +1,3 @@
+// GENERATED by @c2n/framework-types. Do not edit by hand.
+// Types only — see the matching .d.ts.
+export {}

package/types/src/switch.d.ts

@@ -1,4 +1,13 @@
 import { LitElement, type PropertyValues } from 'lit';
+import type { TypedAddEventListener, TypedRemoveEventListener } from '@c2n/core/event-helper.js';
+/** Events fired by {@link Switch}, keyed for `addEventListener`. */
+export interface SwitchEventMap {
+    change: Event;
+}
+export interface Switch {
+    addEventListener: TypedAddEventListener<Switch, SwitchEventMap>;
+    removeEventListener: TypedRemoveEventListener<Switch, SwitchEventMap>;
+}
 /**
  * On/off toggle built on a native `<input type="checkbox" role="switch">`, so keyboard activation (Space), form value
  * and the `switch` role come from the browser. The thumb can also be dragged: it follows the pointer and the side it is
@@ -54,7 +63,13 @@ import { LitElement, type PropertyValues } from 'lit';
  * @cssproperty {time} [--c2-switch--transition-duration=200ms] - Thumb slide and colour change.
  */
 export declare class Switch extends LitElement {
+    static formAssociated: boolean;
     static styles: import("lit").CSSResult;
+    private readonly internals;
+    private customValidityMessage;
+    private disabledByForm;
+    private defaultChecked;
+    private defaultCheckedCaptured;
     protected formElement: HTMLInputElement;
     private trackElement;
     private thumbElement;
@@ -66,10 +81,15 @@ export declare class Switch extends LitElement {
     name: string;
     /** Form value submitted while on. Defaults to `on`, like a native checkbox. */
     value: string;
+    /** Requires the switch to be on for the form to be valid. */
+    required: boolean;
     /** Label text when the default slot is empty. */
     label: string;
+    /** Accessible name used when no visible label names the switch. */
     ariaLabel: string;
+    /** Id of the element that labels the switch. */
     ariaLabelledBy: undefined | string;
+    /** Id of the element that describes the switch. */
     ariaDescribedBy: undefined | string;
     private hasDescription;
     /** True while the thumb follows the pointer; disables the slide transition. */
@@ -77,12 +97,28 @@ export declare class Switch extends LitElement {
     private drag?;
     /** The click that follows a drag must not toggle the input again. */
     private suppressClick;
+    connectedCallback(): void;
+    /** The containing form, when this control is associated with one. */
+    get form(): HTMLFormElement | null;
+    /** Labels associated with this form control. */
+    get labels(): NodeList;
+    get validity(): ValidityState;
+    get validationMessage(): string;
+    get willValidate(): boolean;
+    formResetCallback(): void;
+    formDisabledCallback(disabled: boolean): void;
+    formStateRestoreCallback(state: string | File | FormData | null): void;
+    checkValidity(): boolean;
+    reportValidity(): boolean;
+    setCustomValidity(message: string): void;
     focus(options?: FocusOptions): void;
     /** Flips the state (or forces it) and fires `change`, as a click would. */
     toggle(force?: boolean): void;
     /** `slotchange` does not fire for server-rendered slots, so read the description once after the first render. */
     firstUpdated(): void;
     protected update(changed: PropertyValues<this>): void;
+    protected updated(_changed: PropertyValues<this>): void;
+    private get effectiveDisabled();
     private handleDescriptionChange;
     private updateDescription;
     private handleChange;

package/types/src/switch.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"switch.d.ts","sourceRoot":"","sources":["../../src/switch.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAmB,KAAK,cAAc,EAAE,MAAM,KAAK,CAAA;AAOtE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAqDG;AACH,qBACa,MAAO,SAAQ,UAAU;IACpC,OAAgB,MAAM,0BAAoB;IAE1B,SAAS,CAAC,WAAW,EAAG,gBAAgB,CAAA;IAC7B,OAAO,CAAC,YAAY,CAAc;IAClC,OAAO,CAAC,YAAY,CAAc;IAE7D,gCAAgC;IACY,OAAO,UAAQ;IAE3D,yEAAyE;IAC7B,QAAQ,UAAQ;IAE5D,oDAAoD;IACxC,IAAI,SAAK;IAErB,+EAA+E;IACnE,KAAK,SAAO;IAExB,iDAAiD;IACrC,KAAK,SAAK;IAGb,SAAS,EAAG,MAAM,CAAA;IAG3B,cAAc,EAAG,SAAS,GAAG,MAAM,CAAA;IAGnC,eAAe,EAAG,SAAS,GAAG,MAAM,CAAA;IAE3B,OAAO,CAAC,cAAc,CAAQ;IACvC,+EAA+E;IACtE,OAAO,CAAC,QAAQ,CAAQ;IAEjC,OAAO,CAAC,IAAI,CAAC,CAAgH;IAC7H,qEAAqE;IACrE,OAAO,CAAC,aAAa,CAAQ;IAEpB,KAAK,CAAC,OAAO,CAAC,EAAE,YAAY;IAIrC,2EAA2E;IAC3E,MAAM,CAAC,KAAK,CAAC,EAAE,OAAO;IAQtB,iHAAiH;IACxG,YAAY;cAKF,MAAM,CAAC,OAAO,EAAE,cAAc,CAAC,IAAI,CAAC;IAKvD,OAAO,CAAC,uBAAuB;IAI/B,OAAO,CAAC,iBAAiB;IAIzB,OAAO,CAAC,YAAY;IAKpB,OAAO,KAAK,GAAG,GAEd;IAED,OAAO,CAAC,iBAAiB;IAWzB,OAAO,CAAC,iBAAiB;IAazB,OAAO,CAAC,eAAe;IAevB,OAAO,CAAC,mBAAmB;IAM3B,OAAO,CAAC,OAAO;IAKf,OAAO,CAAC,WAAW;IAMV,MAAM;CAsChB;AAED,OAAO,CAAC,MAAM,CAAC;IACb,UAAU,qBAAqB;QAC7B,WAAW,EAAE,MAAM,CAAA;KACpB;CACF"}
+{"version":3,"file":"switch.d.ts","sourceRoot":"","sources":["../../src/switch.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAmB,KAAK,cAAc,EAAE,MAAM,KAAK,CAAA;AAGtE,OAAO,KAAK,EAAE,qBAAqB,EAAE,wBAAwB,EAAE,MAAM,2BAA2B,CAAA;AAMhG,oEAAoE;AACpE,MAAM,WAAW,cAAc;IAC7B,MAAM,EAAE,KAAK,CAAA;CACd;AAED,MAAM,WAAW,MAAM;IACrB,gBAAgB,EAAE,qBAAqB,CAAC,MAAM,EAAE,cAAc,CAAC,CAAA;IAC/D,mBAAmB,EAAE,wBAAwB,CAAC,MAAM,EAAE,cAAc,CAAC,CAAA;CACtE;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAqDG;AACH,qBACa,MAAO,SAAQ,UAAU;IACpC,MAAM,CAAC,cAAc,UAAO;IAE5B,OAAgB,MAAM,0BAAoB;IAE1C,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAyB;IACnD,OAAO,CAAC,qBAAqB,CAAK;IACzB,OAAO,CAAC,cAAc,CAAQ;IACvC,OAAO,CAAC,cAAc,CAAQ;IAC9B,OAAO,CAAC,sBAAsB,CAAQ;IAEtB,SAAS,CAAC,WAAW,EAAG,gBAAgB,CAAA;IAC7B,OAAO,CAAC,YAAY,CAAc;IAClC,OAAO,CAAC,YAAY,CAAc;IAE7D,gCAAgC;IACY,OAAO,UAAQ;IAE3D,yEAAyE;IAC7B,QAAQ,UAAQ;IAE5D,oDAAoD;IACxC,IAAI,SAAK;IAErB,+EAA+E;IACnE,KAAK,SAAO;IAExB,6DAA6D;IACjB,QAAQ,UAAQ;IAE5D,iDAAiD;IACrC,KAAK,SAAK;IAEtB,mEAAmE;IAE1D,SAAS,EAAG,MAAM,CAAA;IAE3B,gDAAgD;IAEhD,cAAc,EAAG,SAAS,GAAG,MAAM,CAAA;IAEnC,mDAAmD;IAEnD,eAAe,EAAG,SAAS,GAAG,MAAM,CAAA;IAE3B,OAAO,CAAC,cAAc,CAAQ;IACvC,+EAA+E;IACtE,OAAO,CAAC,QAAQ,CAAQ;IAEjC,OAAO,CAAC,IAAI,CAAC,CAAgH;IAC7H,qEAAqE;IACrE,OAAO,CAAC,aAAa,CAAQ;IAEpB,iBAAiB;IAQ1B,qEAAqE;IACrE,IAAI,IAAI,2BAEP;IAED,gDAAgD;IAChD,IAAI,MAAM,aAET;IAED,IAAI,QAAQ,kBAEX;IAED,IAAI,iBAAiB,WAEpB;IAED,IAAI,YAAY,YAEf;IAED,iBAAiB;IAIjB,oBAAoB,CAAC,QAAQ,EAAE,OAAO;IAItC,wBAAwB,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,GAAG,QAAQ,GAAG,IAAI;IAI/D,aAAa;IAIb,cAAc;IAId,iBAAiB,CAAC,OAAO,EAAE,MAAM;IAKxB,KAAK,CAAC,OAAO,CAAC,EAAE,YAAY;IAIrC,2EAA2E;IAC3E,MAAM,CAAC,KAAK,CAAC,EAAE,OAAO;IAQtB,iHAAiH;IACxG,YAAY;cAKF,MAAM,CAAC,OAAO,EAAE,cAAc,CAAC,IAAI,CAAC;cAKpC,OAAO,CAAC,QAAQ,EAAE,cAAc,CAAC,IAAI,CAAC;IAQzD,OAAO,KAAK,iBAAiB,GAE5B;IAED,OAAO,CAAC,uBAAuB;IAI/B,OAAO,CAAC,iBAAiB;IAIzB,OAAO,CAAC,YAAY;IAKpB,OAAO,KAAK,GAAG,GAEd;IAED,OAAO,CAAC,iBAAiB;IAWzB,OAAO,CAAC,iBAAiB;IAazB,OAAO,CAAC,eAAe;IAevB,OAAO,CAAC,mBAAmB;IAM3B,OAAO,CAAC,OAAO;IAKf,OAAO,CAAC,WAAW;IAMV,MAAM;CAuChB;AAED,OAAO,CAAC,MAAM,CAAC;IACb,UAAU,qBAAqB;QAC7B,WAAW,EAAE,MAAM,CAAA;KACpB;CACF"}

package/vue.d.ts

@@ -0,0 +1,36 @@
+// GENERATED by @c2n/framework-types. Do not edit by hand.
+//
+// Vue template types for the custom elements of @c2n/switch. Import once, anywhere in the program:
+//
+//     import '@c2n/switch/vue'
+//
+// Tell the compiler about the tags as well, or every c2-* tag is resolved as a Vue component and renders
+// nothing: template.compilerOptions.isCustomElement = (tag) => tag.startsWith('c2-') in vite.config.ts.
+
+import type { DefineComponent, HTMLAttributes } from 'vue'
+import type { Switch, SwitchEventMap } from '@c2n/switch'
+
+/** The element's own public properties, plus every attribute Vue understands on a host element. */
+type C2Props<T> = Partial<Omit<T, keyof HTMLElement>> & HTMLAttributes
+
+declare module 'vue' {
+  interface GlobalComponents {
+    'c2-switch': DefineComponent<
+      C2Props<Switch> & {
+        'aria-label'?: unknown
+        'aria-labelledby'?: unknown
+        'aria-describedby'?: unknown
+        onChange?: (event: SwitchEventMap['change']) => void
+      }
+    >
+  }
+}
+
+declare module '@vue/runtime-dom' {
+  interface HTMLAttributes {
+    /** Vue's own definition omits it, and slotting a plain element into a component needs it. */
+    slot?: string
+  }
+}
+
+export {}

package/vue.js

@@ -0,0 +1,3 @@
+// GENERATED by @c2n/framework-types. Do not edit by hand.
+// Types only — see the matching .d.ts.
+export {}