@kjun-ui/native 0.15.0 → 0.17.0

package/dist/types/packages/native/src/popover.d.ts

@@ -21,6 +21,11 @@ export interface KjunPopoverProps {
 export declare function KjunPopover({ noPadding, open: controlled, onOpenChange, manualTrigger, matchTriggerWidth, maxHeight, flip, focusOnOpen, ariaLabel, placement, header, modal, trigger, children, }: KjunPopoverProps): import("react/jsx-runtime").JSX.Element;
 export interface KjunTooltipProps extends Pick<PressableProps, "onPress" | "disabled"> {
     content?: string;
+    /** A bolder line above content (a file name above its path). Read together with content. */
+    title?: string;
+    align?: "start" | "center";
+    /** Maximum width step (tooltip.maxWidths); default is md, the earlier width. */
+    width?: "sm" | "md" | "lg";
     placement?: "top" | "bottom" | "left" | "right";
     delay?: number;
     /** Controlled visibility; omit to let hover and focus drive it. */
@@ -28,4 +33,4 @@ export interface KjunTooltipProps extends Pick<PressableProps, "onPress" | "disa
     onOpenChange?: (open: boolean) => void;
     children: ReactNode;
 }
-export declare function KjunTooltip({ content: message, placement, delay, children, onPress, disabled, open: controlled, onOpenChange, }: KjunTooltipProps): import("react/jsx-runtime").JSX.Element;
+export declare function KjunTooltip({ content: body, title, align, width, placement, delay, children, onPress, disabled, open: controlled, onOpenChange, }: KjunTooltipProps): import("react/jsx-runtime").JSX.Element;

package/dist/types/packages/native/src/progress.d.cts

@@ -0,0 +1,16 @@
+import { type ReactNode } from "react";
+import type { SemanticTone } from "./display-primitives.cjs";
+export interface KjunProgressProps {
+    /** null is missing data; omission keeps the zero default. */
+    value?: number | null;
+    /** Work is active but its completion percentage is unknown; takes precedence over null. */
+    indeterminate?: boolean;
+    max?: number;
+    size?: "sm" | "md" | "lg";
+    variant?: SemanticTone;
+    showLabel?: boolean;
+    label?: ReactNode;
+    subLabel?: ReactNode;
+    shape?: "bar" | "circle";
+}
+export declare function KjunProgress({ value, indeterminate, max, size, variant, showLabel, label, subLabel, shape, }: KjunProgressProps): import("react/jsx-runtime").JSX.Element;

package/dist/types/packages/native/src/progress.d.ts

@@ -0,0 +1,16 @@
+import { type ReactNode } from "react";
+import type { SemanticTone } from "./display-primitives.js";
+export interface KjunProgressProps {
+    /** null is missing data; omission keeps the zero default. */
+    value?: number | null;
+    /** Work is active but its completion percentage is unknown; takes precedence over null. */
+    indeterminate?: boolean;
+    max?: number;
+    size?: "sm" | "md" | "lg";
+    variant?: SemanticTone;
+    showLabel?: boolean;
+    label?: ReactNode;
+    subLabel?: ReactNode;
+    shape?: "bar" | "circle";
+}
+export declare function KjunProgress({ value, indeterminate, max, size, variant, showLabel, label, subLabel, shape, }: KjunProgressProps): import("react/jsx-runtime").JSX.Element;

package/dist/types/packages/native/src/range-input.d.cts

@@ -6,6 +6,10 @@ export interface KjunSliderProps {
     disabled?: boolean;
     label?: string;
     ariaLabel?: string;
+    /** Hides the visible value only; each thumb still reports its value to assistive technology. */
+    showValue?: boolean;
+    /** Formats the visible value and each thumb's accessible value text. Values stay numeric. */
+    formatValue?: (value: number) => string;
     onValueChange?: (value: number) => void;
     onChangeCommit?: (value: number) => void;
 }

package/dist/types/packages/native/src/range-input.d.ts

@@ -6,6 +6,10 @@ export interface KjunSliderProps {
     disabled?: boolean;
     label?: string;
     ariaLabel?: string;
+    /** Hides the visible value only; each thumb still reports its value to assistive technology. */
+    showValue?: boolean;
+    /** Formats the visible value and each thumb's accessible value text. Values stay numeric. */
+    formatValue?: (value: number) => string;
     onValueChange?: (value: number) => void;
     onChangeCommit?: (value: number) => void;
 }

package/dist/types/shared/package-runtime/alert-tone.d.cts

@@ -0,0 +1,11 @@
+/**
+ * Color roles a soft-fill Alert paints per tone. Info has no fill role: it uses a translucent text tint so it
+ * stays visible on any page background; the semantic tones carry the color, titles stay on the text role.
+ */
+export declare function alertToneRoles(tone: string): {
+    bg: string | null;
+    icon: string;
+};
+export declare const alertIcons: Record<string, string>;
+/** Native has no color-mix: tints a hex or rgb() color with alpha, or returns undefined for other formats. */
+export declare function tintColor(color: string, alpha: number): string | undefined;

package/dist/types/shared/package-runtime/alert-tone.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Color roles a soft-fill Alert paints per tone. Info has no fill role: it uses a translucent text tint so it
+ * stays visible on any page background; the semantic tones carry the color, titles stay on the text role.
+ */
+export declare function alertToneRoles(tone: string): {
+    bg: string | null;
+    icon: string;
+};
+export declare const alertIcons: Record<string, string>;
+/** Native has no color-mix: tints a hex or rgb() color with alpha, or returns undefined for other formats. */
+export declare function tintColor(color: string, alpha: number): string | undefined;

package/dist/types/shared/package-runtime/drawer-geometry.d.cts

@@ -18,15 +18,21 @@ export interface DrawerFrame {
     lift: number;
 }
 /**
- * Keyboard events a drawer listens to. Only iOS: React Native's Android Modal window is adjustResize,
- * so the system already shrinks the modal and a measured root height covers it.
+ * Keyboard events a drawer listens to. Android reports only after the keyboard moved; edge-to-edge
+ * windows no longer resize for it (adjustResize), so the drawer lifts itself there too.
  */
 export declare function keyboardEvents(os: string): {
     readonly show: "keyboardWillShow";
     readonly hide: "keyboardWillHide";
+} | {
+    readonly show: "keyboardDidShow";
+    readonly hide: "keyboardDidHide";
 } | null;
-/** The part of the window the keyboard covers; 0 when the platform already resized the window. */
-export declare function keyboardOverlap(windowHeight: number, keyboardScreenY: number): number;
+/**
+ * The part of the modal root the keyboard covers. Measured against the root, a window the platform
+ * already resized ends at or above the keyboard and gives 0, so the drawer never lifts twice.
+ */
+export declare function keyboardOverlap(rootHeight: number, keyboardScreenY: number): number;
 export declare function drawerFrame({ position, windowHeight, safeAreaTop, safeAreaBottom, gap, keyboard, maxHeight }: DrawerFrameInput): DrawerFrame;
 /** Web overlay variables read by the drawer CSS (tokens controls.css). */
 export declare function drawerOverlayVars({ safeAreaTop, safeAreaBottom, maxHeight }: {

package/dist/types/shared/package-runtime/drawer-geometry.d.ts

@@ -18,15 +18,21 @@ export interface DrawerFrame {
     lift: number;
 }
 /**
- * Keyboard events a drawer listens to. Only iOS: React Native's Android Modal window is adjustResize,
- * so the system already shrinks the modal and a measured root height covers it.
+ * Keyboard events a drawer listens to. Android reports only after the keyboard moved; edge-to-edge
+ * windows no longer resize for it (adjustResize), so the drawer lifts itself there too.
  */
 export declare function keyboardEvents(os: string): {
     readonly show: "keyboardWillShow";
     readonly hide: "keyboardWillHide";
+} | {
+    readonly show: "keyboardDidShow";
+    readonly hide: "keyboardDidHide";
 } | null;
-/** The part of the window the keyboard covers; 0 when the platform already resized the window. */
-export declare function keyboardOverlap(windowHeight: number, keyboardScreenY: number): number;
+/**
+ * The part of the modal root the keyboard covers. Measured against the root, a window the platform
+ * already resized ends at or above the keyboard and gives 0, so the drawer never lifts twice.
+ */
+export declare function keyboardOverlap(rootHeight: number, keyboardScreenY: number): number;
 export declare function drawerFrame({ position, windowHeight, safeAreaTop, safeAreaBottom, gap, keyboard, maxHeight }: DrawerFrameInput): DrawerFrame;
 /** Web overlay variables read by the drawer CSS (tokens controls.css). */
 export declare function drawerOverlayVars({ safeAreaTop, safeAreaBottom, maxHeight }: {

package/dist/types/shared/package-runtime/progress-circle.d.cts

@@ -9,3 +9,8 @@ export declare function progressCircle(size: ProgressCircleSize, percentage: num
     offset: number;
     showsPercentage: boolean;
 };
+/**
+ * What a progress value means: indeterminate work wins, then a null, non-finite value or an invalid max is
+ * missing data (never 0%). An omitted value keeps the 0 default before it reaches here.
+ */
+export declare function progressState(value: number | null, max: number, indeterminate: boolean): "indeterminate" | "missing" | "determinate";

package/dist/types/shared/package-runtime/progress-circle.d.ts

@@ -9,3 +9,8 @@ export declare function progressCircle(size: ProgressCircleSize, percentage: num
     offset: number;
     showsPercentage: boolean;
 };
+/**
+ * What a progress value means: indeterminate work wins, then a null, non-finite value or an invalid max is
+ * missing data (never 0%). An omitted value keeps the 0 default before it reaches here.
+ */
+export declare function progressState(value: number | null, max: number, indeterminate: boolean): "indeterminate" | "missing" | "determinate";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kjun-ui/native",
-  "version": "0.15.0",
+  "version": "0.17.0",
   "license": "MIT",
   "homepage": "https://ui.kjun.dev",
   "repository": {
@@ -47,8 +47,8 @@
     "./package.json": "./package.json"
   },
   "dependencies": {
-    "@kjun-ui/tokens": "0.15.0",
-    "@kjun-ui/icons": "0.15.0"
+    "@kjun-ui/tokens": "0.17.0",
+    "@kjun-ui/icons": "0.17.0"
   },
   "peerDependencies": {
     "react": "^19.2.3",