@rogieking/figui3 6.21.1 → 6.23.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.
@@ -73,7 +73,7 @@ export default defineConfig({
73
73
  - `fig-fill-picker` is optional. Import `fig-editor.js` and `fig-editor.css` when full picker behavior is needed.
74
74
  - Do not use `picker` or `picker-anchor` on `fig-input-color`; components auto-detect `fig-fill-picker` at interaction time.
75
75
  - `picker-*` attrs on `fig-input-color` are forwarded to `fig-fill-picker` only when the optional picker is registered.
76
- - Example: `picker-dialog-position`, `picker-experimental`, etc.
76
+ - Example: `picker-dialog-position`.
77
77
  - For React custom modes, use `fig-fill-picker` + slot API:
78
78
  - Add a child with `slot="mode-<name>"` (and optional `label`).
79
79
  - Include `<name>` in the `mode` attribute (e.g. `mode="solid,react-demo"`).
@@ -88,19 +88,6 @@ export default defineConfig({
88
88
  - `fig-input-color` expects solid color data (`detail.color`, optional `detail.alpha`) from the picker.
89
89
  - `fig-fill-picker` custom modes use JSON with `type` set to mode name and remaining data in payload.
90
90
 
91
- ## Experimental Attribute Guidance
92
-
93
- - Use `experimental` as a feature-flag string for opt-in behavior. Treat it as progressive enhancement, not guaranteed baseline behavior.
94
- - Prefer `experimental="modern"` when enabling modern customizable select/picker UI behavior.
95
- - Keep usage explicit on the component that needs it (for example `fig-dropdown`, `fig-fill-picker`, `fig-input-fill`, `fig-input-color`).
96
- - Preserve pass-through behavior:
97
- - `fig-input-color` and `fig-input-fill` forward experimental-related picker settings into internal `fig-fill-picker` usage.
98
- - Avoid adding hidden implicit defaults that enable experimental behavior globally.
99
- - Backward-compat rule:
100
- - Do not reintroduce the old `neue` variant name for dropdown experimental behavior.
101
- - Use `variant="classic"` only when a slider needs the previous visual style.
102
- - Documentation rule: any new experimental token must be documented with activation syntax, intended scope, and fallback behavior in demos + README + changelog.
103
-
104
91
  ## Critical Rules
105
92
 
106
93
  ### Overlay Components (`fig-dialog`, `fig-popup`)
@@ -142,7 +129,6 @@ export default defineConfig({
142
129
  - Update `README.md` component docs when public API or behavior changes.
143
130
  - Update demo surfaces (`index.html` and `playground/` routes where relevant) for visible behavior changes.
144
131
  - Prefer realistic examples that mirror plugin/property panel usage.
145
- - If introducing an experimental feature, document activation and fallback behavior clearly.
146
132
 
147
133
  ### Compatibility and Safety
148
134
 
@@ -151,11 +151,11 @@ bootstrap();
151
151
  <!-- Fill + blend pair -->
152
152
  <fig-field direction="horizontal">
153
153
  <label>Fill</label>
154
- <fig-input-fill value='{"type":"solid","color":"#667eea"}' experimental="modern"></fig-input-fill>
154
+ <fig-input-fill value='{"type":"solid","color":"#667eea"}'></fig-input-fill>
155
155
  </fig-field>
156
156
  <fig-field direction="horizontal">
157
157
  <label>Blend</label>
158
- <fig-dropdown full experimental="modern">
158
+ <fig-dropdown full>
159
159
  <option selected>Normal</option>
160
160
  <option>Multiply</option>
161
161
  </fig-dropdown>
package/README.md CHANGED
@@ -218,7 +218,6 @@ One import for every host (`@rogieking/figui3/propskit.js`). Framework examples
218
218
  |---|---|---|---|
219
219
  | `value` | string | — | Selected value |
220
220
  | `type` | string | `"select"` | `"select"` or `"dropdown"` |
221
- | `experimental` | string | — | Feature flags (e.g. `"modern"` for `appearance: base-select`) |
222
221
  | `label` | string | — | Accessible label for the generated native `<select>` |
223
222
  | `disabled` | boolean | `false` | Disabled state |
224
223
 
@@ -229,7 +228,7 @@ One import for every host (`@rogieking/figui3/propskit.js`). Framework examples
229
228
  </fig-dropdown>
230
229
  ```
231
230
 
232
- Keyboard activation follows the native select pattern. Enter opens the closed picker, and when `experimental="modern"` is open, Enter is left to the browser so the focused option commits normally.
231
+ Keyboard activation follows the native select pattern. Enter opens the closed picker.
233
232
 
234
233
  ---
235
234
 
@@ -372,7 +371,7 @@ PropsKit controls that support `size` default to the large layout when the attri
372
371
 
373
372
  Composes a `<fig-field>` and `<fig-input-color>` into a full-surface property control. Color attributes are forwarded to the inner input and text editing remains enabled.
374
373
 
375
- **Attributes:** `label`, `value`, `alpha`, `disabled`, `experimental`, `size`
374
+ **Attributes:** `label`, `value`, `alpha`, `disabled`, `size`
376
375
 
377
376
  **Events:** `input`, `change` — forwarded from the inner color input.
378
377
 
@@ -626,7 +625,6 @@ A compact solid-color swatch. Uses `<fig-fill-picker>` when the optional picker
626
625
  | `text` | boolean | `false` | Show hex text input |
627
626
  | `alpha` | boolean | `true` | Show alpha slider; set `alpha="false"` to hide opacity controls |
628
627
  | `mode` | string | — | Color mode (`"hex"`, `"rgb"`, `"hsl"`) |
629
- | `experimental` | string | — | Feature flags |
630
628
  | `picker-*` | string | — | Forwarded to `<fig-fill-picker>` when the optional picker is registered |
631
629
  | `disabled` | boolean | `false` | Disabled state |
632
630
 
@@ -688,7 +686,6 @@ A gradient editor with draggable stops. With `edit="picker"` and the optional pi
688
686
  | `edit` | boolean/string | `true` | `true`, `false`, or `"picker"` |
689
687
  | `mode` | string | `"handle"` | `"handle"` renders color stop handles without tips; `"tip"` renders persistent color tips |
690
688
  | `disabled` | boolean | `false` | Disabled state |
691
- | `experimental` | string | — | Picker feature flags |
692
689
  | `picker-*` | string | — | Passthrough picker attributes |
693
690
 
694
691
  Supported interpolation spaces: `srgb`, `srgb-linear`, `display-p3`, `oklab`, `oklch` (with `hueInterpolation`: `shorter`, `longer`, `increasing`, `decreasing`).
@@ -719,7 +716,6 @@ A comprehensive fill input supporting solid, gradient, image, and video fills. W
719
716
  | `value` | string | — | JSON fill data |
720
717
  | `disabled` | boolean | `false` | Disabled state |
721
718
  | `mode` | string | — | Lock to a fill mode |
722
- | `experimental` | string | — | Feature flags |
723
719
  | `alpha` | boolean | `true` | Show alpha controls |
724
720
  | `picker-*` | string | — | Forwarded to `<fig-fill-picker>` when the optional picker is registered |
725
721
 
@@ -750,7 +746,6 @@ Optional full fill picker dialog supporting solid, gradient, image, video, and w
750
746
  | `disabled` | boolean | `false` | Disabled state |
751
747
  | `alpha` | boolean | `true` | Show alpha controls |
752
748
  | `mode` | string | — | Lock to mode: `"solid"`, `"gradient"`, `"image"`, `"video"`, `"webcam"` |
753
- | `experimental` | string | — | Feature flags |
754
749
 
755
750
  **Events:**
756
751
 
@@ -1112,10 +1107,13 @@ A modal/non-modal dialog. Uses `is="fig-dialog"` on a native `<dialog>` element.
1112
1107
  ```html
1113
1108
  <dialog is="fig-dialog" id="myDialog" modal drag handle="fig-header" position="center center">
1114
1109
  <fig-header>Dialog Title</fig-header>
1115
- <fig-content><p>Content here.</p></fig-content>
1110
+ <fig-content padding><p>Content here.</p></fig-content>
1116
1111
  </dialog>
1117
1112
  ```
1118
1113
 
1114
+ Use `padding` on `fig-content` for prose-only content. Leave it off when
1115
+ rendering `fig-field` or `fig-group` children, which provide their own gutters.
1116
+
1119
1117
  Dialog close paths restore focus to the element that opened the dialog.
1120
1118
 
1121
1119
  ---