@recursica/mantine-adapter 0.42.0 → 0.43.0

package/CHANGELOG.md

@@ -1,5 +1,23 @@
 # @recursica/mantine-adapter
 
+## 0.43.0
+
+### Minor Changes
+
+- d171a96: Update revision to latest
+
+### Patch Changes
+
+- Updated dependencies [d171a96]
+  - @recursica/adapter-common@0.19.0
+
+## 0.42.1
+
+### Patch Changes
+
+- 015c809: DatePicker's calendar (hover, today, weekend, disabled/outside days, in-range, header nav/month-label as Recursica text buttons, popover border/shadow) is now fully token-driven. Default value format is `MM/DD/YY`, `highlightToday` defaults to `true`, a default calendar icon is provided (overridable via `leftSection`), and the field no longer wraps its value/placeholder to a second line. Default placeholder is `"MM / DD / YY"` (overridable via `placeholder`).
+- 56e0d63: Remove all `recursica-ignore` exemption comments so the token analyzer report reflects true unused/unimplemented Figma variables. No runtime behavior change.
+
 ## 0.42.0
 
 ### Minor Changes

package/dist/index.d.ts

@@ -49,7 +49,7 @@ import { MenuSubDropdownProps as MenuSubDropdownProps_2 } from '@mantine/core';
 import { MenuSubProps as MenuSubProps_2 } from '@mantine/core';
 import { MenuSubTargetProps as MenuSubTargetProps_2 } from '@mantine/core';
 import { MenuTargetProps as MenuTargetProps_2 } from '@mantine/core';
-import { ModalBodyProps } from '@mantine/core';
+import { ModalBodyProps as ModalBodyProps_2 } from '@mantine/core';
 import { ModalCloseButtonProps as ModalCloseButtonProps_2 } from '@mantine/core';
 import { ModalContentProps as ModalContentProps_2 } from '@mantine/core';
 import { ModalHeaderProps as ModalHeaderProps_2 } from '@mantine/core';
@@ -253,9 +253,6 @@ declare const CardFooter: ForwardRefExoticComponent<CardFooterProps & RefAttribu
 
 declare type CardFooterProps = RecursicaOverStyled<RecursicaCardSectionProps>;
 
-/**
- * Replaces standard generic Mantine `<Card.Section>` wrappers by directly injecting the strict Recursica design tokens for header sizing, background drops, and intrinsic padding limits.
- */
 declare const CardHeader: ForwardRefExoticComponent<CardHeaderProps & RefAttributes<HTMLDivElement>>;
 
 declare type CardHeaderProps = RecursicaOverStyled<RecursicaCardSectionProps>;
@@ -721,7 +718,7 @@ export declare const HoverCard: typeof rawComponents.HoverCard;
 declare const HoverCard_2: HoverCardComponent;
 
 declare const HoverCardBase: {
-    ({ overStyled, withBeak, ...rest }: HoverCardProps): JSX.Element;
+    ({ overStyled, withBeak, position, arrowSize, withArrow, ...rest }: HoverCardProps): JSX.Element;
     displayName: string;
 };
 
@@ -883,8 +880,7 @@ renderRoot?: (props: Record<string, any>) => any;
 /**
  * An individual actionable item within the menu dropdown.
  *
- * **Note:** Mantine's `color` prop is stripped in strict mode to enforce
- * design token adherence. Use `overStyled={true}` if you need to bypass.
+ * **Note:** Mantine's `color` prop is stripped to enforce design token adherence.
  */
 declare type MenuItemProps = RecursicaOverStyled<Omit<MenuItemProps_2, "color">>;
 
@@ -960,7 +956,7 @@ declare const MenuSubTarget: {
 declare type MenuSubTargetProps = MenuSubTargetProps_2;
 
 declare const MenuTarget: {
-    (props: MenuTargetProps): JSX.Element;
+    ({ overStyled, ...rest }: MenuTargetProps): JSX.Element;
     displayName: string;
 };
 
@@ -968,7 +964,46 @@ declare const MenuTarget: {
  * Wrapper for the element that triggers the menu.
  * Requires a single child element that supports ref forwarding.
  */
-declare type MenuTargetProps = MenuTargetProps_2;
+declare type MenuTargetProps = RecursicaOverStyled<MenuTargetProps_2>;
+
+/**
+ * mergeClassNames
+ *
+ * Per-slot merge for a `classNames` prop against Recursica's own CSS-module classes. This is
+ * NOT the same shape as `withCallerOverride`: the caller's value must never fully replace ours,
+ * because the underlying library's `classNames` slots are singular strings — replacing one
+ * outright would drop the component's own module styles, not just extend them. Each slot keeps
+ * Recursica's class and appends the caller's class for that slot if they supplied one.
+ *
+ * Merges over the UNION of slots in `ours` and `callerValue`, not just `ours`'s keys — a caller
+ * may target a slot Recursica doesn't set a default class for (e.g. a library slot we never
+ * needed to style ourselves). Restricting the loop to `ours`'s keys would silently drop that
+ * slot instead of passing it through, the same class of prop-leakage bug this whole pattern
+ * exists to prevent.
+ *
+ * @param ours - Recursica's own per-slot classNames (CSS module classes)
+ * @param callerValue - The caller's `classNames` prop, if any
+ * @returns a new classNames object covering every slot named by either side
+ */
+export declare function mergeClassNames<T extends Record<string, string | undefined>>(ours: T, callerValue: Partial<Record<keyof T, string>> | undefined): T;
+
+/**
+ * mergeStyles
+ *
+ * Per-slot merge for a `styles` prop (e.g. Mantine's StylesApi) against Recursica's own default
+ * inline styles for that slot. Mirrors `mergeClassNames`'s shape but the merge is a plain object
+ * merge instead of a string concat, since each slot's value is a `CSSProperties` object, not a
+ * class list: the caller's individual style properties override ours property-by-property
+ * without dropping properties they didn't touch.
+ *
+ * Merges over the UNION of slots in `ours` and `callerValue`, not just `ours`'s keys — same
+ * reasoning as `mergeClassNames`: a caller may target a slot Recursica has no default for.
+ *
+ * @param ours - Recursica's own per-slot default styles, if any
+ * @param callerValue - The caller's `styles` prop, if any
+ * @returns a new styles object covering every slot named by either side
+ */
+export declare function mergeStyles<T extends Record<string, default_2.CSSProperties | undefined>>(ours: T, callerValue: Partial<Record<keyof T, default_2.CSSProperties>> | undefined): T;
 
 export declare const Modal: typeof rawComponents.Modal;
 
@@ -976,10 +1011,9 @@ declare const Modal_2: ModalComponent & {
     Footer: typeof ModalFooter;
 };
 
-declare const ModalBody: default_2.ForwardRefExoticComponent<Omit<ModalBodyProps & default_2.RefAttributes<HTMLDivElement> & {
-    component?: any;
-    renderRoot?: (props: Record<string, any>) => default_2.ReactNode;
-}, "ref"> & default_2.RefAttributes<HTMLDivElement>>;
+declare const ModalBody: default_2.ForwardRefExoticComponent<ModalBodyProps & default_2.RefAttributes<HTMLDivElement>>;
+
+declare type ModalBodyProps = RecursicaOverStyled<ModalBodyProps_2>;
 
 declare const ModalCloseButton: default_2.ForwardRefExoticComponent<ModalCloseButtonProps & default_2.RefAttributes<HTMLButtonElement>>;
 
@@ -1045,6 +1079,32 @@ declare const NumberInput_2: default_2.ForwardRefExoticComponent<NumberInputProp
 
 declare type NumberInputProps_2 = RecursicaOverStyled<RecursicaNumberInputProps>;
 
+/**
+ * omitUnsupportedProps
+ *
+ * Shared across every adapter. Where `filterStylingProps` blocks the fixed set of styling
+ * escape hatches (className, style, sx, etc.), this utility deletes a component-declared list
+ * of named props that component doesn't support at all — e.g. a native prop the underlying
+ * library exposes but Recursica intentionally doesn't map (`size`, `color`, `radius`, ...).
+ *
+ * `Omit<LibraryProps, "size">` on the public type already stops well-typed callers. This is the
+ * runtime backstop: a plain-JavaScript caller (or anyone forcing the type) can still put `size`
+ * on the props object, and without this it would leak straight through `...rest` into the
+ * wrapped component. Call this immediately after `filterStylingProps`, on every component
+ * (including sub-components merged onto a parent, e.g. `Table.Th`), declaring the omitted keys
+ * as a local `UNSUPPORTED_PROPS` const with a comment per prop explaining why it's unsupported.
+ *
+ * @param props - Props already run through `filterStylingProps`
+ * @param unsupportedProps - Component-declared list of prop names to delete. Typed as
+ *   `PropertyKey`, not `keyof T`, on purpose: `T` is the already-narrowed `rest`/`sanitizedProps`
+ *   type, which typically has these props `Omit<>`'d out of it already — the whole point of
+ *   `UNSUPPORTED_PROPS` is to still catch them at runtime. Type `UNSUPPORTED_PROPS` itself
+ *   against the underlying library's full props type instead, e.g.
+ *   `as const satisfies readonly (keyof MantineButtonProps)[]`.
+ * @returns `props` with every key in `unsupportedProps` removed
+ */
+export declare function omitUnsupportedProps<T extends Record<string, unknown>>(props: T, unsupportedProps: readonly PropertyKey[]): Partial<T>;
+
 export declare const Pagination: typeof rawComponents.Pagination;
 
 declare const _Pagination: default_2.ForwardRefExoticComponent<PaginationProps & default_2.RefAttributes<HTMLDivElement>>;
@@ -1245,7 +1305,7 @@ export declare const Popover: typeof rawComponents.Popover;
 declare const Popover_2: PopoverComponent;
 
 declare const PopoverBase: {
-    ({ overStyled, withBeak, ...rest }: PopoverProps): JSX.Element;
+    ({ overStyled, withBeak, position, ...rest }: PopoverProps): JSX.Element;
     displayName: string;
 };
 
@@ -1401,6 +1461,7 @@ declare namespace rawComponents {
         Menu_2 as Menu,
         ModalProps,
         ModalFooterProps,
+        ModalBodyProps,
         ModalRootProps,
         ModalOverlayProps,
         ModalContentProps,
@@ -3087,7 +3148,7 @@ export declare const Tooltip: typeof rawComponents.Tooltip;
 declare const Tooltip_2: TooltipComponent;
 
 declare const TooltipBase: {
-    ({ overStyled, withBeak, ...rest }: TooltipProps): JSX.Element;
+    ({ overStyled, withBeak, position, arrowSize, ...rest }: TooltipProps): JSX.Element;
     displayName: string;
 };
 
@@ -3149,6 +3210,23 @@ declare type TreeProps = RecursicaOverStyled<RecursicaTreeProps & Omit<default_2
  */
 export declare function useGlobalOverStyled(): boolean;
 
+/**
+ * withCallerOverride
+ *
+ * Resolves a single prop where Recursica supplies a default but the caller should be able to
+ * override it. Use this only when the default can't be expressed as a plain destructured default
+ * (`const { variant = "solid" } = props`) — e.g. the default is computed from other props/state
+ * inside the component body, so it isn't known until after `rest` has already been destructured.
+ *
+ * Do not rely on spread order for this (`{...sanitizedProps, ...overrides}` never carries this
+ * intent implicitly) — resolve the value explicitly and place the result in `overrides`.
+ *
+ * @param ourDefault - The value Recursica falls back to when the caller didn't supply one
+ * @param callerValue - The raw value from the caller's props, if any
+ * @returns `callerValue` if defined, else `ourDefault`
+ */
+export declare function withCallerOverride<T>(ourDefault: T, callerValue: T | undefined): T;
+
 /**
  * Universal execution barrier trapping readOnly states globally.
  * Natively delegates active logic down avoiding duplicative internal component bindings dynamically.