@recursica/mui-adapter 0.5.0 → 0.7.0

package/src/components/Container/Container.stories.tsx

@@ -1,35 +1,118 @@
+import React from "react";
 import type { Meta, StoryObj } from "@storybook/react";
 import { Container } from "./Container";
-import { ComingSoon } from "@recursica/storybook-template";
+import { Text } from "../Text/Text";
 
-const meta: Meta<typeof Container> = {
-  title: "UI-Kit/🚧 Container",
+type ContainerStoryProps = React.ComponentProps<typeof Container>;
+
+const meta: Meta<ContainerStoryProps> = {
+  title: "UI-Kit/Container",
   component: Container,
   tags: ["autodocs"],
   parameters: {
-    controls: {
-      include: [
-        "layer",
-        "withLayer",
-        "children",
-        "component",
-        "variant",
-        "size",
-        "icon",
-        "disabled",
-        "href",
-        "onClick",
-        "onChange",
-        "value",
-        "checked",
+    docs: {
+      description: {
+        component:
+          "Container is a generic layout wrapper that safely maps to Mantine's Container, standardizing maximum content widths across the application.",
+      },
+    },
+  },
+  args: {
+    size: "md",
+    fluid: false,
+  },
+  argTypes: {
+    size: {
+      control: "select",
+      options: [
+        "xs",
+        "sm",
+        "md",
+        "lg",
+        "xl",
+        "rec-sm",
+        "rec-default",
+        "rec-md",
+        "rec-lg",
+        "rec-xl",
+        "rec-2xl",
       ],
+      description:
+        "Maximum width defined by Mantine system sizes or Recursica sizes",
+    },
+    fluid: {
+      control: "boolean",
+      description: "If true, overrides size and sets max-width to 100%",
+    },
+    defaultChecked: {
+      table: { disable: true },
     },
   },
 };
 
 export default meta;
-type Story = StoryObj<typeof Container>;
+
+type Story = StoryObj<ContainerStoryProps>;
 
 export const Default: Story = {
-  render: () => <ComingSoon componentName="Container" />,
+  // eslint-disable-next-line @typescript-eslint/no-unused-vars, @typescript-eslint/no-explicit-any
+  render: ({ withLayer, layer, ...args }: any) => (
+    <div style={{ backgroundColor: "#f0f0f0", padding: "16px" }}>
+      <Container
+        {...args}
+        style={{
+          backgroundColor: "white",
+          padding: "16px",
+          border: "1px solid #ccc",
+        }}
+      >
+        <Text>
+          This is a Container holding centered content. The background and
+          border are added just to demonstrate the layout bounds visually.
+        </Text>
+      </Container>
+    </div>
+  ),
+};
+
+export const SmallContainer: Story = {
+  args: {
+    size: "sm",
+  },
+  // eslint-disable-next-line @typescript-eslint/no-unused-vars, @typescript-eslint/no-explicit-any
+  render: ({ withLayer, layer, ...args }: any) => (
+    <div style={{ backgroundColor: "#f0f0f0", padding: "16px" }}>
+      <Container
+        {...args}
+        style={{
+          backgroundColor: "white",
+          padding: "16px",
+          border: "1px solid #ccc",
+        }}
+      >
+        <Text>Small Container Layout</Text>
+      </Container>
+    </div>
+  ),
+};
+
+export const FluidContainer: Story = {
+  args: {
+    fluid: true,
+  },
+  // eslint-disable-next-line @typescript-eslint/no-unused-vars, @typescript-eslint/no-explicit-any
+  render: ({ withLayer, layer, ...args }: any) => (
+    <div style={{ backgroundColor: "#f0f0f0", padding: "16px" }}>
+      <Container
+        {...args}
+        style={{
+          backgroundColor: "white",
+          padding: "16px",
+          border: "1px solid #ccc",
+        }}
+      >
+        <Text>Fluid Container Layout</Text>
+      </Container>
+    </div>
+  ),
 };

package/src/components/Container/Container.tsx

@@ -11,20 +11,8 @@ import {
   Container as MUIContainer,
   type ContainerProps as MUIContainerProps,
 } from "@mui/material";
-import { type RecursicaSpacing } from "../../utils/filterStylingProps";
 
-export interface RecursicaContainerProps {
-  children?: React.ReactNode;
-  size?:
-    | "xs"
-    | "sm"
-    | "md"
-    | "lg"
-    | "xl"
-    | RecursicaSpacing
-    | (string & {})
-    | number;
-}
+import { type RecursicaContainerProps } from "@recursica/adapter-common";
 
 export type ContainerProps = Omit<MUIContainerProps, "maxWidth"> &
   RecursicaContainerProps;

package/src/components/DatePicker/DatePicker.stories.tsx

@@ -1,35 +1,141 @@
+import React from "react";
 import type { Meta, StoryObj } from "@storybook/react";
 import { DatePicker } from "./DatePicker";
-import { ComingSoon } from "@recursica/storybook-template";
+import { formControlArgTypes } from "../../../.storybook/commonArgTypes";
 
 const meta: Meta<typeof DatePicker> = {
-  title: "UI-Kit/🚧 DatePicker",
+  title: "UI-Kit/DatePicker",
   component: DatePicker,
   tags: ["autodocs"],
   parameters: {
-    controls: {
-      include: [
-        "layer",
-        "withLayer",
-        "children",
-        "component",
-        "variant",
-        "size",
-        "icon",
-        "disabled",
-        "href",
-        "onClick",
-        "onChange",
-        "value",
-        "checked",
-      ],
+    docs: {
+      description: {
+        component: `
+The \`DatePicker\` primitive provides a unified calendar date selection input integrated directly into the \`FormControlWrapper\` architecture.
+
+### Architectural Decoupling
+Recursica overrides the internal Mantine \`DatePickerInput\` wrapper defaults, safely injecting the date picker into our rigid structural layout systems. State modifiers (e.g. Focus, Errors, ReadOnly) hook seamlessly back onto our native CSS mapping architecture.
+
+### Examples
+Always structure horizontal architectures via the generic \`formLayout\` parameter.
+\`\`\`tsx
+<DatePicker 
+  label="Start Date" 
+  assistiveText="Select the deployment kick-off date." 
+  formLayout="stacked" 
+/>
+\`\`\`
+`,
+      },
+    },
+  },
+  argTypes: {
+    ...formControlArgTypes,
+    disabled: {
+      control: "boolean",
+      description:
+        "Maps the formal disabled variable states structurally to the input core.",
+    },
+    error: {
+      control: "text",
+      description:
+        "Applies the strict error string boundary rendering invalid structures seamlessly.",
+    },
+    required: {
+      control: "boolean",
+    },
+    label: {
+      control: "text",
+    },
+    assistiveText: {
+      control: "text",
+    },
+    readOnly: {
+      control: "boolean",
+      description:
+        "Toggles structural read-only data presentation explicitly blocking standard component bindings.",
     },
   },
 };
 
 export default meta;
+
 type Story = StoryObj<typeof DatePicker>;
 
 export const Default: Story = {
-  render: () => <ComingSoon componentName="DatePicker" />,
+  args: {
+    disabled: false,
+    label: "Project Deadline",
+    placeholder: "Select a deadline...",
+    assistiveText: "Specify the absolute cutoff for code submission.",
+  },
+};
+
+export const FormsSideBySide: Story = {
+  args: {
+    label: "Incident Start Date",
+    placeholder: "Pick date...",
+    assistiveText: "When did the incident originally occur?",
+    formLayout: "side-by-side",
+  },
+};
+
+export const WithLeadingIcon: Story = {
+  args: {
+    label: "Launch Date",
+    placeholder: "Select launch date...",
+    leftSection: (
+      <svg
+        width="24"
+        height="24"
+        viewBox="0 0 24 24"
+        fill="none"
+        stroke="currentColor"
+        strokeWidth="2"
+        strokeLinecap="round"
+        strokeLinejoin="round"
+      >
+        <rect x="3" y="4" width="18" height="18" rx="2" ry="2"></rect>
+        <line x1="16" y1="2" x2="16" y2="6"></line>
+        <line x1="8" y1="2" x2="8" y2="6"></line>
+        <line x1="3" y1="10" x2="21" y2="10"></line>
+      </svg>
+    ),
+  },
+};
+
+export const Disabled: Story = {
+  args: {
+    label: "Disabled Date Range",
+    placeholder: "Disabled selection...",
+    disabled: true,
+  },
+};
+
+export const ErrorState: Story = {
+  args: {
+    label: "Execution Date",
+    placeholder: "Pick a valid date...",
+    error: "The chosen date conflicts with an existing deployment freeze.",
+    required: true,
+  },
+};
+
+export const StaticReadOnly: Story = {
+  args: {
+    label: "Static ReadOnly Review",
+    placeholder: "Ignored...",
+    value: new Date("2026-05-21"),
+    readOnly: true,
+  },
+};
+
+export const EditableReadOnly: Story = {
+  args: {
+    label: "Editable ReadOnly Review",
+    placeholder: "Ignored until active...",
+    defaultValue: new Date("2026-06-01"),
+    readOnly: true,
+    labelWithEditIcon: true,
+  },
 };

package/src/components/DatePicker/DatePicker.tsx

@@ -1,7 +1,9 @@
 import React from "react";
 import "./DatePicker.module.css";
+import { type RecursicaDatePickerProps } from "@recursica/adapter-common";
 
-export type DatePickerProps = React.HTMLAttributes<HTMLDivElement>;
+export type DatePickerProps = React.HTMLAttributes<HTMLDivElement> &
+  RecursicaDatePickerProps;
 
 export const DatePicker: React.FC<DatePickerProps> = (props) => {
   return <div {...props}>DatePicker</div>;

package/src/components/Dropdown/Dropdown.module.css

@@ -1,46 +1,296 @@
 /* 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_dropdown_properties_border-radius */
-/* recursica-ignore: --recursica_ui-kit_components_dropdown_properties_horizontal-padding */
-/* recursica-ignore: --recursica_ui-kit_components_dropdown_properties_icon-size */
-/* recursica-ignore: --recursica_ui-kit_components_dropdown_properties_icon-text-gap */
-/* recursica-ignore: --recursica_ui-kit_components_dropdown_properties_max-width */
-/* recursica-ignore: --recursica_ui-kit_components_dropdown_properties_min-height */
-/* recursica-ignore: --recursica_ui-kit_components_dropdown_properties_min-width */
-/* recursica-ignore: --recursica_ui-kit_components_dropdown_properties_text_font-family */
-/* recursica-ignore: --recursica_ui-kit_components_dropdown_properties_text_font-size */
-/* recursica-ignore: --recursica_ui-kit_components_dropdown_properties_text_font-style */
-/* recursica-ignore: --recursica_ui-kit_components_dropdown_properties_text_font-weight */
-/* recursica-ignore: --recursica_ui-kit_components_dropdown_properties_text_letter-spacing */
-/* recursica-ignore: --recursica_ui-kit_components_dropdown_properties_text_line-height */
-/* recursica-ignore: --recursica_ui-kit_components_dropdown_properties_text_text-decoration */
-/* recursica-ignore: --recursica_ui-kit_components_dropdown_properties_text_text-transform */
-/* recursica-ignore: --recursica_ui-kit_components_dropdown_properties_vertical-padding */
-/* recursica-ignore: --recursica_ui-kit_components_dropdown_variants_layouts_side-by-side_properties_top-bottom-margin */
-/* recursica-ignore: --recursica_ui-kit_components_dropdown_variants_layouts_stacked_properties_top-bottom-margin */
+   - state-specific border-size variables are ignored because a uniform 1px border is applied globally to prevent 
+     unexpected layout shift or flickering during focus, disabled, or error state transitions. */
 /* recursica-ignore: --recursica_ui-kit_components_dropdown_variants_states_default_properties_border-size */
-/* recursica-ignore: --recursica_ui-kit_components_dropdown_variants_states_default_properties_colors_background */
-/* recursica-ignore: --recursica_ui-kit_components_dropdown_variants_states_default_properties_colors_border-color */
-/* recursica-ignore: --recursica_ui-kit_components_dropdown_variants_states_default_properties_colors_leading-icon */
-/* recursica-ignore: --recursica_ui-kit_components_dropdown_variants_states_default_properties_colors_text */
-/* recursica-ignore: --recursica_ui-kit_components_dropdown_variants_states_default_properties_colors_trailing-icon */
 /* recursica-ignore: --recursica_ui-kit_components_dropdown_variants_states_disabled_properties_border-size */
-/* recursica-ignore: --recursica_ui-kit_components_dropdown_variants_states_disabled_properties_colors_background */
-/* recursica-ignore: --recursica_ui-kit_components_dropdown_variants_states_disabled_properties_colors_border-color */
-/* recursica-ignore: --recursica_ui-kit_components_dropdown_variants_states_disabled_properties_colors_leading-icon */
-/* recursica-ignore: --recursica_ui-kit_components_dropdown_variants_states_disabled_properties_colors_text */
-/* recursica-ignore: --recursica_ui-kit_components_dropdown_variants_states_disabled_properties_colors_trailing-icon */
 /* recursica-ignore: --recursica_ui-kit_components_dropdown_variants_states_error_properties_border-size */
-/* recursica-ignore: --recursica_ui-kit_components_dropdown_variants_states_error_properties_colors_background */
-/* recursica-ignore: --recursica_ui-kit_components_dropdown_variants_states_error_properties_colors_border-color */
-/* recursica-ignore: --recursica_ui-kit_components_dropdown_variants_states_error_properties_colors_leading-icon */
-/* recursica-ignore: --recursica_ui-kit_components_dropdown_variants_states_error_properties_colors_text */
-/* recursica-ignore: --recursica_ui-kit_components_dropdown_variants_states_error_properties_colors_trailing-icon */
 /* recursica-ignore: --recursica_ui-kit_components_dropdown_variants_states_focus_properties_border-size */
-/* recursica-ignore: --recursica_ui-kit_components_dropdown_variants_states_focus_properties_colors_background */
-/* recursica-ignore: --recursica_ui-kit_components_dropdown_variants_states_focus_properties_colors_border-color */
-/* recursica-ignore: --recursica_ui-kit_components_dropdown_variants_states_focus_properties_colors_leading-icon */
-/* recursica-ignore: --recursica_ui-kit_components_dropdown_variants_states_focus_properties_colors_text */
-/* recursica-ignore: --recursica_ui-kit_components_dropdown_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_dropdown_variants_layouts_stacked_properties_top-bottom-margin
+  );
+}
+
+.layoutOverride[data-form-layout="side-by-side"] {
+  --form-control-margin-bottom: var(
+    --recursica_ui-kit_components_dropdown_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.
+   - placeholder opacity: 0.5. The dropdown parameters currently lack a dedicated placeholder-opacity variable.
+*/
+
+.root {
+  display: flex;
+  position: relative;
+  width: 100%;
+  min-height: var(--recursica_ui-kit_components_dropdown_properties_min-height);
+
+  /* Override Mantine native Input variables governing section spacing padding mathematics safely */
+  --input-left-section-size: calc(
+    var(--recursica_ui-kit_components_dropdown_properties_horizontal-padding) +
+      var(--recursica_ui-kit_components_dropdown_properties_icon-size) +
+      var(--recursica_ui-kit_components_dropdown_properties_icon-text-gap)
+  );
+  --input-right-section-size: calc(
+    var(--recursica_ui-kit_components_dropdown_properties_horizontal-padding) +
+      var(--recursica_ui-kit_components_dropdown_properties_icon-size) +
+      var(--recursica_ui-kit_components_dropdown_properties_icon-text-gap)
+  );
+}
+
+.input {
+  /* Structural Overrides */
+  width: 100%;
+  box-sizing: border-box;
+  margin: 0;
+
+  /* Box Geometry */
+  min-height: var(--recursica_ui-kit_components_dropdown_properties_min-height);
+  padding-top: var(
+    --recursica_ui-kit_components_dropdown_properties_vertical-padding
+  );
+  padding-bottom: var(
+    --recursica_ui-kit_components_dropdown_properties_vertical-padding
+  );
+  padding-left: var(
+    --recursica_ui-kit_components_dropdown_properties_horizontal-padding
+  );
+  padding-right: var(
+    --recursica_ui-kit_components_dropdown_properties_horizontal-padding
+  );
+  border-radius: var(
+    --recursica_ui-kit_components_dropdown_properties_border-radius
+  );
+  border-width: 1px;
+  border-style: solid;
+
+  /* Strict Typography Unification */
+  font-family: var(
+    --recursica_ui-kit_components_dropdown_properties_text_font-family
+  );
+  font-size: var(
+    --recursica_ui-kit_components_dropdown_properties_text_font-size
+  );
+  font-style: var(
+    --recursica_ui-kit_components_dropdown_properties_text_font-style
+  );
+  font-weight: var(
+    --recursica_ui-kit_components_dropdown_properties_text_font-weight
+  );
+  letter-spacing: var(
+    --recursica_ui-kit_components_dropdown_properties_text_letter-spacing
+  );
+  line-height: var(
+    --recursica_ui-kit_components_dropdown_properties_text_line-height
+  );
+  text-decoration: var(
+    --recursica_ui-kit_components_dropdown_properties_text_text-decoration
+  );
+  text-transform: var(
+    --recursica_ui-kit_components_dropdown_properties_text_text-transform
+  );
+
+  /* Base State Default Execution */
+  background-color: var(
+    --recursica_ui-kit_components_dropdown_variants_states_default_properties_colors_background
+  );
+  border-color: var(
+    --recursica_ui-kit_components_dropdown_variants_states_default_properties_colors_border-color
+  );
+  color: var(
+    --recursica_ui-kit_components_dropdown_variants_states_default_properties_colors_text
+  );
+
+  outline: none;
+}
+
+.input::placeholder {
+  /* HARDCODE: Dropdown properties currently missing placeholder-opacity tokens from Figma JSON */
+  opacity: 0.5;
+  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_dropdown_properties_horizontal-padding
+  );
+}
+
+.section[data-position="right"] {
+  justify-content: flex-end;
+  padding-right: var(
+    --recursica_ui-kit_components_dropdown_properties_horizontal-padding
+  );
+}
+
+.section :global(svg) {
+  width: var(--recursica_ui-kit_components_dropdown_properties_icon-size);
+  height: var(--recursica_ui-kit_components_dropdown_properties_icon-size);
+  color: var(
+    --recursica_ui-kit_components_dropdown_variants_states_default_properties_colors_leading-icon
+  );
+}
+
+.section[data-position="right"] :global(svg) {
+  color: var(
+    --recursica_ui-kit_components_dropdown_variants_states_default_properties_colors_trailing-icon
+  );
+}
+
+/* -------------------------------------
+   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_dropdown_variants_states_focus_properties_colors_border-color
+  );
+  background-color: var(
+    --recursica_ui-kit_components_dropdown_variants_states_focus_properties_colors_background
+  );
+  color: var(
+    --recursica_ui-kit_components_dropdown_variants_states_focus_properties_colors_text
+  );
+}
+
+.root:focus-within .section[data-position="left"] :global(svg) {
+  color: var(
+    --recursica_ui-kit_components_dropdown_variants_states_focus_properties_colors_leading-icon
+  );
+}
+
+.root:focus-within .section[data-position="right"] :global(svg) {
+  color: var(
+    --recursica_ui-kit_components_dropdown_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_dropdown_variants_states_error_properties_colors_border-color
+  ) !important;
+  background-color: var(
+    --recursica_ui-kit_components_dropdown_variants_states_error_properties_colors_background
+  ) !important;
+  color: var(
+    --recursica_ui-kit_components_dropdown_variants_states_error_properties_colors_text
+  ) !important;
+}
+
+.root[data-error] .section[data-position="left"] :global(svg) {
+  color: var(
+    --recursica_ui-kit_components_dropdown_variants_states_error_properties_colors_leading-icon
+  ) !important;
+}
+
+.root[data-error] .section[data-position="right"] :global(svg) {
+  color: var(
+    --recursica_ui-kit_components_dropdown_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_dropdown_variants_states_disabled_properties_colors_border-color
+  ) !important;
+  background-color: var(
+    --recursica_ui-kit_components_dropdown_variants_states_disabled_properties_colors_background
+  ) !important;
+  color: var(
+    --recursica_ui-kit_components_dropdown_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_dropdown_variants_states_disabled_properties_colors_leading-icon
+  ) !important;
+}
+
+.root[data-disabled] .section[data-position="right"] :global(svg) {
+  color: var(
+    --recursica_ui-kit_components_dropdown_variants_states_disabled_properties_colors_trailing-icon
+  ) !important;
+}
+
+/* -------------------------------------
+   DROPDOWN & OPTIONS ARCHITECTURE
+-------------------------------------- */
+
+.dropdown {
+  background-color: var(
+    --recursica_ui-kit_components_dropdown_variants_states_default_properties_colors_background
+  );
+  border: 1px solid
+    var(
+      --recursica_ui-kit_components_dropdown_variants_states_default_properties_colors_border-color
+    );
+  border-radius: var(
+    --recursica_ui-kit_components_dropdown_properties_border-radius
+  );
+  overflow: hidden;
+}
+
+.option {
+  font-family: var(
+    --recursica_ui-kit_components_dropdown_properties_text_font-family
+  );
+  font-size: var(
+    --recursica_ui-kit_components_dropdown_properties_text_font-size
+  );
+  font-weight: var(
+    --recursica_ui-kit_components_dropdown_properties_text_font-weight
+  );
+  color: var(
+    --recursica_ui-kit_components_dropdown_variants_states_default_properties_colors_text
+  );
+  padding: calc(
+      var(--recursica_ui-kit_components_dropdown_properties_vertical-padding) *
+        0.75
+    )
+    var(--recursica_ui-kit_components_dropdown_properties_horizontal-padding);
+  cursor: pointer;
+}
+
+.option[data-selected="true"],
+.option[data-combobox-selected="true"],
+.option[data-hovered="true"],
+.option:hover {
+  background-color: var(
+    --recursica_ui-kit_components_dropdown_variants_states_focus_properties_colors_background
+  );
+  color: var(
+    --recursica_ui-kit_components_dropdown_variants_states_focus_properties_colors_text
+  );
+}