@puzzle-ui/ui 0.3.0 → 0.5.0

package/dist/components/data-display/empty-state/index.cjs

@@ -0,0 +1,49 @@
+const require_empty_state_utils = require("./empty-state.utils.cjs");
+;/* empty css                  */
+let _puzzle_ui_core = require("@puzzle-ui/core");
+let react_jsx_runtime = require("react/jsx-runtime");
+// src/components/data-display/empty-state/index.tsx
+const EmptyState = ({ size = "md", variant = "default", className, children, ...props }) => /* @__PURE__ */ (0, react_jsx_runtime.jsx)("div", {
+	...props,
+	className: require_empty_state_utils.getEmptyStateClasses(size, variant, className),
+	"data-size": size,
+	"data-variant": variant,
+	children
+});
+const EmptyStateHeader = ({ className, children, ...props }) => /* @__PURE__ */ (0, react_jsx_runtime.jsx)("div", {
+	...props,
+	className: (0, _puzzle_ui_core.cn)("puzzle-empty-state__header", className),
+	children
+});
+const EmptyStateMedia = ({ variant = "default", className, children, "aria-label": ariaLabel, "aria-hidden": ariaHidden, role, ...props }) => /* @__PURE__ */ (0, react_jsx_runtime.jsx)("div", {
+	...props,
+	className: (0, _puzzle_ui_core.cn)("puzzle-empty-state__media", `puzzle-empty-state__media--${variant}`, className),
+	"data-variant": variant,
+	role: ariaLabel ? role ?? "img" : role,
+	"aria-label": ariaLabel,
+	"aria-hidden": ariaLabel ? void 0 : ariaHidden ?? true,
+	children
+});
+const EmptyStateTitle = ({ className, children, ...props }) => /* @__PURE__ */ (0, react_jsx_runtime.jsx)("h3", {
+	...props,
+	className: (0, _puzzle_ui_core.cn)("puzzle-empty-state__title", className),
+	children
+});
+const EmptyStateDescription = ({ className, children, ...props }) => /* @__PURE__ */ (0, react_jsx_runtime.jsx)("p", {
+	...props,
+	className: (0, _puzzle_ui_core.cn)("puzzle-empty-state__description", className),
+	children
+});
+const EmptyStateContent = ({ className, children, ...props }) => /* @__PURE__ */ (0, react_jsx_runtime.jsx)("div", {
+	...props,
+	className: (0, _puzzle_ui_core.cn)("puzzle-empty-state__content", className),
+	children
+});
+exports.EmptyState = EmptyState;
+exports.EmptyStateContent = EmptyStateContent;
+exports.EmptyStateDescription = EmptyStateDescription;
+exports.EmptyStateHeader = EmptyStateHeader;
+exports.EmptyStateMedia = EmptyStateMedia;
+exports.EmptyStateTitle = EmptyStateTitle;
+
+//# sourceMappingURL=index.cjs.map

package/dist/components/data-display/empty-state/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.cjs","names":["getEmptyStateClasses","cn"],"sources":["../../../../src/components/data-display/empty-state/index.tsx"],"sourcesContent":["import type { HTMLAttributes } from \"react\";\nimport { cn } from \"@puzzle-ui/core\";\nimport { getEmptyStateClasses } from \"./empty-state.utils\";\n\nimport \"./empty-state.css\";\n\ntype EmptyStateSize = \"sm\" | \"md\" | \"lg\";\ntype EmptyStateVariant = \"default\" | \"outlined\" | \"filled\";\ntype EmptyStateMediaVariant = \"default\" | \"icon\";\n\ntype EmptyStateProps = HTMLAttributes<HTMLDivElement> & {\n  size?: EmptyStateSize;\n  variant?: EmptyStateVariant;\n};\n\ntype EmptyStatePartProps = HTMLAttributes<HTMLDivElement>;\n\ntype EmptyStateMediaProps = EmptyStatePartProps & {\n  variant?: EmptyStateMediaVariant;\n};\n\nconst EmptyState = ({\n  size = \"md\",\n  variant = \"default\",\n  className,\n  children,\n  ...props\n}: EmptyStateProps) => (\n  <div\n    {...props}\n    className={getEmptyStateClasses(size, variant, className)}\n    data-size={size}\n    data-variant={variant}\n  >\n    {children}\n  </div>\n);\n\nconst EmptyStateHeader = ({\n  className,\n  children,\n  ...props\n}: EmptyStatePartProps) => (\n  <div {...props} className={cn(\"puzzle-empty-state__header\", className)}>\n    {children}\n  </div>\n);\n\nconst EmptyStateMedia = ({\n  variant = \"default\",\n  className,\n  children,\n  \"aria-label\": ariaLabel,\n  \"aria-hidden\": ariaHidden,\n  role,\n  ...props\n}: EmptyStateMediaProps) => (\n  <div\n    {...props}\n    className={cn(\n      \"puzzle-empty-state__media\",\n      `puzzle-empty-state__media--${variant}`,\n      className,\n    )}\n    data-variant={variant}\n    role={ariaLabel ? (role ?? \"img\") : role}\n    aria-label={ariaLabel}\n    aria-hidden={ariaLabel ? undefined : (ariaHidden ?? true)}\n  >\n    {children}\n  </div>\n);\n\nconst EmptyStateTitle = ({\n  className,\n  children,\n  ...props\n}: HTMLAttributes<HTMLHeadingElement>) => (\n  <h3 {...props} className={cn(\"puzzle-empty-state__title\", className)}>\n    {children}\n  </h3>\n);\n\nconst EmptyStateDescription = ({\n  className,\n  children,\n  ...props\n}: HTMLAttributes<HTMLParagraphElement>) => (\n  <p {...props} className={cn(\"puzzle-empty-state__description\", className)}>\n    {children}\n  </p>\n);\n\nconst EmptyStateContent = ({\n  className,\n  children,\n  ...props\n}: EmptyStatePartProps) => (\n  <div {...props} className={cn(\"puzzle-empty-state__content\", className)}>\n    {children}\n  </div>\n);\n\nexport {\n  EmptyState,\n  EmptyStateHeader,\n  EmptyStateMedia,\n  EmptyStateTitle,\n  EmptyStateDescription,\n  EmptyStateContent,\n  type EmptyStateProps,\n  type EmptyStateSize,\n  type EmptyStateVariant,\n  type EmptyStateMediaProps,\n  type EmptyStateMediaVariant,\n};\n"],"mappings":";;;;;AAqBA,MAAM,cAAc,EAClB,OAAO,MACP,UAAU,WACV,WACA,UACA,GAAG,YAEH,iBAAA,GAAA,kBAAA,IAAA,CAAC,OAAD;CACE,GAAI;CACJ,WAAWA,0BAAAA,qBAAqB,MAAM,SAAS,SAAS;CACxD,aAAW;CACX,gBAAc;CAEb;AACE,CAAA;AAGP,MAAM,oBAAoB,EACxB,WACA,UACA,GAAG,YAEH,iBAAA,GAAA,kBAAA,IAAA,CAAC,OAAD;CAAK,GAAI;CAAO,YAAA,GAAWC,gBAAAA,GAAAA,CAAG,8BAA8B,SAAS;CAClE;AACE,CAAA;AAGP,MAAM,mBAAmB,EACvB,UAAU,WACV,WACA,UACA,cAAc,WACd,eAAe,YACf,MACA,GAAG,YAEH,iBAAA,GAAA,kBAAA,IAAA,CAAC,OAAD;CACE,GAAI;CACJ,YAAA,GAAWA,gBAAAA,GAAAA,CACT,6BACA,8BAA8B,WAC9B,SACF;CACA,gBAAc;CACd,MAAM,YAAa,QAAQ,QAAS;CACpC,cAAY;CACZ,eAAa,YAAY,KAAA,IAAa,cAAc;CAEnD;AACE,CAAA;AAGP,MAAM,mBAAmB,EACvB,WACA,UACA,GAAG,YAEH,iBAAA,GAAA,kBAAA,IAAA,CAAC,MAAD;CAAI,GAAI;CAAO,YAAA,GAAWA,gBAAAA,GAAAA,CAAG,6BAA6B,SAAS;CAChE;AACC,CAAA;AAGN,MAAM,yBAAyB,EAC7B,WACA,UACA,GAAG,YAEH,iBAAA,GAAA,kBAAA,IAAA,CAAC,KAAD;CAAG,GAAI;CAAO,YAAA,GAAWA,gBAAAA,GAAAA,CAAG,mCAAmC,SAAS;CACrE;AACA,CAAA;AAGL,MAAM,qBAAqB,EACzB,WACA,UACA,GAAG,YAEH,iBAAA,GAAA,kBAAA,IAAA,CAAC,OAAD;CAAK,GAAI;CAAO,YAAA,GAAWA,gBAAAA,GAAAA,CAAG,+BAA+B,SAAS;CACnE;AACE,CAAA"}

package/dist/components/data-display/empty-state/index.d.cts

@@ -0,0 +1,19 @@
+import { HTMLAttributes } from "react";
+type EmptyStateSize = "sm" | "md" | "lg";
+type EmptyStateVariant = "default" | "outlined" | "filled";
+type EmptyStateMediaVariant = "default" | "icon";
+type EmptyStateProps = HTMLAttributes<HTMLDivElement> & {
+  size?: EmptyStateSize;
+  variant?: EmptyStateVariant;
+};
+type EmptyStatePartProps = HTMLAttributes<HTMLDivElement>;
+type EmptyStateMediaProps = EmptyStatePartProps & {
+  variant?: EmptyStateMediaVariant;
+};
+declare const EmptyState: ({ size, variant, className, children, ...props }: EmptyStateProps) => import("react").JSX.Element;
+declare const EmptyStateHeader: ({ className, children, ...props }: EmptyStatePartProps) => import("react").JSX.Element;
+declare const EmptyStateMedia: ({ variant, className, children, "aria-label": ariaLabel, "aria-hidden": ariaHidden, role, ...props }: EmptyStateMediaProps) => import("react").JSX.Element;
+declare const EmptyStateTitle: ({ className, children, ...props }: HTMLAttributes<HTMLHeadingElement>) => import("react").JSX.Element;
+declare const EmptyStateDescription: ({ className, children, ...props }: HTMLAttributes<HTMLParagraphElement>) => import("react").JSX.Element;
+declare const EmptyStateContent: ({ className, children, ...props }: EmptyStatePartProps) => import("react").JSX.Element;
+export { EmptyState, EmptyStateContent, EmptyStateDescription, EmptyStateHeader, EmptyStateMedia, type EmptyStateMediaProps, type EmptyStateMediaVariant, type EmptyStateProps, type EmptyStateSize, EmptyStateTitle, type EmptyStateVariant };

package/dist/components/data-display/empty-state/index.d.ts

@@ -0,0 +1,19 @@
+import { HTMLAttributes } from "react";
+type EmptyStateSize = "sm" | "md" | "lg";
+type EmptyStateVariant = "default" | "outlined" | "filled";
+type EmptyStateMediaVariant = "default" | "icon";
+type EmptyStateProps = HTMLAttributes<HTMLDivElement> & {
+  size?: EmptyStateSize;
+  variant?: EmptyStateVariant;
+};
+type EmptyStatePartProps = HTMLAttributes<HTMLDivElement>;
+type EmptyStateMediaProps = EmptyStatePartProps & {
+  variant?: EmptyStateMediaVariant;
+};
+declare const EmptyState: ({ size, variant, className, children, ...props }: EmptyStateProps) => import("react").JSX.Element;
+declare const EmptyStateHeader: ({ className, children, ...props }: EmptyStatePartProps) => import("react").JSX.Element;
+declare const EmptyStateMedia: ({ variant, className, children, "aria-label": ariaLabel, "aria-hidden": ariaHidden, role, ...props }: EmptyStateMediaProps) => import("react").JSX.Element;
+declare const EmptyStateTitle: ({ className, children, ...props }: HTMLAttributes<HTMLHeadingElement>) => import("react").JSX.Element;
+declare const EmptyStateDescription: ({ className, children, ...props }: HTMLAttributes<HTMLParagraphElement>) => import("react").JSX.Element;
+declare const EmptyStateContent: ({ className, children, ...props }: EmptyStatePartProps) => import("react").JSX.Element;
+export { EmptyState, EmptyStateContent, EmptyStateDescription, EmptyStateHeader, EmptyStateMedia, type EmptyStateMediaProps, type EmptyStateMediaVariant, type EmptyStateProps, type EmptyStateSize, EmptyStateTitle, type EmptyStateVariant };

package/dist/components/data-display/empty-state/index.js

@@ -0,0 +1,44 @@
+import { getEmptyStateClasses } from "./empty-state.utils.js";
+import "./empty-state.css";
+import { cn } from "@puzzle-ui/core";
+import { jsx } from "react/jsx-runtime";
+// src/components/data-display/empty-state/index.tsx
+const EmptyState = ({ size = "md", variant = "default", className, children, ...props }) => /* @__PURE__ */ jsx("div", {
+	...props,
+	className: getEmptyStateClasses(size, variant, className),
+	"data-size": size,
+	"data-variant": variant,
+	children
+});
+const EmptyStateHeader = ({ className, children, ...props }) => /* @__PURE__ */ jsx("div", {
+	...props,
+	className: cn("puzzle-empty-state__header", className),
+	children
+});
+const EmptyStateMedia = ({ variant = "default", className, children, "aria-label": ariaLabel, "aria-hidden": ariaHidden, role, ...props }) => /* @__PURE__ */ jsx("div", {
+	...props,
+	className: cn("puzzle-empty-state__media", `puzzle-empty-state__media--${variant}`, className),
+	"data-variant": variant,
+	role: ariaLabel ? role ?? "img" : role,
+	"aria-label": ariaLabel,
+	"aria-hidden": ariaLabel ? void 0 : ariaHidden ?? true,
+	children
+});
+const EmptyStateTitle = ({ className, children, ...props }) => /* @__PURE__ */ jsx("h3", {
+	...props,
+	className: cn("puzzle-empty-state__title", className),
+	children
+});
+const EmptyStateDescription = ({ className, children, ...props }) => /* @__PURE__ */ jsx("p", {
+	...props,
+	className: cn("puzzle-empty-state__description", className),
+	children
+});
+const EmptyStateContent = ({ className, children, ...props }) => /* @__PURE__ */ jsx("div", {
+	...props,
+	className: cn("puzzle-empty-state__content", className),
+	children
+});
+export { EmptyState, EmptyStateContent, EmptyStateDescription, EmptyStateHeader, EmptyStateMedia, EmptyStateTitle };
+
+//# sourceMappingURL=index.js.map

package/dist/components/data-display/empty-state/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","names":[],"sources":["../../../../src/components/data-display/empty-state/index.tsx"],"sourcesContent":["import type { HTMLAttributes } from \"react\";\nimport { cn } from \"@puzzle-ui/core\";\nimport { getEmptyStateClasses } from \"./empty-state.utils\";\n\nimport \"./empty-state.css\";\n\ntype EmptyStateSize = \"sm\" | \"md\" | \"lg\";\ntype EmptyStateVariant = \"default\" | \"outlined\" | \"filled\";\ntype EmptyStateMediaVariant = \"default\" | \"icon\";\n\ntype EmptyStateProps = HTMLAttributes<HTMLDivElement> & {\n  size?: EmptyStateSize;\n  variant?: EmptyStateVariant;\n};\n\ntype EmptyStatePartProps = HTMLAttributes<HTMLDivElement>;\n\ntype EmptyStateMediaProps = EmptyStatePartProps & {\n  variant?: EmptyStateMediaVariant;\n};\n\nconst EmptyState = ({\n  size = \"md\",\n  variant = \"default\",\n  className,\n  children,\n  ...props\n}: EmptyStateProps) => (\n  <div\n    {...props}\n    className={getEmptyStateClasses(size, variant, className)}\n    data-size={size}\n    data-variant={variant}\n  >\n    {children}\n  </div>\n);\n\nconst EmptyStateHeader = ({\n  className,\n  children,\n  ...props\n}: EmptyStatePartProps) => (\n  <div {...props} className={cn(\"puzzle-empty-state__header\", className)}>\n    {children}\n  </div>\n);\n\nconst EmptyStateMedia = ({\n  variant = \"default\",\n  className,\n  children,\n  \"aria-label\": ariaLabel,\n  \"aria-hidden\": ariaHidden,\n  role,\n  ...props\n}: EmptyStateMediaProps) => (\n  <div\n    {...props}\n    className={cn(\n      \"puzzle-empty-state__media\",\n      `puzzle-empty-state__media--${variant}`,\n      className,\n    )}\n    data-variant={variant}\n    role={ariaLabel ? (role ?? \"img\") : role}\n    aria-label={ariaLabel}\n    aria-hidden={ariaLabel ? undefined : (ariaHidden ?? true)}\n  >\n    {children}\n  </div>\n);\n\nconst EmptyStateTitle = ({\n  className,\n  children,\n  ...props\n}: HTMLAttributes<HTMLHeadingElement>) => (\n  <h3 {...props} className={cn(\"puzzle-empty-state__title\", className)}>\n    {children}\n  </h3>\n);\n\nconst EmptyStateDescription = ({\n  className,\n  children,\n  ...props\n}: HTMLAttributes<HTMLParagraphElement>) => (\n  <p {...props} className={cn(\"puzzle-empty-state__description\", className)}>\n    {children}\n  </p>\n);\n\nconst EmptyStateContent = ({\n  className,\n  children,\n  ...props\n}: EmptyStatePartProps) => (\n  <div {...props} className={cn(\"puzzle-empty-state__content\", className)}>\n    {children}\n  </div>\n);\n\nexport {\n  EmptyState,\n  EmptyStateHeader,\n  EmptyStateMedia,\n  EmptyStateTitle,\n  EmptyStateDescription,\n  EmptyStateContent,\n  type EmptyStateProps,\n  type EmptyStateSize,\n  type EmptyStateVariant,\n  type EmptyStateMediaProps,\n  type EmptyStateMediaVariant,\n};\n"],"mappings":";;;;;AAqBA,MAAM,cAAc,EAClB,OAAO,MACP,UAAU,WACV,WACA,UACA,GAAG,YAEH,oBAAC,OAAD;CACE,GAAI;CACJ,WAAW,qBAAqB,MAAM,SAAS,SAAS;CACxD,aAAW;CACX,gBAAc;CAEb;AACE,CAAA;AAGP,MAAM,oBAAoB,EACxB,WACA,UACA,GAAG,YAEH,oBAAC,OAAD;CAAK,GAAI;CAAO,WAAW,GAAG,8BAA8B,SAAS;CAClE;AACE,CAAA;AAGP,MAAM,mBAAmB,EACvB,UAAU,WACV,WACA,UACA,cAAc,WACd,eAAe,YACf,MACA,GAAG,YAEH,oBAAC,OAAD;CACE,GAAI;CACJ,WAAW,GACT,6BACA,8BAA8B,WAC9B,SACF;CACA,gBAAc;CACd,MAAM,YAAa,QAAQ,QAAS;CACpC,cAAY;CACZ,eAAa,YAAY,KAAA,IAAa,cAAc;CAEnD;AACE,CAAA;AAGP,MAAM,mBAAmB,EACvB,WACA,UACA,GAAG,YAEH,oBAAC,MAAD;CAAI,GAAI;CAAO,WAAW,GAAG,6BAA6B,SAAS;CAChE;AACC,CAAA;AAGN,MAAM,yBAAyB,EAC7B,WACA,UACA,GAAG,YAEH,oBAAC,KAAD;CAAG,GAAI;CAAO,WAAW,GAAG,mCAAmC,SAAS;CACrE;AACA,CAAA;AAGL,MAAM,qBAAqB,EACzB,WACA,UACA,GAAG,YAEH,oBAAC,OAAD;CAAK,GAAI;CAAO,WAAW,GAAG,+BAA+B,SAAS;CACnE;AACE,CAAA"}

package/dist/components/data-display/rating/index.cjs

@@ -0,0 +1,84 @@
+"use client";
+const require_rating_utils = require("./rating.utils.cjs");
+;/* empty css             */
+let _puzzle_ui_core = require("@puzzle-ui/core");
+let react = require("react");
+let react_jsx_runtime = require("react/jsx-runtime");
+let _puzzle_ui_icons = require("@puzzle-ui/icons");
+// src/components/data-display/rating/index.tsx
+const ICONS = {
+	full: "ph:star-fill",
+	half: "ph:star-half-fill",
+	empty: "ph:star"
+};
+const SIZE_MAP = {
+	sm: 16,
+	md: 20,
+	lg: 24
+};
+const Rating = ({ value, defaultValue = 0, onValueChange, max = 5, precision = .5, size = "md", readOnly = false, disabled = false, color = "var(--puzzle-color-warning, #FABC0A)", emptyColor = "var(--puzzle-color-border)", className, style, "aria-label": ariaLabel = "Rating", onKeyDown, ...props }) => {
+	if (!Number.isInteger(max) || max < 1 || max > 10) throw new Error("Rating max must be an integer between 1 and 10.");
+	const isControlled = value !== void 0;
+	const [internalValue, setInternalValue] = (0, react.useState)(() => require_rating_utils.normalizeRating(defaultValue, max, precision));
+	const currentValue = require_rating_utils.normalizeRating(isControlled ? value : internalValue, max, precision);
+	const commitValue = (nextValue) => {
+		if (disabled || readOnly) return;
+		const next = require_rating_utils.normalizeRating(nextValue, max, precision);
+		if (next === currentValue) return;
+		if (!isControlled) setInternalValue(next);
+		onValueChange?.(next);
+	};
+	const handleKeyDown = (event) => {
+		onKeyDown?.(event);
+		if (event.defaultPrevented || disabled || readOnly) return;
+		const nextValue = require_rating_utils.getNextRating(currentValue, event.key, max, precision);
+		if (nextValue === void 0) return;
+		event.preventDefault();
+		commitValue(nextValue);
+	};
+	const classes = (0, _puzzle_ui_core.cn)("puzzle-rating", disabled && "puzzle-rating-disabled", readOnly && "puzzle-rating-readonly", className);
+	return /* @__PURE__ */ (0, react_jsx_runtime.jsx)("div", {
+		...props,
+		className: classes,
+		style: {
+			...style,
+			"--puzzle-rating-color": color,
+			"--puzzle-rating-empty-color": emptyColor
+		},
+		role: readOnly ? "img" : "slider",
+		tabIndex: disabled || readOnly ? void 0 : 0,
+		"aria-label": readOnly ? `${ariaLabel}: ${currentValue} out of ${max} stars` : ariaLabel,
+		"aria-valuemin": readOnly ? void 0 : 0,
+		"aria-valuemax": readOnly ? void 0 : max,
+		"aria-valuenow": readOnly ? void 0 : currentValue,
+		"aria-valuetext": readOnly ? void 0 : `${currentValue} out of ${max} stars`,
+		"aria-disabled": disabled || void 0,
+		"aria-readonly": readOnly || void 0,
+		onKeyDown: handleKeyDown,
+		"data-size": size,
+		"data-disabled": disabled || void 0,
+		"data-readonly": readOnly || void 0,
+		children: Array.from({ length: max }, (_, index) => {
+			const state = require_rating_utils.getRatingStarState(currentValue, index);
+			return /* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", {
+				className: "puzzle-rating__star",
+				"data-state": state,
+				"aria-hidden": "true",
+				onClick: (event) => {
+					const rect = event.currentTarget.getBoundingClientRect();
+					const isHalf = precision === .5 && event.clientX < rect.left + rect.width / 2;
+					commitValue(index + (isHalf ? .5 : 1));
+				},
+				children: /* @__PURE__ */ (0, react_jsx_runtime.jsx)(_puzzle_ui_icons.Icon, {
+					name: ICONS[state],
+					size: SIZE_MAP[size],
+					"aria-hidden": "true",
+					focusable: "false"
+				})
+			}, index);
+		})
+	});
+};
+exports.Rating = Rating;
+
+//# sourceMappingURL=index.cjs.map

package/dist/components/data-display/rating/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.cjs","names":["useState","normalizeRating","getNextRating","cn","getRatingStarState","Icon"],"sources":["../../../../src/components/data-display/rating/index.tsx"],"sourcesContent":["\"use client\";\n\nimport { useState, type CSSProperties, type KeyboardEvent } from \"react\";\n\nimport { cn } from \"@puzzle-ui/core\";\nimport { Icon } from \"@puzzle-ui/icons\";\n\nimport type { RatingProps, RatingSize } from \"./rating.types\";\n\nimport {\n  getNextRating,\n  getRatingStarState,\n  normalizeRating,\n} from \"./rating.utils\";\n\nimport \"./rating.css\";\n\nconst ICONS = {\n  full: \"ph:star-fill\",\n  half: \"ph:star-half-fill\",\n  empty: \"ph:star\",\n} as const;\n\nconst SIZE_MAP = {\n  sm: 16,\n  md: 20,\n  lg: 24,\n} as const;\n\nconst Rating = ({\n  value,\n  defaultValue = 0,\n  onValueChange,\n  max = 5,\n  precision = 0.5,\n  size = \"md\",\n  readOnly = false,\n  disabled = false,\n  color = \"var(--puzzle-color-warning, #FABC0A)\",\n  emptyColor = \"var(--puzzle-color-border)\",\n  className,\n  style,\n  \"aria-label\": ariaLabel = \"Rating\",\n  onKeyDown,\n  ...props\n}: RatingProps) => {\n  if (!Number.isInteger(max) || max < 1 || max > 10) {\n    throw new Error(\"Rating max must be an integer between 1 and 10.\");\n  }\n\n  const isControlled = value !== undefined;\n\n  const [internalValue, setInternalValue] = useState(() =>\n    normalizeRating(defaultValue, max, precision),\n  );\n\n  const currentValue = normalizeRating(\n    isControlled ? value : internalValue,\n    max,\n    precision,\n  );\n\n  const commitValue = (nextValue: number) => {\n    if (disabled || readOnly) {\n      return;\n    }\n\n    const next = normalizeRating(nextValue, max, precision);\n\n    if (next === currentValue) {\n      return;\n    }\n\n    if (!isControlled) {\n      setInternalValue(next);\n    }\n\n    onValueChange?.(next);\n  };\n\n  const handleKeyDown = (event: KeyboardEvent<HTMLDivElement>) => {\n    onKeyDown?.(event);\n\n    if (event.defaultPrevented || disabled || readOnly) {\n      return;\n    }\n\n    const nextValue = getNextRating(currentValue, event.key, max, precision);\n\n    if (nextValue === undefined) {\n      return;\n    }\n\n    event.preventDefault();\n    commitValue(nextValue);\n  };\n\n  const classes = cn(\n    \"puzzle-rating\",\n    disabled && \"puzzle-rating-disabled\",\n    readOnly && \"puzzle-rating-readonly\",\n    className,\n  );\n\n  return (\n    <div\n      {...props}\n      className={classes}\n      style={\n        {\n          ...style,\n          \"--puzzle-rating-color\": color,\n          \"--puzzle-rating-empty-color\": emptyColor,\n        } as CSSProperties\n      }\n      role={readOnly ? \"img\" : \"slider\"}\n      tabIndex={disabled || readOnly ? undefined : 0}\n      aria-label={\n        readOnly\n          ? `${ariaLabel}: ${currentValue} out of ${max} stars`\n          : ariaLabel\n      }\n      aria-valuemin={readOnly ? undefined : 0}\n      aria-valuemax={readOnly ? undefined : max}\n      aria-valuenow={readOnly ? undefined : currentValue}\n      aria-valuetext={\n        readOnly ? undefined : `${currentValue} out of ${max} stars`\n      }\n      aria-disabled={disabled || undefined}\n      aria-readonly={readOnly || undefined}\n      onKeyDown={handleKeyDown}\n      data-size={size}\n      data-disabled={disabled || undefined}\n      data-readonly={readOnly || undefined}\n    >\n      {Array.from({ length: max }, (_, index) => {\n        const state = getRatingStarState(currentValue, index);\n\n        return (\n          <span\n            key={index}\n            className=\"puzzle-rating__star\"\n            data-state={state}\n            aria-hidden=\"true\"\n            onClick={(event) => {\n              const rect = event.currentTarget.getBoundingClientRect();\n\n              const isHalf =\n                precision === 0.5 && event.clientX < rect.left + rect.width / 2;\n\n              commitValue(index + (isHalf ? 0.5 : 1));\n            }}\n          >\n            <Icon\n              name={ICONS[state]}\n              size={SIZE_MAP[size]}\n              aria-hidden=\"true\"\n              focusable=\"false\"\n            />\n          </span>\n        );\n      })}\n    </div>\n  );\n};\n\nexport { Rating, type RatingProps, type RatingSize };\n"],"mappings":";;;;;;;;AAiBA,MAAM,QAAQ;CACZ,MAAM;CACN,MAAM;CACN,OAAO;AACT;AAEA,MAAM,WAAW;CACf,IAAI;CACJ,IAAI;CACJ,IAAI;AACN;AAEA,MAAM,UAAU,EACd,OACA,eAAe,GACf,eACA,MAAM,GACN,YAAY,IACZ,OAAO,MACP,WAAW,OACX,WAAW,OACX,QAAQ,wCACR,aAAa,8BACb,WACA,OACA,cAAc,YAAY,UAC1B,WACA,GAAG,YACc;CACjB,IAAI,CAAC,OAAO,UAAU,GAAG,KAAK,MAAM,KAAK,MAAM,IAC7C,MAAM,IAAI,MAAM,iDAAiD;CAGnE,MAAM,eAAe,UAAU,KAAA;CAE/B,MAAM,CAAC,eAAe,qBAAA,GAAoBA,MAAAA,SAAAA,OACxCC,qBAAAA,gBAAgB,cAAc,KAAK,SAAS,CAC9C;CAEA,MAAM,eAAeA,qBAAAA,gBACnB,eAAe,QAAQ,eACvB,KACA,SACF;CAEA,MAAM,eAAe,cAAsB;EACzC,IAAI,YAAY,UACd;EAGF,MAAM,OAAOA,qBAAAA,gBAAgB,WAAW,KAAK,SAAS;EAEtD,IAAI,SAAS,cACX;EAGF,IAAI,CAAC,cACH,iBAAiB,IAAI;EAGvB,gBAAgB,IAAI;CACtB;CAEA,MAAM,iBAAiB,UAAyC;EAC9D,YAAY,KAAK;EAEjB,IAAI,MAAM,oBAAoB,YAAY,UACxC;EAGF,MAAM,YAAYC,qBAAAA,cAAc,cAAc,MAAM,KAAK,KAAK,SAAS;EAEvE,IAAI,cAAc,KAAA,GAChB;EAGF,MAAM,eAAe;EACrB,YAAY,SAAS;CACvB;CAEA,MAAM,WAAA,GAAUC,gBAAAA,GAAAA,CACd,iBACA,YAAY,0BACZ,YAAY,0BACZ,SACF;CAEA,OACE,iBAAA,GAAA,kBAAA,IAAA,CAAC,OAAD;EACE,GAAI;EACJ,WAAW;EACX,OACE;GACE,GAAG;GACH,yBAAyB;GACzB,+BAA+B;EACjC;EAEF,MAAM,WAAW,QAAQ;EACzB,UAAU,YAAY,WAAW,KAAA,IAAY;EAC7C,cACE,WACI,GAAG,UAAU,IAAI,aAAa,UAAU,IAAI,UAC5C;EAEN,iBAAe,WAAW,KAAA,IAAY;EACtC,iBAAe,WAAW,KAAA,IAAY;EACtC,iBAAe,WAAW,KAAA,IAAY;EACtC,kBACE,WAAW,KAAA,IAAY,GAAG,aAAa,UAAU,IAAI;EAEvD,iBAAe,YAAY,KAAA;EAC3B,iBAAe,YAAY,KAAA;EAC3B,WAAW;EACX,aAAW;EACX,iBAAe,YAAY,KAAA;EAC3B,iBAAe,YAAY,KAAA;EAE1B,UAAA,MAAM,KAAK,EAAE,QAAQ,IAAI,IAAI,GAAG,UAAU;GACzC,MAAM,QAAQC,qBAAAA,mBAAmB,cAAc,KAAK;GAEpD,OACE,iBAAA,GAAA,kBAAA,IAAA,CAAC,QAAD;IAEE,WAAU;IACV,cAAY;IACZ,eAAY;IACZ,UAAU,UAAU;KAClB,MAAM,OAAO,MAAM,cAAc,sBAAsB;KAEvD,MAAM,SACJ,cAAc,MAAO,MAAM,UAAU,KAAK,OAAO,KAAK,QAAQ;KAEhE,YAAY,SAAS,SAAS,KAAM,EAAE;IACxC;IAEA,UAAA,iBAAA,GAAA,kBAAA,IAAA,CAACC,iBAAAA,MAAD;KACE,MAAM,MAAM;KACZ,MAAM,SAAS;KACf,eAAY;KACZ,WAAU;IACX,CAAA;GACG,GAnBC,KAmBD;EAEV,CAAC;CACE,CAAA;AAET"}

package/dist/components/data-display/rating/index.d.cts

@@ -0,0 +1,3 @@
+import { RatingProps, RatingSize } from "./rating.types.cjs";
+declare const Rating: ({ value, defaultValue, onValueChange, max, precision, size, readOnly, disabled, color, emptyColor, className, style, "aria-label": ariaLabel, onKeyDown, ...props }: RatingProps) => import("react").JSX.Element;
+export { Rating, type RatingProps, type RatingSize };

package/dist/components/data-display/rating/index.d.ts

@@ -0,0 +1,3 @@
+import { RatingProps, RatingSize } from "./rating.types.js";
+declare const Rating: ({ value, defaultValue, onValueChange, max, precision, size, readOnly, disabled, color, emptyColor, className, style, "aria-label": ariaLabel, onKeyDown, ...props }: RatingProps) => import("react").JSX.Element;
+export { Rating, type RatingProps, type RatingSize };

package/dist/components/data-display/rating/index.js

@@ -0,0 +1,84 @@
+"use client";
+import { getNextRating, getRatingStarState, normalizeRating } from "./rating.utils.js";
+import "./rating.css";
+import { cn } from "@puzzle-ui/core";
+import { useState } from "react";
+import { jsx } from "react/jsx-runtime";
+import { Icon } from "@puzzle-ui/icons";
+// src/components/data-display/rating/index.tsx
+const ICONS = {
+	full: "ph:star-fill",
+	half: "ph:star-half-fill",
+	empty: "ph:star"
+};
+const SIZE_MAP = {
+	sm: 16,
+	md: 20,
+	lg: 24
+};
+const Rating = ({ value, defaultValue = 0, onValueChange, max = 5, precision = .5, size = "md", readOnly = false, disabled = false, color = "var(--puzzle-color-warning, #FABC0A)", emptyColor = "var(--puzzle-color-border)", className, style, "aria-label": ariaLabel = "Rating", onKeyDown, ...props }) => {
+	if (!Number.isInteger(max) || max < 1 || max > 10) throw new Error("Rating max must be an integer between 1 and 10.");
+	const isControlled = value !== void 0;
+	const [internalValue, setInternalValue] = useState(() => normalizeRating(defaultValue, max, precision));
+	const currentValue = normalizeRating(isControlled ? value : internalValue, max, precision);
+	const commitValue = (nextValue) => {
+		if (disabled || readOnly) return;
+		const next = normalizeRating(nextValue, max, precision);
+		if (next === currentValue) return;
+		if (!isControlled) setInternalValue(next);
+		onValueChange?.(next);
+	};
+	const handleKeyDown = (event) => {
+		onKeyDown?.(event);
+		if (event.defaultPrevented || disabled || readOnly) return;
+		const nextValue = getNextRating(currentValue, event.key, max, precision);
+		if (nextValue === void 0) return;
+		event.preventDefault();
+		commitValue(nextValue);
+	};
+	const classes = cn("puzzle-rating", disabled && "puzzle-rating-disabled", readOnly && "puzzle-rating-readonly", className);
+	return /* @__PURE__ */ jsx("div", {
+		...props,
+		className: classes,
+		style: {
+			...style,
+			"--puzzle-rating-color": color,
+			"--puzzle-rating-empty-color": emptyColor
+		},
+		role: readOnly ? "img" : "slider",
+		tabIndex: disabled || readOnly ? void 0 : 0,
+		"aria-label": readOnly ? `${ariaLabel}: ${currentValue} out of ${max} stars` : ariaLabel,
+		"aria-valuemin": readOnly ? void 0 : 0,
+		"aria-valuemax": readOnly ? void 0 : max,
+		"aria-valuenow": readOnly ? void 0 : currentValue,
+		"aria-valuetext": readOnly ? void 0 : `${currentValue} out of ${max} stars`,
+		"aria-disabled": disabled || void 0,
+		"aria-readonly": readOnly || void 0,
+		onKeyDown: handleKeyDown,
+		"data-size": size,
+		"data-disabled": disabled || void 0,
+		"data-readonly": readOnly || void 0,
+		children: Array.from({ length: max }, (_, index) => {
+			const state = getRatingStarState(currentValue, index);
+			return /* @__PURE__ */ jsx("span", {
+				className: "puzzle-rating__star",
+				"data-state": state,
+				"aria-hidden": "true",
+				onClick: (event) => {
+					const rect = event.currentTarget.getBoundingClientRect();
+					const isHalf = precision === .5 && event.clientX < rect.left + rect.width / 2;
+					commitValue(index + (isHalf ? .5 : 1));
+				},
+				children: /* @__PURE__ */ jsx(Icon, {
+					name: ICONS[state],
+					size: SIZE_MAP[size],
+					"aria-hidden": "true",
+					focusable: "false"
+				})
+			}, index);
+		})
+	});
+};
+export { Rating };
+
+//# sourceMappingURL=index.js.map

package/dist/components/data-display/rating/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","names":[],"sources":["../../../../src/components/data-display/rating/index.tsx"],"sourcesContent":["\"use client\";\n\nimport { useState, type CSSProperties, type KeyboardEvent } from \"react\";\n\nimport { cn } from \"@puzzle-ui/core\";\nimport { Icon } from \"@puzzle-ui/icons\";\n\nimport type { RatingProps, RatingSize } from \"./rating.types\";\n\nimport {\n  getNextRating,\n  getRatingStarState,\n  normalizeRating,\n} from \"./rating.utils\";\n\nimport \"./rating.css\";\n\nconst ICONS = {\n  full: \"ph:star-fill\",\n  half: \"ph:star-half-fill\",\n  empty: \"ph:star\",\n} as const;\n\nconst SIZE_MAP = {\n  sm: 16,\n  md: 20,\n  lg: 24,\n} as const;\n\nconst Rating = ({\n  value,\n  defaultValue = 0,\n  onValueChange,\n  max = 5,\n  precision = 0.5,\n  size = \"md\",\n  readOnly = false,\n  disabled = false,\n  color = \"var(--puzzle-color-warning, #FABC0A)\",\n  emptyColor = \"var(--puzzle-color-border)\",\n  className,\n  style,\n  \"aria-label\": ariaLabel = \"Rating\",\n  onKeyDown,\n  ...props\n}: RatingProps) => {\n  if (!Number.isInteger(max) || max < 1 || max > 10) {\n    throw new Error(\"Rating max must be an integer between 1 and 10.\");\n  }\n\n  const isControlled = value !== undefined;\n\n  const [internalValue, setInternalValue] = useState(() =>\n    normalizeRating(defaultValue, max, precision),\n  );\n\n  const currentValue = normalizeRating(\n    isControlled ? value : internalValue,\n    max,\n    precision,\n  );\n\n  const commitValue = (nextValue: number) => {\n    if (disabled || readOnly) {\n      return;\n    }\n\n    const next = normalizeRating(nextValue, max, precision);\n\n    if (next === currentValue) {\n      return;\n    }\n\n    if (!isControlled) {\n      setInternalValue(next);\n    }\n\n    onValueChange?.(next);\n  };\n\n  const handleKeyDown = (event: KeyboardEvent<HTMLDivElement>) => {\n    onKeyDown?.(event);\n\n    if (event.defaultPrevented || disabled || readOnly) {\n      return;\n    }\n\n    const nextValue = getNextRating(currentValue, event.key, max, precision);\n\n    if (nextValue === undefined) {\n      return;\n    }\n\n    event.preventDefault();\n    commitValue(nextValue);\n  };\n\n  const classes = cn(\n    \"puzzle-rating\",\n    disabled && \"puzzle-rating-disabled\",\n    readOnly && \"puzzle-rating-readonly\",\n    className,\n  );\n\n  return (\n    <div\n      {...props}\n      className={classes}\n      style={\n        {\n          ...style,\n          \"--puzzle-rating-color\": color,\n          \"--puzzle-rating-empty-color\": emptyColor,\n        } as CSSProperties\n      }\n      role={readOnly ? \"img\" : \"slider\"}\n      tabIndex={disabled || readOnly ? undefined : 0}\n      aria-label={\n        readOnly\n          ? `${ariaLabel}: ${currentValue} out of ${max} stars`\n          : ariaLabel\n      }\n      aria-valuemin={readOnly ? undefined : 0}\n      aria-valuemax={readOnly ? undefined : max}\n      aria-valuenow={readOnly ? undefined : currentValue}\n      aria-valuetext={\n        readOnly ? undefined : `${currentValue} out of ${max} stars`\n      }\n      aria-disabled={disabled || undefined}\n      aria-readonly={readOnly || undefined}\n      onKeyDown={handleKeyDown}\n      data-size={size}\n      data-disabled={disabled || undefined}\n      data-readonly={readOnly || undefined}\n    >\n      {Array.from({ length: max }, (_, index) => {\n        const state = getRatingStarState(currentValue, index);\n\n        return (\n          <span\n            key={index}\n            className=\"puzzle-rating__star\"\n            data-state={state}\n            aria-hidden=\"true\"\n            onClick={(event) => {\n              const rect = event.currentTarget.getBoundingClientRect();\n\n              const isHalf =\n                precision === 0.5 && event.clientX < rect.left + rect.width / 2;\n\n              commitValue(index + (isHalf ? 0.5 : 1));\n            }}\n          >\n            <Icon\n              name={ICONS[state]}\n              size={SIZE_MAP[size]}\n              aria-hidden=\"true\"\n              focusable=\"false\"\n            />\n          </span>\n        );\n      })}\n    </div>\n  );\n};\n\nexport { Rating, type RatingProps, type RatingSize };\n"],"mappings":";;;;;;;;AAiBA,MAAM,QAAQ;CACZ,MAAM;CACN,MAAM;CACN,OAAO;AACT;AAEA,MAAM,WAAW;CACf,IAAI;CACJ,IAAI;CACJ,IAAI;AACN;AAEA,MAAM,UAAU,EACd,OACA,eAAe,GACf,eACA,MAAM,GACN,YAAY,IACZ,OAAO,MACP,WAAW,OACX,WAAW,OACX,QAAQ,wCACR,aAAa,8BACb,WACA,OACA,cAAc,YAAY,UAC1B,WACA,GAAG,YACc;CACjB,IAAI,CAAC,OAAO,UAAU,GAAG,KAAK,MAAM,KAAK,MAAM,IAC7C,MAAM,IAAI,MAAM,iDAAiD;CAGnE,MAAM,eAAe,UAAU,KAAA;CAE/B,MAAM,CAAC,eAAe,oBAAoB,eACxC,gBAAgB,cAAc,KAAK,SAAS,CAC9C;CAEA,MAAM,eAAe,gBACnB,eAAe,QAAQ,eACvB,KACA,SACF;CAEA,MAAM,eAAe,cAAsB;EACzC,IAAI,YAAY,UACd;EAGF,MAAM,OAAO,gBAAgB,WAAW,KAAK,SAAS;EAEtD,IAAI,SAAS,cACX;EAGF,IAAI,CAAC,cACH,iBAAiB,IAAI;EAGvB,gBAAgB,IAAI;CACtB;CAEA,MAAM,iBAAiB,UAAyC;EAC9D,YAAY,KAAK;EAEjB,IAAI,MAAM,oBAAoB,YAAY,UACxC;EAGF,MAAM,YAAY,cAAc,cAAc,MAAM,KAAK,KAAK,SAAS;EAEvE,IAAI,cAAc,KAAA,GAChB;EAGF,MAAM,eAAe;EACrB,YAAY,SAAS;CACvB;CAEA,MAAM,UAAU,GACd,iBACA,YAAY,0BACZ,YAAY,0BACZ,SACF;CAEA,OACE,oBAAC,OAAD;EACE,GAAI;EACJ,WAAW;EACX,OACE;GACE,GAAG;GACH,yBAAyB;GACzB,+BAA+B;EACjC;EAEF,MAAM,WAAW,QAAQ;EACzB,UAAU,YAAY,WAAW,KAAA,IAAY;EAC7C,cACE,WACI,GAAG,UAAU,IAAI,aAAa,UAAU,IAAI,UAC5C;EAEN,iBAAe,WAAW,KAAA,IAAY;EACtC,iBAAe,WAAW,KAAA,IAAY;EACtC,iBAAe,WAAW,KAAA,IAAY;EACtC,kBACE,WAAW,KAAA,IAAY,GAAG,aAAa,UAAU,IAAI;EAEvD,iBAAe,YAAY,KAAA;EAC3B,iBAAe,YAAY,KAAA;EAC3B,WAAW;EACX,aAAW;EACX,iBAAe,YAAY,KAAA;EAC3B,iBAAe,YAAY,KAAA;EAE1B,UAAA,MAAM,KAAK,EAAE,QAAQ,IAAI,IAAI,GAAG,UAAU;GACzC,MAAM,QAAQ,mBAAmB,cAAc,KAAK;GAEpD,OACE,oBAAC,QAAD;IAEE,WAAU;IACV,cAAY;IACZ,eAAY;IACZ,UAAU,UAAU;KAClB,MAAM,OAAO,MAAM,cAAc,sBAAsB;KAEvD,MAAM,SACJ,cAAc,MAAO,MAAM,UAAU,KAAK,OAAO,KAAK,QAAQ;KAEhE,YAAY,SAAS,SAAS,KAAM,EAAE;IACxC;IAEA,UAAA,oBAAC,MAAD;KACE,MAAM,MAAM;KACZ,MAAM,SAAS;KACf,eAAY;KACZ,WAAU;IACX,CAAA;GACG,GAnBC,KAmBD;EAEV,CAAC;CACE,CAAA;AAET"}

package/dist/components/data-display/rating/rating.css

@@ -0,0 +1,72 @@
+.puzzle-rating {
+  align-items: center;
+  gap: var(--puzzle-space-1, .25rem);
+  width: fit-content;
+  color: var(--puzzle-rating-color);
+  cursor: pointer;
+  touch-action: manipulation;
+  -webkit-tap-highlight-color: transparent;
+  direction: ltr;
+  display: inline-flex;
+}
+
+.puzzle-rating__star {
+  color: var(--puzzle-rating-empty-color);
+  user-select: none;
+  flex: none;
+  justify-content: center;
+  align-items: center;
+  line-height: 1;
+  display: inline-flex;
+}
+
+.puzzle-rating__star[data-state="full"], .puzzle-rating__star[data-state="half"] {
+  color: var(--puzzle-rating-color);
+}
+
+.puzzle-rating__star svg {
+  display: block;
+}
+
+.puzzle-rating:focus-visible {
+  outline: 2px solid var(--puzzle-color-ring);
+  outline-offset: 3px;
+  border-radius: var(--puzzle-radius-sm, .25rem);
+}
+
+.puzzle-rating-disabled {
+  cursor: not-allowed;
+  opacity: .55;
+}
+
+.puzzle-rating-readonly {
+  cursor: default;
+}
+
+.puzzle-rating[data-size="sm"] {
+  gap: var(--puzzle-space-1, .25rem);
+}
+
+.puzzle-rating[data-size="lg"] {
+  gap: var(--puzzle-space-2, .5rem);
+}
+
+@media (forced-colors: active) {
+  .puzzle-rating__star {
+    color: graytext;
+  }
+
+  .puzzle-rating__star[data-state="full"], .puzzle-rating__star[data-state="half"] {
+    color: highlight;
+  }
+
+  .puzzle-rating:focus-visible {
+    outline-color: highlight;
+  }
+}
+
+@media (prefers-reduced-motion: reduce) {
+  .puzzle-rating, .puzzle-rating__star {
+    transition: none;
+  }
+}

package/dist/components/data-display/rating/rating.types.d.cts

@@ -0,0 +1,15 @@
+import { ComponentPropsWithRef } from "react";
+type RatingSize = "sm" | "md" | "lg";
+type RatingProps = Omit<ComponentPropsWithRef<"div">, "children" | "defaultValue" | "role" | "value"> & {
+  value?: number;
+  defaultValue?: number;
+  onValueChange?: (value: number) => void;
+  max?: number;
+  precision?: 0.5 | 1;
+  size?: RatingSize;
+  readOnly?: boolean;
+  disabled?: boolean;
+  color?: string;
+  emptyColor?: string;
+};
+export type { RatingProps, RatingSize };

package/dist/components/data-display/rating/rating.types.d.ts

@@ -0,0 +1,15 @@
+import { ComponentPropsWithRef } from "react";
+type RatingSize = "sm" | "md" | "lg";
+type RatingProps = Omit<ComponentPropsWithRef<"div">, "children" | "defaultValue" | "role" | "value"> & {
+  value?: number;
+  defaultValue?: number;
+  onValueChange?: (value: number) => void;
+  max?: number;
+  precision?: 0.5 | 1;
+  size?: RatingSize;
+  readOnly?: boolean;
+  disabled?: boolean;
+  color?: string;
+  emptyColor?: string;
+};
+export type { RatingProps, RatingSize };

package/dist/components/data-display/rating/rating.utils.cjs

@@ -0,0 +1,27 @@
+// src/components/data-display/rating/rating.utils.ts
+const normalizeRating = (value, max, precision) => {
+	if (!Number.isFinite(value)) return 0;
+	return Math.round(Math.min(max, Math.max(0, value)) / precision) * precision;
+};
+const getRatingStarState = (value, index) => {
+	const remainder = value - index;
+	if (remainder >= 1) return "full";
+	if (remainder >= .5) return "half";
+	return "empty";
+};
+const getNextRating = (value, key, max, precision) => {
+	switch (key) {
+		case "ArrowRight":
+		case "ArrowUp": return normalizeRating(value + precision, max, precision);
+		case "ArrowLeft":
+		case "ArrowDown": return normalizeRating(value - precision, max, precision);
+		case "Home": return 0;
+		case "End": return max;
+		default: return;
+	}
+};
+exports.getNextRating = getNextRating;
+exports.getRatingStarState = getRatingStarState;
+exports.normalizeRating = normalizeRating;
+
+//# sourceMappingURL=rating.utils.cjs.map

package/dist/components/data-display/rating/rating.utils.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"rating.utils.cjs","names":[],"sources":["../../../../src/components/data-display/rating/rating.utils.ts"],"sourcesContent":["const normalizeRating = (value: number, max: number, precision: 0.5 | 1) => {\n  if (!Number.isFinite(value)) {\n    return 0;\n  }\n\n  const clamped = Math.min(max, Math.max(0, value));\n\n  return Math.round(clamped / precision) * precision;\n};\n\nconst getRatingStarState = (value: number, index: number) => {\n  const remainder = value - index;\n\n  if (remainder >= 1) {\n    return \"full\" as const;\n  }\n\n  if (remainder >= 0.5) {\n    return \"half\" as const;\n  }\n\n  return \"empty\" as const;\n};\n\nconst getNextRating = (\n  value: number,\n  key: string,\n  max: number,\n  precision: 0.5 | 1,\n) => {\n  switch (key) {\n    case \"ArrowRight\":\n    case \"ArrowUp\":\n      return normalizeRating(value + precision, max, precision);\n\n    case \"ArrowLeft\":\n    case \"ArrowDown\":\n      return normalizeRating(value - precision, max, precision);\n\n    case \"Home\":\n      return 0;\n\n    case \"End\":\n      return max;\n\n    default:\n      return undefined;\n  }\n};\n\nexport { normalizeRating, getRatingStarState, getNextRating };\n"],"mappings":";AAAA,MAAM,mBAAmB,OAAe,KAAa,cAAuB;CAC1E,IAAI,CAAC,OAAO,SAAS,KAAK,GACxB,OAAO;CAKT,OAAO,KAAK,MAFI,KAAK,IAAI,KAAK,KAAK,IAAI,GAAG,KAAK,CAEvB,IAAI,SAAS,IAAI;AAC3C;AAEA,MAAM,sBAAsB,OAAe,UAAkB;CAC3D,MAAM,YAAY,QAAQ;CAE1B,IAAI,aAAa,GACf,OAAO;CAGT,IAAI,aAAa,IACf,OAAO;CAGT,OAAO;AACT;AAEA,MAAM,iBACJ,OACA,KACA,KACA,cACG;CACH,QAAQ,KAAR;EACE,KAAK;EACL,KAAK,WACH,OAAO,gBAAgB,QAAQ,WAAW,KAAK,SAAS;EAE1D,KAAK;EACL,KAAK,aACH,OAAO,gBAAgB,QAAQ,WAAW,KAAK,SAAS;EAE1D,KAAK,QACH,OAAO;EAET,KAAK,OACH,OAAO;EAET,SACE;CACJ;AACF"}

package/dist/components/data-display/rating/rating.utils.js

@@ -0,0 +1,25 @@
+// src/components/data-display/rating/rating.utils.ts
+const normalizeRating = (value, max, precision) => {
+	if (!Number.isFinite(value)) return 0;
+	return Math.round(Math.min(max, Math.max(0, value)) / precision) * precision;
+};
+const getRatingStarState = (value, index) => {
+	const remainder = value - index;
+	if (remainder >= 1) return "full";
+	if (remainder >= .5) return "half";
+	return "empty";
+};
+const getNextRating = (value, key, max, precision) => {
+	switch (key) {
+		case "ArrowRight":
+		case "ArrowUp": return normalizeRating(value + precision, max, precision);
+		case "ArrowLeft":
+		case "ArrowDown": return normalizeRating(value - precision, max, precision);
+		case "Home": return 0;
+		case "End": return max;
+		default: return;
+	}
+};
+export { getNextRating, getRatingStarState, normalizeRating };
+
+//# sourceMappingURL=rating.utils.js.map

package/dist/components/data-display/rating/rating.utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"rating.utils.js","names":[],"sources":["../../../../src/components/data-display/rating/rating.utils.ts"],"sourcesContent":["const normalizeRating = (value: number, max: number, precision: 0.5 | 1) => {\n  if (!Number.isFinite(value)) {\n    return 0;\n  }\n\n  const clamped = Math.min(max, Math.max(0, value));\n\n  return Math.round(clamped / precision) * precision;\n};\n\nconst getRatingStarState = (value: number, index: number) => {\n  const remainder = value - index;\n\n  if (remainder >= 1) {\n    return \"full\" as const;\n  }\n\n  if (remainder >= 0.5) {\n    return \"half\" as const;\n  }\n\n  return \"empty\" as const;\n};\n\nconst getNextRating = (\n  value: number,\n  key: string,\n  max: number,\n  precision: 0.5 | 1,\n) => {\n  switch (key) {\n    case \"ArrowRight\":\n    case \"ArrowUp\":\n      return normalizeRating(value + precision, max, precision);\n\n    case \"ArrowLeft\":\n    case \"ArrowDown\":\n      return normalizeRating(value - precision, max, precision);\n\n    case \"Home\":\n      return 0;\n\n    case \"End\":\n      return max;\n\n    default:\n      return undefined;\n  }\n};\n\nexport { normalizeRating, getRatingStarState, getNextRating };\n"],"mappings":";AAAA,MAAM,mBAAmB,OAAe,KAAa,cAAuB;CAC1E,IAAI,CAAC,OAAO,SAAS,KAAK,GACxB,OAAO;CAKT,OAAO,KAAK,MAFI,KAAK,IAAI,KAAK,KAAK,IAAI,GAAG,KAAK,CAEvB,IAAI,SAAS,IAAI;AAC3C;AAEA,MAAM,sBAAsB,OAAe,UAAkB;CAC3D,MAAM,YAAY,QAAQ;CAE1B,IAAI,aAAa,GACf,OAAO;CAGT,IAAI,aAAa,IACf,OAAO;CAGT,OAAO;AACT;AAEA,MAAM,iBACJ,OACA,KACA,KACA,cACG;CACH,QAAQ,KAAR;EACE,KAAK;EACL,KAAK,WACH,OAAO,gBAAgB,QAAQ,WAAW,KAAK,SAAS;EAE1D,KAAK;EACL,KAAK,aACH,OAAO,gBAAgB,QAAQ,WAAW,KAAK,SAAS;EAE1D,KAAK,QACH,OAAO;EAET,KAAK,OACH,OAAO;EAET,SACE;CACJ;AACF"}