npm - @mantine-vue/core - Versions diffs - 2.4.0 → 3.1.0 - Mend

@mantine-vue/core 2.4.0 → 3.1.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (871) hide show

package/lib/core/MantineProvider/MantineProvider.d.ts CHANGED Viewed

@@ -157,19 +157,19 @@ export declare const MantineProvider: import("vue").DefineComponent<import("vue"
         colors?: {
             [x: string & {}]: readonly [(string | undefined)?, (string | undefined)?, (string | undefined)?, (string | undefined)?, (string | undefined)?, (string | undefined)?, (string | undefined)?, (string | undefined)?, (string | undefined)?, (string | undefined)?, ...(string | undefined)[]] | undefined;
             dark?: readonly [(string | undefined)?, (string | undefined)?, (string | undefined)?, (string | undefined)?, (string | undefined)?, (string | undefined)?, (string | undefined)?, (string | undefined)?, (string | undefined)?, (string | undefined)?, ...(string | undefined)[]] | undefined;
-            gray?: readonly [(string | undefined)?, (string | undefined)?, (string | undefined)?, (string | undefined)?, (string | undefined)?, (string | undefined)?, (string | undefined)?, (string | undefined)?, (string | undefined)?, (string | undefined)?, ...(string | undefined)[]] | undefined;
-            red?: readonly [(string | undefined)?, (string | undefined)?, (string | undefined)?, (string | undefined)?, (string | undefined)?, (string | undefined)?, (string | undefined)?, (string | undefined)?, (string | undefined)?, (string | undefined)?, ...(string | undefined)[]] | undefined;
-            pink?: readonly [(string | undefined)?, (string | undefined)?, (string | undefined)?, (string | undefined)?, (string | undefined)?, (string | undefined)?, (string | undefined)?, (string | undefined)?, (string | undefined)?, (string | undefined)?, ...(string | undefined)[]] | undefined;
-            grape?: readonly [(string | undefined)?, (string | undefined)?, (string | undefined)?, (string | undefined)?, (string | undefined)?, (string | undefined)?, (string | undefined)?, (string | undefined)?, (string | undefined)?, (string | undefined)?, ...(string | undefined)[]] | undefined;
-            violet?: readonly [(string | undefined)?, (string | undefined)?, (string | undefined)?, (string | undefined)?, (string | undefined)?, (string | undefined)?, (string | undefined)?, (string | undefined)?, (string | undefined)?, (string | undefined)?, ...(string | undefined)[]] | undefined;
-            indigo?: readonly [(string | undefined)?, (string | undefined)?, (string | undefined)?, (string | undefined)?, (string | undefined)?, (string | undefined)?, (string | undefined)?, (string | undefined)?, (string | undefined)?, (string | undefined)?, ...(string | undefined)[]] | undefined;
             blue?: readonly [(string | undefined)?, (string | undefined)?, (string | undefined)?, (string | undefined)?, (string | undefined)?, (string | undefined)?, (string | undefined)?, (string | undefined)?, (string | undefined)?, (string | undefined)?, ...(string | undefined)[]] | undefined;
             cyan?: readonly [(string | undefined)?, (string | undefined)?, (string | undefined)?, (string | undefined)?, (string | undefined)?, (string | undefined)?, (string | undefined)?, (string | undefined)?, (string | undefined)?, (string | undefined)?, ...(string | undefined)[]] | undefined;
+            gray?: readonly [(string | undefined)?, (string | undefined)?, (string | undefined)?, (string | undefined)?, (string | undefined)?, (string | undefined)?, (string | undefined)?, (string | undefined)?, (string | undefined)?, (string | undefined)?, ...(string | undefined)[]] | undefined;
             green?: readonly [(string | undefined)?, (string | undefined)?, (string | undefined)?, (string | undefined)?, (string | undefined)?, (string | undefined)?, (string | undefined)?, (string | undefined)?, (string | undefined)?, (string | undefined)?, ...(string | undefined)[]] | undefined;
+            indigo?: readonly [(string | undefined)?, (string | undefined)?, (string | undefined)?, (string | undefined)?, (string | undefined)?, (string | undefined)?, (string | undefined)?, (string | undefined)?, (string | undefined)?, (string | undefined)?, ...(string | undefined)[]] | undefined;
             lime?: readonly [(string | undefined)?, (string | undefined)?, (string | undefined)?, (string | undefined)?, (string | undefined)?, (string | undefined)?, (string | undefined)?, (string | undefined)?, (string | undefined)?, (string | undefined)?, ...(string | undefined)[]] | undefined;
-            yellow?: readonly [(string | undefined)?, (string | undefined)?, (string | undefined)?, (string | undefined)?, (string | undefined)?, (string | undefined)?, (string | undefined)?, (string | undefined)?, (string | undefined)?, (string | undefined)?, ...(string | undefined)[]] | undefined;
             orange?: readonly [(string | undefined)?, (string | undefined)?, (string | undefined)?, (string | undefined)?, (string | undefined)?, (string | undefined)?, (string | undefined)?, (string | undefined)?, (string | undefined)?, (string | undefined)?, ...(string | undefined)[]] | undefined;
+            pink?: readonly [(string | undefined)?, (string | undefined)?, (string | undefined)?, (string | undefined)?, (string | undefined)?, (string | undefined)?, (string | undefined)?, (string | undefined)?, (string | undefined)?, (string | undefined)?, ...(string | undefined)[]] | undefined;
+            red?: readonly [(string | undefined)?, (string | undefined)?, (string | undefined)?, (string | undefined)?, (string | undefined)?, (string | undefined)?, (string | undefined)?, (string | undefined)?, (string | undefined)?, (string | undefined)?, ...(string | undefined)[]] | undefined;
             teal?: readonly [(string | undefined)?, (string | undefined)?, (string | undefined)?, (string | undefined)?, (string | undefined)?, (string | undefined)?, (string | undefined)?, (string | undefined)?, (string | undefined)?, (string | undefined)?, ...(string | undefined)[]] | undefined;
+            violet?: readonly [(string | undefined)?, (string | undefined)?, (string | undefined)?, (string | undefined)?, (string | undefined)?, (string | undefined)?, (string | undefined)?, (string | undefined)?, (string | undefined)?, (string | undefined)?, ...(string | undefined)[]] | undefined;
+            yellow?: readonly [(string | undefined)?, (string | undefined)?, (string | undefined)?, (string | undefined)?, (string | undefined)?, (string | undefined)?, (string | undefined)?, (string | undefined)?, (string | undefined)?, (string | undefined)?, ...(string | undefined)[]] | undefined;
+            grape?: readonly [(string | undefined)?, (string | undefined)?, (string | undefined)?, (string | undefined)?, (string | undefined)?, (string | undefined)?, (string | undefined)?, (string | undefined)?, (string | undefined)?, (string | undefined)?, ...(string | undefined)[]] | undefined;
         } | undefined;
         primaryShade?: import("./theme.types").MantineColorShade | {
             light?: import("./theme.types").MantineColorShade | undefined;
@@ -184,7 +184,7 @@ export declare const MantineProvider: import("vue").DefineComponent<import("vue"
         headings?: {
             fontFamily?: string | undefined;
             fontWeight?: string | undefined;
-            textWrap?: "wrap" | "nowrap" | "balance" | "pretty" | "stable" | undefined;
+            textWrap?: "balance" | "nowrap" | "wrap" | "stable" | "pretty" | undefined;
             sizes?: {
                 h1?: {
                     fontSize?: string | undefined;
@@ -357,7 +357,7 @@ export declare const MantineProvider: import("vue").DefineComponent<import("vue"
         } | undefined;
     };
     defaultColorScheme: MantineColorScheme;
-    forceColorScheme: "light" | "dark";
+    forceColorScheme: "dark" | "light";
     cssVariablesSelector: string;
     withCssVariables: boolean;
     deduplicateCssVariables: boolean;
@@ -369,7 +369,7 @@ export declare const MantineProvider: import("vue").DefineComponent<import("vue"
     withGlobalClasses: boolean;
     stylesTransform: MantineStylesTransform;
     deduplicateInlineStyles: boolean;
-    env: "default" | "test";
+    env: "test" | "default";
 }, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
 export declare const HeadlessMantineProvider: import("vue").DefineComponent<import("vue").ExtractPropTypes<{
     theme: {
@@ -401,19 +401,19 @@ export declare const HeadlessMantineProvider: import("vue").DefineComponent<impo
         colors?: {
             [x: string & {}]: readonly [(string | undefined)?, (string | undefined)?, (string | undefined)?, (string | undefined)?, (string | undefined)?, (string | undefined)?, (string | undefined)?, (string | undefined)?, (string | undefined)?, (string | undefined)?, ...(string | undefined)[]] | undefined;
             dark?: readonly [(string | undefined)?, (string | undefined)?, (string | undefined)?, (string | undefined)?, (string | undefined)?, (string | undefined)?, (string | undefined)?, (string | undefined)?, (string | undefined)?, (string | undefined)?, ...(string | undefined)[]] | undefined;
-            gray?: readonly [(string | undefined)?, (string | undefined)?, (string | undefined)?, (string | undefined)?, (string | undefined)?, (string | undefined)?, (string | undefined)?, (string | undefined)?, (string | undefined)?, (string | undefined)?, ...(string | undefined)[]] | undefined;
-            red?: readonly [(string | undefined)?, (string | undefined)?, (string | undefined)?, (string | undefined)?, (string | undefined)?, (string | undefined)?, (string | undefined)?, (string | undefined)?, (string | undefined)?, (string | undefined)?, ...(string | undefined)[]] | undefined;
-            pink?: readonly [(string | undefined)?, (string | undefined)?, (string | undefined)?, (string | undefined)?, (string | undefined)?, (string | undefined)?, (string | undefined)?, (string | undefined)?, (string | undefined)?, (string | undefined)?, ...(string | undefined)[]] | undefined;
-            grape?: readonly [(string | undefined)?, (string | undefined)?, (string | undefined)?, (string | undefined)?, (string | undefined)?, (string | undefined)?, (string | undefined)?, (string | undefined)?, (string | undefined)?, (string | undefined)?, ...(string | undefined)[]] | undefined;
-            violet?: readonly [(string | undefined)?, (string | undefined)?, (string | undefined)?, (string | undefined)?, (string | undefined)?, (string | undefined)?, (string | undefined)?, (string | undefined)?, (string | undefined)?, (string | undefined)?, ...(string | undefined)[]] | undefined;
-            indigo?: readonly [(string | undefined)?, (string | undefined)?, (string | undefined)?, (string | undefined)?, (string | undefined)?, (string | undefined)?, (string | undefined)?, (string | undefined)?, (string | undefined)?, (string | undefined)?, ...(string | undefined)[]] | undefined;
             blue?: readonly [(string | undefined)?, (string | undefined)?, (string | undefined)?, (string | undefined)?, (string | undefined)?, (string | undefined)?, (string | undefined)?, (string | undefined)?, (string | undefined)?, (string | undefined)?, ...(string | undefined)[]] | undefined;
             cyan?: readonly [(string | undefined)?, (string | undefined)?, (string | undefined)?, (string | undefined)?, (string | undefined)?, (string | undefined)?, (string | undefined)?, (string | undefined)?, (string | undefined)?, (string | undefined)?, ...(string | undefined)[]] | undefined;
+            gray?: readonly [(string | undefined)?, (string | undefined)?, (string | undefined)?, (string | undefined)?, (string | undefined)?, (string | undefined)?, (string | undefined)?, (string | undefined)?, (string | undefined)?, (string | undefined)?, ...(string | undefined)[]] | undefined;
             green?: readonly [(string | undefined)?, (string | undefined)?, (string | undefined)?, (string | undefined)?, (string | undefined)?, (string | undefined)?, (string | undefined)?, (string | undefined)?, (string | undefined)?, (string | undefined)?, ...(string | undefined)[]] | undefined;
+            indigo?: readonly [(string | undefined)?, (string | undefined)?, (string | undefined)?, (string | undefined)?, (string | undefined)?, (string | undefined)?, (string | undefined)?, (string | undefined)?, (string | undefined)?, (string | undefined)?, ...(string | undefined)[]] | undefined;
             lime?: readonly [(string | undefined)?, (string | undefined)?, (string | undefined)?, (string | undefined)?, (string | undefined)?, (string | undefined)?, (string | undefined)?, (string | undefined)?, (string | undefined)?, (string | undefined)?, ...(string | undefined)[]] | undefined;
-            yellow?: readonly [(string | undefined)?, (string | undefined)?, (string | undefined)?, (string | undefined)?, (string | undefined)?, (string | undefined)?, (string | undefined)?, (string | undefined)?, (string | undefined)?, (string | undefined)?, ...(string | undefined)[]] | undefined;
             orange?: readonly [(string | undefined)?, (string | undefined)?, (string | undefined)?, (string | undefined)?, (string | undefined)?, (string | undefined)?, (string | undefined)?, (string | undefined)?, (string | undefined)?, (string | undefined)?, ...(string | undefined)[]] | undefined;
+            pink?: readonly [(string | undefined)?, (string | undefined)?, (string | undefined)?, (string | undefined)?, (string | undefined)?, (string | undefined)?, (string | undefined)?, (string | undefined)?, (string | undefined)?, (string | undefined)?, ...(string | undefined)[]] | undefined;
+            red?: readonly [(string | undefined)?, (string | undefined)?, (string | undefined)?, (string | undefined)?, (string | undefined)?, (string | undefined)?, (string | undefined)?, (string | undefined)?, (string | undefined)?, (string | undefined)?, ...(string | undefined)[]] | undefined;
             teal?: readonly [(string | undefined)?, (string | undefined)?, (string | undefined)?, (string | undefined)?, (string | undefined)?, (string | undefined)?, (string | undefined)?, (string | undefined)?, (string | undefined)?, (string | undefined)?, ...(string | undefined)[]] | undefined;
+            violet?: readonly [(string | undefined)?, (string | undefined)?, (string | undefined)?, (string | undefined)?, (string | undefined)?, (string | undefined)?, (string | undefined)?, (string | undefined)?, (string | undefined)?, (string | undefined)?, ...(string | undefined)[]] | undefined;
+            yellow?: readonly [(string | undefined)?, (string | undefined)?, (string | undefined)?, (string | undefined)?, (string | undefined)?, (string | undefined)?, (string | undefined)?, (string | undefined)?, (string | undefined)?, (string | undefined)?, ...(string | undefined)[]] | undefined;
+            grape?: readonly [(string | undefined)?, (string | undefined)?, (string | undefined)?, (string | undefined)?, (string | undefined)?, (string | undefined)?, (string | undefined)?, (string | undefined)?, (string | undefined)?, (string | undefined)?, ...(string | undefined)[]] | undefined;
         } | undefined;
         primaryShade?: import("./theme.types").MantineColorShade | {
             light?: import("./theme.types").MantineColorShade | undefined;
@@ -428,7 +428,7 @@ export declare const HeadlessMantineProvider: import("vue").DefineComponent<impo
         headings?: {
             fontFamily?: string | undefined;
             fontWeight?: string | undefined;
-            textWrap?: "wrap" | "nowrap" | "balance" | "pretty" | "stable" | undefined;
+            textWrap?: "balance" | "nowrap" | "wrap" | "stable" | "pretty" | undefined;
             sizes?: {
                 h1?: {
                     fontSize?: string | undefined;
@@ -600,7 +600,7 @@ export declare const HeadlessMantineProvider: import("vue").DefineComponent<impo
             [x: string]: any;
         } | undefined;
     };
-    env: "default" | "test";
+    env: "test" | "default";
 }, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
 export declare const MantineCssVariables: import("vue").DefineComponent<{}, () => import("vue").VNode<import("vue").RendererNode, import("vue").RendererElement, {
     [key: string]: any;

package/lib/core/MantineProvider/MantineThemeProvider.d.ts CHANGED Viewed

@@ -23,6 +23,7 @@ export declare const MantineThemeProvider: import("vue").DefineComponent<import(
         default: undefined;
     };
 }>> & Readonly<{}>, {
+    inherit: boolean;
     theme: {
         focusRing?: "auto" | "always" | "never" | undefined;
         scale?: number | undefined;
@@ -32,19 +33,19 @@ export declare const MantineThemeProvider: import("vue").DefineComponent<import(
         colors?: {
             [x: string & {}]: readonly [(string | undefined)?, (string | undefined)?, (string | undefined)?, (string | undefined)?, (string | undefined)?, (string | undefined)?, (string | undefined)?, (string | undefined)?, (string | undefined)?, (string | undefined)?, ...(string | undefined)[]] | undefined;
             dark?: readonly [(string | undefined)?, (string | undefined)?, (string | undefined)?, (string | undefined)?, (string | undefined)?, (string | undefined)?, (string | undefined)?, (string | undefined)?, (string | undefined)?, (string | undefined)?, ...(string | undefined)[]] | undefined;
-            gray?: readonly [(string | undefined)?, (string | undefined)?, (string | undefined)?, (string | undefined)?, (string | undefined)?, (string | undefined)?, (string | undefined)?, (string | undefined)?, (string | undefined)?, (string | undefined)?, ...(string | undefined)[]] | undefined;
-            red?: readonly [(string | undefined)?, (string | undefined)?, (string | undefined)?, (string | undefined)?, (string | undefined)?, (string | undefined)?, (string | undefined)?, (string | undefined)?, (string | undefined)?, (string | undefined)?, ...(string | undefined)[]] | undefined;
-            pink?: readonly [(string | undefined)?, (string | undefined)?, (string | undefined)?, (string | undefined)?, (string | undefined)?, (string | undefined)?, (string | undefined)?, (string | undefined)?, (string | undefined)?, (string | undefined)?, ...(string | undefined)[]] | undefined;
-            grape?: readonly [(string | undefined)?, (string | undefined)?, (string | undefined)?, (string | undefined)?, (string | undefined)?, (string | undefined)?, (string | undefined)?, (string | undefined)?, (string | undefined)?, (string | undefined)?, ...(string | undefined)[]] | undefined;
-            violet?: readonly [(string | undefined)?, (string | undefined)?, (string | undefined)?, (string | undefined)?, (string | undefined)?, (string | undefined)?, (string | undefined)?, (string | undefined)?, (string | undefined)?, (string | undefined)?, ...(string | undefined)[]] | undefined;
-            indigo?: readonly [(string | undefined)?, (string | undefined)?, (string | undefined)?, (string | undefined)?, (string | undefined)?, (string | undefined)?, (string | undefined)?, (string | undefined)?, (string | undefined)?, (string | undefined)?, ...(string | undefined)[]] | undefined;
             blue?: readonly [(string | undefined)?, (string | undefined)?, (string | undefined)?, (string | undefined)?, (string | undefined)?, (string | undefined)?, (string | undefined)?, (string | undefined)?, (string | undefined)?, (string | undefined)?, ...(string | undefined)[]] | undefined;
             cyan?: readonly [(string | undefined)?, (string | undefined)?, (string | undefined)?, (string | undefined)?, (string | undefined)?, (string | undefined)?, (string | undefined)?, (string | undefined)?, (string | undefined)?, (string | undefined)?, ...(string | undefined)[]] | undefined;
+            gray?: readonly [(string | undefined)?, (string | undefined)?, (string | undefined)?, (string | undefined)?, (string | undefined)?, (string | undefined)?, (string | undefined)?, (string | undefined)?, (string | undefined)?, (string | undefined)?, ...(string | undefined)[]] | undefined;
             green?: readonly [(string | undefined)?, (string | undefined)?, (string | undefined)?, (string | undefined)?, (string | undefined)?, (string | undefined)?, (string | undefined)?, (string | undefined)?, (string | undefined)?, (string | undefined)?, ...(string | undefined)[]] | undefined;
+            indigo?: readonly [(string | undefined)?, (string | undefined)?, (string | undefined)?, (string | undefined)?, (string | undefined)?, (string | undefined)?, (string | undefined)?, (string | undefined)?, (string | undefined)?, (string | undefined)?, ...(string | undefined)[]] | undefined;
             lime?: readonly [(string | undefined)?, (string | undefined)?, (string | undefined)?, (string | undefined)?, (string | undefined)?, (string | undefined)?, (string | undefined)?, (string | undefined)?, (string | undefined)?, (string | undefined)?, ...(string | undefined)[]] | undefined;
-            yellow?: readonly [(string | undefined)?, (string | undefined)?, (string | undefined)?, (string | undefined)?, (string | undefined)?, (string | undefined)?, (string | undefined)?, (string | undefined)?, (string | undefined)?, (string | undefined)?, ...(string | undefined)[]] | undefined;
             orange?: readonly [(string | undefined)?, (string | undefined)?, (string | undefined)?, (string | undefined)?, (string | undefined)?, (string | undefined)?, (string | undefined)?, (string | undefined)?, (string | undefined)?, (string | undefined)?, ...(string | undefined)[]] | undefined;
+            pink?: readonly [(string | undefined)?, (string | undefined)?, (string | undefined)?, (string | undefined)?, (string | undefined)?, (string | undefined)?, (string | undefined)?, (string | undefined)?, (string | undefined)?, (string | undefined)?, ...(string | undefined)[]] | undefined;
+            red?: readonly [(string | undefined)?, (string | undefined)?, (string | undefined)?, (string | undefined)?, (string | undefined)?, (string | undefined)?, (string | undefined)?, (string | undefined)?, (string | undefined)?, (string | undefined)?, ...(string | undefined)[]] | undefined;
             teal?: readonly [(string | undefined)?, (string | undefined)?, (string | undefined)?, (string | undefined)?, (string | undefined)?, (string | undefined)?, (string | undefined)?, (string | undefined)?, (string | undefined)?, (string | undefined)?, ...(string | undefined)[]] | undefined;
+            violet?: readonly [(string | undefined)?, (string | undefined)?, (string | undefined)?, (string | undefined)?, (string | undefined)?, (string | undefined)?, (string | undefined)?, (string | undefined)?, (string | undefined)?, (string | undefined)?, ...(string | undefined)[]] | undefined;
+            yellow?: readonly [(string | undefined)?, (string | undefined)?, (string | undefined)?, (string | undefined)?, (string | undefined)?, (string | undefined)?, (string | undefined)?, (string | undefined)?, (string | undefined)?, (string | undefined)?, ...(string | undefined)[]] | undefined;
+            grape?: readonly [(string | undefined)?, (string | undefined)?, (string | undefined)?, (string | undefined)?, (string | undefined)?, (string | undefined)?, (string | undefined)?, (string | undefined)?, (string | undefined)?, (string | undefined)?, ...(string | undefined)[]] | undefined;
         } | undefined;
         primaryShade?: import("./theme.types").MantineColorShade | {
             light?: import("./theme.types").MantineColorShade | undefined;
@@ -59,7 +60,7 @@ export declare const MantineThemeProvider: import("vue").DefineComponent<import(
         headings?: {
             fontFamily?: string | undefined;
             fontWeight?: string | undefined;
-            textWrap?: "wrap" | "nowrap" | "balance" | "pretty" | "stable" | undefined;
+            textWrap?: "balance" | "nowrap" | "wrap" | "stable" | "pretty" | undefined;
             sizes?: {
                 h1?: {
                     fontSize?: string | undefined;
@@ -231,5 +232,4 @@ export declare const MantineThemeProvider: import("vue").DefineComponent<import(
             [x: string]: any;
         } | undefined;
     };
-    inherit: boolean;
 }, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;

package/lib/core/MantineProvider/use-props.d.ts CHANGED Viewed

@@ -1 +1,14 @@
-export declare function useProps<Props extends Record<string, any>>(component: string, defaultProps: Partial<Props> | null, props: Props): Props;
+/**
+ * Resolves a component's props against the theme.
+ *
+ * Precedence, lowest to highest: `defaultProps` → `theme.components[name].defaultProps`
+ * → the props the consumer actually passed.
+ *
+ * `component` accepts several names so a component can inherit theme defaults from the
+ * components it composes, with later names winning. The input family relies on this:
+ * `Textarea` resolves `['Input', 'InputWrapper', 'Textarea']`, so a theme-level `Input`
+ * default reaches every input unless the specific component overrides it.
+ *
+ * A theme's `defaultProps` may also be a function of the theme.
+ */
+export declare function useProps<Props extends Record<string, any>>(component: string | (string | undefined)[], defaultProps: Partial<Props> | null, props: Props): Props;

package/lib/core/factory/create-factory.d.ts ADDED Viewed

@@ -0,0 +1,3 @@
+import type { FactoryPayload, PolymorphicFactoryPayload } from './factory-payload';
+export type Factory<Payload extends FactoryPayload> = Payload;
+export type PolymorphicFactory<Payload extends PolymorphicFactoryPayload> = Payload;

package/lib/core/factory/create-polymorphic-component.d.ts ADDED Viewed

@@ -0,0 +1,69 @@
+import type { Component, IntrinsicElementAttributes, ReservedProps } from 'vue';
+import type { DataAttributes, EmitsToProps } from './factory-payload';
+import type { RootRefProps } from './factory';
+/** Every value the `component` prop accepts: an intrinsic tag name or a Vue component. */
+export type MantineElementType = keyof IntrinsicElementAttributes | Component;
+/**
+ * Neutral element for the prop intersections in this module.
+ *
+ * `unknown` because `T & unknown` reduces to exactly `T`. Not `Record<string, never>`, which
+ * would intersect every prop down to `never`.
+ */
+export type EmptyProps = unknown;
+/** Props contributed by the value passed to `component`. */
+export type PropsOf<C> = C extends keyof IntrinsicElementAttributes ? IntrinsicElementAttributes[C] : C extends abstract new (...args: any[]) => {
+    $props: infer Props;
+} ? Props : C extends (props: infer Props, ...args: any[]) => any ? Props : EmptyProps;
+/**
+ * Lets a polymorphic component's payload and default root be recovered from its type alone,
+ * which TypeScript cannot otherwise do because it cannot read a type parameter's default.
+ *
+ * Without this, `PropsOf<typeof Button>` resolves at the constraint (`MantineElementType`),
+ * whose functional-component member infers props as `any`, collapsing the whole result to `any`
+ * and silently accepting every invalid prop. Never present at runtime.
+ *
+ * @internal
+ */
+export declare const MANTINE_PAYLOAD: unique symbol;
+export interface PolymorphicMarker<Payload, Default> {
+    /** @internal type-only, never assigned */
+    readonly [MANTINE_PAYLOAD]?: {
+        payload: Payload;
+        default: Default;
+    };
+}
+/**
+ * Public props of any component, polymorphic or not.
+ *
+ * Replaces `InstanceType<typeof Component>['$props']`, which cannot work for polymorphic
+ * components. Pass `Root` to resolve against a root other than the default.
+ */
+export type ComponentProps<C, Root = void> = C extends PolymorphicMarker<infer Payload, infer Default> ? Payload extends {
+    props: any;
+    emits?: infer Emits;
+} ? // `RootRefProps` is part of the call signature (`PolymorphicProps`), so it belongs here
+PolymorphicComponentProps<Root extends void ? Default : Root, Payload['props'] & EmitsToProps<Emits>> & RootRefProps<PolymorphicRef<Root extends void ? Default : Root>> : PropsOf<C> : C extends abstract new (...args: any[]) => {
+    $props: infer Props;
+} ? Props : PropsOf<C>;
+/** The DOM node the root resolves to: `HTMLAnchorElement` for `'a'`, `Element` otherwise. */
+export type PolymorphicRef<C> = C extends keyof HTMLElementTagNameMap ? HTMLElementTagNameMap[C] : Element;
+/**
+ * Props of a polymorphic component for a given root `C`.
+ *
+ * `Props` is subtracted from the root's props, so a Mantine prop wins over a conflicting root
+ * prop of the same name. `ReservedProps` is added unconditionally, without which
+ * `<Button ref="el" />` would be rejected once `strictTemplates` is enabled.
+ */
+export type PolymorphicComponentProps<C, Props = EmptyProps> = Props & Omit<PropsOf<C>, keyof Props> & DataAttributes & ReservedProps & {
+    /**
+     * Root element or component rendered by this component.
+     *
+     * Accepts an intrinsic tag name (`component="a"`) or a Vue component
+     * (`:component="RouterLink"`). Props of the selected root are inferred and type-checked
+     * alongside the component's own props.
+     */
+    component?: C;
+};
+/** Casts an existing implementation to a polymorphic component type. */
+export declare function createPolymorphicComponent<ComponentDefaultType extends MantineElementType, Props, Statics = Record<string, never>>(component: unknown): (<C extends MantineElementType = ComponentDefaultType>(props: PolymorphicComponentProps<C, Props>) => unknown) & Statics;
+export declare const polymorphic: typeof createPolymorphicComponent;

package/lib/core/factory/factory-payload.d.ts ADDED Viewed

@@ -0,0 +1,73 @@
+import type { IntrinsicElementAttributes, ReservedProps } from 'vue';
+import type { EmptyProps, MantineElementType } from './create-polymorphic-component';
+/** `data-*` attributes, which are always permitted alongside a component's own props. */
+export type DataAttributes = Record<`data-${string}`, any>;
+/** Describes the public types and metadata used to construct a factory component. */
+export interface FactoryPayload {
+    /** The component's full public props interface, including `BoxProps` when supported. */
+    props: Record<string, any>;
+    /** Slots, in `defineSlots` shape: `{ default?: () => VNodeChild }`. */
+    slots?: Record<string, any>;
+    /**
+     * Emitted events, in either shape `defineEmits` accepts: `{ error: [event: Event] }` or
+     * `{ error: (event: Event) => void }`.
+     *
+     * The overloaded call-signature form is not supported -- TypeScript cannot map over
+     * overloads, so every event but the last would be silently dropped.
+     */
+    emits?: Record<string, any>;
+    /** Members made available through `defineExpose`, reachable via a template `ref`. */
+    exposed?: Record<string, any>;
+    /**
+     * Extra context the Styles API resolvers receive as their third argument, for components whose
+     * classes or CSS variables depend on state rather than props alone
+     */
+    ctx?: Record<string, any>;
+    /** The DOM node the component's root resolves to. */
+    ref?: any;
+    /**
+     * Intrinsic tag the root renders, for non-polymorphic components. Contributes that element's
+     * native attributes and event handlers.
+     */
+    element?: keyof IntrinsicElementAttributes;
+    /** Union of Styles API selectors, for example `'root' | 'label'`. */
+    stylesNames?: string;
+    /** Maps each style name to the CSS variables set on it. */
+    vars?: Record<string, any>;
+    /** Union of supported `variant` values. */
+    variant?: string;
+    /** Compound components exposed as statics, for example `{ Group: typeof ButtonGroup }`. */
+    staticComponents?: Record<string, any>;
+    /** Marks a compound component, whose `extend` accepts only `defaultProps`. */
+    compound?: boolean;
+}
+/** A payload for a polymorphic component, which additionally declares its default root. */
+export interface PolymorphicFactoryPayload extends FactoryPayload {
+    /** Root rendered when `component` is not set. */
+    defaultComponent: MantineElementType;
+    /** DOM node the default root resolves to. */
+    defaultRef: any;
+}
+/**
+ * Turns a payload's `emits` into the `onEvent` props Vue exposes, handling both `defineEmits`
+ * shapes. `Capitalize` also yields the right `v-model` name, so `{ 'update:opened': [boolean] }`
+ * becomes `{ 'onUpdate:opened'?: … }`.
+ */
+export type EmitsToProps<Emits> = Emits extends object ? {
+    [Key in keyof Emits & string as `on${Capitalize<Key>}`]?: Emits[Key] extends any[] ? (...args: Emits[Key]) => void : Emits[Key];
+} : EmptyProps;
+/**
+ * Native attributes contributed by a payload's `element`.
+ *
+ * Anything the component already declares is subtracted, so its own `onChange` wins over the
+ * DOM's. Without the subtraction the two intersect into an uncallable signature.
+ */
+export type ElementAttributes<Element, Declared> = Element extends keyof IntrinsicElementAttributes ? Omit<IntrinsicElementAttributes[Element], keyof Declared> : EmptyProps;
+/**
+ * The full public props of a non-polymorphic factory component.
+ *
+ * `DataAttributes` is part of the contract because `data-*` is valid on every element and Vue's
+ * `IntrinsicElementAttributes` does not model it. Without it, `:data-active="…"` on a factory
+ * component is rejected under `strictTemplates` even though the DOM accepts it.
+ */
+export type FactoryComponentProps<Payload extends FactoryPayload> = Payload['props'] & EmitsToProps<Payload['emits']> & ElementAttributes<Payload['element'], Payload['props'] & EmitsToProps<Payload['emits']>> & DataAttributes & ReservedProps;

package/lib/core/factory/factory-styles-api.d.ts ADDED Viewed

@@ -0,0 +1,39 @@
+import type { CSSProperties } from 'vue';
+import type { MantineTheme } from '../MantineProvider';
+import type { FactoryPayload } from './factory-payload';
+/** Any CSS custom property name. */
+export type CssVariable = `--${string}`;
+/** The style names a payload declares, or any string when it declares none. */
+export type StylesNamesOf<Payload extends FactoryPayload> = Payload['stylesNames'] extends string ? Payload['stylesNames'] : string;
+export type StylesRecord<StylesNames extends string, Value> = Partial<Record<StylesNames, Value>>;
+/**
+ * A `classNames`/`styles` value keyed by the payload's style names.
+ *
+ * Compound components resolve to the static record only: they cannot take a function,
+ * because they are configured through their parent's Styles API rather than their own.
+ *
+ */
+export type StylesApiRecord<Payload extends FactoryPayload, Value> = Payload['compound'] extends true ? StylesRecord<StylesNamesOf<Payload>, Value> : StylesRecord<StylesNamesOf<Payload>, Value> | ((theme: MantineTheme, props: Payload['props'], ctx: Record<string, any>) => StylesRecord<StylesNamesOf<Payload>, Value>);
+export type FactoryClassNames<Payload extends FactoryPayload> = StylesApiRecord<Payload, string>;
+export type FactoryStyles<Payload extends FactoryPayload> = StylesApiRecord<Payload, CSSProperties>;
+/** Maps a payload's `vars` description onto the record a resolver must return. */
+export type TransformVars<Vars> = {
+    [Key in keyof Vars]: Vars[Key] extends CssVariable ? Record<Vars[Key], string | undefined> : never;
+};
+export type PartialTransformVars<Vars> = {
+    [Key in keyof Vars]: Vars[Key] extends CssVariable ? Partial<Record<Vars[Key], string | undefined>> : never;
+};
+export type FactoryVarsResolver<Payload extends FactoryPayload> = (theme: MantineTheme, props: Payload['props'], ctx: Record<string, any>) => TransformVars<Payload['vars']>;
+export type FactoryPartialVarsResolver<Payload extends FactoryPayload> = (theme: MantineTheme, props: Payload['props'], ctx: Record<string, any>) => PartialTransformVars<Payload['vars']>;
+/**
+ * The `vars` prop stays resolver-only, matching upstream.
+ *
+ * `useStyles` would also accept a plain record, and `classNames`/`styles` do -- but adding the
+ * record form here means mapping `Payload['vars']` in a *union* member rather than in a function's
+ * return position. Return positions are evaluated lazily; a union member is not, so the components
+ * still on the legacy props-keyed form (`vars?: Vars<XProps>` declared inside `XProps`) become
+ * circular, and several others blow the instantiation depth limit.
+ *
+ * Callers needing an arbitrary custom property should bind it through `style`, which is where
+ * upstream's `__vars` escape hatch ends up anyway.
+ */

package/lib/core/factory/factory.d.ts CHANGED Viewed

@@ -1,28 +1,88 @@
-import { type PropType } from 'vue';
-export interface VueFactoryPayload<Props extends Record<string, any> = Record<string, any>> {
-    name: string;
-    props?: Record<string, any>;
-    setup: (props: Props, ctx: {
-        attrs: Record<string, unknown>;
-        slots: any;
-        emit: any;
-        ref: any;
-    }) => any;
+import { type Component, type DefineSetupFnComponent, type SlotsType } from 'vue';
+import type { VueRefTarget } from '@mantine-vue/hooks';
+import type { MantineThemeComponent } from '../MantineProvider';
+import type { EmptyProps } from './create-polymorphic-component';
+import type { DataAttributes, FactoryComponentProps, FactoryPayload } from './factory-payload';
+import type { FactoryClassNames, FactoryPartialVarsResolver, FactoryStyles, FactoryVarsResolver, StylesNamesOf } from './factory-styles-api';
+/**
+ * Receives the component's root DOM node, since a template `ref` on a component resolves to
+ * that component's instance and Vue offers no supported way to change it.
+ *
+ * Use the callback form in templates -- Vue unwraps refs when binding, so `:rootRef="el"` would
+ * pass the element rather than the ref object. A ref object works from `h()`. The node is also
+ * exposed as `rootElement`. See the polymorphic components guide.
+ */
+export type RootRefProp<Element> = VueRefTarget<Element>;
+export interface RootRefProps<Element> {
+    /** Receives the component's root DOM node. See `RootRefProp`. */
+    rootRef?: RootRefProp<Element>;
 }
-export declare function factory<Props extends Record<string, any>>(payload: VueFactoryPayload<Props>): import("vue").DefineComponent<{}, () => any, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<{}> & Readonly<{}>, {
-    [x: string]: any;
-}, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
-export interface FactoryBoxProps {
-    component?: string;
-    class?: any;
-    style?: any;
+/** `extend` input for a compound component: only `defaultProps` */
+export interface ExtendCompoundComponent<Payload extends FactoryPayload> {
+    defaultProps?: Partial<Payload['props']> & DataAttributes;
 }
-export declare const polymorphicProps: {
-    component: {
-        type: PropType<string>;
-        default: undefined;
+/** `extend` input for a root component: default props plus full Styles API configuration. */
+export interface ExtendsRootComponent<Payload extends FactoryPayload> {
+    defaultProps?: Partial<Payload['props']> & DataAttributes & {
+        component?: any;
     };
+    classNames?: FactoryClassNames<Payload>;
+    styles?: FactoryStyles<Payload>;
+    vars?: FactoryPartialVarsResolver<Payload>;
+}
+export type ExtendComponent<Payload extends FactoryPayload> = Payload['compound'] extends true ? ExtendCompoundComponent<Payload> : ExtendsRootComponent<Payload>;
+export interface ThemeExtend<Payload extends FactoryPayload> {
+    /** Builds a `MantineProvider` theme entry for this component. */
+    extend: (input: ExtendComponent<Payload>) => MantineThemeComponent;
+}
+/**
+ * The component's CSS module classes, keyed by its style names. Resolves to `never` for
+ * components that declare no `stylesNames`, so the property cannot be misused.
+ */
+export type ComponentClasses<Payload extends FactoryPayload> = {
+    classes: Payload['stylesNames'] extends string ? Record<StylesNamesOf<Payload>, string> : never;
 };
-export declare function renderPolymorphic(component: string | undefined, props: Record<string, any>, children?: any): import("vue").VNode<import("vue").RendererNode, import("vue").RendererElement, {
+/** `varsResolver` is exposed only by components that declare CSS variables. */
+export type ComponentVariablesResolver<Payload extends FactoryPayload> = Payload['vars'] extends Record<string, any> ? {
+    varsResolver: FactoryVarsResolver<Payload>;
+} : EmptyProps;
+/**
+ * Compound components spread onto the component as statics.
+ *
+ * Resolves to `EmptyProps` rather than `Record<string, never>` when a payload declares none --
+ * that record's index signature would make `Badge.Section` type-check on any component.
+ */
+export type StaticComponents<Input> = Input extends Record<string, any> ? Input : EmptyProps;
+export interface FactoryComponentWithProps<Payload extends FactoryPayload> {
+    /**
+     * Returns a new component with `props` pre-applied. Props passed by the caller win over
+     * the fixed ones.
+     */
+    withProps: (props: Partial<Payload['props']>) => MantineComponent<Payload>;
+}
+export type MantineComponentStaticProperties<Payload extends FactoryPayload> = ThemeExtend<Payload> & ComponentClasses<Payload> & ComponentVariablesResolver<Payload> & FactoryComponentWithProps<Payload> & StaticComponents<Payload['staticComponents']>;
+type MantineComponentProps<Payload extends FactoryPayload> = FactoryComponentProps<Payload> & RootRefProps<Payload['ref']>;
+type MantineComponentEmits<Payload extends FactoryPayload> = Payload['emits'] extends Record<string, any> ? Payload['emits'] : Record<never, never>;
+type MantineComponentSlots<Payload extends FactoryPayload> = Payload['slots'] extends Record<string, any> ? Payload['slots'] : Record<never, never>;
+type VueMantineComponent<Payload extends FactoryPayload> = DefineSetupFnComponent<MantineComponentProps<Payload>, MantineComponentEmits<Payload>, SlotsType<MantineComponentSlots<Payload>>>;
+/** A factory component compatible with Vue's public instance and `h()` types. */
+export type MantineComponent<Payload extends FactoryPayload> = VueMantineComponent<Payload> & {
+    new (...args: any[]): InstanceType<VueMantineComponent<Payload>> & (Payload['exposed'] extends Record<string, any> ? Payload['exposed'] : EmptyProps);
+} & MantineComponentStaticProperties<Payload>;
+export declare function identity<T>(value: T): T;
+/**
+ * Wraps a component so caller props override a fixed set of props. The wrapper declares no props
+ * of its own, so callers' props arrive in `attrs` and are spread last -- that ordering is what
+ * gives them precedence.
+ */
+export declare function createWithProps(target: Component, statics: Record<string, any>): (fixedProps: Record<string, any>) => import("vue").DefineComponent<{}, () => import("vue").VNode<import("vue").RendererNode, import("vue").RendererElement, {
     [key: string]: any;
-}>;
+}>, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<{}> & Readonly<{}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
+/** Assigns the shared static API onto a component implementation. */
+export declare function attachStatics(ui: Component, statics: Record<string, any> | undefined): Component & Record<string, any>;
+/** Attaches the Mantine static API to a component implementation. */
+export declare function factory<Payload extends FactoryPayload>(ui: Component, statics?: Payload['staticComponents'] & {
+    classes?: Record<string, string>;
+    varsResolver?: unknown;
+}): MantineComponent<Payload>;
+export {};

package/lib/core/factory/index.d.ts CHANGED Viewed

@@ -1,4 +1,10 @@
-export * from './factory';
-export * from './polymorphic-factory';
-export * from './with-box-props';
-export * from './use-forwarded-ref';
+export type { Factory, PolymorphicFactory } from './create-factory';
+export { createPolymorphicComponent, polymorphic } from './create-polymorphic-component';
+export type { ComponentProps, EmptyProps, MantineElementType, PolymorphicComponentProps, PolymorphicMarker, PolymorphicRef, PropsOf, } from './create-polymorphic-component';
+export { createWithProps, factory, identity } from './factory';
+export type { ComponentClasses, ComponentVariablesResolver, ExtendComponent, ExtendCompoundComponent, ExtendsRootComponent, FactoryComponentWithProps, MantineComponent, MantineComponentStaticProperties, RootRefProp, RootRefProps, StaticComponents, ThemeExtend, } from './factory';
+export type { DataAttributes, ElementAttributes, EmitsToProps, FactoryComponentProps, FactoryPayload, PolymorphicFactoryPayload, } from './factory-payload';
+export type { CssVariable, FactoryClassNames, FactoryPartialVarsResolver, FactoryStyles, FactoryVarsResolver, PartialTransformVars, StylesApiRecord, StylesNamesOf, StylesRecord, TransformVars, } from './factory-styles-api';
+export { polymorphicFactory } from './polymorphic-factory';
+export type { MantinePolymorphicComponent, PolymorphicComponentWithProps, PolymorphicProps, } from './polymorphic-factory';
+export { useForwardedRef } from './use-forwarded-ref';

package/lib/core/factory/polymorphic-factory.d.ts CHANGED Viewed

@@ -1 +1,32 @@
-export { factory as polymorphicFactory, renderPolymorphic } from './factory';
+import type { Component, EmitFn } from 'vue';
+import type { MantineElementType, PolymorphicComponentProps, PolymorphicMarker, PolymorphicRef } from './create-polymorphic-component';
+import { type ComponentClasses, type ComponentVariablesResolver, type RootRefProps, type StaticComponents, type ThemeExtend } from './factory';
+import type { EmitsToProps, PolymorphicFactoryPayload } from './factory-payload';
+/**
+ * Full props of a polymorphic component for a given root `C`: the component's own props,
+ * the root's props, emit handlers and the typed `rootRef`.
+ */
+export type PolymorphicProps<C, Payload extends PolymorphicFactoryPayload> = PolymorphicComponentProps<C, Payload['props'] & EmitsToProps<Payload['emits']>> & RootRefProps<PolymorphicRef<C>>;
+export interface PolymorphicComponentWithProps<Payload extends PolymorphicFactoryPayload> {
+    /**
+     * Returns a new component with props pre-applied, keeping polymorphic inference.
+     *
+     * A `component` fixed here becomes the new component's default root, so
+     * `Button.withProps({ component: RouterLink })` yields a component that accepts
+     * `RouterLink`'s props. Props passed by the caller win over the fixed ones.
+     */
+    withProps: <Fixed extends MantineElementType = Payload['defaultComponent']>(fixedProps: PolymorphicProps<Fixed, Payload>) => MantinePolymorphicComponent<Payload, Fixed>;
+}
+/**
+ * Generic function component used to infer the root from `component`. Slots and Vue's `EmitFn`
+ * are declared on the context parameter to remain compatible with `FunctionalComponent`.
+ */
+export type MantinePolymorphicComponent<Payload extends PolymorphicFactoryPayload, Default extends MantineElementType = Payload['defaultComponent']> = (<C extends MantineElementType = Default>(props: PolymorphicProps<C, Payload>, ctx?: {
+    slots: Payload['slots'];
+    emit: EmitFn<Payload['emits']>;
+}) => unknown) & PolymorphicMarker<Payload, Default> & ThemeExtend<Payload> & ComponentClasses<Payload> & ComponentVariablesResolver<Payload> & PolymorphicComponentWithProps<Payload> & StaticComponents<Payload['staticComponents']>;
+/** Attaches the Mantine static API to a polymorphic component implementation. */
+export declare function polymorphicFactory<Payload extends PolymorphicFactoryPayload>(ui: Component, statics?: Payload['staticComponents'] & {
+    classes?: Record<string, string>;
+    varsResolver?: unknown;
+}): MantinePolymorphicComponent<Payload>;

package/lib/core/factory/use-forwarded-ref.d.ts CHANGED Viewed

@@ -1,39 +1,11 @@
 import { type Ref } from 'vue';
 /**
- * Vue has no built-in equivalent of React's `forwardRef`: a `ref` attached to
- * a component (e.g. `<Button ref="x" />`) always resolves to the component's
- * public instance proxy, never to the DOM node it renders.
+ * Re-targets the `ref` a parent attached to this component so it points at the rendered DOM node
+ * instead of the component instance.
  *
- * This helper reads the `ref` the *parent* attached to the current component
- * instance and keeps it in sync with `elementRef` -- the component's own ref
- * to its rendered root element -- so the parent's ref ends up pointing at the
- * real DOM node instead, matching React Mantine's `factory()` behavior.
- *
- * It relies on a documented-but-internal detail of Vue 3: whenever a `ref`
- * prop is a string, a `Ref`, or a function, Vue normalizes `vnode.ref` into
- * an `{ i, r, k, f }` descriptor before the component ever sees it, where `r`
- * is the original value the parent passed (see `normalizeRef` in
- * `@vue/runtime-core`'s `vnode.ts`). This shape has been stable across Vue
- * 3.x, but it isn't public API, so treat this as a best-effort forwarder --
- * if a future Vue version changes it, this degrades to a no-op (the ref
- * simply won't forward), not a crash.
- *
- * Usage inside a component's `setup()`, once `elementRef` is bound to the
- * component's real root element:
- *
- * ```ts
- * setup(props, { attrs }) {
- *   const elementRef = ref<HTMLDivElement | null>(null)
- *   useForwardedRef(elementRef)
- *   return () => h('div', { ...attrs, ref: elementRef })
- * }
- * ```
- *
- * For multi-layer components (e.g. `Button` renders `UnstyledButton`, which
- * renders `Box`, which renders the native element), every layer needs to
- * call `useForwardedRef` and attach its own `elementRef` to whatever it
- * renders -- each layer intercepts the ref passed by its parent and
- * re-targets it one level down, the same way React's `forwardRef` calls are
- * threaded explicitly through each wrapper.
+ * @deprecated Reads `vnode.ref`'s normalized `{ i, r, k, f }` shape, which is a Vue internal --
+ * best-effort, and degrades to a no-op rather than crashing if Vue changes it. Use the factory's
+ * `rootRef` prop or the exposed `rootElement` instead. Kept only for components not yet migrated
+ * to a factory payload.
  */
 export declare function useForwardedRef<T extends Element>(elementRef: Ref<T | null>): void;

package/lib/core/renderable-node.d.ts CHANGED Viewed

@@ -5,6 +5,11 @@ export interface SectionSlots {
     leftSection?: () => VNodeChild;
     rightSection?: () => VNodeChild;
 }
-/** Prop content takes precedence over slot content. Explicit null is preserved. */
+/**
+ * Resolves content for props that accept both a scoped slot and a plain prop.
+ * Precedence: slot > prop > undefined. A slot passed by the parent always wins,
+ * even if a prop is also set, so consumers can override built-in defaults from
+ * their template without fighting prop-driven content.
+ */
 export declare function resolveNode(prop: MantineNode | undefined, slot?: () => VNodeChild): VNodeChild;
 export declare function hasNode(node: VNodeChild): boolean;