@verbb/plugin-kit-web 2.0.15 → 2.0.17

package/dist/register.js

@@ -1,88 +1,88 @@
 import { n as resolveSpinnerVariant, t as getButtonSpinnerSize } from "./chunks/spinner-utils-CDfHypTv.js";
 import { t as PkSpinner } from "./chunks/pk-spinner-DweuYJ_Z.js";
-import { t as PkButton } from "./chunks/pk-button-BWGDkuzc.js";
+import { t as PkButton } from "./chunks/pk-button-BrH4u4Qr.js";
 import "./components/button.js";
 import { t as PkButtonGroup } from "./chunks/pk-button-group-BSz5T5iS.js";
 import { t as PkButtonGroupSeparator } from "./chunks/pk-button-group-separator-DH3Rl24b.js";
 import { t as PkButtonGroupText } from "./chunks/pk-button-group-text-Qro_KmZb.js";
 import "./components/button-group.js";
-import { t as PkCheckbox } from "./chunks/pk-checkbox-CvZwJZn_.js";
+import { t as PkCheckbox } from "./chunks/pk-checkbox-CfV1uDdC.js";
 import "./components/checkbox.js";
-import { n as PkCheckboxSelect, t as ALL_VALUE } from "./chunks/pk-checkbox-select-DclPoyDM.js";
+import { n as PkCheckboxSelect, t as ALL_VALUE } from "./chunks/pk-checkbox-select-DeCaI3a0.js";
 import "./components/checkbox-select.js";
-import { t as PkCodeEditor } from "./chunks/pk-code-editor-CrKnJUyi.js";
+import { t as PkCodeEditor } from "./chunks/pk-code-editor-BG9sG_Fy.js";
 import "./components/code-editor.js";
-import { t as PkCombobox } from "./chunks/pk-combobox-BLft8AXy.js";
-import { t as PkPopup } from "./chunks/pk-popup-B9AgBC2V.js";
-import { t as PkInput } from "./chunks/pk-input-DDkIXOkt.js";
+import { t as PkCombobox } from "./chunks/pk-combobox-CL9En0J-.js";
+import { t as PkPopup } from "./chunks/pk-popup-B65tZMQH.js";
+import { t as PkInput } from "./chunks/pk-input-CF_icEtR.js";
 import "./components/input.js";
-import { t as PkInputGroup } from "./chunks/pk-input-group-CRPSBFhX.js";
-import { t as PkInputGroupAddon } from "./chunks/pk-input-group-addon-B0StOmTJ.js";
-import { t as PkInputGroupButton } from "./chunks/pk-input-group-button-CnKajvsP.js";
-import { t as PkInputGroupInput } from "./chunks/pk-input-group-input-mllffsjQ.js";
-import { t as PkInputGroupText } from "./chunks/pk-input-group-text-DvaPJvh2.js";
-import { t as PkInputGroupTextarea } from "./chunks/pk-input-group-textarea-CqYv8tUQ.js";
+import { t as PkInputGroup } from "./chunks/pk-input-group-BLqKPnfc.js";
+import { t as PkInputGroupAddon } from "./chunks/pk-input-group-addon-ClBkGmAw.js";
+import { t as PkInputGroupButton } from "./chunks/pk-input-group-button-CHQHsWd4.js";
+import { t as PkInputGroupInput } from "./chunks/pk-input-group-input-oNnqMBGU.js";
+import { t as PkInputGroupText } from "./chunks/pk-input-group-text-HUxlXROB.js";
+import { t as PkInputGroupTextarea } from "./chunks/pk-input-group-textarea-Cl2FNuw-.js";
 import "./components/input-group.js";
-import { t as PkTextarea } from "./chunks/pk-textarea-BcAyZYC-.js";
+import { t as PkTextarea } from "./chunks/pk-textarea-CYM2tK88.js";
 import "./components/textarea.js";
-import { t as PkSeparator } from "./chunks/pk-separator-CHij3vEG.js";
+import { t as PkSeparator } from "./chunks/pk-separator-N-VyjYE6.js";
 import "./components/separator.js";
-import { t as PkStatus } from "./chunks/pk-status-D1IzTSI2.js";
+import { t as PkStatus } from "./chunks/pk-status-BehQARDv.js";
 import "./components/status.js";
-import { t as PkToggle } from "./chunks/pk-toggle-CW-lflrh.js";
+import { t as PkToggle } from "./chunks/pk-toggle-BthhH7vl.js";
 import "./components/toggle.js";
-import { t as PkToggleGroup } from "./chunks/pk-toggle-group-BKymefo3.js";
+import { t as PkToggleGroup } from "./chunks/pk-toggle-group-D2Quux8D.js";
 import "./components/toggle-group.js";
-import { t as PkLightswitch } from "./chunks/pk-lightswitch-DI1BeCmA.js";
+import { t as PkLightswitch } from "./chunks/pk-lightswitch-D1qEFRxK.js";
 import "./components/lightswitch.js";
-import { t as PkDialog } from "./chunks/pk-dialog-BbEfvb0g.js";
+import { t as PkDialog } from "./chunks/pk-dialog-VMQqLW1f.js";
 import { PkIcon } from "./components/icon/pk-icon.js";
 import { PkConnect } from "./components/connect/pk-connect.js";
 import { PkConnectOauth } from "./components/connect/pk-connect-oauth.js";
 import "./components/connect.js";
-import { t as PkCopyButton } from "./chunks/pk-copy-button-asOLQkqk.js";
+import { t as PkCopyButton } from "./chunks/pk-copy-button-BVaOLtYG.js";
 import "./components/copy-button.js";
 import "./components/dialog.js";
-import { t as PkDropdownItem } from "./chunks/pk-dropdown-item-BoZTGWMU.js";
-import { t as PkDropdownMenu } from "./chunks/pk-dropdown-menu-CfZc7dIz.js";
-import { t as PkDropdownLabel } from "./chunks/pk-dropdown-label-Da28F917.js";
+import { t as PkDropdownItem } from "./chunks/pk-dropdown-item-D9OaG5o-.js";
+import { t as PkDropdownMenu } from "./chunks/pk-dropdown-menu-DW1wI8xQ.js";
+import { t as PkDropdownLabel } from "./chunks/pk-dropdown-label-CRNWMWQd.js";
 import { PkDropdownSeparator } from "./components/dropdown-menu/pk-dropdown-separator.js";
 import "./components/dropdown-menu.js";
-import { t as PkColorInput } from "./chunks/pk-color-input-DXdqNCK7.js";
-import { t as PkCalendar } from "./chunks/pk-calendar-enTOUCRD.js";
-import { t as PkDatePicker } from "./chunks/pk-date-picker-Bri3kZ6x.js";
-import { t as PkOption } from "./chunks/pk-option-MGj9SKOK.js";
-import { t as PkSelect } from "./chunks/pk-select-C1s0OJr0.js";
-import { t as PkTimePicker } from "./chunks/pk-time-picker-5D4nmig2.js";
-import { t as PkEditableTable } from "./chunks/pk-editable-table-Cn4WXqAo.js";
-import { t as PkField } from "./chunks/pk-field-NL4KdFZC.js";
+import { t as PkColorInput } from "./chunks/pk-color-input-CncNce1C.js";
+import { t as PkCalendar } from "./chunks/pk-calendar-Z7Y0PjeY.js";
+import { t as PkDatePicker } from "./chunks/pk-date-picker-BEAd4Ngl.js";
+import { t as PkOption } from "./chunks/pk-option-DQZHV9jL.js";
+import { t as PkSelect } from "./chunks/pk-select-CdQdhnZN.js";
+import { t as PkTimePicker } from "./chunks/pk-time-picker-CebRqydV.js";
+import { t as PkEditableTable } from "./chunks/pk-editable-table-BoqfveXO.js";
+import { t as PkField } from "./chunks/pk-field-UAlMq6mQ.js";
 import "./components/field.js";
-import { t as PkPopover } from "./chunks/pk-popover-duyNosk2.js";
+import { t as PkPopover } from "./chunks/pk-popover-D3jkHfwB.js";
 import "./components/popover.js";
 import "./components/popup.js";
-import { t as PkTooltip } from "./chunks/pk-tooltip-BoDq8YVe.js";
+import { t as PkTooltip } from "./chunks/pk-tooltip--QBV6puX.js";
 import "./components/tooltip.js";
-import { t as PkRadio } from "./chunks/pk-radio-BK4D2Htu.js";
-import { t as PkRadioGroup } from "./chunks/pk-radio-group-BRJIjOsR.js";
+import { t as PkRadio } from "./chunks/pk-radio-B5XkMHy3.js";
+import { t as PkRadioGroup } from "./chunks/pk-radio-group-ByrxGLdX.js";
 import "./components/radio-group.js";
-import { t as PkTab } from "./chunks/pk-tab-2MHunhlF.js";
-import { t as PkTabHeading } from "./chunks/pk-tab-heading-BV6m_sT-.js";
-import { t as PkTabPanel } from "./chunks/pk-tab-panel-C6FxQw9q.js";
-import { t as PkTabs } from "./chunks/pk-tabs-BTE63uK9.js";
+import { t as PkTab } from "./chunks/pk-tab-CTloD18e.js";
+import { t as PkTabHeading } from "./chunks/pk-tab-heading-Cjcgebxn.js";
+import { t as PkTabPanel } from "./chunks/pk-tab-panel-CkKU5-Ah.js";
+import { t as PkTabs } from "./chunks/pk-tabs-BgEBki1q.js";
 import "./components/tabs.js";
-import { t as PkScrollArea } from "./chunks/pk-scroll-area-BR6ckorh.js";
+import { t as PkScrollArea } from "./chunks/pk-scroll-area-CdfNxYz8.js";
 import "./components/scroll-area.js";
 import "./components/color-input.js";
 import "./components/calendar.js";
 import "./components/date-picker.js";
-import { t as PkOptionGroup } from "./chunks/pk-option-group-Cs6N7mlP.js";
+import { t as PkOptionGroup } from "./chunks/pk-option-group-CCzJkBFp.js";
 import "./components/select.js";
 import "./components/time-picker.js";
 import "./components/spinner.js";
-import { t as PkTiptapContent } from "./chunks/pk-tiptap-content-BPd4GO6c.js";
-import { t as PkTiptapEditor } from "./chunks/pk-tiptap-editor-tG67Vegc.js";
-import { t as PkTiptapInput } from "./chunks/pk-tiptap-input-CtefNnaK.js";
-import { t as registerAll } from "./chunks/register-CQodpTWT.js";
-import { t as BUNDLER_TAG_IMPORT_PATHS } from "./chunks/component-registry-CNB8PbP_.js";
-import { t as createRegisterComponents } from "./chunks/register-components-B-qCPFFh.js";
+import { t as PkTiptapContent } from "./chunks/pk-tiptap-content-CL8smjGi.js";
+import { t as PkTiptapEditor } from "./chunks/pk-tiptap-editor-CTz-yfHL.js";
+import { t as PkTiptapInput } from "./chunks/pk-tiptap-input-Y9eog9Zn.js";
+import { t as registerAll } from "./chunks/register-aJw-9RWi.js";
+import { t as BUNDLER_TAG_IMPORT_PATHS } from "./chunks/component-registry-D34fm8xW.js";
+import { t as createRegisterComponents } from "./chunks/register-components-BT9THgdh.js";
 export { ALL_VALUE, PkButton, PkButtonGroup, PkButtonGroupSeparator, PkButtonGroupText, PkCalendar, PkCheckbox, PkCheckboxSelect, PkCodeEditor, PkColorInput, PkCombobox, PkConnect, PkConnectOauth, PkCopyButton, PkDatePicker, PkDialog, PkDropdownItem, PkDropdownLabel, PkDropdownMenu, PkDropdownSeparator, PkEditableTable, PkField, PkIcon, PkInput, PkInputGroup, PkInputGroupAddon, PkInputGroupButton, PkInputGroupInput, PkInputGroupText, PkInputGroupTextarea, PkLightswitch, PkOption, PkOptionGroup, PkPopover, PkPopup, PkRadio, PkRadioGroup, PkScrollArea, PkSelect, PkSeparator, PkSpinner, PkStatus, PkTab, PkTabHeading, PkTabPanel, PkTabs, PkTextarea, PkTimePicker, PkTiptapContent, PkTiptapEditor, PkTiptapInput, PkToggle, PkToggleGroup, PkTooltip, BUNDLER_TAG_IMPORT_PATHS as componentImportPaths, createRegisterComponents, getButtonSpinnerSize, registerAll, resolveSpinnerVariant };

package/dist/utilities/fouce.css

@@ -51,6 +51,8 @@
         pk-calendar,
         pk-date-picker,
         pk-combobox,
+        pk-autocomplete,
+        pk-image-browser,
         pk-time-picker,
         pk-copy-button,
         pk-connect,

package/dist/utils/async-option-fetch.d.ts

@@ -0,0 +1,38 @@
+/**
+ * Debounced async option fetch with abort + stale-request guards.
+ * Used by Combobox and Autocomplete so both share one loading lifecycle.
+ */
+export type PkAsyncOptionItem = {
+    value: string;
+    label: string;
+};
+export type PkAsyncOptionFetchHandler = (query: string, signal: AbortSignal) => Promise<PkAsyncOptionItem[]>;
+export type PkAsyncOptionFetchCallbacks = {
+    /** Called when a fetch starts (non-empty query). */
+    onLoading?: () => void;
+    /** Apply results for the latest request (may be empty). */
+    onResults: (items: PkAsyncOptionItem[]) => void;
+    /** Called when a non-abort failure occurs for the latest request. */
+    onError?: (message: string) => void;
+    /** Called when loading ends for the latest request (success or error). */
+    onSettled?: () => void;
+    /** Empty query — typically show selected meta or clear. */
+    onEmptyQuery?: () => void;
+    /** Log context when a fetch throws (defaults to "options"). */
+    errorLabel?: string;
+    debounceMs?: number;
+};
+export declare class AsyncOptionFetcher {
+    private readonly getHandler;
+    private timer;
+    private requestId;
+    private abortController;
+    private readonly debounceMs;
+    private readonly errorLabel;
+    private readonly callbacks;
+    constructor(getHandler: () => PkAsyncOptionFetchHandler | null, callbacks: PkAsyncOptionFetchCallbacks);
+    schedule(query: string): void;
+    cancel(): void;
+    private run;
+}
+//# sourceMappingURL=async-option-fetch.d.ts.map

package/dist/utils/async-option-fetch.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"async-option-fetch.d.ts","sourceRoot":"","sources":["../../src/utils/async-option-fetch.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,MAAM,iBAAiB,GAAG;IAC5B,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;CACjB,CAAC;AAEF,MAAM,MAAM,yBAAyB,GAAG,CACpC,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,WAAW,KAClB,OAAO,CAAC,iBAAiB,EAAE,CAAC,CAAC;AAElC,MAAM,MAAM,2BAA2B,GAAG;IACtC,oDAAoD;IACpD,SAAS,CAAC,EAAE,MAAM,IAAI,CAAC;IACvB,2DAA2D;IAC3D,SAAS,EAAE,CAAC,KAAK,EAAE,iBAAiB,EAAE,KAAK,IAAI,CAAC;IAChD,qEAAqE;IACrE,OAAO,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;IACpC,0EAA0E;IAC1E,SAAS,CAAC,EAAE,MAAM,IAAI,CAAC;IACvB,2DAA2D;IAC3D,YAAY,CAAC,EAAE,MAAM,IAAI,CAAC;IAC1B,+DAA+D;IAC/D,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,MAAM,CAAC;CACvB,CAAC;AAEF,qBAAa,kBAAkB;IASvB,OAAO,CAAC,QAAQ,CAAC,UAAU;IAR/B,OAAO,CAAC,KAAK,CAAuB;IACpC,OAAO,CAAC,SAAS,CAAK;IACtB,OAAO,CAAC,eAAe,CAAgC;IACvD,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;IACpC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;IACpC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAA8B;gBAGnC,UAAU,EAAE,MAAM,yBAAyB,GAAG,IAAI,EACnE,SAAS,EAAE,2BAA2B;IAO1C,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAW7B,MAAM,IAAI,IAAI;YAUA,GAAG;CA4CpB"}

package/dist/utils/option-filter.d.ts

@@ -0,0 +1,11 @@
+import { PkOption } from '../components/select/pk-option.js';
+/** Custom option filter — `(option, query) => boolean`. Query is already lowercased. */
+export type PkOptionFilter = (option: PkOption, query: string) => boolean;
+/**
+ * Default Combobox / Autocomplete filter: label, value, or full search text substring.
+ * Rich options may set a short `label` for the closed input — still match subtitle text.
+ */
+export declare function defaultOptionFilter(option: PkOption, query: string): boolean;
+/** Resolve a custom filter or the default substring match. */
+export declare function matchesOptionFilter(option: PkOption, query: string, filter: PkOptionFilter | null | undefined): boolean;
+//# sourceMappingURL=option-filter.d.ts.map

package/dist/utils/option-filter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"option-filter.d.ts","sourceRoot":"","sources":["../../src/utils/option-filter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,mCAAmC,CAAC;AAElE,wFAAwF;AACxF,MAAM,MAAM,cAAc,GAAG,CAAC,MAAM,EAAE,QAAQ,EAAE,KAAK,EAAE,MAAM,KAAK,OAAO,CAAC;AAE1E;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,QAAQ,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAM5E;AAED,8DAA8D;AAC9D,wBAAgB,mBAAmB,CAC/B,MAAM,EAAE,QAAQ,EAChB,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,cAAc,GAAG,IAAI,GAAG,SAAS,GAC1C,OAAO,CAMT"}

package/dist/utils/popup-content-exit.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Wait for `pk-popup-content-out` on a listbox panel, then clear the `closing` class.
+ * Shared by Combobox and Autocomplete so exit motion stays one implementation.
+ */
+export declare function waitForPopupContentExitAnimation(panel: HTMLElement | null | undefined, fallbackMs?: number): Promise<void>;
+//# sourceMappingURL=popup-content-exit.d.ts.map

package/dist/utils/popup-content-exit.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"popup-content-exit.d.ts","sourceRoot":"","sources":["../../src/utils/popup-content-exit.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,wBAAgB,gCAAgC,CAC5C,KAAK,EAAE,WAAW,GAAG,IAAI,GAAG,SAAS,EACrC,UAAU,SAAM,GACjB,OAAO,CAAC,IAAI,CAAC,CA8Bf"}

package/dist-loader/chunks/option-filter-Bc5aNNT0.js

@@ -0,0 +1,119 @@
+import { t as syncListboxSeparators } from "./sync-listbox-separators-Ch5krDUs.js";
+//#region src/utils/popup-content-exit.ts
+/**
+* Wait for `pk-popup-content-out` on a listbox panel, then clear the `closing` class.
+* Shared by Combobox and Autocomplete so exit motion stays one implementation.
+*/
+function waitForPopupContentExitAnimation(panel, fallbackMs = 150) {
+	if (!panel) return Promise.resolve();
+	return new Promise((resolve) => {
+		let settled = false;
+		const finish = () => {
+			if (settled) return;
+			settled = true;
+			panel.removeEventListener("animationend", onAnimationEnd);
+			window.clearTimeout(fallback);
+			panel.classList.remove("closing");
+			resolve();
+		};
+		const onAnimationEnd = (event) => {
+			if (event.target === panel && event.animationName.startsWith("pk-popup-content-out")) finish();
+		};
+		panel.classList.add("closing");
+		panel.addEventListener("animationend", onAnimationEnd);
+		const fallback = window.setTimeout(finish, fallbackMs);
+	});
+}
+//#endregion
+//#region src/internal/sync-filtered-options.ts
+/**
+* Apply filter visibility, match highlight, option ids, and group empty markers.
+* Shared by Combobox and Autocomplete — not a full listbox controller.
+*/
+function syncFilteredOptions(config) {
+	const { host, options, visible, listboxId, filterQuery, isSelected } = config;
+	for (const option of options) {
+		option.selected = isSelected(option.value);
+		option.hidden = !visible.includes(option);
+		option.optionId = `${listboxId}-option-${option.value}`;
+		option.matchQuery = filterQuery;
+	}
+	for (const group of host.querySelectorAll("pk-option-group")) {
+		const groupOptions = [...group.querySelectorAll("pk-option")];
+		const filterEmpty = groupOptions.length > 0 && groupOptions.every((option) => option.hidden);
+		group.toggleAttribute("data-pk-filter-empty", filterEmpty);
+	}
+	syncListboxSeparators(host);
+}
+//#endregion
+//#region src/utils/async-option-fetch.ts
+var AsyncOptionFetcher = class {
+	constructor(getHandler, callbacks) {
+		this.getHandler = getHandler;
+		this.timer = null;
+		this.requestId = 0;
+		this.abortController = null;
+		this.callbacks = callbacks;
+		this.debounceMs = callbacks.debounceMs ?? 200;
+		this.errorLabel = callbacks.errorLabel ?? "options";
+	}
+	schedule(query) {
+		if (this.timer !== null) window.clearTimeout(this.timer);
+		this.timer = window.setTimeout(() => {
+			this.timer = null;
+			this.run(query);
+		}, this.debounceMs);
+	}
+	cancel() {
+		if (this.timer !== null) {
+			window.clearTimeout(this.timer);
+			this.timer = null;
+		}
+		this.abortController?.abort();
+		this.abortController = null;
+	}
+	async run(query) {
+		const handler = this.getHandler();
+		if (!handler) return;
+		const requestId = ++this.requestId;
+		this.abortController?.abort();
+		this.abortController = new AbortController();
+		if (!query) {
+			this.callbacks.onEmptyQuery?.();
+			return;
+		}
+		this.callbacks.onLoading?.();
+		try {
+			const results = await handler(query, this.abortController.signal);
+			if (requestId !== this.requestId) return;
+			this.callbacks.onResults(results);
+		} catch (error) {
+			if (this.abortController?.signal.aborted || requestId !== this.requestId) return;
+			if (error instanceof DOMException && error.name === "AbortError") return;
+			console.error(`Failed to load ${this.errorLabel}:`, error);
+			this.callbacks.onError?.("Failed to load options. Please try again.");
+			this.callbacks.onResults([]);
+		} finally {
+			if (requestId === this.requestId) this.callbacks.onSettled?.();
+		}
+	}
+};
+//#endregion
+//#region src/utils/option-filter.ts
+/**
+* Default Combobox / Autocomplete filter: label, value, or full search text substring.
+* Rich options may set a short `label` for the closed input — still match subtitle text.
+*/
+function defaultOptionFilter(option, query) {
+	const label = option.getLabel().toLowerCase();
+	const value = option.value.toLowerCase();
+	const searchText = (option.getSearchText?.() ?? label).toLowerCase();
+	return label.includes(query) || value.includes(query) || searchText.includes(query);
+}
+/** Resolve a custom filter or the default substring match. */
+function matchesOptionFilter(option, query, filter) {
+	if (filter) return filter(option, query);
+	return defaultOptionFilter(option, query);
+}
+//#endregion
+export { waitForPopupContentExitAnimation as i, AsyncOptionFetcher as n, syncFilteredOptions as r, matchesOptionFilter as t };

package/dist-loader/chunks/{pk-base-B21zXxSo.js → pk-base-CyzwylQ7.js}

@@ -261,7 +261,15 @@ function CustomErrorValidator() {
 //#endregion
 //#region src/base/pk-form-associated-element.ts
 /**
-* Form-associated custom element base —  `FormAssociatedElement` pattern.
+* Form-associated custom element base — ElementInternals + shared validity helpers.
+*
+* @cssstate disabled - The control is disabled.
+* @cssstate required - The control is required.
+* @cssstate optional - The control is not required.
+* @cssstate invalid - The control currently fails constraint validation.
+* @cssstate valid - The control currently passes constraint validation.
+* @cssstate user-invalid - Invalid after the user has interacted with the control.
+* @cssstate user-valid - Valid after the user has interacted with the control.
 */
 var PkFormAssociatedElement = class extends PkElement {
 	static {
@@ -379,20 +387,24 @@ var PkFormAssociatedElement = class extends PkElement {
 	getForm() {
 		return this.internals.form;
 	}
+	/** Runs constraint validation without showing the browser UI. */
 	checkValidity() {
 		this.updateValidity();
 		return this.internals.checkValidity();
 	}
+	/** Runs constraint validation and shows the browser UI when invalid. */
 	reportValidity() {
 		this.updateValidity();
 		this.hasInteracted = true;
 		return this.internals.reportValidity();
 	}
+	/** Clears custom errors and re-syncs validity state. */
 	resetValidity() {
 		this.setCustomValidity("");
 		this.internals.setValidity({});
 		this.syncCustomStates();
 	}
+	/** Sets or clears a custom validation message. */
 	setCustomValidity(message) {
 		if (!message) {
 			this.customError = null;

package/dist-loader/chunks/{pk-button-Dh4gjLHw.js → pk-button-saBDszJV.js}

@@ -1,7 +1,7 @@
 import { a as o, c as r, f as A, i as e, l as n, m as i, p as b, u as customElement } from "./lit-DpLik9Rf.js";
-import { c as __decorate, l as PkElement, s as iconStyles, u as hostDisplayInlineBlock } from "./pk-base-B21zXxSo.js";
-import "./pk-spinner-CIbXjDnp.js";
-import { h as chevronDown, t as iconToSvg } from "./svg-_Mtb7CHx.js";
+import { c as __decorate, l as PkElement, s as iconStyles, u as hostDisplayInlineBlock } from "./pk-base-CyzwylQ7.js";
+import "./pk-spinner-BKU9Rf2R.js";
+import { h as chevronDown, t as iconToSvg } from "./svg-Bz-bXZn7.js";
 import { i as buttonGroupIndentStyles, n as buttonGroupCornerRadiusStyles, r as buttonGroupCornerRoleStyles, t as buttonGroupBorderJoinStyles } from "./button-group-item.styles-CsBQ3Cyh.js";
 //#region src/components/spinner/spinner-utils.ts
 function getButtonSpinnerSize(buttonSize = "default") {
@@ -637,6 +637,7 @@ var PkButton = class PkButton extends PkElement {
 		this.groupTrigger = false;
 		this.icon = false;
 		this.title = "";
+		this.ariaLabel = null;
 		this.type = "button";
 		this.hasDefaultSlotContent = false;
 		this.hasStartSlotContent = false;
@@ -728,15 +729,17 @@ var PkButton = class PkButton extends PkElement {
 	render() {
 		const spinnerSize = this.spinnerSize || getButtonSpinnerSize(this.size);
 		const spinnerVariant = resolveSpinnerVariant(this.variant, this.spinnerVariant);
+		const isLink = Boolean(this.href);
+		const accessibleName = this.ariaLabel || this.title || "";
 		return b`
-            ${Boolean(this.href) ? b`
+            ${isLink ? b`
                     <a
                         part="base"
                         class=${this.buttonClasses()}
                         href=${this.href}
                         target=${this.target ?? A}
                         rel=${this.rel ?? A}
-                        title=${this.title || A}
+                        aria-label=${accessibleName || A}
                     >
                         ${this.renderInner(spinnerSize, spinnerVariant)}
                     </a>
@@ -748,9 +751,9 @@ var PkButton = class PkButton extends PkElement {
                         ?disabled=${this.disabled}
                         aria-disabled=${this.disabled ? "true" : A}
                         aria-busy=${this.loading ? "true" : A}
+                        aria-label=${accessibleName || A}
                         name=${this.name ?? A}
                         value=${this.value ?? A}
-                        title=${this.title || A}
                     >
                         ${this.renderInner(spinnerSize, spinnerVariant)}
                     </button>
@@ -840,6 +843,7 @@ __decorate([n()], PkButton.prototype, "rel", void 0);
 __decorate([n()], PkButton.prototype, "name", void 0);
 __decorate([n()], PkButton.prototype, "value", void 0);
 __decorate([n()], PkButton.prototype, "title", void 0);
+__decorate([n({ attribute: "aria-label" })], PkButton.prototype, "ariaLabel", void 0);
 __decorate([n()], PkButton.prototype, "type", void 0);
 __decorate([n({ reflect: true })], PkButton.prototype, "form", void 0);
 __decorate([r()], PkButton.prototype, "hasDefaultSlotContent", void 0);

package/dist-loader/chunks/{pk-calendar-n1bwSO7X.js → pk-calendar-BrF8i3dW.js}

@@ -1,8 +1,8 @@
 import { a as o$1, c as r, f as A, i as e, l as n, m as i, o, p as b, u as customElement } from "./lit-DpLik9Rf.js";
-import { c as __decorate, l as PkElement, s as iconStyles } from "./pk-base-B21zXxSo.js";
-import { _ as chevronRight, g as chevronLeft } from "./svg-_Mtb7CHx.js";
+import { c as __decorate, l as PkElement, s as iconStyles } from "./pk-base-CyzwylQ7.js";
+import { _ as chevronRight, g as chevronLeft } from "./svg-Bz-bXZn7.js";
 import { t as HasSlotController } from "./has-slot-BGJeJdHr.js";
-import { n as renderIconHtml } from "./render-Niz5wYRa.js";
+import { n as renderIconHtml } from "./render-Bnzcxfss.js";
 //#region src/utils/date.ts
 /** ISO date helpers — ported from  `date-picker/internal/iso`. */
 var ISO_DATE = /^(\d{4})-(\d{2})-(\d{2})$/;

package/dist-loader/chunks/{pk-checkbox-BrZQB816.js → pk-checkbox-B3d4nkBx.js}

@@ -1,5 +1,5 @@
 import { c as r, f as A, i as e, l as n, m as i, p as b, s as e$1, u as customElement } from "./lit-DpLik9Rf.js";
-import { c as __decorate, i as PkFormAssociatedElement, r as checkboxControlStyles } from "./pk-base-B21zXxSo.js";
+import { c as __decorate, i as PkFormAssociatedElement, r as checkboxControlStyles } from "./pk-base-CyzwylQ7.js";
 import { t as RequiredValidator } from "./required-validator-0XwZtX9k.js";
 import { t as HasSlotController } from "./has-slot-BGJeJdHr.js";
 //#region src/icons/checkbox-indicators.ts

package/dist-loader/chunks/{pk-color-input-sS05YOwT.js → pk-color-input-CD-r_sfG.js}

@@ -1,5 +1,5 @@
 import { c as r, f as A, i as e, l as n, m as i, p as b, s as e$1, u as customElement } from "./lit-DpLik9Rf.js";
-import { c as __decorate, i as PkFormAssociatedElement } from "./pk-base-B21zXxSo.js";
+import { c as __decorate, i as PkFormAssociatedElement } from "./pk-base-CyzwylQ7.js";
 import { t as MirrorValidator } from "./mirror-validator-C5XrXPaq.js";
 import { t as RequiredValidator } from "./required-validator-0XwZtX9k.js";
 //#region src/components/color-input/pk-color-input.styles.ts