@recursica/mui-adapter 0.5.0 → 0.7.0

package/src/components/Modal/Modal.tsx

@@ -1,8 +1,218 @@
-import React from "react";
-import "./Modal.module.css";
+import React, { forwardRef } from "react";
+import {
+  Dialog as MuiDialog,
+  type DialogProps as MuiDialogProps,
+  DialogTitle as MuiDialogTitle,
+  type DialogTitleProps as MuiDialogTitleProps,
+  DialogContent as MuiDialogContent,
+  type DialogContentProps as MuiDialogContentProps,
+  DialogActions as MuiDialogActions,
+  type DialogActionsProps as MuiDialogActionsProps,
+  IconButton as MuiIconButton,
+} from "@mui/material";
+import {
+  filterStylingProps,
+  type RecursicaOverStyled,
+} from "../../utils/filterStylingProps";
+import styles from "./Modal.module.css";
 
-export type ModalProps = React.HTMLAttributes<HTMLDivElement>;
+// ============================================================
+// MODAL ROOT (Dialog)
+// ============================================================
 
-export const Modal: React.FC<ModalProps> = (props) => {
-  return <div {...props}>Modal</div>;
+import { type RecursicaModalProps } from "@recursica/adapter-common";
+
+export type ModalProps = RecursicaOverStyled<
+  Omit<MuiDialogProps, "size" | "radius" | "shadow" | "open"> &
+    RecursicaModalProps
+>;
+
+const CloseIcon = () => (
+  <svg
+    xmlns="http://www.w3.org/2000/svg"
+    width="20"
+    height="20"
+    viewBox="0 0 24 24"
+    fill="none"
+    stroke="currentColor"
+    strokeWidth="2"
+    strokeLinecap="round"
+    strokeLinejoin="round"
+  >
+    <path d="M18 6L6 18M6 6l12 12" />
+  </svg>
+);
+
+const ModalRoot = forwardRef<HTMLDivElement, ModalProps>(function ModalRoot(
+  {
+    overStyled = false,
+    opened = false,
+    withCloseButton = true,
+    title,
+    children,
+    onClose,
+    className,
+    ...rest
+  },
+  ref,
+) {
+  const sanitizedProps = filterStylingProps(rest, overStyled);
+
+  let footer: React.ReactNode = null;
+  const bodyChildren: React.ReactNode[] = [];
+
+  React.Children.forEach(children, (child) => {
+    if (
+      React.isValidElement(child) &&
+      (child.type === ModalFooter ||
+        (child.type as any)?.displayName === "Modal.Footer")
+    ) {
+      footer = child;
+    } else {
+      bodyChildren.push(child);
+    }
+  });
+
+  return (
+    <MuiDialog
+      ref={ref}
+      className={`${styles.root} ${className || ""}`}
+      classes={{
+        paper: styles.inner,
+      }}
+      {...(sanitizedProps as MuiDialogProps)}
+      open={opened || (sanitizedProps as any).open}
+      onClose={onClose}
+    >
+      {(title || withCloseButton) && (
+        <div className={styles.header}>
+          {title && <div className={styles.title}>{title}</div>}
+          {withCloseButton && (
+            <MuiIconButton
+              onClick={(e) => onClose?.(e, "backdropClick")}
+              className={styles.close}
+            >
+              <CloseIcon />
+            </MuiIconButton>
+          )}
+        </div>
+      )}
+      <ModalBody>{bodyChildren}</ModalBody>
+      {footer}
+    </MuiDialog>
+  );
+});
+
+ModalRoot.displayName = "Modal";
+
+// ============================================================
+// MODAL TITLE (DialogTitle)
+// ============================================================
+
+export type ModalTitleProps = RecursicaOverStyled<MuiDialogTitleProps>;
+
+const ModalTitle = forwardRef<HTMLDivElement, ModalTitleProps>(
+  function ModalTitle({ overStyled = false, className, ...rest }, ref) {
+    const sanitizedProps = filterStylingProps(rest, overStyled);
+
+    return (
+      <MuiDialogTitle
+        ref={ref as any}
+        className={`${styles.title} ${className || ""}`}
+        {...(sanitizedProps as MuiDialogTitleProps)}
+      />
+    );
+  },
+);
+
+ModalTitle.displayName = "Modal.Title";
+
+// ============================================================
+// MODAL BODY (DialogContent)
+// ============================================================
+
+export type ModalBodyProps = RecursicaOverStyled<MuiDialogContentProps>;
+
+const ModalBody = forwardRef<HTMLDivElement, ModalBodyProps>(function ModalBody(
+  { overStyled = false, className, children, ...rest },
+  ref,
+) {
+  const sanitizedProps = filterStylingProps(rest, overStyled);
+  const internalRef = React.useRef<HTMLDivElement>(null);
+  const [scrolledTop, setScrolledTop] = React.useState(false);
+  const [scrolledBottom, setScrolledBottom] = React.useState(false);
+
+  const checkScroll = React.useCallback(() => {
+    if (internalRef.current) {
+      const { scrollTop, scrollHeight, clientHeight } = internalRef.current;
+      setScrolledTop(scrollTop > 0);
+      setScrolledBottom(Math.ceil(scrollTop + clientHeight) < scrollHeight);
+    }
+  }, []);
+
+  React.useEffect(() => {
+    checkScroll();
+    window.addEventListener("resize", checkScroll);
+    return () => window.removeEventListener("resize", checkScroll);
+  }, [checkScroll, children]);
+
+  return (
+    <MuiDialogContent
+      ref={(node) => {
+        if (typeof ref === "function") ref(node as any);
+        else if (ref)
+          (ref as React.MutableRefObject<HTMLDivElement | null>).current =
+            node as any;
+        if (internalRef)
+          (
+            internalRef as React.MutableRefObject<HTMLDivElement | null>
+          ).current = node as HTMLDivElement;
+      }}
+      onScroll={() => checkScroll()}
+      data-scrolled-top={scrolledTop || undefined}
+      data-scrolled-bottom={scrolledBottom || undefined}
+      className={`${styles.content} ${styles.scrollArea} ${className || ""}`}
+      {...(sanitizedProps as MuiDialogContentProps)}
+    >
+      {children}
+    </MuiDialogContent>
+  );
+});
+
+ModalBody.displayName = "Modal.Body";
+
+// ============================================================
+// MODAL FOOTER (DialogActions)
+// ============================================================
+
+export type ModalFooterProps = RecursicaOverStyled<MuiDialogActionsProps>;
+
+const ModalFooter = forwardRef<HTMLDivElement, ModalFooterProps>(
+  function ModalFooter({ overStyled = false, className, ...rest }, ref) {
+    const sanitizedProps = filterStylingProps(rest, overStyled);
+
+    return (
+      <MuiDialogActions
+        ref={ref as any}
+        className={`${styles.footer} ${className || ""}`}
+        {...(sanitizedProps as MuiDialogActionsProps)}
+      />
+    );
+  },
+);
+
+ModalFooter.displayName = "Modal.Footer";
+
+// ============================================================
+// EXPORT COMPOSITION
+// ============================================================
+
+export const Modal = ModalRoot as typeof ModalRoot & {
+  Title: typeof ModalTitle;
+  Body: typeof ModalBody;
+  Footer: typeof ModalFooter;
 };
+
+Modal.Title = ModalTitle;
+Modal.Body = ModalBody;
+Modal.Footer = ModalFooter;

package/src/components/NumberInput/NumberInput.module.css

@@ -1,47 +1,281 @@
 /* EXEMPTIONS:
-   This component is a placeholder stub. Once fully implemented, its specific
-   tokens will be fully wired up to direct styles. */
-
-/* recursica-ignore: --recursica_ui-kit_components_number-input_properties_border-radius */
-/* recursica-ignore: --recursica_ui-kit_components_number-input_properties_horizontal-padding */
-/* recursica-ignore: --recursica_ui-kit_components_number-input_properties_icon-size */
-/* recursica-ignore: --recursica_ui-kit_components_number-input_properties_icon-text-gap */
-/* recursica-ignore: --recursica_ui-kit_components_number-input_properties_max-width */
-/* recursica-ignore: --recursica_ui-kit_components_number-input_properties_min-height */
-/* recursica-ignore: --recursica_ui-kit_components_number-input_properties_min-width */
-/* recursica-ignore: --recursica_ui-kit_components_number-input_properties_placeholder-opacity */
-/* recursica-ignore: --recursica_ui-kit_components_number-input_properties_text_font-family */
-/* recursica-ignore: --recursica_ui-kit_components_number-input_properties_text_font-size */
-/* recursica-ignore: --recursica_ui-kit_components_number-input_properties_text_font-style */
-/* recursica-ignore: --recursica_ui-kit_components_number-input_properties_text_font-weight */
-/* recursica-ignore: --recursica_ui-kit_components_number-input_properties_text_letter-spacing */
-/* recursica-ignore: --recursica_ui-kit_components_number-input_properties_text_line-height */
-/* recursica-ignore: --recursica_ui-kit_components_number-input_properties_text_text-decoration */
-/* recursica-ignore: --recursica_ui-kit_components_number-input_properties_text_text-transform */
-/* recursica-ignore: --recursica_ui-kit_components_number-input_properties_vertical-padding */
-/* recursica-ignore: --recursica_ui-kit_components_number-input_variants_layouts_side-by-side_properties_top-bottom-margin */
-/* recursica-ignore: --recursica_ui-kit_components_number-input_variants_layouts_stacked_properties_top-bottom-margin */
+   - state-specific border-size variables are ignored because the input box uses a uniform static boundary to prevent 
+     unexpected layout shifts or flickering when switching between active, focused, or error states. */
 /* recursica-ignore: --recursica_ui-kit_components_number-input_variants_states_default_properties_border-size */
-/* recursica-ignore: --recursica_ui-kit_components_number-input_variants_states_default_properties_colors_background */
-/* recursica-ignore: --recursica_ui-kit_components_number-input_variants_states_default_properties_colors_border-color */
-/* recursica-ignore: --recursica_ui-kit_components_number-input_variants_states_default_properties_colors_leading-icon */
-/* recursica-ignore: --recursica_ui-kit_components_number-input_variants_states_default_properties_colors_text */
-/* recursica-ignore: --recursica_ui-kit_components_number-input_variants_states_default_properties_colors_trailing-icon */
 /* recursica-ignore: --recursica_ui-kit_components_number-input_variants_states_disabled_properties_border-size */
-/* recursica-ignore: --recursica_ui-kit_components_number-input_variants_states_disabled_properties_colors_background */
-/* recursica-ignore: --recursica_ui-kit_components_number-input_variants_states_disabled_properties_colors_border-color */
-/* recursica-ignore: --recursica_ui-kit_components_number-input_variants_states_disabled_properties_colors_leading-icon */
-/* recursica-ignore: --recursica_ui-kit_components_number-input_variants_states_disabled_properties_colors_text */
-/* recursica-ignore: --recursica_ui-kit_components_number-input_variants_states_disabled_properties_colors_trailing-icon */
 /* recursica-ignore: --recursica_ui-kit_components_number-input_variants_states_error_properties_border-size */
-/* recursica-ignore: --recursica_ui-kit_components_number-input_variants_states_error_properties_colors_background */
-/* recursica-ignore: --recursica_ui-kit_components_number-input_variants_states_error_properties_colors_border-color */
-/* recursica-ignore: --recursica_ui-kit_components_number-input_variants_states_error_properties_colors_leading-icon */
-/* recursica-ignore: --recursica_ui-kit_components_number-input_variants_states_error_properties_colors_text */
-/* recursica-ignore: --recursica_ui-kit_components_number-input_variants_states_error_properties_colors_trailing-icon */
 /* recursica-ignore: --recursica_ui-kit_components_number-input_variants_states_focus_properties_border-size */
-/* recursica-ignore: --recursica_ui-kit_components_number-input_variants_states_focus_properties_colors_background */
-/* recursica-ignore: --recursica_ui-kit_components_number-input_variants_states_focus_properties_colors_border-color */
-/* recursica-ignore: --recursica_ui-kit_components_number-input_variants_states_focus_properties_colors_leading-icon */
-/* recursica-ignore: --recursica_ui-kit_components_number-input_variants_states_focus_properties_colors_text */
-/* recursica-ignore: --recursica_ui-kit_components_number-input_variants_states_focus_properties_colors_trailing-icon */
+
+/* LAYOUT SPACING OVERRIDES:
+   - Sets the --form-control-margin-bottom spacing hook to map component-specific layout tokens. */
+.layoutOverride {
+  --form-control-margin-bottom: var(
+    --recursica_ui-kit_components_number-input_variants_layouts_stacked_properties_top-bottom-margin
+  );
+}
+
+.layoutOverride[data-form-layout="side-by-side"] {
+  --form-control-margin-bottom: var(
+    --recursica_ui-kit_components_number-input_variants_layouts_side-by-side_properties_top-bottom-margin
+  );
+}
+
+/* HARDCODED VALUES:
+   - border-width: 1px. Native geometric boundary for the input box.
+   - border-style: solid. Native structural rendering rule.
+   - outline: none. Bypassing browser focus rings to rely strictly on Recursica focus states natively.
+   - flex/layout: display: flex on the root wrapper safely encapsulating internal section rendering.
+   - Controls: Hardcoded to bypass Mantine's default borders and backgrounds on the increment/decrement arrows.
+*/
+
+.root {
+  display: flex;
+  position: relative;
+  width: 100%;
+  min-height: var(
+    --recursica_ui-kit_components_number-input_properties_min-height
+  );
+
+  /* Override Mantine native Input variables governing section spacing padding mathematics safely */
+  --input-left-section-size: calc(
+    var(
+        --recursica_ui-kit_components_number-input_properties_horizontal-padding
+      ) +
+      var(--recursica_ui-kit_components_number-input_properties_icon-size) +
+      var(--recursica_ui-kit_components_number-input_properties_icon-text-gap)
+  );
+  --input-right-section-size: calc(
+    var(
+        --recursica_ui-kit_components_number-input_properties_horizontal-padding
+      ) +
+      var(--recursica_ui-kit_components_number-input_properties_icon-size) +
+      var(--recursica_ui-kit_components_number-input_properties_icon-text-gap)
+  );
+}
+
+.input {
+  /* Structural Overrides */
+  width: 100%;
+  box-sizing: border-box;
+  margin: 0;
+
+  /* Box Geometry */
+  min-height: var(
+    --recursica_ui-kit_components_number-input_properties_min-height
+  );
+  padding-top: var(
+    --recursica_ui-kit_components_number-input_properties_vertical-padding
+  );
+  padding-bottom: var(
+    --recursica_ui-kit_components_number-input_properties_vertical-padding
+  );
+  padding-left: var(
+    --recursica_ui-kit_components_number-input_properties_horizontal-padding
+  );
+  padding-right: var(
+    --recursica_ui-kit_components_number-input_properties_horizontal-padding
+  );
+  border-radius: var(
+    --recursica_ui-kit_components_number-input_properties_border-radius
+  );
+  border-width: 1px;
+  border-style: solid;
+
+  /* Strict Typography Unification */
+  font-family: var(
+    --recursica_ui-kit_components_number-input_properties_text_font-family
+  );
+  font-size: var(
+    --recursica_ui-kit_components_number-input_properties_text_font-size
+  );
+  font-style: var(
+    --recursica_ui-kit_components_number-input_properties_text_font-style
+  );
+  font-weight: var(
+    --recursica_ui-kit_components_number-input_properties_text_font-weight
+  );
+  letter-spacing: var(
+    --recursica_ui-kit_components_number-input_properties_text_letter-spacing
+  );
+  line-height: var(
+    --recursica_ui-kit_components_number-input_properties_text_line-height
+  );
+  text-decoration: var(
+    --recursica_ui-kit_components_number-input_properties_text_text-decoration
+  );
+  text-transform: var(
+    --recursica_ui-kit_components_number-input_properties_text_text-transform
+  );
+
+  /* Base State Default Execution */
+  background-color: var(
+    --recursica_ui-kit_components_number-input_variants_states_default_properties_colors_background
+  );
+  border-color: var(
+    --recursica_ui-kit_components_number-input_variants_states_default_properties_colors_border-color
+  );
+  color: var(
+    --recursica_ui-kit_components_number-input_variants_states_default_properties_colors_text
+  );
+
+  outline: none;
+}
+
+.input::placeholder {
+  opacity: var(
+    --recursica_ui-kit_components_number-input_properties_placeholder-opacity
+  );
+  color: inherit;
+}
+
+/* Dynamic Padding Overrides */
+.root[data-with-left-section] .input {
+  padding-left: var(--input-left-section-size);
+}
+
+.root[data-with-right-section] .input {
+  padding-right: var(--input-right-section-size);
+}
+
+/* Flexible End-Caps (Icons, actions) */
+.section {
+  display: flex;
+  align-items: center;
+  height: 100%;
+}
+
+.section[data-position="left"] {
+  justify-content: flex-start;
+  padding-left: var(
+    --recursica_ui-kit_components_number-input_properties_horizontal-padding
+  );
+}
+
+.section[data-position="right"] {
+  justify-content: flex-end;
+  padding-right: var(
+    --recursica_ui-kit_components_number-input_properties_horizontal-padding
+  );
+}
+
+.section :global(svg) {
+  width: var(--recursica_ui-kit_components_number-input_properties_icon-size);
+  height: var(--recursica_ui-kit_components_number-input_properties_icon-size);
+  color: var(
+    --recursica_ui-kit_components_number-input_variants_states_default_properties_colors_leading-icon
+  );
+}
+
+.section[data-position="right"] :global(svg) {
+  color: var(
+    --recursica_ui-kit_components_number-input_variants_states_default_properties_colors_trailing-icon
+  );
+}
+
+/* -------------------------------------
+   CONTROLS (Mantine Specific Up/Down Arrows)
+-------------------------------------- */
+
+.controls {
+  /* Adjust right padding so controls do not overlap borders */
+  padding-right: var(
+    --recursica_ui-kit_components_number-input_properties_horizontal-padding
+  );
+}
+
+.control {
+  /* Override Mantine borders for the inner controls */
+  border: none;
+  background: transparent;
+  color: var(
+    --recursica_ui-kit_components_number-input_variants_states_default_properties_colors_trailing-icon
+  );
+}
+
+.control:hover {
+  background: transparent;
+}
+
+/* -------------------------------------
+   STATE CASCADE ARCHITECTURE
+-------------------------------------- */
+
+/* Focus State Mapping (Triggered internally via browser pseudo-pseudo-class) */
+.input:focus-within,
+.input:focus {
+  border-color: var(
+    --recursica_ui-kit_components_number-input_variants_states_focus_properties_colors_border-color
+  );
+  background-color: var(
+    --recursica_ui-kit_components_number-input_variants_states_focus_properties_colors_background
+  );
+  color: var(
+    --recursica_ui-kit_components_number-input_variants_states_focus_properties_colors_text
+  );
+}
+
+.root:focus-within .section[data-position="left"] :global(svg) {
+  color: var(
+    --recursica_ui-kit_components_number-input_variants_states_focus_properties_colors_leading-icon
+  );
+}
+
+.root:focus-within .section[data-position="right"] :global(svg),
+.root:focus-within .control {
+  color: var(
+    --recursica_ui-kit_components_number-input_variants_states_focus_properties_colors_trailing-icon
+  );
+}
+
+/* Error State Mapping (Propagated strictly down from the wrapper DOM context) */
+.root[data-error] .input {
+  border-color: var(
+    --recursica_ui-kit_components_number-input_variants_states_error_properties_colors_border-color
+  ) !important;
+  background-color: var(
+    --recursica_ui-kit_components_number-input_variants_states_error_properties_colors_background
+  ) !important;
+  color: var(
+    --recursica_ui-kit_components_number-input_variants_states_error_properties_colors_text
+  ) !important;
+}
+
+.root[data-error] .section[data-position="left"] :global(svg) {
+  color: var(
+    --recursica_ui-kit_components_number-input_variants_states_error_properties_colors_leading-icon
+  ) !important;
+}
+
+.root[data-error] .section[data-position="right"] :global(svg),
+.root[data-error] .control {
+  color: var(
+    --recursica_ui-kit_components_number-input_variants_states_error_properties_colors_trailing-icon
+  ) !important;
+}
+
+/* Disabled State Mapping (Propagated strictly down from the wrapper DOM context) */
+.root[data-disabled] .input {
+  border-color: var(
+    --recursica_ui-kit_components_number-input_variants_states_disabled_properties_colors_border-color
+  ) !important;
+  background-color: var(
+    --recursica_ui-kit_components_number-input_variants_states_disabled_properties_colors_background
+  ) !important;
+  color: var(
+    --recursica_ui-kit_components_number-input_variants_states_disabled_properties_colors_text
+  ) !important;
+  cursor: not-allowed;
+}
+
+.root[data-disabled] .section[data-position="left"] :global(svg) {
+  color: var(
+    --recursica_ui-kit_components_number-input_variants_states_disabled_properties_colors_leading-icon
+  ) !important;
+}
+
+.root[data-disabled] .section[data-position="right"] :global(svg),
+.root[data-disabled] .control {
+  color: var(
+    --recursica_ui-kit_components_number-input_variants_states_disabled_properties_colors_trailing-icon
+  ) !important;
+}

package/src/components/NumberInput/NumberInput.stories.tsx

@@ -1,35 +1,98 @@
 import type { Meta, StoryObj } from "@storybook/react";
 import { NumberInput } from "./NumberInput";
-import { ComingSoon } from "@recursica/storybook-template";
 
 const meta: Meta<typeof NumberInput> = {
-  title: "UI-Kit/🚧 NumberInput",
+  title: "UI-Kit/NumberInput",
   component: NumberInput,
   tags: ["autodocs"],
-  parameters: {
-    controls: {
-      include: [
-        "layer",
-        "withLayer",
-        "children",
-        "component",
-        "variant",
-        "size",
-        "icon",
-        "disabled",
-        "href",
-        "onClick",
-        "onChange",
-        "value",
-        "checked",
-      ],
+  argTypes: {
+    label: { control: "text" },
+    assistiveText: { control: "text" },
+    disabled: { control: "boolean" },
+    error: { control: "boolean" },
+    readOnly: { control: "boolean" },
+    required: { control: "boolean" },
+    hideControls: { control: "boolean" },
+    formLayout: {
+      control: "select",
+      options: ["stacked", "side-by-side"],
     },
+    labelSize: {
+      control: "select",
+      options: ["small", "default", "large"],
+    },
+    checked: { table: { disable: true } },
+    defaultChecked: { table: { disable: true } },
+    assistiveWithIcon: { table: { disable: true } },
+    labelOptionalText: { table: { disable: true } },
+    labelWithEditIcon: { table: { disable: true } },
+    onLabelEditClick: { table: { disable: true } },
+    emptyValueComponent: { table: { disable: true } },
   },
 };
 
 export default meta;
+
 type Story = StoryObj<typeof NumberInput>;
 
 export const Default: Story = {
-  render: () => <ComingSoon componentName="NumberInput" />,
+  args: {
+    label: "Amount",
+    placeholder: "Enter an amount",
+    assistiveText: "Must be greater than 0",
+    defaultValue: 10,
+    min: 0,
+    max: 100,
+  },
+};
+
+export const SideBySideLayout: Story = {
+  args: {
+    ...Default.args,
+    formLayout: "side-by-side",
+  },
+};
+
+export const States: Story = {
+  render: () => (
+    <div
+      style={{
+        display: "flex",
+        flexDirection: "column",
+        gap: "1rem",
+        maxWidth: 400,
+      }}
+    >
+      <NumberInput label="Default" placeholder="Enter a number" />
+      <NumberInput label="Disabled" placeholder="Disabled input" disabled />
+      <NumberInput label="Error" placeholder="Error state" error />
+      <NumberInput label="Read Only" value={42} readOnly />
+      <NumberInput label="Required" required />
+    </div>
+  ),
+};
+
+export const WithLeftIcon: Story = {
+  args: {
+    label: "Price",
+    placeholder: "0.00",
+    leftSection: <span>$</span>,
+  },
+};
+
+export const WithRightIcon: Story = {
+  args: {
+    label: "Percentage",
+    placeholder: "0",
+    rightSection: <span>%</span>,
+    hideControls: true, // Typically hiding controls if rightSection is occupied
+  },
+};
+
+export const HiddenControls: Story = {
+  args: {
+    label: "Zip Code",
+    placeholder: "Enter zip code",
+    hideControls: true,
+  },
 };