@ttoss/fsl-ui 0.2.4

package/dist/composites/TextField/TextField.mjs

@@ -0,0 +1,191 @@
+/** Powered by @ttoss/config. https://ttoss.dev/docs/modules/packages/config/ */
+import { focusRingOutline } from "../../tokens/focusRing.mjs";
+import { resolveInteractiveStyle } from "../../tokens/resolveInteractiveStyle.mjs";
+import { createPresenceScope } from "../scope.mjs";
+import { vars } from "@ttoss/fsl-theme/vars";
+import { FieldError, Input, Label, Text, TextField } from "react-aria-components";
+import { jsx } from "react/jsx-runtime";
+
+//#region src/composites/TextField/TextField.tsx
+var textFieldScope = createPresenceScope("TextField");
+/** Formal semantic identity — TextField root (Input entity, root part). */
+var textFieldMeta = {
+  displayName: "TextField",
+  entity: "Input",
+  structure: "root"
+};
+/** Formal semantic identity — label slot. */
+var textFieldLabelMeta = {
+  displayName: "TextFieldLabel",
+  entity: "Input",
+  structure: "label",
+  composition: "label"
+};
+/** Formal semantic identity — control slot (the actual input element). */
+var textFieldControlMeta = {
+  displayName: "TextFieldControl",
+  entity: "Input",
+  structure: "control",
+  composition: "control"
+};
+/** Formal semantic identity — description slot (helper text). */
+var textFieldDescriptionMeta = {
+  displayName: "TextFieldDescription",
+  entity: "Input",
+  structure: "description",
+  composition: "description"
+};
+/** Formal semantic identity — status slot (validation message). */
+var textFieldErrorMeta = {
+  displayName: "TextFieldError",
+  entity: "Input",
+  structure: "validationMessage",
+  composition: "status"
+};
+/**
+* A semantic text input composite built on React Aria's `TextField`.
+*
+* Composes four slots: `TextFieldLabel`, `TextFieldControl`,
+* `TextFieldDescription`, and `TextFieldError`. Each sub-part carries its
+* own `ComponentMeta` with a `composition` role per FSL §4.
+*
+* Validation feedback is driven by React Aria's `isInvalid` prop or
+* `validate` callback and surfaces on the control, label, and validation
+* message via the `invalid` token State.
+*
+* @example
+* ```tsx
+* <TextField isRequired>
+*   <TextFieldLabel>Email</TextFieldLabel>
+*   <TextFieldControl type="email" />
+*   <TextFieldDescription>We never share your email.</TextFieldDescription>
+*   <TextFieldError />
+* </TextField>
+* ```
+*/
+var TextField$1 = ({
+  children,
+  ...props
+}) => {
+  return /* @__PURE__ */jsx(TextField, {
+    ...props,
+    "data-scope": "text-field",
+    "data-part": "root",
+    style: {
+      boxSizing: "border-box",
+      display: "flex",
+      flexDirection: "column",
+      gap: vars.spacing.gap.stack.xs
+    },
+    children: values => {
+      return /* @__PURE__ */jsx(textFieldScope.Provider, {
+        children: typeof children === "function" ? children(values) : children
+      });
+    }
+  });
+};
+TextField$1.displayName = textFieldMeta.displayName;
+/** The label slot of a TextField. Wired to React Aria for a11y linkage. */
+var TextFieldLabel = props => {
+  textFieldScope.use(textFieldLabelMeta.displayName);
+  const colors = vars.colors.input.primary;
+  return /* @__PURE__ */jsx(Label, {
+    ...props,
+    "data-scope": "text-field",
+    "data-part": "label",
+    style: {
+      color: colors?.text?.default,
+      ...vars.text.label.md
+    }
+  });
+};
+TextFieldLabel.displayName = textFieldLabelMeta.displayName;
+/**
+* The control slot of a TextField — the actual `<input>` element. Reads
+* `isInvalid` from React Aria's render-props and surfaces the `invalid`
+* State via `vars.colors.input.primary.*`.
+*/
+var TextFieldControl = props => {
+  textFieldScope.use(textFieldControlMeta.displayName);
+  const colors = vars.colors.input.primary;
+  return /* @__PURE__ */jsx(Input, {
+    ...props,
+    "data-scope": "text-field",
+    "data-part": "control",
+    style: ({
+      isHovered,
+      isDisabled,
+      isFocusVisible,
+      isInvalid
+    }) => {
+      return {
+        boxSizing: "border-box",
+        minHeight: vars.sizing.hit.base,
+        paddingBlock: vars.spacing.inset.control.sm,
+        paddingInline: vars.spacing.inset.control.md,
+        borderRadius: vars.radii.control,
+        borderWidth: vars.border.outline.control.width,
+        borderStyle: vars.border.outline.control.style,
+        transitionDuration: vars.motion.feedback.duration,
+        transitionTimingFunction: vars.motion.feedback.easing,
+        transitionProperty: "background-color, border-color, color",
+        backgroundColor: resolveInteractiveStyle(colors?.background, {
+          isHovered,
+          isDisabled,
+          isInvalid
+        }),
+        borderColor: resolveInteractiveStyle(colors?.border, {
+          isDisabled,
+          isInvalid,
+          isFocusVisible
+        }),
+        color: resolveInteractiveStyle(colors?.text, {
+          isHovered,
+          isDisabled,
+          isInvalid
+        }) ?? colors?.text?.default,
+        outline: focusRingOutline(isFocusVisible),
+        ...vars.text.label.md
+      };
+    }
+  });
+};
+TextFieldControl.displayName = textFieldControlMeta.displayName;
+/** Helper/description text linked to the control via React Aria's slot. */
+var TextFieldDescription = props => {
+  textFieldScope.use(textFieldDescriptionMeta.displayName);
+  const colors = vars.colors.input.primary;
+  return /* @__PURE__ */jsx(Text, {
+    slot: "description",
+    ...props,
+    "data-scope": "text-field",
+    "data-part": "description",
+    style: {
+      color: colors?.text?.default,
+      ...vars.text.label.sm
+    }
+  });
+};
+TextFieldDescription.displayName = textFieldDescriptionMeta.displayName;
+/**
+* Validation message — rendered by React Aria only when the field is
+* invalid. Uses the `invalid` State of the canonical `input.primary`
+* subtree (mirroring the control's invalid coloring).
+*/
+var TextFieldError = props => {
+  textFieldScope.use(textFieldErrorMeta.displayName);
+  const colors = vars.colors.input.primary;
+  return /* @__PURE__ */jsx(FieldError, {
+    ...props,
+    "data-scope": "text-field",
+    "data-part": "validationMessage",
+    style: {
+      color: colors?.text?.invalid ?? colors?.text?.default,
+      ...vars.text.label.sm
+    }
+  });
+};
+TextFieldError.displayName = textFieldErrorMeta.displayName;
+
+//#endregion
+export { TextField$1 as TextField, TextFieldControl, TextFieldDescription, TextFieldError, TextFieldLabel, textFieldControlMeta, textFieldDescriptionMeta, textFieldErrorMeta, textFieldLabelMeta, textFieldMeta };

package/dist/composites/Tooltip/Tooltip.cjs

@@ -0,0 +1,79 @@
+/** Powered by @ttoss/config. https://ttoss.dev/docs/modules/packages/config/ */
+const require_escapeHatch = require('../../tokens/escapeHatch.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/composites/Tooltip/Tooltip.tsx
+var TOOLTIP_MAX_WIDTH_DEFAULT = "min(280px, 90vw)";
+var TOOLTIP_OFFSET_DEFAULT = 6;
+/**
+* Wraps a focusable trigger and its `Tooltip`. React Aria shows the tooltip on
+* hover and keyboard focus and manages the delay.
+*/
+var TooltipTrigger = props => {
+  return /* @__PURE__ */(0, react_jsx_runtime.jsx)(react_aria_components.TooltipTrigger, {
+    ...props
+  });
+};
+TooltipTrigger.displayName = "TooltipTrigger";
+/** Formal semantic identity — Tooltip surface (Overlay entity). */
+var tooltipMeta = {
+  displayName: "Tooltip",
+  entity: "Overlay",
+  structure: "root"
+};
+/**
+* A hover/focus tooltip (Overlay entity). Place inside a `TooltipTrigger`
+* after the focusable trigger element.
+*
+* A tooltip must contain **only non-interactive text/content** — it is not a
+* focus target and must never hold buttons, links, or form fields (use a
+* `Popover` for interactive overlays).
+*
+* @example
+* ```tsx
+* <TooltipTrigger>
+*   <Button>Save</Button>
+*   <Tooltip>Saves the current draft</Tooltip>
+* </TooltipTrigger>
+* ```
+*/
+var Tooltip = ({
+  evaluation = "primary",
+  offset = TOOLTIP_OFFSET_DEFAULT,
+  ...props
+}) => {
+  const colors = _ttoss_fsl_theme_vars.vars.colors.informational[evaluation];
+  return /* @__PURE__ */(0, react_jsx_runtime.jsx)(react_aria_components.Tooltip, {
+    ...props,
+    offset,
+    "data-scope": "tooltip",
+    "data-part": "root",
+    "data-evaluation": evaluation,
+    style: {
+      boxSizing: "border-box",
+      maxWidth: require_escapeHatch.fslVar("--fsl-tooltip-max-width", TOOLTIP_MAX_WIDTH_DEFAULT),
+      borderRadius: _ttoss_fsl_theme_vars.vars.radii.surface,
+      borderWidth: _ttoss_fsl_theme_vars.vars.border.outline.surface.width,
+      borderStyle: _ttoss_fsl_theme_vars.vars.border.outline.surface.style,
+      borderColor: colors?.border?.default,
+      backgroundColor: colors?.background?.default,
+      color: colors?.text?.default,
+      boxShadow: _ttoss_fsl_theme_vars.vars.elevation.surface.overlay,
+      paddingBlock: _ttoss_fsl_theme_vars.vars.spacing.inset.surface.sm,
+      paddingInline: _ttoss_fsl_theme_vars.vars.spacing.inset.surface.md,
+      ..._ttoss_fsl_theme_vars.vars.text.label.md,
+      transitionProperty: "opacity",
+      transitionDuration: _ttoss_fsl_theme_vars.vars.motion.transition.enter.duration,
+      transitionTimingFunction: _ttoss_fsl_theme_vars.vars.motion.transition.enter.easing,
+      zIndex: _ttoss_fsl_theme_vars.vars.zIndex.layer.overlay
+    }
+  });
+};
+Tooltip.displayName = tooltipMeta.displayName;
+
+//#endregion
+exports.Tooltip = Tooltip;
+exports.TooltipTrigger = TooltipTrigger;
+exports.tooltipMeta = tooltipMeta;

package/dist/composites/Tooltip/Tooltip.d.cts

@@ -0,0 +1,53 @@
+
+import { EvaluationsFor } from "../../semantics/taxonomy.cjs";
+import { TooltipProps, TooltipTriggerComponentProps } from "react-aria-components";
+
+//#region src/composites/Tooltip/Tooltip.d.ts
+/**
+ * Wraps a focusable trigger and its `Tooltip`. React Aria shows the tooltip on
+ * hover and keyboard focus and manages the delay.
+ */
+declare const TooltipTrigger: {
+  (props: TooltipTriggerComponentProps): import("react/jsx-runtime").JSX.Element;
+  displayName: string;
+};
+/** Formal semantic identity — Tooltip surface (Overlay entity). */
+declare const tooltipMeta: {
+  readonly displayName: "Tooltip";
+  readonly entity: "Overlay";
+  readonly structure: "root";
+};
+/** Props for the Tooltip surface. */
+interface TooltipProps$1 extends Omit<TooltipProps, 'style'> {
+  /**
+   * Semantic emphasis for the tooltip surface.
+   * @default 'primary'
+   */
+  evaluation?: EvaluationsFor<(typeof tooltipMeta)['entity']>;
+}
+/**
+ * A hover/focus tooltip (Overlay entity). Place inside a `TooltipTrigger`
+ * after the focusable trigger element.
+ *
+ * A tooltip must contain **only non-interactive text/content** — it is not a
+ * focus target and must never hold buttons, links, or form fields (use a
+ * `Popover` for interactive overlays).
+ *
+ * @example
+ * ```tsx
+ * <TooltipTrigger>
+ *   <Button>Save</Button>
+ *   <Tooltip>Saves the current draft</Tooltip>
+ * </TooltipTrigger>
+ * ```
+ */
+declare const Tooltip: {
+  ({
+    evaluation,
+    offset,
+    ...props
+  }: TooltipProps$1): import("react/jsx-runtime").JSX.Element;
+  displayName: "Tooltip";
+};
+//#endregion
+export { Tooltip, TooltipProps$1 as TooltipProps, TooltipTrigger, tooltipMeta };

package/dist/composites/Tooltip/Tooltip.d.mts

@@ -0,0 +1,53 @@
+
+import { EvaluationsFor } from "../../semantics/taxonomy.mjs";
+import { TooltipProps, TooltipTriggerComponentProps } from "react-aria-components";
+
+//#region src/composites/Tooltip/Tooltip.d.ts
+/**
+ * Wraps a focusable trigger and its `Tooltip`. React Aria shows the tooltip on
+ * hover and keyboard focus and manages the delay.
+ */
+declare const TooltipTrigger$1: {
+  (props: TooltipTriggerComponentProps): import("react/jsx-runtime").JSX.Element;
+  displayName: string;
+};
+/** Formal semantic identity — Tooltip surface (Overlay entity). */
+declare const tooltipMeta: {
+  readonly displayName: "Tooltip";
+  readonly entity: "Overlay";
+  readonly structure: "root";
+};
+/** Props for the Tooltip surface. */
+interface TooltipProps$1 extends Omit<TooltipProps, 'style'> {
+  /**
+   * Semantic emphasis for the tooltip surface.
+   * @default 'primary'
+   */
+  evaluation?: EvaluationsFor<(typeof tooltipMeta)['entity']>;
+}
+/**
+ * A hover/focus tooltip (Overlay entity). Place inside a `TooltipTrigger`
+ * after the focusable trigger element.
+ *
+ * A tooltip must contain **only non-interactive text/content** — it is not a
+ * focus target and must never hold buttons, links, or form fields (use a
+ * `Popover` for interactive overlays).
+ *
+ * @example
+ * ```tsx
+ * <TooltipTrigger>
+ *   <Button>Save</Button>
+ *   <Tooltip>Saves the current draft</Tooltip>
+ * </TooltipTrigger>
+ * ```
+ */
+declare const Tooltip$1: {
+  ({
+    evaluation,
+    offset,
+    ...props
+  }: TooltipProps$1): import("react/jsx-runtime").JSX.Element;
+  displayName: "Tooltip";
+};
+//#endregion
+export { Tooltip$1 as Tooltip, TooltipProps$1 as TooltipProps, TooltipTrigger$1 as TooltipTrigger, tooltipMeta };

package/dist/composites/Tooltip/Tooltip.mjs

@@ -0,0 +1,77 @@
+/** Powered by @ttoss/config. https://ttoss.dev/docs/modules/packages/config/ */
+import { fslVar } from "../../tokens/escapeHatch.mjs";
+import { vars } from "@ttoss/fsl-theme/vars";
+import { Tooltip, TooltipTrigger } from "react-aria-components";
+import { jsx } from "react/jsx-runtime";
+
+//#region src/composites/Tooltip/Tooltip.tsx
+var TOOLTIP_MAX_WIDTH_DEFAULT = "min(280px, 90vw)";
+var TOOLTIP_OFFSET_DEFAULT = 6;
+/**
+* Wraps a focusable trigger and its `Tooltip`. React Aria shows the tooltip on
+* hover and keyboard focus and manages the delay.
+*/
+var TooltipTrigger$1 = props => {
+  return /* @__PURE__ */jsx(TooltipTrigger, {
+    ...props
+  });
+};
+TooltipTrigger$1.displayName = "TooltipTrigger";
+/** Formal semantic identity — Tooltip surface (Overlay entity). */
+var tooltipMeta = {
+  displayName: "Tooltip",
+  entity: "Overlay",
+  structure: "root"
+};
+/**
+* A hover/focus tooltip (Overlay entity). Place inside a `TooltipTrigger`
+* after the focusable trigger element.
+*
+* A tooltip must contain **only non-interactive text/content** — it is not a
+* focus target and must never hold buttons, links, or form fields (use a
+* `Popover` for interactive overlays).
+*
+* @example
+* ```tsx
+* <TooltipTrigger>
+*   <Button>Save</Button>
+*   <Tooltip>Saves the current draft</Tooltip>
+* </TooltipTrigger>
+* ```
+*/
+var Tooltip$1 = ({
+  evaluation = "primary",
+  offset = TOOLTIP_OFFSET_DEFAULT,
+  ...props
+}) => {
+  const colors = vars.colors.informational[evaluation];
+  return /* @__PURE__ */jsx(Tooltip, {
+    ...props,
+    offset,
+    "data-scope": "tooltip",
+    "data-part": "root",
+    "data-evaluation": evaluation,
+    style: {
+      boxSizing: "border-box",
+      maxWidth: fslVar("--fsl-tooltip-max-width", TOOLTIP_MAX_WIDTH_DEFAULT),
+      borderRadius: vars.radii.surface,
+      borderWidth: vars.border.outline.surface.width,
+      borderStyle: vars.border.outline.surface.style,
+      borderColor: colors?.border?.default,
+      backgroundColor: colors?.background?.default,
+      color: colors?.text?.default,
+      boxShadow: vars.elevation.surface.overlay,
+      paddingBlock: vars.spacing.inset.surface.sm,
+      paddingInline: vars.spacing.inset.surface.md,
+      ...vars.text.label.md,
+      transitionProperty: "opacity",
+      transitionDuration: vars.motion.transition.enter.duration,
+      transitionTimingFunction: vars.motion.transition.enter.easing,
+      zIndex: vars.zIndex.layer.overlay
+    }
+  });
+};
+Tooltip$1.displayName = tooltipMeta.displayName;
+
+//#endregion
+export { Tooltip$1 as Tooltip, TooltipTrigger$1 as TooltipTrigger, tooltipMeta };