@lostgradient/cinder 0.19.0 → 0.19.1

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/CHANGELOG.md CHANGED
@@ -1,5 +1,15 @@
1
1
  # @lostgradient/cinder
2
2
 
3
+ ## 0.19.1
4
+
5
+ ### Patch Changes
6
+
7
+ - [#914](https://github.com/stevekinney/cinder/pull/914) [`8efb8b6`](https://github.com/stevekinney/cinder/commit/8efb8b6b27d3f705dca8b2197df2fb33f80b0339) Thanks [@stevekinney](https://github.com/stevekinney)! - Prevent FacetedFilterBar select labels from clipping by allowing controls to grow to fit their line box.
8
+
9
+ - [#916](https://github.com/stevekinney/cinder/pull/916) [`eaa52b6`](https://github.com/stevekinney/cinder/commit/eaa52b6b5d359ca071df8eb5039b261c0ac4b40f) Thanks [@stevekinney](https://github.com/stevekinney)! - Add visually hidden Select labels and warn when a bound value does not match any option.
10
+
11
+ - [#915](https://github.com/stevekinney/cinder/pull/915) [`79cc14b`](https://github.com/stevekinney/cinder/commit/79cc14b49750cdeae92e3cb16a75bc4ef77d1582) Thanks [@stevekinney](https://github.com/stevekinney)! - Load Stat styles when using the StatGroup compound component API.
12
+
3
13
  ## 0.19.0
4
14
 
5
15
  ### Minor Changes
package/components.json CHANGED
@@ -3,7 +3,7 @@
3
3
  "manifestVersion": 1,
4
4
  "package": {
5
5
  "name": "@lostgradient/cinder",
6
- "version": "0.19.0",
6
+ "version": "0.19.1",
7
7
  "framework": "svelte",
8
8
  "frameworkVersionRange": ">=5.56.0 <6",
9
9
  "classPrefix": "cinder-",
@@ -54,7 +54,7 @@
54
54
  font: inherit;
55
55
  font-size: var(--cinder-text-sm);
56
56
  line-height: var(--cinder-leading-normal);
57
- block-size: var(--cinder-control-height-sm, 2rem);
57
+ min-block-size: var(--cinder-control-height-sm, 2rem);
58
58
  cursor: pointer;
59
59
  transition:
60
60
  border-color var(--cinder-duration-fast) var(--cinder-ease-standard),
@@ -1769,6 +1769,7 @@ var rest_excludes6 = new Set([
1769
1769
  "value",
1770
1770
  "options",
1771
1771
  "label",
1772
+ "hideLabel",
1772
1773
  "description",
1773
1774
  "error",
1774
1775
  "required",
@@ -1778,14 +1779,14 @@ var rest_excludes6 = new Set([
1778
1779
  "aria-invalid"
1779
1780
  ]);
1780
1781
  var root6 = $7.from_html(`<span class="cinder-_required-marker" aria-hidden="true">*</span>`);
1781
- var root_16 = $7.from_html(`<label class="cinder-select-field__label"> <!></label>`);
1782
+ var root_16 = $7.from_html(`<label> <!></label>`);
1782
1783
  var root_26 = $7.from_html(`<select></select>`);
1783
1784
  var root_36 = $7.from_html(`<option> </option>`);
1784
1785
  var root_45 = $7.from_html(`<p class="cinder-select-field__description"> </p>`);
1785
1786
  var root_53 = $7.from_html(`<div><!> <span class="cinder-select-field__control"><!> <span class="cinder-select-field__chevron" aria-hidden="true"></span></span> <!> <p class="cinder-select-field__error" aria-live="polite"> </p></div>`);
1786
1787
  function Select($$anchor, $$props) {
1787
1788
  $7.push($$props, true);
1788
- let value = $7.prop($$props, "value", 15), rest = $7.rest_props($$props, rest_excludes6);
1789
+ let value = $7.prop($$props, "value", 15), hideLabel = $7.prop($$props, "hideLabel", 3, false), rest = $7.rest_props($$props, rest_excludes6);
1789
1790
  const context = getFormFieldContext();
1790
1791
  const field = $7.derived(() => resolveFieldControl({
1791
1792
  id: $$props.id,
@@ -1803,6 +1804,8 @@ function Select($$anchor, $$props) {
1803
1804
  $7.user_effect(() => {
1804
1805
  if ($$props.options.length === 0) {
1805
1806
  devWarn("[cinder/Select] options is empty — pass at least one option, or ignore during async load.");
1807
+ } else if (value() !== undefined && !$$props.options.some((option) => option.value === value())) {
1808
+ devWarn("[cinder/Select] value does not match any option — pass a value from options or omit it.");
1806
1809
  }
1807
1810
  });
1808
1811
  var div = root_53();
@@ -1823,11 +1826,14 @@ function Select($$anchor, $$props) {
1823
1826
  });
1824
1827
  }
1825
1828
  $7.reset(label_1);
1826
- $7.template_effect(() => {
1829
+ $7.template_effect(($0) => {
1827
1830
  $7.set_attribute(label_1, "for", $$props.id);
1831
+ $7.set_class(label_1, 1, $0);
1828
1832
  $7.set_attribute(label_1, "data-disabled", $7.get(field).disabled || undefined);
1829
1833
  $7.set_text(text, `${$$props.label ?? ""} `);
1830
- });
1834
+ }, [
1835
+ () => $7.clsx(classNames("cinder-select-field__label", hideLabel() && "cinder-sr-only"))
1836
+ ]);
1831
1837
  $7.append($$anchor2, label_1);
1832
1838
  };
1833
1839
  $7.if(node, ($$render) => {
@@ -3345,4 +3351,4 @@ export {
3345
3351
  Schedule_builder as ScheduleBuilder
3346
3352
  };
3347
3353
 
3348
- //# debugId=748BE6DDFC4BBB0C64756E2164756E21
3354
+ //# debugId=3D9D2023D93D716464756E2164756E21
@@ -1167,6 +1167,7 @@ var rest_excludes4 = new Set([
1167
1167
  "value",
1168
1168
  "options",
1169
1169
  "label",
1170
+ "hideLabel",
1170
1171
  "description",
1171
1172
  "error",
1172
1173
  "required",
@@ -1176,14 +1177,14 @@ var rest_excludes4 = new Set([
1176
1177
  "aria-invalid"
1177
1178
  ]);
1178
1179
  var root4 = $4.from_html(`<span class="cinder-_required-marker" aria-hidden="true">*</span>`);
1179
- var root_14 = $4.from_html(`<label class="cinder-select-field__label"> <!></label>`);
1180
+ var root_14 = $4.from_html(`<label> <!></label>`);
1180
1181
  var root_24 = $4.from_html(`<select></select>`);
1181
1182
  var root_34 = $4.from_html(`<option> </option>`);
1182
1183
  var root_44 = $4.from_html(`<p class="cinder-select-field__description"> </p>`);
1183
1184
  var root_53 = $4.from_html(`<div><!> <span class="cinder-select-field__control"><!> <span class="cinder-select-field__chevron" aria-hidden="true"></span></span> <!> <p class="cinder-select-field__error" aria-live="polite"> </p></div>`);
1184
1185
  function Select($$anchor, $$props) {
1185
1186
  $4.push($$props, true);
1186
- let value = $4.prop($$props, "value", 15), rest = $4.rest_props($$props, rest_excludes4);
1187
+ let value = $4.prop($$props, "value", 15), hideLabel = $4.prop($$props, "hideLabel", 3, false), rest = $4.rest_props($$props, rest_excludes4);
1187
1188
  const context = getFormFieldContext();
1188
1189
  const field = $4.derived(() => resolveFieldControl({
1189
1190
  id: $$props.id,
@@ -1201,6 +1202,8 @@ function Select($$anchor, $$props) {
1201
1202
  $4.user_effect(() => {
1202
1203
  if ($$props.options.length === 0) {
1203
1204
  devWarn("[cinder/Select] options is empty — pass at least one option, or ignore during async load.");
1205
+ } else if (value() !== undefined && !$$props.options.some((option) => option.value === value())) {
1206
+ devWarn("[cinder/Select] value does not match any option — pass a value from options or omit it.");
1204
1207
  }
1205
1208
  });
1206
1209
  var div = root_53();
@@ -1221,11 +1224,14 @@ function Select($$anchor, $$props) {
1221
1224
  });
1222
1225
  }
1223
1226
  $4.reset(label_1);
1224
- $4.template_effect(() => {
1227
+ $4.template_effect(($0) => {
1225
1228
  $4.set_attribute(label_1, "for", $$props.id);
1229
+ $4.set_class(label_1, 1, $0);
1226
1230
  $4.set_attribute(label_1, "data-disabled", $4.get(field).disabled || undefined);
1227
1231
  $4.set_text(text, `${$$props.label ?? ""} `);
1228
- });
1232
+ }, [
1233
+ () => $4.clsx(classNames("cinder-select-field__label", hideLabel() && "cinder-sr-only"))
1234
+ ]);
1229
1235
  $4.append($$anchor2, label_1);
1230
1236
  };
1231
1237
  $4.if(node, ($$render) => {
@@ -2727,4 +2733,4 @@ export {
2727
2733
  Schema_form as SchemaForm
2728
2734
  };
2729
2735
 
2730
- //# debugId=CC6776F31AC165C364756E2164756E21
2736
+ //# debugId=9E1A8A930A67D35164756E2164756E21
@@ -140,6 +140,7 @@ var rest_excludes = new Set([
140
140
  "value",
141
141
  "options",
142
142
  "label",
143
+ "hideLabel",
143
144
  "description",
144
145
  "error",
145
146
  "required",
@@ -149,14 +150,14 @@ var rest_excludes = new Set([
149
150
  "aria-invalid"
150
151
  ]);
151
152
  var root = $.from_html(`<span class="cinder-_required-marker" aria-hidden="true">*</span>`);
152
- var root_1 = $.from_html(`<label class="cinder-select-field__label"> <!></label>`);
153
+ var root_1 = $.from_html(`<label> <!></label>`);
153
154
  var root_2 = $.from_html(`<select></select>`);
154
155
  var root_3 = $.from_html(`<option> </option>`);
155
156
  var root_4 = $.from_html(`<p class="cinder-select-field__description"> </p>`);
156
157
  var root_5 = $.from_html(`<div><!> <span class="cinder-select-field__control"><!> <span class="cinder-select-field__chevron" aria-hidden="true"></span></span> <!> <p class="cinder-select-field__error" aria-live="polite"> </p></div>`);
157
158
  function Select($$anchor, $$props) {
158
159
  $.push($$props, true);
159
- let value = $.prop($$props, "value", 15), rest = $.rest_props($$props, rest_excludes);
160
+ let value = $.prop($$props, "value", 15), hideLabel = $.prop($$props, "hideLabel", 3, false), rest = $.rest_props($$props, rest_excludes);
160
161
  const context = getFormFieldContext();
161
162
  const field = $.derived(() => resolveFieldControl({
162
163
  id: $$props.id,
@@ -174,6 +175,8 @@ function Select($$anchor, $$props) {
174
175
  $.user_effect(() => {
175
176
  if ($$props.options.length === 0) {
176
177
  devWarn("[cinder/Select] options is empty — pass at least one option, or ignore during async load.");
178
+ } else if (value() !== undefined && !$$props.options.some((option) => option.value === value())) {
179
+ devWarn("[cinder/Select] value does not match any option — pass a value from options or omit it.");
177
180
  }
178
181
  });
179
182
  var div = root_5();
@@ -194,11 +197,14 @@ function Select($$anchor, $$props) {
194
197
  });
195
198
  }
196
199
  $.reset(label_1);
197
- $.template_effect(() => {
200
+ $.template_effect(($0) => {
198
201
  $.set_attribute(label_1, "for", $$props.id);
202
+ $.set_class(label_1, 1, $0);
199
203
  $.set_attribute(label_1, "data-disabled", $.get(field).disabled || undefined);
200
204
  $.set_text(text, `${$$props.label ?? ""} `);
201
- });
205
+ }, [
206
+ () => $.clsx(classNames("cinder-select-field__label", hideLabel() && "cinder-sr-only"))
207
+ ]);
202
208
  $.append($$anchor2, label_1);
203
209
  };
204
210
  $.if(node, ($$render) => {
@@ -301,4 +307,4 @@ export {
301
307
  Select
302
308
  };
303
309
 
304
- //# debugId=292CCF81922236DA64756E2164756E21
310
+ //# debugId=FA2173692C84D5FD64756E2164756E21
@@ -72,6 +72,10 @@ var schema = {
72
72
  type: "string",
73
73
  description: "Visible label rendered in a `<label>` associated via `for`."
74
74
  },
75
+ hideLabel: {
76
+ type: "boolean",
77
+ description: "Visually hides the label while keeping it available to assistive technology."
78
+ },
75
79
  description: {
76
80
  type: "string",
77
81
  description: "Helper text rendered below the control; wired via `aria-describedby`."
@@ -109,4 +113,4 @@ export {
109
113
  select_schema_default as default
110
114
  };
111
115
 
112
- //# debugId=ABDDFB14887ADD8F64756E2164756E21
116
+ //# debugId=CAC7A1DD4E39706F64756E2164756E21
@@ -13,6 +13,8 @@ export type SelectProps<T extends string = string> = HTMLSelectAttributes & {
13
13
  options: readonly SelectOption<T>[];
14
14
  /** Visible label rendered in a `<label>` associated via `for`. */
15
15
  label?: string;
16
+ /** Visually hides the label while keeping it available to assistive technology. */
17
+ hideLabel?: boolean;
16
18
  /** Helper text rendered below the control; wired via `aria-describedby`. */
17
19
  description?: string;
18
20
  /** Validation error message; sets `aria-invalid="true"` and is wired via `aria-describedby`. */
@@ -1,4 +1,5 @@
1
1
  @layer cinder.tokens, cinder.foundation, cinder.components, cinder.utilities;
2
+ @import '../stat/stat.css';
2
3
  @layer cinder.components {
3
4
  .cinder-stat-group {
4
5
  --cinder-stat-group-gap: var(--cinder-space-4, 1rem);
package/dist/index.js CHANGED
@@ -50822,6 +50822,7 @@ var rest_excludes112 = new Set([
50822
50822
  "value",
50823
50823
  "options",
50824
50824
  "label",
50825
+ "hideLabel",
50825
50826
  "description",
50826
50827
  "error",
50827
50828
  "required",
@@ -50831,14 +50832,14 @@ var rest_excludes112 = new Set([
50831
50832
  "aria-invalid"
50832
50833
  ]);
50833
50834
  var root149 = $235.from_html(`<span class="cinder-_required-marker" aria-hidden="true">*</span>`);
50834
- var root_1159 = $235.from_html(`<label class="cinder-select-field__label"> <!></label>`);
50835
+ var root_1159 = $235.from_html(`<label> <!></label>`);
50835
50836
  var root_299 = $235.from_html(`<select></select>`);
50836
50837
  var root_386 = $235.from_html(`<option> </option>`);
50837
50838
  var root_460 = $235.from_html(`<p class="cinder-select-field__description"> </p>`);
50838
50839
  var root_546 = $235.from_html(`<div><!> <span class="cinder-select-field__control"><!> <span class="cinder-select-field__chevron" aria-hidden="true"></span></span> <!> <p class="cinder-select-field__error" aria-live="polite"> </p></div>`);
50839
50840
  function Select($$anchor, $$props) {
50840
50841
  $235.push($$props, true);
50841
- let value = $235.prop($$props, "value", 15), rest = $235.rest_props($$props, rest_excludes112);
50842
+ let value = $235.prop($$props, "value", 15), hideLabel = $235.prop($$props, "hideLabel", 3, false), rest = $235.rest_props($$props, rest_excludes112);
50842
50843
  const context = getFormFieldContext();
50843
50844
  const field = $235.derived(() => resolveFieldControl({
50844
50845
  id: $$props.id,
@@ -50856,6 +50857,8 @@ function Select($$anchor, $$props) {
50856
50857
  $235.user_effect(() => {
50857
50858
  if ($$props.options.length === 0) {
50858
50859
  devWarn("[cinder/Select] options is empty — pass at least one option, or ignore during async load.");
50860
+ } else if (value() !== undefined && !$$props.options.some((option) => option.value === value())) {
50861
+ devWarn("[cinder/Select] value does not match any option — pass a value from options or omit it.");
50859
50862
  }
50860
50863
  });
50861
50864
  var div = root_546();
@@ -50876,11 +50879,14 @@ function Select($$anchor, $$props) {
50876
50879
  });
50877
50880
  }
50878
50881
  $235.reset(label_1);
50879
- $235.template_effect(() => {
50882
+ $235.template_effect(($0) => {
50880
50883
  $235.set_attribute(label_1, "for", $$props.id);
50884
+ $235.set_class(label_1, 1, $0);
50881
50885
  $235.set_attribute(label_1, "data-disabled", $235.get(field).disabled || undefined);
50882
50886
  $235.set_text(text38, `${$$props.label ?? ""} `);
50883
- });
50887
+ }, [
50888
+ () => $235.clsx(classNames("cinder-select-field__label", hideLabel() && "cinder-sr-only"))
50889
+ ]);
50884
50890
  $235.append($$anchor2, label_1);
50885
50891
  };
50886
50892
  $235.if(node, ($$render) => {
@@ -65922,4 +65928,4 @@ export {
65922
65928
  AccessGateExport as AccessGate
65923
65929
  };
65924
65930
 
65925
- //# debugId=885A4B4DA7E3699064756E2164756E21
65931
+ //# debugId=D46DC87530A0430C64756E2164756E21
@@ -1,11 +1,11 @@
1
1
  import {
2
2
  Schedule_builder,
3
3
  schedule_builder_default
4
- } from "../../index.server-9nac5z11.js";
4
+ } from "../../index.server-psqfjzpc.js";
5
5
  import"../../index.server-c42b462p.js";
6
6
  import"../../index.server-jgdtsvz2.js";
7
7
  import"../../index.server-mknhgg07.js";
8
- import"../../index.server-ex3ea9z0.js";
8
+ import"../../index.server-xsdzbgs2.js";
9
9
  import"../../index.server-d146g8pr.js";
10
10
  import"../../index.server-chh0fzxj.js";
11
11
  import"../../index.server-h54v6c32.js";
@@ -2,8 +2,8 @@ import {
2
2
  Schema_form,
3
3
  readSchemaFormData,
4
4
  schema_form_default
5
- } from "../../index.server-66nm5gd5.js";
6
- import"../../index.server-ex3ea9z0.js";
5
+ } from "../../index.server-ghvvqkfc.js";
6
+ import"../../index.server-xsdzbgs2.js";
7
7
  import"../../index.server-d146g8pr.js";
8
8
  import"../../index.server-chh0fzxj.js";
9
9
  import"../../index.server-435sj5m6.js";
@@ -1,9 +1,9 @@
1
1
  import {
2
2
  select_default
3
- } from "../../index.server-8ak2cftv.js";
3
+ } from "../../index.server-z754e36a.js";
4
4
  import {
5
5
  Select
6
- } from "../../index.server-ex3ea9z0.js";
6
+ } from "../../index.server-xsdzbgs2.js";
7
7
  import"../../index.server-weae7gs2.js";
8
8
  import"../../index.server-493m9fm5.js";
9
9
  import"../../index.server-abm21gz1.js";
@@ -175,7 +175,7 @@ import {
175
175
  } from "./index.server-4dfs3xwn.js";
176
176
  import {
177
177
  select_default
178
- } from "./index.server-8ak2cftv.js";
178
+ } from "./index.server-z754e36a.js";
179
179
  import {
180
180
  selectable_row_default
181
181
  } from "./index.server-1gzbrhhh.js";
@@ -199,15 +199,15 @@ import {
199
199
  } from "./index.server-62593nnh.js";
200
200
  import {
201
201
  schedule_builder_default
202
- } from "./index.server-9nac5z11.js";
202
+ } from "./index.server-psqfjzpc.js";
203
203
  import"./index.server-c42b462p.js";
204
204
  import"./index.server-jgdtsvz2.js";
205
205
  import"./index.server-mknhgg07.js";
206
206
  import {
207
207
  readSchemaFormData,
208
208
  schema_form_default
209
- } from "./index.server-66nm5gd5.js";
210
- import"./index.server-ex3ea9z0.js";
209
+ } from "./index.server-ghvvqkfc.js";
210
+ import"./index.server-xsdzbgs2.js";
211
211
  import {
212
212
  scroll_area_default
213
213
  } from "./index.server-66amt15s.js";
@@ -1,6 +1,6 @@
1
1
  import {
2
2
  Select
3
- } from "./index.server-ex3ea9z0.js";
3
+ } from "./index.server-xsdzbgs2.js";
4
4
  import {
5
5
  Number_input
6
6
  } from "./index.server-d146g8pr.js";
@@ -9,7 +9,7 @@ import {
9
9
  } from "./index.server-mknhgg07.js";
10
10
  import {
11
11
  Select
12
- } from "./index.server-ex3ea9z0.js";
12
+ } from "./index.server-xsdzbgs2.js";
13
13
  import {
14
14
  Number_input
15
15
  } from "./index.server-d146g8pr.js";
@@ -17,6 +17,7 @@ function Select($$renderer, $$props) {
17
17
  value = undefined,
18
18
  options,
19
19
  label,
20
+ hideLabel = false,
20
21
  description,
21
22
  error,
22
23
  required,
@@ -45,7 +46,7 @@ function Select($$renderer, $$props) {
45
46
  $$renderer2.push(`<div${$.attr_class($.clsx(classNames("cinder-select-field", className)))}>`);
46
47
  if (label) {
47
48
  $$renderer2.push("<!--[0-->");
48
- $$renderer2.push(`<label${$.attr("for", id)} class="cinder-select-field__label"${$.attr("data-disabled", field().disabled || undefined)}>${$.escape(label)} `);
49
+ $$renderer2.push(`<label${$.attr("for", id)}${$.attr_class($.clsx(classNames("cinder-select-field__label", hideLabel && "cinder-sr-only")))}${$.attr("data-disabled", field().disabled || undefined)}>${$.escape(label)} `);
49
50
  if (field().required) {
50
51
  $$renderer2.push("<!--[0-->");
51
52
  $$renderer2.push(`<span class="cinder-_required-marker" aria-hidden="true">*</span>`);
@@ -106,4 +107,4 @@ function Select($$renderer, $$props) {
106
107
 
107
108
  export { Select };
108
109
 
109
- //# debugId=82F3F27AA444759E64756E2164756E21
110
+ //# debugId=EA31119EFED9073364756E2164756E21
@@ -1,6 +1,6 @@
1
1
  import {
2
2
  Select
3
- } from "./index.server-ex3ea9z0.js";
3
+ } from "./index.server-xsdzbgs2.js";
4
4
 
5
5
  // src/components/select/index.ts
6
6
  var select_default = Select;
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@lostgradient/cinder",
3
- "version": "0.19.0",
3
+ "version": "0.19.1",
4
4
  "description": "A Svelte 5 component library and design system focused on accessibility, theming, and per-component tree-shaking.",
5
5
  "keywords": [
6
6
  "svelte",
@@ -54,7 +54,7 @@
54
54
  font: inherit;
55
55
  font-size: var(--cinder-text-sm);
56
56
  line-height: var(--cinder-leading-normal);
57
- block-size: var(--cinder-control-height-sm, 2rem);
57
+ min-block-size: var(--cinder-control-height-sm, 2rem);
58
58
  cursor: pointer;
59
59
  transition:
60
60
  border-color var(--cinder-duration-fast) var(--cinder-ease-standard),
@@ -18,6 +18,10 @@
18
18
  "type": "string",
19
19
  "description": "Visible label rendered in a `<label>` associated via `for`."
20
20
  },
21
+ "hideLabel": {
22
+ "type": "boolean",
23
+ "description": "Visually hides the label while keeping it available to assistive technology."
24
+ },
21
25
  "description": {
22
26
  "type": "string",
23
27
  "description": "Helper text rendered below the control; wired via `aria-describedby`."
@@ -20,6 +20,10 @@ const schema = {
20
20
  type: 'string',
21
21
  description: 'Visible label rendered in a `<label>` associated via `for`.',
22
22
  },
23
+ hideLabel: {
24
+ type: 'boolean',
25
+ description: 'Visually hides the label while keeping it available to assistive technology.',
26
+ },
23
27
  description: {
24
28
  type: 'string',
25
29
  description: 'Helper text rendered below the control; wired via `aria-describedby`.',
@@ -7,7 +7,7 @@ import { resolveFieldControl } from '../../_internal/field-control.ts';
7
7
  import { getFormFieldContext } from '../../_internal/form-field-context.ts';
8
8
  import { classNames } from '../../utilities/class-names.ts';
9
9
  import { devWarn } from '../../utilities/dev-warn.ts';
10
- let { id, value = $bindable(), options, label, description, error, required, disabled, class: className, 'aria-describedby': consumerDescribedBy, 'aria-invalid': consumerInvalid, ...rest } = $props();
10
+ let { id, value = $bindable(), options, label, hideLabel = false, description, error, required, disabled, class: className, 'aria-describedby': consumerDescribedBy, 'aria-invalid': consumerInvalid, ...rest } = $props();
11
11
  const context = getFormFieldContext();
12
12
  const field = $derived(resolveFieldControl({
13
13
  id,
@@ -31,12 +31,19 @@ $effect(() => {
31
31
  if (options.length === 0) {
32
32
  devWarn('[cinder/Select] options is empty — pass at least one option, or ignore during async load.');
33
33
  }
34
+ else if (value !== undefined && !options.some((option) => option.value === value)) {
35
+ devWarn('[cinder/Select] value does not match any option — pass a value from options or omit it.');
36
+ }
34
37
  });
35
38
  </script>
36
39
 
37
40
  <div class={classNames('cinder-select-field', className)}>
38
41
  {#if label}
39
- <label for={id} class="cinder-select-field__label" data-disabled={field.disabled || undefined}>
42
+ <label
43
+ for={id}
44
+ class={classNames('cinder-select-field__label', hideLabel && 'cinder-sr-only')}
45
+ data-disabled={field.disabled || undefined}
46
+ >
40
47
  {label}
41
48
  {#if field.required}
42
49
  <span class="cinder-_required-marker" aria-hidden="true">*</span>
@@ -15,6 +15,8 @@ export type SelectProps<T extends string = string> = HTMLSelectAttributes & {
15
15
  options: readonly SelectOption<T>[];
16
16
  /** Visible label rendered in a `<label>` associated via `for`. */
17
17
  label?: string;
18
+ /** Visually hides the label while keeping it available to assistive technology. */
19
+ hideLabel?: boolean;
18
20
  /** Helper text rendered below the control; wired via `aria-describedby`. */
19
21
  description?: string;
20
22
  /** Validation error message; sets `aria-invalid="true"` and is wired via `aria-describedby`. */
@@ -1,4 +1,5 @@
1
1
  @layer cinder.tokens, cinder.foundation, cinder.components, cinder.utilities;
2
+ @import '../stat/stat.css';
2
3
  @layer cinder.components {
3
4
  .cinder-stat-group {
4
5
  --cinder-stat-group-gap: var(--cinder-space-4, 1rem);