react-native-bikram-sambat 0.1.0

package/lib/typescript/src/theme/types.d.ts

@@ -0,0 +1,43 @@
+import type { TextStyle } from 'react-native';
+export type CalendarTheme = {
+    colors: {
+        background: string;
+        surface: string;
+        text: string;
+        mutedText: string;
+        primary: string;
+        primaryText: string;
+        todayBorder: string;
+        disabledText: string;
+        outsideMonthText: string;
+        border: string;
+        marker: string;
+        overlay: string;
+        modalBackground: string;
+        fieldBackground: string;
+        fieldBorder: string;
+        placeholderText: string;
+        rangeBackground: string;
+        rangeText: string;
+        rangeStartBackground: string;
+        rangeEndBackground: string;
+        danger: string;
+    };
+    radius: {
+        day: number;
+        calendar: number;
+    };
+    spacing: {
+        xs: number;
+        sm: number;
+        md: number;
+        lg: number;
+    };
+    typography: {
+        header: TextStyle;
+        weekday: TextStyle;
+        day: TextStyle;
+    };
+};
+export type ColorScheme = 'light' | 'dark' | 'system';
+//# sourceMappingURL=types.d.ts.map

package/lib/typescript/src/theme/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../src/theme/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAE9C,MAAM,MAAM,aAAa,GAAG;IAC1B,MAAM,EAAE;QACN,UAAU,EAAE,MAAM,CAAC;QACnB,OAAO,EAAE,MAAM,CAAC;QAChB,IAAI,EAAE,MAAM,CAAC;QACb,SAAS,EAAE,MAAM,CAAC;QAClB,OAAO,EAAE,MAAM,CAAC;QAChB,WAAW,EAAE,MAAM,CAAC;QACpB,WAAW,EAAE,MAAM,CAAC;QACpB,YAAY,EAAE,MAAM,CAAC;QACrB,gBAAgB,EAAE,MAAM,CAAC;QACzB,MAAM,EAAE,MAAM,CAAC;QACf,MAAM,EAAE,MAAM,CAAC;QACf,OAAO,EAAE,MAAM,CAAC;QAChB,eAAe,EAAE,MAAM,CAAC;QACxB,eAAe,EAAE,MAAM,CAAC;QACxB,WAAW,EAAE,MAAM,CAAC;QACpB,eAAe,EAAE,MAAM,CAAC;QACxB,eAAe,EAAE,MAAM,CAAC;QACxB,SAAS,EAAE,MAAM,CAAC;QAClB,oBAAoB,EAAE,MAAM,CAAC;QAC7B,kBAAkB,EAAE,MAAM,CAAC;QAC3B,MAAM,EAAE,MAAM,CAAC;KAChB,CAAC;IACF,MAAM,EAAE;QACN,GAAG,EAAE,MAAM,CAAC;QACZ,QAAQ,EAAE,MAAM,CAAC;KAClB,CAAC;IACF,OAAO,EAAE;QACP,EAAE,EAAE,MAAM,CAAC;QACX,EAAE,EAAE,MAAM,CAAC;QACX,EAAE,EAAE,MAAM,CAAC;QACX,EAAE,EAAE,MAAM,CAAC;KACZ,CAAC;IACF,UAAU,EAAE;QACV,MAAM,EAAE,SAAS,CAAC;QAClB,OAAO,EAAE,SAAS,CAAC;QACnB,GAAG,EAAE,SAAS,CAAC;KAChB,CAAC;CACH,CAAC;AAEF,MAAM,MAAM,WAAW,GAAG,OAAO,GAAG,MAAM,GAAG,QAAQ,CAAC"}

package/lib/typescript/src/utils/date-helpers.d.ts

@@ -0,0 +1,27 @@
+import type { BSDateValue } from '../core/types';
+import type { LocaleCode, NumeralSystem, CalendarLocale } from '../core/locale';
+export declare function safeFormatBSDate(date: BSDateValue | null | undefined, pattern: string, locale?: LocaleCode | CalendarLocale, numerals?: NumeralSystem): string | null;
+export declare function getSafeInitialBSDate(value: BSDateValue | null | undefined, defaultValue: BSDateValue | undefined): BSDateValue;
+export declare function isDateDisabled(date: BSDateValue, options: {
+    minDate?: BSDateValue;
+    maxDate?: BSDateValue;
+    disabledDates?: string[] | ((date: BSDateValue) => boolean);
+    dateKey: string;
+}): boolean;
+export declare function createDateAccessibilityLabel(date: BSDateValue, locale: CalendarLocale, options: {
+    selected?: boolean;
+    today?: boolean;
+    disabled?: boolean;
+    outsideMonth?: boolean;
+    rangeStart?: boolean;
+    rangeEnd?: boolean;
+    inRange?: boolean;
+    markedLabel?: string;
+}): string;
+export declare function warnInvalidDateInDev(message: string, value: unknown): void;
+export declare function warnOutOfRangeInDev(value: BSDateValue, range: {
+    min: number;
+    max: number;
+}): void;
+export declare function warnMinMaxInDev(minDate: BSDateValue | undefined, maxDate: BSDateValue | undefined): void;
+//# sourceMappingURL=date-helpers.d.ts.map

package/lib/typescript/src/utils/date-helpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"date-helpers.d.ts","sourceRoot":"","sources":["../../../../src/utils/date-helpers.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAGjD,OAAO,KAAK,EAAE,UAAU,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAEhF,wBAAgB,gBAAgB,CAC9B,IAAI,EAAE,WAAW,GAAG,IAAI,GAAG,SAAS,EACpC,OAAO,EAAE,MAAM,EACf,MAAM,CAAC,EAAE,UAAU,GAAG,cAAc,EACpC,QAAQ,CAAC,EAAE,aAAa,GACvB,MAAM,GAAG,IAAI,CAUf;AAED,wBAAgB,oBAAoB,CAClC,KAAK,EAAE,WAAW,GAAG,IAAI,GAAG,SAAS,EACrC,YAAY,EAAE,WAAW,GAAG,SAAS,GACpC,WAAW,CAUb;AAED,wBAAgB,cAAc,CAC5B,IAAI,EAAE,WAAW,EACjB,OAAO,EAAE;IACP,OAAO,CAAC,EAAE,WAAW,CAAC;IACtB,OAAO,CAAC,EAAE,WAAW,CAAC;IACtB,aAAa,CAAC,EAAE,MAAM,EAAE,GAAG,CAAC,CAAC,IAAI,EAAE,WAAW,KAAK,OAAO,CAAC,CAAC;IAC5D,OAAO,EAAE,MAAM,CAAC;CACjB,GACA,OAAO,CAeT;AAQD,wBAAgB,4BAA4B,CAC1C,IAAI,EAAE,WAAW,EACjB,MAAM,EAAE,cAAc,EACtB,OAAO,EAAE;IACP,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB,GACA,MAAM,CA8BR;AAED,wBAAgB,oBAAoB,CAClC,OAAO,EAAE,MAAM,EACf,KAAK,EAAE,OAAO,GACb,IAAI,CAIN;AAED,wBAAgB,mBAAmB,CACjC,KAAK,EAAE,WAAW,EAClB,KAAK,EAAE;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CAAE,GAClC,IAAI,CAON;AAED,wBAAgB,eAAe,CAC7B,OAAO,EAAE,WAAW,GAAG,SAAS,EAChC,OAAO,EAAE,WAAW,GAAG,SAAS,GAC/B,IAAI,CAQN"}

package/lib/typescript/src/utils/index.d.ts

@@ -0,0 +1,2 @@
+export { safeFormatBSDate, getSafeInitialBSDate, isDateDisabled, createDateAccessibilityLabel, warnInvalidDateInDev, warnOutOfRangeInDev, warnMinMaxInDev, } from './date-helpers';
+//# sourceMappingURL=index.d.ts.map

package/lib/typescript/src/utils/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/utils/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,gBAAgB,EAChB,oBAAoB,EACpB,cAAc,EACd,4BAA4B,EAC5B,oBAAoB,EACpB,mBAAmB,EACnB,eAAe,GAChB,MAAM,gBAAgB,CAAC"}

package/package.json

@@ -0,0 +1,85 @@
+{
+  "name": "react-native-bikram-sambat",
+  "version": "0.1.0",
+  "description": "A production-grade Bikram Sambat calendar engine and React Native date picker for React Native.",
+  "main": "./lib/commonjs/index.js",
+  "module": "./lib/module/index.js",
+  "types": "./lib/typescript/src/index.d.ts",
+  "react-native": "./src/index.ts",
+  "source": "./src/index.ts",
+  "sideEffects": false,
+  "exports": {
+    ".": {
+      "react-native": "./src/index.ts",
+      "types": "./lib/typescript/src/index.d.ts",
+      "import": "./lib/module/index.js",
+      "require": "./lib/commonjs/index.js"
+    },
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "src",
+    "lib",
+    "README.md",
+    "LICENSE"
+  ],
+  "keywords": [
+    "react-native",
+    "bikram-sambat",
+    "nepali-calendar",
+    "bs-date",
+    "date-picker",
+    "calendar",
+    "nepali-date",
+    "bs-to-ad",
+    "ad-to-bs"
+  ],
+  "author": "",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/your-org/react-native-bikram-sambat.git"
+  },
+  "bugs": {
+    "url": "https://github.com/your-org/react-native-bikram-sambat/issues"
+  },
+  "homepage": "https://github.com/your-org/react-native-bikram-sambat#readme",
+  "publishConfig": {
+    "access": "public"
+  },
+  "peerDependencies": {
+    "react": ">=18",
+    "react-native": ">=0.73"
+  },
+  "devDependencies": {
+    "@types/jest": "^29.5.12",
+    "@types/react": "^19.2.14",
+    "jest": "^29.7.0",
+    "react-native-builder-bob": "^0.30.0",
+    "rimraf": "^6.0.1",
+    "ts-jest": "^29.2.5",
+    "typescript": "^5.5.4"
+  },
+  "scripts": {
+    "build": "bob build",
+    "typecheck": "tsc --noEmit",
+    "test": "jest",
+    "clean": "rimraf lib",
+    "prepack": "bob build",
+    "pack:dry": "npm pack --dry-run"
+  },
+  "react-native-builder-bob": {
+    "source": "src",
+    "output": "lib",
+    "targets": [
+      "commonjs",
+      "module",
+      [
+        "typescript",
+        {
+          "project": "tsconfig.build.json"
+        }
+      ]
+    ]
+  }
+}

package/src/accessibility/index.ts

@@ -0,0 +1,5 @@
+export {
+  getDayAccessibilityLabel,
+  HEADER_PREV_MONTH_LABEL,
+  HEADER_NEXT_MONTH_LABEL,
+} from './labels';

package/src/accessibility/labels.ts

@@ -0,0 +1,22 @@
+import type { BSDateValue } from '../core/types';
+import type { CalendarLocale } from '../core/locale';
+import { formatBS } from '../core/format';
+
+export function getDayAccessibilityLabel(
+  date: BSDateValue,
+  locale: CalendarLocale,
+  selected: boolean,
+  today: boolean,
+  disabled: boolean
+): string {
+  const dateStr = formatBS(date, 'yyyy MMMM d', { locale });
+
+  if (disabled) return `${dateStr}, disabled`;
+  if (selected) return `${dateStr}, selected`;
+  if (today) return `${dateStr}, today`;
+
+  return dateStr;
+}
+
+export const HEADER_PREV_MONTH_LABEL = 'Previous month';
+export const HEADER_NEXT_MONTH_LABEL = 'Next month';

package/src/calendar/calendar-types.ts

@@ -0,0 +1,25 @@
+import type { BSDateValue } from '../core/types';
+
+export type CalendarMonthGridOptions = {
+  year: number;
+  month: number;
+  weekStartsOn?: 0 | 1 | 2 | 3 | 4 | 5 | 6;
+  minDate?: BSDateValue;
+  maxDate?: BSDateValue;
+  today?: BSDateValue;
+};
+
+export type CalendarMonthCell = {
+  key: string;
+  date: BSDateValue;
+  day: number;
+  inCurrentMonth: boolean;
+  isToday: boolean;
+  isDisabled: boolean;
+};
+
+export type CalendarMonthGrid = {
+  year: number;
+  month: number;
+  weeks: CalendarMonthCell[][];
+};

package/src/calendar/get-calendar-month-grid.ts

@@ -0,0 +1,125 @@
+import type { BSDateValue } from '../core/types';
+import { createBSDateKey } from '../core/dateKey';
+import { getBSMonthLength } from '../core/validation';
+import { getSupportedBSYearRange } from '../core/bsData';
+import { compareBS } from '../core/arithmetic';
+import { toAD } from '../core/conversion';
+import { todayBS } from '../core/arithmetic';
+import type { CalendarMonthCell, CalendarMonthGrid, CalendarMonthGridOptions } from './calendar-types';
+
+function getWeekday(bsDate: BSDateValue): number {
+  const ad = toAD(bsDate);
+  const utcDate = new Date(Date.UTC(ad.year, ad.month - 1, ad.day));
+  return utcDate.getUTCDay();
+}
+
+function safeGetBSMonthLength(year: number, month: number): number | null {
+  try {
+    return getBSMonthLength(year, month);
+  } catch {
+    return null;
+  }
+}
+
+function safeCreateBSDateKey(date: BSDateValue): string {
+  try {
+    return createBSDateKey(date);
+  } catch {
+    return `${date.year}-${String(date.month).padStart(2, '0')}-${String(date.day).padStart(2, '0')}`;
+  }
+}
+
+function isDateInRange(year: number): boolean {
+  const range = getSupportedBSYearRange();
+  return year >= range.min && year <= range.max;
+}
+
+function makeCell(
+  year: number,
+  month: number,
+  day: number,
+  inCurrentMonth: boolean,
+  todayDate: BSDateValue | null,
+  minDate: BSDateValue | undefined,
+  maxDate: BSDateValue | undefined
+): CalendarMonthCell {
+  const date: BSDateValue = { calendar: 'BS', year, month, day };
+  const key = safeCreateBSDateKey(date);
+  const inRange = isDateInRange(year);
+  const isToday = inRange && todayDate !== null && compareBS(date, todayDate) === 0;
+  const isDisabled =
+    !inRange ||
+    (minDate !== undefined && compareBS(date, minDate) < 0) ||
+    (maxDate !== undefined && compareBS(date, maxDate) > 0);
+
+  return {
+    key,
+    date,
+    day,
+    inCurrentMonth,
+    isToday,
+    isDisabled,
+  };
+}
+
+export function getCalendarMonthGrid(
+  options: CalendarMonthGridOptions
+): CalendarMonthGrid {
+  const { year, month, weekStartsOn = 0, minDate, maxDate } = options;
+
+  const monthLength = getBSMonthLength(year, month);
+  const firstDay: BSDateValue = { calendar: 'BS', year, month, day: 1 };
+  const firstWeekday = getWeekday(firstDay);
+
+  const leadingDays = (firstWeekday - weekStartsOn + 7) % 7;
+
+  let prevMonth = month - 1;
+  let prevYear = year;
+  if (prevMonth < 1) {
+    prevMonth = 12;
+    prevYear -= 1;
+  }
+  const prevMonthLength = safeGetBSMonthLength(prevYear, prevMonth) ?? 30;
+
+  let todayDate: BSDateValue | null = null;
+  try {
+    todayDate = options.today ?? todayBS();
+  } catch {
+    todayDate = null;
+  }
+
+  const cells: CalendarMonthCell[] = [];
+
+  for (let i = 0; i < leadingDays; i++) {
+    const day = prevMonthLength - leadingDays + i + 1;
+    cells.push(makeCell(prevYear, prevMonth, day, false, todayDate, minDate, maxDate));
+  }
+
+  for (let day = 1; day <= monthLength; day++) {
+    cells.push(makeCell(year, month, day, true, todayDate, minDate, maxDate));
+  }
+
+  let nextMonth = month + 1;
+  let nextYear = year;
+  if (nextMonth > 12) {
+    nextMonth = 1;
+    nextYear += 1;
+  }
+
+  let trailingDay = 1;
+  while (cells.length % 7 !== 0) {
+    cells.push(makeCell(nextYear, nextMonth, trailingDay, false, todayDate, minDate, maxDate));
+    trailingDay += 1;
+  }
+
+  const weeks: CalendarMonthCell[][] = [];
+  for (let i = 0; i < cells.length; i += 7) {
+    weeks.push(cells.slice(i, i + 7));
+  }
+
+  return {
+    year,
+    month,
+    weeks,
+  };
+}

package/src/calendar/index.ts

@@ -0,0 +1,2 @@
+export type { CalendarMonthGridOptions, CalendarMonthCell, CalendarMonthGrid } from './calendar-types';
+export { getCalendarMonthGrid } from './get-calendar-month-grid';

package/src/components/NepaliCalendar/CalendarDay.tsx

@@ -0,0 +1,198 @@
+import React, { memo, useMemo } from 'react';
+import { Pressable, Text, View, StyleSheet } from 'react-native';
+import type { BSDateValue } from '../../core/types';
+import { toNepaliNumerals } from '../../core/numerals';
+import type { CalendarTheme } from '../../theme/types';
+import type { CalendarMarkedDate } from './types';
+
+type CalendarDayProps = {
+  date: BSDateValue;
+  day: number;
+  selected: boolean;
+  today: boolean;
+  disabled: boolean;
+  inCurrentMonth: boolean;
+  marked?: CalendarMarkedDate;
+  numerals: 'latin' | 'devanagari';
+  theme: CalendarTheme;
+  onPress: () => void;
+  rangeStart?: boolean;
+  rangeEnd?: boolean;
+  inRange?: boolean;
+  locale?: import('../../core/locale').CalendarLocale;
+};
+
+export const CalendarDay = memo(function CalendarDay({
+  date,
+  day,
+  selected,
+  today,
+  disabled,
+  inCurrentMonth,
+  marked,
+  numerals,
+  theme,
+  onPress,
+  rangeStart,
+  rangeEnd,
+  inRange,
+  locale,
+}: CalendarDayProps) {
+  const displayDay = useMemo(
+    () => (numerals === 'devanagari' ? toNepaliNumerals(day) : String(day)),
+    [day, numerals]
+  );
+
+  const isRangeEndpoint = rangeStart || rangeEnd;
+
+  const textColor = useMemo(() => {
+    if (disabled) return theme.colors.disabledText;
+    if (isRangeEndpoint) return theme.colors.primaryText;
+    if (inRange) return theme.colors.rangeText;
+    if (selected) return theme.colors.primaryText;
+    if (!inCurrentMonth) return theme.colors.outsideMonthText;
+    if (marked?.textColor) return marked.textColor;
+    return theme.colors.text;
+  }, [
+    disabled,
+    isRangeEndpoint,
+    inRange,
+    selected,
+    inCurrentMonth,
+    marked?.textColor,
+    theme.colors.disabledText,
+    theme.colors.primaryText,
+    theme.colors.rangeText,
+    theme.colors.outsideMonthText,
+    theme.colors.text,
+  ]);
+
+  const backgroundColor = useMemo(() => {
+    if (isRangeEndpoint) {
+      return rangeStart
+        ? theme.colors.rangeStartBackground
+        : theme.colors.rangeEndBackground;
+    }
+    if (inRange) return theme.colors.rangeBackground;
+    if (selected) return theme.colors.primary;
+    return undefined;
+  }, [
+    isRangeEndpoint,
+    rangeStart,
+    inRange,
+    selected,
+    theme.colors.rangeStartBackground,
+    theme.colors.rangeEndBackground,
+    theme.colors.rangeBackground,
+    theme.colors.primary,
+  ]);
+
+  const accessibilityLabel = useMemo(() => {
+    const parts: string[] = [];
+
+    if (locale) {
+      try {
+        const { formatBS } = require('../../core/format');
+        parts.push(formatBS(date, 'yyyy MMMM d', { locale }));
+      } catch {
+        parts.push(`${date.year}/${date.month}/${day}`);
+      }
+    } else {
+      parts.push(`${date.year}/${date.month}/${day}`);
+    }
+
+    if (rangeStart) parts.push('range start');
+    if (rangeEnd) parts.push('range end');
+    if (inRange && !rangeStart && !rangeEnd) parts.push('in selected range');
+    if (selected && !inRange) parts.push('selected');
+    if (today) parts.push('today');
+    if (disabled) parts.push('disabled');
+    if (!inCurrentMonth) parts.push('outside month');
+    if (marked?.label) parts.push(marked.label);
+
+    return parts.join(', ');
+  }, [
+    date,
+    day,
+    locale,
+    rangeStart,
+    rangeEnd,
+    inRange,
+    selected,
+    today,
+    disabled,
+    inCurrentMonth,
+    marked?.label,
+  ]);
+
+  const containerStyle = [
+    styles.dayContainer,
+    backgroundColor && { backgroundColor },
+    today && !isRangeEndpoint && !selected && !inRange && {
+      borderWidth: 1,
+      borderColor: theme.colors.todayBorder,
+    },
+    disabled && styles.dayDisabled,
+    inRange && !isRangeEndpoint && styles.dayInRange,
+    rangeStart && styles.dayRangeStart,
+    rangeEnd && styles.dayRangeEnd,
+  ];
+
+  return (
+    <Pressable
+      style={containerStyle}
+      onPress={onPress}
+      disabled={disabled}
+      accessibilityRole="button"
+      accessibilityLabel={accessibilityLabel}
+      accessibilityState={{ disabled, selected: selected || isRangeEndpoint }}
+    >
+      <Text style={[styles.dayText, { color: textColor }]}>{displayDay}</Text>
+      {marked && !disabled && (
+        <View
+          style={[
+            styles.marker,
+            { backgroundColor: marked.color ?? theme.colors.marker },
+          ]}
+        />
+      )}
+    </Pressable>
+  );
+});
+
+const styles = StyleSheet.create({
+  dayContainer: {
+    alignItems: 'center',
+    justifyContent: 'center',
+    height: 40,
+    width: 40,
+    borderRadius: 20,
+    position: 'relative',
+  },
+  dayInRange: {
+    borderRadius: 0,
+  },
+  dayRangeStart: {
+    borderTopLeftRadius: 20,
+    borderBottomLeftRadius: 20,
+  },
+  dayRangeEnd: {
+    borderTopRightRadius: 20,
+    borderBottomRightRadius: 20,
+  },
+  dayText: {
+    fontSize: 15,
+    textAlign: 'center',
+    lineHeight: 20,
+  },
+  dayDisabled: {
+    opacity: 0.5,
+  },
+  marker: {
+    position: 'absolute',
+    bottom: 4,
+    width: 4,
+    height: 4,
+    borderRadius: 2,
+  },
+});