@meonode/mui 1.0.5 → 1.0.7

package/dist/core.d.ts

@@ -0,0 +1,61 @@
+import React from 'react';
+import type { NodeInstance, NodeProps } from '@meonode/ui';
+import { OverridableComponent, OverridableTypeMap, OverrideProps } from '@mui/material/OverridableComponent';
+/**
+ * Determines if an object is likely to be a Material-UI theme object by comparing its structure
+ * to a reference theme.
+ * @param obj The object to evaluate as a potential MUI theme
+ * @returns `true` if the object appears to be a MUI theme, `false` otherwise
+ * @remarks
+ * The function uses a heuristic approach by:
+ * 1. Creating a reference theme using MUI's extendTheme()
+ * 2. Comparing the keys of the input object with the reference theme
+ * 3. Calculating a similarity score based on matching keys
+ * 4. Considering it a theme if at least 25% of reference keys are present
+ * @example
+ * ```ts
+ * const customTheme = {
+ *   palette: { primary: { main: '#000' } },
+ *   typography: { fontSize: 14 }
+ * };
+ *
+ * if (isProbablyMuiTheme(customTheme)) {
+ *   // Handle theme object
+ * }
+ * ```
+ * @throws Will not throw, but returns false for null, non-objects, or invalid inputs
+ */
+export declare function isProbablyMuiTheme(obj: unknown): boolean;
+/**
+ * A utility type that extends an OverridableTypeMap to include a polymorphic `component` prop.
+ * This allows the component to be overridden with a different React element type.
+ * @template TMap - The base OverridableTypeMap to extend.
+ * @template TComponent - The React element type to use for the `component` prop.
+ */
+type WithPolymorphic<TMap extends OverridableTypeMap, TComponent extends React.ElementType> = TMap & {
+    props: TMap['props'] & Partial<{
+        component: TComponent;
+    }>;
+    defaultComponent: TMap['defaultComponent'];
+};
+/**
+ * Creates a function that generates a `NodeInstance` for a Material-UI component
+ * with support for polymorphic behavior.
+ * @template TMap - The OverridableTypeMap for the Material-UI component.
+ * @template TDefaultComponent - The default React element type for the component.
+ * @param element The Material-UI component to wrap.
+ * @returns A function that takes props and returns a `NodeInstance` for the component.
+ */
+export default function createMuiNode<TMap extends OverridableTypeMap, TDefaultComponent extends React.ElementType = TMap['defaultComponent']>(element: OverridableComponent<TMap>): <T extends React.ElementType = TDefaultComponent>(props?: NodeProps<OverridableComponent<WithPolymorphic<TMap, T>>> & Omit<OverrideProps<WithPolymorphic<TMap, T>, T>, keyof NodeProps<OverridableComponent<WithPolymorphic<TMap, T>>>>) => NodeInstance<OverridableComponent<WithPolymorphic<TMap, T>>>;
+/**
+ * Creates a function that generates a `NodeInstance` for a generic React element.
+ * @template TElement - The React element type to wrap.
+ * @param element The React element to wrap.
+ * @returns A function that takes props and returns a `NodeInstance` for the element.
+ */
+export default function createMuiNode<TElement extends React.ElementType>(element: TElement): (props?: NodeProps<TElement>) => NodeInstance<TElement>;
+/**
+ * Exports the `createMuiNode` function for external use.
+ */
+export { createMuiNode };
+//# sourceMappingURL=core.d.ts.map

package/dist/core.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"core.d.ts","sourceRoot":"","sources":["../src/core.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,MAAM,OAAO,CAAA;AACzB,OAAO,KAAK,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,aAAa,CAAA;AAE1D,OAAO,EAAE,oBAAoB,EAAE,kBAAkB,EAAE,aAAa,EAAE,MAAM,oCAAoC,CAAA;AAE5G;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,OAAO,GAAG,OAAO,CAWxD;AAED;;;;;GAKG;AACH,KAAK,eAAe,CAAC,IAAI,SAAS,kBAAkB,EAAE,UAAU,SAAS,KAAK,CAAC,WAAW,IAAI,IAAI,GAAG;IACnG,KAAK,EAAE,IAAI,CAAC,OAAO,CAAC,GAAG,OAAO,CAAC;QAAE,SAAS,EAAE,UAAU,CAAA;KAAE,CAAC,CAAA;IACzD,gBAAgB,EAAE,IAAI,CAAC,kBAAkB,CAAC,CAAA;CAC3C,CAAA;AAED;;;;;;;GAOG;AACH,MAAM,CAAC,OAAO,UAAU,aAAa,CAAC,IAAI,SAAS,kBAAkB,EAAE,iBAAiB,SAAS,KAAK,CAAC,WAAW,GAAG,IAAI,CAAC,kBAAkB,CAAC,EAC3I,OAAO,EAAE,oBAAoB,CAAC,IAAI,CAAC,GAClC,CAAC,CAAC,SAAS,KAAK,CAAC,WAAW,GAAG,iBAAiB,EACjD,KAAK,CAAC,EAAE,SAAS,CAAC,oBAAoB,CAAC,eAAe,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,GAC/D,IAAI,CAAC,aAAa,CAAC,eAAe,CAAC,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,MAAM,SAAS,CAAC,oBAAoB,CAAC,eAAe,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,KAChH,YAAY,CAAC,oBAAoB,CAAC,eAAe,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,CAAA;AAEjE;;;;;GAKG;AACH,MAAM,CAAC,OAAO,UAAU,aAAa,CAAC,QAAQ,SAAS,KAAK,CAAC,WAAW,EAAE,OAAO,EAAE,QAAQ,GAAG,CAAC,KAAK,CAAC,EAAE,SAAS,CAAC,QAAQ,CAAC,KAAK,YAAY,CAAC,QAAQ,CAAC,CAAA;AAoBrJ;;GAEG;AACH,OAAO,EAAE,aAAa,EAAE,CAAA"}

package/dist/core.js

@@ -0,0 +1,50 @@
+"use strict";function _typeof(a){"@babel/helpers - typeof";return _typeof="function"==typeof Symbol&&"symbol"==typeof Symbol.iterator?function(a){return typeof a}:function(a){return a&&"function"==typeof Symbol&&a.constructor===Symbol&&a!==Symbol.prototype?"symbol":typeof a},_typeof(a)}import*as Mui from"@mui/material";import{Node}from"@meonode/ui";/**
+ * Determines if an object is likely to be a Material-UI theme object by comparing its structure
+ * to a reference theme.
+ * @param obj The object to evaluate as a potential MUI theme
+ * @returns `true` if the object appears to be a MUI theme, `false` otherwise
+ * @remarks
+ * The function uses a heuristic approach by:
+ * 1. Creating a reference theme using MUI's extendTheme()
+ * 2. Comparing the keys of the input object with the reference theme
+ * 3. Calculating a similarity score based on matching keys
+ * 4. Considering it a theme if at least 25% of reference keys are present
+ * @example
+ * ```ts
+ * const customTheme = {
+ *   palette: { primary: { main: '#000' } },
+ *   typography: { fontSize: 14 }
+ * };
+ *
+ * if (isProbablyMuiTheme(customTheme)) {
+ *   // Handle theme object
+ * }
+ * ```
+ * @throws Will not throw, but returns false for null, non-objects, or invalid inputs
+ */export function isProbablyMuiTheme(a){if("object"!==_typeof(a)||null===a)return!1;var b=Mui.extendTheme(),c=Object.keys(b),d=Object.keys(a),e=d.filter(function(a){return c.includes(a)}),f=e.length/c.length;return .25<=f}/**
+ * A utility type that extends an OverridableTypeMap to include a polymorphic `component` prop.
+ * This allows the component to be overridden with a different React element type.
+ * @template TMap - The base OverridableTypeMap to extend.
+ * @template TComponent - The React element type to use for the `component` prop.
+ *//**
+ * Creates a function that generates a `NodeInstance` for a Material-UI component
+ * with support for polymorphic behavior.
+ * @template TMap - The OverridableTypeMap for the Material-UI component.
+ * @template TDefaultComponent - The default React element type for the component.
+ * @param element The Material-UI component to wrap.
+ * @returns A function that takes props and returns a `NodeInstance` for the component.
+ *//**
+ * Creates a function that generates a `NodeInstance` for a generic React element.
+ * @template TElement - The React element type to wrap.
+ * @param element The React element to wrap.
+ * @returns A function that takes props and returns a `NodeInstance` for the element.
+ *//**
+ * Creates a function that generates a `NodeInstance` for any given element.
+ * @param element The element to wrap.
+ * @returns A function that takes props and returns a `NodeInstance` for the element.
+ * @remarks
+ * - If the `theme` prop is not a valid Material-UI theme, it is renamed to `nodetheme`.
+ * - This ensures compatibility with the `Node` function.
+ */export default function createMuiNode(a){return function(){var b=0<arguments.length&&void 0!==arguments[0]?arguments[0]:{};return isProbablyMuiTheme(null===b||void 0===b?void 0:b.theme)||(b.nodetheme=b.theme,delete b.theme),Node(a,b)}}/**
+ * Exports the `createMuiNode` function for external use.
+ */export{createMuiNode};