@verbb/plugin-kit-web 2.0.0

package/dist/chunks/control-aria-B2QMq4ji.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"control-aria-B2QMq4ji.js","names":[],"sources":["../../src/internal/control-aria.ts"],"sourcesContent":["/** ARIA attributes mirrored from a field shell host onto the focusable native control. */\nexport const MIRRORED_ARIA_ATTRIBUTES = [\n    'aria-labelledby',\n    'aria-describedby',\n    'aria-invalid',\n    'aria-errormessage',\n    'aria-required',\n    'aria-label',\n] as const;\n\n/** True when a parent `pk-field` (or similar) has wired external field chrome. */\nexport function hasExternalFieldAria(host: Element): boolean {\n    return host.hasAttribute('aria-labelledby')\n        || host.hasAttribute('aria-describedby')\n        || host.hasAttribute('aria-errormessage');\n}\n\n/** Copy mirrored ARIA attributes from `source` onto `target`. */\nexport function mirrorAriaAttributes(source: Element, target: Element): void {\n    for (const name of MIRRORED_ARIA_ATTRIBUTES) {\n        const value = source.getAttribute(name);\n\n        if (value !== null) {\n            target.setAttribute(name, value);\n        } else {\n            target.removeAttribute(name);\n        }\n    }\n}\n\nexport type StandaloneControlAriaOptions = {\n    control: HTMLElement;\n    labelId?: string;\n    instructionsId?: string;\n    hasLabel: boolean;\n    hasInstructions: boolean;\n    required?: boolean;\n    invalid?: boolean;\n};\n\n/** Wire label/instructions/required/invalid for standalone controls ( internal layout). */\nexport function syncStandaloneControlAria({\n    control,\n    labelId,\n    instructionsId,\n    hasLabel,\n    hasInstructions,\n    required = false,\n    invalid = false,\n}: StandaloneControlAriaOptions): void {\n    if (hasLabel && labelId) {\n        control.setAttribute('aria-labelledby', labelId);\n    } else {\n        control.removeAttribute('aria-labelledby');\n    }\n\n    if (hasInstructions && instructionsId) {\n        control.setAttribute('aria-describedby', instructionsId);\n    } else {\n        control.removeAttribute('aria-describedby');\n    }\n\n    if (required) {\n        control.setAttribute('aria-required', 'true');\n    } else {\n        control.removeAttribute('aria-required');\n    }\n\n    if (invalid) {\n        control.setAttribute('aria-invalid', 'true');\n    } else {\n        control.removeAttribute('aria-invalid');\n    }\n\n    control.removeAttribute('aria-errormessage');\n}\n\n/** Observes host ARIA attribute changes and mirrors them to a focusable inner control. */\nexport class HostAriaMirror {\n    private observer?: MutationObserver;\n\n    constructor(\n        private readonly host: HTMLElement,\n        private readonly getTarget: () => HTMLElement | null | undefined,\n        private readonly onSync?: () => void,\n    ) {}\n\n    connect(): void {\n        this.sync();\n\n        this.observer = new MutationObserver(() => {\n            this.sync();\n        });\n\n        this.observer.observe(this.host, {\n            attributes: true,\n            attributeFilter: [...MIRRORED_ARIA_ATTRIBUTES],\n        });\n    }\n\n    disconnect(): void {\n        this.observer?.disconnect();\n        this.observer = undefined;\n    }\n\n    sync(): void {\n        if (!hasExternalFieldAria(this.host)) {\n            this.onSync?.();\n            return;\n        }\n\n        const target = this.getTarget();\n\n        if (!target) {\n            return;\n        }\n\n        mirrorAriaAttributes(this.host, target);\n    }\n}\n\n/** Mirror host ARIA onto the first slotted input/textarea inside a group wrapper. */\nexport function mirrorHostAriaToSlottedControl(host: HTMLElement, slot: HTMLSlotElement): void {\n    if (!hasExternalFieldAria(host)) {\n        return;\n    }\n\n    const [control] = slot.assignedElements({ flatten: true }).filter((element) => {\n        if (!(element instanceof HTMLElement)) {\n            return false;\n        }\n\n        if (element.matches('pk-input-group-input, pk-input-group-textarea')) {\n            return true;\n        }\n\n        return element.querySelector('input, textarea, select') instanceof HTMLElement;\n    });\n\n    if (!(control instanceof HTMLElement)) {\n        return;\n    }\n\n    const target = control.matches('pk-input-group-input, pk-input-group-textarea')\n        ? control.shadowRoot?.querySelector('input, textarea') ?? control.querySelector('input, textarea')\n        : control.querySelector('input, textarea, select, button[aria-haspopup]');\n\n    if (target instanceof HTMLElement) {\n        mirrorAriaAttributes(host, target);\n    }\n}\n"],"mappings":";;AACA,IAAa,2BAA2B;CACpC;CACA;CACA;CACA;CACA;CACA;CACH;;AAGD,SAAgB,qBAAqB,MAAwB;AACzD,QAAO,KAAK,aAAa,kBAAkB,IACpC,KAAK,aAAa,mBAAmB,IACrC,KAAK,aAAa,oBAAoB;;;AAIjD,SAAgB,qBAAqB,QAAiB,QAAuB;AACzE,MAAK,MAAM,QAAQ,0BAA0B;EACzC,MAAM,QAAQ,OAAO,aAAa,KAAK;AAEvC,MAAI,UAAU,KACV,QAAO,aAAa,MAAM,MAAM;MAEhC,QAAO,gBAAgB,KAAK;;;;AAgBxC,SAAgB,0BAA0B,EACtC,SACA,SACA,gBACA,UACA,iBACA,WAAW,OACX,UAAU,SACyB;AACnC,KAAI,YAAY,QACZ,SAAQ,aAAa,mBAAmB,QAAQ;KAEhD,SAAQ,gBAAgB,kBAAkB;AAG9C,KAAI,mBAAmB,eACnB,SAAQ,aAAa,oBAAoB,eAAe;KAExD,SAAQ,gBAAgB,mBAAmB;AAG/C,KAAI,SACA,SAAQ,aAAa,iBAAiB,OAAO;KAE7C,SAAQ,gBAAgB,gBAAgB;AAG5C,KAAI,QACA,SAAQ,aAAa,gBAAgB,OAAO;KAE5C,SAAQ,gBAAgB,eAAe;AAG3C,SAAQ,gBAAgB,oBAAoB;;;AAIhD,IAAa,iBAAb,MAA4B;CAGxB,YACI,MACA,WACA,QACF;AAHmB,OAAA,OAAA;AACA,OAAA,YAAA;AACA,OAAA,SAAA;;CAGrB,UAAgB;AACZ,OAAK,MAAM;AAEX,OAAK,WAAW,IAAI,uBAAuB;AACvC,QAAK,MAAM;IACb;AAEF,OAAK,SAAS,QAAQ,KAAK,MAAM;GAC7B,YAAY;GACZ,iBAAiB,CAAC,GAAG,yBAAyB;GACjD,CAAC;;CAGN,aAAmB;AACf,OAAK,UAAU,YAAY;AAC3B,OAAK,WAAW,KAAA;;CAGpB,OAAa;AACT,MAAI,CAAC,qBAAqB,KAAK,KAAK,EAAE;AAClC,QAAK,UAAU;AACf;;EAGJ,MAAM,SAAS,KAAK,WAAW;AAE/B,MAAI,CAAC,OACD;AAGJ,uBAAqB,KAAK,MAAM,OAAO"}

package/dist/chunks/decorate-W02hmVTt.js

@@ -0,0 +1,149 @@
+import { LitElement, css, unsafeCSS } from "lit";
+//#region src/base/styles.ts
+var sharedStyleSheets = /* @__PURE__ */ new Map();
+/**
+* Share constructable stylesheets across component instances ( pattern).
+* Falls back to an injected `<style>` tag when adoptedStyleSheets aren't supported.
+*/
+function adoptStyles(shadowRoot, styleResults, cacheKey) {
+	const cssText = styleResults.flatMap((result) => Array.isArray(result) ? result : [result]).map((result) => {
+		if ("cssText" in result && typeof result.cssText === "string") return result.cssText;
+		return unsafeCSS(result).cssText;
+	}).join("\n");
+	if (!("adoptedStyleSheets" in Document.prototype) || typeof CSSStyleSheet === "undefined") {
+		const styleKey = cacheKey ?? String(styleResults.length);
+		if (!shadowRoot.querySelector(`style[data-pk-adopted-styles="${styleKey}"]`)) {
+			const style = document.createElement("style");
+			style.dataset.pkAdoptedStyles = styleKey;
+			style.textContent = cssText;
+			shadowRoot.prepend(style);
+		}
+		return;
+	}
+	const key = cacheKey ?? cssText;
+	let sheet = sharedStyleSheets.get(key);
+	if (!sheet) {
+		sheet = new CSSStyleSheet();
+		sheet.replaceSync(cssText);
+		sharedStyleSheets.set(key, sheet);
+	}
+	shadowRoot.adoptedStyleSheets = [...shadowRoot.adoptedStyleSheets, sheet];
+}
+var hostDisplayInlineBlock = css`
+    @layer pk-component {
+        :host {
+            display: inline-block;
+            vertical-align: middle;
+        }
+    }
+`;
+css`
+    .pk-focus-ring:focus {
+        outline: none;
+    }
+
+    .pk-focus-ring:focus-visible {
+        box-shadow: var(--pk-shadow-focus);
+    }
+`;
+//#endregion
+//#region src/base/shadow-reset.styles.ts
+/**
+* Shadow-root baseline — box model + inherited typography inside every pk-* component.
+* Applied via PkElement.createRenderRoot(); does not replace per-component styles.
+*/
+var shadowResetStyles = css`
+    @layer pk-reset {
+        :host {
+            box-sizing: border-box;
+        }
+
+        :host *,
+        :host *::before,
+        :host *::after {
+            box-sizing: border-box;
+        }
+
+        :host(:not([hidden])) {
+            /* Prevent UA / CP margin on unstyled custom element hosts in light DOM. */
+            margin: 0;
+        }
+    }
+`;
+//#endregion
+//#region src/base/pk-element.ts
+/**
+* Base class for Plugin Kit web components.
+* Open shadow root; Lit adopts constructable stylesheets where supported.
+*
+* `performUpdate` is wrapped so a single control failure degrades inline instead of
+* taking down the whole CP surface (React error boundaries do not see Lit throws).
+*/
+var PkElement = class extends LitElement {
+	constructor(..._args) {
+		super(..._args);
+		this.pkRenderFailed = false;
+	}
+	static {
+		this.shadowRootOptions = {
+			mode: "open",
+			delegatesFocus: true
+		};
+	}
+	connectedCallback() {
+		super.connectedCallback();
+		if (!this.hasAttribute("data-pk")) this.setAttribute("data-pk", "");
+	}
+	createRenderRoot() {
+		const root = super.createRenderRoot();
+		adoptStyles(root, [shadowResetStyles], "pk-shadow-reset");
+		return root;
+	}
+	performUpdate() {
+		if (this.pkRenderFailed) return;
+		try {
+			const result = super.performUpdate();
+			if (result instanceof Promise) result.catch((error) => {
+				this.handleRenderFailure(error);
+			});
+		} catch (error) {
+			this.handleRenderFailure(error);
+		}
+	}
+	handleRenderFailure(error) {
+		const err = error instanceof Error ? error : new Error(String(error));
+		this.pkRenderFailed = true;
+		this.dispatchEvent(new CustomEvent("pk-error", {
+			detail: {
+				tagName: this.localName || this.tagName.toLowerCase(),
+				message: err.message,
+				stack: err.stack
+			},
+			bubbles: true,
+			composed: true
+		}));
+		try {
+			const root = this.renderRoot;
+			if (root) {
+				root.textContent = "";
+				const shell = document.createElement("div");
+				shell.setAttribute("part", "error");
+				shell.setAttribute("role", "alert");
+				shell.textContent = "This control failed to load.";
+				root.appendChild(shell);
+			}
+		} catch {}
+	}
+};
+//#endregion
+//#region \0@oxc-project+runtime@0.127.0/helpers/decorate.js
+function __decorate(decorators, target, key, desc) {
+	var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+	if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+	else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+	return c > 3 && r && Object.defineProperty(target, key, r), r;
+}
+//#endregion
+export { PkElement as n, hostDisplayInlineBlock as r, __decorate as t };
+
+//# sourceMappingURL=decorate-W02hmVTt.js.map

package/dist/chunks/decorate-W02hmVTt.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"decorate-W02hmVTt.js","names":[],"sources":["../../src/base/styles.ts","../../src/base/shadow-reset.styles.ts","../../src/base/pk-element.ts"],"sourcesContent":["import { css, unsafeCSS, type CSSResultGroup } from 'lit';\n\nconst sharedStyleSheets = new Map<string, CSSStyleSheet>();\n\n/**\n * Share constructable stylesheets across component instances ( pattern).\n * Falls back to an injected `<style>` tag when adoptedStyleSheets aren't supported.\n */\nexport function adoptStyles(\n    shadowRoot: ShadowRoot,\n    styleResults: CSSResultGroup[],\n    cacheKey?: string,\n): void {\n    const cssText = styleResults\n        .flatMap((result) => (Array.isArray(result) ? result : [result]))\n        .map((result) => {\n            if ('cssText' in result && typeof result.cssText === 'string') {\n                return result.cssText;\n            }\n\n            return unsafeCSS(result).cssText;\n        })\n        .join('\\n');\n\n    if (!('adoptedStyleSheets' in Document.prototype) || typeof CSSStyleSheet === 'undefined') {\n        const styleKey = cacheKey ?? String(styleResults.length);\n\n        if (!shadowRoot.querySelector(`style[data-pk-adopted-styles=\"${styleKey}\"]`)) {\n            const style = document.createElement('style');\n            style.dataset.pkAdoptedStyles = styleKey;\n            style.textContent = cssText;\n            shadowRoot.prepend(style);\n        }\n\n        return;\n    }\n\n    const key = cacheKey ?? cssText;\n    let sheet = sharedStyleSheets.get(key);\n\n    if (!sheet) {\n        sheet = new CSSStyleSheet();\n        sheet.replaceSync(cssText);\n        sharedStyleSheets.set(key, sheet);\n    }\n\n    shadowRoot.adoptedStyleSheets = [...shadowRoot.adoptedStyleSheets, sheet];\n}\n\nexport const hostDisplayInlineBlock = css`\n    @layer pk-component {\n        :host {\n            display: inline-block;\n            vertical-align: middle;\n        }\n    }\n`;\n\nexport const focusRing = css`\n    .pk-focus-ring:focus {\n        outline: none;\n    }\n\n    .pk-focus-ring:focus-visible {\n        box-shadow: var(--pk-shadow-focus);\n    }\n`;\n","import { css } from 'lit';\n\n/**\n * Shadow-root baseline — box model + inherited typography inside every pk-* component.\n * Applied via PkElement.createRenderRoot(); does not replace per-component styles.\n */\nexport const shadowResetStyles = css`\n    @layer pk-reset {\n        :host {\n            box-sizing: border-box;\n        }\n\n        :host *,\n        :host *::before,\n        :host *::after {\n            box-sizing: border-box;\n        }\n\n        :host(:not([hidden])) {\n            /* Prevent UA / CP margin on unstyled custom element hosts in light DOM. */\n            margin: 0;\n        }\n    }\n`;\n","import { LitElement } from 'lit';\n\nimport { adoptStyles } from './styles.js';\nimport { shadowResetStyles } from './shadow-reset.styles.js';\n\nexport type PkElementErrorDetail = {\n    tagName: string;\n    message: string;\n    stack?: string;\n};\n\ndeclare global {\n    interface GlobalEventHandlersEventMap {\n        'pk-error': CustomEvent<PkElementErrorDetail>;\n    }\n}\n\n/**\n * Base class for Plugin Kit web components.\n * Open shadow root; Lit adopts constructable stylesheets where supported.\n *\n * `performUpdate` is wrapped so a single control failure degrades inline instead of\n * taking down the whole CP surface (React error boundaries do not see Lit throws).\n */\nexport class PkElement extends LitElement {\n    static override shadowRootOptions: ShadowRootInit = {\n        mode: 'open',\n        delegatesFocus: true,\n    };\n\n    /** When set, subclasses should skip normal render — base shows a minimal error shell. */\n    protected pkRenderFailed = false;\n\n    override connectedCallback(): void {\n        super.connectedCallback();\n        // Host marker for document/shadow peers (e.g. Tailwind preflight). Must not set\n        // attributes in the constructor — CE rules forbid that on createElement().\n        if (!this.hasAttribute('data-pk')) {\n            this.setAttribute('data-pk', '');\n        }\n    }\n\n    override createRenderRoot(): HTMLElement | DocumentFragment {\n        const root = super.createRenderRoot();\n        adoptStyles(root as ShadowRoot, [shadowResetStyles], 'pk-shadow-reset');\n        return root;\n    }\n\n    override performUpdate(): void {\n        if (this.pkRenderFailed) {\n            return;\n        }\n\n        try {\n            const result = super.performUpdate();\n\n            // Lit deprecates returning a Promise from performUpdate — handle async render\n            // failures without making this override async (avoids dev-mode update-queue bugs).\n            // Lit may return void; keep a Promise guard for older async performUpdate paths.\n            if ((result as unknown) instanceof Promise) {\n                void (result as Promise<unknown>).catch((error: unknown) => {\n                    this.handleRenderFailure(error);\n                });\n            }\n        } catch (error) {\n            this.handleRenderFailure(error);\n        }\n    }\n\n    protected handleRenderFailure(error: unknown): void {\n        const err = error instanceof Error ? error : new Error(String(error));\n        this.pkRenderFailed = true;\n\n        this.dispatchEvent(\n            new CustomEvent<PkElementErrorDetail>('pk-error', {\n                detail: {\n                    tagName: this.localName || this.tagName.toLowerCase(),\n                    message: err.message,\n                    stack: err.stack,\n                },\n                bubbles: true,\n                composed: true,\n            }),\n        );\n\n        // Last-resort inline fallback — plain DOM so we do not recurse through Lit render().\n        try {\n            const root = this.renderRoot as ShadowRoot | HTMLElement | undefined;\n\n            if (root) {\n                root.textContent = '';\n                const shell = document.createElement('div');\n                shell.setAttribute('part', 'error');\n                shell.setAttribute('role', 'alert');\n                shell.textContent = 'This control failed to load.';\n                root.appendChild(shell);\n            }\n        } catch {\n            /* never throw from the error handler */\n        }\n    }\n}\n"],"mappings":";;AAEA,IAAM,oCAAoB,IAAI,KAA4B;;;;;AAM1D,SAAgB,YACZ,YACA,cACA,UACI;CACJ,MAAM,UAAU,aACX,SAAS,WAAY,MAAM,QAAQ,OAAO,GAAG,SAAS,CAAC,OAAO,CAAE,CAChE,KAAK,WAAW;AACb,MAAI,aAAa,UAAU,OAAO,OAAO,YAAY,SACjD,QAAO,OAAO;AAGlB,SAAO,UAAU,OAAO,CAAC;GAC3B,CACD,KAAK,KAAK;AAEf,KAAI,EAAE,wBAAwB,SAAS,cAAc,OAAO,kBAAkB,aAAa;EACvF,MAAM,WAAW,YAAY,OAAO,aAAa,OAAO;AAExD,MAAI,CAAC,WAAW,cAAc,iCAAiC,SAAS,IAAI,EAAE;GAC1E,MAAM,QAAQ,SAAS,cAAc,QAAQ;AAC7C,SAAM,QAAQ,kBAAkB;AAChC,SAAM,cAAc;AACpB,cAAW,QAAQ,MAAM;;AAG7B;;CAGJ,MAAM,MAAM,YAAY;CACxB,IAAI,QAAQ,kBAAkB,IAAI,IAAI;AAEtC,KAAI,CAAC,OAAO;AACR,UAAQ,IAAI,eAAe;AAC3B,QAAM,YAAY,QAAQ;AAC1B,oBAAkB,IAAI,KAAK,MAAM;;AAGrC,YAAW,qBAAqB,CAAC,GAAG,WAAW,oBAAoB,MAAM;;AAG7E,IAAa,yBAAyB,GAAG;;;;;;;;AAShB,GAAG;;;;;;;;;;;;;;;ACpD5B,IAAa,oBAAoB,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;ACkBpC,IAAa,YAAb,cAA+B,WAAW;;;wBAOX;;;2BANyB;GAChD,MAAM;GACN,gBAAgB;GACnB;;CAKD,oBAAmC;AAC/B,QAAM,mBAAmB;AAGzB,MAAI,CAAC,KAAK,aAAa,UAAU,CAC7B,MAAK,aAAa,WAAW,GAAG;;CAIxC,mBAA4D;EACxD,MAAM,OAAO,MAAM,kBAAkB;AACrC,cAAY,MAAoB,CAAC,kBAAkB,EAAE,kBAAkB;AACvE,SAAO;;CAGX,gBAA+B;AAC3B,MAAI,KAAK,eACL;AAGJ,MAAI;GACA,MAAM,SAAS,MAAM,eAAe;AAKpC,OAAK,kBAA8B,QACzB,QAA4B,OAAO,UAAmB;AACxD,SAAK,oBAAoB,MAAM;KACjC;WAED,OAAO;AACZ,QAAK,oBAAoB,MAAM;;;CAIvC,oBAA8B,OAAsB;EAChD,MAAM,MAAM,iBAAiB,QAAQ,QAAQ,IAAI,MAAM,OAAO,MAAM,CAAC;AACrE,OAAK,iBAAiB;AAEtB,OAAK,cACD,IAAI,YAAkC,YAAY;GAC9C,QAAQ;IACJ,SAAS,KAAK,aAAa,KAAK,QAAQ,aAAa;IACrD,SAAS,IAAI;IACb,OAAO,IAAI;IACd;GACD,SAAS;GACT,UAAU;GACb,CAAC,CACL;AAGD,MAAI;GACA,MAAM,OAAO,KAAK;AAElB,OAAI,MAAM;AACN,SAAK,cAAc;IACnB,MAAM,QAAQ,SAAS,cAAc,MAAM;AAC3C,UAAM,aAAa,QAAQ,QAAQ;AACnC,UAAM,aAAa,QAAQ,QAAQ;AACnC,UAAM,cAAc;AACpB,SAAK,YAAY,MAAM;;UAEvB"}

package/dist/chunks/dismissible-stack-XQUMfKO3.js

@@ -0,0 +1,32 @@
+//#region src/a11y/dismissible-stack.ts
+/**
+* Dismissible stack — adapted from  internal/dismissible-stack.ts.
+* Ensures only the topmost overlay handles Escape.
+*/
+var dismissibleStack = [];
+function registerDismissible(key) {
+	dismissibleStack.push(key);
+}
+function unregisterDismissible(key) {
+	for (let index = dismissibleStack.length - 1; index >= 0; index -= 1) if (dismissibleStack[index] === key) {
+		dismissibleStack.splice(index, 1);
+		break;
+	}
+}
+function isTopDismissible(key) {
+	return dismissibleStack.length > 0 && dismissibleStack[dismissibleStack.length - 1] === key;
+}
+/** Dev/diagnostic — ordered stack of dismissible overlay hosts (bottom → top). */
+function getDismissibleStackSnapshot() {
+	return dismissibleStack.map((key) => {
+		if (key instanceof HTMLElement) {
+			const id = key.id ? `#${key.id}` : "";
+			return `<${key.localName}${id}>`;
+		}
+		return key.constructor?.name ?? "object";
+	});
+}
+//#endregion
+export { unregisterDismissible as i, isTopDismissible as n, registerDismissible as r, getDismissibleStackSnapshot as t };
+
+//# sourceMappingURL=dismissible-stack-XQUMfKO3.js.map

package/dist/chunks/dismissible-stack-XQUMfKO3.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dismissible-stack-XQUMfKO3.js","names":[],"sources":["../../src/a11y/dismissible-stack.ts"],"sourcesContent":["/**\n * Dismissible stack — adapted from  internal/dismissible-stack.ts.\n * Ensures only the topmost overlay handles Escape.\n */\nconst dismissibleStack: object[] = [];\n\nexport function registerDismissible(key: object): void {\n    dismissibleStack.push(key);\n}\n\nexport function unregisterDismissible(key: object): void {\n    for (let index = dismissibleStack.length - 1; index >= 0; index -= 1) {\n        if (dismissibleStack[index] === key) {\n            dismissibleStack.splice(index, 1);\n            break;\n        }\n    }\n}\n\nexport function isTopDismissible(key: object): boolean {\n    return dismissibleStack.length > 0 && dismissibleStack[dismissibleStack.length - 1] === key;\n}\n\n/** Dev/diagnostic — ordered stack of dismissible overlay hosts (bottom → top). */\nexport function getDismissibleStackSnapshot(): string[] {\n    return dismissibleStack.map((key) => {\n        if (key instanceof HTMLElement) {\n            const id = key.id ? `#${key.id}` : '';\n            return `<${key.localName}${id}>`;\n        }\n\n        return key.constructor?.name ?? 'object';\n    });\n}\n"],"mappings":";;;;;AAIA,IAAM,mBAA6B,EAAE;AAErC,SAAgB,oBAAoB,KAAmB;AACnD,kBAAiB,KAAK,IAAI;;AAG9B,SAAgB,sBAAsB,KAAmB;AACrD,MAAK,IAAI,QAAQ,iBAAiB,SAAS,GAAG,SAAS,GAAG,SAAS,EAC/D,KAAI,iBAAiB,WAAW,KAAK;AACjC,mBAAiB,OAAO,OAAO,EAAE;AACjC;;;AAKZ,SAAgB,iBAAiB,KAAsB;AACnD,QAAO,iBAAiB,SAAS,KAAK,iBAAiB,iBAAiB,SAAS,OAAO;;;AAI5F,SAAgB,8BAAwC;AACpD,QAAO,iBAAiB,KAAK,QAAQ;AACjC,MAAI,eAAe,aAAa;GAC5B,MAAM,KAAK,IAAI,KAAK,IAAI,IAAI,OAAO;AACnC,UAAO,IAAI,IAAI,YAAY,GAAG;;AAGlC,SAAO,IAAI,aAAa,QAAQ;GAClC"}

package/dist/chunks/field-labels-CoU9dnNq.js

@@ -0,0 +1,14 @@
+//#region src/internal/field-labels.ts
+/** Reads the legacy `hint` attribute when `instructions` is empty. */
+function readLegacyInstructions(element, instructions) {
+	if (instructions) return instructions;
+	return element.getAttribute("hint") ?? "";
+}
+/** Whether a named slot (or legacy alias) has content. */
+function hasInstructionContent(hasSlot, instructions, withInstructions = false) {
+	return Boolean(instructions) || hasSlot("instructions", withInstructions) || hasSlot("hint");
+}
+//#endregion
+export { readLegacyInstructions as n, hasInstructionContent as t };
+
+//# sourceMappingURL=field-labels-CoU9dnNq.js.map

package/dist/chunks/field-labels-CoU9dnNq.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"field-labels-CoU9dnNq.js","names":[],"sources":["../../src/internal/field-labels.ts"],"sourcesContent":["/** Reads the legacy `hint` attribute when `instructions` is empty. */\nexport function readLegacyInstructions(element: HTMLElement, instructions: string): string {\n    if (instructions) {\n        return instructions;\n    }\n\n    return element.getAttribute('hint') ?? '';\n}\n\n/** Whether a named slot (or legacy alias) has content. */\nexport function hasInstructionContent(\n    hasSlot: (name: string, flag?: boolean) => boolean,\n    instructions: string,\n    withInstructions = false,\n): boolean {\n    return Boolean(instructions)\n        || hasSlot('instructions', withInstructions)\n        || hasSlot('hint');\n}\n"],"mappings":";;AACA,SAAgB,uBAAuB,SAAsB,cAA8B;AACvF,KAAI,aACA,QAAO;AAGX,QAAO,QAAQ,aAAa,OAAO,IAAI;;;AAI3C,SAAgB,sBACZ,SACA,cACA,mBAAmB,OACZ;AACP,QAAO,QAAQ,aAAa,IACrB,QAAQ,gBAAgB,iBAAiB,IACzC,QAAQ,OAAO"}

package/dist/chunks/focus-aa5dlv8k.js

@@ -0,0 +1,122 @@
+import { n as getDeepestActiveElement } from "./active-elements-BwpXu8Lb.js";
+//#region src/a11y/focus.ts
+var idCounter = 0;
+/** Stable unique id for aria-labelledby / aria-controls wiring inside components. */
+function uniqueId(prefix = "pk") {
+	idCounter += 1;
+	return `${prefix}-${idCounter}`;
+}
+var FOCUSABLE_SELECTOR = [
+	"a[href]",
+	"button:not([disabled])",
+	"input:not([disabled])",
+	"select:not([disabled])",
+	"textarea:not([disabled])",
+	"[tabindex]:not([tabindex=\"-1\"])"
+].join(",");
+var FOCUSABLE_SELECTOR_WITH_DISABLED = [
+	"a[href]",
+	"button",
+	"input",
+	"select",
+	"textarea",
+	"[tabindex]:not([tabindex=\"-1\"])"
+].join(",");
+function isDisplayed(element) {
+	return element.offsetParent !== null || element.getClientRects().length > 0;
+}
+function matchesFocusable(element, includeDisabled) {
+	return element.matches(includeDisabled ? FOCUSABLE_SELECTOR_WITH_DISABLED : FOCUSABLE_SELECTOR);
+}
+/** Walks shadow roots and assigned slot content — required for slotted dialog actions. */
+function gatherFocusableElements(node, includeDisabled, results, seen) {
+	if (node instanceof HTMLSlotElement) {
+		for (const assigned of node.assignedElements({ flatten: true })) gatherFocusableElements(assigned, includeDisabled, results, seen);
+		return;
+	}
+	if (!(node instanceof HTMLElement)) return;
+	if (matchesFocusable(node, includeDisabled) && isDisplayed(node) && !seen.has(node)) {
+		seen.add(node);
+		results.push(node);
+	}
+	const subtree = node.shadowRoot ?? node;
+	for (const child of subtree.childNodes) gatherFocusableElements(child, includeDisabled, results, seen);
+}
+function getFocusableElements(root, includeDisabled = false) {
+	const results = [];
+	const seen = /* @__PURE__ */ new Set();
+	if (root instanceof DocumentFragment) {
+		for (const child of root.childNodes) gatherFocusableElements(child, includeDisabled, results, seen);
+		return results;
+	}
+	gatherFocusableElements(root, includeDisabled, results, seen);
+	return results;
+}
+function containsActiveElement(element, active) {
+	if (!active) return false;
+	return element === active || element.contains(active);
+}
+function getActiveFocusIndex(focusable, active) {
+	if (!active) return -1;
+	return focusable.findIndex((element) => containsActiveElement(element, active));
+}
+/**
+* Focus trap for overlays — adapted from  dialog patterns.
+* Uses deepest active element so shadow-DOM controls participate correctly.
+*/
+function createFocusTrap({ root, onEscape }) {
+	const handleKeyDown = (event) => {
+		if (event.key === "Escape") {
+			onEscape?.();
+			return;
+		}
+		if (event.key !== "Tab") return;
+		const focusable = getFocusableElements(root);
+		if (focusable.length === 0) {
+			event.preventDefault();
+			return;
+		}
+		const first = focusable[0];
+		const last = focusable[focusable.length - 1];
+		const activeIndex = getActiveFocusIndex(focusable, getDeepestActiveElement() ?? document.activeElement);
+		if (event.shiftKey) {
+			if (activeIndex <= 0) {
+				event.preventDefault();
+				last.focus();
+			}
+			return;
+		}
+		if (activeIndex === -1 || activeIndex >= focusable.length - 1) {
+			event.preventDefault();
+			first.focus();
+		}
+	};
+	document.addEventListener("keydown", handleKeyDown, true);
+	return () => {
+		document.removeEventListener("keydown", handleKeyDown, true);
+	};
+}
+/** Screen reader announcements for async overlay state changes. */
+var LiveRegion = class {
+	constructor(politeness = "polite") {
+		this.element = document.createElement("div");
+		this.element.setAttribute("aria-live", politeness);
+		this.element.setAttribute("aria-atomic", "true");
+		this.element.className = "pk-visually-hidden";
+		this.element.style.cssText = "position:absolute;width:1px;height:1px;padding:0;margin:-1px;overflow:hidden;clip:rect(0,0,0,0);white-space:nowrap;border:0;";
+		document.body.append(this.element);
+	}
+	announce(message) {
+		this.element.textContent = "";
+		requestAnimationFrame(() => {
+			this.element.textContent = message;
+		});
+	}
+	destroy() {
+		this.element.remove();
+	}
+};
+//#endregion
+export { uniqueId as i, createFocusTrap as n, getFocusableElements as r, LiveRegion as t };
+
+//# sourceMappingURL=focus-aa5dlv8k.js.map

package/dist/chunks/focus-aa5dlv8k.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"focus-aa5dlv8k.js","names":[],"sources":["../../src/a11y/focus.ts"],"sourcesContent":["import { getDeepestActiveElement } from './active-elements.js';\n\nlet idCounter = 0;\n\n/** Stable unique id for aria-labelledby / aria-controls wiring inside components. */\nexport function uniqueId(prefix = 'pk'): string {\n    idCounter += 1;\n    return `${prefix}-${idCounter}`;\n}\n\nconst FOCUSABLE_SELECTOR = [\n    'a[href]',\n    'button:not([disabled])',\n    'input:not([disabled])',\n    'select:not([disabled])',\n    'textarea:not([disabled])',\n    '[tabindex]:not([tabindex=\"-1\"])',\n].join(',');\n\nconst FOCUSABLE_SELECTOR_WITH_DISABLED = [\n    'a[href]',\n    'button',\n    'input',\n    'select',\n    'textarea',\n    '[tabindex]:not([tabindex=\"-1\"])',\n].join(',');\n\nfunction isDisplayed(element: HTMLElement): boolean {\n    return element.offsetParent !== null || element.getClientRects().length > 0;\n}\n\nfunction matchesFocusable(element: HTMLElement, includeDisabled: boolean): boolean {\n    return element.matches(includeDisabled ? FOCUSABLE_SELECTOR_WITH_DISABLED : FOCUSABLE_SELECTOR);\n}\n\n/** Walks shadow roots and assigned slot content — required for slotted dialog actions. */\nfunction gatherFocusableElements(\n    node: Node,\n    includeDisabled: boolean,\n    results: HTMLElement[],\n    seen: Set<HTMLElement>,\n): void {\n    if (node instanceof HTMLSlotElement) {\n        for (const assigned of node.assignedElements({ flatten: true })) {\n            gatherFocusableElements(assigned, includeDisabled, results, seen);\n        }\n\n        return;\n    }\n\n    if (!(node instanceof HTMLElement)) {\n        return;\n    }\n\n    if (matchesFocusable(node, includeDisabled) && isDisplayed(node) && !seen.has(node)) {\n        seen.add(node);\n        results.push(node);\n    }\n\n    const subtree = node.shadowRoot ?? node;\n\n    for (const child of subtree.childNodes) {\n        gatherFocusableElements(child, includeDisabled, results, seen);\n    }\n}\n\nexport function getFocusableElements(root: ParentNode, includeDisabled = false): HTMLElement[] {\n    const results: HTMLElement[] = [];\n    const seen = new Set<HTMLElement>();\n\n    if (root instanceof DocumentFragment) {\n        for (const child of root.childNodes) {\n            gatherFocusableElements(child, includeDisabled, results, seen);\n        }\n\n        return results;\n    }\n\n    gatherFocusableElements(root as Node, includeDisabled, results, seen);\n    return results;\n}\n\nfunction containsActiveElement(element: HTMLElement, active: Element | null | undefined): boolean {\n    if (!active) {\n        return false;\n    }\n\n    return element === active || element.contains(active);\n}\n\nfunction getActiveFocusIndex(focusable: HTMLElement[], active: Element | null | undefined): number {\n    if (!active) {\n        return -1;\n    }\n\n    return focusable.findIndex((element) => containsActiveElement(element, active));\n}\n\nexport type FocusTrapOptions = {\n    root: HTMLElement;\n    onEscape?: () => void;\n};\n\n/**\n * Focus trap for overlays — adapted from  dialog patterns.\n * Uses deepest active element so shadow-DOM controls participate correctly.\n */\nexport function createFocusTrap({ root, onEscape }: FocusTrapOptions): () => void {\n    const handleKeyDown = (event: KeyboardEvent) => {\n        if (event.key === 'Escape') {\n            onEscape?.();\n            return;\n        }\n\n        if (event.key !== 'Tab') {\n            return;\n        }\n\n        const focusable = getFocusableElements(root);\n\n        if (focusable.length === 0) {\n            event.preventDefault();\n            return;\n        }\n\n        const first = focusable[0]!;\n        const last = focusable[focusable.length - 1]!;\n        const active = getDeepestActiveElement() ?? document.activeElement;\n        const activeIndex = getActiveFocusIndex(focusable, active);\n\n        if (event.shiftKey) {\n            if (activeIndex <= 0) {\n                event.preventDefault();\n                last.focus();\n            }\n\n            return;\n        }\n\n        if (activeIndex === -1 || activeIndex >= focusable.length - 1) {\n            event.preventDefault();\n            first.focus();\n        }\n    };\n\n    document.addEventListener('keydown', handleKeyDown, true);\n\n    return () => {\n        document.removeEventListener('keydown', handleKeyDown, true);\n    };\n}\n\n/** Screen reader announcements for async overlay state changes. */\nexport class LiveRegion {\n    private readonly element: HTMLElement;\n\n    constructor(politeness: 'polite' | 'assertive' = 'polite') {\n        this.element = document.createElement('div');\n        this.element.setAttribute('aria-live', politeness);\n        this.element.setAttribute('aria-atomic', 'true');\n        this.element.className = 'pk-visually-hidden';\n        this.element.style.cssText = 'position:absolute;width:1px;height:1px;padding:0;margin:-1px;overflow:hidden;clip:rect(0,0,0,0);white-space:nowrap;border:0;';\n        document.body.append(this.element);\n    }\n\n    announce(message: string): void {\n        this.element.textContent = '';\n        requestAnimationFrame(() => {\n            this.element.textContent = message;\n        });\n    }\n\n    destroy(): void {\n        this.element.remove();\n    }\n}\n"],"mappings":"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"}

package/dist/chunks/form-control.styles-BQdimE5o.js

@@ -0,0 +1,108 @@
+import { css } from "lit";
+//#region src/base/form-control.styles.ts
+/** Shared label/instructions layout for form controls — Craft tokens,  structure. */
+var formControlStyles = css`
+    @layer pk-component {
+        .form-control {
+            display: flex;
+            flex-direction: column;
+            gap: 0.375rem;
+            width: 100%;
+        }
+
+        .form-control__header {
+            display: flex;
+            flex-direction: column;
+            gap: 0.125rem;
+            min-width: 0;
+        }
+
+        .form-control__label {
+            display: inline-flex;
+            align-items: center;
+            gap: 0.25rem;
+            margin: 0;
+            color: var(--pk-color-gray-700);
+            font-family: var(--pk-font-family);
+            font-size: var(--pk-font-size-base);
+            font-weight: 700;
+            line-height: var(--pk-line-height);
+        }
+
+        .form-control__instructions,
+        .form-control__hint {
+            margin: 0;
+            color: var(--pk-color-gray-500);
+            font-family: var(--pk-font-family);
+            font-size: var(--pk-font-size-base);
+            line-height: var(--pk-line-height);
+        }
+
+        .form-control__instructions:empty,
+        .form-control__hint:empty {
+            display: none;
+        }
+
+        .sr-only {
+            position: absolute;
+            width: 1px;
+            height: 1px;
+            padding: 0;
+            margin: -1px;
+            overflow: hidden;
+            clip: rect(0, 0, 0, 0);
+            white-space: nowrap;
+            border: 0;
+        }
+
+        .form-control__input {
+            display: flex;
+            align-items: stretch;
+            position: relative;
+            width: 100%;
+        }
+
+        .form-control__start,
+        .form-control__end {
+            display: inline-flex;
+            align-items: center;
+            flex-shrink: 0;
+        }
+
+        .form-control__start {
+            margin-inline-end: 6px;
+        }
+
+        .form-control__end {
+            margin-inline-start: 6px;
+        }
+
+        .icon-button {
+            display: inline-flex;
+            align-items: center;
+            justify-content: center;
+            margin: 0;
+            padding: 0;
+            border: 0;
+            background: transparent;
+            color: var(--pk-color-gray-500);
+            cursor: pointer;
+            line-height: 0;
+        }
+
+        .icon-button:focus-visible {
+            outline: none;
+            box-shadow: var(--pk-shadow-focus);
+            border-radius: var(--pk-radius-sm);
+        }
+
+        .icon-button:disabled {
+            cursor: not-allowed;
+            opacity: 0.5;
+        }
+    }
+`;
+//#endregion
+export { formControlStyles as t };
+
+//# sourceMappingURL=form-control.styles-BQdimE5o.js.map

package/dist/chunks/form-control.styles-BQdimE5o.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"form-control.styles-BQdimE5o.js","names":[],"sources":["../../src/base/form-control.styles.ts"],"sourcesContent":["import { css } from 'lit';\n\n/** Shared label/instructions layout for form controls — Craft tokens,  structure. */\nexport const formControlStyles = css`\n    @layer pk-component {\n        .form-control {\n            display: flex;\n            flex-direction: column;\n            gap: 0.375rem;\n            width: 100%;\n        }\n\n        .form-control__header {\n            display: flex;\n            flex-direction: column;\n            gap: 0.125rem;\n            min-width: 0;\n        }\n\n        .form-control__label {\n            display: inline-flex;\n            align-items: center;\n            gap: 0.25rem;\n            margin: 0;\n            color: var(--pk-color-gray-700);\n            font-family: var(--pk-font-family);\n            font-size: var(--pk-font-size-base);\n            font-weight: 700;\n            line-height: var(--pk-line-height);\n        }\n\n        .form-control__instructions,\n        .form-control__hint {\n            margin: 0;\n            color: var(--pk-color-gray-500);\n            font-family: var(--pk-font-family);\n            font-size: var(--pk-font-size-base);\n            line-height: var(--pk-line-height);\n        }\n\n        .form-control__instructions:empty,\n        .form-control__hint:empty {\n            display: none;\n        }\n\n        .sr-only {\n            position: absolute;\n            width: 1px;\n            height: 1px;\n            padding: 0;\n            margin: -1px;\n            overflow: hidden;\n            clip: rect(0, 0, 0, 0);\n            white-space: nowrap;\n            border: 0;\n        }\n\n        .form-control__input {\n            display: flex;\n            align-items: stretch;\n            position: relative;\n            width: 100%;\n        }\n\n        .form-control__start,\n        .form-control__end {\n            display: inline-flex;\n            align-items: center;\n            flex-shrink: 0;\n        }\n\n        .form-control__start {\n            margin-inline-end: 6px;\n        }\n\n        .form-control__end {\n            margin-inline-start: 6px;\n        }\n\n        .icon-button {\n            display: inline-flex;\n            align-items: center;\n            justify-content: center;\n            margin: 0;\n            padding: 0;\n            border: 0;\n            background: transparent;\n            color: var(--pk-color-gray-500);\n            cursor: pointer;\n            line-height: 0;\n        }\n\n        .icon-button:focus-visible {\n            outline: none;\n            box-shadow: var(--pk-shadow-focus);\n            border-radius: var(--pk-radius-sm);\n        }\n\n        .icon-button:disabled {\n            cursor: not-allowed;\n            opacity: 0.5;\n        }\n    }\n`;\n"],"mappings":";;;AAGA,IAAa,oBAAoB,GAAG"}

package/dist/chunks/has-slot-8BvCt_qo.js

@@ -0,0 +1,74 @@
+//#region src/internal/has-slot.ts
+/** Detects whether named slots have assigned content —  `HasSlotController`. */
+var HasSlotController = class {
+	constructor(host, ...slotNames) {
+		this.host = host;
+		this.boundSlots = /* @__PURE__ */ new Set();
+		this.lastHasContent = /* @__PURE__ */ new Map();
+		this.handleSlotChange = () => {
+			let changed = false;
+			for (const name of this.slotNames) {
+				const has = this.test(name);
+				if (this.lastHasContent.get(name) !== has) {
+					this.lastHasContent.set(name, has);
+					changed = true;
+				}
+			}
+			if (changed) this.host.requestUpdate();
+		};
+		this.slotNames = slotNames;
+		host.addController(this);
+	}
+	hostConnected() {
+		this.bindSlotListeners();
+	}
+	hostUpdated() {
+		this.bindSlotListeners();
+	}
+	hostDisconnected() {
+		for (const slot of this.boundSlots) slot.removeEventListener("slotchange", this.handleSlotChange);
+		this.boundSlots.clear();
+	}
+	/**
+	* Bind a `slotchange` listener to each watched slot once it exists.
+	*
+	* Deliberately does NOT call `requestUpdate()` here: this runs from
+	* `hostUpdated()` (after an update completes), so requesting one would trigger
+	* Lit's "scheduled an update after an update completed" warning and, if a
+	* slot's element identity changed between renders, an infinite update loop.
+	* The initial render already reflects light-DOM content (children exist before
+	* upgrade), and the initial `slotchange` covers any late-assigned content — so
+	* `handleSlotChange` is the single, deduped path that schedules re-renders.
+	*/
+	bindSlotListeners() {
+		for (const name of this.slotNames) {
+			const slot = this.findSlot(name);
+			if (!slot || this.boundSlots.has(slot)) continue;
+			this.boundSlots.add(slot);
+			slot.addEventListener("slotchange", this.handleSlotChange);
+			if (!this.lastHasContent.has(name)) this.lastHasContent.set(name, this.test(name));
+		}
+	}
+	findSlot(name) {
+		if (!this.host.shadowRoot) return null;
+		if (!name) return this.host.shadowRoot.querySelector("slot:not([name])");
+		return this.host.shadowRoot.querySelector(`slot[name="${name}"]`);
+	}
+	test(name, ssrFlag = false) {
+		if (ssrFlag) return true;
+		if (this.hasLightDomSlotContent(name)) return true;
+		const slot = this.findSlot(name);
+		if (!slot) return false;
+		return slot.assignedNodes({ flatten: true }).some((node) => {
+			if (node.nodeType === Node.TEXT_NODE) return Boolean(node.textContent?.trim());
+			return node.nodeType === Node.ELEMENT_NODE;
+		});
+	}
+	hasLightDomSlotContent(name) {
+		return [...this.host.children].some((child) => child.getAttribute("slot") === name);
+	}
+};
+//#endregion
+export { HasSlotController as t };
+
+//# sourceMappingURL=has-slot-8BvCt_qo.js.map

package/dist/chunks/has-slot-8BvCt_qo.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"has-slot-8BvCt_qo.js","names":[],"sources":["../../src/internal/has-slot.ts"],"sourcesContent":["import type { ReactiveController, ReactiveControllerHost } from 'lit';\n\n/** Detects whether named slots have assigned content —  `HasSlotController`. */\nexport class HasSlotController implements ReactiveController {\n    private readonly slotNames: string[];\n\n    private readonly boundSlots = new Set<HTMLSlotElement>();\n\n    /** Last-seen content presence per slot, so we only re-render on real changes. */\n    private readonly lastHasContent = new Map<string, boolean>();\n\n    constructor(\n        private readonly host: ReactiveControllerHost & HTMLElement,\n        ...slotNames: string[]\n    ) {\n        this.slotNames = slotNames;\n        host.addController(this);\n    }\n\n    hostConnected(): void {\n        this.bindSlotListeners();\n    }\n\n    hostUpdated(): void {\n        this.bindSlotListeners();\n    }\n\n    hostDisconnected(): void {\n        for (const slot of this.boundSlots) {\n            slot.removeEventListener('slotchange', this.handleSlotChange);\n        }\n\n        this.boundSlots.clear();\n    }\n\n    /**\n     * Bind a `slotchange` listener to each watched slot once it exists.\n     *\n     * Deliberately does NOT call `requestUpdate()` here: this runs from\n     * `hostUpdated()` (after an update completes), so requesting one would trigger\n     * Lit's \"scheduled an update after an update completed\" warning and, if a\n     * slot's element identity changed between renders, an infinite update loop.\n     * The initial render already reflects light-DOM content (children exist before\n     * upgrade), and the initial `slotchange` covers any late-assigned content — so\n     * `handleSlotChange` is the single, deduped path that schedules re-renders.\n     */\n    private bindSlotListeners(): void {\n        for (const name of this.slotNames) {\n            const slot = this.findSlot(name);\n\n            if (!slot || this.boundSlots.has(slot)) {\n                continue;\n            }\n\n            this.boundSlots.add(slot);\n            slot.addEventListener('slotchange', this.handleSlotChange);\n\n            // Seed the baseline with what the just-completed render already used.\n            if (!this.lastHasContent.has(name)) {\n                this.lastHasContent.set(name, this.test(name));\n            }\n        }\n    }\n\n    private findSlot(name: string): HTMLSlotElement | null {\n        if (!this.host.shadowRoot) {\n            return null;\n        }\n\n        if (!name) {\n            return this.host.shadowRoot.querySelector('slot:not([name])');\n        }\n\n        return this.host.shadowRoot.querySelector(`slot[name=\"${name}\"]`);\n    }\n\n    private handleSlotChange = (): void => {\n        // Only re-render when a watched slot's content presence actually flips —\n        // slotchange fires on every light-DOM mutation, so deduping here keeps a\n        // busy subtree (e.g. a Tiptap editor) from thrashing the host.\n        let changed = false;\n\n        for (const name of this.slotNames) {\n            const has = this.test(name);\n\n            if (this.lastHasContent.get(name) !== has) {\n                this.lastHasContent.set(name, has);\n                changed = true;\n            }\n        }\n\n        if (changed) {\n            this.host.requestUpdate();\n        }\n    };\n\n    test(name: string, ssrFlag = false): boolean {\n        if (ssrFlag) {\n            return true;\n        }\n\n        if (this.hasLightDomSlotContent(name)) {\n            return true;\n        }\n\n        const slot = this.findSlot(name);\n\n        if (!slot) {\n            return false;\n        }\n\n        return slot.assignedNodes({ flatten: true }).some((node) => {\n            if (node.nodeType === Node.TEXT_NODE) {\n                return Boolean(node.textContent?.trim());\n            }\n\n            return node.nodeType === Node.ELEMENT_NODE;\n        });\n    }\n\n    private hasLightDomSlotContent(name: string): boolean {\n        return [...this.host.children].some((child) => child.getAttribute('slot') === name);\n    }\n}\n"],"mappings":";;AAGA,IAAa,oBAAb,MAA6D;CAQzD,YACI,MACA,GAAG,WACL;AAFmB,OAAA,OAAA;oCANS,IAAI,KAAsB;wCAGtB,IAAI,KAAsB;gCAmErB;GAInC,IAAI,UAAU;AAEd,QAAK,MAAM,QAAQ,KAAK,WAAW;IAC/B,MAAM,MAAM,KAAK,KAAK,KAAK;AAE3B,QAAI,KAAK,eAAe,IAAI,KAAK,KAAK,KAAK;AACvC,UAAK,eAAe,IAAI,MAAM,IAAI;AAClC,eAAU;;;AAIlB,OAAI,QACA,MAAK,KAAK,eAAe;;AA7E7B,OAAK,YAAY;AACjB,OAAK,cAAc,KAAK;;CAG5B,gBAAsB;AAClB,OAAK,mBAAmB;;CAG5B,cAAoB;AAChB,OAAK,mBAAmB;;CAG5B,mBAAyB;AACrB,OAAK,MAAM,QAAQ,KAAK,WACpB,MAAK,oBAAoB,cAAc,KAAK,iBAAiB;AAGjE,OAAK,WAAW,OAAO;;;;;;;;;;;;;CAc3B,oBAAkC;AAC9B,OAAK,MAAM,QAAQ,KAAK,WAAW;GAC/B,MAAM,OAAO,KAAK,SAAS,KAAK;AAEhC,OAAI,CAAC,QAAQ,KAAK,WAAW,IAAI,KAAK,CAClC;AAGJ,QAAK,WAAW,IAAI,KAAK;AACzB,QAAK,iBAAiB,cAAc,KAAK,iBAAiB;AAG1D,OAAI,CAAC,KAAK,eAAe,IAAI,KAAK,CAC9B,MAAK,eAAe,IAAI,MAAM,KAAK,KAAK,KAAK,CAAC;;;CAK1D,SAAiB,MAAsC;AACnD,MAAI,CAAC,KAAK,KAAK,WACX,QAAO;AAGX,MAAI,CAAC,KACD,QAAO,KAAK,KAAK,WAAW,cAAc,mBAAmB;AAGjE,SAAO,KAAK,KAAK,WAAW,cAAc,cAAc,KAAK,IAAI;;CAuBrE,KAAK,MAAc,UAAU,OAAgB;AACzC,MAAI,QACA,QAAO;AAGX,MAAI,KAAK,uBAAuB,KAAK,CACjC,QAAO;EAGX,MAAM,OAAO,KAAK,SAAS,KAAK;AAEhC,MAAI,CAAC,KACD,QAAO;AAGX,SAAO,KAAK,cAAc,EAAE,SAAS,MAAM,CAAC,CAAC,MAAM,SAAS;AACxD,OAAI,KAAK,aAAa,KAAK,UACvB,QAAO,QAAQ,KAAK,aAAa,MAAM,CAAC;AAG5C,UAAO,KAAK,aAAa,KAAK;IAChC;;CAGN,uBAA+B,MAAuB;AAClD,SAAO,CAAC,GAAG,KAAK,KAAK,SAAS,CAAC,MAAM,UAAU,MAAM,aAAa,OAAO,KAAK,KAAK"}

package/dist/chunks/icon.styles-BLTWLqYp.js

@@ -0,0 +1,21 @@
+import { css } from "lit";
+//#region src/base/icon.styles.ts
+/** Shared icon sizing for slotted SVGs inside shadow DOM. */
+var iconStyles = css`
+    @layer pk-component {
+        slot[name='start']::slotted(svg),
+        slot[name='end']::slotted(svg) {
+            display: block;
+            width: 1em;
+            height: 1em;
+            flex-shrink: 0;
+            pointer-events: none;
+            vertical-align: middle;
+            overflow: visible;
+        }
+    }
+`;
+//#endregion
+export { iconStyles as t };
+
+//# sourceMappingURL=icon.styles-BLTWLqYp.js.map

package/dist/chunks/icon.styles-BLTWLqYp.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"icon.styles-BLTWLqYp.js","names":[],"sources":["../../src/base/icon.styles.ts"],"sourcesContent":["import { css } from 'lit';\n\n/** Shared icon sizing for slotted SVGs inside shadow DOM. */\nexport const iconStyles = css`\n    @layer pk-component {\n        slot[name='start']::slotted(svg),\n        slot[name='end']::slotted(svg) {\n            display: block;\n            width: 1em;\n            height: 1em;\n            flex-shrink: 0;\n            pointer-events: none;\n            vertical-align: middle;\n            overflow: visible;\n        }\n    }\n`;\n"],"mappings":";;;AAGA,IAAa,aAAa,GAAG"}