injast-core 1.0.81 → 1.0.83

package/README.md

@@ -106,6 +106,69 @@ export function Providers({ children }: { children: React.ReactNode }) {
 
 Most wrapper components accept the corresponding Material UI component props, with additional Injast-specific props where documented in Storybook stories.
 
+## Persian Calendar
+
+برای انتخاب تاریخ شمسی، از `MobileDatePicker` یا `WheelDatePicker` استفاده کنید. هر دو کامپوننت تاریخ را برای کاربر به صورت شمسی نمایش می‌دهند.
+
+`MobileDatePicker` برای تقویم مودالی مناسب است. مقدار `value` و خروجی `onChange` آن میلادی و با فرمت `YYYY-MM-DD` است، اما `minDate` و `maxDate` را به صورت شمسی `YYYY/MM/DD` می‌گیرد:
+
+```tsx
+import { useState } from "react";
+import { MobileDatePicker } from "injast-core";
+
+export function BirthDateField() {
+  const [birthDate, setBirthDate] = useState("2024-03-20");
+
+  return (
+    <MobileDatePicker
+      label="تاریخ تولد"
+      placeholder="تاریخ را انتخاب کنید"
+      value={birthDate}
+      onChange={setBirthDate}
+      minDate="1300/01/01"
+      maxDate="1403/12/30"
+    />
+  );
+}
+```
+
+`WheelDatePicker` برای انتخابگر چرخشی داخل دراور مناسب است. اگر می‌خواهید state فرم شمسی بماند، `dateFormat="jalali"` بگذارید:
+
+```tsx
+import { useState } from "react";
+import { WheelDatePicker } from "injast-core";
+
+export function DeliveryDateField() {
+  const [deliveryDate, setDeliveryDate] = useState<string | null>("1403/01/01");
+
+  return (
+    <WheelDatePicker
+      title="تاریخ تحویل"
+      placeholder="تاریخ تحویل"
+      value={deliveryDate}
+      onChange={(value) =>
+        setDeliveryDate(typeof value === "string" ? value : null)
+      }
+      dateFormat="jalali"
+    />
+  );
+}
+```
+
+برای ارسال تاریخ به API یا نمایش تاریخ، از utilityهای آماده استفاده کنید و تبدیل شمسی/میلادی را دستی ننویسید:
+
+```tsx
+import {
+  gregorianToJalali,
+  jalaliToGregorian,
+  shortDateFormat,
+} from "injast-core";
+
+gregorianToJalali("2024-03-20"); // "1403/01/01"
+jalaliToGregorian("1403/01/01"); // "2024-03-20"
+shortDateFormat("2024-03-20");
+```
+
 ## 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.
@@ -137,10 +200,33 @@ Then select `injast-core` from the public unscoped package results.
 For Make kits, start with the included guidelines:
 
 ```text
+guidelines/ai-index.md
 guidelines/Guidelines.md
 ```
 
-The guidelines route Make to setup instructions, foundations, component selection rules, and focused component usage notes. In a Vite/React Make file, use `SPAThemeProvider`, import `injast-core/fonts.css` once, and prefer Injast components over raw HTML controls.
+The AI index routes Make and coding agents to setup instructions, foundations, component selection rules, focused component usage notes, runtime helpers, and TypeScript types. In a Vite/React Make file, use `SPAThemeProvider`, import `injast-core/fonts.css` once, and prefer Injast components over raw HTML controls.
+
+For Figma-driven implementation, use the Figma MCP flow before coding. The local MCP endpoint is:
+
+```text
+http://127.0.0.1:3845/mcp
+```
+
+Fetch structured design context and a screenshot for the exact node, then translate the design into Injast Core components, RTL layout, Persian copy, and the project guidelines.
+
+Generated mobile app screens should follow the Gold reference app at `/Users/ali/Documents/Gold`: centered `max-width: 520px` shell, wired navigation and overlay behavior, Injast Core inputs, drawer-based pre-invoices, and no mobile OS/app status bar chrome.
+
+## Codex Skill
+
+The package ships a Codex skill for Injast app generation:
+
+```text
+skills/injast-app-builder
+```
+
+After installing the package, consumers can point Codex at `node_modules/injast-core/skills/injast-app-builder` or copy that folder into their Codex skills directory if their Codex setup does not auto-discover package-bundled skills.
+
+The skill starts from `guidelines/ai-index.md` and then loads focused guideline files for the requested screen or flow.
 
 ## License