@photon-ai/pho-ui 4.0.0 → 4.2.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -95,6 +95,11 @@ export interface BasicPageRootProps extends ComponentProps<"div"> {
95
95
  * starting values would blink it out. The React page taking over from
96
96
  * it stays put too — it finds the marker in the document at its first
97
97
  * render, while the twin is still there.
98
+ *
99
+ * Not needed for markup React hydrates in place (a server-rendered
100
+ * page): the parts know a hydration pass from a mount and stay at rest
101
+ * on their own. This is for the twin that mounts fresh, beside or over
102
+ * markup it does not hydrate.
98
103
  */
99
104
  prerendered?: boolean;
100
105
  }
@@ -222,7 +227,8 @@ export interface BasicPageStackProps extends Omit<ComponentProps<"div">, RevealM
222
227
  * second the page was painted before React and is already there. A
223
228
  * loading part in some other page (one still on screen while this one
224
229
  * mounts) does not count. `true` always enters, except inside a
225
- * `Root prerendered`; `false` never does.
230
+ * `Root prerendered` or while hydrating server markup (the page is on
231
+ * screen either way); `false` never does.
226
232
  */
227
233
  enter?: boolean;
228
234
  ref?: Ref<HTMLDivElement>;
@@ -253,6 +259,11 @@ export interface BasicPageStackProps extends Omit<ComponentProps<"div">, RevealM
253
259
  * nothing inside that root does either, and the React page taking over
254
260
  * finds the marker in the document and stays put on its own;
255
261
  * `enter={false}` says so outright for markup that must never move.
262
+ * - **A page the server rendered and React hydrates** stays put with no
263
+ * flag at all: the hydration pass renders what the server did, at rest,
264
+ * and the entrance waits for a page React mounts itself (a navigation).
265
+ * An `enter` on a hydrating stack does not override this either: the
266
+ * page is on screen, and starting values would blink it out.
256
267
  * - **A region the skeleton couldn't predict** (a list of unknown length)
257
268
  * — `Reveal` rises that region in once its shape is known.
258
269
  *
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@photon-ai/pho-ui",
3
- "version": "4.0.0",
3
+ "version": "4.2.0",
4
4
  "description": "Pho Design System — Photon's React component library, built on Base UI",
5
5
  "license": "UNLICENSED",
6
6
  "repository": {