@astryxdesign/core 0.7.6-canary.fdabeba → 0.7.6

package/dist/Resizable/resizableModel.js

@@ -0,0 +1,287 @@
+// Copyright (c) Meta Platforms, Inc. and affiliates.
+
+/**
+ * @file resizableModel.ts
+ * @input Size values (pixels, `Npx`, `N%`, pixel() and percent()), a basis,
+ *   bounds, snap points, and a storage key
+ * @output The resize model's pure parts: size parsing and resolution against a
+ *   basis, clamping and snapping, persistence, and the content-box measurement
+ *   of a percentage basis
+ * @position Shared by useResizable and createResizable, so both resolve,
+ *   clamp, snap and persist alike; no React, and no DOM work on import
+ */
+
+import { devWarn } from "../utils/devWarning.js";
+export const DEFAULT_MIN = 50;
+export const DEFAULT_COLLAPSED_SIZE = 40;
+export const STORAGE_PREFIX = 'astryx-resizable:';
+export function clampSize(size, min, max, snaps) {
+  const clamped = Math.min(max, Math.max(min, size));
+
+  // When snap points are defined, always snap to the nearest one.
+  // No intermediate positions — the panel can only rest at snap values.
+  if (snaps.length > 0) {
+    let nearest = snaps[0];
+    let nearestDist = Math.abs(clamped - nearest);
+    for (let i = 1; i < snaps.length; i++) {
+      const dist = Math.abs(clamped - snaps[i]);
+      if (dist < nearestDist) {
+        nearest = snaps[i];
+        nearestDist = dist;
+      }
+    }
+    return Math.min(max, Math.max(min, nearest));
+  }
+  return clamped;
+}
+/**
+ * Reads a persisted entry. Three formats exist in storage:
+ * - `{size, isCollapsed}` — the current format; `size` is the expanded size,
+ *   so the pre-collapse width survives a collapsed session
+ * - a plain non-zero number — a legacy width-only entry that never recorded
+ *   collapse, so `isCollapsed` is null (unknown)
+ * - a plain `0` — written by legacy collapse, which restored the region as a
+ *   zero-width expanded panel (#4790); read as "collapsed, no saved size"
+ */
+export function loadPersistedState(key) {
+  if (typeof window === 'undefined') {
+    return null;
+  }
+  try {
+    const raw = localStorage.getItem(STORAGE_PREFIX + key);
+    if (raw == null) {
+      return null;
+    }
+    const parsed = JSON.parse(raw);
+    if (typeof parsed === 'number') {
+      if (!Number.isFinite(parsed)) {
+        return null;
+      }
+      return parsed === 0 ? {
+        size: null,
+        isCollapsed: true
+      } : {
+        size: parsed,
+        isCollapsed: null
+      };
+    }
+    if (typeof parsed === 'object' && parsed != null) {
+      const {
+        size,
+        isCollapsed
+      } = parsed;
+      const hasSize = typeof size === 'number' && Number.isFinite(size) && size > 0;
+      if (hasSize || isCollapsed === true) {
+        return {
+          size: hasSize ? size : null,
+          isCollapsed: isCollapsed === true
+        };
+      }
+    }
+  } catch {
+    /* ignore */
+  }
+  return null;
+}
+export function persistState(key, state) {
+  if (typeof window === 'undefined') {
+    return;
+  }
+  try {
+    localStorage.setItem(STORAGE_PREFIX + key, JSON.stringify(state));
+  } catch {
+    /* ignore */
+  }
+}
+
+/** The released compatibility basis when there is no window to measure. */
+export const SERVER_BASIS = 1200;
+export const DEFAULT_SIZE_FALLBACK = 250;
+export const RESIZABLE_SIZE_GUIDANCE = 'Use a non-negative number of pixels, an exact "Npx" string, an exact ' + '"N%" string from 0% to 100%, pixel(value), or ' + 'percent(value, {min: pixel(value)}) / percent(value, {max: pixel(value)}).';
+
+/** Parsed, validated input. */
+
+const PX_PATTERN = /^(\d+(?:\.\d+)?)px$/;
+const PERCENT_PATTERN = /^(\d+(?:\.\d+)?)%$/;
+function parseSizeString(value) {
+  // Preserve the released atomic fast path exactly.
+  const px = PX_PATTERN.exec(value);
+  if (px) {
+    const parsed = Number(px[1]);
+    return Number.isFinite(parsed) ? {
+      kind: 'px',
+      value: parsed
+    } : null;
+  }
+  const percentValue = PERCENT_PATTERN.exec(value);
+  if (percentValue) {
+    const parsed = Number(percentValue[1]);
+    return Number.isFinite(parsed) && parsed <= 100 ? {
+      kind: 'percent',
+      value: parsed
+    } : null;
+  }
+  return null;
+}
+function parsePixelSize(value) {
+  if (typeof value !== 'object' || value == null || Array.isArray(value)) {
+    return null;
+  }
+  const candidate = value;
+  return candidate.type === 'pixel' && typeof candidate.value === 'number' && Number.isFinite(candidate.value) && candidate.value >= 0 ? candidate.value : null;
+}
+function parsePercentSize(value) {
+  if (Array.isArray(value)) {
+    return null;
+  }
+  const candidate = value;
+  if (candidate.type !== 'percent' || typeof candidate.value !== 'number' || !Number.isFinite(candidate.value) || candidate.value < 0 || candidate.value > 100) {
+    return null;
+  }
+  const hasMin = candidate.min !== undefined;
+  const hasMax = candidate.max !== undefined;
+  // Exactly one bound is required. The helper's public type enforces this for
+  // typed callers; this branch preserves it for JavaScript and `any`.
+  if (hasMin === hasMax) {
+    return null;
+  }
+  if (hasMin) {
+    const min = parsePixelSize(candidate.min);
+    return min == null ? null : {
+      kind: 'percent',
+      value: candidate.value,
+      min
+    };
+  }
+  const max = parsePixelSize(candidate.max);
+  return max == null ? null : {
+    kind: 'percent',
+    value: candidate.value,
+    max
+  };
+}
+export function parseSize(value) {
+  if (typeof value === 'number') {
+    return Number.isFinite(value) && value >= 0 ? {
+      kind: 'px',
+      value
+    } : null;
+  }
+  if (typeof value === 'string') {
+    return parseSizeString(value);
+  }
+  if (typeof value === 'object' && value != null) {
+    const pixelValue = parsePixelSize(value);
+    return pixelValue == null ? parsePercentSize(value) : {
+      kind: 'px',
+      value: pixelValue
+    };
+  }
+  return null;
+}
+
+/** Whether this parsed value must be recomputed when its basis changes. */
+export function dependsOnBasis(parsed) {
+  return parsed?.kind === 'percent';
+}
+
+/** Resolve a parsed size against its basis, then apply its one pixel bound. */
+export function toPixels(parsed, basis) {
+  if (parsed.kind === 'px') {
+    return parsed.value;
+  }
+  if (basis == null) {
+    return null;
+  }
+  const percentagePx = Math.round(parsed.value / 100 * basis);
+  if (parsed.min !== undefined) {
+    return Math.max(percentagePx, parsed.min);
+  }
+  if (parsed.max !== undefined) {
+    return Math.min(percentagePx, parsed.max);
+  }
+  return percentagePx;
+}
+function describeUnknown(value) {
+  if (typeof value === 'number' && !Number.isFinite(value)) {
+    return String(value);
+  }
+  try {
+    return JSON.stringify(value) ?? String(value);
+  } catch {
+    return String(value);
+  }
+}
+function describePixelCandidate(value) {
+  if (typeof value !== 'object' || value == null || Array.isArray(value)) {
+    return describeUnknown(value);
+  }
+  const candidate = value;
+  return candidate.type === 'pixel' ? `{"type":"pixel","value":${describeUnknown(candidate.value)}}` : describeUnknown(value);
+}
+function describeSize(value) {
+  if (typeof value === 'object' && value != null && !Array.isArray(value)) {
+    const candidate = value;
+    if (candidate.type === 'pixel') {
+      return describePixelCandidate(value);
+    }
+    if (candidate.type === 'percent') {
+      const fields = ['"type":"percent"', `"value":${describeUnknown(candidate.value)}`];
+      if (candidate.min !== undefined) {
+        fields.push(`"min":${describePixelCandidate(candidate.min)}`);
+      }
+      if (candidate.max !== undefined) {
+        fields.push(`"max":${describePixelCandidate(candidate.max)}`);
+      }
+      return `{${fields.join(',')}}`;
+    }
+  }
+  return describeUnknown(value);
+}
+
+/**
+ * Resolves one configured value, applying its role's fallback when the input is
+ * not accepted. The warning remains development-only through `devWarn`; every
+ * build takes the same deterministic fallback.
+ */
+export function resolveBound(raw, parsed, basis, fallback, label, accepted, didWarnRef, source = 'useResizable') {
+  if (raw === undefined) {
+    return fallback;
+  }
+  // Preserve the released explicit unbounded maximum. Other roles still
+  // reject non-finite numbers.
+  if (raw === Infinity && fallback === Infinity) {
+    return Infinity;
+  }
+  if (parsed == null) {
+    if (!didWarnRef.current) {
+      didWarnRef.current = true;
+      devWarn(source, `${label}: ${describeSize(raw)} is not a size. ${accepted} ` + `Falling back to ${fallback}.`);
+    }
+    return fallback;
+  }
+  return toPixels(parsed, basis) ?? fallback;
+}
+
+/**
+ * The container's content-box size on the active axis.
+ *
+ * Content box, not border box: a bordered or padded container would otherwise
+ * report a basis a few pixels larger than the space a percentage is actually a
+ * share of, and that error lands in `aria-valuemax`. The observer entry
+ * carries `contentBoxSize` natively, which is already writing-mode aware;
+ * measuring the element is the fallback for the synthetic entry
+ * `observeResize` fires on registration.
+ */
+export function measureContentBox(element, direction, entry) {
+  const box = entry?.contentBoxSize?.[0];
+  if (box) {
+    return direction === 'vertical' ? box.blockSize : box.inlineSize;
+  }
+  const style = typeof window === 'undefined' ? null : window.getComputedStyle(element);
+  if (style == null) {
+    return null;
+  }
+  const size = direction === 'vertical' ? element.clientHeight - parseFloat(style.paddingTop) - parseFloat(style.paddingBottom) : element.clientWidth - parseFloat(style.paddingLeft) - parseFloat(style.paddingRight);
+  return Number.isFinite(size) ? size : null;
+}

package/dist/Resizable/useResizable.d.ts

@@ -10,6 +10,7 @@
 import { type RefObject } from 'react';
 import type { SizeValue } from '../utils/types.js';
 import type { ResizableSize } from './utils.js';
+import { type ResizableDirection } from './resizableModel.js';
 /** Minimum size configuration. */
 export type ResizableMinConfig = {
     minSize?: ResizableSize;
@@ -18,7 +19,7 @@ export type ResizableMinConfig = {
 export type ResizableMaxConfig = {
     maxSize?: ResizableSize;
 };
-export type ResizableDirection = 'horizontal' | 'vertical';
+export type { ResizableDirection } from './resizableModel.js';
 export interface ResizableRegionSizing {
     /**
      * Initial size. A number is pixels, exact `Npx` is pixels, exact `N%` is a
@@ -199,5 +200,4 @@ type MultiResizableArgument<Config extends UseResizableMultiConfig> = Config ext
 } : never;
 export declare function useResizable<const Config extends UseResizableSingleConfig>(config: SingleResizableArgument<Config>): ResizableRegion;
 export declare function useResizable<const Config extends UseResizableMultiConfig>(config: MultiResizableArgument<Config>): Record<string, ResizableRegion>;
-export {};
 //# sourceMappingURL=useResizable.d.ts.map

package/dist/Resizable/useResizable.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"useResizable.d.ts","sourceRoot":"","sources":["../../src/Resizable/useResizable.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"useResizable.d.ts","sourceRoot":"","sources":["../../src/Resizable/useResizable.ts"],"names":[],"mappings":"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"}

package/dist/Resizable/useResizable.js

@@ -15,6 +15,7 @@ import { useCallback, useEffect, useRef, useState, useSyncExternalStore } from '
 import { observeResize } from "../utils/sharedResizeObserver.js";
 import { useIsomorphicLayoutEffect } from "../hooks/useIsomorphicLayoutEffect.js";
 import { devWarn } from "../utils/devWarning.js";
+import { DEFAULT_COLLAPSED_SIZE, DEFAULT_MIN, DEFAULT_SIZE_FALLBACK, RESIZABLE_SIZE_GUIDANCE, SERVER_BASIS, clampSize, dependsOnBasis, loadPersistedState, measureContentBox, parseSize, persistState, resolveBound } from "./resizableModel.js";
 
 // =============================================================================
 // Types
@@ -30,100 +31,6 @@ import { devWarn } from "../utils/devWarning.js";
  * over the full ResizableRegionConfig.
  */
 
-// =============================================================================
-// Constants
-// =============================================================================
-
-const DEFAULT_MIN = 50;
-const DEFAULT_COLLAPSED_SIZE = 40;
-const STORAGE_PREFIX = 'astryx-resizable:';
-
-// =============================================================================
-// Helpers
-// =============================================================================
-
-function clampSize(size, min, max, snaps) {
-  const clamped = Math.min(max, Math.max(min, size));
-
-  // When snap points are defined, always snap to the nearest one.
-  // No intermediate positions — the panel can only rest at snap values.
-  if (snaps.length > 0) {
-    let nearest = snaps[0];
-    let nearestDist = Math.abs(clamped - nearest);
-    for (let i = 1; i < snaps.length; i++) {
-      const dist = Math.abs(clamped - snaps[i]);
-      if (dist < nearestDist) {
-        nearest = snaps[i];
-        nearestDist = dist;
-      }
-    }
-    return Math.min(max, Math.max(min, nearest));
-  }
-  return clamped;
-}
-/**
- * Reads a persisted entry. Three formats exist in storage:
- * - `{size, isCollapsed}` — the current format; `size` is the expanded size,
- *   so the pre-collapse width survives a collapsed session
- * - a plain non-zero number — a legacy width-only entry that never recorded
- *   collapse, so `isCollapsed` is null (unknown)
- * - a plain `0` — written by legacy collapse, which restored the region as a
- *   zero-width expanded panel (#4790); read as "collapsed, no saved size"
- */
-function loadPersistedState(key) {
-  if (typeof window === 'undefined') {
-    return null;
-  }
-  try {
-    const raw = localStorage.getItem(STORAGE_PREFIX + key);
-    if (raw == null) {
-      return null;
-    }
-    const parsed = JSON.parse(raw);
-    if (typeof parsed === 'number') {
-      if (!Number.isFinite(parsed)) {
-        return null;
-      }
-      return parsed === 0 ? {
-        size: null,
-        isCollapsed: true
-      } : {
-        size: parsed,
-        isCollapsed: null
-      };
-    }
-    if (typeof parsed === 'object' && parsed != null) {
-      const {
-        size,
-        isCollapsed
-      } = parsed;
-      const hasSize = typeof size === 'number' && Number.isFinite(size) && size > 0;
-      if (hasSize || isCollapsed === true) {
-        return {
-          size: hasSize ? size : null,
-          isCollapsed: isCollapsed === true
-        };
-      }
-    }
-  } catch {
-    /* ignore */
-  }
-  return null;
-}
-function persistState(key, state) {
-  if (typeof window === 'undefined') {
-    return;
-  }
-  try {
-    localStorage.setItem(STORAGE_PREFIX + key, JSON.stringify(state));
-  } catch {
-    /* ignore */
-  }
-}
-
-/** The released compatibility basis when there is no window to measure. */
-const SERVER_BASIS = 1200;
-
 /** A store that never changes on its own; the snapshot is re-read on render. */
 const noopSubscribe = () => () => {};
 
@@ -152,196 +59,6 @@ function readWindowHeight() {
 function readNoWindowExtent() {
   return null;
 }
-const DEFAULT_SIZE_FALLBACK = 250;
-const RESIZABLE_SIZE_GUIDANCE = 'Use a non-negative number of pixels, an exact "Npx" string, an exact ' + '"N%" string from 0% to 100%, pixel(value), or ' + 'percent(value, {min: pixel(value)}) / percent(value, {max: pixel(value)}).';
-
-/** Parsed, validated input. */
-
-const PX_PATTERN = /^(\d+(?:\.\d+)?)px$/;
-const PERCENT_PATTERN = /^(\d+(?:\.\d+)?)%$/;
-function parseSizeString(value) {
-  // Preserve the released atomic fast path exactly.
-  const px = PX_PATTERN.exec(value);
-  if (px) {
-    const parsed = Number(px[1]);
-    return Number.isFinite(parsed) ? {
-      kind: 'px',
-      value: parsed
-    } : null;
-  }
-  const percentValue = PERCENT_PATTERN.exec(value);
-  if (percentValue) {
-    const parsed = Number(percentValue[1]);
-    return Number.isFinite(parsed) && parsed <= 100 ? {
-      kind: 'percent',
-      value: parsed
-    } : null;
-  }
-  return null;
-}
-function parsePixelSize(value) {
-  if (typeof value !== 'object' || value == null || Array.isArray(value)) {
-    return null;
-  }
-  const candidate = value;
-  return candidate.type === 'pixel' && typeof candidate.value === 'number' && Number.isFinite(candidate.value) && candidate.value >= 0 ? candidate.value : null;
-}
-function parsePercentSize(value) {
-  if (Array.isArray(value)) {
-    return null;
-  }
-  const candidate = value;
-  if (candidate.type !== 'percent' || typeof candidate.value !== 'number' || !Number.isFinite(candidate.value) || candidate.value < 0 || candidate.value > 100) {
-    return null;
-  }
-  const hasMin = candidate.min !== undefined;
-  const hasMax = candidate.max !== undefined;
-  // Exactly one bound is required. The helper's public type enforces this for
-  // typed callers; this branch preserves it for JavaScript and `any`.
-  if (hasMin === hasMax) {
-    return null;
-  }
-  if (hasMin) {
-    const min = parsePixelSize(candidate.min);
-    return min == null ? null : {
-      kind: 'percent',
-      value: candidate.value,
-      min
-    };
-  }
-  const max = parsePixelSize(candidate.max);
-  return max == null ? null : {
-    kind: 'percent',
-    value: candidate.value,
-    max
-  };
-}
-function parseSize(value) {
-  if (typeof value === 'number') {
-    return Number.isFinite(value) && value >= 0 ? {
-      kind: 'px',
-      value
-    } : null;
-  }
-  if (typeof value === 'string') {
-    return parseSizeString(value);
-  }
-  if (typeof value === 'object' && value != null) {
-    const pixelValue = parsePixelSize(value);
-    return pixelValue == null ? parsePercentSize(value) : {
-      kind: 'px',
-      value: pixelValue
-    };
-  }
-  return null;
-}
-
-/** Whether this parsed value must be recomputed when its basis changes. */
-function dependsOnBasis(parsed) {
-  return parsed?.kind === 'percent';
-}
-
-/** Resolve a parsed size against its basis, then apply its one pixel bound. */
-function toPixels(parsed, basis) {
-  if (parsed.kind === 'px') {
-    return parsed.value;
-  }
-  if (basis == null) {
-    return null;
-  }
-  const percentagePx = Math.round(parsed.value / 100 * basis);
-  if (parsed.min !== undefined) {
-    return Math.max(percentagePx, parsed.min);
-  }
-  if (parsed.max !== undefined) {
-    return Math.min(percentagePx, parsed.max);
-  }
-  return percentagePx;
-}
-function describeUnknown(value) {
-  if (typeof value === 'number' && !Number.isFinite(value)) {
-    return String(value);
-  }
-  try {
-    return JSON.stringify(value) ?? String(value);
-  } catch {
-    return String(value);
-  }
-}
-function describePixelCandidate(value) {
-  if (typeof value !== 'object' || value == null || Array.isArray(value)) {
-    return describeUnknown(value);
-  }
-  const candidate = value;
-  return candidate.type === 'pixel' ? `{"type":"pixel","value":${describeUnknown(candidate.value)}}` : describeUnknown(value);
-}
-function describeSize(value) {
-  if (typeof value === 'object' && value != null && !Array.isArray(value)) {
-    const candidate = value;
-    if (candidate.type === 'pixel') {
-      return describePixelCandidate(value);
-    }
-    if (candidate.type === 'percent') {
-      const fields = ['"type":"percent"', `"value":${describeUnknown(candidate.value)}`];
-      if (candidate.min !== undefined) {
-        fields.push(`"min":${describePixelCandidate(candidate.min)}`);
-      }
-      if (candidate.max !== undefined) {
-        fields.push(`"max":${describePixelCandidate(candidate.max)}`);
-      }
-      return `{${fields.join(',')}}`;
-    }
-  }
-  return describeUnknown(value);
-}
-
-/**
- * Resolves one configured value, applying its role's fallback when the input is
- * not accepted. The warning remains development-only through `devWarn`; every
- * build takes the same deterministic fallback.
- */
-function resolveBound(raw, parsed, basis, fallback, label, accepted, didWarnRef) {
-  if (raw === undefined) {
-    return fallback;
-  }
-  // Preserve the released explicit unbounded maximum. Other roles still
-  // reject non-finite numbers.
-  if (raw === Infinity && fallback === Infinity) {
-    return Infinity;
-  }
-  if (parsed == null) {
-    if (!didWarnRef.current) {
-      didWarnRef.current = true;
-      devWarn('useResizable', `${label}: ${describeSize(raw)} is not a size. ${accepted} ` + `Falling back to ${fallback}.`);
-    }
-    return fallback;
-  }
-  return toPixels(parsed, basis) ?? fallback;
-}
-
-/**
- * The container's content-box size on the active axis.
- *
- * Content box, not border box: a bordered or padded container would otherwise
- * report a basis a few pixels larger than the space a percentage is actually a
- * share of, and that error lands in `aria-valuemax`. The observer entry
- * carries `contentBoxSize` natively, which is already writing-mode aware;
- * measuring the element is the fallback for the synthetic entry
- * `observeResize` fires on registration.
- */
-function measureContentBox(element, direction, entry) {
-  const box = entry?.contentBoxSize?.[0];
-  if (box) {
-    return direction === 'vertical' ? box.blockSize : box.inlineSize;
-  }
-  const style = typeof window === 'undefined' ? null : window.getComputedStyle(element);
-  if (style == null) {
-    return null;
-  }
-  const size = direction === 'vertical' ? element.clientHeight - parseFloat(style.paddingTop) - parseFloat(style.paddingBottom) : element.clientWidth - parseFloat(style.paddingLeft) - parseFloat(style.paddingRight);
-  return Number.isFinite(size) ? size : null;
-}
-
 // =============================================================================
 // Single-region hook
 // =============================================================================

package/dist/SegmentedControl/SegmentedControl.d.ts

@@ -41,7 +41,9 @@ export interface SegmentedControlProps extends Omit<BaseProps<HTMLDivElement>, '
      */
     layout?: SegmentedControlLayout;
     /**
-     * Whether the entire control is disabled.
+     * Whether the entire control is disabled. The selected segment keeps the
+     * control's Tab stop, announced as disabled (`aria-disabled`), and nothing
+     * can be selected.
      * @default false
      */
     isDisabled?: boolean;
@@ -49,11 +51,11 @@ export interface SegmentedControlProps extends Omit<BaseProps<HTMLDivElement>, '
      * Explains why the control is disabled. Applies to the whole-group disabled
      * state (`isDisabled`), not individual segments. When set together with
      * `isDisabled`, the control shows a tooltip with this text on hover and
-     * keyboard focus, and stays focusable (via `aria-disabled`) so the reason is
-     * discoverable by keyboard and assistive technology. Selection stays blocked.
+     * keyboard focus, and the reason describes each segment for assistive
+     * technology. Selection stays blocked.
      *
-     * Use this instead of wrapping a disabled control in `Tooltip` — disabled
-     * controls don't emit the pointer events an external tooltip needs.
+     * Use this instead of wrapping a disabled control in `Tooltip`, so the
+     * reason is attached to the control itself.
      */
     disabledMessage?: string;
     /**

package/dist/SegmentedControl/SegmentedControl.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"SegmentedControl.d.ts","sourceRoot":"","sources":["../../src/SegmentedControl/SegmentedControl.tsx"],"names":[],"mappings":"AAIA;;;;;;;;;;;GAWG;AAEH,OAAO,KAAK,EAAE,EAAuB,KAAK,SAAS,EAAC,MAAM,OAAO,CAAC;AAOlE,OAAO,KAAK,EACV,oBAAoB,EACpB,sBAAsB,EACvB,MAAM,2BAA2B,CAAC;AAInC,OAAO,KAAK,EAAC,SAAS,EAAC,MAAM,cAAc,CAAC;AAI5C,MAAM,WAAW,qBAAsB,SAAQ,IAAI,CACjD,SAAS,CAAC,cAAc,CAAC,EACzB,UAAU,CACX;IACC,GAAG,CAAC,EAAE,KAAK,CAAC,GAAG,CAAC,cAAc,CAAC,CAAC;IAChC;;OAEG;IACH,KAAK,EAAE,MAAM,CAAC;IACd;;OAEG;IACH,QAAQ,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IAClC;;OAEG;IACH,KAAK,EAAE,MAAM,CAAC;IACd;;;OAGG;IACH,IAAI,CAAC,EAAE,oBAAoB,CAAC;IAC5B;;;;;;OAMG;IACH,MAAM,CAAC,EAAE,sBAAsB,CAAC;IAChC;;;OAGG;IACH,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB;;;;;;;;;OASG;IACH,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB;;OAEG;IACH,QAAQ,EAAE,SAAS,CAAC;CACrB;AA8DD;;;;;;;;;;;;GAYG;AACH,wBAAgB,gBAAgB,CAAC,EAC/B,GAAG,EACH,KAAK,EACL,QAAQ,EACR,KAAK,EACL,IAAI,EAAE,QAAQ,EACd,MAAc,EACd,UAAkB,EAClB,eAAe,EACf,QAAQ,EACR,MAAM,EACN,SAAS,EACT,KAAK,EACL,SAAS,EAAE,aAAa,EACxB,OAAO,EAAE,WAAW,EACpB,MAAM,EAAE,UAAU,EAClB,kBAAkB,EAAE,mBAAmB,EACvC,GAAG,IAAI,EACR,EAAE,qBAAqB,qBAyIvB;yBA3Je,gBAAgB"}
+{"version":3,"file":"SegmentedControl.d.ts","sourceRoot":"","sources":["../../src/SegmentedControl/SegmentedControl.tsx"],"names":[],"mappings":"AAIA;;;;;;;;;;;GAWG;AAEH,OAAO,KAAK,EAAE,EAAuB,KAAK,SAAS,EAAC,MAAM,OAAO,CAAC;AAQlE,OAAO,KAAK,EACV,oBAAoB,EACpB,sBAAsB,EACvB,MAAM,2BAA2B,CAAC;AAInC,OAAO,KAAK,EAAC,SAAS,EAAC,MAAM,cAAc,CAAC;AAI5C,MAAM,WAAW,qBAAsB,SAAQ,IAAI,CACjD,SAAS,CAAC,cAAc,CAAC,EACzB,UAAU,CACX;IACC,GAAG,CAAC,EAAE,KAAK,CAAC,GAAG,CAAC,cAAc,CAAC,CAAC;IAChC;;OAEG;IACH,KAAK,EAAE,MAAM,CAAC;IACd;;OAEG;IACH,QAAQ,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IAClC;;OAEG;IACH,KAAK,EAAE,MAAM,CAAC;IACd;;;OAGG;IACH,IAAI,CAAC,EAAE,oBAAoB,CAAC;IAC5B;;;;;;OAMG;IACH,MAAM,CAAC,EAAE,sBAAsB,CAAC;IAChC;;;;;OAKG;IACH,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB;;;;;;;;;OASG;IACH,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB;;OAEG;IACH,QAAQ,EAAE,SAAS,CAAC;CACrB;AA0DD;;;;;;;;;;;;GAYG;AACH,wBAAgB,gBAAgB,CAAC,EAC/B,GAAG,EACH,KAAK,EACL,QAAQ,EACR,KAAK,EACL,IAAI,EAAE,QAAQ,EACd,MAAc,EACd,UAAkB,EAClB,eAAe,EACf,QAAQ,EACR,MAAM,EACN,SAAS,EACT,KAAK,EACL,SAAS,EAAE,aAAa,EACxB,OAAO,EAAE,WAAW,EACpB,MAAM,EAAE,UAAU,EAClB,kBAAkB,EAAE,mBAAmB,EACvC,GAAG,IAAI,EACR,EAAE,qBAAqB,qBAoJvB;yBAtKe,gBAAgB"}