@mhmo91/schmancy 0.10.35 → 0.10.37

package/src/form/fields/chips/chips.ts

@@ -0,0 +1,234 @@
+import { SchmancyFormField } from '@mixins/formField.mixin'
+import { css, html, nothing, PropertyValues } from 'lit'
+import { customElement, property, queryAssignedElements } from 'lit/decorators.js'
+import { ifDefined } from 'lit/directives/if-defined.js'
+import { when } from 'lit/directives/when.js'
+import { BehaviorSubject, combineLatest } from 'rxjs'
+import { debounceTime, distinctUntilChanged, takeUntil } from 'rxjs/operators'
+import { fullWidth } from '../../../directives/layout'
+import type { FilterChipChangeEvent as SchmancyChipChangeEvent } from './filter-chip'
+import { SchmancyFilterChip as SchmancyChip } from './filter-chip'
+
+export type SchmancyChipsChangeEvent = CustomEvent<{ value: string | string[] }>
+
+@customElement('schmancy-chips')
+export default class SchmancyChips extends SchmancyFormField(css`
+:host {
+	display: block;
+	height: fit-content;
+	width: fit-content;
+}
+`) {
+	// FACE wiring (formAssociated, internals, attachInternals) comes from
+	// SchmancyFormField. Same for: name, required, disabled, validationMessage,
+	// validateOn, touched/dirty/pristine/submitted, markTouched/markSubmitted,
+	// formResetCallback, formDisabledCallback, FIELD_CONNECT_EVENT dispatch,
+	// emitChange(), checkValidity(), reportValidity(), setCustomValidity().
+
+	/** Whether multiple chips can be selected simultaneously. */
+	@property({ type: Boolean, reflect: true })
+	multi: boolean = false
+
+	// Override `value` with the chips-specific type and a custom getter/setter
+	// pair backed by reactive subjects.
+	@property({ reflect: false })
+	override get value(): string | string[] {
+		return this.multi
+			? (this.values$?.value ?? [])
+			: (this.value$?.value ?? '')
+	}
+	override set value(v: string | string[]) {
+		const old = this.value
+		if (this.multi) {
+			const arr = Array.isArray(v)
+				? v
+				: v ? String(v).split(',').map(s => s.trim()).filter(Boolean) : []
+			this.values$?.next(arr)
+		} else {
+			this.value$?.next(Array.isArray(v) ? (v[0] ?? '') : String(v ?? ''))
+		}
+		this.requestUpdate('value', old)
+	}
+
+	/** Typed convenience alias for multi-mode consumers. */
+	get values(): string[] {
+		return [...(this.values$?.value ?? [])]
+	}
+	set values(v: string[]) {
+		this.values$?.next(Array.isArray(v) ? [...v] : [])
+	}
+
+	@property({ type: Boolean, reflect: true })
+	wrap: boolean = false
+
+	@property({ type: String, reflect: true })
+	justify: 'start' | 'center' | 'end' = 'start'
+
+	@queryAssignedElements({
+		selector:
+			'schmancy-chip, schmancy-filter-chip, schmancy-assist-chip, schmancy-input-chip, schmancy-suggestion-chip',
+		flatten: true,
+	})
+	chips!: (SchmancyChip | HTMLElement)[]
+
+	// Two internal streams — one for single mode, one for multi mode.
+	private value$ = new BehaviorSubject<string>('')
+	private values$ = new BehaviorSubject<string[]>([])
+
+	protected override willUpdate(changedProps: PropertyValues): void {
+		super.willUpdate(changedProps)
+		// super handles the string path; fix the array path for multi mode.
+		if (changedProps.has('value') && Array.isArray(this.value) && this.name) {
+			const fd = new FormData()
+			this.value.forEach(v => fd.append(this.name, v))
+			this.internals?.setFormValue(fd)
+		}
+	}
+
+	override checkValidity(): boolean {
+		if (this.required && Array.isArray(this.value) && this.value.length === 0) {
+			const msg = this.errorMessages?.valueMissing ?? 'This field is required'
+			this.internals?.setValidity({ valueMissing: true }, msg)
+			if (this.submitted || this.dirty || this.touched || this.validateOn === 'always') {
+				this.error = true
+				this.validationMessage = msg
+			}
+			return false
+		}
+		return super.checkValidity()
+	}
+
+	override connectedCallback() {
+		super.connectedCallback()
+
+		// Sync BehaviorSubjects with whatever value was set before connection.
+		if (this.multi) {
+			const cur = this.value
+			this.values$.next(Array.isArray(cur) ? cur : [])
+		} else {
+			const cur = this.value
+			this.value$.next(Array.isArray(cur) ? (cur[0] ?? '') : String(cur ?? ''))
+		}
+
+		combineLatest([
+			this.value$.pipe(distinctUntilChanged()),
+			this.values$.pipe(
+				distinctUntilChanged((prev, curr) => prev.length === curr.length && prev.every((v, i) => v === curr[i])),
+			),
+		])
+			.pipe(
+				debounceTime(0),
+				takeUntil(this.disconnecting),
+			)
+			.subscribe(([value, values]) => {
+				this.updateChipStates(value, values)
+			})
+	}
+
+	private updateChipStates(value: string, values: string[]) {
+		if (!this.chips) return
+
+		this.chips.forEach(chip => {
+			if ('value' in chip && 'selected' in chip) {
+				const filterChip = chip as SchmancyChip
+				if (this.multi) {
+					filterChip.selected = values.length > 0 && values.includes(filterChip.value)
+				} else {
+					filterChip.selected = value !== '' && value === filterChip.value
+				}
+			}
+		})
+	}
+
+	async change(e: CustomEvent<SchmancyChipChangeEvent>) {
+		e.preventDefault()
+		e.stopPropagation()
+
+		const { value: chipValue, selected } = e.detail
+
+		if (this.multi) {
+			const old = this.value
+			if (selected) {
+				if (!this.values$.value.includes(chipValue)) {
+					this.values$.next([...this.values$.value, chipValue])
+				}
+			} else {
+				this.values$.next(this.values$.value.filter(v => v !== chipValue))
+			}
+			this.requestUpdate('value', old)
+		} else {
+			const old = this.value
+			if (selected) {
+				this.value$.next(chipValue)
+			} else if (!this.required) {
+				this.value$.next('')
+			} else {
+				// Required single-mode: ignore deselection attempt.
+				return
+			}
+			this.requestUpdate('value', old)
+		}
+
+		this.emitChange({ value: this.multi ? this.values$.value : this.value$.value })
+	}
+
+	override resetForm(): void {
+		super.resetForm()
+		this.value$.next('')
+		this.values$.next([])
+	}
+
+	protected firstUpdated(_changedProperties: PropertyValues): void {
+		super.firstUpdated(_changedProperties)
+		this.updateChipStates(this.value$.value, this.values$.value)
+	}
+
+	protected render(): unknown {
+		const classes = {
+			'flex flex-nowrap justify-center gap-2': true,
+			'flex-wrap': this.wrap,
+			'justify-center': this.justify === 'center',
+		}
+		const wrapperClasses = {
+			'rounded-lg transition-all duration-200': true,
+			'outline outline-2 outline-offset-4 outline-error-default': this.error,
+		}
+		return html`
+			<div class="${this.classMap(wrapperClasses)}">
+				<schmancy-scroll
+					hide
+					.direction=${this.wrap ? 'vertical' : 'horizontal'}
+					class="${this.classMap(classes)}"
+					${fullWidth()}
+					@change=${this.change}
+				>
+					<slot
+						@slotchange=${() => {
+							this.updateChipStates(this.value$.value, this.values$.value)
+						}}
+					></slot>
+				</schmancy-scroll>
+			</div>
+
+			${when(
+				this.hint || (this.error && this.validationMessage),
+				() => html`
+					<div
+						id="hint-${this.id}"
+						class="mt-1 text-sm ${this.error ? 'text-error-default' : 'text-surface-onVariant'}"
+						role=${ifDefined(this.error ? 'alert' : undefined)}
+						aria-live="polite"
+					>
+						${this.error && this.validationMessage ? this.validationMessage : this.hint}
+					</div>
+				`,
+				() => nothing,
+			)}`
+	}
+}
+
+declare global {
+	interface HTMLElementTagNameMap {
+		'schmancy-chips': SchmancyChips
+	}
+}

package/src/form/fields/chips/filter-chip.ts

@@ -0,0 +1,255 @@
+import { SchmancyElement } from '@mixins/index'
+import { css, html, LitElement } from 'lit'
+import { property } from 'lit/decorators.js'
+import { magnetic } from '../../../directives/magnetic'
+
+/**
+ * Filter chip component for content filtering.
+ *
+ * Filter chips are the ONLY chip type that maintains persistent selected state.
+ * They are used for filtering content by toggling on/off different filter criteria.
+ *
+ * @fires change - Dispatched when selection state changes with {value, selected}
+ * @fires remove - Dispatched when remove button is clicked (if removable)
+ *
+ * @example
+ * ```html
+ * <schmancy-filter-chip value="category-1" selected>
+ *   Category 1
+ * </schmancy-filter-chip>
+ * ```
+ */
+export class SchmancyFilterChip extends SchmancyElement {
+	static styles = [css`
+	:host {
+		display: inline-flex;
+		outline: none;
+		border-radius: 0.5rem;
+		transition: transform 200ms cubic-bezier(0.34, 1.56, 0.64, 1);
+	}
+
+	:host(:active:not([disabled])) {
+		transform: scale(0.95);
+		transition-duration: 100ms;
+	}
+
+	:host([disabled]) {
+		pointer-events: none;
+		opacity: var(--schmancy-sys-state-disabled-opacity);
+	}
+
+	@media (prefers-reduced-motion: reduce) {
+		:host { transition: none; }
+		:host(:active:not([disabled])) { transform: none; }
+	}
+
+	button {
+		font-family: inherit;
+	}
+`];
+	/** Unique identifier for this filter chip */
+	@property({ type: String, reflect: true })
+	value: string = ''
+
+	/** Whether the filter chip is selected (active filter) */
+	private _selected: boolean = false
+
+	@property({ type: Boolean, reflect: true })
+	get selected(): boolean {
+		return this._selected
+	}
+	set selected(value: boolean) {
+		const oldValue = this._selected
+		this._selected = value
+		this.requestUpdate('selected', oldValue)
+	}
+
+	/** Whether to show a remove button */
+	@property({ type: Boolean, reflect: true })
+	removable: boolean = false
+
+	/** Whether the chip is disabled */
+	@property({ type: Boolean, reflect: true })
+	disabled: boolean = false
+
+	/** Whether to use elevated style with shadow */
+	@property({ type: Boolean, reflect: true })
+	elevated: boolean = false
+
+
+	constructor() {
+		super()
+		try {
+			this.internals = this.attachInternals()
+		} catch {
+			this.internals = undefined
+		}
+	}
+
+	protected static shadowRootOptions = {
+		...LitElement.shadowRootOptions,
+		delegatesFocus: true,
+	}
+
+	static formAssociated = true
+	internals: ElementInternals | undefined
+	get form() {
+		return this.internals?.form
+	}
+
+	connectedCallback() {
+		super.connectedCallback()
+	}
+
+	protected updated(changed: Map<string, unknown>) {
+		super.updated?.(changed)
+		if (changed.has('value') || changed.has('selected')) {
+			this.internals?.setFormValue(this._selected ? (this.value || 'on') : null)
+		}
+	}
+
+	formResetCallback(): void {
+		this._selected = this.hasAttribute('selected')
+	}
+
+	formDisabledCallback(disabled: boolean): void {
+		this.disabled = disabled
+	}
+
+	private handleClick = () => {
+		if (this.disabled) return
+
+		this.dispatchEvent(
+			new CustomEvent('change', {
+				detail: { value: this.value, selected: !this._selected },
+				bubbles: true,
+				composed: true,
+			}),
+		)
+	}
+
+	private handleRemove = (e: Event) => {
+		if (this.disabled) return
+
+		e.stopPropagation()
+
+		this.dispatchEvent(
+			new CustomEvent('remove', {
+				detail: { value: this.value },
+				bubbles: true,
+				composed: true,
+			}),
+		)
+	}
+
+	private handleKeyDown = (e: KeyboardEvent) => {
+		if (this.disabled) return
+
+		if (e.key === 'Enter' || e.key === ' ') {
+			e.preventDefault()
+			this.dispatchEvent(
+				new CustomEvent('change', {
+					detail: { value: this.value, selected: !this._selected },
+					bubbles: true,
+					composed: true,
+				}),
+			)
+		}
+	}
+
+
+	protected render(): unknown {
+		const chipClasses = {
+			'inline-flex': true,
+			'items-center': true,
+			'gap-2': true,
+			'rounded-lg': true,
+			'h-8 px-4': true,
+			'cursor-pointer': !this.disabled,
+			'transition-all': true,
+			'duration-200': true,
+			'select-none': true,
+			'text-sm': true,
+			'font-medium': true,
+			'relative': true,
+			'min-h-[32px]': true,
+
+			// Background and text colors based on selection state
+			'bg-secondary-container': this._selected,
+			'text-secondary-onContainer': this._selected,
+			'bg-surface-container': !this._selected,
+			'text-surface-on': !this._selected,
+
+			// Hover states
+			'hover:brightness-95': this._selected && !this.disabled,
+			'hover:bg-surface-containerHigh': !this._selected && !this.disabled,
+
+			// Pressed state
+			'active:brightness-90': !this.disabled,
+
+			// Focus-visible state
+			'focus-visible:outline': !this.disabled,
+			'focus-visible:outline-2': !this.disabled,
+			'focus-visible:outline-offset-2': !this.disabled,
+			'focus-visible:outline-primary-default': !this.disabled,
+
+			// Elevated style
+			'shadow-md': this.elevated && !this.disabled,
+			'hover:shadow-lg': this.elevated && !this.disabled,
+
+			// Disabled state
+			'opacity-[var(--schmancy-sys-state-disabled-opacity)]': this.disabled,
+			'cursor-not-allowed': this.disabled,
+		}
+
+		return html`
+			<button
+				${magnetic({ strength: 2, radius: 40 })}
+				class=${this.classMap(chipClasses)}
+				@click=${this.handleClick}
+				@keydown=${this.handleKeyDown}
+				?disabled=${this.disabled}
+				aria-pressed=${this._selected ? 'true' : 'false'}
+				role="checkbox"
+				tabindex="0"
+			>
+				<slot></slot>
+
+				${this.removable
+					? html`
+							<button
+								class="ml-1 -mr-1 p-0.5 rounded-full hover:bg-surface-containerHighest transition-colors duration-200"
+								@click=${this.handleRemove}
+								aria-label="Remove filter"
+								tabindex="-1"
+							>
+								<span class="material-symbols-outlined text-sm">close</span>
+							</button>
+						`
+					: ''}
+			</button>
+		`
+	}
+}
+
+if (!customElements.get('schmancy-filter-chip')) {
+	customElements.define('schmancy-filter-chip', SchmancyFilterChip)
+}
+
+if (!customElements.get('schmancy-chip')) {
+	class SchmancyChipCompat extends SchmancyFilterChip {}
+	customElements.define('schmancy-chip', SchmancyChipCompat)
+}
+
+export { SchmancyFilterChip as SchmancyChip }
+
+declare global {
+	interface HTMLElementTagNameMap {
+		'schmancy-chip': SchmancyFilterChip
+		'schmancy-filter-chip': SchmancyFilterChip
+	}
+}
+
+export type FilterChipChangeEvent = { value: string; selected: boolean }
+export type FilterChipRemoveEvent = { value: string }
+export type SchmancyChipChangeEvent = FilterChipChangeEvent

package/src/form/fields/chips/index.ts

@@ -0,0 +1,5 @@
+export * from './assist-chip';
+export * from './chips';
+export * from './filter-chip';
+export * from './input-chip';
+export * from './suggestion-chip';