asheeui 0.6.2 → 0.6.5

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

@@ -1,4 +1,14 @@
 import { FieldSizeKey, FieldStatus } from '../field/field-config';
+/**
+ * CSS classes for input size.
+ * Maps size keys to Tailwind classes that control height,
+ * padding, and font size.
+ */
 export declare const INPUT_SIZE_CLASS: Record<FieldSizeKey, string>;
+/**
+ * CSS classes for input status border styles.
+ * Maps status values to Tailwind classes for border and
+ * focus ring colors.
+ */
 export declare const INPUT_STATUS_BORDER_CLASS: Record<FieldStatus, string>;
 //# sourceMappingURL=input-styles.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"input-styles.d.ts","sourceRoot":"","sources":["../../../src/components/input/input-styles.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AAEvE,eAAO,MAAM,gBAAgB,EAAE,MAAM,CAAC,YAAY,EAAE,MAAM,CAIzD,CAAC;AAEF,eAAO,MAAM,yBAAyB,EAAE,MAAM,CAAC,WAAW,EAAE,MAAM,CAQjE,CAAC"}
+{"version":3,"file":"input-styles.d.ts","sourceRoot":"","sources":["../../../src/components/input/input-styles.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AAGvE;;;;GAIG;AACH,eAAO,MAAM,gBAAgB,EAAE,MAAM,CAAC,YAAY,EAAE,MAAM,CAIzD,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,yBAAyB,EAAE,MAAM,CAAC,WAAW,EAAE,MAAM,CACvC,CAAC"}

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

@@ -1,15 +1,11 @@
 "use client";
-const s = {
+import { FIELD_STATUS_BORDER_CLASS as t } from "../field/field-styles.js";
+const x = {
   sm: "h-8 px-2.5 text-xs",
   md: "h-10 px-3 text-sm",
   lg: "h-12 px-4 text-base"
-}, e = {
-  default: "",
-  error: "border-danger focus-visible:border-danger focus-visible:ring-danger/20",
-  warning: "border-warning focus-visible:border-warning focus-visible:ring-warning/20",
-  success: "border-success focus-visible:border-success focus-visible:ring-success/20"
-};
+}, _ = t;
 export {
-  s as INPUT_SIZE_CLASS,
-  e as INPUT_STATUS_BORDER_CLASS
+  x as INPUT_SIZE_CLASS,
+  _ as INPUT_STATUS_BORDER_CLASS
 };

package/dist/components/keyboard/OnScreenKeyboard.d.ts

@@ -1,14 +1,64 @@
-import { Radius } from '../../shared/radius';
-import { Color, Variant } from '../../shared/variant';
-import { LayoutName } from './keyboard-config';
-export interface OnScreenKeyboardProps {
+import { KeyboardConfig, LayoutName } from './keyboard-config';
+/**
+ * Props for the OnScreenKeyboard component.
+ */
+export interface OnScreenKeyboardProps extends KeyboardConfig {
+    /**
+     * Extra CSS classes for the keyboard container.
+     */
     className?: string;
-    heightClass?: string;
+    /**
+     * Initial layout to show when the keyboard opens.
+     */
     initialLayout?: LayoutName;
-    variant?: Variant;
-    color?: Color;
-    radius?: Radius;
+    /**
+     * Extra CSS classes for individual keys.
+     */
     keyClassName?: string;
+    /**
+     * CSS height class for the keyboard container.
+     * Required to set the keyboard height.
+     */
+    heightClass: string;
 }
+/**
+ * The on-screen virtual keyboard UI.
+ *
+ * OnScreenKeyboard renders a floating keyboard that appears at the bottom
+ * of the screen when an input is focused. It supports multiple layouts
+ * (default, shift, symbols, numeric), key press handling with cursor
+ * management, physical keyboard synchronization, and visual feedback
+ * for pressed keys.
+ *
+ * The component is controlled by the KeyboardContext and should be
+ * placed inside a KeyboardProvider. It automatically shows and hides
+ * based on the context state.
+ *
+ * @param props - OnScreenKeyboard configuration options.
+ * @param props.className - Extra CSS classes for the container.
+ * @param props.heightClass - CSS height class for the keyboard.
+ * @param props.initialLayout - Initial layout name.
+ * @param props.keyClassName - Extra CSS classes for keys.
+ * @param props.variant - Visual variant for keys.
+ * @param props.color - Theme color for keys.
+ * @param props.radius - Corner rounding for keys.
+ *
+ * @example
+ * ```tsx
+ * import { KeyboardProvider, OnScreenKeyboard, Input } from "asheeui";
+ *
+ * export function App() {
+ *   return (
+ *     <KeyboardProvider heightClass="h-56">
+ *       <Input label="Search" enableVirtualKeyboard />
+ *       <OnScreenKeyboard />
+ *     </KeyboardProvider>
+ *   );
+ * }
+ * ```
+ *
+ * @see KeyboardProvider - The provider that controls the keyboard state.
+ * @see useKeyboardField - Hook for connecting inputs to the keyboard.
+ */
 export declare function OnScreenKeyboard({ className, heightClass, initialLayout, variant: variantProp, color: colorProp, radius: radiusProp, keyClassName, }: OnScreenKeyboardProps): import("react").JSX.Element | null;
 //# sourceMappingURL=OnScreenKeyboard.d.ts.map

package/dist/components/keyboard/OnScreenKeyboard.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"OnScreenKeyboard.d.ts","sourceRoot":"","sources":["../../../src/components/keyboard/OnScreenKeyboard.tsx"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,qBAAqB,CAAC;AAClD,OAAO,KAAK,EAAE,KAAK,EAAE,OAAO,EAAE,MAAM,sBAAsB,CAAC;AAG3D,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAuDpD,MAAM,WAAW,qBAAqB;IACpC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,aAAa,CAAC,EAAE,UAAU,CAAC;IAC3B,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,KAAK,CAAC,EAAE,KAAK,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,wBAAgB,gBAAgB,CAAC,EAC/B,SAAS,EACT,WAAW,EACX,aAAa,EACb,OAAO,EAAE,WAAW,EACpB,KAAK,EAAE,SAAS,EAChB,MAAM,EAAE,UAAU,EAClB,YAAY,GACb,EAAE,qBAAqB,sCA6MvB"}
+{"version":3,"file":"OnScreenKeyboard.d.ts","sourceRoot":"","sources":["../../../src/components/keyboard/OnScreenKeyboard.tsx"],"names":[],"mappings":"AAeA,OAAO,EAEL,KAAK,cAAc,EACnB,KAAK,UAAU,EAChB,MAAM,mBAAmB,CAAC;AAuE3B;;GAEG;AACH,MAAM,WAAW,qBAAsB,SAAQ,cAAc;IAC3D;;OAEG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB;;OAEG;IACH,aAAa,CAAC,EAAE,UAAU,CAAC;IAE3B;;OAEG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;IAEtB;;;OAGG;IACH,WAAW,EAAE,MAAM,CAAC;CACrB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAsCG;AACH,wBAAgB,gBAAgB,CAAC,EAC/B,SAAS,EACT,WAAW,EACX,aAAa,EACb,OAAO,EAAE,WAAW,EACpB,KAAK,EAAE,SAAS,EAChB,MAAM,EAAE,UAAU,EAClB,YAAY,GACb,EAAE,qBAAqB,sCAoNvB"}

package/dist/components/keyboard/OnScreenKeyboard.js

@@ -1,53 +1,54 @@
 "use client";
 import { jsx as y } from "react/jsx-runtime";
-import { FloatingPortal as W } from "@floating-ui/react";
-import { useState as K, useEffect as k, useMemo as X, useCallback as O } from "react";
-import { useAsheeConfig as G } from "../../libs/context.js";
-import { Button as I } from "../button/Button.js";
-import { useKeyboard as J } from "./keyboard-context.js";
-import { cn as P } from "../../utils/cn.js";
-function Q(e) {
+import { FloatingPortal as I } from "@floating-ui/react";
+import { useState as C, useEffect as k, useMemo as U, useCallback as B } from "react";
+import { useAsheeConfig as W } from "../../libs/context.js";
+import { Button as X } from "../button/Button.js";
+import { FALLBACK_KEYBOARD_CONFIG as L } from "./keyboard-config.js";
+import { useKeyboard as Y } from "./keyboard-context.js";
+import { cn as D } from "../../utils/cn.js";
+function J(e) {
   return e === "{space}" ? "flex-[4]" : ["{bksp}", "{enter}", "{shift}", "{symbols}", "{abc}", "{clear}"].includes(
     e
   ) ? "flex-[1.6]" : "flex-1";
 }
-function T(e, o, i) {
+function P(e, o, i) {
   var g;
-  const h = Object.getPrototypeOf(e), w = (g = Object.getOwnPropertyDescriptor(h, "value")) == null ? void 0 : g.set;
+  const m = Object.getPrototypeOf(e), w = (g = Object.getOwnPropertyDescriptor(m, "value")) == null ? void 0 : g.set;
   w ? w.call(e, o) : e.value = o, e.dispatchEvent(new Event("input", { bubbles: !0 })), requestAnimationFrame(() => {
     e.focus(), e.setSelectionRange(i, i);
   });
 }
-function Y(e, o, i) {
+function Q(e, o, i) {
   return o !== i ? { value: e.slice(0, o) + e.slice(i), cursor: o } : o === 0 ? { value: e, cursor: 0 } : {
     value: e.slice(0, o - 1) + e.slice(i),
     cursor: o - 1
   };
 }
-function $(e) {
-  return (o, i, h) => ({
-    value: o.slice(0, i) + e + o.slice(h),
+function T(e) {
+  return (o, i, m) => ({
+    value: o.slice(0, i) + e + o.slice(m),
     cursor: i + e.length
   });
 }
-function oe({
+function ce({
   className: e,
   heightClass: o,
   initialLayout: i,
-  variant: h,
+  variant: m,
   color: w,
   radius: g,
-  keyClassName: j
+  keyClassName: $
 }) {
-  const E = J();
+  const E = Y();
   if (!E) return null;
-  const { isOpen: m, activeElement: n, config: l, forceClose: S } = E, L = G(), b = l.layouts ?? {}, D = l.display ?? {}, B = o ?? l.heightClass, c = l.defaultLayout ?? "default", H = h ?? l.variant ?? L.defaultVariant ?? "solid", M = w ?? l.color ?? L.defaultColor ?? "primary", V = g ?? l.radius, [u, v] = K(
+  const { isOpen: h, activeElement: n, config: l, forceClose: S } = E, A = W(), b = l.layouts ?? {}, j = l.display ?? {}, F = o, c = l.defaultLayout ?? L.defaultLayout, H = m ?? l.variant ?? A.defaultVariant ?? L.variant, M = w ?? l.color ?? A.defaultColor ?? L.color, V = g ?? l.radius, [u, v] = C(
     i ?? c
-  ), [F, R] = K(/* @__PURE__ */ new Set()), [q, A] = K(null);
+  ), [_, R] = C(/* @__PURE__ */ new Set()), [q, N] = C(null);
   k(() => {
-    m && v(i ?? c);
-  }, [m, i, c]);
-  const z = X(() => (b[u] || b[c] || []).map((a, t) => ({
+    h && v(i ?? c);
+  }, [h, i, c]);
+  const z = U(() => (b[u] || b[c] || []).map((a, t) => ({
     id: `${u}-row-${t}`,
     keys: a.split(" ").map((f, d) => ({
       id: `${u}-r${t}-k${d}-${f}`,
@@ -55,33 +56,33 @@ function oe({
     }))
   })), [b, u, c]);
   k(() => {
-    if (!m) return;
+    if (!h) return;
     const a = (b[u] || []).join(" ").split(" "), t = (s) => s === "Backspace" ? "{bksp}" : s === "Enter" ? "{enter}" : s === " " ? "{space}" : s === "Shift" ? "{shift}" : s.length === 1 && a.includes(s) ? s : null, f = (s) => {
       if (s.key === "Escape") {
         S();
         return;
       }
       const p = t(s.key);
-      p && R((C) => new Set(C).add(p));
+      p && R((x) => new Set(x).add(p));
     }, d = (s) => {
       const p = t(s.key);
-      p && R((C) => {
-        const N = new Set(C);
-        return N.delete(p), N;
+      p && R((x) => {
+        const O = new Set(x);
+        return O.delete(p), O;
       });
     };
     return window.addEventListener("keydown", f), window.addEventListener("keyup", d), () => {
       window.removeEventListener("keydown", f), window.removeEventListener("keyup", d);
     };
-  }, [m, u, b, S]);
-  const x = O(
+  }, [h, u, b, S]);
+  const K = B(
     (r) => {
       if (!n) return;
       const a = n.value, t = n.selectionStart ?? a.length, f = n.selectionEnd ?? a.length, { value: d, cursor: s } = r(a, t, f);
-      T(n, d, s);
+      P(n, d, s);
     },
     [n]
-  ), U = O(
+  ), G = B(
     (r) => {
       if (r === "{shift}") {
         v(
@@ -98,23 +99,23 @@ function oe({
         return;
       }
       if (r === "{clear}") {
-        n && T(n, "", 0);
+        n && P(n, "", 0);
         return;
       }
       if (r === "{enter}") {
-        (n == null ? void 0 : n.tagName) === "TEXTAREA" ? x($(`
+        (n == null ? void 0 : n.tagName) === "TEXTAREA" ? K(T(`
 `)) : n == null || n.blur();
         return;
       }
       if (r === "{bksp}") {
-        x(Y);
+        K(Q);
         return;
       }
-      x($(r === "{space}" ? " " : r)), u === "shift" && l.autoShiftBack && v(c);
+      K(T(r === "{space}" ? " " : r)), u === "shift" && l.autoShiftBack && v(c);
     },
-    [n, x, u, l.autoShiftBack, c]
+    [n, K, u, l.autoShiftBack, c]
   );
-  return m ? /* @__PURE__ */ y(W, { children: /* @__PURE__ */ y(
+  return h ? /* @__PURE__ */ y(I, { children: /* @__PURE__ */ y(
     "section",
     {
       "aria-label": "Virtual Keyboard",
@@ -123,26 +124,26 @@ function oe({
       children: /* @__PURE__ */ y(
         "div",
         {
-          className: P(
+          className: D(
             "w-full bg-background border-t border-border shadow-2xl flex flex-col select-none",
-            B,
+            F,
             e
           ),
           children: /* @__PURE__ */ y("div", { className: "flex flex-col gap-1.5 p-2 flex-1 min-h-0", children: z.map((r) => /* @__PURE__ */ y("div", { className: "flex gap-1.5 flex-1", children: r.keys.map(({ id: a, token: t }) => {
-            const s = F.has(t) || q === t, p = D[t] ?? t;
+            const s = _.has(t) || q === t, p = j[t] ?? t;
             return /* @__PURE__ */ y(
-              I,
+              X,
               {
                 variant: H,
                 color: s ? M : "secondary",
                 radius: V,
-                onClick: () => U(t),
-                onMouseEnter: () => A(t),
-                onMouseLeave: () => A(null),
-                className: P(
+                onClick: () => G(t),
+                onMouseEnter: () => N(t),
+                onMouseLeave: () => N(null),
+                className: D(
                   "h-full text-lg font-medium p-0 flex items-center justify-center",
-                  Q(t),
-                  j
+                  J(t),
+                  $
                 ),
                 children: p
               },
@@ -155,5 +156,5 @@ function oe({
   ) }) : null;
 }
 export {
-  oe as OnScreenKeyboard
+  ce as OnScreenKeyboard
 };

package/dist/components/keyboard/index.js

@@ -1,4 +1,4 @@
 export * from "./OnScreenKeyboard.js";
-export * from "./default-keyboard-config.js";
+export * from "./keyboard-config.js";
 export * from "./keyboard-context.js";
 export * from "./use-keyboard-field.js";

package/dist/components/keyboard/keyboard-config.d.ts

@@ -1,18 +1,103 @@
 import { ReactNode } from 'react';
-import { Radius } from '../../shared/radius';
-import { Color, Variant } from '../../shared/variant';
+import { Color, Radius, Variant } from '../../shared';
+/**
+ * Standard layout names for the virtual keyboard.
+ * - `default`: Lowercase alphabetic layout.
+ * - `shift`: Uppercase alphabetic layout.
+ * - `symbols`: Symbol and punctuation layout.
+ * - `numeric`: Numeric keypad layout.
+ */
 export type StandardLayoutName = "default" | "shift" | "symbols" | "numeric";
+/**
+ * Layout name type that supports custom layouts.
+ * Can be either a StandardLayoutName or a custom string identifier.
+ */
 export type LayoutName = StandardLayoutName | (string & {});
+/**
+ * Mapping of layout names to arrays of row strings.
+ * Each row string contains space-separated key tokens.
+ */
 export type KeyboardLayouts = Record<string, string[]>;
+/**
+ * Mapping of key tokens to display React nodes.
+ * Used to render special keys with icons or custom labels.
+ */
 export type KeyDisplayMap = Record<string, ReactNode>;
+/**
+ * Theme configuration options for the Keyboard component.
+ *
+ * Set under `components.keyboard` in the AsheeUI config. Values feed the
+ * component-level fallback tier of the theme cascade.
+ */
 export interface KeyboardConfig {
+    /**
+     * The layouts available for the keyboard.
+     * Maps layout names to arrays of row strings.
+     */
     layouts?: KeyboardLayouts;
+    /**
+     * Display mappings for special keys.
+     * Maps tokens like "{bksp}" to display labels.
+     */
     display?: KeyDisplayMap;
+    /**
+     * The default layout to show when the keyboard opens.
+     * @default "default"
+     */
     defaultLayout?: LayoutName;
-    heightClass?: string;
+    /**
+     * Delay in milliseconds before closing the keyboard on blur.
+     * @default 500
+     */
+    closeDelay?: number;
+    /**
+     * Whether to automatically switch back from shift after a key press.
+     * @default true
+     */
     autoShiftBack?: boolean;
+    /**
+     * Visual style variant for keyboard keys.
+     * @default "solid"
+     */
     variant?: Variant;
+    /**
+     * Theme accent color for keyboard keys.
+     * @default "primary"
+     */
     color?: Color;
+    /**
+     * Corner rounding for keyboard keys.
+     */
     radius?: Radius;
 }
+/**
+ * Default keyboard layouts.
+ * Provides alphabetic, shifted, symbols, and numeric layouts with
+ * special keys for backspace, enter, shift, layout switching, and space.
+ */
+export declare const defaultKeyboardLayouts: KeyboardLayouts;
+/**
+ * Default display mappings for special keys.
+ * Maps token names to their display labels or icons.
+ */
+export declare const defaultKeyDisplay: KeyDisplayMap;
+/**
+ * Default configuration values registered for the Keyboard component.
+ */
+export declare const defaultKeyboardConfig: KeyboardConfig;
+declare module "../../libs/registry" {
+    interface ComponentTypeConfigRegistry {
+        keyboard: KeyboardConfig;
+    }
+}
+/**
+ * Hard fallback values used when no config tier provides a value.
+ * These values are used when instance props, component config,
+ * and global defaults are all undefined.
+ */
+export declare const FALLBACK_KEYBOARD_CONFIG: {
+    defaultLayout: string;
+    variant: Variant;
+    color: Color;
+};
 //# sourceMappingURL=keyboard-config.d.ts.map

package/dist/components/keyboard/keyboard-config.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"keyboard-config.d.ts","sourceRoot":"","sources":["../../../src/components/keyboard/keyboard-config.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AACvC,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,qBAAqB,CAAC;AAClD,OAAO,KAAK,EAAE,KAAK,EAAE,OAAO,EAAE,MAAM,sBAAsB,CAAC;AAE3D,MAAM,MAAM,kBAAkB,GAAG,SAAS,GAAG,OAAO,GAAG,SAAS,GAAG,SAAS,CAAC;AAC7E,MAAM,MAAM,UAAU,GAAG,kBAAkB,GAAG,CAAC,MAAM,GAAG,EAAE,CAAC,CAAC;AAE5D,MAAM,MAAM,eAAe,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;AACvD,MAAM,MAAM,aAAa,GAAG,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;AAEtD,MAAM,WAAW,cAAc;IAC7B,OAAO,CAAC,EAAE,eAAe,CAAC;IAC1B,OAAO,CAAC,EAAE,aAAa,CAAC;IACxB,aAAa,CAAC,EAAE,UAAU,CAAC;IAC3B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,KAAK,CAAC,EAAE,KAAK,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB"}
+{"version":3,"file":"keyboard-config.d.ts","sourceRoot":"","sources":["../../../src/components/keyboard/keyboard-config.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAEvC,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAE3D;;;;;;GAMG;AACH,MAAM,MAAM,kBAAkB,GAAG,SAAS,GAAG,OAAO,GAAG,SAAS,GAAG,SAAS,CAAC;AAE7E;;;GAGG;AACH,MAAM,MAAM,UAAU,GAAG,kBAAkB,GAAG,CAAC,MAAM,GAAG,EAAE,CAAC,CAAC;AAE5D;;;GAGG;AACH,MAAM,MAAM,eAAe,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;AAEvD;;;GAGG;AACH,MAAM,MAAM,aAAa,GAAG,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;AAEtD;;;;;GAKG;AACH,MAAM,WAAW,cAAc;IAC7B;;;OAGG;IACH,OAAO,CAAC,EAAE,eAAe,CAAC;IAE1B;;;OAGG;IACH,OAAO,CAAC,EAAE,aAAa,CAAC;IAExB;;;OAGG;IACH,aAAa,CAAC,EAAE,UAAU,CAAC;IAE3B;;;OAGG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IAEpB;;;OAGG;IACH,aAAa,CAAC,EAAE,OAAO,CAAC;IAExB;;;OAGG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC;IAElB;;;OAGG;IACH,KAAK,CAAC,EAAE,KAAK,CAAC;IAEd;;OAEG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED;;;;GAIG;AACH,eAAO,MAAM,sBAAsB,EAAE,eAuBpC,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,iBAAiB,EAAE,aAQ/B,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,qBAAqB,EAAE,cAMnC,CAAC;AAEF,OAAO,QAAQ,qBAAqB,CAAC;IACnC,UAAU,2BAA2B;QACnC,QAAQ,EAAE,cAAc,CAAC;KAC1B;CACF;AAID;;;;GAIG;AACH,eAAO,MAAM,wBAAwB;;aAEf,OAAO;WACP,KAAK;CAC1B,CAAC"}

package/dist/components/keyboard/{default-keyboard-config.js → keyboard-config.js}

@@ -35,11 +35,17 @@ const s = {
   layouts: s,
   display: t,
   defaultLayout: "default",
-  heightClass: "h-[40vh] min-h-[18.75rem]",
+  closeDelay: 500,
   autoShiftBack: !0
 };
 e("keyboard", a);
+const l = {
+  defaultLayout: "default",
+  variant: "solid",
+  color: "primary"
+};
 export {
+  l as FALLBACK_KEYBOARD_CONFIG,
   t as defaultKeyDisplay,
   a as defaultKeyboardConfig,
   s as defaultKeyboardLayouts

package/dist/components/keyboard/keyboard-context.d.ts

@@ -1,31 +1,121 @@
 import { ReactNode } from 'react';
-import { Radius } from '../../shared/radius';
-import { Color, Variant } from '../../shared/variant';
-import { KeyboardConfig, KeyboardLayouts, KeyDisplayMap, LayoutName } from './keyboard-config';
+import { KeyboardConfig, LayoutName } from './keyboard-config';
+/**
+ * Type for keyboard input elements.
+ * The keyboard can attach to input and textarea elements.
+ */
 export type KeyboardElement = HTMLInputElement | HTMLTextAreaElement;
+/**
+ * Context type for the keyboard state and controls.
+ */
 export interface KeyboardContextType {
+    /**
+     * Whether the keyboard is currently open.
+     */
     isOpen: boolean;
+    /**
+     * ID of the currently active input element.
+     */
     activeInputId: string | null;
+    /**
+     * The currently active input element reference.
+     */
     activeElement: KeyboardElement | null;
+    /**
+     * The merged keyboard configuration.
+     */
     config: KeyboardConfig;
+    /**
+     * Opens the keyboard for a specific input element.
+     * @param id - The ID of the input element.
+     * @param el - The input element reference.
+     */
     openKeyboard: (id: string, el: KeyboardElement) => void;
+    /**
+     * Requests to close the keyboard for a specific input.
+     * Uses a delay to prevent accidental closing on focus transitions.
+     * @param id - The ID of the input element.
+     */
     requestClose: (id: string) => void;
+    /**
+     * Immediately closes the keyboard regardless of state.
+     */
     forceClose: () => void;
 }
+/**
+ * React context for the keyboard state.
+ */
 export declare const KeyboardContext: import('react').Context<KeyboardContextType | null>;
-export interface KeyboardProviderProps {
+/**
+ * Props for the KeyboardProvider component.
+ */
+export interface KeyboardProviderProps extends KeyboardConfig {
+    /**
+     * Child components that will have access to the keyboard context.
+     */
     children: ReactNode;
-    config?: KeyboardConfig;
-    layouts?: KeyboardLayouts;
-    display?: KeyDisplayMap;
+    /**
+     * Default layout to show when the keyboard opens.
+     * @default "default"
+     */
     defaultLayout?: LayoutName;
+    /**
+     * CSS height class for the keyboard container.
+     */
     heightClass?: string;
-    autoShiftBack?: boolean;
-    closeDelay?: number;
-    variant?: Variant;
-    color?: Color;
-    radius?: Radius;
 }
-export declare function KeyboardProvider({ children, config: propConfig, layouts, display, defaultLayout, heightClass, autoShiftBack, closeDelay, variant, color, radius, }: KeyboardProviderProps): import("react").JSX.Element;
+/**
+ * Provider component for the virtual keyboard.
+ *
+ * KeyboardProvider wraps your application or a section of it to provide
+ * keyboard context. It manages the open/close state, active input tracking,
+ * and configuration merging. Input components using useKeyboardField or
+ * the KeyboardContext will automatically trigger the keyboard on focus.
+ *
+ * @param props - KeyboardProvider configuration options.
+ * @param props.children - Child components.
+ * @param props.layouts - Available keyboard layouts.
+ * @param props.display - Display mappings for special keys.
+ * @param props.defaultLayout - Default layout name. Defaults to "default".
+ * @param props.heightClass - CSS height class for the keyboard.
+ * @param props.autoShiftBack - Auto switch back from shift. Defaults to true.
+ * @param props.closeDelay - Close delay in milliseconds. Defaults to 120.
+ * @param props.variant - Visual variant for keys.
+ * @param props.color - Theme color for keys.
+ * @param props.radius - Corner rounding for keys.
+ *
+ * @example
+ * ```tsx
+ * import { KeyboardProvider, OnScreenKeyboard, Input } from "asheeui";
+ *
+ * export function App() {
+ *   return (
+ *     <KeyboardProvider heightClass="h-56">
+ *       <Input
+ *         label="Search"
+ *         enableVirtualKeyboard
+ *       />
+ *       <OnScreenKeyboard />
+ *     </KeyboardProvider>
+ *   );
+ * }
+ * ```
+ *
+ * @see useKeyboard - Hook for accessing the keyboard context.
+ * @see OnScreenKeyboard - The keyboard UI component.
+ */
+export declare function KeyboardProvider({ children, layouts, display, defaultLayout, heightClass, autoShiftBack, closeDelay, variant, color, radius, }: KeyboardProviderProps): import("react").JSX.Element;
+/**
+ * Hook for accessing the keyboard context.
+ * Must be used within a KeyboardProvider.
+ *
+ * @returns The keyboard context value.
+ * @throws {Error} When used outside of a KeyboardProvider.
+ *
+ * @example
+ * ```tsx
+ * const { isOpen, openKeyboard, forceClose } = useKeyboard();
+ * ```
+ */
 export declare function useKeyboard(): KeyboardContextType;
 //# sourceMappingURL=keyboard-context.d.ts.map

package/dist/components/keyboard/keyboard-context.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"keyboard-context.d.ts","sourceRoot":"","sources":["../../../src/components/keyboard/keyboard-context.tsx"],"names":[],"mappings":"AAEA,OAAO,EAEL,KAAK,SAAS,EAMf,MAAM,OAAO,CAAC;AAEf,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,qBAAqB,CAAC;AAClD,OAAO,KAAK,EAAE,KAAK,EAAE,OAAO,EAAE,MAAM,sBAAsB,CAAC;AAE3D,OAAO,KAAK,EACV,cAAc,EACd,eAAe,EACf,aAAa,EACb,UAAU,EACX,MAAM,mBAAmB,CAAC;AAE3B,MAAM,MAAM,eAAe,GAAG,gBAAgB,GAAG,mBAAmB,CAAC;AAErE,MAAM,WAAW,mBAAmB;IAClC,MAAM,EAAE,OAAO,CAAC;IAChB,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,aAAa,EAAE,eAAe,GAAG,IAAI,CAAC;IACtC,MAAM,EAAE,cAAc,CAAC;IACvB,YAAY,EAAE,CAAC,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,eAAe,KAAK,IAAI,CAAC;IACxD,YAAY,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,IAAI,CAAC;IACnC,UAAU,EAAE,MAAM,IAAI,CAAC;CACxB;AAED,eAAO,MAAM,eAAe,qDAAkD,CAAC;AAE/E,MAAM,WAAW,qBAAqB;IACpC,QAAQ,EAAE,SAAS,CAAC;IACpB,MAAM,CAAC,EAAE,cAAc,CAAC;IACxB,OAAO,CAAC,EAAE,eAAe,CAAC;IAC1B,OAAO,CAAC,EAAE,aAAa,CAAC;IACxB,aAAa,CAAC,EAAE,UAAU,CAAC;IAC3B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,KAAK,CAAC,EAAE,KAAK,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,wBAAgB,gBAAgB,CAAC,EAC/B,QAAQ,EACR,MAAM,EAAE,UAAU,EAClB,OAAO,EACP,OAAO,EACP,aAAa,EACb,WAAW,EACX,aAAa,EACb,UAAgB,EAChB,OAAO,EACP,KAAK,EACL,MAAM,GACP,EAAE,qBAAqB,+BA4HvB;AAED,wBAAgB,WAAW,wBAM1B"}
+{"version":3,"file":"keyboard-context.d.ts","sourceRoot":"","sources":["../../../src/components/keyboard/keyboard-context.tsx"],"names":[],"mappings":"AASA,OAAO,EAEL,KAAK,SAAS,EAMf,MAAM,OAAO,CAAC;AAEf,OAAO,EAEL,KAAK,cAAc,EAEnB,KAAK,UAAU,EAChB,MAAM,mBAAmB,CAAC;AAE3B;;;GAGG;AACH,MAAM,MAAM,eAAe,GAAG,gBAAgB,GAAG,mBAAmB,CAAC;AAErE;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC;;OAEG;IACH,MAAM,EAAE,OAAO,CAAC;IAEhB;;OAEG;IACH,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;IAE7B;;OAEG;IACH,aAAa,EAAE,eAAe,GAAG,IAAI,CAAC;IAEtC;;OAEG;IACH,MAAM,EAAE,cAAc,CAAC;IAEvB;;;;OAIG;IACH,YAAY,EAAE,CAAC,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,eAAe,KAAK,IAAI,CAAC;IAExD;;;;OAIG;IACH,YAAY,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,IAAI,CAAC;IAEnC;;OAEG;IACH,UAAU,EAAE,MAAM,IAAI,CAAC;CACxB;AAED;;GAEG;AACH,eAAO,MAAM,eAAe,qDAAkD,CAAC;AAE/E;;GAEG;AACH,MAAM,WAAW,qBAAsB,SAAQ,cAAc;IAC3D;;OAEG;IACH,QAAQ,EAAE,SAAS,CAAC;IAEpB;;;OAGG;IACH,aAAa,CAAC,EAAE,UAAU,CAAC;IAE3B;;OAEG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAuCG;AACH,wBAAgB,gBAAgB,CAAC,EAC/B,QAAQ,EACR,OAAO,EACP,OAAO,EACP,aAAa,EACb,WAAW,EACX,aAAa,EACb,UAAgB,EAChB,OAAO,EACP,KAAK,EACL,MAAM,GACP,EAAE,qBAAqB,+BAmHvB;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,WAAW,wBAM1B"}