react-photo-calendar 0.1.0

package/dist/primitives/PhotoCalendarDay.d.ts

@@ -0,0 +1,7 @@
+import type { DayRenderProps } from '../types/calendar';
+export interface PhotoCalendarDayProps {
+    day: DayRenderProps;
+    className?: string;
+}
+export declare function PhotoCalendarDay({ day, className }: PhotoCalendarDayProps): import("react/jsx-runtime").JSX.Element;
+//# sourceMappingURL=PhotoCalendarDay.d.ts.map

package/dist/primitives/PhotoCalendarDay.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"PhotoCalendarDay.d.ts","sourceRoot":"","sources":["../../src/primitives/PhotoCalendarDay.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAExD,MAAM,WAAW,qBAAqB;IACpC,GAAG,EAAE,cAAc,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,wBAAgB,gBAAgB,CAAC,EAAE,GAAG,EAAE,SAAS,EAAE,EAAE,qBAAqB,2CAiCzE"}

package/dist/primitives/PhotoCalendarMonthGrid.d.ts

@@ -0,0 +1,17 @@
+import type { ReactNode } from 'react';
+import type { DayRenderProps } from '../types/calendar';
+import type { PhotoCalendarDayState } from '../hooks/usePhotoCalendarState';
+export type { DayRenderProps } from '../types/calendar';
+export interface PhotoCalendarMonthGridProps {
+    className?: string;
+    /**
+     * Custom render function for the contents inside each day button.
+     */
+    renderDay?: (props: DayRenderProps) => ReactNode;
+    /**
+     * Optional override for day states, enabling multi-month rendering scenarios.
+     */
+    dayStates?: PhotoCalendarDayState[];
+}
+export declare function PhotoCalendarMonthGrid({ className, renderDay, dayStates }: PhotoCalendarMonthGridProps): import("react/jsx-runtime").JSX.Element;
+//# sourceMappingURL=PhotoCalendarMonthGrid.d.ts.map

package/dist/primitives/PhotoCalendarMonthGrid.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"PhotoCalendarMonthGrid.d.ts","sourceRoot":"","sources":["../../src/primitives/PhotoCalendarMonthGrid.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAIvC,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AACxD,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,gCAAgC,CAAC;AAE5E,YAAY,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAExD,MAAM,WAAW,2BAA2B;IAC1C,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;;OAEG;IACH,SAAS,CAAC,EAAE,CAAC,KAAK,EAAE,cAAc,KAAK,SAAS,CAAC;IACjD;;OAEG;IACH,SAAS,CAAC,EAAE,qBAAqB,EAAE,CAAC;CACrC;AAED,wBAAgB,sBAAsB,CAAC,EAAE,SAA2B,EAAE,SAAS,EAAE,SAAS,EAAE,EAAE,2BAA2B,2CAgDxH"}

package/dist/primitives/PhotoCalendarNavigation.d.ts

@@ -0,0 +1,17 @@
+import type { ReactNode } from 'react';
+import type { PhotoCalendarNavigationState } from '../hooks/usePhotoCalendarState';
+export interface NavigationRenderProps extends PhotoCalendarNavigationState {
+    currentYear: number;
+    currentMonth: number;
+    monthLabel: string;
+    monthNames: ReadonlyArray<string>;
+}
+export interface PhotoCalendarNavigationProps {
+    /**
+     * Provide custom navigation markup using render props.
+     * The default renders the built-in CalendarBanner.
+     */
+    children?: (props: NavigationRenderProps) => ReactNode;
+}
+export declare function PhotoCalendarNavigation({ children }: PhotoCalendarNavigationProps): import("react/jsx-runtime").JSX.Element;
+//# sourceMappingURL=PhotoCalendarNavigation.d.ts.map

package/dist/primitives/PhotoCalendarNavigation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"PhotoCalendarNavigation.d.ts","sourceRoot":"","sources":["../../src/primitives/PhotoCalendarNavigation.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAGvC,OAAO,KAAK,EAAE,4BAA4B,EAAE,MAAM,gCAAgC,CAAC;AAEnF,MAAM,WAAW,qBAAsB,SAAQ,4BAA4B;IACzE,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC;CACnC;AAED,MAAM,WAAW,4BAA4B;IAC3C;;;OAGG;IACH,QAAQ,CAAC,EAAE,CAAC,KAAK,EAAE,qBAAqB,KAAK,SAAS,CAAC;CACxD;AAED,wBAAgB,uBAAuB,CAAC,EAAE,QAAQ,EAAE,EAAE,4BAA4B,2CAejF"}

package/dist/primitives/PhotoCalendarRoot.d.ts

@@ -0,0 +1,7 @@
+import type { ReactNode } from 'react';
+import { type PhotoCalendarState, type UsePhotoCalendarStateOptions } from '../hooks/usePhotoCalendarState';
+export interface PhotoCalendarRootProps extends UsePhotoCalendarStateOptions {
+    children?: ReactNode | ((state: PhotoCalendarState) => ReactNode);
+}
+export declare function PhotoCalendarRoot({ children, ...options }: PhotoCalendarRootProps): import("react/jsx-runtime").JSX.Element;
+//# sourceMappingURL=PhotoCalendarRoot.d.ts.map

package/dist/primitives/PhotoCalendarRoot.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"PhotoCalendarRoot.d.ts","sourceRoot":"","sources":["../../src/primitives/PhotoCalendarRoot.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAEvC,OAAO,EAAyB,KAAK,kBAAkB,EAAE,KAAK,4BAA4B,EAAE,MAAM,gCAAgC,CAAC;AAEnI,MAAM,WAAW,sBAAuB,SAAQ,4BAA4B;IAC1E,QAAQ,CAAC,EAAE,SAAS,GAAG,CAAC,CAAC,KAAK,EAAE,kBAAkB,KAAK,SAAS,CAAC,CAAC;CACnE;AAED,wBAAgB,iBAAiB,CAAC,EAAE,QAAQ,EAAE,GAAG,OAAO,EAAE,EAAE,sBAAsB,2CAKjF"}

package/dist/primitives/PhotoCalendarWeekdays.d.ts

@@ -0,0 +1,15 @@
+import type { ReactNode } from 'react';
+export interface WeekdayRenderProps {
+    shortLabels: ReadonlyArray<string>;
+    longLabels: ReadonlyArray<string>;
+}
+export interface PhotoCalendarWeekdaysProps {
+    className?: string;
+    /**
+     * Optional render prop to customise weekday header markup.
+     * Defaults to rendering span elements matching the current CSS classes.
+     */
+    children?: (props: WeekdayRenderProps) => ReactNode;
+}
+export declare function PhotoCalendarWeekdays({ className, children }: PhotoCalendarWeekdaysProps): import("react/jsx-runtime").JSX.Element;
+//# sourceMappingURL=PhotoCalendarWeekdays.d.ts.map

package/dist/primitives/PhotoCalendarWeekdays.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"PhotoCalendarWeekdays.d.ts","sourceRoot":"","sources":["../../src/primitives/PhotoCalendarWeekdays.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAGvC,MAAM,WAAW,kBAAkB;IACjC,WAAW,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC;IACnC,UAAU,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC;CACnC;AAED,MAAM,WAAW,0BAA0B;IACzC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;;;OAGG;IACH,QAAQ,CAAC,EAAE,CAAC,KAAK,EAAE,kBAAkB,KAAK,SAAS,CAAC;CACrD;AAED,wBAAgB,qBAAqB,CAAC,EAAE,SAA+B,EAAE,QAAQ,EAAE,EAAE,0BAA0B,2CAyB9G"}

package/dist/types/calendar.d.ts

@@ -0,0 +1,25 @@
+import type { ReactNode } from 'react';
+export interface VisibleRange {
+    start: Date;
+    end: Date;
+    startIso: string;
+    endIso: string;
+}
+export interface DayRenderContext {
+    date: Date;
+    isoDate: string;
+    day: number;
+    isCurrentMonth: boolean;
+    isToday: boolean;
+    photos: string[];
+    visibleThumbnails: string[];
+    overflow: number;
+    selectDay: () => void;
+    defaultContent?: ReactNode;
+}
+export interface DayRenderProps extends DayRenderContext {
+    defaultContent: ReactNode;
+    ariaLabel: string;
+    isSelectable: boolean;
+}
+//# sourceMappingURL=calendar.d.ts.map

package/dist/types/calendar.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"calendar.d.ts","sourceRoot":"","sources":["../../src/types/calendar.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAEvC,MAAM,WAAW,YAAY;IAC3B,KAAK,EAAE,IAAI,CAAC;IACZ,GAAG,EAAE,IAAI,CAAC;IACV,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,IAAI,CAAC;IACX,OAAO,EAAE,MAAM,CAAC;IAChB,GAAG,EAAE,MAAM,CAAC;IACZ,cAAc,EAAE,OAAO,CAAC;IACxB,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,iBAAiB,EAAE,MAAM,EAAE,CAAC;IAC5B,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,IAAI,CAAC;IACtB,cAAc,CAAC,EAAE,SAAS,CAAC;CAC5B;AAED,MAAM,WAAW,cAAe,SAAQ,gBAAgB;IACtD,cAAc,EAAE,SAAS,CAAC;IAC1B,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,EAAE,OAAO,CAAC;CACvB"}

package/dist/types/photo.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Represents a single photo entry used by the calendar.
+ * The first photo URL in the array will be displayed as the day's preview.
+ */
+export interface PhotoEntry {
+    /**
+     * ISO datetime string indicating when this photo was taken
+     */
+    datetime: string;
+    /**
+     * Array of photo URLs, the first one will be displayed in the calendar
+     */
+    photos: string[];
+}
+//# sourceMappingURL=photo.d.ts.map

package/dist/types/photo.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"photo.d.ts","sourceRoot":"","sources":["../../src/types/photo.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,WAAW,UAAU;IACzB;;OAEG;IACH,QAAQ,EAAE,MAAM,CAAC;IACjB;;OAEG;IACH,MAAM,EAAE,MAAM,EAAE,CAAC;CAClB"}

package/dist/utils/calendar.d.ts

@@ -0,0 +1,15 @@
+export interface CalendarCell {
+    date: Date;
+    isoDate: string;
+    day: number;
+    inCurrentMonth: boolean;
+}
+export declare function parseMonthKey(value?: string): Date;
+export declare function createCalendarCells(monthDate: Date, firstDayOfWeek: number): CalendarCell[];
+export declare function formatMonthKey(date: Date): string;
+export declare function addMonths(date: Date, offset: number): Date;
+export declare function getVisibleRange(cells: CalendarCell[]): {
+    start: Date;
+    end: Date;
+} | null;
+//# sourceMappingURL=calendar.d.ts.map

package/dist/utils/calendar.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"calendar.d.ts","sourceRoot":"","sources":["../../src/utils/calendar.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,IAAI,CAAC;IACX,OAAO,EAAE,MAAM,CAAC;IAChB,GAAG,EAAE,MAAM,CAAC;IACZ,cAAc,EAAE,OAAO,CAAC;CACzB;AAED,wBAAgB,aAAa,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAgBlD;AAMD,wBAAgB,mBAAmB,CAAC,SAAS,EAAE,IAAI,EAAE,cAAc,EAAE,MAAM,GAAG,YAAY,EAAE,CAyB3F;AAED,wBAAgB,cAAc,CAAC,IAAI,EAAE,IAAI,GAAG,MAAM,CAGjD;AAED,wBAAgB,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI,CAE1D;AAED,wBAAgB,eAAe,CAAC,KAAK,EAAE,YAAY,EAAE,GAAG;IAAE,KAAK,EAAE,IAAI,CAAC;IAAC,GAAG,EAAE,IAAI,CAAA;CAAE,GAAG,IAAI,CAYxF"}

package/dist/utils/photos.d.ts

@@ -0,0 +1,6 @@
+import type { PhotoEntry } from '../types/photo';
+/**
+ * Converts a list of entries into a quick lookup map keyed by ISO date (yyyy-mm-dd).
+ */
+export declare function createPhotosByDateMap(entries?: PhotoEntry[]): Record<string, string[]>;
+//# sourceMappingURL=photos.d.ts.map

package/dist/utils/photos.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"photos.d.ts","sourceRoot":"","sources":["../../src/utils/photos.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAEjD;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,OAAO,CAAC,EAAE,UAAU,EAAE,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAatF"}

package/package.json

@@ -0,0 +1,89 @@
+{
+  "name": "react-photo-calendar",
+  "version": "0.1.0",
+  "description": "Headless, composable React month-view calendar that renders photo thumbnails per day.",
+  "keywords": [
+    "react",
+    "calendar",
+    "photo",
+    "month-view",
+    "headless",
+    "components",
+    "typescript"
+  ],
+  "license": "MIT",
+  "author": "Leonardo Merza",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/ljmerza/react-photo-calendar.git"
+  },
+  "homepage": "https://github.com/ljmerza/react-photo-calendar#readme",
+  "bugs": {
+    "url": "https://github.com/ljmerza/react-photo-calendar/issues"
+  },
+  "type": "module",
+  "main": "./dist/photo-calendar.cjs",
+  "module": "./dist/photo-calendar.mjs",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/photo-calendar.mjs",
+      "require": "./dist/photo-calendar.cjs"
+    },
+    "./styles.css": "./dist/photo-calendar.css",
+    "./package.json": "./package.json"
+  },
+  "sideEffects": [
+    "**/*.css"
+  ],
+  "files": [
+    "dist"
+  ],
+  "engines": {
+    "node": ">=20"
+  },
+  "scripts": {
+    "dev": "storybook dev -p 6006",
+    "build": "vite build && tsc --project tsconfig.build.json --emitDeclarationOnly",
+    "prepublishOnly": "npm run build",
+    "preview": "storybook build",
+    "lint": "eslint .",
+    "typecheck": "tsc --noEmit",
+    "test": "vitest run",
+    "test:coverage": "vitest run --coverage",
+    "storybook": "storybook dev -p 6006",
+    "storybook:build": "storybook build"
+  },
+  "peerDependencies": {
+    "react": "^18.2.0 || ^19.0.0",
+    "react-dom": "^18.2.0 || ^19.0.0"
+  },
+  "devDependencies": {
+    "@eslint/js": "^9.17.0",
+    "@storybook/addon-essentials": "^8.4.11",
+    "@storybook/react": "^8.4.11",
+    "@storybook/react-vite": "^8.4.11",
+    "@storybook/test": "^8.4.11",
+    "@tailwindcss/postcss": "^4.1.16",
+    "@testing-library/react": "^16.2.0",
+    "@types/react": "^19.0.8",
+    "@types/react-dom": "^19.0.3",
+    "@vitejs/plugin-react": "^4.3.2",
+    "@vitest/coverage-v8": "^3.0.5",
+    "autoprefixer": "^10.4.21",
+    "eslint": "^9.17.0",
+    "eslint-plugin-react-hooks": "^5.1.0",
+    "globals": "^15.14.0",
+    "jsdom": "^27.0.1",
+    "postcss": "^8.5.6",
+    "react": "^19.0.0",
+    "react-dom": "^19.0.0",
+    "tailwindcss": "^4.1.16",
+    "tslib": "^2.8.1",
+    "typescript": "^5.7.2",
+    "typescript-eslint": "^8.19.0",
+    "vite": "^6.0.0",
+    "vitest": "^3.0.5"
+  }
+}