@verbb/plugin-kit-web 2.0.0

package/CHANGELOG.md

@@ -0,0 +1,16 @@
+# Changelog
+
+## Unreleased
+
+## 2.0.0 - 2026-07-19
+
+### Added
+- Initial public release of `@verbb/plugin-kit-web` — canonical `<pk-*>` Craft CP components (Lit + shadow DOM, `--pk-*` tokens).
+- Family side-effect registration entries (`@verbb/plugin-kit-web/components/{family}.js`) and default `plugin-kit.css` (tokens + FOUCE).
+- Opt-in icon registry integration with `@verbb/plugin-kit-icons` (`registerIcons` / `all.js`).
+- `<pk-editable-table>` as the canonical editable table (table-native pointer reorder, Craft-style cell controls).
+- TipTap (`pk-tiptap-*`) and CodeMirror (`pk-code-editor`) surfaces backed by `@verbb/plugin-kit-tiptap-core` / `@verbb/plugin-kit-codemirror-core`.
+- No-build loader path (`plugin-kit.loader.js`) for script-tag CP embeds.
+
+### Changed
+- Package versions lockstep with `@verbb/plugin-kit-react`, `@verbb/plugin-kit-vue`, `@verbb/plugin-kit-forms`, and related `@verbb/plugin-kit-*` packages at `2.0.0`.

package/LICENSE.md

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) Verbb
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,149 @@
+# `@verbb/plugin-kit-web`
+
+Canonical Craft CP UI as Lit custom elements (`<pk-*>`) — shadow DOM, `--pk-*` tokens, and accessibility live here. React and Vue adapters are thin facades over this package.
+
+## Install
+
+```bash
+npm install @verbb/plugin-kit-web
+```
+
+Node `>= 20`. Peer / runtime packages (`lit`, `@floating-ui/dom`, `@verbb/plugin-kit-core`, `@verbb/plugin-kit-icons`, and TipTap/CodeMirror cores when you import those families) install with the package on a normal npm publish.
+
+Full Craft wiring (Vite + asset bundle + Twig) is in the [Web quick start](https://docs.verbb.io/plugin-kit/web/getting-started/quick-start).
+
+## Consume (bundler)
+
+Prefer **family side-effect imports** so TipTap, CodeMirror, and other heavy surfaces stay out of the graph until you ask for them:
+
+```ts
+import '@verbb/plugin-kit-web/plugin-kit.css'; // tokens + FOUCE + overlay chrome
+
+import '@verbb/plugin-kit-web/components/button.js';
+import '@verbb/plugin-kit-web/components/dropdown-menu.js';
+import '@verbb/plugin-kit-web/components/icon.js';
+
+// Only the glyphs your `<pk-icon icon="…">` tags need
+import { registerIcons, plus, gear } from '@verbb/plugin-kit-icons';
+registerIcons({ plus, gear });
+```
+
+```html
+<pk-button variant="primary">Save</pk-button>
+
+<pk-dropdown-menu>
+  <pk-button slot="trigger" with-caret>Actions</pk-button>
+  <pk-dropdown-item value="duplicate">Duplicate</pk-dropdown-item>
+  <pk-dropdown-item value="delete">Delete</pk-dropdown-item>
+</pk-dropdown-menu>
+```
+
+Family entries live at `@verbb/plugin-kit-web/components/{family}.js` (for example `dropdown-menu.js` registers menu, item, separator, and label). TipTap is split (`tiptap-editor` / `tiptap-input` / `tiptap-content`).
+
+Need a typed class?
+
+```ts
+import { PkButton } from '@verbb/plugin-kit-web/components/button/pk-button.js';
+```
+
+Avoid the package root (`@verbb/plugin-kit-web`) and `@verbb/plugin-kit-web/register` in production CP bundles unless you intentionally want the full library (playgrounds, demos).
+
+### Icons
+
+`<pk-icon icon="…">` uses an **opt-in** registry. Register named glyphs, or import `@verbb/plugin-kit-icons/all.js` for the full curated set. HTML uses kebab-case (`icon="arrow-up"`); JS exports are camelCase (`arrowUp`) and normalize on register.
+
+### Waiting before JS interaction
+
+FOUCE CSS handles **visual** readiness. When your entry reads properties, focuses elements, or attaches listeners on first load:
+
+```ts
+import { allDefined } from '@verbb/plugin-kit-web/plugin-kit';
+
+await allDefined();
+// or: await allDefined({ root: document.getElementById('my-field') });
+
+const button = document.querySelector('pk-button');
+await button?.updateComplete;
+```
+
+- **`allDefined()`** — page-level or scoped (`root`) gate before querying `pk-*`
+- **`customElements.whenDefined('pk-button')`** — when you only need one tag
+- **`element.updateComplete`** — after define, before reading reflected attrs / Lit properties
+
+## Styles
+
+| Import | Purpose |
+|--------|---------|
+| `@verbb/plugin-kit-web/plugin-kit.css` | **Recommended** — tokens + FOUCE + overlay chrome |
+| `@verbb/plugin-kit-web/tokens.css` | Design tokens on `:root` only |
+| `@verbb/plugin-kit-web/utilities/fouce.css` | FOUCE alone (already included in `plugin-kit.css`) |
+
+Shadow roots reset `box-sizing` via `PkElement`. Load `plugin-kit.css` so it can land in `<head>` before first paint — do not rely on JS alone to hide undefined elements.
+
+### FOUCE (short)
+
+`plugin-kit.css` hides `pk-*` until they upgrade (reserve in-flow controls; collapse overlays). Optional `.pk-cloak` on `<html>` or a wrapper hides a broader region until all `pk-*` descendants upgrade. A 2s safety reveal prevents a failed import from blanking the UI forever.
+
+Turbo / Hotwire CP pages:
+
+```ts
+import { preventTurboFouce } from '@verbb/plugin-kit-web/plugin-kit';
+preventTurboFouce();
+```
+
+Details and the FOUCE lab: [Reducing FOUCE](https://docs.verbb.io/plugin-kit/web/getting-started/fouce).
+
+## No-build (script tag)
+
+Host `dist-loader/` and load CSS + the loader — it discovers `pk-*` on the page and lazy-loads only what you use:
+
+```html
+<link rel="stylesheet" href="/path/to/dist-loader/plugin-kit.css" />
+<script type="module" src="/path/to/dist-loader/plugin-kit.loader.js"></script>
+
+<pk-button variant="primary">Save</pk-button>
+```
+
+Base path is taken from the script URL. Override with `data-plugin-kit` or `setBasePath()`:
+
+```html
+<meta data-plugin-kit="/path/to/dist-loader" />
+```
+
+```html
+<div data-pk-preload="pk-dialog pk-select"></div>
+```
+
+See [No-Build Step](https://docs.verbb.io/plugin-kit/web/getting-started/no-build-step).
+
+## Craft CP tips
+
+1. Import `plugin-kit.css` from the same entry Craft publishes so FOUCE is render-blocking.
+2. Cherry-pick family imports for the tags your Twig/JS actually uses.
+3. If you split a “register” entry from an “app” entry, register **before** the app mounts (manifest / asset order).
+4. Twig can render `<pk-*>` markup directly; components upgrade in place once the entry runs.
+
+## Framework adapters
+
+Same elements, framework-shaped imports:
+
+| Package | Bootstrap |
+|---------|-----------|
+| [`@verbb/plugin-kit-react`](../plugin-kit-react/README.md) | `createRoot` + `PluginKitProvider` |
+| [`@verbb/plugin-kit-vue`](../plugin-kit-vue/README.md) | `createApp` + `PluginKitProvider` |
+
+## Related packages
+
+| Package | Role |
+|---------|------|
+| `@verbb/plugin-kit-icons` | Opt-in glyph registry for `<pk-icon>` |
+| `@verbb/plugin-kit-forms` | Headless SchemaForm engine |
+| `@verbb/plugin-kit-tiptap-core` | Shared TipTap schema / serialization |
+| `@verbb/plugin-kit-codemirror-core` | Shared CodeMirror setup |
+| `@verbb/plugin-kit-core` | Host bridge helpers, shared utils |
+
+## Docs & workshop
+
+- Docs: [docs.verbb.io/plugin-kit/web](https://docs.verbb.io/plugin-kit/web/)
+- Component workshop (monorepo): `npm run dev` → http://localhost:5175  
+  FOUCE lab: `/tools/fouce`

package/dist/a11y/active-elements.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Shadow-DOM-aware active element chain — adapted from  internal/active-elements.ts.
+ */
+export declare function activeElements(activeElement?: Element | null): Generator<Element>;
+export declare function getDeepestActiveElement(): Element | undefined;
+//# sourceMappingURL=active-elements.d.ts.map

package/dist/a11y/active-elements.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"active-elements.d.ts","sourceRoot":"","sources":["../../src/a11y/active-elements.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,wBAAiB,cAAc,CAC3B,aAAa,GAAE,OAAO,GAAG,IAA6B,GACvD,SAAS,CAAC,OAAO,CAAC,CAUpB;AAED,wBAAgB,uBAAuB,IAAI,OAAO,GAAG,SAAS,CAE7D"}

package/dist/a11y/dismissible-stack.d.ts

@@ -0,0 +1,6 @@
+export declare function registerDismissible(key: object): void;
+export declare function unregisterDismissible(key: object): void;
+export declare function isTopDismissible(key: object): boolean;
+/** Dev/diagnostic — ordered stack of dismissible overlay hosts (bottom → top). */
+export declare function getDismissibleStackSnapshot(): string[];
+//# sourceMappingURL=dismissible-stack.d.ts.map

package/dist/a11y/dismissible-stack.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dismissible-stack.d.ts","sourceRoot":"","sources":["../../src/a11y/dismissible-stack.ts"],"names":[],"mappings":"AAMA,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAErD;AAED,wBAAgB,qBAAqB,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAOvD;AAED,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAErD;AAED,kFAAkF;AAClF,wBAAgB,2BAA2B,IAAI,MAAM,EAAE,CAStD"}

package/dist/a11y/focus.d.ts

@@ -0,0 +1,20 @@
+/** Stable unique id for aria-labelledby / aria-controls wiring inside components. */
+export declare function uniqueId(prefix?: string): string;
+export declare function getFocusableElements(root: ParentNode, includeDisabled?: boolean): HTMLElement[];
+export type FocusTrapOptions = {
+    root: HTMLElement;
+    onEscape?: () => void;
+};
+/**
+ * Focus trap for overlays — adapted from  dialog patterns.
+ * Uses deepest active element so shadow-DOM controls participate correctly.
+ */
+export declare function createFocusTrap({ root, onEscape }: FocusTrapOptions): () => void;
+/** Screen reader announcements for async overlay state changes. */
+export declare class LiveRegion {
+    private readonly element;
+    constructor(politeness?: 'polite' | 'assertive');
+    announce(message: string): void;
+    destroy(): void;
+}
+//# sourceMappingURL=focus.d.ts.map

package/dist/a11y/focus.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"focus.d.ts","sourceRoot":"","sources":["../../src/a11y/focus.ts"],"names":[],"mappings":"AAIA,qFAAqF;AACrF,wBAAgB,QAAQ,CAAC,MAAM,SAAO,GAAG,MAAM,CAG9C;AA2DD,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,UAAU,EAAE,eAAe,UAAQ,GAAG,WAAW,EAAE,CAc7F;AAkBD,MAAM,MAAM,gBAAgB,GAAG;IAC3B,IAAI,EAAE,WAAW,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,IAAI,CAAC;CACzB,CAAC;AAEF;;;GAGG;AACH,wBAAgB,eAAe,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,EAAE,gBAAgB,GAAG,MAAM,IAAI,CA2ChF;AAED,mEAAmE;AACnE,qBAAa,UAAU;IACnB,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAc;gBAE1B,UAAU,GAAE,QAAQ,GAAG,WAAsB;IASzD,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAO/B,OAAO,IAAI,IAAI;CAGlB"}

package/dist/a11y/index.d.ts

@@ -0,0 +1,7 @@
+export { uniqueId, getFocusableElements, createFocusTrap, LiveRegion } from './focus.js';
+export type { FocusTrapOptions } from './focus.js';
+export { lockBodyScrolling, unlockBodyScrolling, scrollIntoView } from './scroll-lock.js';
+export { getOffset } from './offset.js';
+export { registerDismissible, unregisterDismissible, isTopDismissible } from './dismissible-stack.js';
+export { activeElements, getDeepestActiveElement } from './active-elements.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/a11y/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/a11y/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,oBAAoB,EAAE,eAAe,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AACzF,YAAY,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AACnD,OAAO,EAAE,iBAAiB,EAAE,mBAAmB,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAC1F,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AACxC,OAAO,EAAE,mBAAmB,EAAE,qBAAqB,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AACtG,OAAO,EAAE,cAAc,EAAE,uBAAuB,EAAE,MAAM,sBAAsB,CAAC"}

package/dist/a11y/offset.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Element offset relative to a parent — adapted from  internal/offset.ts.
+ * Works around shadow-DOM offsetParent quirks in Chromium.
+ */
+export declare function getOffset(element: HTMLElement, parent: HTMLElement): {
+    top: number;
+    left: number;
+};
+//# sourceMappingURL=offset.d.ts.map

package/dist/a11y/offset.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"offset.d.ts","sourceRoot":"","sources":["../../src/a11y/offset.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,wBAAgB,SAAS,CAAC,OAAO,EAAE,WAAW,EAAE,MAAM,EAAE,WAAW,GAAG;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAKlG"}

package/dist/a11y/scroll-lock.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Document scroll lock for overlays (dialog, etc.).
+ *
+ * Ref-counted so nested overlays unlock only when all close.
+ *
+ * Avoids the classic “fixed chrome jumps” bug from `padding-right` compensation:
+ * Craft CP / playground fixed sidebars & tip bars do not inherit body padding, so
+ * `body { padding-right: scrollbar }` shifts them when the scrollbar goes
+ * away. v1 (Base UI) did not jump — follow that model instead:
+ *
+ * 1. Prefer a real `scrollbar-gutter: stable` lock (width unchanged under overflow:hidden).
+ * 2. Otherwise keep `overflow-y: scroll` on `<html>` so the gutter stays painted, and
+ *    constrain `<body>` so the page cannot scroll.
+ */
+export declare function lockBodyScrolling(lockingEl: HTMLElement): void;
+export declare function unlockBodyScrolling(lockingEl: HTMLElement): void;
+/** Dev/diagnostic — how many overlay hosts currently hold the scroll lock. */
+export declare function getScrollLockDepth(): number;
+/** Emergency clear when lock ref-count and html class drift out of sync. */
+export declare function forceClearScrollLock(): void;
+/** Scroll an element into view of its scroll container if needed. */
+export declare function scrollIntoView(element: HTMLElement, container: HTMLElement, direction?: 'horizontal' | 'vertical' | 'both', behavior?: ScrollBehavior): void;
+//# sourceMappingURL=scroll-lock.d.ts.map

package/dist/a11y/scroll-lock.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scroll-lock.d.ts","sourceRoot":"","sources":["../../src/a11y/scroll-lock.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AA6IH,wBAAgB,iBAAiB,CAAC,SAAS,EAAE,WAAW,GAAG,IAAI,CAU9D;AAED,wBAAgB,mBAAmB,CAAC,SAAS,EAAE,WAAW,GAAG,IAAI,CAUhE;AAED,8EAA8E;AAC9E,wBAAgB,kBAAkB,IAAI,MAAM,CAE3C;AAED,4EAA4E;AAC5E,wBAAgB,oBAAoB,IAAI,IAAI,CAO3C;AAED,qEAAqE;AACrE,wBAAgB,cAAc,CAC1B,OAAO,EAAE,WAAW,EACpB,SAAS,EAAE,WAAW,EACtB,SAAS,GAAE,YAAY,GAAG,UAAU,GAAG,MAAmB,EAC1D,QAAQ,GAAE,cAAyB,GACpC,IAAI,CA8BN"}

package/dist/base/checkbox-control.styles.d.ts

@@ -0,0 +1,3 @@
+/** Shared checkbox/radio control box — Craft tokens, border-box sizing. */
+export declare const checkboxControlStyles: import('lit').CSSResult;
+//# sourceMappingURL=checkbox-control.styles.d.ts.map

package/dist/base/checkbox-control.styles.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"checkbox-control.styles.d.ts","sourceRoot":"","sources":["../../src/base/checkbox-control.styles.ts"],"names":[],"mappings":"AAEA,2EAA2E;AAC3E,eAAO,MAAM,qBAAqB,yBAkFjC,CAAC"}

package/dist/base/component-id.d.ts

@@ -0,0 +1,2 @@
+export declare function createComponentId(prefix?: string): string;
+//# sourceMappingURL=component-id.d.ts.map

package/dist/base/component-id.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"component-id.d.ts","sourceRoot":"","sources":["../../src/base/component-id.ts"],"names":[],"mappings":"AAEA,wBAAgB,iBAAiB,CAAC,MAAM,SAAO,GAAG,MAAM,CAGvD"}

package/dist/base/form-control.styles.d.ts

@@ -0,0 +1,3 @@
+/** Shared label/instructions layout for form controls — Craft tokens,  structure. */
+export declare const formControlStyles: import('lit').CSSResult;
+//# sourceMappingURL=form-control.styles.d.ts.map

package/dist/base/form-control.styles.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"form-control.styles.d.ts","sourceRoot":"","sources":["../../src/base/form-control.styles.ts"],"names":[],"mappings":"AAEA,qFAAqF;AACrF,eAAO,MAAM,iBAAiB,yBAoG7B,CAAC"}

package/dist/base/icon.styles.d.ts

@@ -0,0 +1,3 @@
+/** Shared icon sizing for slotted SVGs inside shadow DOM. */
+export declare const iconStyles: import('lit').CSSResult;
+//# sourceMappingURL=icon.styles.d.ts.map

package/dist/base/icon.styles.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"icon.styles.d.ts","sourceRoot":"","sources":["../../src/base/icon.styles.ts"],"names":[],"mappings":"AAEA,6DAA6D;AAC7D,eAAO,MAAM,UAAU,yBAatB,CAAC"}

package/dist/base/markdown.styles.d.ts

@@ -0,0 +1,3 @@
+/** Shared inline markdown styling for field instructions, errors, and warnings. */
+export declare const inlineMarkdownStyles: import('lit').CSSResult;
+//# sourceMappingURL=markdown.styles.d.ts.map

package/dist/base/markdown.styles.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"markdown.styles.d.ts","sourceRoot":"","sources":["../../src/base/markdown.styles.ts"],"names":[],"mappings":"AAEA,mFAAmF;AACnF,eAAO,MAAM,oBAAoB,yBA2BhC,CAAC"}

package/dist/base/pk-element.d.ts

@@ -0,0 +1,28 @@
+import { LitElement } from 'lit';
+export type PkElementErrorDetail = {
+    tagName: string;
+    message: string;
+    stack?: string;
+};
+declare global {
+    interface GlobalEventHandlersEventMap {
+        'pk-error': CustomEvent<PkElementErrorDetail>;
+    }
+}
+/**
+ * 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).
+ */
+export declare class PkElement extends LitElement {
+    static shadowRootOptions: ShadowRootInit;
+    /** When set, subclasses should skip normal render — base shows a minimal error shell. */
+    protected pkRenderFailed: boolean;
+    connectedCallback(): void;
+    createRenderRoot(): HTMLElement | DocumentFragment;
+    performUpdate(): void;
+    protected handleRenderFailure(error: unknown): void;
+}
+//# sourceMappingURL=pk-element.d.ts.map

package/dist/base/pk-element.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pk-element.d.ts","sourceRoot":"","sources":["../../src/base/pk-element.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,KAAK,CAAC;AAKjC,MAAM,MAAM,oBAAoB,GAAG;IAC/B,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;CAClB,CAAC;AAEF,OAAO,CAAC,MAAM,CAAC;IACX,UAAU,2BAA2B;QACjC,UAAU,EAAE,WAAW,CAAC,oBAAoB,CAAC,CAAC;KACjD;CACJ;AAED;;;;;;GAMG;AACH,qBAAa,SAAU,SAAQ,UAAU;IACrC,OAAgB,iBAAiB,EAAE,cAAc,CAG/C;IAEF,yFAAyF;IACzF,SAAS,CAAC,cAAc,UAAS;IAExB,iBAAiB,IAAI,IAAI;IASzB,gBAAgB,IAAI,WAAW,GAAG,gBAAgB;IAMlD,aAAa,IAAI,IAAI;IAqB9B,SAAS,CAAC,mBAAmB,CAAC,KAAK,EAAE,OAAO,GAAG,IAAI;CAgCtD"}

package/dist/base/pk-form-associated-element.d.ts

@@ -0,0 +1,63 @@
+import { PropertyValues } from 'lit';
+import { PkValidator } from '../validators/index.js';
+import { PkElement } from './pk-element.js';
+/**
+ * Form-associated custom element base —  `FormAssociatedElement` pattern.
+ */
+export declare abstract class PkFormAssociatedElement extends PkElement {
+    static formAssociated: boolean;
+    static get validators(): PkValidator[];
+    static get observedAttributes(): string[];
+    protected readonly internals: ElementInternals;
+    /** Shadow native control for `MirrorValidator`. */
+    input?: HTMLInputElement | HTMLTextAreaElement | HTMLSelectElement;
+    /** Events that must all fire before `:user-invalid` applies — override per component. */
+    assumeInteractionOn: string[];
+    validators: PkValidator[];
+    name: string | null;
+    disabled: boolean;
+    required: boolean;
+    customError: string | null;
+    valueHasChanged: boolean;
+    hasInteracted: boolean;
+    private emittedEvents;
+    private hostAriaMirror?;
+    constructor();
+    connectedCallback(): void;
+    disconnectedCallback(): void;
+    updated(changed: PropertyValues): void;
+    firstUpdated(_changed: PropertyValues): void;
+    /** Focusable native control that receives mirrored field-shell ARIA. */
+    protected getAriaMirrorTarget(): HTMLElement | null;
+    /** Standalone label/instructions wiring when no external field shell is present. */
+    protected syncStandaloneAria(): void;
+    protected connectHostAriaMirror(): void;
+    protected syncHostAriaMirror(): void;
+    formResetCallback(): void;
+    formDisabledCallback(isDisabled: boolean): void;
+    formStateRestoreCallback(state: string | File | FormData | null, _reason?: 'restore' | 'autocomplete'): void;
+    set form(value: string);
+    get form(): HTMLFormElement | null;
+    get labels(): NodeList;
+    get validity(): ValidityState;
+    get willValidate(): boolean;
+    get validationMessage(): string;
+    getForm(): HTMLFormElement | null;
+    checkValidity(): boolean;
+    reportValidity(): boolean;
+    resetValidity(): void;
+    setCustomValidity(message: string): void;
+    protected get validationTarget(): HTMLElement | undefined;
+    protected get allValidators(): PkValidator[];
+    protected setFormValue(value: string | File | FormData | null, state?: string | File | FormData | null): void;
+    protected setValue(value: string | File | FormData | null, state?: string | File | FormData | null): void;
+    protected updateValidity(): void;
+    protected syncCustomStates(): void;
+    protected setState(name: string, active: boolean): void;
+    protected syncFormValue(): void;
+    protected resetToDefaultValue(): void;
+    protected restoreFormState(_state: string | File | FormData | null): void;
+    private emitInvalid;
+    private handleInteraction;
+}
+//# sourceMappingURL=pk-form-associated-element.d.ts.map

package/dist/base/pk-form-associated-element.d.ts.map

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

package/dist/base/shadow-reset.styles.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Shadow-root baseline — box model + inherited typography inside every pk-* component.
+ * Applied via PkElement.createRenderRoot(); does not replace per-component styles.
+ */
+export declare const shadowResetStyles: import('lit').CSSResult;
+//# sourceMappingURL=shadow-reset.styles.d.ts.map

package/dist/base/shadow-reset.styles.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"shadow-reset.styles.d.ts","sourceRoot":"","sources":["../../src/base/shadow-reset.styles.ts"],"names":[],"mappings":"AAEA;;;GAGG;AACH,eAAO,MAAM,iBAAiB,yBAiB7B,CAAC"}

package/dist/base/styles.d.ts

@@ -0,0 +1,9 @@
+import { CSSResultGroup } from 'lit';
+/**
+ * Share constructable stylesheets across component instances ( pattern).
+ * Falls back to an injected `<style>` tag when adoptedStyleSheets aren't supported.
+ */
+export declare function adoptStyles(shadowRoot: ShadowRoot, styleResults: CSSResultGroup[], cacheKey?: string): void;
+export declare const hostDisplayInlineBlock: import('lit').CSSResult;
+export declare const focusRing: import('lit').CSSResult;
+//# sourceMappingURL=styles.d.ts.map

package/dist/base/styles.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"styles.d.ts","sourceRoot":"","sources":["../../src/base/styles.ts"],"names":[],"mappings":"AAAA,OAAO,EAAkB,KAAK,cAAc,EAAE,MAAM,KAAK,CAAC;AAI1D;;;GAGG;AACH,wBAAgB,WAAW,CACvB,UAAU,EAAE,UAAU,EACtB,YAAY,EAAE,cAAc,EAAE,EAC9B,QAAQ,CAAC,EAAE,MAAM,GAClB,IAAI,CAmCN;AAED,eAAO,MAAM,sBAAsB,yBAOlC,CAAC;AAEF,eAAO,MAAM,SAAS,yBAQrB,CAAC"}

package/dist/chunks/active-elements-BwpXu8Lb.js

@@ -0,0 +1,16 @@
+//#region src/a11y/active-elements.ts
+/**
+* Shadow-DOM-aware active element chain — adapted from  internal/active-elements.ts.
+*/
+function* activeElements(activeElement = document.activeElement) {
+	if (activeElement === null || activeElement === void 0) return;
+	yield activeElement;
+	if ("shadowRoot" in activeElement && activeElement.shadowRoot && activeElement.shadowRoot.mode !== "closed") yield* activeElements(activeElement.shadowRoot.activeElement);
+}
+function getDeepestActiveElement() {
+	return [...activeElements()].pop();
+}
+//#endregion
+export { getDeepestActiveElement as n, activeElements as t };
+
+//# sourceMappingURL=active-elements-BwpXu8Lb.js.map

package/dist/chunks/active-elements-BwpXu8Lb.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"active-elements-BwpXu8Lb.js","names":[],"sources":["../../src/a11y/active-elements.ts"],"sourcesContent":["/**\n * Shadow-DOM-aware active element chain — adapted from  internal/active-elements.ts.\n */\nexport function* activeElements(\n    activeElement: Element | null = document.activeElement,\n): Generator<Element> {\n    if (activeElement === null || activeElement === undefined) {\n        return;\n    }\n\n    yield activeElement;\n\n    if ('shadowRoot' in activeElement && activeElement.shadowRoot && activeElement.shadowRoot.mode !== 'closed') {\n        yield* activeElements(activeElement.shadowRoot.activeElement);\n    }\n}\n\nexport function getDeepestActiveElement(): Element | undefined {\n    return [...activeElements()].pop();\n}\n"],"mappings":";;;;AAGA,UAAiB,eACb,gBAAgC,SAAS,eACvB;AAClB,KAAI,kBAAkB,QAAQ,kBAAkB,KAAA,EAC5C;AAGJ,OAAM;AAEN,KAAI,gBAAgB,iBAAiB,cAAc,cAAc,cAAc,WAAW,SAAS,SAC/F,QAAO,eAAe,cAAc,WAAW,cAAc;;AAIrE,SAAgB,0BAA+C;AAC3D,QAAO,CAAC,GAAG,gBAAgB,CAAC,CAAC,KAAK"}

package/dist/chunks/animate-with-class-CsDwYnXL.js

@@ -0,0 +1,42 @@
+//#region src/utils/animate-with-class.ts
+/**
+* Run a CSS animation class on an element and resolve when it finishes.
+* Resolves on animationend/cancel, immediately when no CSS animation runs, or on timeout
+* so overlay hide can never hang forever (stuck `active` / missing `after-hide`).
+*/
+function animateWithClass(el, className, timeoutMs = 500) {
+	return new Promise((resolve) => {
+		const controller = new AbortController();
+		const { signal } = controller;
+		if (el.classList.contains(className)) {
+			resolve();
+			return;
+		}
+		el.classList.add(className);
+		let resolved = false;
+		const onEnd = () => {
+			if (resolved) return;
+			resolved = true;
+			el.classList.remove(className);
+			window.clearTimeout(timeoutId);
+			resolve();
+			controller.abort();
+		};
+		el.addEventListener("animationend", onEnd, {
+			once: true,
+			signal
+		});
+		el.addEventListener("animationcancel", onEnd, {
+			once: true,
+			signal
+		});
+		const timeoutId = window.setTimeout(onEnd, timeoutMs);
+		requestAnimationFrame(() => {
+			if (!resolved && el.getAnimations().length === 0) onEnd();
+		});
+	});
+}
+//#endregion
+export { animateWithClass as t };
+
+//# sourceMappingURL=animate-with-class-CsDwYnXL.js.map

package/dist/chunks/animate-with-class-CsDwYnXL.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"animate-with-class-CsDwYnXL.js","names":[],"sources":["../../src/utils/animate-with-class.ts"],"sourcesContent":["/**\n * Run a CSS animation class on an element and resolve when it finishes.\n * Resolves on animationend/cancel, immediately when no CSS animation runs, or on timeout\n * so overlay hide can never hang forever (stuck `active` / missing `after-hide`).\n */\nexport function animateWithClass(el: HTMLElement, className: string, timeoutMs = 500): Promise<void> {\n    return new Promise((resolve) => {\n        const controller = new AbortController();\n        const { signal } = controller;\n\n        if (el.classList.contains(className)) {\n            resolve();\n            return;\n        }\n\n        el.classList.add(className);\n\n        let resolved = false;\n\n        const onEnd = (): void => {\n            if (resolved) {\n                return;\n            }\n\n            resolved = true;\n            el.classList.remove(className);\n            window.clearTimeout(timeoutId);\n            resolve();\n            controller.abort();\n        };\n\n        el.addEventListener('animationend', onEnd, { once: true, signal });\n        el.addEventListener('animationcancel', onEnd, { once: true, signal });\n\n        // If the browser reports running animations that never end (interrupted reverse\n        // animations, display:none mid-flight), still settle so overlays can demote.\n        const timeoutId = window.setTimeout(onEnd, timeoutMs);\n\n        requestAnimationFrame(() => {\n            if (!resolved && el.getAnimations().length === 0) {\n                onEnd();\n            }\n        });\n    });\n}\n"],"mappings":";;;;;;AAKA,SAAgB,iBAAiB,IAAiB,WAAmB,YAAY,KAAoB;AACjG,QAAO,IAAI,SAAS,YAAY;EAC5B,MAAM,aAAa,IAAI,iBAAiB;EACxC,MAAM,EAAE,WAAW;AAEnB,MAAI,GAAG,UAAU,SAAS,UAAU,EAAE;AAClC,YAAS;AACT;;AAGJ,KAAG,UAAU,IAAI,UAAU;EAE3B,IAAI,WAAW;EAEf,MAAM,cAAoB;AACtB,OAAI,SACA;AAGJ,cAAW;AACX,MAAG,UAAU,OAAO,UAAU;AAC9B,UAAO,aAAa,UAAU;AAC9B,YAAS;AACT,cAAW,OAAO;;AAGtB,KAAG,iBAAiB,gBAAgB,OAAO;GAAE,MAAM;GAAM;GAAQ,CAAC;AAClE,KAAG,iBAAiB,mBAAmB,OAAO;GAAE,MAAM;GAAM;GAAQ,CAAC;EAIrE,MAAM,YAAY,OAAO,WAAW,OAAO,UAAU;AAErD,8BAA4B;AACxB,OAAI,CAAC,YAAY,GAAG,eAAe,CAAC,WAAW,EAC3C,QAAO;IAEb;GACJ"}