@photon-ai/pho-ui 4.4.0 → 4.5.0

package/dist/sections/basic-page.js

@@ -1,6 +1,6 @@
 "use client";
 import { a as s } from "../chunks/data-table-Mog6m3d9.js";
-import { a as E, c as a, d as C, f as S, i as I, l as e, m as o, n as B, o as P, p as N, r, s as t, t as D, u as R } from "../chunks/basic-page-ijv-ijUB.js";
+import { a as E, c as a, d as C, f as S, i as I, l as e, m as o, n as B, o as P, p as N, r, s as t, t as D, u as R } from "../chunks/basic-page-D3MY3uY6.js";
 export {
   D as AUTO_SAVE_DELAY_MS,
   B as BASIC_PAGE_CALLOUT,

package/dist/src/sections/basic-page/basic-page.d.ts

@@ -73,8 +73,19 @@ export interface BasicPageRootProps extends ComponentProps<"div"> {
      * name: the large title collapsing into its bar. It assembles itself
      * from `Title` and the trail's tail crumb; nothing to wire. Pass `false`
      * for a page that should scroll away whole.
+     *
+     * `"pinned"` makes the condensed state the page's only state: the bar
+     * is up from the first paint, with no entrance, and never dissolves —
+     * nothing is observed. The heading block leaves the flow: `Title` still
+     * names the page (its `h1` stays, visually hidden) and still hands the
+     * bar its words; the trail in the flow hides, and the bar's tail crumb
+     * is the way back. The column starts right under the bar — its top seat
+     * is the bar's height, nothing more — and `Stack` sits at the untitled
+     * rhythm, 12px below it. For a page that is one surface (an inbox, a
+     * board) and has no room for a title block. A shell adopting the bar
+     * reads `condensed: true` from the start, as it does after a scroll.
      */
-    condense?: boolean;
+    condense?: boolean | "pinned";
     /**
      * The content column's cap. `base` is the 42rem reading column every
      * settings page uses; `wide` opens it to 80rem for a page that is a
@@ -117,7 +128,9 @@ declare function Root({ condense, width, prerendered, className, children, ref,
  * `Breadcrumbs` report what belongs in it (the heading, the tail crumb)
  * through this context, so the bar assembles itself and consumers only set
  * the flag. The bar stays out of the way until the whole heading has left
- * the scrollport, then fades in pinned to the top.
+ * the scrollport, then fades in pinned to the top. `condense="pinned"` is
+ * the one exception: there, `Title` mounts the bar itself instead of
+ * reporting to it — see `CondenseBar`'s doc.
  */
 interface CondenseTail {
     label: ReactNode;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@photon-ai/pho-ui",
-  "version": "4.4.0",
+  "version": "4.5.0",
   "description": "Pho Design System — Photon's React component library, built on Base UI",
   "license": "UNLICENSED",
   "repository": {