@recursica/adapter-mantine-v8 1.0.0

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

@@ -0,0 +1,367 @@
+/* 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_focus_blur
+ *   recursica-allow-brand: --recursica_brand_states_focus_border-size
+ *   recursica-allow-brand: --recursica_brand_states_focus_color
+ *   recursica-allow-brand: --recursica_brand_states_focus_margin
+ *   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
+    );
+
+  /* Closed (resting) background/border — swapped to the open appearance below when expanded */
+  background-color: var(
+    --recursica_ui-kit_components_accordion-header_variants_appearance_closed_properties_colors_background-color
+  );
+
+  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[data-active] .control {
+  background-color: var(
+    --recursica_ui-kit_components_accordion-header_variants_appearance_open_properties_colors_background-color
+  );
+  border-color: var(
+    --recursica_ui-kit_components_accordion-header_variants_appearance_open_properties_colors_border-color
+  );
+  color: var(
+    --recursica_ui-kit_components_accordion-header_variants_appearance_open_properties_colors_text-color
+  );
+}
+
+/* Mantine natively places hover states on the control node. We explicitly re-apply our own real
+   background (Mantine's native :hover CSS would otherwise show through) — closed or open,
+   matching whichever appearance is currently active — 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
+  );
+}
+.item[data-active] .control:hover:not(:disabled) {
+  background-color: var(
+    --recursica_ui-kit_components_accordion-header_variants_appearance_open_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);
+}
+
+/* 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). The Control's own native
+   `disabled` attribute already blocks click/keyboard interaction on its own; this only
+   handles the visual dim. */
+.item[data-disabled] {
+  opacity: var(--recursica_brand_states_disabled);
+}
+
+/* Recursica focus ring instead of Mantine's default `.mantine-focus-auto:focus-visible` outline
+   (same class+pseudo-class specificity, so !important guarantees ours wins regardless of CSS
+   import order). */
+.control:focus-visible {
+  outline: none !important;
+  box-shadow:
+    0 0 0 var(--recursica_brand_states_focus_border-size)
+      var(--recursica_brand_states_focus_color),
+    0 0 var(--recursica_brand_states_focus_blur)
+      var(--recursica_brand_states_focus_margin)
+      var(--recursica_brand_states_focus_color) !important;
+}
+
+/* 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` clipped 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;
+}
+
+/* ==== ICON SLOT (Mantine's leading-icon wrapper) ==== */
+.icon {
+  /* HARDCODE: Mantine applies its own margin-inline-start/end around this slot; our own
+     icon-gap token (applied as flex `gap` on .control) already provides the spacing. */
+  margin-inline-start: 0;
+  margin-inline-end: 0;
+}
+
+/* ==== 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;
+}
+.item[data-active] .chevron {
+  transform: rotate(180deg);
+  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[data-active] .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,189 @@
+import type { Meta, StoryObj } from "@storybook/react";
+import { Accordion } from "./Accordion";
+
+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 (
+      <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>
+    );
+  },
+};
+
+export const WithIcons: StoryObj<typeof Accordion> = {
+  render: () => {
+    return (
+      <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>
+    );
+  },
+};
+
+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.
+      <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>
+    );
+  },
+};
+
+export const Disabled: StoryObj<typeof Accordion> = {
+  render: () => {
+    return (
+      <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>
+    );
+  },
+};

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

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