@isma91/react-scheduler 4.0.6 → 4.0.7

package/dist/LICENSE

@@ -0,0 +1,24 @@
+This is free and unencumbered software released into the public domain.
+
+Anyone is free to copy, modify, publish, use, compile, sell, or
+distribute this software, either in source code form or as a compiled
+binary, for any purpose, commercial or non-commercial, and by any
+means.
+
+In jurisdictions that recognize copyright laws, the author or authors
+of this software dedicate any and all copyright interest in the
+software to the public domain. We make this dedication for the benefit
+of the public at large and to the detriment of our heirs and
+successors. We intend this dedication to be an overt act of
+relinquishment in perpetuity of all present and future rights to this
+software under copyright law.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.
+IN NO EVENT SHALL THE AUTHORS BE LIABLE FOR ANY CLAIM, DAMAGES OR
+OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE,
+ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR
+OTHER DEALINGS IN THE SOFTWARE.
+
+For more information, please refer to <https://unlicense.org>

package/dist/README.md

@@ -0,0 +1,174 @@
+# React Scheduler Component
+
+> :rocket: **Fork Notice**: This is a modernized fork of [@aldabil/react-scheduler](https://github.com/aldabil21/react-scheduler) with:
+> - React 19 support
+> - MUI 7 / @mui/x-date-pickers 8 support  
+> - date-fns 4 support
+> - Additional features (see changelog)
+
+[![npm package](https://img.shields.io/npm/v/@isma91/react-scheduler/latest.svg)](https://www.npmjs.com/package/@isma91/react-scheduler)
+
+
+> :warning: **Notice**: This component uses `mui`/`emotion`/`date-fns`. if your project is not already using these libs, this component may not be suitable.
+
+## Installation
+
+```jsx
+npm i @isma91/react-scheduler
+```
+
+If you plan to use `recurring` events in your scheduler, install `rrule` [package](https://www.npmjs.com/package/rrule)
+
+## Usage
+
+```jsx
+import { Scheduler } from "@isma91/react-scheduler";
+```
+
+## Example
+
+```jsx
+<Scheduler
+  view="month"
+  events={[
+    {
+      event_id: 1,
+      title: "Event 1",
+      start: new Date("2021/5/2 09:30"),
+      end: new Date("2021/5/2 10:30"),
+    },
+    {
+      event_id: 2,
+      title: "Event 2",
+      start: new Date("2021/5/4 10:00"),
+      end: new Date("2021/5/4 11:00"),
+    },
+  ]}
+/>
+```
+
+### Scheduler Props
+
+All props are _optional_
+| Prop | Value |
+|----------|-------------|
+| height | number. Min height of table. <br> _Default_: 600
+| view | string. Initial view to load. options: "week", "month", "day". <br> _Default_: "week" (if it's not null)
+| agenda | boolean. Activate agenda view
+| alwaysShowAgendaDays | boolean. if true, day rows without events will be shown
+| month | Object. Month view props. <br> _default_: <pre>{<br>weekDays: [0, 1, 2, 3, 4, 5], <br>weekStartOn: 6, <br>startHour: 9, <br>endHour: 17,<br>cellRenderer?:(props: CellProps) => React.ReactNode,<br>navigation: true,<br>disableGoToDay: false<br>}</pre>
+| week | Object. Week view props. <br> _default_: <pre>{ <br>weekDays: [0, 1, 2, 3, 4, 5], <br>weekStartOn: 6, <br>startHour: 9, <br>endHour: 17,<br>step: 60,<br>cellRenderer?:(props: CellProps) => React.ReactNode,<br>navigation: true,<br>disableGoToDay: false<br>}</pre>
+| day | Object. Day view props. <br> _default_: <pre>{<br>startHour: 9, <br>endHour: 17, <br>step: 60,<br>cellRenderer?:(props: CellProps) => React.ReactNode,<br>hourRenderer?:(hour: string) => React.ReactNode,<br>navigation: true<br>}</pre>
+| selectedDate | Date. Initial selected date. <br>_Default_: `new Date()`
+| navigation | boolean. Show/Hide top bar date navigation. <br>_Default_: `true`
+| navigationPickerProps | CalendarPickerProps for top bar date navigation. Ref [CalendarPicker API](https://mui.com/x/api/date-pickers/calendar-picker/#main-content)
+| disableViewNavigator | boolean. Show/Hide top bar date View navigator. <br>_Default_: `false`
+| events | Array of ProcessedEvent. <br>_Default_: [] <br> <pre>type ProcessedEvent = {<br>event*id: number or string;<br>title: string;<br>subtitle?: string;<br>start: Date;<br>end: Date;<br>disabled?: boolean;<br>recurring: RRule;<br>color?: string or "palette.path";<br>textColor?: string or "palette.path";<br>editable?: boolean;<br>deletable?: boolean;<br>draggable?: boolean;<br>allDay?: boolean;<br>agendaAvatar?: React.ReactElement \| string<br>sx?: Mui sx prop<br>} </pre>
+| eventRenderer | Function(event:ProcessedEvent): React.ReactNode.<br> A function that overrides the event item render function, see demo \_Custom Event Renderer* below
+| editable | boolean. If `true`, the scheduler cell click will not open the editor, and the event item will not show the edit button, this is applied to all events, and can be overridden in each event property, see `ProcessedEvent` type.
+| deletable | boolean. Whether the event item will show the delete button, this is applied to all events, and can be overridden in each event property, see `ProcessedEvent` type.
+| draggable | boolean. Whether activate drag&drop for the events, this is applied to all events, and can be overridden in each event property, see `ProcessedEvent` type.
+| getRemoteEvents | Function(RemoteQuery). Return promise of array of events. Can be used as a callback to fetch events by parent component or fetch.<br><pre>type RemoteQuery = { <br> start: Date;<br> end: Date;<br> view: "day" \| "week" \| "month";<br>}</pre>
+| refetch | Function accessible via ref to manually trigger a reload of remote events. Only works when `getRemoteEvents` is provided. <br>_Usage_: `schedulerRef.current?.scheduler?.refetch()` |
+| fields | Array of extra fields with configurations. <br> Example: <pre> { <br> name: "description", <br> type: "input" , <br> config: { label: "Description", required: true, min: 3, email: true, variant: "outlined", ....<br>}</pre>
+| loading | boolean. Loading state of the calendar table
+| loadingComponent | Custom component to override the default `CircularProgress`
+| onConfirm | Function(event, action). Return promise with the new added/edited event use with remote data. <br> _action_: `add` | `edit`
+| onDelete | Function(id) Return promise with the deleted event id to use with remote data.
+| customEditor | Function(scheduler). Override editor modal. <br> Provided prop _scheduler_ object with helper props: <br> <pre>{<br>state: state obj, <br>close(): void<br>loading(status: boolean): void<br>edited?: ProcessedEvent<br>onConfirm(event: ProcessedEvent, action:EventActions): void<br>}</pre>
+| customViewer | Function(event: ProcessedEvent, close: () => void). Used to render fully customized content of the event popper. If used, `viewerExtraComponent` & `viewerTitleComponent` will be ignored
+| viewerExtraComponent | Function(fields, event) OR Component. Additional component in event viewer popper
+| viewerTitleComponent | Function(event). Helper function to render custom title in event popper
+| viewerSubtitleComponent | Function(event). Helper function to render custom subtitle in event popper
+| disableViewer | boolean. If true, the viewer popover will be disabled globally
+| resources | Array. Resources array to split event views with resources <br>_Example_ <pre>{<br>assignee: 1,<br>text: "User One", <br>subtext: "Sales Manager", <br>avatar: "https://picsum.photos/200/300", <br>color: "#ab2d2d",<br> }</pre>
+| resourceFields | Object. Map the resources correct fields. <br>_Example_:<pre>{<br>idField: "admin*id", <br>textField: "title", <br>subTextField: "mobile",<br>avatarField: "title", <br>colorField: "background",<br>}</pre>
+| resourceHeaderComponent | Function(resource). Override header component of resource
+| resourceViewMode | Display resources mode. <br>\_Options*: `default` | `vertical` | `tabs`
+| onResourceChange | Function(resource: Resource): void. Triggered when the resource tabs changes, only applicable when `resourceViewMode="tabs"`
+| direction | string. Table direction. `rtl` | `ltr`
+| dialogMaxWidth | Edito dialog maxWith. Ex: `lg` | `md` | `sm`... _Default_:`md`
+| locale | Locale of date-fns. _Default_: `enUS`
+| hourFormat | Hour format. <br>_Options_: `12` | `24`. _Default_: `12`
+| timeZone| String, time zone [IANA ID](https://en.wikipedia.org/wiki/List_of_tz_database_time_zones)
+| translations | Object. Translations view props. <br> _default_: <pre>{<br> navigation: {<br> month: "Month",<br> week: "Week",<br> day: "Day",<br> today: "Today"<br> agenda: "Agenda"<br> },<br> form: {<br> addTitle: "Add Event",<br> editTitle: "Edit Event",<br> confirm: "Confirm",<br> delete: "Delete",<br> cancel: "Cancel"<br> },<br> event: {<br> title: "Title",<br> subtitle: "Subtitle",<br> start: "Start",<br> end: "End",<br> allDay: "All Day"<br>},<br> validation: {<br> required: "Required",<br> invalidEmail: "Invalid Email",<br> onlyNumbers: "Only Numbers Allowed",<br> min: "Minimum {{min}} letters",<br> max: "Maximum {{max}} letters"<br> },<br> moreEvents: "More...",<br> noDataToDisplay: "No data to display",<br> loading: "Loading..."<br>}</pre>
+| onEventDrop | Function(event: DragEvent<HTMLButtonElement>, droppedOn: Date, updatedEvent: ProcessedEvent, originalEvent: ProcessedEvent). Return a promise, used to update remote data of the dropped event. Return an event to update state internally, or void if event state is managed within component
+| onEventClick | Function(event: ProcessedEvent): void. Triggered when an event item is clicked
+| onEventEdit | Function(event: ProcessedEvent): void. Triggered when an event item is being edited from the popover
+| onCellClick | Function(start: Date, end: Date, resourceKey?: string, resourceVal?: string | number): void. Triggered when a cell in the grid is clicked
+| onSelectedDateChange | Function(date: Date): void. Triggered when the `selectedDate` prop changes by navigation date picker or `today` button
+| onViewChange | Function(view: View, agenda?: boolean): void. Triggered when navigation view changes
+| stickyNavigation | If `true`, the navigation controller bar will be sticky
+| onClickMore | Function(date: Date, goToDay: Function(date: Date): void): void. Triggered when the "More..." button is clicked, it receives the date and a `goToDay` function that shows a day view for a specfic date.
+| stickyNavigationOffset | number. Top offset in pixels when sticky navigation is enabled. <br>_Default_: `0` |
+| stickyNavigationHeight | number. Height of the sticky navigation header in pixels. Used to calculate offset for sticky elements below the header. <br>_Default_: `40` |
+| customHeaderContent | Function. Custom content to display in the scheduler header. Wrap with `useCallback` if using state/props to avoid re-renders. <br>_Example_: `() => <Button>Refresh</Button>` |
+| currentTime | Date. Override the current time used for the time indicator bar. Useful when working with different timezones or for testing. <br>_Default_: `new Date()` |
+| showCurrentTimeBar | boolean. Show/hide the current time indicator bar. <br>_Default_: `true` |
+| currentTimeBarColor | string. Color of the current time indicator bar. <br>_Default_: `theme.palette.error.light` (red) |
+| forceInlineMultiDay | boolean. When `true`, events spanning multiple days with `allDay: false` will be displayed in the time grid instead of the all-day header. Events will be split visually at midnight boundaries. <br>_Default_: `false` |
+| displayHourRange | boolean. Controls visibility of the secondary information in Agenda list items. When `false`, hides the secondary text.<br>_Default_: `true` |
+
+### SchedulerRef
+
+Used to help manage and control the internal state of the `Scheduler` component from outside of `Scheduler` props, Example:
+
+```js
+import { Scheduler } from "@isma91/react-scheduler";
+import type { SchedulerRef } from "@isma91/react-scheduler/types"
+
+const SomeComponent = () => {
+  const calendarRef = useRef<SchedulerRef>(null);
+
+  return <Fragment>
+    <div>
+      <Button onClick={()=>{
+        calendarRef.current.scheduler.handleState("day", "view");
+      }}>
+        Change View
+      </Button>
+      <Button onClick={()=>{
+        calendarRef.current.scheduler.triggerDialog(true, {
+          start: /*Put the start date*/,
+          end: /*Put the end date*/
+        })
+      }}>
+        Add Event Tomorrow
+      </Button>
+    </div>
+
+    <Scheduler
+      ref={calendarRef}
+      events={EVENTS}
+      //...
+    />
+  </Fragment>
+};
+```
+
+The `calendarRef` holds the entire internal state of the Scheduler component. Perhaps the most useful method inside the `calendarRef` is `handleState`, example:
+
+```
+calendarRef.current.scheduler.handleState(value, key);
+```
+
+consider looking inside `SchedulerRef` type to see all fields & methods available.
+
+### Demos
+
+- [Basic](https://codesandbox.io/p/sandbox/standard-x24pqk)
+- [Remote Data](https://codesandbox.io/s/remote-data-j13ei)
+- [Custom Fields](https://codesandbox.io/s/custom-fields-b2kbv)
+- [Editor/Viewer Override](https://codesandbox.io/s/customeditor-tt2pf)
+- [Resources/View Mode](https://codesandbox.io/s/resources-7wlcy)
+- [Custom Cell Action](https://codesandbox.io/s/custom-cell-action-n02dv)
+- [Custom Event Renderer](https://codesandbox.io/s/custom-event-renderer-rkf4xw)
+
+### Todos
+
+- [ ] Tests
+- [x] Drag&Drop - partially
+- [ ] Resizable
+- [x] Recurring events - partially
+- [x] Localization
+- [x] Hour format 12 | 24

package/dist/package.json

@@ -0,0 +1,65 @@
+{
+  "name": "@isma91/react-scheduler",
+  "version": "4.0.7",
+  "description": "React scheduler component based on Material-UI & date-fns",
+  "files": [
+    "dist"
+  ],
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    }
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/isma91/react-scheduler.git"
+  },
+  "author": "isma91 (fork of Aldabil)",
+  "bugs": {
+    "url": "https://github.com/isma91/react-scheduler/issues"
+  },
+  "keywords": [
+    "react",
+    "material-ui",
+    "calendar",
+    "scheduler"
+  ],
+  "license": "MIT",
+  "peerDependencies": {
+    "@mui/icons-material": ">=7.0.0",
+    "@mui/material": ">=7.0.0",
+    "@mui/x-date-pickers": ">=7.0.0",
+    "date-fns": ">=4.0.0",
+    "react": ">=18.0.0",
+    "react-dom": ">=18.0.0",
+    "rrule": ">=2.8.1"
+  },
+  "peerDependenciesMeta": {
+    "rrule": {
+      "optional": true
+    }
+  },
+  "eslintConfig": {
+    "extends": [
+      "react-app",
+      "react-app/jest"
+    ]
+  },
+  "browserslist": {
+    "production": [
+      ">0.2%",
+      "not dead",
+      "not op_mini all"
+    ],
+    "development": [
+      "last 1 chrome version",
+      "last 1 firefox version",
+      "last 1 safari version"
+    ]
+  },
+  "homepage": "https://github.com/aldabil21/react-scheduler#readme"
+}

package/package.json

@@ -1,19 +1,45 @@
 {
   "name": "@isma91/react-scheduler",
-  "version": "4.0.6",
+  "version": "4.0.7",
   "description": "React scheduler component based on Material-UI & date-fns",
   "files": [
-    "*"
+    "dist"
   ],
   "type": "module",
+  "scripts": {
+    "start": "vite serve",
+    "build": "vite build --mode production",
+    "postbuild": "node ./scripts/post-pack.js",
+    "local:pack": "npm run build && cd dist && npm pack && mv *.tgz ../",
+    "format": "prettier --check \"**/*.{js,jsx,ts,tsx,json}\"",
+    "format:write": "prettier --write \"**/*.{js,jsx,ts,tsx,json}\"",
+    "lint": "npm run types && eslint .",
+    "lint:fix": "eslint . --fix",
+    "types": "tsc --noEmit",
+    "prepare": "husky install",
+    "pre:commit": "lint-staged",
+    "test": "jest",
+    "test:watch": "jest --watch",
+    "test:ci": "jest --ci",
+    "check:dist": "node ./scripts/check-dist.mjs",
+    "prepublishOnly": "npm run build && npm run check:dist && npm pack --dry-run"
+  },
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
   "exports": {
-    "./types": {
-      "import": "./types.d.ts"
-    },
     ".": {
-      "import": "./index.js"
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
     }
   },
+  "lint-staged": {
+    "**/*.{ts,js,tsx,jsx}": [
+      "npm run lint"
+    ],
+    "**/*.{ts,js,tsx,jsx,json,yml}": [
+      "npm run format:write"
+    ]
+  },
   "repository": {
     "type": "git",
     "url": "https://github.com/isma91/react-scheduler.git"
@@ -29,6 +55,55 @@
     "scheduler"
   ],
   "license": "MIT",
+  "devDependencies": {
+    "@emotion/react": "^11.14.0",
+    "@emotion/styled": "^11.14.0",
+    "@eslint/compat": "^1.2.6",
+    "@eslint/eslintrc": "^3.2.0",
+    "@eslint/js": "^9.20.0",
+    "@mui/icons-material": ">=7.0.2",
+    "@mui/material": ">=7.0.2",
+    "@mui/x-date-pickers": ">=8.0.0",
+    "@testing-library/dom": "^10.4.0",
+    "@testing-library/jest-dom": "^6.6.3",
+    "@testing-library/react": "^16.2.0",
+    "@testing-library/user-event": "^14.6.1",
+    "@types/jest": "^29.5.14",
+    "@types/react": "^19.0.10",
+    "@types/react-dom": "^19.0.4",
+    "@types/rollup-plugin-peer-deps-external": "^2",
+    "@typescript-eslint/parser": "^8.24.1",
+    "@vitejs/plugin-react": "^4.3.4",
+    "date-fns": ">=4.1.0",
+    "eslint": "^9.20.1",
+    "eslint-import-resolver-typescript": "^3.8.3",
+    "eslint-plugin-import": "^2.31.0",
+    "eslint-plugin-jsx-a11y": "^6.10.2",
+    "eslint-plugin-promise": "^7.2.1",
+    "eslint-plugin-react": "^7.37.4",
+    "eslint-plugin-react-hooks": "^5.2.0",
+    "eslint-plugin-react-refresh": "^0.4.19",
+    "globals": "^16.0.0",
+    "husky": "^9.1.7",
+    "jest": "^29.7.0",
+    "jest-environment-jsdom": "^29.7.0",
+    "lint-staged": "^15.4.3",
+    "prettier": "^3.5.1",
+    "react": ">=19.0.0",
+    "react-dom": "^19.0.0",
+    "react-router-dom": "^7.3.0",
+    "rollup-plugin-peer-deps-external": "^2.2.4",
+    "rrule": "^2.8.1",
+    "ts-jest": "^29.2.5",
+    "ts-node": "^10.9.2",
+    "typescript": "^5.7.3",
+    "typescript-eslint": "^8.24.1",
+    "vite": "^6.1.1",
+    "vite-plugin-checker": "^0.9.0",
+    "vite-plugin-dts": "^4.5.0",
+    "vite-plugin-svgr": "^4.3.0",
+    "vite-tsconfig-paths": "^5.1.4"
+  },
   "peerDependencies": {
     "@mui/icons-material": ">=7.0.0",
     "@mui/material": ">=7.0.0",
@@ -60,6 +135,5 @@
       "last 1 firefox version",
       "last 1 safari version"
     ]
-  },
-  "homepage": "https://github.com/aldabil21/react-scheduler#readme"
-}
+  }
+}