@recursica/mantine-adapter 0.5.0 → 0.6.0

package/dist/src/components/ReadOnlyField/WithReadOnlyWrapper.d.ts

@@ -0,0 +1,22 @@
+import { default as React } from 'react';
+import { ReadOnlyFieldType } from '@recursica/adapter-common';
+import { FormControlWrapperProps } from '../FormControlWrapper/FormControlWrapper';
+export interface WithReadOnlyWrapperProps extends Omit<FormControlWrapperProps, "children" | "overStyled"> {
+    /** Injects whether the field defaults to reading mode natively */
+    readOnly?: boolean;
+    /** Explicit React component directly overtaking the baseline text renderer when read-only mode is active */
+    readOnlyComponent?: React.ReactNode;
+    /** Instructs the underlying generic ReadOnlyField which raw visual structure to bridge automatically */
+    readOnlyType?: ReadOnlyFieldType;
+    /** The isolated raw data value intercepted explicitly into the ReadOnly formatters */
+    readOnlyValue?: any;
+    /** Safely enables deep Mantine overrides transparently bypassing block filters */
+    overStyled?: boolean;
+    /** The nested active node dynamically exposed exclusively when read-only bounds are disabled */
+    activeComponent: React.ReactNode;
+}
+/**
+ * Universal execution barrier trapping readOnly states globally.
+ * Natively delegates active logic down avoiding duplicative internal component bindings dynamically.
+ */
+export declare const WithReadOnlyWrapper: React.ForwardRefExoticComponent<WithReadOnlyWrapperProps & React.RefAttributes<HTMLDivElement>>;

package/dist/src/components/ReadOnlyField/index.d.ts

@@ -0,0 +1,3 @@
+export * from './ReadOnlyField';
+export * from './WithReadOnlyWrapper';
+export * from './ReadOnlyTextField';

package/dist/src/components/Text/Text.d.ts

@@ -0,0 +1,17 @@
+import { ReactNode } from 'react';
+import { TextProps as MantineTextProps } from '@mantine/core';
+import { RecursicaOverStyled } from '../../utils/filterStylingProps';
+export type TextVariant = "body" | "body-small" | "caption" | "overline" | "subtitle" | "subtitle-small";
+export type RecursicaTextProps = Omit<MantineTextProps, "variant"> & {
+    /**
+     * The explicit typography hierarchy dictated by Recursica's global design tokens.
+     */
+    variant?: TextVariant;
+    children?: ReactNode;
+};
+export type TextProps = RecursicaOverStyled<RecursicaTextProps>;
+/**
+ * A generalized typographical wrapper limiting text properties to bounded Recursica UI-kit tokens inherently.
+ * Do not use for semantic headings; use the explicit `<Title>` component for `<h1>` - `<h6>`.
+ */
+export declare const Text: import('react').ForwardRefExoticComponent<TextProps & import('react').RefAttributes<HTMLDivElement>>;

package/dist/src/components/TextField/TextField.d.ts

@@ -1,3 +1,9 @@
 import { default as React } from 'react';
-export type TextFieldProps = React.HTMLAttributes<HTMLDivElement>;
-export declare const TextField: React.FC<TextFieldProps>;
+import { InputProps, InputWrapperProps } from '@mantine/core';
+import { ReadOnlyControlProps } from '@recursica/adapter-common';
+import { RecursicaOverStyled } from '../../utils/filterStylingProps';
+import { RecursicaFormControlWrapperProps } from '../FormControlWrapper/FormControlWrapper';
+export interface RecursicaTextFieldProps extends Omit<InputProps, "size" | "variant" | "radius" | "wrapperProps">, Pick<InputWrapperProps, "label" | "error" | "required" | "withAsterisk" | "id">, Omit<React.ComponentPropsWithoutRef<"input">, "size" | "style" | "className" | "id">, Omit<RecursicaFormControlWrapperProps, "controlMaxWidth" | "controlMinWidth">, ReadOnlyControlProps {
+}
+export type TextFieldProps = RecursicaOverStyled<RecursicaTextFieldProps>;
+export declare const TextField: React.ForwardRefExoticComponent<TextFieldProps & React.RefAttributes<HTMLInputElement>>;

package/dist/src/components/Title/Title.d.ts

@@ -0,0 +1,13 @@
+import { TitleProps as MantineTitleProps } from '@mantine/core';
+import { RecursicaOverStyled } from '../../utils/filterStylingProps';
+export type RecursicaTitleProps = Omit<MantineTitleProps, "order"> & {
+    /**
+     * Enforces semantic HTML headers (h1-h6) cleanly bound to native typographic scaling variables in the design system.
+     */
+    order?: 1 | 2 | 3 | 4 | 5 | 6;
+};
+export type TitleProps = RecursicaOverStyled<RecursicaTitleProps>;
+/**
+ * Enforces highly accessible structural markup utilizing semantic `<h1>` through `<h6>` tags securely bound directly to Recursica typographic scales.
+ */
+export declare const Title: import('react').ForwardRefExoticComponent<TitleProps & import('react').RefAttributes<HTMLHeadingElement>>;

package/dist/src/components/index.d.ts

@@ -5,6 +5,7 @@ export * from './Breadcrumb/Breadcrumb';
 export * from './Button';
 export * from './Card/Card';
 export * from './Checkbox/Checkbox';
+export * from './Checkbox/CheckboxGroup';
 export * from './Chip/Chip';
 export * from './DatePicker/DatePicker';
 export * from './Dropdown/Dropdown';
@@ -13,6 +14,7 @@ export * from './FileUpload/FileUpload';
 export * from './HoverCard/HoverCard';
 export * from './Link/Link';
 export * from './Loader/Loader';
+export * from './Label';
 export * from './Menu/Menu';
 export * from './Modal/Modal';
 export * from './NumberInput/NumberInput';
@@ -20,7 +22,7 @@ export * from './Pagination/Pagination';
 export * from './Panel/Panel';
 export * from './Popover/Popover';
 export * from './Radio/Radio';
-export * from './ReadOnlyField/ReadOnlyField';
+export * from './ReadOnlyField';
 export * from './Search/Search';
 export * from './SegmentedControl/SegmentedControl';
 export * from './Slider/Slider';

package/dist/src/utils/ColorSchemeWrapper.d.ts

@@ -0,0 +1,3 @@
+export declare function ColorSchemeWrapper({ children, }: {
+    children: React.ReactNode;
+}): import("react/jsx-runtime").JSX.Element;

package/dist/src/utils/filterStylingProps.d.ts

@@ -21,9 +21,13 @@
  * @param overStyled - Boolean toggle to allow raw external styling. Defaults to false.
  * @returns Sanitized component props safe for internal styling merging
  */
-export declare const BLOCKED_STYLING_KEYS: readonly ["className", "classNames", "style", "styles", "vars", "p", "px", "py", "pt", "pb", "pl", "pr", "bg", "c", "opacity", "ff", "fz", "fw", "lts", "ta", "lh", "fs", "tt", "td", "bd", "bdw", "bds", "bdc", "bdr", "shadow"];
+export declare const BLOCKED_STYLING_KEYS: readonly ["className", "classNames", "style", "styles", "vars", "p", "px", "py", "pt", "pb", "pl", "pr", "bg", "c", "opacity", "ff", "fz", "fw", "lts", "ta", "lh", "fs", "tt", "td", "bd", "bdw", "bds", "bdc", "bdr", "shadow", "w", "miw", "maw", "h", "mih", "mah"];
 export type BlockedStylingKeys = (typeof BLOCKED_STYLING_KEYS)[number];
-export type RecursicaOverStyled<T> = (Omit<T, BlockedStylingKeys> & {
+export type RecursicaSpacing = "rec-none" | "rec-sm" | "rec-default" | "rec-md" | "rec-lg" | "rec-xl" | "rec-2xl";
+export type ForbiddenStyles = {
+    [K in BlockedStylingKeys]?: never;
+};
+export type RecursicaOverStyled<T> = (Omit<T, BlockedStylingKeys> & ForbiddenStyles & {
     overStyled?: false | undefined;
 }) | (T & {
     overStyled: true;

package/package.json

@@ -11,7 +11,7 @@
     "type": "git",
     "url": "git+https://github.com/borderux/recursica.git"
   },
-  "version": "0.5.0",
+  "version": "0.6.0",
   "type": "module",
   "main": "./dist/mantine-adapter.cjs",
   "module": "./dist/mantine-adapter.js",
@@ -72,6 +72,7 @@
     "sass": "^1.89.2",
     "sirv": "^3.0.2",
     "storybook": "^10.3.3",
+    "storybook-dark-mode": "^5.0.0",
     "strip-literal": "^3.0.0",
     "typescript": "~5.8.3",
     "typescript-eslint": "^8.30.1",
@@ -81,9 +82,9 @@
     "vitest": "^3.2.4"
   },
   "peerDependencies": {
-    "@mantine/core": ">=8.0.0",
-    "@mantine/dates": ">=8.0.0",
-    "@mantine/hooks": ">=8.0.0",
+    "@mantine/core": "^8.0.0",
+    "@mantine/dates": "^8.0.0",
+    "@mantine/hooks": "^8.0.0",
     "react": ">=16.8.0",
     "react-dom": ">=16.8.0"
   }