@verbb/plugin-kit-web 2.0.15 → 2.0.17

package/dist/components/image-browser/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/components/image-browser/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACH,cAAc,EACd,KAAK,mBAAmB,EACxB,KAAK,kBAAkB,EACvB,KAAK,uBAAuB,EAC5B,KAAK,kBAAkB,EACvB,KAAK,kBAAkB,EACvB,KAAK,mBAAmB,GAC3B,MAAM,uBAAuB,CAAC"}

package/dist/components/image-browser/pk-image-browser.d.ts

@@ -0,0 +1,190 @@
+import { PropertyValues } from 'lit';
+import { PkFormAssociatedElement } from '../../base/pk-form-associated-element.js';
+import { PkOverlaySource } from '../../events/overlay-lifecycle.js';
+import { PkPopupPlacement } from '../popup/pk-popup.js';
+export type PkImageBrowserSize = 'xs' | 'sm' | 'default' | 'lg' | 'xl';
+/** Grid preview kind — compact glyphs vs larger photo tiles. */
+export type PkImageBrowserMode = 'icon' | 'image';
+/**
+ * How option names appear in the grid.
+ * - `tooltip` (default) — shared `pk-tooltip` on hover; `aria-label` always
+ * - `inline` — caption under each cell
+ * - `none` — `aria-label` only (no tooltip, no caption)
+ *
+ * Named `labelMode` (not `labels`) to avoid clashing with the native
+ * form-associated `HTMLElement.labels` NodeList getter.
+ */
+export type PkImageBrowserLabelMode = 'tooltip' | 'inline' | 'none';
+export type PkImageBrowserWidth = 'auto' | 'full';
+/**
+ * One browsable entry. Plugins own filtering / filesystem scanning and pass
+ * already-resolved preview URLs or inline SVG markup.
+ */
+export type PkImageBrowserItem = {
+    value: string;
+    label: string;
+    /** Public URL for `<img>`, or inline `<svg>…</svg>` markup. */
+    preview?: string;
+};
+export type PkImageBrowserGroup = {
+    name: string;
+    items: PkImageBrowserItem[];
+};
+/**
+ * Image browser — presentational picker for static filesystem icons/images.
+ *
+ * Plugins supply `items` / `groups` (and optional `selected-label` /
+ * `selected-preview` for the closed trigger before the catalog is ready). The
+ * kit does not scan disks or filter extensions.
+ *
+ * Keyboard: trigger opens with Enter / Space / ArrowDown; search owns focus with
+ * `aria-activedescendant`; arrows move the highlight (2D in the grid); Enter
+ * selects; Escape closes.
+ *
+ * @csspart root - Filled control surface (trigger + clear + chevron)
+ * @csspart trigger - Opens the panel (preview + label)
+ * @csspart clear-button - Clear selection button (inside the control)
+ * @csspart panel - Popup panel shell
+ * @csspart panel-search - Search field container
+ * @csspart panel-input - Search input
+ * @csspart panel-body - Scrollable results region
+ * @csspart loading - Catalog-loading status region (spinner)
+ * @csspart option - Grid cell button
+ *
+ * @dependency pk-popup - Positioned panel host.
+ * @dependency pk-spinner - Shown in the panel while `loading` is set.
+ * @dependency pk-tooltip - Hover label when `label-mode="tooltip"`.
+ */
+export declare class PkImageBrowser extends PkFormAssociatedElement {
+    static styles: import('lit').CSSResult[];
+    static get validators(): import('../../index.js').PkValidator[];
+    assumeInteractionOn: string[];
+    size: PkImageBrowserSize;
+    /** `icon` = compact glyph tiles; `image` = larger photo tiles. */
+    mode: PkImageBrowserMode;
+    width: PkImageBrowserWidth;
+    /**
+     * How option names appear in the grid: `tooltip` (default), `inline` under
+     * each cell, or `none` (`aria-label` only).
+     */
+    labelMode: PkImageBrowserLabelMode;
+    invalid: boolean;
+    readonly: boolean;
+    value: string;
+    defaultValue: string;
+    placeholder: string;
+    searchPlaceholder: string;
+    emptyMessage: string;
+    ariaLabel: string | null;
+    /**
+     * Host-driven catalog warm / refresh. Shows a centered `pk-spinner` in the
+     * panel (no loading copy). Prefer this over inferring from empty `items` /
+     * `groups` — empty can also mean a filter miss or a genuinely empty catalog.
+     */
+    loading: boolean;
+    /** Show a clear control when a value is selected. */
+    withClear: boolean;
+    items: PkImageBrowserItem[];
+    groups: PkImageBrowserGroup[];
+    /**
+     * Closed-trigger label when `value` is set but not yet found in `items` /
+     * `groups` (e.g. catalog still loading).
+     */
+    selectedLabel: string;
+    /** Closed-trigger preview for the same pre-catalog case as `selected-label`. */
+    selectedPreview: string;
+    placement: PkPopupPlacement;
+    sideOffset: number;
+    /** Items drawn per group before scroll reveals the next page. */
+    pageSize: number;
+    open: boolean;
+    private query;
+    /** Render budget shared across groups — raised by scrolling, reset on query/open. */
+    private limit;
+    private closing;
+    private panelAnimated;
+    /** Flat index into `flatVisibleItems()` for aria-activedescendant navigation. */
+    private highlightedIndex;
+    /** Shared hover tooltip target when `labelMode="tooltip"`. */
+    private tooltipFor;
+    private tooltipContent;
+    input: HTMLInputElement;
+    private triggerElement;
+    private controlElement;
+    private popupElement;
+    private panelElement;
+    private searchInput;
+    private panelBody;
+    private optionTooltip;
+    private readonly listboxId;
+    private readonly searchId;
+    private closeTimer;
+    private tooltipOpenTimer;
+    private liveRegion;
+    connectedCallback(): void;
+    disconnectedCallback(): void;
+    protected willUpdate(changed: PropertyValues): void;
+    updated(changed: PropertyValues): void;
+    protected get validationTarget(): HTMLElement;
+    protected syncFormValue(): void;
+    protected resetToDefaultValue(): void;
+    protected restoreFormState(state: string | File | FormData | null): void;
+    show(): Promise<void>;
+    hide(source?: PkOverlaySource): Promise<void>;
+    private optionId;
+    private groupHeadingId;
+    private normalizedPageSize;
+    private resolveGroups;
+    private findItem;
+    private selectedItem;
+    private triggerDisplay;
+    /** Groups matching the query, each truncated to the current render budget. */
+    private visibleGroups;
+    private flatVisibleItems;
+    private isTruncated;
+    private activeDescendantId;
+    private triggerAccessibleName;
+    private announceResults;
+    private resetHighlightForOpenCatalog;
+    private setHighlightedIndex;
+    private scrollHighlightedIntoView;
+    /** Column count of the CSS grid that owns the highlighted option (for 2D arrows). */
+    private columnCountNear;
+    private moveHighlight;
+    private emitChange;
+    private selectValue;
+    private handleClear;
+    private togglePanel;
+    private handleTriggerKeyDown;
+    private openPanel;
+    private closePanel;
+    private clearCloseTimer;
+    private syncPanelPlacement;
+    private attachDismissListeners;
+    private teardownDismissListeners;
+    private onDocumentPointerDown;
+    private onDocumentKeyDown;
+    private handleSearchInput;
+    private handleSearchKeyDown;
+    private handleResultsScroll;
+    private focusSearchWhenReady;
+    private renderPreview;
+    private usesInlineLabels;
+    private usesTooltipLabels;
+    /** Hover caption via one shared tooltip — avoids N×pk-tooltip in large catalogs. */
+    private showOptionTooltip;
+    private clearOptionTooltip;
+    private clearTooltipOpenTimer;
+    private handleOptionPointerEnter;
+    private handleOptionPointerLeave;
+    private resetHighlightToSelected;
+    private renderTriggerContents;
+    private renderResults;
+    render(): import('lit-html').TemplateResult<1>;
+}
+declare global {
+    interface HTMLElementTagNameMap {
+        'pk-image-browser': PkImageBrowser;
+    }
+}
+//# sourceMappingURL=pk-image-browser.d.ts.map

package/dist/components/image-browser/pk-image-browser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pk-image-browser.d.ts","sourceRoot":"","sources":["../../../src/components/image-browser/pk-image-browser.ts"],"names":[],"mappings":"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"}

package/dist/components/image-browser/pk-image-browser.js

@@ -0,0 +1,2 @@
+import { t as PkImageBrowser } from "../../chunks/pk-image-browser-DwiCFOIG.js";
+export { PkImageBrowser };

package/dist/components/image-browser/pk-image-browser.styles.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Presentational static image / icon browser.
+ * Trigger chrome mirrors combobox popup-mode; panel grid mirrors Vizy icon picker.
+ */
+export declare const pkImageBrowserStyles: import('lit').CSSResult[];
+//# sourceMappingURL=pk-image-browser.styles.d.ts.map

package/dist/components/image-browser/pk-image-browser.styles.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pk-image-browser.styles.d.ts","sourceRoot":"","sources":["../../../src/components/image-browser/pk-image-browser.styles.ts"],"names":[],"mappings":"AAKA;;;GAGG;AACH,eAAO,MAAM,oBAAoB,2BAkiBhC,CAAC"}

package/dist/components/image-browser.d.ts

@@ -0,0 +1,2 @@
+export * from './image-browser/index'
+export {}

package/dist/components/image-browser.js

@@ -0,0 +1,2 @@
+import { t as PkImageBrowser } from "../chunks/pk-image-browser-DwiCFOIG.js";
+export { PkImageBrowser };

package/dist/components/input/pk-input.d.ts

@@ -7,8 +7,9 @@ export type PkInputSize = 'xs' | 'sm' | 'default' | 'lg' | 'xl';
  * @slot label
  * @slot instructions
  * @slot hint - Alias for `instructions`
- * @slot start - Leading adornment inside the field chrome (icon, unit, etc.)
- * @slot end - Trailing adornment inside the field chrome
+ * @slot start - Leading adornment inside the field control (icon, unit, etc.)
+ * @slot end - Trailing adornment inside the field control (icon, unit, or
+ *   in-control action such as `pk-copy-button`)
  * @slot clear-icon
  *
  * @csspart form-control - Wrapper

package/dist/components/input/pk-input.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"pk-input.d.ts","sourceRoot":"","sources":["../../../src/components/input/pk-input.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,KAAK,CAAC;AAK1C,OAAO,EAAE,uBAAuB,EAAE,MAAM,0CAA0C,CAAC;AAWnF,MAAM,MAAM,WAAW,GAAG,IAAI,GAAG,IAAI,GAAG,SAAS,GAAG,IAAI,GAAG,IAAI,CAAC;AAEhE;;;;;;;;;;;;;;;;;;GAkBG;AACH,qBACa,OAAQ,SAAQ,uBAAuB;IAChD,OAAgB,MAAM,4BAA2M;IAEjO,WAAoB,UAAU,2CAE7B;IAEQ,mBAAmB,WAAqB;IAEjD,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAAgF;IAElH,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAwB;IAGvC,KAAK,EAAG,gBAAgB,CAAC;IAGlC,IAAI,SAAU;IAEd,OAAO,CAAC,MAAM,CAAuB;IAErC,IAAI,KAAK,IAAI,MAAM,CAMlB;IAED,IACI,KAAK,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,EAS3B;IAGD,YAAY,EAAE,MAAM,GAAG,IAAI,CAAQ;IAGnC,IAAI,EAAE,WAAW,CAAa;IAG9B,KAAK,SAAM;IAGX,YAAY,SAAM;IAGlB,SAAS,UAAS;IAGlB,WAAW,SAAM;IAGjB,QAAQ,UAAS;IAGjB,OAAO,UAAS;IAEhB,kDAAkD;IAElD,OAAO,UAAS;IAEhB,mEAAmE;IAEnE,IAAI,UAAS;IAGb,OAAO,CAAC,EAAE,MAAM,CAAC;IAGjB,SAAS,CAAC,EAAE,MAAM,CAAC;IAGnB,SAAS,CAAC,EAAE,MAAM,CAAC;IAGnB,GAAG,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IAGtB,GAAG,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IAGtB,IAAI,CAAC,EAAE,MAAM,GAAG,KAAK,CAAC;IAGtB,YAAY,CAAC,EAAE,MAAM,CAAC;IAGtB,SAAS,UAAS;IAGlB,SAAS,UAAS;IAGlB,gBAAgB,UAAS;IAEhB,iBAAiB,IAAI,IAAI;cAUf,aAAa,IAAI,IAAI;cAIrB,mBAAmB,IAAI,IAAI;cAK3B,gBAAgB,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,GAAG,QAAQ,GAAG,IAAI,GAAG,IAAI;IAMxE,iBAAiB,IAAI,IAAI;IAWzB,OAAO,CAAC,OAAO,EAAE,cAAc,GAAG,IAAI;cAQ5B,kBAAkB,IAAI,IAAI;IAuB7C,OAAO,CAAC,eAAe;IAIvB,OAAO,CAAC,sBAAsB;IAQ9B,KAAK,CAAC,OAAO,CAAC,EAAE,YAAY,GAAG,IAAI;IAInC,IAAI,IAAI,IAAI;IAIZ,MAAM,IAAI,IAAI;IAId,OAAO,CAAC,WAAW;IAKnB,OAAO,CAAC,YAAY;IAMpB;;;OAGG;IACH,OAAO,CAAC,aAAa;IAIrB,OAAO,CAAC,gBAAgB;IAcf,MAAM;CAqGlB;AAED,OAAO,CAAC,MAAM,CAAC;IACX,UAAU,qBAAqB;QAC3B,UAAU,EAAE,OAAO,CAAC;KACvB;CACJ"}
+{"version":3,"file":"pk-input.d.ts","sourceRoot":"","sources":["../../../src/components/input/pk-input.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,KAAK,CAAC;AAK1C,OAAO,EAAE,uBAAuB,EAAE,MAAM,0CAA0C,CAAC;AAWnF,MAAM,MAAM,WAAW,GAAG,IAAI,GAAG,IAAI,GAAG,SAAS,GAAG,IAAI,GAAG,IAAI,CAAC;AAEhE;;;;;;;;;;;;;;;;;;;GAmBG;AACH,qBACa,OAAQ,SAAQ,uBAAuB;IAChD,OAAgB,MAAM,4BAA2M;IAEjO,WAAoB,UAAU,2CAE7B;IAEQ,mBAAmB,WAAqB;IAEjD,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAAgF;IAElH,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAwB;IAGvC,KAAK,EAAG,gBAAgB,CAAC;IAGlC,IAAI,SAAU;IAEd,OAAO,CAAC,MAAM,CAAuB;IAErC,IAAI,KAAK,IAAI,MAAM,CAMlB;IAED,IACI,KAAK,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,EAS3B;IAGD,YAAY,EAAE,MAAM,GAAG,IAAI,CAAQ;IAGnC,IAAI,EAAE,WAAW,CAAa;IAG9B,KAAK,SAAM;IAGX,YAAY,SAAM;IAGlB,SAAS,UAAS;IAGlB,WAAW,SAAM;IAGjB,QAAQ,UAAS;IAGjB,OAAO,UAAS;IAEhB,kDAAkD;IAElD,OAAO,UAAS;IAEhB,mEAAmE;IAEnE,IAAI,UAAS;IAGb,OAAO,CAAC,EAAE,MAAM,CAAC;IAGjB,SAAS,CAAC,EAAE,MAAM,CAAC;IAGnB,SAAS,CAAC,EAAE,MAAM,CAAC;IAGnB,GAAG,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IAGtB,GAAG,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IAGtB,IAAI,CAAC,EAAE,MAAM,GAAG,KAAK,CAAC;IAGtB,YAAY,CAAC,EAAE,MAAM,CAAC;IAGtB,SAAS,UAAS;IAGlB,SAAS,UAAS;IAGlB,gBAAgB,UAAS;IAEhB,iBAAiB,IAAI,IAAI;cAUf,aAAa,IAAI,IAAI;cAIrB,mBAAmB,IAAI,IAAI;cAK3B,gBAAgB,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,GAAG,QAAQ,GAAG,IAAI,GAAG,IAAI;IAMxE,iBAAiB,IAAI,IAAI;IAWzB,OAAO,CAAC,OAAO,EAAE,cAAc,GAAG,IAAI;cAQ5B,kBAAkB,IAAI,IAAI;IAuB7C,OAAO,CAAC,eAAe;IAIvB,OAAO,CAAC,sBAAsB;IAQ9B,KAAK,CAAC,OAAO,CAAC,EAAE,YAAY,GAAG,IAAI;IAInC,IAAI,IAAI,IAAI;IAIZ,MAAM,IAAI,IAAI;IAId,OAAO,CAAC,WAAW;IAKnB,OAAO,CAAC,YAAY;IAMpB;;;OAGG;IACH,OAAO,CAAC,aAAa;IAIrB,OAAO,CAAC,gBAAgB;IAcf,MAAM;CAqGlB;AAED,OAAO,CAAC,MAAM,CAAC;IACX,UAAU,qBAAqB;QAC3B,UAAU,EAAE,OAAO,CAAC;KACvB;CACJ"}

package/dist/components/input/pk-input.js

@@ -1,2 +1,2 @@
-import { t as PkInput } from "../../chunks/pk-input-DDkIXOkt.js";
+import { t as PkInput } from "../../chunks/pk-input-CF_icEtR.js";
 export { PkInput };

package/dist/components/input/pk-input.styles.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"pk-input.styles.d.ts","sourceRoot":"","sources":["../../../src/components/input/pk-input.styles.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,aAAa,yBA6VzB,CAAC"}
+{"version":3,"file":"pk-input.styles.d.ts","sourceRoot":"","sources":["../../../src/components/input/pk-input.styles.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,aAAa,yBA2YzB,CAAC"}

package/dist/components/input-group/pk-input-group-addon.js

@@ -1,2 +1,2 @@
-import { t as PkInputGroupAddon } from "../../chunks/pk-input-group-addon-B0StOmTJ.js";
+import { t as PkInputGroupAddon } from "../../chunks/pk-input-group-addon-ClBkGmAw.js";
 export { PkInputGroupAddon };

package/dist/components/input-group/pk-input-group-button.js

@@ -1,2 +1,2 @@
-import { t as PkInputGroupButton } from "../../chunks/pk-input-group-button-CnKajvsP.js";
+import { t as PkInputGroupButton } from "../../chunks/pk-input-group-button-CHQHsWd4.js";
 export { PkInputGroupButton };

package/dist/components/input-group/pk-input-group-input.js

@@ -1,2 +1,2 @@
-import { t as PkInputGroupInput } from "../../chunks/pk-input-group-input-mllffsjQ.js";
+import { t as PkInputGroupInput } from "../../chunks/pk-input-group-input-oNnqMBGU.js";
 export { PkInputGroupInput };

package/dist/components/input-group/pk-input-group-text.js

@@ -1,2 +1,2 @@
-import { t as PkInputGroupText } from "../../chunks/pk-input-group-text-DvaPJvh2.js";
+import { t as PkInputGroupText } from "../../chunks/pk-input-group-text-HUxlXROB.js";
 export { PkInputGroupText };

package/dist/components/input-group/pk-input-group-textarea.js

@@ -1,2 +1,2 @@
-import { t as PkInputGroupTextarea } from "../../chunks/pk-input-group-textarea-CqYv8tUQ.js";
+import { t as PkInputGroupTextarea } from "../../chunks/pk-input-group-textarea-Cl2FNuw-.js";
 export { PkInputGroupTextarea };

package/dist/components/input-group/pk-input-group.d.ts

@@ -13,7 +13,7 @@ export declare class PkInputGroup extends PkElement {
     static styles: import('lit').CSSResult[];
     private defaultSlot;
     private hostAriaMirror?;
-    /** Watch slotted control `invalid` / `disabled` / `aria-invalid` for host chrome attrs. */
+    /** Watch slotted control `invalid` / `disabled` / `aria-invalid` for host state attributes. */
     private controlStateObserver?;
     disconnectedCallback(): void;
     firstUpdated(): void;
@@ -25,7 +25,7 @@ export declare class PkInputGroup extends PkElement {
     /** Block addons live in light DOM; `:host(:has())` cannot see slotted children from shadow styles. */
     private syncBlockLayout;
     /**
-     * Mirror control invalid/disabled onto the host so shadow styles can paint shell chrome
+     * Mirror control invalid/disabled onto the host so shadow styles can paint the shell
      * without `:host(:has(…))` (unreliable for light-DOM slotted children in Chromium).
      */
     private syncControlChromeState;

package/dist/components/input-group/pk-input-group.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"pk-input-group.d.ts","sourceRoot":"","sources":["../../../src/components/input-group/pk-input-group.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,SAAS,EAAE,MAAM,0BAA0B,CAAC;AAsBrD;;;;;;;;;GASG;AACH,qBACa,YAAa,SAAQ,SAAS;IACvC,OAAgB,MAAM,4BAAsB;IAG5C,OAAO,CAAC,WAAW,CAAmB;IAEtC,OAAO,CAAC,cAAc,CAAC,CAAiB;IAExC,2FAA2F;IAC3F,OAAO,CAAC,oBAAoB,CAAC,CAAmB;IAEvC,oBAAoB,IAAI,IAAI;IAQ5B,YAAY,IAAI,IAAI;IAM7B,OAAO,CAAC,iBAAiB;IASzB,OAAO,CAAC,2BAA2B;IAQnC,OAAO,CAAC,uBAAuB;IAe/B,OAAO,CAAC,gBAAgB,CAItB;IAEF,OAAO,CAAC,oBAAoB;IAK5B,sGAAsG;IACtG,OAAO,CAAC,eAAe;IASvB;;;OAGG;IACH,OAAO,CAAC,sBAAsB;IAsBrB,MAAM;CAOlB;AAED,OAAO,CAAC,MAAM,CAAC;IACX,UAAU,qBAAqB;QAC3B,gBAAgB,EAAE,YAAY,CAAC;KAClC;CACJ"}
+{"version":3,"file":"pk-input-group.d.ts","sourceRoot":"","sources":["../../../src/components/input-group/pk-input-group.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,SAAS,EAAE,MAAM,0BAA0B,CAAC;AAsBrD;;;;;;;;;GASG;AACH,qBACa,YAAa,SAAQ,SAAS;IACvC,OAAgB,MAAM,4BAAsB;IAG5C,OAAO,CAAC,WAAW,CAAmB;IAEtC,OAAO,CAAC,cAAc,CAAC,CAAiB;IAExC,+FAA+F;IAC/F,OAAO,CAAC,oBAAoB,CAAC,CAAmB;IAEvC,oBAAoB,IAAI,IAAI;IAQ5B,YAAY,IAAI,IAAI;IAM7B,OAAO,CAAC,iBAAiB;IASzB,OAAO,CAAC,2BAA2B;IAQnC,OAAO,CAAC,uBAAuB;IAe/B,OAAO,CAAC,gBAAgB,CAItB;IAEF,OAAO,CAAC,oBAAoB;IAK5B,sGAAsG;IACtG,OAAO,CAAC,eAAe;IASvB;;;OAGG;IACH,OAAO,CAAC,sBAAsB;IAsBrB,MAAM;CAOlB;AAED,OAAO,CAAC,MAAM,CAAC;IACX,UAAU,qBAAqB;QAC3B,gBAAgB,EAAE,YAAY,CAAC;KAClC;CACJ"}

package/dist/components/input-group/pk-input-group.js

@@ -1,2 +1,2 @@
-import { t as PkInputGroup } from "../../chunks/pk-input-group-CRPSBFhX.js";
+import { t as PkInputGroup } from "../../chunks/pk-input-group-BLqKPnfc.js";
 export { PkInputGroup };

package/dist/components/input-group.js

@@ -1,7 +1,7 @@
-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";
 export { PkInputGroup, PkInputGroupAddon, PkInputGroupButton, PkInputGroupInput, PkInputGroupText, PkInputGroupTextarea };

package/dist/components/input.js

@@ -1,2 +1,2 @@
-import { t as PkInput } from "../chunks/pk-input-DDkIXOkt.js";
+import { t as PkInput } from "../chunks/pk-input-CF_icEtR.js";
 export { PkInput };

package/dist/components/lightswitch/pk-lightswitch.js

@@ -1,2 +1,2 @@
-import { t as PkLightswitch } from "../../chunks/pk-lightswitch-DI1BeCmA.js";
+import { t as PkLightswitch } from "../../chunks/pk-lightswitch-D1qEFRxK.js";
 export { PkLightswitch };

package/dist/components/lightswitch.js

@@ -1,2 +1,2 @@
-import { t as PkLightswitch } from "../chunks/pk-lightswitch-DI1BeCmA.js";
+import { t as PkLightswitch } from "../chunks/pk-lightswitch-D1qEFRxK.js";
 export { PkLightswitch };

package/dist/components/popover/pk-popover.d.ts

@@ -18,13 +18,13 @@ export declare class PkPopover extends PkElement {
     placement: PkPopupPlacement;
     sideOffset: number;
     /**
-     * Drop default panel padding/fixed width so slotted chrome (command lists, etc.)
+     * Drop default panel padding/fixed width so slotted content (command lists, etc.)
      * can control its own inset. Consumer outer `p-0` alone cannot reach `.panel`.
      */
     flush: boolean;
     /**
      * Show a floating-ui arrow on the panel (off by default).
-     * Named like other optional chrome (`with-clear`, `with-caret`) — tooltip always
+     * Named like other optional controls (`with-clear`, `with-caret`) — tooltip always
      * paints its own arrow and has no toggle.
      */
     withArrow: boolean;

package/dist/components/popover/pk-popover.js

@@ -1,2 +1,2 @@
-import { t as PkPopover } from "../../chunks/pk-popover-duyNosk2.js";
+import { t as PkPopover } from "../../chunks/pk-popover-D3jkHfwB.js";
 export { PkPopover };

package/dist/components/popover.js

@@ -1,2 +1,2 @@
-import { t as PkPopover } from "../chunks/pk-popover-duyNosk2.js";
+import { t as PkPopover } from "../chunks/pk-popover-D3jkHfwB.js";
 export { PkPopover };

package/dist/components/popup/pk-popup.d.ts

@@ -46,6 +46,10 @@ export declare class PkPopup extends PkElement {
     arrowPlacement: 'start' | 'end' | 'center' | 'anchor';
     arrowPadding: number;
     sync?: 'width' | 'height' | 'both';
+    /** Constrain the popup to the available collision boundary on the selected axes. */
+    autoSize?: 'horizontal' | 'vertical' | 'both';
+    /** Space retained between an auto-sized popup and its collision boundary. */
+    autoSizePadding: number;
     /** When false, the popup is positioned once and not tracked on scroll/resize. */
     anchorTracking: boolean;
     hoverBridge: boolean;

package/dist/components/popup/pk-popup.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"pk-popup.d.ts","sourceRoot":"","sources":["../../../src/components/popup/pk-popup.ts"],"names":[],"mappings":"AAAA,OAAO,EAUH,KAAK,SAAS,EACjB,MAAM,kBAAkB,CAAC;AAK1B,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,KAAK,CAAC;AAE1C,OAAO,EAAE,SAAS,EAAE,MAAM,0BAA0B,CAAC;AAOrD,MAAM,MAAM,gBAAgB,GAAG,SAAS,CAAC;AAEzC,MAAM,MAAM,qBAAqB,GAAG;IAChC,qBAAqB,EAAE,MAAM,OAAO,CAAC;IACrC,cAAc,CAAC,EAAE,OAAO,CAAC;CAC5B,CAAC;AAiCF;;;;;;;;;;;;;GAaG;AACH,qBACa,OAAQ,SAAQ,SAAS;IAClC,OAAgB,MAAM,0BAAiB;IAEvC,uEAAuE;IAEvE,MAAM,EAAE,OAAO,GAAG,MAAM,GAAG,qBAAqB,CAAM;IAEtD,0DAA0D;IAE1D,MAAM,UAAS;IAEf;;;OAGG;IAEH,cAAc,CAAC,EAAE,OAAO,GAAG,UAAU,CAAC;IAEtC,uGAAuG;IAEvG,QAAQ,EAAE,UAAU,GAAG,QAAQ,CAAc;IAG7C,SAAS,EAAE,gBAAgB,CAAkB;IAG7C,QAAQ,SAAK;IAGb,QAAQ,SAAK;IAGb,IAAI,UAAQ;IAGZ,sBAAsB,SAAM;IAG5B,oBAAoB,EAAE,UAAU,GAAG,SAAS,CAAc;IAG1D,WAAW,SAAK;IAGhB,KAAK,UAAQ;IAGb,YAAY,SAAK;IAGjB,KAAK,UAAS;IAGd,cAAc,EAAE,OAAO,GAAG,KAAK,GAAG,QAAQ,GAAG,QAAQ,CAAY;IAGjE,YAAY,SAAM;IAGlB,IAAI,CAAC,EAAE,OAAO,GAAG,QAAQ,GAAG,MAAM,CAAC;IAEnC,iFAAiF;IAEjF,cAAc,UAAQ;IAGtB,WAAW,UAAS;IAGpB,OAAO,CAAC,YAAY,CAAC,CAAc;IAGnC,OAAO,CAAC,YAAY,CAAC,CAAc;IAEnC,OAAO,CAAC,aAAa,CAAgD;IACrE,OAAO,CAAC,OAAO,CAAC,CAAa;IAC7B,sEAAsE;IACtE,OAAO,CAAC,uBAAuB,CAAS;IACxC,OAAO,CAAC,gBAAgB,CAAK;IAEpB,oBAAoB,IAAI,IAAI;IAK5B,OAAO,CAAC,OAAO,EAAE,cAAc,GAAG,IAAI;IAqB/C,6DAA6D;IAC7D,UAAU,IAAI,IAAI;IAQlB;;;OAGG;YACW,eAAe;IA+J7B,OAAO,CAAC,MAAM;IAed;;;;OAIG;YACW,qBAAqB;IAuCnC,OAAO,CAAC,aAAa;YAoBP,kBAAkB;IAShC,wGAAwG;IACxG,OAAO,CAAC,mBAAmB;IAI3B,wDAAwD;IACxD,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IA0BrB,iFAAiF;IACjF,kBAAkB,IAAI,IAAI;IAO1B,mCAAmC;IAC7B,WAAW,IAAI,OAAO,CAAC,IAAI,CAAC;IAIlC,OAAO,CAAC,KAAK;IA2Bb,2EAA2E;IAC3E,iBAAiB,IAAI,WAAW,GAAG,IAAI;IAkBvC,OAAO,CAAC,iBAAiB;IAsEhB,MAAM;CA8BlB;AAED,OAAO,CAAC,MAAM,CAAC;IACX,UAAU,qBAAqB;QAC3B,UAAU,EAAE,OAAO,CAAC;KACvB;CACJ"}
+{"version":3,"file":"pk-popup.d.ts","sourceRoot":"","sources":["../../../src/components/popup/pk-popup.ts"],"names":[],"mappings":"AAAA,OAAO,EAUH,KAAK,SAAS,EACjB,MAAM,kBAAkB,CAAC;AAK1B,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,KAAK,CAAC;AAE1C,OAAO,EAAE,SAAS,EAAE,MAAM,0BAA0B,CAAC;AAOrD,MAAM,MAAM,gBAAgB,GAAG,SAAS,CAAC;AAEzC,MAAM,MAAM,qBAAqB,GAAG;IAChC,qBAAqB,EAAE,MAAM,OAAO,CAAC;IACrC,cAAc,CAAC,EAAE,OAAO,CAAC;CAC5B,CAAC;AAiCF;;;;;;;;;;;;;GAaG;AACH,qBACa,OAAQ,SAAQ,SAAS;IAClC,OAAgB,MAAM,0BAAiB;IAEvC,uEAAuE;IAEvE,MAAM,EAAE,OAAO,GAAG,MAAM,GAAG,qBAAqB,CAAM;IAEtD,0DAA0D;IAE1D,MAAM,UAAS;IAEf;;;OAGG;IAEH,cAAc,CAAC,EAAE,OAAO,GAAG,UAAU,CAAC;IAEtC,uGAAuG;IAEvG,QAAQ,EAAE,UAAU,GAAG,QAAQ,CAAc;IAG7C,SAAS,EAAE,gBAAgB,CAAkB;IAG7C,QAAQ,SAAK;IAGb,QAAQ,SAAK;IAGb,IAAI,UAAQ;IAGZ,sBAAsB,SAAM;IAG5B,oBAAoB,EAAE,UAAU,GAAG,SAAS,CAAc;IAG1D,WAAW,SAAK;IAGhB,KAAK,UAAQ;IAGb,YAAY,SAAK;IAGjB,KAAK,UAAS;IAGd,cAAc,EAAE,OAAO,GAAG,KAAK,GAAG,QAAQ,GAAG,QAAQ,CAAY;IAGjE,YAAY,SAAM;IAGlB,IAAI,CAAC,EAAE,OAAO,GAAG,QAAQ,GAAG,MAAM,CAAC;IAEnC,oFAAoF;IAEpF,QAAQ,CAAC,EAAE,YAAY,GAAG,UAAU,GAAG,MAAM,CAAC;IAE9C,6EAA6E;IAE7E,eAAe,SAAK;IAEpB,iFAAiF;IAEjF,cAAc,UAAQ;IAGtB,WAAW,UAAS;IAGpB,OAAO,CAAC,YAAY,CAAC,CAAc;IAGnC,OAAO,CAAC,YAAY,CAAC,CAAc;IAEnC,OAAO,CAAC,aAAa,CAAgD;IACrE,OAAO,CAAC,OAAO,CAAC,CAAa;IAC7B,sEAAsE;IACtE,OAAO,CAAC,uBAAuB,CAAS;IACxC,OAAO,CAAC,gBAAgB,CAAK;IAEpB,oBAAoB,IAAI,IAAI;IAK5B,OAAO,CAAC,OAAO,EAAE,cAAc,GAAG,IAAI;IAqB/C,6DAA6D;IAC7D,UAAU,IAAI,IAAI;IAQlB;;;OAGG;YACW,eAAe;IAiM7B,OAAO,CAAC,MAAM;IAed;;;;OAIG;YACW,qBAAqB;IAuCnC,OAAO,CAAC,aAAa;YAoBP,kBAAkB;IAShC,wGAAwG;IACxG,OAAO,CAAC,mBAAmB;IAI3B,wDAAwD;IACxD,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IA0BrB,iFAAiF;IACjF,kBAAkB,IAAI,IAAI;IAO1B,mCAAmC;IAC7B,WAAW,IAAI,OAAO,CAAC,IAAI,CAAC;IAIlC,OAAO,CAAC,KAAK;IA2Bb,2EAA2E;IAC3E,iBAAiB,IAAI,WAAW,GAAG,IAAI;IAkBvC,OAAO,CAAC,iBAAiB;IAsEhB,MAAM;CA8BlB;AAED,OAAO,CAAC,MAAM,CAAC;IACX,UAAU,qBAAqB;QAC3B,UAAU,EAAE,OAAO,CAAC;KACvB;CACJ"}

package/dist/components/popup/pk-popup.js

@@ -1,2 +1,2 @@
-import { t as PkPopup } from "../../chunks/pk-popup-B9AgBC2V.js";
+import { t as PkPopup } from "../../chunks/pk-popup-B65tZMQH.js";
 export { PkPopup };

package/dist/components/popup.js

@@ -1,2 +1,2 @@
-import { t as PkPopup } from "../chunks/pk-popup-B9AgBC2V.js";
+import { t as PkPopup } from "../chunks/pk-popup-B65tZMQH.js";
 export { PkPopup };

package/dist/components/radio-group/pk-radio-group.js

@@ -1,2 +1,2 @@
-import { t as PkRadioGroup } from "../../chunks/pk-radio-group-BRJIjOsR.js";
+import { t as PkRadioGroup } from "../../chunks/pk-radio-group-ByrxGLdX.js";
 export { PkRadioGroup };

package/dist/components/radio-group/pk-radio.js

@@ -1,2 +1,2 @@
-import { t as PkRadio } from "../../chunks/pk-radio-BK4D2Htu.js";
+import { t as PkRadio } from "../../chunks/pk-radio-B5XkMHy3.js";
 export { PkRadio };

package/dist/components/radio-group.js

@@ -1,3 +1,3 @@
-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";
 export { PkRadio, PkRadioGroup };

package/dist/components/scroll-area/pk-scroll-area.js

@@ -1,2 +1,2 @@
-import { t as PkScrollArea } from "../../chunks/pk-scroll-area-BR6ckorh.js";
+import { t as PkScrollArea } from "../../chunks/pk-scroll-area-CdfNxYz8.js";
 export { PkScrollArea };

package/dist/components/scroll-area.js

@@ -1,2 +1,2 @@
-import { t as PkScrollArea } from "../chunks/pk-scroll-area-BR6ckorh.js";
+import { t as PkScrollArea } from "../chunks/pk-scroll-area-CdfNxYz8.js";
 export { PkScrollArea };

package/dist/components/select/pk-option-group.d.ts

@@ -1,6 +1,6 @@
 import { PkElement } from '../../base/pk-element.js';
 /**
- * Visual option group for `pk-select` —  listbox grouping pattern.
+ * Visual option group for `pk-select` — listbox grouping pattern.
  *
  * @slot - `pk-option` items in this group
  *
@@ -8,7 +8,9 @@ import { PkElement } from '../../base/pk-element.js';
  */
 export declare class PkOptionGroup extends PkElement {
     static styles: import('lit').CSSResult;
+    /** Visible group heading above the options. */
     label: string;
+    /** Hides the group and its options. */
     hidden: boolean;
     private readonly labelId;
     connectedCallback(): void;

package/dist/components/select/pk-option-group.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"pk-option-group.d.ts","sourceRoot":"","sources":["../../../src/components/select/pk-option-group.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,SAAS,EAAE,MAAM,0BAA0B,CAAC;AAIrD;;;;;;GAMG;AACH,qBACa,aAAc,SAAQ,SAAS;IACxC,OAAgB,MAAM,0BAAuB;IAG7C,KAAK,SAAM;IAGX,MAAM,UAAS;IAEf,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAqC;IAEpD,iBAAiB,IAAI,IAAI;IAMzB,MAAM;CAQlB;AAED,OAAO,CAAC,MAAM,CAAC;IACX,UAAU,qBAAqB;QAC3B,iBAAiB,EAAE,aAAa,CAAC;KACpC;CACJ"}
+{"version":3,"file":"pk-option-group.d.ts","sourceRoot":"","sources":["../../../src/components/select/pk-option-group.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,SAAS,EAAE,MAAM,0BAA0B,CAAC;AAIrD;;;;;;GAMG;AACH,qBACa,aAAc,SAAQ,SAAS;IACxC,OAAgB,MAAM,0BAAuB;IAE7C,+CAA+C;IAE/C,KAAK,SAAM;IAEX,uCAAuC;IAEvC,MAAM,UAAS;IAEf,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAqC;IAEpD,iBAAiB,IAAI,IAAI;IAMzB,MAAM;CAQlB;AAED,OAAO,CAAC,MAAM,CAAC;IACX,UAAU,qBAAqB;QAC3B,iBAAiB,EAAE,aAAa,CAAC;KACpC;CACJ"}

package/dist/components/select/pk-option-group.js

@@ -1,2 +1,2 @@
-import { t as PkOptionGroup } from "../../chunks/pk-option-group-Cs6N7mlP.js";
+import { t as PkOptionGroup } from "../../chunks/pk-option-group-CCzJkBFp.js";
 export { PkOptionGroup };

package/dist/components/select/pk-option.d.ts

@@ -1,6 +1,6 @@
 import { PkElement } from '../../base/pk-element.js';
 /**
- * Select option — use inside `pk-select` or `pk-combobox`.
+ * Select option — use inside `pk-select`, `pk-combobox`, or `pk-autocomplete`.
  *
  * @slot start - Presentational decoration before the label (e.g. `pk-status`).
  * @slot - Option label
@@ -9,23 +9,32 @@ import { PkElement } from '../../base/pk-element.js';
  * @csspart option - Option button
  * @csspart label - Option label
  * @csspart check - Selected-state check indicator
+ *
+ * @event pk-option-select - Emitted when the option is activated (click / Enter).
+ * @event pk-option-highlight - Emitted when the option becomes the highlighted item.
  */
 export declare class PkOption extends PkElement {
     static styles: import('lit').CSSResult;
+    /** Option value submitted / emitted when selected. */
     value: string;
     /**
      * Optional short label for the closed trigger / filter identity (v1 itemToStringLabel).
      * When set, preferred over concatenating rich default-slot text (title + subtitle).
      */
     label: string;
+    /** Disables the option so it cannot be selected. */
     disabled: boolean;
+    /** Whether this option is currently selected. */
     selected: boolean;
+    /** Keyboard / pointer highlight within the listbox. */
     highlighted: boolean;
+    /** Hides the option from the list (e.g. filtered combobox results). */
     hidden: boolean;
     focusIndex: number;
     optionId: string;
     /** When set, the label renders with matching query text highlighted (combobox filter). */
     matchQuery: string;
+    /** Focus the option’s inner control (listbox keyboard navigation). */
     focusControl(preventScroll?: boolean): void;
     /**
      * Label for the closed combobox/select value.

package/dist/components/select/pk-option.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"pk-option.d.ts","sourceRoot":"","sources":["../../../src/components/select/pk-option.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,SAAS,EAAE,MAAM,0BAA0B,CAAC;AAMrD;;;;;;;;;;GAUG;AACH,qBACa,QAAS,SAAQ,SAAS;IACnC,OAAgB,MAAM,0BAAkB;IAGxC,KAAK,SAAM;IAEX;;;OAGG;IAEH,KAAK,SAAM;IAGX,QAAQ,UAAS;IAGjB,QAAQ,UAAS;IAGjB,WAAW,UAAS;IAGpB,MAAM,UAAS;IAGf,UAAU,SAAM;IAGhB,QAAQ,SAAM;IAEd,0FAA0F;IAE1F,UAAU,SAAM;IAEhB,YAAY,CAAC,aAAa,UAAO,GAAG,IAAI;IAIxC;;;;OAIG;IACH,QAAQ,IAAI,MAAM;IAoBlB,+EAA+E;IAC/E,aAAa,IAAI,MAAM;IAgBvB,0FAA0F;IAC1F,OAAO,CAAC,mBAAmB;IAW3B,gEAAgE;IAChE,gBAAgB,IAAI,WAAW,EAAE;IAMxB,YAAY,IAAI,IAAI;IAO7B,OAAO,CAAC,mBAAmB;IAI3B,OAAO,CAAC,WAAW;IAYnB,OAAO,CAAC,gBAAgB;IAYxB,OAAO,CAAC,aAAa;IAwCrB,OAAO,CAAC,WAAW;IAwBV,MAAM;CAwBlB;AAED,OAAO,CAAC,MAAM,CAAC;IACX,UAAU,qBAAqB;QAC3B,WAAW,EAAE,QAAQ,CAAC;KACzB;CACJ"}
+{"version":3,"file":"pk-option.d.ts","sourceRoot":"","sources":["../../../src/components/select/pk-option.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,SAAS,EAAE,MAAM,0BAA0B,CAAC;AAMrD;;;;;;;;;;;;;GAaG;AACH,qBACa,QAAS,SAAQ,SAAS;IACnC,OAAgB,MAAM,0BAAkB;IAExC,sDAAsD;IAEtD,KAAK,SAAM;IAEX;;;OAGG;IAEH,KAAK,SAAM;IAEX,oDAAoD;IAEpD,QAAQ,UAAS;IAEjB,iDAAiD;IAEjD,QAAQ,UAAS;IAEjB,uDAAuD;IAEvD,WAAW,UAAS;IAEpB,uEAAuE;IAEvE,MAAM,UAAS;IAGf,UAAU,SAAM;IAGhB,QAAQ,SAAM;IAEd,0FAA0F;IAE1F,UAAU,SAAM;IAEhB,sEAAsE;IACtE,YAAY,CAAC,aAAa,UAAO,GAAG,IAAI;IAIxC;;;;OAIG;IACH,QAAQ,IAAI,MAAM;IAoBlB,+EAA+E;IAC/E,aAAa,IAAI,MAAM;IAgBvB,0FAA0F;IAC1F,OAAO,CAAC,mBAAmB;IAW3B,gEAAgE;IAChE,gBAAgB,IAAI,WAAW,EAAE;IAMxB,YAAY,IAAI,IAAI;IAO7B,OAAO,CAAC,mBAAmB;IAI3B,OAAO,CAAC,WAAW;IAYnB,OAAO,CAAC,gBAAgB;IAYxB,OAAO,CAAC,aAAa;IAwCrB,OAAO,CAAC,WAAW;IAwBV,MAAM;CAwBlB;AAED,OAAO,CAAC,MAAM,CAAC;IACX,UAAU,qBAAqB;QAC3B,WAAW,EAAE,QAAQ,CAAC;KACzB;CACJ"}

package/dist/components/select/pk-option.js

@@ -1,2 +1,2 @@
-import { t as PkOption } from "../../chunks/pk-option-MGj9SKOK.js";
+import { t as PkOption } from "../../chunks/pk-option-DQZHV9jL.js";
 export { PkOption };

package/dist/components/select/pk-select.d.ts

@@ -5,7 +5,7 @@ import { PkValidator } from '../../validators/types.js';
 import { PkPopupPlacement } from '../popup/pk-popup.js';
 export type PkSelectSize = 'xs' | 'sm' | 'default' | 'lg' | 'xl';
 /**
- * Select —  pattern: slotted `pk-option` children, form-associated, clearable, multiselect tags.
+ * Select — slotted `pk-option` children, form-associated, clearable, multiselect tags.
  *
  * @slot start - Presentational decoration before the trigger label (e.g. icons)
  * @slot end - Presentational decoration before the expand chevron
@@ -17,28 +17,65 @@ export type PkSelectSize = 'xs' | 'sm' | 'default' | 'lg' | 'xl';
  * @csspart trigger-start - Mirrored start decoration from the selected option
  * @csspart trigger - Select trigger button
  * @csspart panel - Listbox panel
+ *
+ * @cssproperty [--pk-select-fill=var(--pk-color-slate-250)] - Closed trigger background.
+ * @cssproperty [--pk-select-fill-hover=var(--pk-color-slate-300)] - Closed trigger hover background.
+ * @cssproperty [--pk-select-anchor-width] - Panel min-width; set from the trigger width while open.
+ * @cssproperty [--pk-select-decoration-size=0.875rem] - Start/end decoration glyph size.
+ *
+ * @event pk-show - Emitted when the listbox begins to open.
+ * @event pk-after-show - Emitted after the listbox opens and enter motion finishes.
+ * @event {{ source: string }} pk-hide - Emitted when the listbox begins to close (cancelable).
+ * @event pk-after-hide - Emitted after the listbox closes and exit motion finishes.
+ * @event {{ open: boolean }} pk-open-change - Emitted when `open` changes after show/hide settles.
+ * @event {{ value: string, values: string[] }} pk-change - Emitted when the selection changes.
+ * @event pk-clear - Emitted when the value is cleared via the clear control.
+ * @event pk-invalid - Emitted when constraint validation fails.
+ * @event input - Native input event when the selection changes.
+ * @event change - Native change event when the selection changes.
+ *
+ * @method show - Opens the listbox.
+ * @method hide - Closes the listbox.
+ * @method checkValidity - Runs constraint validation without showing the browser UI.
+ * @method reportValidity - Runs constraint validation and shows the browser UI when invalid.
+ * @method setCustomValidity - Sets or clears a custom validation message.
+ * @method resetValidity - Clears custom errors and re-syncs validity state.
+ *
+ * @dependency pk-popup - Positioned listbox panel host.
  */
 export declare class PkSelect extends PkFormAssociatedElement {
     static styles: import('lit').CSSResult[];
     static get validators(): PkValidator[];
     assumeInteractionOn: string[];
+    /** Whether the listbox is open. Prefer `show()` / `hide()` for animated transitions. */
     open: boolean;
+    /** Allow more than one option to be selected (tag display). */
     multiple: boolean;
+    /** Preferred listbox placement; may flip to stay in viewport. */
     placement: PkPopupPlacement;
-    /** Gap between the trigger and listbox panel in px (default: 4). */
+    /** Gap between the trigger and listbox panel in px. */
     sideOffset: number;
+    /** Alias of `with-clear` — shows a clear control when the value is non-empty. */
     clearable: boolean;
+    /** Shows a clear control when the value is non-empty. */
     withClear: boolean;
+    /** Marks the control invalid (visual + ARIA). */
     invalid: boolean;
+    /** Shared CP size scale for the closed trigger and list items. */
     size: PkSelectSize;
     /** When `full`, the trigger stretches to the host width. */
     width?: 'full';
-    /** Empty by default — consumers opt in when a prompt is useful. */
+    /** Prompt shown when nothing is selected. Empty by default. */
     placeholder: string;
+    /** Selected value (single-select). Empty string when cleared. */
     value: string;
+    /** Initial value before user interaction (form reset baseline). */
     defaultValue: string;
+    /** Selected values when `multiple` is set. Property-only (not an attribute). */
     values: string[];
+    /** Initial multi values before user interaction. Property-only. */
     defaultValues: string[];
+    /** Accessible name for the trigger when no visible label is present. */
     ariaLabel: string | null;
     /**
      * Whether arrow-key focus loops from the last option back to the first (and vice versa).
@@ -99,7 +136,9 @@ export declare class PkSelect extends PkFormAssociatedElement {
     private togglePanel;
     private getPopupAnchor;
     private getActiveDescendantId;
+    /** Opens the listbox. */
     show(): Promise<void>;
+    /** Closes the listbox. */
     hide(source?: PkOverlaySource): Promise<void>;
     private openPanel;
     private closePanel;