@wordpress-gcb/fields 0.2.1 → 0.2.3

package/dist/controls/spacing.js

@@ -0,0 +1,172 @@
+/**
+ * SpacingField — preset spacing (None / S / M / L) with a custom-value escape hatch.
+ *
+ * Stored value is either one of the preset keys (`'small'`, etc.) or a CSS
+ * length string (e.g. `'2rem'`). When set to a custom value, the toggle group
+ * is disabled and a "custom value applied" hint shows.
+ */
+
+import { __ } from '@wordpress/i18n';
+import { Button, TextControl, Notice } from '@wordpress/components';
+import { useState } from '@wordpress/element';
+import { __experimentalToggleGroupControl as ToggleGroupControl, __experimentalToggleGroupControlOption as ToggleGroupControlOption, __experimentalHStack as HStack } from '@wordpress/components';
+import { useTokens, getTokensByGroup } from '../hooks/useTokens';
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+const DEFAULT_PRESETS = [{
+  label: 'None',
+  value: 'none'
+}, {
+  label: 'S',
+  value: 'small'
+}, {
+  label: 'M',
+  value: 'medium'
+}, {
+  label: 'L',
+  value: 'large'
+}];
+const PRESET_KEYS = new Set(['none', 'small', 'medium', 'large']);
+
+/**
+ * Build the toggle presets from the theme's spacing tokens when the field was
+ * configured with a token group (and optional checked subset). Falls back to
+ * the simple None/S/M/L presets when no tokens are configured.
+ */
+function tokenPresets(control, tokens) {
+  const group = control.tokenGroup;
+  if (!group || !tokens) return null;
+  let list = getTokensByGroup(tokens, group);
+  if (!Array.isArray(list) || list.length === 0) return null;
+  if (Array.isArray(control.tokenKeys) && control.tokenKeys.length > 0) {
+    list = list.filter(t => control.tokenKeys.includes(t.slug || t.key));
+  }
+  if (list.length === 0) return null;
+  // Compact label (the slug or short name) — the value is the slug.
+  return list.map(t => ({
+    label: t.name || t.label || t.slug || t.key,
+    value: t.slug || t.key
+  }));
+}
+function isValidCSSValue(input) {
+  if (!input) return true;
+  return /^(\d*\.?\d+)(px|rem|em|%|vw|vh|vmin|vmax)?$/.test(String(input).trim());
+}
+export default function SpacingField({
+  control,
+  value,
+  onChange
+}) {
+  const {
+    tokens
+  } = useTokens();
+
+  // Token-driven presets (from theme.json) take priority over the explicit
+  // `presets` config and the simple None/S/M/L fallback.
+  const presets = tokenPresets(control, tokens) || control.presets || DEFAULT_PRESETS;
+  const presetKeys = new Set(presets.map(p => p.value));
+  const firstPreset = presets[0]?.value || 'medium';
+
+  // Decide if value is a preset or a custom string.
+  const isCustom = typeof value === 'string' && value !== '' && !presetKeys.has(value);
+  const presetValue = isCustom ? firstPreset : value || firstPreset;
+  const [showCustom, setShowCustom] = useState(isCustom);
+  const [customInput, setCustomInput] = useState(isCustom ? value : '');
+  const [error, setError] = useState(null);
+  const handlePreset = next => {
+    setShowCustom(false);
+    setCustomInput('');
+    setError(null);
+    onChange(next);
+  };
+  const handleCustom = next => {
+    setCustomInput(next);
+    if (next && !isValidCSSValue(next)) {
+      setError(__('Invalid spacing value. Use a number with a unit (e.g. 2rem, 20px).', 'gcblite'));
+      return;
+    }
+    setError(null);
+    onChange(next || firstPreset);
+  };
+  const handleReset = () => {
+    setShowCustom(false);
+    setCustomInput('');
+    setError(null);
+    onChange(firstPreset);
+  };
+  const displayHint = showCustom ? 'Custom' : presetValue.charAt(0).toUpperCase() + presetValue.slice(1);
+  return /*#__PURE__*/_jsx("div", {
+    className: `gcb-spacing-field components-base-control ${control.className || ''}`.trim(),
+    children: /*#__PURE__*/_jsxs("div", {
+      className: "components-base-control__field",
+      children: [/*#__PURE__*/_jsxs(HStack, {
+        children: [/*#__PURE__*/_jsxs("span", {
+          className: "components-base-control__label",
+          children: [control.label, /*#__PURE__*/_jsx("span", {
+            className: "components-font-size-picker__header__hint",
+            children: displayHint
+          })]
+        }), /*#__PURE__*/_jsx(Button, {
+          size: "small",
+          label: __('Set custom spacing', 'gcblite'),
+          onClick: () => setShowCustom(true),
+          isPressed: showCustom,
+          icon: /*#__PURE__*/_jsxs("svg", {
+            xmlns: "http://www.w3.org/2000/svg",
+            viewBox: "0 0 24 24",
+            width: "24",
+            height: "24",
+            "aria-hidden": true,
+            focusable: "false",
+            children: [/*#__PURE__*/_jsx("path", {
+              d: "m19 7.5h-7.628c-.3089-.87389-1.1423-1.5-2.122-1.5-.97966 0-1.81309.62611-2.12197 1.5h-2.12803v1.5h2.12803c.30888.87389 1.14231 1.5 2.12197 1.5.9797 0 1.8131-.62611 2.122-1.5h7.628z"
+            }), /*#__PURE__*/_jsx("path", {
+              d: "m19 15h-2.128c-.3089-.8739-1.1423-1.5-2.122-1.5s-1.8131.6261-2.122 1.5h-7.628v1.5h7.628c.3089.8739 1.1423 1.5 2.122 1.5s1.8131-.6261 2.122-1.5h2.128z"
+            })]
+          })
+        })]
+      }), error && /*#__PURE__*/_jsx(Notice, {
+        status: "warning",
+        isDismissible: true,
+        onRemove: () => setError(null),
+        children: error
+      }), showCustom && /*#__PURE__*/_jsxs("div", {
+        style: {
+          marginBottom: 16,
+          fontSize: 13
+        },
+        children: [/*#__PURE__*/_jsx("span", {
+          children: __('Custom value applied', 'gcblite')
+        }), /*#__PURE__*/_jsx(Button, {
+          variant: "link",
+          onClick: handleReset,
+          style: {
+            marginLeft: 8,
+            fontSize: 13
+          },
+          children: __('Reset', 'gcblite')
+        })]
+      }), /*#__PURE__*/_jsx(ToggleGroupControl, {
+        label: control.label,
+        value: presetValue,
+        onChange: handlePreset,
+        isBlock: true,
+        hideLabelFromVision: true,
+        disabled: showCustom,
+        className: showCustom ? 'is-disabled' : '',
+        __nextHasNoMarginBottom: true,
+        __next40pxDefaultSize: true,
+        children: presets.map(preset => /*#__PURE__*/_jsx(ToggleGroupControlOption, {
+          value: preset.value,
+          label: preset.label
+        }, preset.value))
+      }), showCustom && /*#__PURE__*/_jsx(TextControl, {
+        label: __('Custom Spacing', 'gcblite'),
+        value: customInput,
+        onChange: handleCustom,
+        placeholder: "e.g. 2rem or 20px",
+        help: __('Enter a value with unit (e.g. 2rem, 20px, 5%) or leave empty for 0.', 'gcblite'),
+        __nextHasNoMarginBottom: true
+      })]
+    })
+  });
+}