@kjun-ui/native 0.9.0 → 0.10.0

package/dist/index.cjs

@@ -141,9 +141,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) || import_defaults.defaultIcons["help-circle"].outline, filled: !!filledNodes };
 }
@@ -783,6 +797,7 @@ function KjunButton(input) {
     size: declaredSize = "md",
     loading = false,
     block = false,
+    wrap = false,
     disabled = false,
     prefixIcon,
     suffixIcon,
@@ -803,7 +818,7 @@ function KjunButton(input) {
   const formActions = (0, import_react12.useContext)(FormActionsContext);
   const cardActions = (0, import_react12.useContext)(CardActionsContext);
   const stateContent = (0, import_react12.useContext)(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(import_tokens5.tokens.button.heights[size], (_a = navigation == null ? void 0 : navigation.controlSize) != null ? _a : 0);
   const iconSize = (_b = navigation == null ? void 0 : navigation.iconSize) != null ? _b : import_tokens5.tokens.button.iconSizes[size];
   const hasContent2 = children !== void 0 && children !== null && children !== false && children !== "";
@@ -964,6 +979,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
 var import_react15 = require("react");
 var import_react_native7 = require("react-native");
@@ -1132,6 +1157,7 @@ function KjunFormGroup({
   required = false,
   error = "",
   hint = "",
+  labelHidden = false,
   children,
   style
 }) {
@@ -1141,9 +1167,17 @@ function KjunFormGroup({
   return /* @__PURE__ */ (0, import_jsx_runtime8.jsx)(
     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__ */ (0, import_jsx_runtime8.jsxs)(import_react_native8.View, { style: [{ minWidth: 0, marginBottom: import_tokens9.tokens.extensions.form.itemGap }, style], children: [
-        label && /* @__PURE__ */ (0, import_jsx_runtime8.jsxs)(
+        label && !labelHidden && /* @__PURE__ */ (0, import_jsx_runtime8.jsxs)(
           import_react_native8.Text,
           {
             nativeID: fieldId + "-label",
@@ -1160,7 +1194,15 @@ function KjunFormGroup({
           }
         ),
         children,
-        (error || hint) && /* @__PURE__ */ (0, import_jsx_runtime8.jsxs)(
+        !!hint && /* @__PURE__ */ (0, import_jsx_runtime8.jsx)(
+          import_react_native8.Text,
+          {
+            nativeID: fieldId + "-hint",
+            style: { fontFamily, ...typeStyle("caption"), marginTop: import_tokens9.tokens.extensions.form.messageGap, color: c.textSecondary },
+            children: hint
+          }
+        ),
+        !!error && /* @__PURE__ */ (0, import_jsx_runtime8.jsxs)(
           import_react_native8.View,
           {
             style: {
@@ -1170,19 +1212,14 @@ function KjunFormGroup({
               marginTop: import_tokens9.tokens.extensions.form.messageGap
             },
             children: [
-              !!error && /* @__PURE__ */ (0, import_jsx_runtime8.jsx)(KjunIcon, { name: "alert-circle", size: import_tokens9.tokens.extensions.form.messageIconSize, color: c.danger }),
+              /* @__PURE__ */ (0, import_jsx_runtime8.jsx)(KjunIcon, { name: "alert-circle", size: import_tokens9.tokens.extensions.form.messageIconSize, color: c.danger }),
               /* @__PURE__ */ (0, import_jsx_runtime8.jsx)(
                 import_react_native8.Text,
                 {
-                  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
                 }
               )
             ]
@@ -1256,8 +1293,8 @@ var KjunInput = (0, import_react16.forwardRef)(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 },
           ...import_react_native8.Platform.OS === "web" ? {
             // Native Web TextInput does not translate accessibilityState.
@@ -1843,6 +1880,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
 var import_tokens12 = require("@kjun-ui/tokens");
 var import_react21 = require("react");
@@ -2035,6 +2079,7 @@ function KjunAlert({
   size = "md",
   title,
   closable = false,
+  live,
   children,
   actions,
   onClose
@@ -2051,7 +2096,7 @@ function KjunAlert({
   return /* @__PURE__ */ (0, import_jsx_runtime14.jsxs)(
     import_react_native15.View,
     {
-      role: tone === "danger" ? "alert" : "status",
+      role: alertRole(tone, live),
       style: {
         flexDirection: "row",
         alignItems: "flex-start",
@@ -3472,13 +3517,13 @@ var KjunTextarea = (0, import_react32.forwardRef)(
         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 },
         ...import_react_native24.Platform.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,
@@ -3717,8 +3762,11 @@ function FloatingPanel({
   flip = true,
   minimumWidth = 0,
   focusOnOpen = false,
-  reveal
+  reveal,
+  header,
+  nonModal = false
 }) {
+  const [headerHeight, setHeaderHeight] = (0, import_react34.useState)(0);
   const panelRef = (0, import_react34.useRef)(null);
   const scroll = (0, import_react34.useRef)(null), viewport = (0, import_react34.useRef)(0);
   const { colors } = useKjunStyles(), window2 = (0, import_react_native28.useWindowDimensions)(), [anchored, setAnchored] = (0, import_react34.useState)(false), [sized, setSized] = (0, import_react34.useState)(false), [anchor, setAnchor] = (0, import_react34.useState)({ x: 0, y: 0, width: 0, height: 0 }), [panel, setPanel] = (0, import_react34.useState)({ width: 0, height: 0 });
@@ -3773,7 +3821,7 @@ function FloatingPanel({
     maximumWidth,
     Math.max(minimumPanelWidth, contentSizedMenu ? panel.width : matchTriggerWidth ? anchor.width : import_tokens23.tokens.extensions.popover.width)
   );
-  const available = Math.min(maxHeight != null ? maxHeight : field ? import_tokens23.tokens.extensions.menu.listMaxHeight : import_tokens23.tokens.extensions.floating.maxHeight, window2.height - 2 * import_tokens23.tokens.extensions.floating.viewportInset), height = Math.min(panel.height, available), roomAbove = anchor.y - gap - import_tokens23.tokens.extensions.floating.viewportInset, roomBelow = window2.height - anchor.y - anchor.height - gap - import_tokens23.tokens.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 ? import_tokens23.tokens.extensions.menu.listMaxHeight : import_tokens23.tokens.extensions.floating.maxHeight, window2.height - 2 * import_tokens23.tokens.extensions.floating.viewportInset), height = Math.min(panel.height + (header != null ? headerHeight : 0), available), roomAbove = anchor.y - gap - import_tokens23.tokens.extensions.floating.viewportInset, roomBelow = window2.height - anchor.y - anchor.height - gap - import_tokens23.tokens.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;
@@ -3857,7 +3905,7 @@ function FloatingPanel({
                 }
               }
             ),
-            /* @__PURE__ */ (0, import_jsx_runtime24.jsx)(
+            /* @__PURE__ */ (0, import_jsx_runtime24.jsxs)(
               import_react_native27.Animated.View,
               {
                 ref: panelRef,
@@ -3868,7 +3916,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,
@@ -3890,26 +3938,42 @@ function FloatingPanel({
                   boxShadow: (tooltip ? import_tokens23.tokens.extensions.tooltip.elevation : popover ? import_tokens23.tokens.extensions.popover.elevation : import_tokens23.tokens.extensions.menu.elevation).map(({ colorRole, ...layer2 }) => ({ ...layer2, color: colors[colorRole] })),
                   overflow: "hidden"
                 },
-                children: /* @__PURE__ */ (0, import_jsx_runtime24.jsx)(
-                  import_react_native28.ScrollView,
-                  {
-                    ref: scroll,
-                    onLayout: (event) => {
-                      viewport.current = event.nativeEvent.layout.height;
-                    },
-                    keyboardShouldPersistTaps: "handled",
-                    style: { maxHeight: available },
-                    contentContainerStyle: { padding: menu || field ? import_tokens23.tokens.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__ */ (0, import_jsx_runtime24.jsx)(
+                    import_react_native28.View,
+                    {
+                      onLayout: ({ nativeEvent: { layout } }) => setHeaderHeight(layout.height),
+                      style: {
+                        paddingTop: import_tokens23.tokens.extensions.popover.padding,
+                        paddingHorizontal: import_tokens23.tokens.extensions.popover.padding,
+                        paddingBottom: import_tokens23.tokens.extensions.popover.headerPaddingBottom,
+                        borderBottomWidth: import_tokens23.tokens.border.defaultWidth,
+                        borderBottomColor: colors.divider
+                      },
+                      children: header
+                    }
+                  ),
+                  /* @__PURE__ */ (0, import_jsx_runtime24.jsx)(
+                    import_react_native28.ScrollView,
+                    {
+                      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 ? import_tokens23.tokens.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
+                    }
+                  )
+                ]
               }
             )
           ]
@@ -3935,9 +3999,12 @@ function KjunPopover({
   focusOnOpen = false,
   ariaLabel,
   placement = "bottom",
+  header,
+  modal = true,
   trigger,
   children
 }) {
+  const { colors } = useKjunStyles();
   const [internal, setInternal] = (0, import_react35.useState)(false), open = controlled != null ? controlled : internal, ref = (0, import_react35.useRef)(null);
   const change = (v) => {
     setInternal(v);
@@ -3966,6 +4033,8 @@ function KjunPopover({
         popover: true,
         focusOnOpen,
         ariaLabel,
+        header: header != null ? content(header, { ...typeStyle("cardTitle"), color: colors.text }) : void 0,
+        nonModal: !modal,
         children: /* @__PURE__ */ (0, import_jsx_runtime25.jsx)(import_react_native29.View, { style: { padding: noPadding ? 0 : import_tokens24.tokens.extensions.popover.padding, gap: noPadding ? 0 : import_tokens24.tokens.extensions.popover.gap }, children: content(
           typeof children === "function" ? children(() => change(false)) : children,
           import_react_native29.Platform.OS === "web" ? { wordBreak: "keep-all", overflowWrap: "anywhere" } : void 0
@@ -3980,9 +4049,18 @@ function KjunTooltip({
   delay = 0,
   children,
   onPress,
-  disabled
+  disabled,
+  open: controlled,
+  onOpenChange
 }) {
-  const { colors } = useKjunStyles(), [open, setOpen] = (0, import_react35.useState)(false), ref = (0, import_react35.useRef)(null), timer = (0, import_react35.useRef)(void 0);
+  const { colors } = useKjunStyles(), [internal, setInternal] = (0, import_react35.useState)(false), open = controlled != null ? controlled : internal, latest = (0, import_react35.useRef)({ 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 = (0, import_react35.useRef)(null), timer = (0, import_react35.useRef)(void 0);
+  latest.current = { open, onOpenChange };
   const scopeActive = useActiveLayerScope();
   const hide = () => {
     clearTimeout(timer.current);
@@ -7233,7 +7311,7 @@ function TableToolbar({
     selectable && selected.length > 0 && /* @__PURE__ */ (0, import_jsx_runtime42.jsxs)(
       import_react_native45.View,
       {
-        accessibilityRole: "toolbar",
+        role: "group",
         accessibilityLabel: "\uC120\uD0DD \uC791\uC5C5",
         style: [toolbarStyle, { backgroundColor: colors.selectedBg }],
         children: [
@@ -9573,7 +9651,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 = import_tokens60.tokens.extensions.compound;
   const buttonStyle = { width: import_tokens60.tokens.input[size].height, paddingHorizontal: 0 };
   const outer = import_tokens60.tokens.input[size].radius;
@@ -9681,7 +9759,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 },