@recursica/adapter-mui-v7 1.0.0

package/src/components/Accordion/Accordion.module.css

@@ -0,0 +1,362 @@
+/* Brand-layer exemptions (recursica-allow-brand) — see recursica-token-analyzer README.md.
+ * Global hover/focus/disabled state tokens (recursica_variables_scoped.css header, 'Hover & Focus states' / 'Disabled state' — implicit rule for every interactive element; components must not define their own per-component treatment).
+ *   recursica-allow-brand: --recursica_brand_states_disabled
+ *   recursica-allow-brand: --recursica_brand_states_hover_color
+ *   recursica-allow-brand: --recursica_brand_states_hover_opacity
+ */
+
+/* ==== ACCORDION CONTAINER ==== */
+.root {
+  box-sizing: border-box;
+  margin: 0;
+  display: flex;
+  flex-direction: column;
+
+  border-style: solid;
+  border-width: var(
+    --recursica_ui-kit_components_accordion_properties_border-size
+  );
+  border-radius: var(
+    --recursica_ui-kit_components_accordion_properties_border-radius
+  );
+  border-color: var(
+    --recursica_ui-kit_components_accordion_properties_colors_border-color
+  );
+  background-color: var(
+    --recursica_ui-kit_components_accordion_properties_colors_background-color
+  );
+  box-shadow: var(--recursica_ui-kit_components_accordion_properties_elevation);
+
+  max-width: var(--recursica_ui-kit_components_accordion_properties_max-width);
+  min-width: var(--recursica_ui-kit_components_accordion_properties_min-width);
+  padding: var(--recursica_ui-kit_components_accordion_properties_padding);
+
+  /* Ensure gaps between items */
+  gap: var(--recursica_ui-kit_components_accordion_properties_item-gap);
+}
+
+/* ==== ACCORDION ITEM ==== */
+.item {
+  box-sizing: border-box;
+  margin: var(--recursica_ui-kit_components_accordion-item_properties_margin);
+  padding: var(--recursica_ui-kit_components_accordion-item_properties_padding);
+  position: relative;
+  transition: all 0.2s ease;
+
+  /* Overriding Mantine Default Borders natively */
+  border-bottom: none;
+
+  border-style: solid;
+  border-color: var(
+    --recursica_ui-kit_components_accordion-item_properties_colors_border-color
+  );
+  border-width: var(
+    --recursica_ui-kit_components_accordion-item_properties_border-size
+  );
+  border-bottom-color: var(
+    --recursica_ui-kit_components_accordion_properties_colors_divider-color
+  );
+  border-bottom-width: var(
+    --recursica_ui-kit_components_accordion_properties_divider-size
+  );
+  border-radius: var(
+    --recursica_ui-kit_components_accordion-item_properties_border-radius
+  );
+  box-shadow: var(
+    --recursica_ui-kit_components_accordion-item_properties_elevation
+  );
+}
+/* The collapsed/expanded background now lives on accordion-header (open/closed appearance),
+   applied via .control below, rather than on the item wrapper itself. */
+.noDivider {
+  border-bottom: none !important;
+  border-bottom-width: 0 !important;
+}
+
+/* ==== ACCORDION CONTROL (HEADER) ==== */
+.control {
+  box-sizing: border-box;
+  width: 100%;
+  display: flex;
+  align-items: center;
+  justify-content: space-between;
+
+  /* Re-apply gap defined by UI Kit for icons vs text */
+  gap: var(--recursica_ui-kit_components_accordion-header_properties_icon-gap);
+
+  /* Strip Mantine's baked padding directly */
+  padding: var(
+      --recursica_ui-kit_components_accordion-header_properties_vertical-padding
+    )
+    var(
+      --recursica_ui-kit_components_accordion-header_properties_horizontal-padding
+    );
+
+  /* Background is intentionally constant across collapsed/expanded (Forge doesn't apply a
+     background swap on expand, even though the token schema defines an "open" appearance color) */
+  background-color: var(
+    --recursica_ui-kit_components_accordion-header_variants_appearance_closed_properties_colors_background-color
+  );
+
+  /* Header's own border box, constant across collapsed/expanded (only its closed-state
+     border-color is used, matching the background decision above) */
+  border-style: solid;
+  border-width: var(
+    --recursica_ui-kit_components_accordion-header_properties_border-size
+  );
+  border-radius: var(
+    --recursica_ui-kit_components_accordion-header_properties_border-radius
+  );
+  border-color: var(
+    --recursica_ui-kit_components_accordion-header_variants_appearance_closed_properties_colors_border-color
+  );
+  box-shadow: var(
+    --recursica_ui-kit_components_accordion-header_properties_elevation
+  );
+
+  transition: background-color 0.15s ease;
+  position: relative;
+  z-index: 1;
+  color: var(
+    --recursica_ui-kit_components_accordion-header_variants_appearance_closed_properties_colors_text-color
+  );
+
+  /* Header Typography */
+  font-family: var(
+    --recursica_ui-kit_components_accordion-header_properties_text_font-family
+  );
+  font-size: var(
+    --recursica_ui-kit_components_accordion-header_properties_text_font-size
+  );
+  font-weight: var(
+    --recursica_ui-kit_components_accordion-header_properties_text_font-weight
+  );
+  font-style: var(
+    --recursica_ui-kit_components_accordion-header_properties_text_font-style
+  );
+  letter-spacing: var(
+    --recursica_ui-kit_components_accordion-header_properties_text_letter-spacing
+  );
+  line-height: var(
+    --recursica_ui-kit_components_accordion-header_properties_text_line-height
+  );
+  text-decoration: var(
+    --recursica_ui-kit_components_accordion-header_properties_text_text-decoration
+  );
+  text-transform: var(
+    --recursica_ui-kit_components_accordion-header_properties_text_text-transform
+  );
+}
+
+.item:global(.Mui-expanded) .control {
+  color: var(
+    --recursica_ui-kit_components_accordion-header_variants_appearance_open_properties_colors_text-color
+  );
+}
+
+/* Ensure inner native wrap aligns and has zero margins */
+.control :global(.MuiAccordionSummary-content) {
+  margin: 0 !important;
+  display: flex;
+  align-items: center;
+  gap: inherit;
+  flex: 1;
+  min-width: 0; /* HARDCODE: a flex item's automatic min-width otherwise defaults to its
+    content's min-content size — since .label's text is `white-space: nowrap`, that min-content
+    size is the full unwrapped title width, which propagates up through this intermediate flex
+    item and blocks .label's own `min-width: 0` from letting text-overflow: ellipsis kick in at
+    all (title wraps/overflows the control instead of truncating). */
+}
+
+.control :global(.MuiAccordionSummary-content.Mui-expanded) {
+  margin: 0 !important;
+}
+
+/* MUI natively places hover states on the control node. We explicitly re-apply our own
+   constant background (MUI's native :hover CSS would otherwise show through) and use an
+   overlay ::after structure with the generic hover tokens for the actual hover tint; no per-item
+   hover-color/hover-opacity tokens exist anymore. */
+.control:hover:not(:disabled) {
+  background-color: var(
+    --recursica_ui-kit_components_accordion-header_variants_appearance_closed_properties_colors_background-color
+  );
+}
+.control::after {
+  content: "";
+  position: absolute;
+  inset: 0;
+  border-radius: inherit;
+  z-index: -1;
+  pointer-events: none;
+  background-color: var(--recursica_brand_states_hover_color);
+  opacity: 0;
+  transition: opacity 150ms ease;
+}
+.control:hover:not(:disabled)::after {
+  opacity: var(--recursica_brand_states_hover_opacity);
+}
+
+/* MUI applies its own default disabled treatment on both the item root and the control
+   (`.Mui-disabled`, each with its own hardcoded background/opacity) — neutralized here so the
+   token-driven dim below is the single source of truth. */
+.item:global(.Mui-disabled) {
+  background-color: transparent;
+}
+.control:global(.Mui-disabled) {
+  opacity: 1;
+}
+
+/* Dims the whole item — control and any currently-visible panel content alike — using the
+   generic disabled opacity token, same convention as every other disabled component in the
+   design system (no accordion-item-specific disabled token exists). MUI's own `disabled` prop
+   already blocks click/keyboard interaction on the control internally; this only handles the
+   visual dim. */
+.item[data-disabled] {
+  opacity: var(--recursica_brand_states_disabled);
+}
+
+/* Label logic inside the Control wrapper */
+.label {
+  flex: 1;
+  min-width: 0; /* HARDCODE: required for text-overflow ellipsis to take effect on a flex child */
+  text-align: left;
+  color: inherit;
+  padding: 0; /* Clear Mantine inner padding */
+  overflow: clip; /* HARDCODE: `hidden` clips descenders (e.g. "g") whenever the text_line-height
+    token is tighter than the font's natural ascent+descent; `overflow-clip-margin` gives ink a
+    small bleed allowance while still clipping genuinely overflowing text — same fix project-wide,
+    see Chip/FileInput's IMPLEMENTATION_NOTES.md for the original discovery. */
+  overflow-clip-margin: 0.35em;
+  white-space: nowrap;
+  text-overflow: ellipsis;
+}
+
+/* ==== CHEVRON / RIGHT ICON ==== */
+.chevron {
+  flex-shrink: 0;
+  width: var(
+    --recursica_ui-kit_components_accordion-header_properties_icon-right-size
+  );
+  height: var(
+    --recursica_ui-kit_components_accordion-header_properties_icon-right-size
+  );
+  color: var(
+    --recursica_ui-kit_components_accordion-header_variants_appearance_closed_properties_colors_icon-color
+  );
+  margin: 0;
+  transition: transform 200ms ease;
+  display: flex;
+  align-items: center;
+  justify-content: center;
+}
+.chevron > * {
+  width: 100%;
+  height: 100%;
+  object-fit: contain;
+}
+/* Rotation itself comes from MUI's own `.MuiAccordionSummary-expandIconWrapper.Mui-expanded`,
+   which already wraps this span — rotating here too would double it back to 0deg. */
+.item:global(.Mui-expanded) .chevron {
+  color: var(
+    --recursica_ui-kit_components_accordion-header_variants_appearance_open_properties_colors_icon-color
+  );
+}
+
+/* ==== LEFT ICON / CUSTOM ICONS ==== */
+.iconLeftWrapper {
+  flex-shrink: 0;
+  display: flex;
+  align-items: center;
+  justify-content: center;
+  width: var(
+    --recursica_ui-kit_components_accordion-header_properties_icon-left-size
+  );
+  height: var(
+    --recursica_ui-kit_components_accordion-header_properties_icon-left-size
+  );
+  color: var(
+    --recursica_ui-kit_components_accordion-header_variants_appearance_closed_properties_colors_icon-color
+  );
+}
+.item:global(.Mui-expanded) .iconLeftWrapper {
+  color: var(
+    --recursica_ui-kit_components_accordion-header_variants_appearance_open_properties_colors_icon-color
+  );
+}
+.iconLeftWrapper > * {
+  width: 100%;
+  height: 100%;
+  object-fit: contain;
+}
+
+/* ==== ACCORDION PANEL (CONTENT) ==== */
+.panel {
+  box-sizing: border-box;
+  margin: var(
+    --recursica_ui-kit_components_accordion-content_properties_margin
+  );
+  padding: 0; /* Overriding dynamic layout structure */
+  background-color: var(
+    --recursica_ui-kit_components_accordion-content_properties_colors_background-color
+  );
+  border-style: solid;
+  border-color: var(
+    --recursica_ui-kit_components_accordion-content_properties_colors_border-color
+  );
+  border-width: var(
+    --recursica_ui-kit_components_accordion-content_properties_border-size
+  );
+  border-radius: var(
+    --recursica_ui-kit_components_accordion-content_properties_border-radius
+  );
+  box-shadow: var(
+    --recursica_ui-kit_components_accordion-content_properties_elevation
+  );
+}
+
+.content {
+  box-sizing: border-box;
+  /* Strip Mantine padding and apply logic directly mapped */
+  padding: 0
+    var(
+      --recursica_ui-kit_components_accordion-content_properties_horizontal-padding
+    )
+    var(
+      --recursica_ui-kit_components_accordion-content_properties_bottom-padding
+    );
+
+  /* Apply offset gap explicitly calculated below header */
+  padding-top: var(
+    --recursica_ui-kit_components_accordion-content_properties_top-padding
+  );
+
+  color: var(
+    --recursica_ui-kit_components_accordion-content_properties_colors_text-color
+  );
+
+  /* Content Typography */
+  font-family: var(
+    --recursica_ui-kit_components_accordion-content_properties_text_font-family
+  );
+  font-size: var(
+    --recursica_ui-kit_components_accordion-content_properties_text_font-size
+  );
+  font-weight: var(
+    --recursica_ui-kit_components_accordion-content_properties_text_font-weight
+  );
+  font-style: var(
+    --recursica_ui-kit_components_accordion-content_properties_text_font-style
+  );
+  letter-spacing: var(
+    --recursica_ui-kit_components_accordion-content_properties_text_letter-spacing
+  );
+  line-height: var(
+    --recursica_ui-kit_components_accordion-content_properties_text_line-height
+  );
+  text-decoration: var(
+    --recursica_ui-kit_components_accordion-content_properties_text_text-decoration
+  );
+  text-transform: var(
+    --recursica_ui-kit_components_accordion-content_properties_text_text-transform
+  );
+}

package/src/components/Accordion/Accordion.stories.tsx

@@ -0,0 +1,198 @@
+import type { Meta, StoryObj } from "@storybook/react";
+import { Accordion } from "./Accordion";
+import { Layer } from "@recursica/adapter-common";
+
+const SVGIcon = () => (
+  <svg
+    xmlns="http://www.w3.org/2000/svg"
+    width="24"
+    height="24"
+    viewBox="0 0 24 24"
+    fill="none"
+    stroke="currentColor"
+    strokeWidth="2"
+    strokeLinecap="round"
+    strokeLinejoin="round"
+  >
+    <path d="M12 2v20M17 5H9.5a3.5 3.5 0 0 0 0 7h5a3.5 3.5 0 0 1 0 7H6" />
+  </svg>
+);
+
+const ChevronIcon = () => (
+  <svg
+    width="24"
+    height="24"
+    viewBox="0 0 24 24"
+    fill="none"
+    xmlns="http://www.w3.org/2000/svg"
+  >
+    <path
+      d="M20.0306 9.53062L12.5306 17.0306C12.461 17.1003 12.3783 17.1557 12.2872 17.1934C12.1962 17.2312 12.0986 17.2506 12 17.2506C11.9014 17.2506 11.8038 17.2312 11.7128 17.1934C11.6218 17.1557 11.539 17.1003 11.4694 17.0306L3.96938 9.53062C3.82865 9.38988 3.74959 9.19901 3.74959 8.99999C3.74959 8.80097 3.82865 8.61009 3.96938 8.46936C4.11011 8.32863 4.30098 8.24957 4.50001 8.24957C4.69903 8.24957 4.8899 8.32863 5.03063 8.46936L12 15.4397L18.9694 8.46936C19.0391 8.39968 19.1218 8.34441 19.2128 8.30669C19.3039 8.26898 19.4015 8.24957 19.5 8.24957C19.5986 8.24957 19.6961 8.26898 19.7872 8.30669C19.8782 8.34441 19.9609 8.39968 20.0306 8.46936C20.1003 8.53905 20.1556 8.62177 20.1933 8.71282C20.231 8.80386 20.2504 8.90144 20.2504 8.99999C20.2504 9.09854 20.231 9.19612 20.1933 9.28716C20.1556 9.37821 20.1003 9.46093 20.0306 9.53062Z"
+      fill="currentColor"
+    />
+  </svg>
+);
+
+const meta: Meta<typeof Accordion> = {
+  title: "UI-Kit/Accordion",
+  component: Accordion,
+  tags: ["autodocs"],
+  parameters: {
+    docs: {
+      description: {
+        component: `
+The \`Accordion\` component intelligently wraps \`@mantine/core\`'s underlying Accordion layers while applying strict native design system mapping via \`recursica_variables_scoped.css\`.
+
+### Hybrid Composition API (Smart-Rendering)
+To maximize flexibility while strictly aligning with the explicit Recursica design logic, the \`AccordionItem\` operates utilizing a **Hybrid Smart-Rendering Flow**:
+
+1. **Auto-Construction (Explicit Mapping)**:
+If you supply the explicitly outlined Recursica properties (\`title\`, \`leftIcon\`) directly onto \`<Accordion.Item>\`, the component auto-generates the necessary \`<Accordion.Control>\` DOM layer inherently bridging the icons and titles visually while leaving the raw \`children\` wrapped neatly as the \`<Accordion.Panel>\`.
+
+2. **Graceful Falldown (Raw Composability)**:
+If you deliberately omit the \`title\` property, the entire mapping system gracefully falls backward yielding exactly to the raw \`@mantine/core\` composition model. Under this context, you must inject your localized \`<Accordion.Control>\` and \`<Accordion.Panel>\` configurations completely manually.
+
+### Architecture Warning (\`open\`)
+To structurally protect the parent wrapper's core transitions tracking architecture (\`<Accordion value="...">\`), this configuration explicitly rejects mapping isolated \`open={true}\` object states natively on specific configurations. Use Mantine's inherent sibling arrays matching the corresponding active value map!
+        `,
+      },
+    },
+  },
+};
+
+export default meta;
+
+export const Default: StoryObj<typeof Accordion> = {
+  render: () => {
+    return (
+      <Layer layer={0} style={{ padding: "24px" }}>
+        <Accordion defaultValue="item-1" chevron={<ChevronIcon />}>
+          <Accordion.Item value="item-1">
+            <Accordion.Control>Billing and Membership</Accordion.Control>
+            <Accordion.Panel>
+              You can manage your billing directly from the dashboard tab. All
+              payments are processed automatically.
+            </Accordion.Panel>
+          </Accordion.Item>
+
+          <Accordion.Item value="item-2">
+            <Accordion.Control>Refund Policy</Accordion.Control>
+            <Accordion.Panel>
+              We offer a 30-day money-back guarantee for all new subscriptions.
+            </Accordion.Panel>
+          </Accordion.Item>
+
+          <Accordion.Item value="item-3">
+            <Accordion.Control>Technical Support</Accordion.Control>
+            <Accordion.Panel>
+              Our support team is available 24/7 via live chat or email.
+            </Accordion.Panel>
+          </Accordion.Item>
+        </Accordion>
+      </Layer>
+    );
+  },
+};
+
+export const WithIcons: StoryObj<typeof Accordion> = {
+  render: () => {
+    return (
+      <Layer layer={0} style={{ padding: "24px" }}>
+        <Accordion defaultValue="security" chevron={<ChevronIcon />}>
+          <Accordion.Item value="security">
+            <Accordion.Control leftIcon={<SVGIcon />}>
+              Security Settings
+            </Accordion.Control>
+            <Accordion.Panel>
+              Enable two-factor authentication (2FA) and monitor active sessions
+              below.
+            </Accordion.Panel>
+          </Accordion.Item>
+
+          <Accordion.Item value="privacy">
+            <Accordion.Control leftIcon={<SVGIcon />}>
+              Privacy Configuration
+            </Accordion.Control>
+            <Accordion.Panel>
+              Choose what data is shared with our analytics partners.
+            </Accordion.Panel>
+          </Accordion.Item>
+        </Accordion>
+      </Layer>
+    );
+  },
+};
+
+export const LongTitleTruncation: StoryObj<typeof Accordion> = {
+  render: () => {
+    return (
+      // `style` is stripped from Accordion itself (only passes through with overStyled);
+      // constrain width on a plain wrapper div instead to force truncation.
+      <Layer layer={0} style={{ padding: "24px" }}>
+        <div style={{ maxWidth: 320 }}>
+          <Accordion defaultValue="long-title" chevron={<ChevronIcon />}>
+            <Accordion.Item value="long-title">
+              <Accordion.Control leftIcon={<SVGIcon />}>
+                This is a deliberately very long accordion item title used to
+                verify that overflowing text truncates with a CSS ellipsis
+                instead of wrapping or overflowing the header
+              </Accordion.Control>
+              <Accordion.Panel>
+                The header label above should truncate to a single line with a
+                trailing ellipsis (…) rather than wrapping onto multiple lines
+                or pushing the chevron out of view.
+              </Accordion.Panel>
+            </Accordion.Item>
+
+            <Accordion.Item value="short-title">
+              <Accordion.Control leftIcon={<SVGIcon />}>
+                Short Title
+              </Accordion.Control>
+              <Accordion.Panel>
+                A short title in the same accordion for visual comparison.
+              </Accordion.Panel>
+            </Accordion.Item>
+          </Accordion>
+        </div>
+      </Layer>
+    );
+  },
+};
+
+export const Disabled: StoryObj<typeof Accordion> = {
+  render: () => {
+    return (
+      <Layer layer={0} style={{ padding: "24px" }}>
+        <Accordion defaultValue="expanded-disabled" chevron={<ChevronIcon />}>
+          <Accordion.Item value="expanded-disabled" disabled>
+            <Accordion.Control leftIcon={<SVGIcon />}>
+              Expanded and Disabled
+            </Accordion.Control>
+            <Accordion.Panel>
+              This item starts expanded so the panel content's dimming can be
+              verified alongside the control's, not just the collapsed header.
+            </Accordion.Panel>
+          </Accordion.Item>
+
+          <Accordion.Item value="collapsed-disabled" disabled>
+            <Accordion.Control leftIcon={<SVGIcon />}>
+              Collapsed and Disabled
+            </Accordion.Control>
+            <Accordion.Panel>
+              Clicking or tabbing to this control should have no effect.
+            </Accordion.Panel>
+          </Accordion.Item>
+
+          <Accordion.Item value="enabled">
+            <Accordion.Control leftIcon={<SVGIcon />}>
+              Enabled, for Comparison
+            </Accordion.Control>
+            <Accordion.Panel>
+              A normal, interactive item alongside the disabled ones above.
+            </Accordion.Panel>
+          </Accordion.Item>
+        </Accordion>
+      </Layer>
+    );
+  },
+};

package/src/components/Accordion/Accordion.test.tsx

@@ -0,0 +1 @@
+// Placeholder for future Accordion component tests. Add tests here if/when needed.