@gridui/slider 0.0.0-stage → 1.0.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/README.md CHANGED
@@ -1,3 +1,8 @@
1
- # Temporary Holding Version
1
+ # @gridui/slider
2
2
 
3
- This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
3
+ Core family. Public API: `Slider`, `SliderProps`.
4
+
5
+ Import components from `@gridui/slider` and load `@gridui/slider/styles.css` after Theme.
6
+ Load styles for any composed dependency used by this family. Applications own routes, labels, state persistence, and branding.
7
+
8
+ See [component ownership](../../docs/component-ownership.md) and [release history](.changeset/history/).
@@ -0,0 +1,8 @@
1
+ /**
2
+ * @author WMXPY
3
+ * @package Slider
4
+ * @namespace Root
5
+ * @description Index
6
+ */
7
+ export type { SliderProps } from "./slider/slider";
8
+ export { Slider } from "./slider/slider";
package/dist/index.js ADDED
@@ -0,0 +1,163 @@
1
+ // src/slider/slider.tsx
2
+ import { cn } from "@gridui/style-utils";
3
+ import * as Primitive from "@radix-ui/react-slider";
4
+ import { useEffect, useId, useImperativeHandle, useRef, useState } from "react";
5
+ import { jsx, jsxs } from "react/jsx-runtime";
6
+ var Slider = (props) => {
7
+ const {
8
+ className,
9
+ min = 0,
10
+ max = 100,
11
+ step = 1,
12
+ value,
13
+ defaultValue,
14
+ thumbLabels,
15
+ getValueText,
16
+ onValueChange,
17
+ onValueCommit,
18
+ name,
19
+ disabled,
20
+ ref,
21
+ ...restProps
22
+ } = props;
23
+ const [
24
+ inheritedDisabled,
25
+ setInheritedDisabled
26
+ ] = useState(false);
27
+ const [
28
+ local,
29
+ setLocal
30
+ ] = useState(defaultValue ?? [min]);
31
+ const values = value ?? local;
32
+ const initial = useRef(local);
33
+ const root = useRef(null);
34
+ const detachedForm = `${useId()}-detached`;
35
+ useImperativeHandle(ref, () => {
36
+ return root.current;
37
+ });
38
+ useEffect(() => {
39
+ const fieldsets = [];
40
+ for (let parent = root.current?.parentElement; parent; parent = parent.parentElement) {
41
+ if (parent instanceof HTMLFieldSetElement) {
42
+ fieldsets.push(parent);
43
+ }
44
+ }
45
+ const update = () => {
46
+ setInheritedDisabled(fieldsets.some((fieldset) => {
47
+ return fieldset.disabled && !fieldset.querySelector(":scope > legend")?.contains(root.current);
48
+ }));
49
+ };
50
+ update();
51
+ const observer = new MutationObserver(update);
52
+ for (const fieldset of fieldsets) {
53
+ observer.observe(fieldset, {
54
+ attributes: true,
55
+ attributeFilter: ["disabled"]
56
+ });
57
+ }
58
+ return () => {
59
+ observer.disconnect();
60
+ };
61
+ }, []);
62
+ useEffect(() => {
63
+ const form = restProps.form ? document.getElementById(restProps.form) : root.current?.closest("form");
64
+ if (!(form instanceof HTMLFormElement)) {
65
+ return;
66
+ }
67
+ let mounted = true;
68
+ const reset = (event) => {
69
+ setTimeout(() => {
70
+ if (mounted && !event.defaultPrevented && value === void 0) {
71
+ setLocal(initial.current);
72
+ }
73
+ }, 0);
74
+ };
75
+ form.addEventListener("reset", reset, true);
76
+ return () => {
77
+ mounted = false;
78
+ form.removeEventListener("reset", reset, true);
79
+ };
80
+ }, [
81
+ restProps.form,
82
+ value
83
+ ]);
84
+ if (!Number.isFinite(min) || !Number.isFinite(max) || min >= max || !Number.isFinite(step) || step <= 0 || values.length === 0 || values.some((entry, index) => {
85
+ return !Number.isFinite(entry) || entry < min || entry > max || index > 0 && entry < values[index - 1];
86
+ }) || thumbLabels.length !== values.length || thumbLabels.some((label) => {
87
+ return !label.trim();
88
+ })) {
89
+ throw new RangeError("Slider requires an ordered finite range and values, a positive step, and a label for each thumb.");
90
+ }
91
+ return /* @__PURE__ */ jsxs(
92
+ Primitive.Root,
93
+ {
94
+ ...restProps,
95
+ form: detachedForm,
96
+ min,
97
+ max,
98
+ step,
99
+ ref: root,
100
+ disabled: disabled || inheritedDisabled,
101
+ value: [...values],
102
+ onValueChange: (next) => {
103
+ if (disabled || inheritedDisabled || root.current?.querySelector("input")?.matches(":disabled")) {
104
+ return;
105
+ }
106
+ if (value === void 0) {
107
+ setLocal(next);
108
+ }
109
+ onValueChange?.(next);
110
+ },
111
+ onValueCommit: (next) => {
112
+ if (!disabled && !inheritedDisabled && !root.current?.querySelector("input")?.matches(":disabled")) {
113
+ onValueCommit?.(next);
114
+ }
115
+ },
116
+ defaultValue: [...defaultValue ?? [min]],
117
+ className: cn("gridui-slider", className),
118
+ children: [
119
+ /* @__PURE__ */ jsx(
120
+ Primitive.Track,
121
+ {
122
+ className: "gridui-slider-track",
123
+ children: /* @__PURE__ */ jsx(
124
+ Primitive.Range,
125
+ {
126
+ className: "gridui-slider-range"
127
+ }
128
+ )
129
+ }
130
+ ),
131
+ values.map((entry, index) => {
132
+ return /* @__PURE__ */ jsx(
133
+ Primitive.Thumb,
134
+ {
135
+ className: "gridui-slider-thumb",
136
+ "aria-label": thumbLabels[index],
137
+ "aria-valuenow": entry,
138
+ "aria-valuetext": getValueText?.(entry, index)
139
+ },
140
+ index
141
+ );
142
+ }),
143
+ values.map((entry, index) => {
144
+ return /* @__PURE__ */ jsx(
145
+ "input",
146
+ {
147
+ type: "hidden",
148
+ name: name && values.length > 1 ? `${name}[]` : name,
149
+ form: restProps.form,
150
+ disabled: disabled || inheritedDisabled,
151
+ value: entry
152
+ },
153
+ index
154
+ );
155
+ })
156
+ ]
157
+ }
158
+ );
159
+ };
160
+ export {
161
+ Slider
162
+ };
163
+ //# sourceMappingURL=index.js.map
@@ -0,0 +1,7 @@
1
+ {
2
+ "version": 3,
3
+ "sources": ["../src/slider/slider.tsx"],
4
+ "sourcesContent": ["/**\n * @author WMXPY\n * @package Slider\n * @namespace Slider\n * @description Slider\n */\n\nimport { cn } from \"@gridui/style-utils\";\nimport * as Primitive from \"@radix-ui/react-slider\";\nimport { type ComponentPropsWithRef, type FC, useEffect, useId, useImperativeHandle, useRef, useState } from \"react\";\n\nexport type SliderProps = Omit<ComponentPropsWithRef<typeof Primitive.Root>, \"children\" | \"value\" | \"defaultValue\"> & {\n readonly value?: readonly number[];\n readonly defaultValue?: readonly number[];\n readonly thumbLabels: readonly string[];\n readonly getValueText?: (value: number, index: number) => string;\n};\n\nexport const Slider: FC<SliderProps> = (props: SliderProps) => {\n const { className, min = 0, max = 100, step = 1, value, defaultValue, thumbLabels, getValueText,\n onValueChange, onValueCommit, name, disabled, ref, ...restProps } = props;\n const [\n inheritedDisabled,\n setInheritedDisabled,\n ] = useState(false);\n const [\n local,\n setLocal,\n ] = useState<readonly number[]>(defaultValue ?? [min]);\n const values = value ?? local;\n const initial = useRef(local);\n const root = useRef<HTMLSpanElement>(null);\n const detachedForm = `${useId()}-detached`;\n useImperativeHandle(ref, () => {\n return root.current as HTMLSpanElement;\n });\n useEffect(() => {\n const fieldsets: HTMLFieldSetElement[] = [];\n for (let parent = root.current?.parentElement; parent; parent = parent.parentElement) {\n if (parent instanceof HTMLFieldSetElement) {\n fieldsets.push(parent);\n }\n }\n const update = () => {\n setInheritedDisabled(fieldsets.some(fieldset => {\n return fieldset.disabled && !fieldset.querySelector(\":scope > legend\")?.contains(root.current);\n }));\n };\n update();\n const observer = new MutationObserver(update);\n for (const fieldset of fieldsets) {\n observer.observe(fieldset, {\n attributes: true,\n attributeFilter: [\"disabled\"],\n });\n }\n return () => {\n observer.disconnect();\n };\n }, []);\n useEffect(() => {\n const form = restProps.form ? document.getElementById(restProps.form) : root.current?.closest(\"form\");\n if (!(form instanceof HTMLFormElement)) {\n return;\n }\n let mounted = true;\n const reset = (event: Event) => {\n // Wait until React bubbling handlers can cancel the native reset.\n setTimeout(() => {\n if (mounted && !event.defaultPrevented && value === undefined) {\n setLocal(initial.current);\n }\n }, 0);\n };\n form.addEventListener(\"reset\", reset, true);\n return () => {\n mounted = false;\n form.removeEventListener(\"reset\", reset, true);\n };\n }, [\n restProps.form,\n value,\n ]);\n if (!Number.isFinite(min) || !Number.isFinite(max) || min >= max || !Number.isFinite(step) || step <= 0\n || values.length === 0 || values.some((entry, index) => {\n return !Number.isFinite(entry) || entry < min || entry > max || (index > 0 && entry < values[index - 1]!);\n })\n || thumbLabels.length !== values.length || thumbLabels.some(label => {\n return !label.trim();\n })) {\n throw new RangeError(\"Slider requires an ordered finite range and values, a positive step, and a label for each thumb.\");\n }\n return (<Primitive.Root\n {...restProps}\n // The native mirror owns reset so cancellation is respected.\n form={detachedForm}\n min={min}\n max={max}\n step={step}\n ref={root}\n disabled={disabled || inheritedDisabled}\n value={[...values]}\n onValueChange={(next) => {\n if (disabled || inheritedDisabled || root.current?.querySelector(\"input\")?.matches(\":disabled\")) {\n return;\n }\n if (value === undefined) {\n setLocal(next);\n }\n onValueChange?.(next);\n }}\n onValueCommit={(next) => {\n if (!disabled && !inheritedDisabled && !root.current?.querySelector(\"input\")?.matches(\":disabled\")) {\n onValueCommit?.(next);\n }\n }}\n defaultValue={[...(defaultValue ?? [min])]}\n className={cn(\"gridui-slider\", className)}\n >\n <Primitive.Track\n className=\"gridui-slider-track\"\n >\n <Primitive.Range\n className=\"gridui-slider-range\"\n />\n </Primitive.Track>\n {values.map((entry, index) => {\n return (<Primitive.Thumb\n key={index}\n className=\"gridui-slider-thumb\"\n aria-label={thumbLabels[index]}\n aria-valuenow={entry}\n aria-valuetext={getValueText?.(entry, index)}\n />);\n })}\n {values.map((entry, index) => {\n return (<input\n key={index}\n type=\"hidden\"\n name={name && values.length > 1 ? `${name}[]` : name}\n form={restProps.form}\n disabled={disabled || inheritedDisabled}\n value={entry}\n />);\n })}\n </Primitive.Root>);\n};\n"],
5
+ "mappings": "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",
6
+ "names": []
7
+ }
@@ -0,0 +1,15 @@
1
+ /**
2
+ * @author WMXPY
3
+ * @package Slider
4
+ * @namespace Slider
5
+ * @description Slider
6
+ */
7
+ import * as Primitive from "@radix-ui/react-slider";
8
+ import { type ComponentPropsWithRef, type FC } from "react";
9
+ export type SliderProps = Omit<ComponentPropsWithRef<typeof Primitive.Root>, "children" | "value" | "defaultValue"> & {
10
+ readonly value?: readonly number[];
11
+ readonly defaultValue?: readonly number[];
12
+ readonly thumbLabels: readonly string[];
13
+ readonly getValueText?: (value: number, index: number) => string;
14
+ };
15
+ export declare const Slider: FC<SliderProps>;
@@ -0,0 +1,64 @@
1
+ /*! tailwindcss v4.3.3 | MIT License | https://tailwindcss.com */
2
+ @layer theme, base, components, utilities;
3
+ @layer utilities {
4
+ .hidden {
5
+ display: none;
6
+ }
7
+ }
8
+ @layer components {
9
+ .gridui-slider {
10
+ position: relative;
11
+ display: flex;
12
+ align-items: center;
13
+ min-width: 0;
14
+ width: 100%;
15
+ min-height: 2.75rem;
16
+ touch-action: none;
17
+ user-select: none;
18
+ }
19
+ .gridui-slider[data-orientation="vertical"] {
20
+ flex-direction: column;
21
+ width: 2.75rem;
22
+ height: 10rem;
23
+ }
24
+ .gridui-slider[data-disabled] {
25
+ opacity: 0.5;
26
+ }
27
+ .gridui-slider-track {
28
+ position: relative;
29
+ flex-grow: 1;
30
+ height: 0.25rem;
31
+ background: var(--gridui-surface);
32
+ }
33
+ .gridui-slider[data-orientation="vertical"] .gridui-slider-track {
34
+ width: 0.25rem;
35
+ height: 100%;
36
+ }
37
+ .gridui-slider-range {
38
+ position: absolute;
39
+ height: 100%;
40
+ background: var(--gridui-accent-background);
41
+ }
42
+ .gridui-slider[data-orientation="vertical"] .gridui-slider-range {
43
+ width: 100%;
44
+ height: auto;
45
+ }
46
+ .gridui-slider-thumb {
47
+ display: block;
48
+ position: relative;
49
+ width: 1.25rem;
50
+ height: 1.25rem;
51
+ border: 1px solid var(--gridui-control-border);
52
+ border-radius: var(--gridui-control-radius);
53
+ background: var(--gridui-background);
54
+ cursor: grab;
55
+ }
56
+ .gridui-slider-thumb::after {
57
+ content: "";
58
+ position: absolute;
59
+ inset: -0.75rem;
60
+ }
61
+ .gridui-slider-thumb[data-disabled] {
62
+ cursor: not-allowed;
63
+ }
64
+ }
package/package.json CHANGED
@@ -1,6 +1,51 @@
1
1
  {
2
2
  "name": "@gridui/slider",
3
- "version": "0.0.0-stage",
4
- "stub": true,
5
- "description": "Temporary package placeholder for staged publishing"
3
+ "version": "1.0.0",
4
+ "description": "GridUI React slider",
5
+ "license": "UNLICENSED",
6
+ "type": "module",
7
+ "files": [
8
+ "dist",
9
+ "README.md"
10
+ ],
11
+ "sideEffects": [
12
+ "**/*.css"
13
+ ],
14
+ "exports": {
15
+ ".": {
16
+ "types": "./dist/index.d.ts",
17
+ "import": "./dist/index.js"
18
+ },
19
+ "./styles.css": "./dist/styles.css"
20
+ },
21
+ "publishConfig": {
22
+ "access": "public"
23
+ },
24
+ "peerDependencies": {
25
+ "react": "^19.2.0",
26
+ "react-dom": "^19.2.0"
27
+ },
28
+ "dependencies": {
29
+ "@gridui/style-utils": "^2.1.2",
30
+ "@gridui/theme": "^2.1.2",
31
+ "@radix-ui/react-slider": "1.6.1"
32
+ },
33
+ "devDependencies": {
34
+ "@gridui-internal/configuration": "0.0.0",
35
+ "@jest/globals": "30.5.2",
36
+ "@types/jest": "30.0.0",
37
+ "@types/node": "26.6.5",
38
+ "@types/react": "19.3.0",
39
+ "@types/react-dom": "19.3.0",
40
+ "jest": "30.5.2",
41
+ "react": "19.3.1",
42
+ "react-dom": "19.3.1",
43
+ "typescript": "6.0.3"
44
+ },
45
+ "scripts": {
46
+ "build": "node ../../scripts/compilation/package.ts",
47
+ "compile": "tsc --project tsconfig.json",
48
+ "test": "jest",
49
+ "coverage": "jest --coverage"
50
+ }
6
51
  }