@ttoss/fsl-ui 0.2.4

package/dist/components/RadioGroup/RadioGroup.d.mts

@@ -0,0 +1,82 @@
+
+import { RadioGroupProps, RadioProps } from "react-aria-components";
+import * as React from "react";
+
+//#region src/components/RadioGroup/RadioGroup.d.ts
+/** Formal semantic identity — RadioGroup root (Selection entity, single-choice). */
+declare const radioGroupMeta: {
+  readonly displayName: "RadioGroup";
+  readonly entity: "Selection";
+  readonly structure: "root";
+};
+/** Formal semantic identity — Radio item (Selection entity, selectionControl + label). */
+declare const radioMeta: {
+  readonly displayName: "Radio";
+  readonly entity: "Selection";
+  readonly structure: "selectionControl";
+  readonly composition: "selection";
+};
+/**
+ * Props for the RadioGroup component.
+ */
+interface RadioGroupProps$1 extends Omit<RadioGroupProps, 'style' | 'children'> {
+  /** Group label displayed above the radio options. */
+  label?: React.ReactNode;
+  /** Radio option children — must be `Radio` components. */
+  children?: React.ReactNode;
+}
+/**
+ * A semantic radio group built on React Aria.
+ *
+ * Orchestrates a set of mutually exclusive `Radio` options. Validation
+ * feedback flows from `isInvalid` (or React Aria's `validate` callback) and
+ * surfaces on each Radio via the `invalid` State.
+ *
+ * Entity = Selection, interaction = `select.single`.
+ *
+ * @example
+ * ```tsx
+ * <RadioGroup label="Size" defaultValue="md">
+ *   <Radio value="sm">Small</Radio>
+ *   <Radio value="md">Medium</Radio>
+ *   <Radio value="lg">Large</Radio>
+ * </RadioGroup>
+ * ```
+ */
+declare const RadioGroup$1: {
+  ({
+    label,
+    children,
+    ...props
+  }: RadioGroupProps$1): import("react/jsx-runtime").JSX.Element;
+  displayName: "RadioGroup";
+};
+/**
+ * Props for the Radio component.
+ */
+interface RadioProps$1 extends Omit<RadioProps, 'style' | 'children'> {
+  /** Label content displayed next to the radio indicator. */
+  children?: React.ReactNode;
+}
+/**
+ * A single radio option — must be used inside a `RadioGroup`.
+ *
+ * Renders a circular indicator (`data-part="selectionControl"`) with an
+ * inner dot (`data-part="indicator"`) when selected. Reads the parent
+ * group's `isInvalid` from React Aria's render props and surfaces the
+ * `invalid` State on the control.
+ *
+ * @example
+ * ```tsx
+ * <Radio value="sm">Small</Radio>
+ * ```
+ */
+declare const Radio$1: {
+  ({
+    children,
+    ...props
+  }: RadioProps$1): import("react/jsx-runtime").JSX.Element;
+  displayName: "Radio";
+};
+//#endregion
+export { Radio$1 as Radio, RadioGroup$1 as RadioGroup, RadioGroupProps$1 as RadioGroupProps, RadioProps$1 as RadioProps, radioGroupMeta, radioMeta };

package/dist/components/RadioGroup/RadioGroup.mjs

@@ -0,0 +1,215 @@
+/** Powered by @ttoss/config. https://ttoss.dev/docs/modules/packages/config/ */
+import { focusRingOutline } from "../../tokens/focusRing.mjs";
+import { resolveInteractiveStyle } from "../../tokens/resolveInteractiveStyle.mjs";
+import { vars } from "@ttoss/fsl-theme/vars";
+import { Label, Radio, RadioGroup } from "react-aria-components";
+import { Fragment, jsx, jsxs } from "react/jsx-runtime";
+
+//#region src/components/RadioGroup/RadioGroup.tsx
+/** Formal semantic identity — RadioGroup root (Selection entity, single-choice). */
+var radioGroupMeta = {
+  displayName: "RadioGroup",
+  entity: "Selection",
+  structure: "root"
+};
+/** Formal semantic identity — Radio item (Selection entity, selectionControl + label). */
+var radioMeta = {
+  displayName: "Radio",
+  entity: "Selection",
+  structure: "selectionControl",
+  composition: "selection"
+};
+/**
+* A semantic radio group built on React Aria.
+*
+* Orchestrates a set of mutually exclusive `Radio` options. Validation
+* feedback flows from `isInvalid` (or React Aria's `validate` callback) and
+* surfaces on each Radio via the `invalid` State.
+*
+* Entity = Selection, interaction = `select.single`.
+*
+* @example
+* ```tsx
+* <RadioGroup label="Size" defaultValue="md">
+*   <Radio value="sm">Small</Radio>
+*   <Radio value="md">Medium</Radio>
+*   <Radio value="lg">Large</Radio>
+* </RadioGroup>
+* ```
+*/
+var RadioGroup$1 = ({
+  label,
+  children,
+  ...props
+}) => {
+  const c = vars.colors.input.primary;
+  return /* @__PURE__ */jsxs(RadioGroup, {
+    ...props,
+    "data-scope": "radio-group",
+    "data-part": "root",
+    style: {
+      boxSizing: "border-box",
+      display: "flex",
+      flexDirection: "column",
+      gap: vars.spacing.gap.stack.sm
+    },
+    children: [label && /* @__PURE__ */jsx(Label, {
+      "data-scope": "radio-group",
+      "data-part": "label",
+      style: {
+        ...vars.text.label.md,
+        color: c?.text?.default
+      },
+      children: label
+    }), children]
+  });
+};
+RadioGroup$1.displayName = radioGroupMeta.displayName;
+var RADIO_BOX_STATIC = {
+  boxSizing: "border-box",
+  flexShrink: 0,
+  position: "relative",
+  display: "inline-flex",
+  alignItems: "center",
+  justifyContent: "center",
+  width: "1.125rem",
+  height: "1.125rem",
+  borderRadius: vars.radii.round,
+  borderStyle: vars.border.outline.control.style,
+  transitionProperty: "background-color, border-color, border-width",
+  transitionDuration: vars.motion.feedback.duration,
+  transitionTimingFunction: vars.motion.feedback.easing,
+  outlineOffset: "2px"
+};
+/** Circular radio-indicator style (state-dependent chrome + focus ring). */
+var buildRadioBoxStyle = ({
+  c,
+  isSelected,
+  isInvalid,
+  isDisabled,
+  isHovered,
+  isPressed,
+  isFocusVisible
+}) => {
+  return {
+    ...RADIO_BOX_STATIC,
+    borderWidth: isSelected ? vars.border.outline.selected.width : vars.border.outline.control.width,
+    backgroundColor: resolveInteractiveStyle(c?.background, {
+      isDisabled,
+      isInvalid,
+      isSelected,
+      isHovered,
+      isPressed
+    }),
+    borderColor: resolveInteractiveStyle(c?.border, {
+      isDisabled,
+      isInvalid,
+      isSelected,
+      isFocusVisible
+    }),
+    outline: focusRingOutline(isFocusVisible)
+  };
+};
+/** Label color — invalid dominates disabled dominates default. */
+var resolveRadioLabelColor = ({
+  c,
+  isInvalid,
+  isDisabled
+}) => {
+  const text = c?.text;
+  if (isInvalid) return text?.invalid;
+  if (isDisabled) return text?.disabled;
+  return text?.default;
+};
+/**
+* A single radio option — must be used inside a `RadioGroup`.
+*
+* Renders a circular indicator (`data-part="selectionControl"`) with an
+* inner dot (`data-part="indicator"`) when selected. Reads the parent
+* group's `isInvalid` from React Aria's render props and surfaces the
+* `invalid` State on the control.
+*
+* @example
+* ```tsx
+* <Radio value="sm">Small</Radio>
+* ```
+*/
+var Radio$1 = ({
+  children,
+  ...props
+}) => {
+  const c = vars.colors.input.primary;
+  return /* @__PURE__ */jsx(Radio, {
+    ...props,
+    "data-scope": "radio",
+    "data-part": "root",
+    style: ({
+      isDisabled
+    }) => {
+      return {
+        boxSizing: "border-box",
+        display: "inline-flex",
+        alignItems: "center",
+        gap: vars.spacing.gap.inline.sm,
+        minHeight: vars.sizing.hit.base,
+        cursor: isDisabled ? "not-allowed" : "pointer",
+        opacity: isDisabled ? vars.opacity.disabled : void 0,
+        ...vars.text.label.md,
+        color: isDisabled ? c?.text?.disabled : c?.text?.default
+      };
+    },
+    children: ({
+      isHovered,
+      isPressed,
+      isDisabled,
+      isFocusVisible,
+      isSelected,
+      isInvalid
+    }) => {
+      const text = c?.text;
+      return /* @__PURE__ */jsxs(Fragment, {
+        children: [/* @__PURE__ */jsx("span", {
+          "data-scope": "radio",
+          "data-part": "selectionControl",
+          "aria-hidden": true,
+          style: buildRadioBoxStyle({
+            c,
+            isSelected,
+            isInvalid,
+            isDisabled,
+            isHovered,
+            isPressed,
+            isFocusVisible
+          }),
+          children: isSelected && /* @__PURE__ */jsx("span", {
+            "data-scope": "radio",
+            "data-part": "indicator",
+            "aria-hidden": true,
+            style: {
+              width: "0.4375rem",
+              height: "0.4375rem",
+              borderRadius: vars.radii.round,
+              backgroundColor: text?.checked ?? text?.default,
+              flexShrink: 0
+            }
+          })
+        }), children != null && /* @__PURE__ */jsx("span", {
+          "data-scope": "radio",
+          "data-part": "label",
+          style: {
+            color: resolveRadioLabelColor({
+              c,
+              isInvalid,
+              isDisabled
+            })
+          },
+          children
+        })]
+      });
+    }
+  });
+};
+Radio$1.displayName = radioMeta.displayName;
+
+//#endregion
+export { Radio$1 as Radio, RadioGroup$1 as RadioGroup, radioGroupMeta, radioMeta };

package/dist/components/Select/Select.cjs

@@ -0,0 +1,253 @@
+/** Powered by @ttoss/config. https://ttoss.dev/docs/modules/packages/config/ */
+const require_focusRing = require('../../tokens/focusRing.cjs');
+const require_resolveInteractiveStyle = require('../../tokens/resolveInteractiveStyle.cjs');
+const require_Icon = require('../Icon/Icon.cjs');
+let _ttoss_fsl_theme_vars = require("@ttoss/fsl-theme/vars");
+let react_aria_components = require("react-aria-components");
+let react_jsx_runtime = require("react/jsx-runtime");
+
+//#region src/components/Select/Select.tsx
+var selectMeta = {
+  displayName: "Select",
+  entity: "Selection",
+  structure: "root"
+};
+var selectItemMeta = {
+  displayName: "SelectItem",
+  entity: "Selection",
+  structure: "item",
+  composition: "selection"
+};
+/** Trigger label color — invalid dominates default (Selection has no evaluation). */
+var resolveSelectLabelColor = ({
+  c,
+  isInvalid
+}) => {
+  const text = c?.text;
+  return isInvalid ? text?.invalid : text?.default;
+};
+/** Dropdown popover surface style — Selection-entity chrome. */
+var buildPopoverStyle = c => {
+  return {
+    boxSizing: "border-box",
+    borderRadius: _ttoss_fsl_theme_vars.vars.radii.control,
+    borderWidth: _ttoss_fsl_theme_vars.vars.border.outline.control.width,
+    borderStyle: _ttoss_fsl_theme_vars.vars.border.outline.control.style,
+    borderColor: c?.border?.default,
+    backgroundColor: c?.background?.default,
+    overflow: "hidden"
+  };
+};
+/**
+* A semantic dropdown selection built on React Aria.
+*
+* Composes a trigger `Button`, a floating `Popover`, and a `ListBox`.
+* Use `SelectItem` for each option.
+*
+* Entity = Selection, interaction = `select.single`. Validation feedback is
+* driven by React Aria's `isInvalid` and surfaces on the trigger via the
+* `invalid` token State.
+*
+* @example
+* ```tsx
+* <Select label="Framework" placeholder="Choose a framework">
+*   <SelectItem id="react">React</SelectItem>
+*   <SelectItem id="vue">Vue</SelectItem>
+*   <SelectItem id="angular">Angular</SelectItem>
+* </Select>
+* ```
+*/
+var Select = ({
+  label,
+  placeholder = "Select…",
+  children,
+  ...props
+}) => {
+  const c = _ttoss_fsl_theme_vars.vars.colors.input.primary;
+  return /* @__PURE__ */(0, react_jsx_runtime.jsx)(react_aria_components.Select, {
+    ...props,
+    "data-scope": "select",
+    "data-part": "root",
+    style: {
+      boxSizing: "border-box",
+      display: "inline-flex",
+      flexDirection: "column",
+      gap: _ttoss_fsl_theme_vars.vars.spacing.gap.stack.xs
+    },
+    children: ({
+      isInvalid
+    }) => {
+      return /* @__PURE__ */(0, react_jsx_runtime.jsxs)(react_jsx_runtime.Fragment, {
+        children: [label && /* @__PURE__ */(0, react_jsx_runtime.jsx)(react_aria_components.Label, {
+          "data-scope": "select",
+          "data-part": "label",
+          style: {
+            ..._ttoss_fsl_theme_vars.vars.text.label.md,
+            color: resolveSelectLabelColor({
+              c,
+              isInvalid
+            })
+          },
+          children: label
+        }), /* @__PURE__ */(0, react_jsx_runtime.jsxs)(react_aria_components.Button, {
+          "data-scope": "select",
+          "data-part": "trigger",
+          style: ({
+            isHovered,
+            isPressed,
+            isDisabled,
+            isFocusVisible
+          }) => {
+            return {
+              boxSizing: "border-box",
+              display: "inline-flex",
+              alignItems: "center",
+              justifyContent: "space-between",
+              gap: _ttoss_fsl_theme_vars.vars.spacing.gap.inline.sm,
+              minHeight: _ttoss_fsl_theme_vars.vars.sizing.hit.base,
+              paddingBlock: _ttoss_fsl_theme_vars.vars.spacing.inset.control.md,
+              paddingInline: _ttoss_fsl_theme_vars.vars.spacing.inset.control.md,
+              borderRadius: _ttoss_fsl_theme_vars.vars.radii.control,
+              borderWidth: _ttoss_fsl_theme_vars.vars.border.outline.control.width,
+              borderStyle: _ttoss_fsl_theme_vars.vars.border.outline.control.style,
+              ..._ttoss_fsl_theme_vars.vars.text.label.md,
+              cursor: isDisabled ? "not-allowed" : "pointer",
+              opacity: isDisabled ? _ttoss_fsl_theme_vars.vars.opacity.disabled : void 0,
+              backgroundColor: require_resolveInteractiveStyle.resolveInteractiveStyle(c?.background, {
+                isDisabled,
+                isInvalid,
+                isHovered,
+                isPressed
+              }),
+              borderColor: require_resolveInteractiveStyle.resolveInteractiveStyle(c?.border, {
+                isDisabled,
+                isInvalid,
+                isFocusVisible
+              }),
+              color: require_resolveInteractiveStyle.resolveInteractiveStyle(c?.text, {
+                isDisabled,
+                isInvalid,
+                isHovered,
+                isPressed
+              }) ?? c?.text?.default,
+              transitionProperty: "background-color, border-color, color",
+              transitionDuration: _ttoss_fsl_theme_vars.vars.motion.feedback.duration,
+              transitionTimingFunction: _ttoss_fsl_theme_vars.vars.motion.feedback.easing,
+              outline: require_focusRing.focusRingOutline(isFocusVisible)
+            };
+          },
+          children: [/* @__PURE__ */(0, react_jsx_runtime.jsx)(react_aria_components.SelectValue, {
+            "data-scope": "select",
+            "data-part": "content",
+            style: {
+              flex: 1
+            },
+            children: ({
+              selectedText,
+              isPlaceholder
+            }) => {
+              return /* @__PURE__ */(0, react_jsx_runtime.jsx)("span", {
+                style: {
+                  color: isPlaceholder ? c?.text?.disabled : void 0
+                },
+                children: isPlaceholder ? placeholder : selectedText
+              });
+            }
+          }), /* @__PURE__ */(0, react_jsx_runtime.jsx)("span", {
+            "data-scope": "select",
+            "data-part": "icon",
+            "aria-hidden": true,
+            style: {
+              flexShrink: 0
+            },
+            children: /* @__PURE__ */(0, react_jsx_runtime.jsx)(require_Icon.Icon, {
+              intent: "disclosure.expand"
+            })
+          })]
+        }), /* @__PURE__ */(0, react_jsx_runtime.jsx)(react_aria_components.Popover, {
+          "data-scope": "select",
+          "data-part": "positioner",
+          style: buildPopoverStyle(c),
+          children: /* @__PURE__ */(0, react_jsx_runtime.jsx)(react_aria_components.ListBox, {
+            "data-scope": "select",
+            "data-part": "surface",
+            style: {
+              outline: "none",
+              display: "flex",
+              flexDirection: "column",
+              padding: _ttoss_fsl_theme_vars.vars.spacing.inset.control.md,
+              gap: _ttoss_fsl_theme_vars.vars.spacing.gap.stack.xs
+            },
+            children
+          })
+        })]
+      });
+    }
+  });
+};
+Select.displayName = selectMeta.displayName;
+/**
+* A single option inside a `Select` dropdown.
+*
+* Renders interactive hover/focus/selected states via
+* `vars.colors.input.primary.*`.
+*
+* @example
+* ```tsx
+* <SelectItem id="react">React</SelectItem>
+* ```
+*/
+var SelectItem = ({
+  children,
+  ...props
+}) => {
+  const c = _ttoss_fsl_theme_vars.vars.colors.input.primary;
+  return /* @__PURE__ */(0, react_jsx_runtime.jsx)(react_aria_components.ListBoxItem, {
+    ...props,
+    "data-scope": "select",
+    "data-part": "item",
+    style: ({
+      isHovered,
+      isPressed,
+      isDisabled,
+      isFocusVisible,
+      isSelected
+    }) => {
+      return {
+        boxSizing: "border-box",
+        display: "flex",
+        alignItems: "center",
+        paddingBlock: _ttoss_fsl_theme_vars.vars.spacing.inset.control.md,
+        paddingInline: _ttoss_fsl_theme_vars.vars.spacing.inset.control.md,
+        borderRadius: _ttoss_fsl_theme_vars.vars.radii.control,
+        cursor: isDisabled ? "not-allowed" : "pointer",
+        opacity: isDisabled ? _ttoss_fsl_theme_vars.vars.opacity.disabled : void 0,
+        ..._ttoss_fsl_theme_vars.vars.text.label.md,
+        backgroundColor: require_resolveInteractiveStyle.resolveInteractiveStyle(c?.background, {
+          isDisabled,
+          isSelected,
+          isHovered,
+          isPressed
+        }),
+        color: require_resolveInteractiveStyle.resolveInteractiveStyle(c?.text, {
+          isDisabled,
+          isSelected,
+          isHovered
+        }) ?? c?.text?.default,
+        outline: require_focusRing.focusRingOutline(isFocusVisible),
+        outlineOffset: "2px",
+        transitionProperty: "background-color, color",
+        transitionDuration: _ttoss_fsl_theme_vars.vars.motion.feedback.duration,
+        transitionTimingFunction: _ttoss_fsl_theme_vars.vars.motion.feedback.easing
+      };
+    },
+    children
+  });
+};
+SelectItem.displayName = selectItemMeta.displayName;
+
+//#endregion
+exports.Select = Select;
+exports.SelectItem = SelectItem;
+exports.selectItemMeta = selectItemMeta;
+exports.selectMeta = selectMeta;

package/dist/components/Select/Select.d.cts

@@ -0,0 +1,86 @@
+
+import * as React from "react";
+import { ListBoxItemProps, SelectProps } from "react-aria-components";
+
+//#region src/components/Select/Select.d.ts
+declare const selectMeta: {
+  readonly displayName: "Select";
+  readonly entity: "Selection";
+  readonly structure: "root";
+};
+declare const selectItemMeta: {
+  readonly displayName: "SelectItem";
+  readonly entity: "Selection";
+  readonly structure: "item";
+  readonly composition: "selection";
+};
+/**
+ * Props for the Select component.
+ */
+interface SelectProps$1<T extends object = object> extends Omit<SelectProps<T>, 'style' | 'children'> {
+  /** Label displayed above the trigger button. */
+  label?: React.ReactNode;
+  /**
+   * Placeholder shown in the trigger when no value is selected.
+   *
+   * Ships a documented English fallback (`'Select…'`) — the placeholder is
+   * supplementary hint text, not a flow-critical label (CONTRIBUTING §6 /
+   * ADR-001). Localized hosts should still supply their own copy.
+   * @default 'Select…'
+   */
+  placeholder?: string;
+  /** `SelectItem` children rendered inside the dropdown ListBox. */
+  children?: React.ReactNode;
+}
+/**
+ * A semantic dropdown selection built on React Aria.
+ *
+ * Composes a trigger `Button`, a floating `Popover`, and a `ListBox`.
+ * Use `SelectItem` for each option.
+ *
+ * Entity = Selection, interaction = `select.single`. Validation feedback is
+ * driven by React Aria's `isInvalid` and surfaces on the trigger via the
+ * `invalid` token State.
+ *
+ * @example
+ * ```tsx
+ * <Select label="Framework" placeholder="Choose a framework">
+ *   <SelectItem id="react">React</SelectItem>
+ *   <SelectItem id="vue">Vue</SelectItem>
+ *   <SelectItem id="angular">Angular</SelectItem>
+ * </Select>
+ * ```
+ */
+declare const Select: {
+  <T extends object = object>({
+    label,
+    placeholder,
+    children,
+    ...props
+  }: SelectProps$1<T>): import("react/jsx-runtime").JSX.Element;
+  displayName: "Select";
+};
+/**
+ * Props for the SelectItem component.
+ */
+type SelectItemProps = Omit<ListBoxItemProps, 'style'>;
+/**
+ * A single option inside a `Select` dropdown.
+ *
+ * Renders interactive hover/focus/selected states via
+ * `vars.colors.input.primary.*`.
+ *
+ * @example
+ * ```tsx
+ * <SelectItem id="react">React</SelectItem>
+ * ```
+ */
+declare const SelectItem: {
+  ({
+    children,
+    ...props
+  }: SelectItemProps): import("react/jsx-runtime").JSX.Element;
+  displayName: "SelectItem";
+};
+//#endregion
+export { Select, SelectItem, SelectItemProps, SelectProps$1 as SelectProps, selectItemMeta, selectMeta };