chore: update pnpm to 11.9

.ai/AGENTS.md

@@ -0,0 +1,65 @@
+# AI Agent Instructions
+
+## Project Context
+
+TanStack Time is a headless time/calendar utility library for TS/JS, React, Solid, Vue, Svelte, Angular. Uses Temporal API polyfill. Monorepo under pnpm + nx.
+
+## Core Constraints
+
+- All public API methods return Date or string. Never Temporal objects.
+- Input dates: RFC 3339 string, epoch numeric, or Date object.
+- Formatting via Intl.DateTimeFormat parts, not string tokens.
+- Timezone and calendar are always tracked. Defaults from Intl.DateTimeFormat.
+- Date objects are mutable. Never mutate inputs.
+
+## Package Hierarchy
+
+- `@tanstack/time` — core logic (calendar, date ops, formatting)
+- `@tanstack/react-time` — React hooks (useCalendar), re-exports from core
+- `@tanstack/time-devtools` — devtools UI, depends on core
+- `@tanstack/solid-time` — Solid adapter (mirrors react-time)
+- `@tanstack/solid-time-devtools` — Solid devtools
+
+## File Organization
+
+- `packages/time/src/date/` — date manipulation (add, subtract, startOf, endOf, format, parse, etc.)
+- `packages/time/src/calendar/` — calendar engine (CalendarCore, DateCore, event rendering, recurrence, resizing)
+- `packages/time/src/client/` — client-side utilities
+- `packages/time/src/formatter/` — Intl.DateTimeFormat wrappers
+- `packages/time/src/utils/` — shared helpers
+
+## Testing
+
+- Vitest for unit tests. `*.test.ts` co-located with source.
+- React tests use `@testing-library/react`.
+- No comment policy: zero comments in source. Prefer naming, types, structure.
+
+## Build
+
+- `tsdown` for bundling. Outputs ESM + CJS.
+- `nx` for task orchestration.
+- `pnpm` for package management.
+
+## Key Files
+
+- `packages/time/src/calendar/calendar.ts` — CalendarCore class
+- `packages/time/src/calendar/date-core.ts` — DateCore abstract class
+- `packages/time/src/date/index.ts` — date utility exports
+- `packages/time/src/index.ts` — top-level exports
+- `Methodology.md` — API design philosophy
+- `TODO.md` — roadmap
+
+## Navigation
+
+- Read `.ai/graph.json` before exploring. It contains the full package map, file lists, exports, dependencies, and test locations.
+- Use the `edges` array to trace internal dependencies and identify affected packages before modifying core logic.
+- If `graph.json` is stale or missing, run `pnpm run graphify` to regenerate it.
+
+## Agent Rules
+
+- Do not add comments to source code.
+- Follow existing code style. Use explicit types.
+- When changing core, check react-time and devtools for breakage.
+- Run `pnpm test:lib` and `pnpm test:types` before declaring done.
+- Prefer small focused functions over classes.
+- All new date logic must handle timezone and calendar correctly.

.ai/README.md

@@ -0,0 +1,20 @@
+# AI Infrastructure
+
+Generated and maintained for AI agents working on TanStack Time.
+
+## Graphify
+
+`pnpm run graphify` generates `.ai/graph.json` — a machine-readable graph of the monorepo (packages, exports, dependencies, files, tests).
+
+## Spec Kit
+
+`.ai/spec-kit/` contains domain-specific specifications:
+
+- `architecture.md` — monorepo structure, package relationships, build system
+- `testing.md` — test framework, commands, coverage expectations
+- `api-design.md` — input/output contracts, method signatures, design philosophy
+- `calendar-domain.md` — Temporal API, event model, recurrence, availability, views
+
+## Agent Context
+
+`.ai/AGENTS.md` — top-level instructions for AI agents. Read this first.

.ai/graph.json

@@ -0,0 +1,302 @@
+{
+  "generated": "2026-06-08T11:19:58.167Z",
+  "packages": [
+    {
+      "name": "@tanstack/react-time",
+      "path": "packages/react-time",
+      "exports": [
+        "useCalendar from ./useCalendar",
+        "calculateGhostPreviewStyle from @tanstack/time",
+        "calculateSegmentResizePreview from @tanstack/time",
+        "calculateTimelineResizePreview from @tanstack/time",
+        "formatEventTimeRange from @tanstack/time",
+        "getEventDisplayTimeRange from @tanstack/time",
+        "getSegmentInfo from @tanstack/time",
+        "isMultiDayEvent from @tanstack/time",
+        "useCalendar",
+        "calculateGhostPreviewStyle",
+        "calculateSegmentResizePreview",
+        "calculateTimelineResizePreview",
+        "formatEventTimeRange",
+        "getEventDisplayTimeRange",
+        "getSegmentInfo",
+        "isMultiDayEvent"
+      ],
+      "dependencies": ["@tanstack/react-store", "@tanstack/time"],
+      "devDependencies": [
+        "@eslint-react/eslint-plugin",
+        "@testing-library/react",
+        "@types/react",
+        "@vitejs/plugin-react",
+        "eslint-plugin-react-compiler",
+        "eslint-plugin-react-hooks",
+        "react"
+      ],
+      "peerDependencies": ["react", "react-dom"],
+      "internalDeps": ["@tanstack/react-store", "@tanstack/time"],
+      "files": [
+        "packages/react-time/src/index.ts",
+        "packages/react-time/src/useCalendar/index.ts",
+        "packages/react-time/src/useCalendar/useCalendar.ts"
+      ],
+      "tests": []
+    },
+    {
+      "name": "@tanstack/react-time-devtools",
+      "path": "packages/react-time-devtools",
+      "exports": ["TimeDevtoolsPanel", "timeDevtoolsPlugin"],
+      "dependencies": ["@tanstack/devtools-utils", "@tanstack/time-devtools"],
+      "devDependencies": [
+        "@eslint-react/eslint-plugin",
+        "@types/react",
+        "@vitejs/plugin-react",
+        "eslint-plugin-react-compiler",
+        "eslint-plugin-react-hooks",
+        "react",
+        "solid-js"
+      ],
+      "peerDependencies": ["react", "react-dom"],
+      "internalDeps": ["@tanstack/devtools-utils", "@tanstack/time-devtools"],
+      "files": [
+        "packages/react-time-devtools/src/index.ts",
+        "packages/react-time-devtools/src/production.ts"
+      ],
+      "tests": []
+    },
+    {
+      "name": "@tanstack/solid-time",
+      "path": "packages/solid-time",
+      "exports": [],
+      "dependencies": ["@tanstack/solid-store", "@tanstack/time"],
+      "devDependencies": ["@types/node", "solid-js", "vite-plugin-solid"],
+      "peerDependencies": ["solid-js"],
+      "internalDeps": ["@tanstack/solid-store", "@tanstack/time"],
+      "files": ["packages/solid-time/src/index.ts"],
+      "tests": []
+    },
+    {
+      "name": "@tanstack/solid-time-devtools",
+      "path": "packages/solid-time-devtools",
+      "exports": ["TimeDevtools", "timeDevtoolsPlugin"],
+      "dependencies": ["@tanstack/devtools-utils", "@tanstack/time-devtools"],
+      "devDependencies": ["solid-js", "vite-plugin-solid"],
+      "peerDependencies": ["solid-js"],
+      "internalDeps": ["@tanstack/devtools-utils", "@tanstack/time-devtools"],
+      "files": [
+        "packages/solid-time-devtools/src/index.ts",
+        "packages/solid-time-devtools/src/production.ts"
+      ],
+      "tests": []
+    },
+    {
+      "name": "@tanstack/time",
+      "path": "packages/time",
+      "exports": ["* from ./date", "* from ./calendar", "* from ./client"],
+      "dependencies": ["@tanstack/devtools-event-client", "@tanstack/store"],
+      "devDependencies": ["vite-tsconfig-paths"],
+      "peerDependencies": [],
+      "internalDeps": ["@tanstack/devtools-event-client", "@tanstack/store"],
+      "files": [
+        "packages/time/src/index.ts",
+        "packages/time/src/calendar/calendar.ts",
+        "packages/time/src/calendar/date-core.ts",
+        "packages/time/src/calendar/expandRecurringEvent.ts",
+        "packages/time/src/calendar/generateDateRange.ts",
+        "packages/time/src/calendar/getEventProps.ts",
+        "packages/time/src/calendar/getResizeProps.ts",
+        "packages/time/src/calendar/getTimeSlots.ts",
+        "packages/time/src/calendar/groupDaysBy.ts",
+        "packages/time/src/calendar/index.ts",
+        "packages/time/src/calendar/resizeController.ts",
+        "packages/time/src/calendar/splitMultiDayEvents.ts",
+        "packages/time/src/calendar/types.ts",
+        "packages/time/src/client/TimeClient.ts",
+        "packages/time/src/client/index.ts",
+        "packages/time/src/formatter/extractLocaleOptions.ts",
+        "packages/time/src/formatter/shared.ts",
+        "packages/time/src/date/index.ts",
+        "packages/time/src/date/types.ts",
+        "packages/time/src/date/validateDate.ts",
+        "packages/time/src/utils/dateDefaults.ts",
+        "packages/time/src/utils/dateRange.ts",
+        "packages/time/src/utils/dateTimeDefaults.ts",
+        "packages/time/src/utils/index.ts",
+        "packages/time/src/utils/weekUtils.ts",
+        "packages/time/src/formatter/buildDateFormatter/buildDateFormatter.ts",
+        "packages/time/src/formatter/buildDateFormatter/index.ts",
+        "packages/time/src/polyfills/getWeekInfo.ts",
+        "packages/time/src/polyfills/types.ts",
+        "packages/time/src/polyfills/weekInfoData.ts",
+        "packages/time/src/formatter/buildDateTimeFormatter/buildDateTimeFormatter.ts",
+        "packages/time/src/formatter/buildDateTimeFormatter/index.ts",
+        "packages/time/src/formatter/buildTimeFormatter/buildTimeFormatter.ts",
+        "packages/time/src/formatter/buildTimeFormatter/index.ts",
+        "packages/time/src/formatter/buildFinalFormatter/buildFinalFormatter.ts",
+        "packages/time/src/formatter/buildFinalFormatter/index.ts",
+        "packages/time/src/date/add/add.ts",
+        "packages/time/src/date/add/index.ts",
+        "packages/time/src/date/endOf/endOf.ts",
+        "packages/time/src/date/endOf/index.ts",
+        "packages/time/src/date/equals/equals.ts",
+        "packages/time/src/date/equals/index.ts",
+        "packages/time/src/date/format/format.ts",
+        "packages/time/src/date/format/index.ts",
+        "packages/time/src/date/helpers/index.ts",
+        "packages/time/src/date/helpers/normalizeLocale.ts",
+        "packages/time/src/date/helpers/normalizeWeek.ts",
+        "packages/time/src/date/helpers/toZonedDateTime.ts",
+        "packages/time/src/date/intersects/index.ts",
+        "packages/time/src/date/intersects/intersects.ts",
+        "packages/time/src/date/isAfter/index.ts",
+        "packages/time/src/date/isAfter/isAfter.ts",
+        "packages/time/src/date/isBefore/index.ts",
+        "packages/time/src/date/isBefore/isBefore.ts",
+        "packages/time/src/date/isBetween/index.ts",
+        "packages/time/src/date/isBetween/isBetween.ts",
+        "packages/time/src/date/isSameOrAfter/index.ts",
+        "packages/time/src/date/isSameOrAfter/isSameOrAfter.ts",
+        "packages/time/src/date/isSameOrBefore/index.ts",
+        "packages/time/src/date/isSameOrBefore/isSameOrBefore.ts",
+        "packages/time/src/date/isLeapYear/index.ts",
+        "packages/time/src/date/isLeapYear/isLeapYear.ts",
+        "packages/time/src/date/isValidDate/index.ts",
+        "packages/time/src/date/isValidDate/isValidDate.ts",
+        "packages/time/src/date/isWeekend/index.ts",
+        "packages/time/src/date/isWeekend/isWeekend.ts",
+        "packages/time/src/date/range/index.ts",
+        "packages/time/src/date/range/range.ts",
+        "packages/time/src/date/parse/index.ts",
+        "packages/time/src/date/parse/parse.ts",
+        "packages/time/src/date/round/index.ts",
+        "packages/time/src/date/round/round.ts",
+        "packages/time/src/date/since/index.ts",
+        "packages/time/src/date/since/since.ts",
+        "packages/time/src/date/startOf/index.ts",
+        "packages/time/src/date/startOf/startOf.ts",
+        "packages/time/src/date/subtract/index.ts",
+        "packages/time/src/date/subtract/subtract.ts",
+        "packages/time/src/date/until/index.ts",
+        "packages/time/src/date/until/until.ts",
+        "packages/time/src/date/withDateOperation/index.ts",
+        "packages/time/src/date/withDateOperation/withDateOperation.ts"
+      ],
+      "tests": [
+        "packages/time/src/calendar/tests/calendar.test.ts",
+        "packages/time/src/date/withDateOperation/withDateOperation.test.ts",
+        "packages/time/src/date/add/tests/add.test.ts",
+        "packages/time/src/formatter/buildFinalFormatter/tests/buildFinalFormatter.test.ts",
+        "packages/time/src/date/endOf/tests/endOf.test.ts",
+        "packages/time/src/date/equals/tests/equals.test.ts",
+        "packages/time/src/date/format/tests/format.test.ts",
+        "packages/time/src/date/intersects/tests/intersects.test.ts",
+        "packages/time/src/date/isBefore/tests/isBefore.test.ts",
+        "packages/time/src/date/isBetween/tests/isBetween.test.ts",
+        "packages/time/src/date/isSameOrAfter/tests/isSameOrAfter.test.ts",
+        "packages/time/src/date/isAfter/tests/isAfter.test.ts",
+        "packages/time/src/date/isSameOrBefore/tests/isSameOrBefore.test.ts",
+        "packages/time/src/date/isLeapYear/tests/isLeapYear.test.ts",
+        "packages/time/src/date/isValidDate/tests/isValidDate.test.ts",
+        "packages/time/src/date/isWeekend/tests/isWeekend.test.ts",
+        "packages/time/src/date/parse/tests/parse.test.ts",
+        "packages/time/src/date/range/tests/range.test.ts",
+        "packages/time/src/date/round/tests/round.test.ts",
+        "packages/time/src/date/since/tests/since.test.ts",
+        "packages/time/src/date/startOf/tests/startOf.test.ts",
+        "packages/time/src/date/subtract/tests/subtract.test.ts",
+        "packages/time/src/date/until/tests/until.test.ts"
+      ]
+    },
+    {
+      "name": "@tanstack/time-devtools",
+      "path": "packages/time-devtools",
+      "exports": ["TimeDevtoolsCore"],
+      "dependencies": [
+        "@tanstack/devtools-ui",
+        "@tanstack/devtools-utils",
+        "@tanstack/time",
+        "goober",
+        "solid-js"
+      ],
+      "devDependencies": ["rolldown-plugin-solid"],
+      "peerDependencies": [],
+      "internalDeps": [
+        "@tanstack/devtools-ui",
+        "@tanstack/devtools-utils",
+        "@tanstack/time"
+      ],
+      "files": [
+        "packages/time-devtools/src/index.ts",
+        "packages/time-devtools/src/production.ts",
+        "packages/time-devtools/src/styles/use-styles.ts"
+      ],
+      "tests": []
+    }
+  ],
+  "edges": [
+    {
+      "from": "@tanstack/react-time",
+      "to": "@tanstack/react-store",
+      "type": "dependency"
+    },
+    {
+      "from": "@tanstack/react-time",
+      "to": "@tanstack/time",
+      "type": "dependency"
+    },
+    {
+      "from": "@tanstack/react-time-devtools",
+      "to": "@tanstack/devtools-utils",
+      "type": "dependency"
+    },
+    {
+      "from": "@tanstack/react-time-devtools",
+      "to": "@tanstack/time-devtools",
+      "type": "dependency"
+    },
+    {
+      "from": "@tanstack/solid-time",
+      "to": "@tanstack/solid-store",
+      "type": "dependency"
+    },
+    {
+      "from": "@tanstack/solid-time",
+      "to": "@tanstack/time",
+      "type": "dependency"
+    },
+    {
+      "from": "@tanstack/solid-time-devtools",
+      "to": "@tanstack/devtools-utils",
+      "type": "dependency"
+    },
+    {
+      "from": "@tanstack/solid-time-devtools",
+      "to": "@tanstack/time-devtools",
+      "type": "dependency"
+    },
+    {
+      "from": "@tanstack/time",
+      "to": "@tanstack/devtools-event-client",
+      "type": "dependency"
+    },
+    {
+      "from": "@tanstack/time",
+      "to": "@tanstack/store",
+      "type": "dependency"
+    },
+    {
+      "from": "@tanstack/time-devtools",
+      "to": "@tanstack/devtools-ui",
+      "type": "dependency"
+    },
+    {
+      "from": "@tanstack/time-devtools",
+      "to": "@tanstack/devtools-utils",
+      "type": "dependency"
+    },
+    {
+      "from": "@tanstack/time-devtools",
+      "to": "@tanstack/time",
+      "type": "dependency"
+    }
+  ]
+}