@mhmo91/schmancy 0.9.5 → 0.9.7

package/src/textarea/textarea.ts

@@ -1,4 +1,4 @@
-import { LitElement, html } from 'lit'
+import { LitElement, html, nothing, type PropertyValues } from 'lit'
 import { customElement, property, query } from 'lit/decorators.js'
 import { ifDefined } from 'lit/directives/if-defined.js'
 import { createRef, ref } from 'lit/directives/ref.js'
@@ -30,6 +30,8 @@ export default class SchmancyTextarea extends TailwindElement(style) {
 	internals: ElementInternals | undefined
 	textareaRef = createRef<HTMLTextAreaElement>()
 
+	private readonly _a11yId = `schmancy-textarea-${Math.random().toString(36).slice(2, 10)}`
+
 	/**
 	 * The label of the control.
 	 * @attr
@@ -179,6 +181,29 @@ export default class SchmancyTextarea extends TailwindElement(style) {
 		}
 	}
 
+	protected willUpdate(changed: PropertyValues): void {
+		super.willUpdate?.(changed)
+		if (changed.has('value') || changed.has('name')) {
+			this.internals?.setFormValue(this.value ?? '')
+		}
+		if (changed.has('required') || changed.has('value')) {
+			if (this.required && !this.value) {
+				this.internals?.setValidity({ valueMissing: true }, 'Please fill out this field.')
+			} else {
+				this.internals?.setValidity({})
+			}
+		}
+	}
+
+	formResetCallback(): void {
+		this.value = this.getAttribute('value') ?? ''
+		this.error = false
+	}
+
+	formDisabledCallback(disabled: boolean): void {
+		this.disabled = disabled
+	}
+
 	firstUpdated() {
 		if (this.autofocus) {
 			this.focus()
@@ -375,6 +400,7 @@ export default class SchmancyTextarea extends TailwindElement(style) {
 			'w-full min-w-0': true,
 			'flex flex-col h-full': this.fillHeight,
 		}
+		const hintId = `${this._a11yId}-hint`
 		return html`
 		<div class="${this.classMap(containerClasses)}">
 			${when(
@@ -404,12 +430,16 @@ export default class SchmancyTextarea extends TailwindElement(style) {
 				rows=${ifDefined(this.rows)}
 				wrap=${ifDefined(this.wrap)}
 				dirname=${ifDefined(this.dirname)}
+				aria-invalid=${this.error ? 'true' : 'false'}
+				aria-required=${this.required ? 'true' : 'false'}
+				aria-describedby=${this.hint ? hintId : nothing}
+				aria-label=${!this.label && this.placeholder ? this.placeholder : nothing}
 			></textarea>
 
 			${when(
 				this.hint,
 				() => html`
-					<div class="mt-1 text-sm ${this.error ? 'text-error-default' : 'text-surface-onVariant'}">
+					<div id=${hintId} class="mt-1 text-sm ${this.error ? 'text-error-default' : 'text-surface-onVariant'}">
 						${this.hint}
 					</div>
 				`,

package/src/tooltip/index.ts

@@ -1,2 +1 @@
-export * from './tooltip.directive';
-export * from './tooltip';
+export * from './tooltip.directive'

package/src/tree/tree.ts

@@ -34,6 +34,22 @@ export class SchmancyTree extends TailwindElement(css`
 	// Since it's actually a <schmancy-button>, use HTMLElement or a custom type
 	@query('#chevron') chevron!: HTMLElement
 
+	private readonly _a11yId = `schmancy-tree-${Math.random().toString(36).slice(2, 10)}`
+	private get _contentId() { return `${this._a11yId}-content` }
+
+	/** ElementInternals — broadcasts `:state(open)` for consumer CSS. */
+	private readonly _internals: ElementInternals | undefined = (() => {
+		try { return this.attachInternals() } catch { return undefined }
+	})()
+
+	updated(changed: Map<string, unknown>) {
+		super.updated?.(changed)
+		if (changed.has('open')) {
+			if (this.open) this._internals?.states.add('open')
+			else this._internals?.states.delete('open')
+		}
+	}
+
 	firstUpdated() {
 		// Hide or show the slot initially based on `open`
 		if (!this.open) {
@@ -116,11 +132,20 @@ export class SchmancyTree extends TailwindElement(css`
 
 				<!-- The chevron or arrow symbol -->
 				<!-- Stop propagation on the schmancy-button itself just to avoid double triggers -->
-				<schmancy-button slot="trailing" id="chevron" @click=${(e: Event) => e.stopPropagation()}> ⌅ </schmancy-button>
+				<schmancy-button
+					slot="trailing"
+					id="chevron"
+					aria-expanded=${this.open ? 'true' : 'false'}
+					aria-controls=${this._contentId}
+					aria-label=${this.open ? 'Collapse' : 'Expand'}
+					@click=${(e: Event) => e.stopPropagation()}
+				>
+					⌅
+				</schmancy-button>
 			</div>
 
 			<!-- The default slot: tree children -->
-			<slot></slot>
+			<slot id=${this._contentId}></slot>
 		`
 	}
 }

package/src/visually-hidden/index.ts

@@ -0,0 +1 @@
+export * from './visually-hidden'

package/src/visually-hidden/visually-hidden.ts

@@ -0,0 +1,39 @@
+import { TailwindElement } from '@mixins/index'
+import { css, html } from 'lit'
+import { customElement } from 'lit/decorators.js'
+
+/**
+ * Hides content visually while keeping it in the accessibility tree. Use for
+ * screen-reader-only labels, supplemental descriptions, and live-region text
+ * that sighted users don't need to see.
+ *
+ * Uses the WCAG-recommended clip pattern rather than `display: none` or
+ * `visibility: hidden` so assistive tech still reads the content.
+ *
+ * @element schmancy-visually-hidden
+ * @slot - Content hidden from sighted users but exposed to assistive tech.
+ */
+@customElement('schmancy-visually-hidden')
+export class SchmancyVisuallyHidden extends TailwindElement(css`
+	:host {
+		position: absolute;
+		width: 1px;
+		height: 1px;
+		padding: 0;
+		margin: -1px;
+		overflow: hidden;
+		clip: rect(0, 0, 0, 0);
+		white-space: nowrap;
+		border-width: 0;
+	}
+`) {
+	render() {
+		return html`<slot></slot>`
+	}
+}
+
+declare global {
+	interface HTMLElementTagNameMap {
+		'schmancy-visually-hidden': SchmancyVisuallyHidden
+	}
+}

package/src/window/window-position.ts

@@ -11,10 +11,9 @@
  *   // → { left: 144, top: 444, width: 360, height: 500 } (cascaded away from conflict)
  */
 
-import type { WindowBounds, WindowRecord, SnapCorner } from './window-registry.js'
+import type { WindowBounds, WindowRecord } from './window-registry.js'
 
 const HEAD_HEIGHT = 44
-const EDGE_GAP = 16
 const CASCADE_OFFSET = HEAD_HEIGHT
 const MAX_CASCADE_ATTEMPTS = 10
 
@@ -48,41 +47,6 @@ export function resolveOverlap(
 	return clampToViewport(bounds, viewport)
 }
 
-/**
- * Snap window bounds to a corner with standard edge gap.
- */
-export function snapToCorner(
-	bounds: WindowBounds,
-	corner: SnapCorner,
-	viewport: { width: number; height: number },
-	bottomOffset: number,
-): WindowBounds {
-	const isRight = corner.includes('right')
-	const isBottom = corner.includes('bottom')
-
-	return {
-		width: bounds.width,
-		height: bounds.height,
-		left: isRight ? viewport.width - bounds.width - EDGE_GAP : EDGE_GAP,
-		top: isBottom ? viewport.height - bounds.height - EDGE_GAP - bottomOffset : EDGE_GAP,
-	}
-}
-
-/**
- * Place a window flush beside a neighbor.
- */
-export function snapToNeighbor(
-	bounds: WindowBounds,
-	neighbor: WindowBounds,
-	side: 'left' | 'right',
-): WindowBounds {
-	return {
-		...bounds,
-		left: side === 'right' ? neighbor.left + neighbor.width + EDGE_GAP : neighbor.left - bounds.width - EDGE_GAP,
-		top: neighbor.top,
-	}
-}
-
 /**
  * Clamp bounds so the window stays fully within the viewport.
  */
@@ -97,40 +61,3 @@ export function clampToViewport(
 		top: Math.max(0, Math.min(bounds.top, viewport.height - bounds.height)),
 	}
 }
-
-/**
- * Convert corner-relative offset (used by the old float) to absolute viewport bounds.
- */
-export function cornerOffsetToAbsolute(
-	corner: SnapCorner,
-	offset: { x: number; y: number },
-	size: { width: number; height: number },
-	viewport: { width: number; height: number },
-	bottomOffset: number,
-): WindowBounds {
-	const isRight = corner.includes('right')
-	const isBottom = corner.includes('bottom')
-	return {
-		width: size.width,
-		height: size.height,
-		left: isRight ? viewport.width - offset.x - size.width : offset.x,
-		top: isBottom ? viewport.height - offset.y - size.height - bottomOffset : offset.y,
-	}
-}
-
-/**
- * Convert absolute viewport bounds back to corner-relative offset.
- */
-export function absoluteToCornerOffset(
-	corner: SnapCorner,
-	bounds: WindowBounds,
-	viewport: { width: number; height: number },
-	bottomOffset: number,
-): { x: number; y: number } {
-	const isRight = corner.includes('right')
-	const isBottom = corner.includes('bottom')
-	return {
-		x: isRight ? viewport.width - bounds.left - bounds.width : bounds.left,
-		y: isBottom ? viewport.height - bounds.top - bounds.height - bottomOffset : bounds.top,
-	}
-}

package/types/mixins/formField.mixin.d.ts

@@ -2,6 +2,12 @@ import { CSSResult, LitElement } from 'lit';
 import { IBaseMixin } from './baseElement';
 import { Constructor } from './constructor';
 import { ITailwindElementMixin } from './tailwind.mixin';
+/**
+ * Cross-realm brand used by `<schmancy-form>` to discover form fields by
+ * inheritance rather than tag-name allowlists. `Symbol.for` puts the symbol in
+ * the global registry so detection works across module realms/bundles.
+ */
+export declare const SCHMANCY_FORM_FIELD: unique symbol;
 /**
  * Interface defining the properties and methods that the FormFieldMixin adds.
  */
@@ -20,11 +26,19 @@ export interface IFormFieldMixin extends Element {
     checkValidity(): boolean;
     reportValidity(): boolean;
     setCustomValidity(message: string): void;
+    toFormEntries(): Array<[string, FormDataEntryValue]>;
+    resetForm(): void;
     emitChange(detail: any): void;
 }
+/** Predicate used by `<schmancy-form>` to detect mixin descendants. */
+export declare function isSchmancyFormField(el: unknown): el is IFormFieldMixin;
 /**
  * A mixin that adds form field capabilities to a LitElement class.
- * This provides common form field properties, validation, and form association.
+ * Components that extend this mixin are automatically discovered and
+ * collected by `<schmancy-form>` — no tag-name registration needed.
+ *
+ * Subclasses may override `toFormEntries()` to contribute multiple
+ * name/value pairs to FormData (e.g. date-range, tag-input).
  *
  * @example
  * ```ts
@@ -37,12 +51,5 @@ export declare function FormFieldMixin<T extends Constructor<LitElement>>(superC
 /**
  * A convenience function that composes FormFieldMixin with TailwindElement
  * to create a base class for Schmancy form components.
- *
- * @example
- * ```ts
- * class MyInput extends SchmancyFormField(css`...`) {
- *   // Your component code here
- * }
- * ```
  */
 export declare function SchmancyFormField<T extends CSSResult>(componentStyle?: T): Constructor<IFormFieldMixin> & Constructor<ITailwindElementMixin> & Constructor<LitElement> & Constructor<IBaseMixin>;

package/types/src/audio/emotional-sounds.d.ts

@@ -41,8 +41,6 @@ export type ConnectedFeeling = 'connected' | 'accepted' | 'included' | 'belongin
 export type MixedFeeling = 'conflicted' | 'confused' | 'ambivalent' | 'nostalgic' | 'guilty' | 'embarrassed' | 'surprised' | 'shocked' | 'awestruck' | 'skeptical';
 /** All feelings */
 export type Feeling = HappyFeeling | SadFeeling | AnxiousFeeling | AngryFeeling | TiredFeeling | CalmFeeling | ConnectedFeeling | MixedFeeling;
-/** Feeling category */
-export type FeelingCategory = 'happy' | 'sad' | 'anxious' | 'angry' | 'tired' | 'calm' | 'connected' | 'mixed';
 /**
  * Emotional Sound Generator
  * Creates soft, beautiful sounds using Web Audio API

package/types/src/autocomplete/autocomplete.d.ts

@@ -17,6 +17,12 @@ declare const SchmancyAutocomplete_base: CustomElementConstructor & import("@mix
  * @prop {string[]} values - Selected values (multi-select mode)
  */
 export default class SchmancyAutocomplete extends SchmancyAutocomplete_base {
+    static formAssociated: boolean;
+    internals: ElementInternals | undefined;
+    constructor();
+    get form(): HTMLFormElement | null;
+    formResetCallback(): void;
+    formDisabledCallback(disabled: boolean): void;
     _valueSet: boolean;
     _valuesSet: boolean;
     required: boolean;
@@ -32,6 +38,7 @@ export default class SchmancyAutocomplete extends SchmancyAutocomplete_base {
     similarityThreshold: number;
     error: boolean;
     validationMessage: string;
+    private readonly _a11yId;
     get values(): string[];
     set values(vals: string[]);
     get value(): string;

package/types/src/breadcrumb/breadcrumb.d.ts

@@ -0,0 +1,38 @@
+declare const SchmancyBreadcrumb_base: import("@mixins/index").Constructor<CustomElementConstructor> & import("@mixins/index").Constructor<import("@mixins/index").ITailwindElementMixin> & import("@mixins/index").Constructor<import("lit").LitElement> & import("@mixins/index").Constructor<import("@mixins/index").IBaseMixin>;
+/**
+ * Breadcrumb navigation container. Wraps a list of `schmancy-breadcrumb-item`
+ * elements with the correct ARIA landmark and semantics.
+ *
+ * @element schmancy-breadcrumb
+ * @slot - Default slot for `<schmancy-breadcrumb-item>` children.
+ * @attr separator - Character or string rendered between items. Default `/`.
+ * @csspart separator - The separator element.
+ */
+export declare class SchmancyBreadcrumb extends SchmancyBreadcrumb_base {
+    separator: string;
+    connectedCallback(): void;
+    render(): import("lit-html").TemplateResult<1>;
+    private _insertSeparators;
+}
+declare const SchmancyBreadcrumbItem_base: import("@mixins/index").Constructor<CustomElementConstructor> & import("@mixins/index").Constructor<import("@mixins/index").ITailwindElementMixin> & import("@mixins/index").Constructor<import("lit").LitElement> & import("@mixins/index").Constructor<import("@mixins/index").IBaseMixin>;
+/**
+ * Individual breadcrumb item. Renders as a link when `href` is provided,
+ * otherwise as a plain span (represents the current page).
+ *
+ * @element schmancy-breadcrumb-item
+ * @slot - Label content.
+ * @attr href - If set, renders as an anchor.
+ * @attr current - Marks as `aria-current="page"`.
+ */
+export declare class SchmancyBreadcrumbItem extends SchmancyBreadcrumbItem_base {
+    href: string;
+    current: boolean;
+    render(): import("lit-html").TemplateResult<1>;
+}
+declare global {
+    interface HTMLElementTagNameMap {
+        'schmancy-breadcrumb': SchmancyBreadcrumb;
+        'schmancy-breadcrumb-item': SchmancyBreadcrumbItem;
+    }
+}
+export {};

package/types/src/breadcrumb/index.d.ts

@@ -0,0 +1 @@
+export * from './breadcrumb';

package/types/src/button/button.d.ts

@@ -12,6 +12,7 @@ declare const SchmancyButton_base: CustomElementConstructor & import("@mixins/in
  * @slot - The default slot.
  * @slot prefix - The prefix slot.
  * @slot suffix - The suffix slot.
+ * @csspart base - The underlying native `<button>` (or `<a>` when `href` is set).
  */
 export declare class SchmancyButton extends SchmancyButton_base {
     protected static shadowRootOptions: {
@@ -22,6 +23,12 @@ export declare class SchmancyButton extends SchmancyButton_base {
         serializable?: boolean;
         slotAssignment?: SlotAssignmentMode;
     };
+    static formAssociated: boolean;
+    private internals;
+    constructor();
+    /** Associated form, when placed inside a <form>. */
+    get form(): HTMLFormElement | null;
+    formDisabledCallback(disabled: boolean): void;
     private nativeElement;
     private _ariaLabel;
     /**

package/types/src/button/icon-button.d.ts

@@ -4,7 +4,8 @@ declare const SchmnacyIconButton_base: CustomElementConstructor & import("@mixin
 /**
  * An icon button component.
  * @element schmancy-icon-button
- * @slot - The default slot.
+ * @slot - The default slot (usually an icon or glyph).
+ * @csspart base - The underlying native `<button>` (or `<a>` when `href` is set).
  */
 export declare class SchmnacyIconButton extends SchmnacyIconButton_base {
     protected static shadowRootOptions: {

package/types/src/checkbox/checkbox.d.ts

@@ -20,6 +20,7 @@ declare class SchmancyCheckboxElement extends SchmancyCheckboxElement_base {
     };
     static formAssociated: boolean;
     internals: ElementInternals | undefined;
+    constructor();
     get form(): HTMLFormElement;
     /**
      * @attr {boolean} value - The value of the checkbox.
@@ -51,6 +52,11 @@ declare class SchmancyCheckboxElement extends SchmancyCheckboxElement_base {
      */
     label?: string;
     connectedCallback(): void;
+    updated(changed: Map<string, unknown>): void;
+    private _syncFormValue;
+    private _syncValidity;
+    checkValidity(): boolean;
+    reportValidity(): boolean;
     /**
      * @attr {xxs | xs | sm | md | lg } size - The size of the checkbox.
      * M3 aligned: 24dp (xxs) → 32dp (xs) → 40dp (sm) → 48dp (md) → 56dp (lg)

package/types/src/checkbox/checkbox.test.d.ts

@@ -0,0 +1 @@
+import './checkbox';

package/types/src/chips/filter-chip.d.ts

@@ -42,6 +42,9 @@ export declare class SchmancyFilterChip extends SchmancyFilterChip_base {
     internals: ElementInternals | undefined;
     get form(): HTMLFormElement;
     connectedCallback(): void;
+    protected updated(changed: Map<string, unknown>): void;
+    formResetCallback(): void;
+    formDisabledCallback(disabled: boolean): void;
     private handleClick;
     private handleRemove;
     private handleKeyDown;

package/types/src/chips/input-chip.d.ts

@@ -60,6 +60,7 @@ export declare class SchmancyInputChip extends SchmancyInputChip_base {
     static formAssociated: boolean;
     internals: ElementInternals | undefined;
     get form(): HTMLFormElement;
+    protected updated(changed: Map<string, unknown>): void;
     connectedCallback(): void;
     private handleChipClick;
     private handleRemove;

package/types/src/date-range/date-range-helpers.d.ts

@@ -1,5 +1,4 @@
 import dayjs from 'dayjs';
-import { PresetUnit } from './date-range-presets';
 /**
  * Format a date range into a human-readable string
  */
@@ -14,14 +13,3 @@ export interface DateRangeType {
     isFullWeek: boolean;
 }
 export declare function detectDateRangeType(fromDate: dayjs.Dayjs, toDate: dayjs.Dayjs): DateRangeType;
-/**
- * Calculate the appropriate shift unit and amount for a date range
- */
-export declare function calculateShiftParams(fromDate: dayjs.Dayjs, toDate: dayjs.Dayjs, activePresetStep?: PresetUnit): {
-    unit: PresetUnit;
-    amount: number;
-};
-/**
- * Helper method to safely add/subtract quarter values
- */
-export declare function adjustQuarter(date: dayjs.Dayjs, amount: number, direction: 1 | -1): dayjs.Dayjs;

package/types/src/dialog/dialog.component.d.ts

@@ -76,6 +76,12 @@ export declare class SchmancyDialog extends SchmancyDialog_base {
      * Ref to the drag handle element for swipe gestures
      */
     private _dragHandleRef;
+    /**
+     * Stable per-instance id used for ARIA labelledby/describedby wiring
+     */
+    private readonly _a11yId;
+    private get _titleId();
+    private get _descId();
     /**
      * Return the dialog element for positioning/size measurement.
      * In content mode, returns the first slotted child (the actual component).

package/types/src/dropdown/dropdown-content.d.ts

@@ -3,7 +3,9 @@ declare const SchmancyDropdownContent_base: import("@mixins/index").Constructor<
  * Content container for the schmancy-dropdown component.
  *
  * @element schmancy-dropdown-content
- * @slot - Default slot for dropdown content
+ * @slot - Default slot for dropdown content.
+ * @csspart content - The inner wrapper element; style to override panel
+ *   backgrounds, shadows, padding, or borders without shadow-root piercing.
  */
 export declare class SchmancyDropdownContent extends SchmancyDropdownContent_base {
     /**

package/types/src/form/form-v2.d.ts

@@ -1,73 +1,22 @@
-import { LitElement } from 'lit';
-export interface FormElement extends HTMLElement {
-    name?: string;
-    value?: string;
-    disabled?: boolean;
-    type?: string;
-    defaultValue?: string;
-}
-export interface CheckableFormElement extends FormElement {
-    checked?: boolean;
-}
-export interface ValidatableFormElement extends FormElement {
-    reportValidity?: () => boolean;
-}
-export interface FormControlConfig {
-    tagName: string;
-    hasValue?: boolean;
-    hasChecked?: boolean;
-    canSubmit?: boolean;
-}
-declare const SchmancyFormV2_base: import("@mixins/index").Constructor<CustomElementConstructor> & import("@mixins/index").Constructor<import("@mixins/index").ITailwindElementMixin> & import("@mixins/index").Constructor<LitElement> & import("@mixins/index").Constructor<import("@mixins/index").IBaseMixin>;
+import SchmancyForm from './form';
+export type { FormElement, CheckableFormElement, ValidatableFormElement, FormControlConfig, FormEventMap, } from './form';
 /**
- * The form is a component used to collect user input from
- * interactive controls.
- *
- * @element sch-form
- *
- * @slot - Default slot for the form.
- *
- * @fires submit - Emitted when the form is submitted.
- * @fires reset - Emitted when the form is reset.
+ * @deprecated Use `<schmancy-form>` (`SchmancyForm`) from `./form`. The
+ * canonical form implementation now discovers fields via the `FormFieldMixin`
+ * brand + a small compat registry, which makes the `sch-form` tag redundant.
+ * This class remains as an alias so any existing `<sch-form>` markup or
+ * `SchmancyFormV2` imports continue to work, and will be removed in a future
+ * major.
  */
-export default class SchmancyFormV2 extends SchmancyFormV2_base {
-    private $disconnecting;
+export default class SchmancyFormV2 extends SchmancyForm {
     static readonly tagName = "sch-form";
-    private static formControlRegistry;
-    static registerFormControl(config: FormControlConfig): void;
-    private static hasValue;
-    private static hasChecked;
-    private static canSubmit;
-    protected static shadowRootOptions: {
-        mode: string;
-        delegatesFocus: boolean;
-        clonable?: boolean;
-        customElementRegistry?: CustomElementRegistry;
-        serializable?: boolean;
-        slotAssignment?: SlotAssignmentMode;
-    };
-    /** Specifies if form data validation should be skipped on submit.
-     * @attr novalidate
-     * @type {boolean}
-     * @public
+    /**
+     * @deprecated Use `SchmancyForm.registerControl()` instead.
      */
-    novalidate: boolean;
-    constructor();
-    disconnectedCallback(): void;
-    /** Submits the form. */
-    submit(): boolean;
-    /** Resets the form. */
-    reset(): void;
-    private getFormElements;
-    getFormData(): FormData;
-    /** Checks for validity of the form. */
-    reportValidity(): boolean;
-    private handleSubmitRequest;
-    protected render(): import("lit-html").TemplateResult<1>;
+    static registerFormControl: typeof SchmancyForm.registerControl;
 }
 declare global {
     interface HTMLElementTagNameMap {
         'sch-form': SchmancyFormV2;
     }
 }
-export {};