injast-core 1.0.78

package/LICENSE

@@ -0,0 +1,15 @@
+ISC License
+
+Copyright (c) 2026 Injast
+
+Permission to use, copy, modify, and/or distribute this software for any
+purpose with or without fee is hereby granted, provided that the above
+copyright notice and this permission notice appear in all copies.
+
+THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
+WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
+MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
+ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
+WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
+ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
+OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.

package/README.md

@@ -0,0 +1,127 @@
+# Injast Core
+
+Reusable React components, Material UI theme providers, hooks, utilities, and design tokens used by Injast applications.
+
+## Installation
+
+```bash
+npm install injast-core
+```
+
+Peer requirements:
+
+```bash
+npm install react@^19 react-dom@^19
+```
+
+The package is published as ESM and is intended for modern React bundlers such as Vite, Next.js, and similar tooling.
+
+## Usage
+
+Root imports are supported:
+
+```tsx
+import { Button, TextField, ThemeProvider, coreFaIR } from "injast-core";
+```
+
+Subpath imports are also available when you want a narrower entrypoint:
+
+```tsx
+import { Button, TextField } from "injast-core/components";
+import { ThemeProvider, SPAThemeProvider } from "injast-core/providers";
+import { createApiRequest } from "injast-core/libs";
+import { convertRialToToman, formatPersianNumber } from "injast-core/utils";
+import { defaultColors } from "injast-core/constants";
+```
+
+## Theme Providers
+
+For React single-page applications:
+
+```tsx
+import { SPAThemeProvider, coreFaIR } from "injast-core";
+
+const appColors = {
+  primary: {
+    main: "#1DBF98",
+    light: "#1DBF98",
+    dark: "#1DBF98",
+    contrastText: "#ffffff",
+  },
+  secondary: {
+    main: "#4F545E",
+    light: "#4F545E",
+    dark: "#4F545E",
+    contrastText: "#ffffff",
+  },
+};
+
+export function AppProviders({ children }: { children: React.ReactNode }) {
+  return (
+    <SPAThemeProvider
+      dir="rtl"
+      appColors={appColors}
+      themeOptions={{ ...coreFaIR }}
+    >
+      {children}
+    </SPAThemeProvider>
+  );
+}
+```
+
+For Next.js client layouts or app providers:
+
+```tsx
+"use client";
+
+import { ThemeProvider } from "injast-core";
+
+const appColors = {
+  primary: {
+    main: "#1DBF98",
+    light: "#1DBF98",
+    dark: "#1DBF98",
+    contrastText: "#ffffff",
+  },
+  secondary: {
+    main: "#4F545E",
+    light: "#4F545E",
+    dark: "#4F545E",
+    contrastText: "#ffffff",
+  },
+};
+
+export function Providers({ children }: { children: React.ReactNode }) {
+  return (
+    <ThemeProvider dir="rtl" appColors={appColors}>
+      {children}
+    </ThemeProvider>
+  );
+}
+```
+
+## Components
+
+`injast-core/components` exports wrappers and custom components including `Button`, `TextField`, `Select`, `Modal`, `Toast`, `MobileDatePicker`, `WheelDatePicker`, `DataGrid`, `MultiSelect`, `OtpInput`, `NumberInput`, `CardNumberInput`, and common Material UI layout primitives.
+
+Most wrapper components accept the corresponding Material UI component props, with additional Injast-specific props where documented in Storybook stories.
+
+## Utilities and Hooks
+
+Useful utilities are exported from `injast-core/utils`, including date conversion helpers, Persian number formatting, query string creation, iframe messaging, and `coreFaIR` for MUI Persian locale configuration.
+
+Hooks are exported from `injast-core/hooks`, including shared Material UI hooks and Injast-specific helpers such as `useErrorHandler`, `useMessage`, and `useWebOtpListener`.
+
+## Fonts and Date Picker CSS
+
+The theme uses the `IRANYekanX` and `IRANYekanXFaNum` font families. You can load the bundled font stylesheet once in your app:
+
+```tsx
+import "injast-core/fonts.css";
+```
+
+`MobileDatePicker` imports the required `react-multi-date-picker` mobile layout stylesheet from its dependency. Ensure your bundler supports CSS imports from JavaScript modules.
+
+## License
+
+ISC