chrona-react 0.2.0 → 0.2.1

package/AGENTS.md

@@ -14,8 +14,14 @@ https://github.com/devlinduldulao/chrona#readme
 3. **Server Components.** These components hold state: mark their module
    `"use client"`. The polyfill import is a side effect, so it must reach the
    client bundle — put it at the top of a `"use client"` module that always
-   loads (a providers file), not in a Server Component.
-4. **Values are Temporal objects.** Strings and `Date` are rejected with a
+   loads (a providers file), not in a Server Component. That covers hydration.
+4. **SSR module init.** The providers import does not order Node module
+   evaluation. If another `"use client"` file reads `Temporal` at module scope
+   (`const reference = Temporal.PlainDate.from(...)` at the top of `page.tsx`),
+   Next.js may evaluate that file during SSR before `providers.tsx` has run and
+   throw `ReferenceError: Temporal is not defined`. Import the polyfill at the
+   top of *that* file too, or move the call inside the component body.
+5. **Values are Temporal objects.** Strings and `Date` are rejected with a
    `ChronaError`; there is no parsing layer.
 
 ## Anatomy

package/README.md

@@ -6,7 +6,7 @@ values, no free-form date parsing, and no CSS — you own every pixel.
 Part of [Chrona](https://github.com/devlinduldulao/chrona). Built on
 [`chrona-core`](https://www.npmjs.com/package/chrona-core).
 
-> **Status: experimental 0.2.0.** Public APIs and styling attributes are not
+> **Status: experimental 0.2.1.** Public APIs and styling attributes are not
 > frozen for v1; 0.2.0 changes the Calendar cell anatomy. See the
 > [changelog](./CHANGELOG.md). Automated axe checks pass, but no screen-reader
 > compatibility certification is claimed.
@@ -172,6 +172,22 @@ export function Providers({ children }: { children: React.ReactNode }) {
 }
 ```
 
+That covers the client bundle before hydration. It does not order Node module
+evaluation. If another `"use client"` file reads `Temporal` at module scope
+(`const reference = Temporal.PlainDate.from(...)` at the top of `page.tsx`),
+Next.js may evaluate that file during SSR before `providers.tsx` has run and
+throw `ReferenceError: Temporal is not defined`. Import the polyfill at the top
+of that file too, or move the call inside the component body:
+
+```tsx
+"use client";
+
+import "temporal-polyfill/global";
+import { Calendar } from "chrona-react";
+
+const REFERENCE = Temporal.PlainDate.from({ year: 2026, month: 9, day: 16 });
+```
+
 Pass the same reference date, value, locale, and time zone on server and client.
 `timeZone` matters because today is resolved at render time, and a server in
 another zone marks a different cell.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "chrona-react",
-  "version": "0.2.0",
+  "version": "0.2.1",
   "description": "Headless Temporal-native React date and time primitives",
   "type": "module",
   "license": "MIT",
@@ -61,7 +61,7 @@
     }
   },
   "dependencies": {
-    "chrona-core": "^0.2.0"
+    "chrona-core": "^0.2.1"
   },
   "peerDependencies": {
     "react": ">=18.0.0",