@reopt-ai/opt-ui 1.10.0 → 1.11.0

package/dist/{text-truncate-CxdzAnhS.cjs → text-truncate-BZdL1k5Z.cjs}

@@ -142,6 +142,7 @@ const OPT_HOVER_ITEM = "[@media(any-hover:hover)]:hover:bg-accent-subtle active:
 const OPT_BORDER = "border border-border";
 const OPT_DIVIDER = "divide-border-subtle";
 const OPT_SURFACE = "rounded-lg bg-surface shadow-sm";
+const OPT_SURFACE_RAISED = "rounded-xl bg-surface-raised shadow-md";
 const OPT_SURFACE_POPOVER = "z-50 rounded-lg border border-border bg-surface-overlay p-2 shadow-lg";
 const OPT_TEXT_PRIMARY = "text-text-primary";
 const OPT_TEXT_SECONDARY = "text-text-secondary";
@@ -240,44 +241,230 @@ function useControlledState(defaultValue, controlledValue, onChange) {
 	}, [isControlled, onChange])];
 }
 //#endregion
+//#region src/core/skeleton.tsx
+const _excluded$17 = [
+	"variant",
+	"width",
+	"height",
+	"lines",
+	"animated",
+	"className",
+	"style"
+];
+const _excluded2$9 = ["lines", "className"];
+const _excluded3$8 = ["size", "className"];
+const _excluded4$6 = ["className"];
+const variantStyles$4 = {
+	text: "rounded h-4",
+	circular: "rounded-full",
+	rectangular: "rounded-lg"
+};
+/** Renders the skeleton component. */
+function Skeleton(_ref) {
+	let { variant = "text", width, height, lines = 1, animated = true, className, style } = _ref, props = _objectWithoutProperties(_ref, _excluded$17);
+	const baseClass = cn("bg-bg-subtle", animated && "animate-pulse", variantStyles$4[variant], className);
+	const computedStyle = _objectSpread2({
+		width: typeof width === "number" ? `${width}px` : width,
+		height: typeof height === "number" ? `${height}px` : height
+	}, style);
+	if (variant === "text" && lines > 1) return /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
+		className: "gap-element flex flex-col",
+		role: "status",
+		"aria-label": "Loading",
+		"data-opt-id": "EJT87",
+		"data-opt-slug": "skeleton.Skeleton",
+		children: [Array.from({ length: lines }).map((_, i) => /* @__PURE__ */ (0, react_jsx_runtime.jsx)("div", _objectSpread2({
+			className: cn(baseClass, i === lines - 1 && "w-4/5"),
+			style: i === lines - 1 ? void 0 : computedStyle
+		}, props), i)), /* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", {
+			className: "sr-only",
+			children: "Loading..."
+		})]
+	});
+	return /* @__PURE__ */ (0, react_jsx_runtime.jsx)("div", _objectSpread2(_objectSpread2({
+		className: baseClass,
+		style: computedStyle,
+		role: "status",
+		"aria-label": "Loading"
+	}, props), {}, {
+		"data-opt-id": "EJT87",
+		"data-opt-slug": "skeleton.Skeleton",
+		children: /* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", {
+			className: "sr-only",
+			children: "Loading..."
+		})
+	}));
+}
+/** Renders the skeleton text component. */
+function SkeletonText(_ref2) {
+	let { lines = 3, className } = _ref2, props = _objectWithoutProperties(_ref2, _excluded2$9);
+	return /* @__PURE__ */ (0, react_jsx_runtime.jsx)(Skeleton, _objectSpread2(_objectSpread2({
+		variant: "text",
+		lines,
+		className
+	}, props), {}, {
+		"data-opt-id": "MX3D5",
+		"data-opt-slug": "skeleton.SkeletonText"
+	}));
+}
+/** Renders the skeleton avatar component. */
+function SkeletonAvatar(_ref3) {
+	let { size = 40, className } = _ref3, props = _objectWithoutProperties(_ref3, _excluded3$8);
+	return /* @__PURE__ */ (0, react_jsx_runtime.jsx)(Skeleton, _objectSpread2(_objectSpread2({
+		variant: "circular",
+		width: size,
+		height: size,
+		className
+	}, props), {}, {
+		"data-opt-id": "MP0HZ",
+		"data-opt-slug": "skeleton.SkeletonAvatar"
+	}));
+}
+/** Renders the skeleton card component. */
+function SkeletonCard(_ref4) {
+	let { className } = _ref4, props = _objectWithoutProperties(_ref4, _excluded4$6);
+	return /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", _objectSpread2(_objectSpread2({ className: cn("gap-group flex flex-col", className) }, props), {}, {
+		"data-opt-id": "34V5D",
+		"data-opt-slug": "skeleton.SkeletonCard",
+		children: [
+			/* @__PURE__ */ (0, react_jsx_runtime.jsx)(Skeleton, {
+				variant: "rectangular",
+				height: 120
+			}),
+			/* @__PURE__ */ (0, react_jsx_runtime.jsx)(Skeleton, {
+				variant: "text",
+				width: "60%"
+			}),
+			/* @__PURE__ */ (0, react_jsx_runtime.jsx)(Skeleton, {
+				variant: "text",
+				lines: 2
+			})
+		]
+	}));
+}
+/** Renders the skeleton table component. */
+function SkeletonTable({ rows = 5, columns = 4, className }) {
+	return /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
+		className: cn("gap-element flex flex-col", className),
+		role: "status",
+		"aria-label": "Loading table",
+		"data-opt-id": "3KEDN",
+		"data-opt-slug": "skeleton.SkeletonTable",
+		children: [
+			/* @__PURE__ */ (0, react_jsx_runtime.jsx)("div", {
+				className: "border-border-subtle gap-group flex border-b pb-2",
+				children: Array.from({ length: columns }).map((_, i) => /* @__PURE__ */ (0, react_jsx_runtime.jsx)(Skeleton, {
+					variant: "text",
+					className: "flex-1",
+					height: 16
+				}, i))
+			}),
+			Array.from({ length: rows }).map((_, rowIndex) => /* @__PURE__ */ (0, react_jsx_runtime.jsx)("div", {
+				className: "gap-group flex py-2",
+				children: Array.from({ length: columns }).map((_, colIndex) => /* @__PURE__ */ (0, react_jsx_runtime.jsx)(Skeleton, {
+					variant: "text",
+					className: "flex-1",
+					height: 14
+				}, colIndex))
+			}, rowIndex)),
+			/* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", {
+				className: "sr-only",
+				children: "Loading..."
+			})
+		]
+	});
+}
+//#endregion
 //#region src/core/stat-card.tsx
+const TREND_GLYPH = {
+	up: "↑",
+	down: "↓",
+	neutral: "→"
+};
+/**
+* Colour follows meaning, not direction. A rising bounce rate is a fall in
+* quality, so a card declaring `polarity: "negative"` inverts the palette
+* rather than congratulating the reader on a worse number.
+*/
+function deltaToneClass(trend, polarity) {
+	if (trend === "neutral") return OPT_TEXT_TERTIARY;
+	return (polarity === "positive" ? trend === "up" : trend === "down") ? "text-success-fg" : "text-danger-fg";
+}
+function sparkStroke(trend, polarity) {
+	if (!trend || trend === "neutral") return "var(--opt-chart-1)";
+	return (polarity === "positive" ? trend === "up" : trend === "down") ? "var(--opt-chart-diverging-positive)" : "var(--opt-chart-diverging-negative)";
+}
 /** Renders the stat card component. */
-function StatCard({ title, value, change, trend, sparklineData, className }) {
-	const trendColor = trend === "up" ? "text-success-fg" : trend === "down" ? "text-danger-fg" : "text-text-tertiary";
-	const trendIcon = trend === "up" ? "↑" : trend === "down" ? "↓" : "→";
-	const sparkColor = trend === "up" ? "var(--opt-chart-diverging-positive)" : trend === "down" ? "var(--opt-chart-diverging-negative)" : "var(--opt-chart-1)";
-	return /* @__PURE__ */ (0, react_jsx_runtime.jsx)("div", {
-		className: cn(OPT_SURFACE, OPT_BORDER, "flex flex-col gap-1 p-5", className),
-		"data-opt-id": "GAX47",
-		"data-opt-slug": "stat-card.StatCard",
-		children: /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
-			className: "flex items-start justify-between gap-4",
-			children: [/* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
-				className: "flex min-w-0 flex-col gap-1",
-				children: [
-					/* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", {
-						className: cn(OPT_TEXT_SECONDARY, "truncate text-sm"),
-						children: title
-					}),
-					/* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", {
-						className: cn(OPT_TEXT_PRIMARY, "text-2xl font-bold"),
-						children: value
-					}),
-					/* @__PURE__ */ (0, react_jsx_runtime.jsxs)("span", {
-						className: cn("text-sm font-medium", trendColor),
-						children: [
-							trendIcon,
-							" ",
-							change
-						]
-					})
-				]
-			}), sparklineData && sparklineData.length > 1 && /* @__PURE__ */ (0, react_jsx_runtime.jsx)(MiniSparkline, {
-				data: sparklineData,
-				color: sparkColor
-			})]
-		})
+function StatCard({ title, value, change, trend, polarity = "positive", description, hint, sparklineData, size = "md", loading = false, href, onSelect, selected = false, className }) {
+	const titleId = react.useId();
+	const hintId = react.useId();
+	const hasDelta = Boolean(change) && trend !== void 0;
+	const interactive = Boolean(href || onSelect);
+	const body = loading ? /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
+		className: "flex flex-col gap-2",
+		children: [
+			/* @__PURE__ */ (0, react_jsx_runtime.jsx)(Skeleton, { className: "h-4 w-24" }),
+			/* @__PURE__ */ (0, react_jsx_runtime.jsx)(Skeleton, { className: "h-7 w-32" }),
+			/* @__PURE__ */ (0, react_jsx_runtime.jsx)(Skeleton, { className: "h-3 w-20" })
+		]
+	}) : /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
+		className: "flex items-start justify-between gap-4",
+		children: [/* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
+			className: "flex min-w-0 flex-col gap-1",
+			children: [
+				/* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", {
+					id: titleId,
+					className: cn(OPT_TEXT_SECONDARY, "truncate text-sm"),
+					children: title
+				}),
+				/* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", {
+					className: cn(OPT_TEXT_PRIMARY, "font-bold tabular-nums", size === "sm" ? "text-xl" : "text-2xl"),
+					children: value
+				}),
+				hasDelta && /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("span", {
+					className: cn("text-sm font-medium tabular-nums", deltaToneClass(trend, polarity)),
+					children: [
+						TREND_GLYPH[trend],
+						" ",
+						change
+					]
+				}),
+				description && /* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", {
+					className: cn("text-text-tertiary", "text-xs"),
+					children: description
+				}),
+				hint && /* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", {
+					id: hintId,
+					className: "sr-only",
+					children: hint
+				})
+			]
+		}), sparklineData && sparklineData.length > 1 && /* @__PURE__ */ (0, react_jsx_runtime.jsx)(MiniSparkline, {
+			data: sparklineData,
+			color: sparkStroke(trend, polarity)
+		})]
 	});
+	const shared = {
+		className: cn(OPT_SURFACE, OPT_BORDER, "flex flex-col gap-1", size === "sm" ? "p-4" : "p-5", interactive && [
+			"hover:border-border-hover",
+			"outline-none focus-visible:ring-2 focus-visible:ring-ring focus-visible:ring-offset-1 focus-visible:ring-offset-ring-offset",
+			"cursor-pointer text-left transition-colors"
+		], selected && "border-accent", className),
+		title: hint,
+		"aria-describedby": hint ? hintId : void 0,
+		"data-opt-id": "GAX47",
+		"data-opt-slug": "stat-card.StatCard"
+	};
+	if (href) return /* @__PURE__ */ (0, react_jsx_runtime.jsx)("a", _objectSpread2(_objectSpread2({
+		href,
+		"aria-current": selected ? "true" : void 0
+	}, shared), {}, { children: body }));
+	if (onSelect) return /* @__PURE__ */ (0, react_jsx_runtime.jsx)("button", _objectSpread2(_objectSpread2({
+		type: "button",
+		onClick: onSelect,
+		"aria-pressed": selected
+	}, shared), {}, { children: body }));
+	return /* @__PURE__ */ (0, react_jsx_runtime.jsx)("div", _objectSpread2(_objectSpread2({}, shared), {}, { children: body }));
 }
 function MiniSparkline({ data, color }) {
 	const width = 80;
@@ -329,7 +516,7 @@ const koBreadcrumbLabels = {
 navAriaLabel: "{label}(으)로 이동" };
 //#endregion
 //#region src/core/button.tsx
-const _excluded$15 = [
+const _excluded$16 = [
 	"variant",
 	"size",
 	"loading",
@@ -340,24 +527,24 @@ const _excluded$15 = [
 	"children",
 	"aria-busy"
 ];
-const variantStyles$2 = {
+const variantStyles$3 = {
 	primary: "bg-accent text-accent-fg hover:bg-accent-hover active:bg-accent-active focus-visible:ring-offset-2",
 	secondary: "border border-border bg-surface text-text-primary hover:bg-bg-subtle active:bg-bg-muted focus-visible:ring-offset-1",
 	ghost: "text-text-secondary hover:bg-bg-subtle active:bg-bg-muted focus-visible:ring-offset-1",
 	danger: "bg-danger text-danger-fg hover:bg-danger active:bg-danger focus-visible:ring-offset-2"
 };
-const sizeStyles$4 = {
+const sizeStyles$5 = {
 	sm: "h-[var(--opt-control-sm)] px-[var(--opt-control-padding-sm)] text-xs gap-[var(--opt-space-1-5)]",
 	md: "h-[var(--opt-control-md)] px-[var(--opt-control-padding-md)] text-sm gap-[var(--opt-space-2)]",
 	lg: "h-[var(--opt-control-lg)] px-[var(--opt-control-padding-lg)] text-base gap-[var(--opt-space-2)]"
 };
 /** Renders the button component. */
 function Button(_ref) {
-	let { variant = "primary", size = "md", loading = false, leftIcon, rightIcon, className, disabled, children, "aria-busy": ariaBusy } = _ref, props = _objectWithoutProperties(_ref, _excluded$15);
+	let { variant = "primary", size = "md", loading = false, leftIcon, rightIcon, className, disabled, children, "aria-busy": ariaBusy } = _ref, props = _objectWithoutProperties(_ref, _excluded$16);
 	const isDisabled = disabled || loading;
 	return /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("button", _objectSpread2(_objectSpread2({
 		type: "button",
-		className: cn("inline-flex cursor-pointer items-center justify-center rounded-lg font-medium transition-colors", OPT_FOCUS_VISIBLE, variantStyles$2[variant], sizeStyles$4[size], isDisabled && "pointer-events-none cursor-not-allowed opacity-50", className),
+		className: cn("inline-flex cursor-pointer items-center justify-center rounded-lg font-medium transition-colors", OPT_FOCUS_VISIBLE, variantStyles$3[variant], sizeStyles$5[size], isDisabled && "pointer-events-none cursor-not-allowed opacity-50", className),
 		disabled: isDisabled
 	}, props), {}, {
 		"aria-busy": loading ? true : ariaBusy,
@@ -399,44 +586,68 @@ const iconSizeClasses = {
 	md: "text-4xl",
 	lg: "text-5xl"
 };
+const titleSizeClasses = {
+	sm: "text-base font-semibold",
+	md: "text-lg font-semibold",
+	lg: "text-xl font-semibold"
+};
+const iconToneClasses = {
+	default: OPT_TEXT_TERTIARY,
+	subdued: OPT_TEXT_TERTIARY,
+	error: "text-danger-fg"
+};
+function isActionList(actions) {
+	return Array.isArray(actions) && actions.every((entry) => typeof entry === "object" && entry !== null && "onClick" in entry);
+}
 /** Renders the empty state component. */
-function EmptyState({ icon, title, description, actions, className, iconSize = "md", headingLevel = "h3" }) {
+function EmptyState({ icon, title, description, body, footer, actions, className, iconSize = "md", headingLevel = "h3", titleSize = "md", layout = "vertical", hasBorder = false, tone = "default" }) {
 	const HeadingTag = headingLevel;
+	const horizontal = layout === "horizontal";
+	const hasActions = isActionList(actions) ? actions.length > 0 : Boolean(actions);
 	return /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
-		role: "status",
+		role: tone === "error" ? "alert" : "status",
 		"aria-label": title,
-		className: cn("flex flex-col items-center justify-center px-4 py-12 text-center", className),
-		"data-opt-id": "5ZK92",
+		className: cn("flex px-4 py-12", horizontal ? "flex-row items-center justify-center gap-8 text-left" : "flex-col items-center justify-center text-center", hasBorder && ["border border-border", "rounded-xl"], tone === "subdued" && "bg-bg-subtle", className),
+		"data-opt-id": "MZV19",
 		"data-opt-slug": "empty-state.EmptyState",
-		children: [
-			icon && /* @__PURE__ */ (0, react_jsx_runtime.jsx)("div", {
-				className: cn(`mb-4 text-text-tertiary`, iconSizeClasses[iconSize]),
-				"aria-hidden": "true",
-				children: icon
-			}),
-			/* @__PURE__ */ (0, react_jsx_runtime.jsx)(HeadingTag, {
-				className: `text-lg font-semibold ${OPT_TEXT_PRIMARY}`,
-				children: title
-			}),
-			description && /* @__PURE__ */ (0, react_jsx_runtime.jsx)("p", {
-				className: `mt-2 max-w-sm text-sm text-text-secondary`,
-				children: description
-			}),
-			actions && actions.length > 0 && /* @__PURE__ */ (0, react_jsx_runtime.jsx)("div", {
-				className: "mt-6 flex items-center gap-3",
-				children: actions.map((action) => /* @__PURE__ */ (0, react_jsx_runtime.jsx)(Button, {
-					onClick: action.onClick,
-					disabled: action.disabled,
-					variant: action.variant === "secondary" ? "secondary" : "primary",
-					children: action.label
-				}, action.id))
-			})
-		]
+		children: [icon && /* @__PURE__ */ (0, react_jsx_runtime.jsx)("div", {
+			className: cn(iconToneClasses[tone], iconSizeClasses[iconSize], horizontal ? "shrink-0" : "mb-4"),
+			"aria-hidden": "true",
+			children: icon
+		}), /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
+			className: cn("flex flex-col", horizontal ? "items-start" : "items-center"),
+			children: [
+				/* @__PURE__ */ (0, react_jsx_runtime.jsx)(HeadingTag, {
+					className: cn(titleSizeClasses[titleSize], OPT_TEXT_PRIMARY),
+					children: title
+				}),
+				body ? /* @__PURE__ */ (0, react_jsx_runtime.jsx)("div", {
+					className: cn("mt-2 max-w-md text-sm", OPT_TEXT_SECONDARY),
+					children: body
+				}) : description && /* @__PURE__ */ (0, react_jsx_runtime.jsx)("p", {
+					className: cn("mt-2 max-w-sm text-sm", "text-text-secondary"),
+					children: description
+				}),
+				hasActions && /* @__PURE__ */ (0, react_jsx_runtime.jsx)("div", {
+					className: cn("mt-6 flex flex-wrap items-center gap-3", !horizontal && "justify-center"),
+					children: isActionList(actions) ? actions.map((action) => /* @__PURE__ */ (0, react_jsx_runtime.jsx)(Button, {
+						onClick: action.onClick,
+						disabled: action.disabled,
+						variant: action.variant === "secondary" ? "secondary" : "primary",
+						children: action.label
+					}, action.id)) : actions
+				}),
+				footer && /* @__PURE__ */ (0, react_jsx_runtime.jsx)("div", {
+					className: cn("border-border-subtle mt-6 w-full border-t pt-4 text-sm", "text-text-tertiary"),
+					children: footer
+				})
+			]
+		})]
 	});
 }
 //#endregion
 //#region src/core/badge.tsx
-const _excluded$14 = [
+const _excluded$15 = [
 	"variant",
 	"size",
 	"dot",
@@ -445,7 +656,7 @@ const _excluded$14 = [
 	"className",
 	"children"
 ];
-const variantStyles$1 = {
+const variantStyles$2 = {
 	default: "bg-bg-subtle text-text-secondary",
 	success: "bg-success-subtle text-success-fg",
 	warning: "bg-warning-subtle text-warning-fg",
@@ -466,19 +677,19 @@ const progressStroke = {
 	error: "stroke-danger",
 	info: "stroke-info"
 };
-const sizeStyles$3 = {
+const sizeStyles$4 = {
 	sm: "px-1.5 py-0.5 text-[10px]",
 	md: "px-2 py-0.5 text-[11px]"
 };
 /** Renders the badge component. */
 function Badge(_ref) {
-	let { variant = "default", size = "md", dot = false, progress, progressSize = 16, className, children } = _ref, props = _objectWithoutProperties(_ref, _excluded$14);
+	let { variant = "default", size = "md", dot = false, progress, progressSize = 16, className, children } = _ref, props = _objectWithoutProperties(_ref, _excluded$15);
 	const hasProgress = progress != null;
 	const clampedProgress = hasProgress ? Math.min(100, Math.max(0, progress)) : 0;
 	const radius = (progressSize - 3) / 2;
 	const circumference = 2 * Math.PI * radius;
 	const offset = circumference - clampedProgress / 100 * circumference;
-	return /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("span", _objectSpread2(_objectSpread2({ className: cn(OPT_BADGE, variantStyles$1[variant], sizeStyles$3[size], className) }, props), {}, {
+	return /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("span", _objectSpread2(_objectSpread2({ className: cn(OPT_BADGE, variantStyles$2[variant], sizeStyles$4[size], className) }, props), {}, {
 		"data-opt-id": "9GBGZ",
 		"data-opt-slug": "badge.Badge",
 		children: [
@@ -518,24 +729,24 @@ function Badge(_ref) {
 }
 //#endregion
 //#region src/core/spinner.tsx
-const _excluded$13 = [
+const _excluded$14 = [
 	"size",
 	"className",
 	"role",
 	"aria-hidden",
 	"aria-label"
 ];
-const sizeStyles$2 = {
+const sizeStyles$3 = {
 	sm: "h-4 w-4",
 	md: "h-6 w-6",
 	lg: "h-8 w-8"
 };
 /** Renders the spinner component. */
 function Spinner(_ref) {
-	let { size = "md", className, role, "aria-hidden": ariaHidden, "aria-label": ariaLabel } = _ref, props = _objectWithoutProperties(_ref, _excluded$13);
+	let { size = "md", className, role, "aria-hidden": ariaHidden, "aria-label": ariaLabel } = _ref, props = _objectWithoutProperties(_ref, _excluded$14);
 	const isDecorative = ariaHidden === true || ariaHidden === "true";
 	return /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("svg", _objectSpread2(_objectSpread2({
-		className: cn("animate-spin text-current", sizeStyles$2[size], className),
+		className: cn("animate-spin text-current", sizeStyles$3[size], className),
 		viewBox: "0 0 24 24",
 		fill: "none",
 		role: isDecorative ? void 0 : role !== null && role !== void 0 ? role : "status",
@@ -560,7 +771,7 @@ function Spinner(_ref) {
 }
 //#endregion
 //#region src/core/alert.tsx
-const _excluded$12 = [
+const _excluded$13 = [
 	"variant",
 	"title",
 	"icon",
@@ -569,7 +780,7 @@ const _excluded$12 = [
 	"className",
 	"children"
 ];
-const variantStyles = {
+const variantStyles$1 = {
 	info: "border-info bg-info-subtle text-info-fg",
 	success: "border-success bg-success-subtle text-success-fg",
 	warning: "border-warning bg-warning-subtle text-warning-fg",
@@ -629,11 +840,11 @@ const defaultIcons = {
 };
 /** Renders the alert component. */
 function Alert(_ref) {
-	let { variant = "info", title, icon, dismissible = false, onDismiss, className, children } = _ref, props = _objectWithoutProperties(_ref, _excluded$12);
+	let { variant = "info", title, icon, dismissible = false, onDismiss, className, children } = _ref, props = _objectWithoutProperties(_ref, _excluded$13);
 	const displayIcon = icon !== null && icon !== void 0 ? icon : defaultIcons[variant];
 	return /* @__PURE__ */ (0, react_jsx_runtime.jsx)("div", _objectSpread2(_objectSpread2({
 		role: "alert",
-		className: cn("relative rounded-lg border p-4", variantStyles[variant], className)
+		className: cn("relative rounded-lg border p-4", variantStyles$1[variant], className)
 	}, props), {}, {
 		"data-opt-id": "4SPK6",
 		"data-opt-slug": "alert.Alert",
@@ -685,7 +896,7 @@ function useInputId(id, label, prefix) {
 }
 //#endregion
 //#region src/core/input.tsx
-const _excluded$11 = [
+const _excluded$12 = [
 	"label",
 	"error",
 	"hint",
@@ -700,7 +911,7 @@ const _excluded$11 = [
 const inputSizeStyles = OPT_INPUT_SIZE;
 const Input = (0, react.forwardRef)((_ref, ref) => {
 	var _useInputId;
-	let { label, error, hint, leftIcon, rightIcon, fullWidth = false, size = "md", required, className, id } = _ref, props = _objectWithoutProperties(_ref, _excluded$11);
+	let { label, error, hint, leftIcon, rightIcon, fullWidth = false, size = "md", required, className, id } = _ref, props = _objectWithoutProperties(_ref, _excluded$12);
 	const fallbackId = (0, react.useId)().replace(/:/g, "");
 	const inputId = (_useInputId = useInputId(id, label, "input")) !== null && _useInputId !== void 0 ? _useInputId : `input-${fallbackId}`;
 	const hasError = Boolean(error);
@@ -850,6 +1061,65 @@ function StarRating({ value = 0, onChange, max = 5, readOnly = false, size = "md
 	});
 }
 //#endregion
+//#region src/core/meter.tsx
+const _excluded$11 = [
+	"value",
+	"min",
+	"max",
+	"size",
+	"variant",
+	"showValue",
+	"label",
+	"getValueLabel",
+	"className"
+];
+const sizeStyles$2 = {
+	sm: "h-1",
+	md: "h-2",
+	lg: "h-3"
+};
+const variantStyles = {
+	default: "bg-accent",
+	success: "bg-success",
+	warning: "bg-warning",
+	error: "bg-danger"
+};
+/**
+* A scalar measurement within a known range (disk usage, score, capacity) —
+* `role="meter"`, distinct from Progress (task completion). Built on the
+* opt-ui-primitives Meter primitive, which owns the role/aria/valuetext.
+*/
+function Meter(_ref) {
+	let { value, min = 0, max = 100, size = "md", variant = "default", showValue = false, label, getValueLabel, className } = _ref, props = _objectWithoutProperties(_ref, _excluded$11);
+	const clamped = Math.min(Math.max(value, min), max);
+	const percentage = max === min ? 0 : (clamped - min) / (max - min) * 100;
+	return /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", _objectSpread2(_objectSpread2({ className: cn("w-full", className) }, props), {}, {
+		"data-opt-id": "G01TE",
+		"data-opt-slug": "meter.Meter",
+		children: [(showValue || label) && /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
+			className: "mb-1.5 flex items-center justify-between text-sm",
+			children: [label && /* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", {
+				className: "text-text-primary font-medium",
+				children: label
+			}), showValue && /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("span", {
+				className: "text-text-tertiary",
+				children: [Math.round(percentage), "%"]
+			})]
+		}), /* @__PURE__ */ (0, react_jsx_runtime.jsx)(_reopt_ai_opt_ui_primitives.Meter, {
+			value: clamped,
+			min,
+			max,
+			getValueLabel,
+			"aria-label": label !== null && label !== void 0 ? label : `${Math.round(percentage)}%`,
+			className: cn("bg-bg-subtle w-full overflow-hidden rounded-full", sizeStyles$2[size]),
+			children: /* @__PURE__ */ (0, react_jsx_runtime.jsx)("div", {
+				className: cn("h-full rounded-full transition-all duration-300 ease-out", variantStyles[variant]),
+				style: { width: `${percentage}%` }
+			})
+		})]
+	}));
+}
+//#endregion
 //#region src/core/composite-zone.tsx
 /** Renders the composite zone component. */
 function CompositeZone({ children, label, focusLoop = true, focusWrap = true, className }) {
@@ -3532,6 +3802,55 @@ function FormDateRangePicker(_ref35) {
 	}));
 }
 //#endregion
+//#region src/lib/formatters.ts
+const OPT_UI_DEFAULT_LOCALE = "ko-KR";
+const KST_OFFSET_MS = 324e5;
+function getKstDateParts(input) {
+	const date = input instanceof Date ? input : new Date(input);
+	if (Number.isNaN(date.getTime())) return null;
+	const kstDate = new Date(date.getTime() + KST_OFFSET_MS);
+	return {
+		year: kstDate.getUTCFullYear(),
+		month: kstDate.getUTCMonth() + 1,
+		day: kstDate.getUTCDate(),
+		hour: kstDate.getUTCHours(),
+		minute: kstDate.getUTCMinutes(),
+		second: kstDate.getUTCSeconds()
+	};
+}
+function pad2(value) {
+	return String(value).padStart(2, "0");
+}
+function meridiem(hour) {
+	return hour < 12 ? "오전" : "오후";
+}
+function hour12(hour) {
+	const normalized = hour % 12;
+	return normalized === 0 ? 12 : normalized;
+}
+/** Formats a date as Korean short date text in the opt-ui default timezone. */
+function formatOptShortDate(input) {
+	const parts = getKstDateParts(input);
+	if (!parts) return "-";
+	return `${parts.month}월 ${parts.day}일`;
+}
+/** Formats a date as Korean clock time in the opt-ui default timezone. */
+function formatOptTime(input) {
+	const parts = getKstDateParts(input);
+	if (!parts) return "-";
+	return `${meridiem(parts.hour)} ${pad2(hour12(parts.hour))}:${pad2(parts.minute)}`;
+}
+/** Formats a date as Korean date-time text in the opt-ui default timezone. */
+function formatOptDateTime(input) {
+	const parts = getKstDateParts(input);
+	if (!parts) return "-";
+	return `${parts.year}. ${parts.month}. ${parts.day}. ${meridiem(parts.hour)} ${hour12(parts.hour)}:${pad2(parts.minute)}:${pad2(parts.second)}`;
+}
+/** Formats numbers without depending on the runtime default locale. */
+function formatOptNumber(value) {
+	return new Intl.NumberFormat(OPT_UI_DEFAULT_LOCALE).format(value);
+}
+//#endregion
 //#region src/core/checkbox.tsx
 const _excluded$1 = [
 	"label",
@@ -4703,6 +5022,12 @@ Object.defineProperty(exports, "MenubarRoot", {
 		return MenubarRoot;
 	}
 });
+Object.defineProperty(exports, "Meter", {
+	enumerable: true,
+	get: function() {
+		return Meter;
+	}
+});
 Object.defineProperty(exports, "NumberInput", {
 	enumerable: true,
 	get: function() {
@@ -4853,6 +5178,12 @@ Object.defineProperty(exports, "OPT_SURFACE_POPOVER", {
 		return OPT_SURFACE_POPOVER;
 	}
 });
+Object.defineProperty(exports, "OPT_SURFACE_RAISED", {
+	enumerable: true,
+	get: function() {
+		return OPT_SURFACE_RAISED;
+	}
+});
 Object.defineProperty(exports, "OPT_TABLE_ROW_ACTIVE", {
 	enumerable: true,
 	get: function() {
@@ -4907,6 +5238,12 @@ Object.defineProperty(exports, "OPT_TH", {
 		return OPT_TH;
 	}
 });
+Object.defineProperty(exports, "OPT_UI_DEFAULT_LOCALE", {
+	enumerable: true,
+	get: function() {
+		return OPT_UI_DEFAULT_LOCALE;
+	}
+});
 Object.defineProperty(exports, "Pagination", {
 	enumerable: true,
 	get: function() {
@@ -4973,6 +5310,36 @@ Object.defineProperty(exports, "SelectTrigger", {
 		return SelectTrigger;
 	}
 });
+Object.defineProperty(exports, "Skeleton", {
+	enumerable: true,
+	get: function() {
+		return Skeleton;
+	}
+});
+Object.defineProperty(exports, "SkeletonAvatar", {
+	enumerable: true,
+	get: function() {
+		return SkeletonAvatar;
+	}
+});
+Object.defineProperty(exports, "SkeletonCard", {
+	enumerable: true,
+	get: function() {
+		return SkeletonCard;
+	}
+});
+Object.defineProperty(exports, "SkeletonTable", {
+	enumerable: true,
+	get: function() {
+		return SkeletonTable;
+	}
+});
+Object.defineProperty(exports, "SkeletonText", {
+	enumerable: true,
+	get: function() {
+		return SkeletonText;
+	}
+});
 Object.defineProperty(exports, "Slider", {
 	enumerable: true,
 	get: function() {
@@ -5099,6 +5466,30 @@ Object.defineProperty(exports, "cn", {
 		return cn;
 	}
 });
+Object.defineProperty(exports, "formatOptDateTime", {
+	enumerable: true,
+	get: function() {
+		return formatOptDateTime;
+	}
+});
+Object.defineProperty(exports, "formatOptNumber", {
+	enumerable: true,
+	get: function() {
+		return formatOptNumber;
+	}
+});
+Object.defineProperty(exports, "formatOptShortDate", {
+	enumerable: true,
+	get: function() {
+		return formatOptShortDate;
+	}
+});
+Object.defineProperty(exports, "formatOptTime", {
+	enumerable: true,
+	get: function() {
+		return formatOptTime;
+	}
+});
 Object.defineProperty(exports, "getDescribedBy", {
 	enumerable: true,
 	get: function() {