@kjun-ui/native 0.9.0 → 0.10.0

package/dist/index.js

@@ -26,9 +26,23 @@ function mergeIcons(parent, own) {
 function withFallbackIcons(registry, fallbacks) {
   return mergeIcons(fallbacks, registry);
 }
+var warnedIcons = /* @__PURE__ */ new Set();
+function developmentMode() {
+  try {
+    return true;
+  } catch (e) {
+    return false;
+  }
+}
+function warnMissingIcon(name) {
+  if (!developmentMode() || warnedIcons.has(name)) return;
+  warnedIcons.add(name);
+  console.warn(`KJUN Icon: "${name}" \uC544\uC774\uCF58\uC774 \uB4F1\uB85D\uB418\uC9C0 \uC54A\uC544 help-circle\uB85C \uB300\uC2E0\uD569\uB2C8\uB2E4. @kjun-ui/icons/icons/${name}\uB97C import\uD574 KjunProvider\uC758 icons\uC5D0 \uB4F1\uB85D\uD558\uC138\uC694.`);
+}
 function resolveIcon(registry, name, filled = false) {
   var _a;
   const definition = Object.prototype.hasOwnProperty.call(registry, name) ? registry[name] : void 0;
+  if (!definition && name) warnMissingIcon(name);
   const filledNodes = filled && (definition == null ? void 0 : definition.filled);
   return { nodes: filledNodes || (definition == null ? void 0 : definition.outline) || ((_a = registry["help-circle"]) == null ? void 0 : _a.outline) || defaultIcons["help-circle"].outline, filled: !!filledNodes };
 }
@@ -693,6 +707,7 @@ function KjunButton(input) {
     size: declaredSize = "md",
     loading = false,
     block = false,
+    wrap = false,
     disabled = false,
     prefixIcon,
     suffixIcon,
@@ -713,7 +728,7 @@ function KjunButton(input) {
   const formActions = useContext5(FormActionsContext);
   const cardActions = useContext5(CardActionsContext);
   const stateContent = useContext5(DataStateContentContext);
-  const multiline = !!formActions || cardActions || !!stateContent || (navigation == null ? void 0 : navigation.slot) === "actions";
+  const multiline = wrap || !!formActions || cardActions || !!stateContent || (navigation == null ? void 0 : navigation.slot) === "actions";
   const height = Math.max(tokens3.button.heights[size], (_a = navigation == null ? void 0 : navigation.controlSize) != null ? _a : 0);
   const iconSize = (_b = navigation == null ? void 0 : navigation.iconSize) != null ? _b : tokens3.button.iconSizes[size];
   const hasContent2 = children !== void 0 && children !== null && children !== false && children !== "";
@@ -874,6 +889,16 @@ function FieldClear({ size, disabled, label, onPress }) {
   );
 }
 
+// shared/package-runtime/aria-ids.ts
+function mergeIds(...lists) {
+  const ids = [...new Set(lists.flatMap((list) => (list != null ? list : "").split(/\s+/)).filter(Boolean))];
+  return ids.length ? ids.join(" ") : void 0;
+}
+function joinHints(...parts) {
+  const text = parts.filter(Boolean);
+  return text.length ? text.join(". ") : void 0;
+}
+
 // packages/native/src/field-surface.ts
 import { useState as useState6 } from "react";
 import { Animated as Animated3, Platform as Platform5, TextInput } from "react-native";
@@ -1061,6 +1086,7 @@ function KjunFormGroup({
   required = false,
   error = "",
   hint = "",
+  labelHidden = false,
   children,
   style
 }) {
@@ -1070,9 +1096,17 @@ function KjunFormGroup({
   return /* @__PURE__ */ jsx8(
     FieldContext.Provider,
     {
-      value: { id: fieldId, label, error, hint, required, describedBy: error ? fieldId + "-error" : hint ? fieldId + "-hint" : void 0 },
+      value: {
+        id: fieldId,
+        label,
+        error,
+        hint,
+        required,
+        labelHidden,
+        describedBy: mergeIds(hint ? fieldId + "-hint" : void 0, error ? fieldId + "-error" : void 0)
+      },
       children: /* @__PURE__ */ jsxs2(View4, { style: [{ minWidth: 0, marginBottom: tokens7.extensions.form.itemGap }, style], children: [
-        label && /* @__PURE__ */ jsxs2(
+        label && !labelHidden && /* @__PURE__ */ jsxs2(
           Text3,
           {
             nativeID: fieldId + "-label",
@@ -1089,7 +1123,15 @@ function KjunFormGroup({
           }
         ),
         children,
-        (error || hint) && /* @__PURE__ */ jsxs2(
+        !!hint && /* @__PURE__ */ jsx8(
+          Text3,
+          {
+            nativeID: fieldId + "-hint",
+            style: { fontFamily, ...typeStyle("caption"), marginTop: tokens7.extensions.form.messageGap, color: c.textSecondary },
+            children: hint
+          }
+        ),
+        !!error && /* @__PURE__ */ jsxs2(
           View4,
           {
             style: {
@@ -1099,19 +1141,14 @@ function KjunFormGroup({
               marginTop: tokens7.extensions.form.messageGap
             },
             children: [
-              !!error && /* @__PURE__ */ jsx8(KjunIcon, { name: "alert-circle", size: tokens7.extensions.form.messageIconSize, color: c.danger }),
+              /* @__PURE__ */ jsx8(KjunIcon, { name: "alert-circle", size: tokens7.extensions.form.messageIconSize, color: c.danger }),
               /* @__PURE__ */ jsx8(
                 Text3,
                 {
-                  nativeID: fieldId + (error ? "-error" : "-hint"),
-                  accessibilityRole: error ? "alert" : void 0,
-                  style: {
-                    fontFamily,
-                    ...typeStyle("caption"),
-                    flexShrink: 1,
-                    color: error ? c.danger : c.textSecondary
-                  },
-                  children: error || hint
+                  nativeID: fieldId + "-error",
+                  accessibilityRole: "alert",
+                  style: { fontFamily, ...typeStyle("caption"), flexShrink: 1, color: c.danger },
+                  children: error
                 }
               )
             ]
@@ -1185,8 +1222,8 @@ var KjunInput = forwardRef2(function KjunInput2({
           editable: canEdit,
           readOnly,
           accessibilityLabel: ariaLabel || props.accessibilityLabel || (field == null ? void 0 : field.label),
-          accessibilityLabelledBy: (field == null ? void 0 : field.label) ? field.id + "-label" : void 0,
-          accessibilityHint: errorMessage || (field == null ? void 0 : field.error) || (field == null ? void 0 : field.hint) || props.accessibilityHint,
+          accessibilityLabelledBy: (field == null ? void 0 : field.label) && !field.labelHidden ? field.id + "-label" : void 0,
+          accessibilityHint: joinHints(field == null ? void 0 : field.hint, errorMessage || (field == null ? void 0 : field.error)) || props.accessibilityHint,
           accessibilityState: { disabled },
           ...Platform6.OS === "web" ? {
             // Native Web TextInput does not translate accessibilityState.
@@ -1784,6 +1821,13 @@ function KjunCard({
   ] });
 }
 
+// shared/package-runtime/alert-live.ts
+function alertRole(tone, live) {
+  if (live === "off") return void 0;
+  if (live) return live === "assertive" ? "alert" : "status";
+  return tone === "danger" ? "alert" : "status";
+}
+
 // packages/native/src/display-primitives.tsx
 import { tokens as tokens10 } from "@kjun-ui/tokens";
 import { useContext as useContext8, useEffect as useEffect5, useRef as useRef6, useState as useState9 } from "react";
@@ -1981,6 +2025,7 @@ function KjunAlert({
   size = "md",
   title,
   closable = false,
+  live,
   children,
   actions,
   onClose
@@ -1997,7 +2042,7 @@ function KjunAlert({
   return /* @__PURE__ */ jsxs6(
     View9,
     {
-      role: tone === "danger" ? "alert" : "status",
+      role: alertRole(tone, live),
       style: {
         flexDirection: "row",
         alignItems: "flex-start",
@@ -3447,13 +3492,13 @@ var KjunTextarea = forwardRef3(
         editable: !disabled && !readonly && !props.readOnly && props.editable !== false,
         nativeID: props.nativeID || (field == null ? void 0 : field.id),
         accessibilityLabel: ariaLabel || props.accessibilityLabel || (field == null ? void 0 : field.label),
-        accessibilityHint: (field == null ? void 0 : field.error) || (field == null ? void 0 : field.hint) || props.accessibilityHint,
+        accessibilityHint: joinHints(field == null ? void 0 : field.hint, field == null ? void 0 : field.error) || props.accessibilityHint,
         accessibilityState: { disabled },
         ...Platform13.OS === "web" ? {
           "aria-disabled": disabled,
           "aria-invalid": invalid || void 0,
           "aria-describedby": field == null ? void 0 : field.describedBy,
-          "aria-labelledby": (field == null ? void 0 : field.label) ? field.id + "-label" : void 0,
+          "aria-labelledby": (field == null ? void 0 : field.label) && !field.labelHidden ? field.id + "-label" : void 0,
           "aria-required": (field == null ? void 0 : field.required) || void 0
         } : {},
         placeholderTextColor: disabled ? colors.textDisabled : colors.inputPlaceholder,
@@ -3723,8 +3768,11 @@ function FloatingPanel({
   flip = true,
   minimumWidth = 0,
   focusOnOpen = false,
-  reveal
+  reveal,
+  header,
+  nonModal = false
 }) {
+  const [headerHeight, setHeaderHeight] = useState16(0);
   const panelRef = useRef16(null);
   const scroll = useRef16(null), viewport = useRef16(0);
   const { colors } = useKjunStyles(), window2 = useWindowDimensions4(), [anchored, setAnchored] = useState16(false), [sized, setSized] = useState16(false), [anchor, setAnchor] = useState16({ x: 0, y: 0, width: 0, height: 0 }), [panel, setPanel] = useState16({ width: 0, height: 0 });
@@ -3779,7 +3827,7 @@ function FloatingPanel({
     maximumWidth,
     Math.max(minimumPanelWidth, contentSizedMenu ? panel.width : matchTriggerWidth ? anchor.width : tokens21.extensions.popover.width)
   );
-  const available = Math.min(maxHeight != null ? maxHeight : field ? tokens21.extensions.menu.listMaxHeight : tokens21.extensions.floating.maxHeight, window2.height - 2 * tokens21.extensions.floating.viewportInset), height = Math.min(panel.height, available), roomAbove = anchor.y - gap - tokens21.extensions.floating.viewportInset, roomBelow = window2.height - anchor.y - anchor.height - gap - tokens21.extensions.floating.viewportInset, above = placement.startsWith("top") ? !(flip && height > roomAbove && roomBelow > roomAbove) : flip && height > roomBelow && roomAbove > roomBelow;
+  const available = Math.min(maxHeight != null ? maxHeight : field ? tokens21.extensions.menu.listMaxHeight : tokens21.extensions.floating.maxHeight, window2.height - 2 * tokens21.extensions.floating.viewportInset), height = Math.min(panel.height + (header != null ? headerHeight : 0), available), roomAbove = anchor.y - gap - tokens21.extensions.floating.viewportInset, roomBelow = window2.height - anchor.y - anchor.height - gap - tokens21.extensions.floating.viewportInset, above = placement.startsWith("top") ? !(flip && height > roomAbove && roomBelow > roomAbove) : flip && height > roomBelow && roomAbove > roomBelow;
   let left = placement.endsWith("end") ? anchor.x + anchor.width - width : placement === "top" || placement === "bottom" ? anchor.x + (anchor.width - width) / 2 : anchor.x, top = above ? anchor.y - height - gap : anchor.y + anchor.height + gap;
   if (placement === "left" || placement === "right") {
     left = placement === "left" ? anchor.x - width - gap : anchor.x + anchor.width + gap;
@@ -3863,7 +3911,7 @@ function FloatingPanel({
                 }
               }
             ),
-            /* @__PURE__ */ jsx24(
+            /* @__PURE__ */ jsxs14(
               Animated13.View,
               {
                 ref: panelRef,
@@ -3874,7 +3922,7 @@ function FloatingPanel({
                 pointerEvents: open && anchored && sized ? "auto" : "none",
                 accessibilityElementsHidden: !open || !anchored || !sized,
                 ...!open || !anchored || !sized ? { inert: true } : {},
-                accessibilityViewIsModal: true,
+                accessibilityViewIsModal: !nonModal,
                 accessibilityLabel: ariaLabel,
                 style: {
                   opacity: anchored && sized ? motion.opacity : 0,
@@ -3896,26 +3944,42 @@ function FloatingPanel({
                   boxShadow: (tooltip ? tokens21.extensions.tooltip.elevation : popover ? tokens21.extensions.popover.elevation : tokens21.extensions.menu.elevation).map(({ colorRole, ...layer2 }) => ({ ...layer2, color: colors[colorRole] })),
                   overflow: "hidden"
                 },
-                children: /* @__PURE__ */ jsx24(
-                  ScrollView4,
-                  {
-                    ref: scroll,
-                    onLayout: (event) => {
-                      viewport.current = event.nativeEvent.layout.height;
-                    },
-                    keyboardShouldPersistTaps: "handled",
-                    style: { maxHeight: available },
-                    contentContainerStyle: { padding: menu || field ? tokens21.extensions.menu.padding : 0 },
-                    onContentSizeChange: (width2, height2) => {
-                      if (contentSizedMenu) return;
-                      setSized(true);
-                      setPanel(
-                        (previous) => previous.width === width2 && previous.height === height2 ? previous : { width: width2, height: height2 }
-                      );
-                    },
-                    children
-                  }
-                )
+                children: [
+                  header != null && /* @__PURE__ */ jsx24(
+                    View18,
+                    {
+                      onLayout: ({ nativeEvent: { layout } }) => setHeaderHeight(layout.height),
+                      style: {
+                        paddingTop: tokens21.extensions.popover.padding,
+                        paddingHorizontal: tokens21.extensions.popover.padding,
+                        paddingBottom: tokens21.extensions.popover.headerPaddingBottom,
+                        borderBottomWidth: tokens21.border.defaultWidth,
+                        borderBottomColor: colors.divider
+                      },
+                      children: header
+                    }
+                  ),
+                  /* @__PURE__ */ jsx24(
+                    ScrollView4,
+                    {
+                      ref: scroll,
+                      onLayout: (event) => {
+                        viewport.current = event.nativeEvent.layout.height;
+                      },
+                      keyboardShouldPersistTaps: "handled",
+                      style: { maxHeight: available - (header != null ? headerHeight : 0), flexShrink: 1 },
+                      contentContainerStyle: { padding: menu || field ? tokens21.extensions.menu.padding : 0 },
+                      onContentSizeChange: (width2, height2) => {
+                        if (contentSizedMenu) return;
+                        setSized(true);
+                        setPanel(
+                          (previous) => previous.width === width2 && previous.height === height2 ? previous : { width: width2, height: height2 }
+                        );
+                      },
+                      children
+                    }
+                  )
+                ]
               }
             )
           ]
@@ -3950,9 +4014,12 @@ function KjunPopover({
   focusOnOpen = false,
   ariaLabel,
   placement = "bottom",
+  header,
+  modal = true,
   trigger,
   children
 }) {
+  const { colors } = useKjunStyles();
   const [internal, setInternal] = useState17(false), open = controlled != null ? controlled : internal, ref = useRef17(null);
   const change = (v) => {
     setInternal(v);
@@ -3981,6 +4048,8 @@ function KjunPopover({
         popover: true,
         focusOnOpen,
         ariaLabel,
+        header: header != null ? content(header, { ...typeStyle("cardTitle"), color: colors.text }) : void 0,
+        nonModal: !modal,
         children: /* @__PURE__ */ jsx25(View19, { style: { padding: noPadding ? 0 : tokens22.extensions.popover.padding, gap: noPadding ? 0 : tokens22.extensions.popover.gap }, children: content(
           typeof children === "function" ? children(() => change(false)) : children,
           Platform16.OS === "web" ? { wordBreak: "keep-all", overflowWrap: "anywhere" } : void 0
@@ -3995,9 +4064,18 @@ function KjunTooltip({
   delay = 0,
   children,
   onPress,
-  disabled
+  disabled,
+  open: controlled,
+  onOpenChange
 }) {
-  const { colors } = useKjunStyles(), [open, setOpen] = useState17(false), ref = useRef17(null), timer = useRef17(void 0);
+  const { colors } = useKjunStyles(), [internal, setInternal] = useState17(false), open = controlled != null ? controlled : internal, latest = useRef17({ open, onOpenChange }), setOpen = (value) => {
+    var _a, _b;
+    if (latest.current.open === value) return;
+    latest.current.open = value;
+    setInternal(value);
+    (_b = (_a = latest.current).onOpenChange) == null ? void 0 : _b.call(_a, value);
+  }, ref = useRef17(null), timer = useRef17(void 0);
+  latest.current = { open, onOpenChange };
   const scopeActive = useActiveLayerScope();
   const hide = () => {
     clearTimeout(timer.current);
@@ -7272,7 +7350,7 @@ function TableToolbar({
     selectable && selected.length > 0 && /* @__PURE__ */ jsxs29(
       View35,
       {
-        accessibilityRole: "toolbar",
+        role: "group",
         accessibilityLabel: "\uC120\uD0DD \uC791\uC5C5",
         style: [toolbarStyle, { backgroundColor: colors.selectedBg }],
         children: [
@@ -9624,7 +9702,7 @@ function KjunQuantityStepper({ value, min = 0, max, step = 1, precision = 0, dis
   const { colors, fontFamily } = useKjunStyles();
   const field = useKjunField();
   const invalid = error || !!(field == null ? void 0 : field.error);
-  const labelledBy = !ariaLabel && (field == null ? void 0 : field.label) ? field.id + "-label" : void 0;
+  const labelledBy = !ariaLabel && (field == null ? void 0 : field.label) && !field.labelHidden ? field.id + "-label" : void 0;
   const geometry2 = tokens57.extensions.compound;
   const buttonStyle = { width: tokens57.input[size].height, paddingHorizontal: 0 };
   const outer = tokens57.input[size].radius;
@@ -9732,7 +9810,7 @@ function KjunQuantityStepper({ value, min = 0, max, step = 1, precision = 0, dis
         nativeID: id || (field == null ? void 0 : field.id),
         accessibilityLabel: ariaLabel || (field == null ? void 0 : field.label) || "\uC218\uB7C9",
         accessibilityLabelledBy: labelledBy,
-        accessibilityHint: (field == null ? void 0 : field.error) || (field == null ? void 0 : field.hint),
+        accessibilityHint: joinHints(field == null ? void 0 : field.hint, field == null ? void 0 : field.error),
         role: "spinbutton",
         accessibilityValue: { min, max, now: value },
         accessibilityState: { disabled: blocked },