@multiplatform.one/components 7.83.2 → 7.84.1

package/src/icons/themedButtonInk.spec.tsx

@@ -0,0 +1,117 @@
+/**
+ * @vitest-environment jsdom
+ *
+ * FZ-8577: a `themed` glyph inside a Button fills with the Button's ink on
+ * web, as it does on native. Before, an accentInk icon Button painted its
+ * frame in the bar tint while the svg filled with the theme's `var(--color)`,
+ * so the SHC console's search, graph and gauge glyphs drew near-black on web
+ * and purple on iOS. The same held for an intent icon button and a disabled
+ * one (FZ-8044, LC-40: the disabled twin keeps its ink, dimmed).
+ *
+ * jsdom cascades no Tamagui CSS, so the frame's ink is read from the rule
+ * behind its `_col-` class, and the glyph's from its own fill: either that
+ * ink itself or `currentColor`, which inherits it.
+ */
+
+import { cleanup, render, screen } from "@testing-library/react";
+import { Button } from "@multiplatform.one/forms";
+import { createDefaultThemeConfig, Surface } from "@multiplatform.one/theme";
+import { MagnifyingGlassIcon } from "@phosphor-icons/react";
+import type { ReactElement } from "react";
+import { TamaguiProvider, YStack } from "tamagui";
+import { afterEach, describe, expect, it } from "vitest";
+import { themed } from "./themed";
+
+afterEach(cleanup);
+
+const houseConfig = createDefaultThemeConfig();
+const SearchGlyph = themed(MagnifyingGlassIcon);
+
+function renderUnder(ui: ReactElement, theme: string) {
+  return render(
+    <TamaguiProvider config={houseConfig.tamagui} defaultTheme={theme}>
+      <YStack backgroundColor="$background">{ui}</YStack>
+    </TamaguiProvider>,
+  );
+}
+
+function ruleValue(className: string, property: string): string | null {
+  for (const sheet of Array.from(document.styleSheets)) {
+    for (const rule of Array.from(sheet.cssRules)) {
+      if (!(rule instanceof CSSStyleRule)) continue;
+      if (!rule.selectorText.endsWith(`.${className}`)) continue;
+      const value = rule.style.getPropertyValue(property);
+      if (value) return value.trim();
+    }
+  }
+  return null;
+}
+
+function frameInk(label: string): string | null {
+  const frame = screen.getByLabelText(label);
+  const cls = Array.from(frame.classList).find(
+    (c) => c.startsWith("_col-") && !/^_col-0(hover|active|focus|press)/.test(c),
+  );
+  return cls ? ruleValue(cls, "color") : null;
+}
+
+function glyphFill(label: string): string | null {
+  const svg = screen.getByLabelText(label).querySelector("svg");
+  return svg?.getAttribute("fill") ?? null;
+}
+
+/** The glyph takes the frame's ink: the same value, or currentColor, which inherits it. */
+function expectGlyphTakesFrameInk(label: string) {
+  const ink = frameInk(label);
+  const fill = glyphFill(label);
+  expect(ink, `${label} frame ink`).toBeTruthy();
+  expect(fill, `${label} glyph fill`).toBeTruthy();
+  expect(fill).not.toBe("var(--color)");
+  if (fill !== "currentColor") expect(fill?.toLowerCase()).toBe(ink?.toLowerCase());
+}
+
+describe("FZ-8577: a themed glyph in a Button fills with the Button's ink on web", () => {
+  for (const theme of ["light_purple", "dark_purple", "light_blue", "dark_blue"]) {
+    it(`${theme}: an accentInk icon button in a bar`, () => {
+      renderUnder(
+        <Surface bar>
+          <Button chromeless accentInk icon={SearchGlyph} aria-label="Search" />
+        </Surface>,
+        theme,
+      );
+      expectGlyphTakesFrameInk("Search");
+    });
+
+    it(`${theme}: an accentInk icon button in content`, () => {
+      renderUnder(<Button chromeless accentInk icon={SearchGlyph} aria-label="Find" />, theme);
+      expectGlyphTakesFrameInk("Find");
+    });
+
+    it(`${theme}: an intent icon button`, () => {
+      renderUnder(<Button error icon={SearchGlyph} aria-label="Remove" />, theme);
+      expectGlyphTakesFrameInk("Remove");
+    });
+
+    it(`${theme}: a disabled accentInk icon button keeps the enabled twin's ink`, () => {
+      renderUnder(
+        <Surface bar>
+          <Button chromeless accentInk icon={SearchGlyph} aria-label="Next" />
+          <Button chromeless accentInk disabled icon={SearchGlyph} aria-label="Previous" />
+        </Surface>,
+        theme,
+      );
+      expectGlyphTakesFrameInk("Previous");
+      expect(frameInk("Previous")).toBe(frameInk("Next"));
+    });
+  }
+
+  it("a glyph with its own colour keeps it", () => {
+    renderUnder(
+      <Surface bar>
+        <Button chromeless accentInk icon={<SearchGlyph color="red" />} aria-label="Own" />
+      </Surface>,
+      "light_purple",
+    );
+    expect(glyphFill("Own")).toBe("red");
+  });
+});

package/src/layouts/DensePageLayout.spec.tsx

@@ -0,0 +1,105 @@
+import { cleanup, screen } from "@testing-library/react";
+import { renderWithProviders } from "@multiplatform.one/test-utils";
+import { layoutBreakpoints } from "@multiplatform.one/theme";
+import { afterEach, describe, expect, it, vi } from "vitest";
+import { Button, Paragraph } from "tamagui";
+import { CONTENT_MAX_WIDTH } from "./page";
+import { DensePageLayout } from "./PageTemplates";
+
+const size = vi.hoisted(() => ({ value: "medium" as string }));
+vi.mock("@multiplatform.one/theme", async (importOriginal) => ({
+  ...(await importOriginal<typeof import("@multiplatform.one/theme")>()),
+  useLayoutSizeClass: () => size.value,
+}));
+
+afterEach(() => {
+  cleanup();
+  size.value = "medium";
+});
+
+function Log(props: Partial<Parameters<typeof DensePageLayout>[0]>) {
+  return (
+    <DensePageLayout
+      kind="log"
+      title="Sync worker"
+      status={<Paragraph>Running</Paragraph>}
+      actions={<Button aria-label="Pause the stream">Pause</Button>}
+      data-testid="dense-shell"
+      {...props}
+    >
+      <Paragraph>log rows</Paragraph>
+    </DensePageLayout>
+  );
+}
+
+/** Tamagui's atomic classes on web: `_pl-t-space-4` is paddingLeft $4. */
+function atom(el: HTMLElement, prefix: string) {
+  return el.className.split(" ").find((name) => name.startsWith(prefix)) ?? null;
+}
+
+function surface(kind: string) {
+  return document.querySelector(`[data-dense-surface="${kind}"]`) as HTMLElement;
+}
+
+describe("DensePageLayout (LC-215)", () => {
+  it("keeps the page head and gives the surface the rest of the page", () => {
+    renderWithProviders(<Log />);
+    expect(screen.getByRole("heading", { name: "Sync worker" })).toBeTruthy();
+    expect(screen.getByText("Running")).toBeTruthy();
+    expect(screen.getByLabelText("Pause the stream")).toBeTruthy();
+    const region = surface("log");
+    expect(region.textContent).toBe("log rows");
+    expect(region.contains(screen.getByText("Sync worker"))).toBe(false);
+    expect(region).toHaveStyle({ flexGrow: "1", minHeight: "0px" });
+  });
+
+  it("from medium up holds a log to the page column and a chart to the readable measure", () => {
+    renderWithProviders(<Log />);
+    expect(screen.getByTestId("dense-shell")).toHaveStyle({ maxWidth: `${CONTENT_MAX_WIDTH}px` });
+    const log = surface("log");
+    expect(atom(log, "_ox-")).toBe("_ox-hidden");
+    expect(atom(log, "_btlr-")).toMatch(/^_btlr-t-radius-/);
+    cleanup();
+    renderWithProviders(<Log kind="chart" measure="readable" />);
+    expect(screen.getByTestId("dense-shell")).toHaveStyle({
+      maxWidth: `${layoutBreakpoints.expanded}px`,
+    });
+  });
+
+  it("on a phone bleeds the surface to both edges, with a gutter only when asked", () => {
+    size.value = "compact";
+    renderWithProviders(<Log />);
+    const shell = screen.getByTestId("dense-shell");
+    expect(getComputedStyle(shell).maxWidth).not.toBe(`${CONTENT_MAX_WIDTH}px`);
+    const region = surface("log");
+    expect([atom(region, "_pl-"), atom(region, "_pr-"), atom(region, "_ox-")]).toEqual([
+      null,
+      null,
+      null,
+    ]);
+    expect(region.contains(screen.getByText("Sync worker"))).toBe(false);
+    cleanup();
+    renderWithProviders(<Log kind="chart" gutter />);
+    const chart = surface("chart");
+    expect(atom(chart, "_pl-")).toMatch(/^_pl-t-space-/);
+    expect(atom(chart, "_pl-")?.slice(4)).toBe(atom(chart, "_pr-")?.slice(4));
+  });
+
+  it("takes a caller's header in place of its own, and draws none with nothing to show", () => {
+    renderWithProviders(
+      <DensePageLayout kind="log" header={<Paragraph>Custom head</Paragraph>}>
+        <Paragraph>rows</Paragraph>
+      </DensePageLayout>,
+    );
+    expect(screen.getByText("Custom head")).toBeTruthy();
+    expect(screen.queryByRole("heading")).toBeNull();
+    cleanup();
+    renderWithProviders(
+      <DensePageLayout kind="log">
+        <Paragraph>rows</Paragraph>
+      </DensePageLayout>,
+    );
+    expect(screen.queryByRole("heading")).toBeNull();
+    expect(surface("log").textContent).toBe("rows");
+  });
+});

package/src/layouts/PageTemplates.tsx

@@ -32,7 +32,7 @@ import {
 } from "@multiplatform.one/theme";
 import { useState, type ReactNode } from "react";
 import { XStack, YStack, isWeb, type SizeTokens } from "tamagui";
-import { PageHeader, Screen, ScreenToolbar, type ScreenProps } from "./page";
+import { PageHeader, PushedPage, Screen, ScreenToolbar, type ScreenProps } from "./page";
 import { SupportingPaneLayout } from "./PaneScaffold";
 import { useShellSidebarPanel } from "./shellSidebarSlot";
 
@@ -266,16 +266,19 @@ export function DetailPageLayout({
   return (
     // LC-157: the toolbar is the Screen's pinned top bar, so it stays put
     // while the record scrolls and takes the title once the header scrolls away.
-    <Screen
-      data-canonical="detail-page"
-      topBar={toolbar}
-      // LC-263: one readable column; a supporting pane gets the full width.
-      maxWidth={aside == null ? DETAIL_READABLE_WIDTH : undefined}
-      {...rest}
-    >
-      {renderTemplateHeader({ title, subtitle, actions, header, nav })}
-      {body}
-    </Screen>
+    // LC-270: a detail page is pushed, so on a phone its title starts there.
+    <PushedPage>
+      <Screen
+        data-canonical="detail-page"
+        topBar={toolbar}
+        // LC-263: one readable column; a supporting pane gets the full width.
+        maxWidth={aside == null ? DETAIL_READABLE_WIDTH : undefined}
+        {...rest}
+      >
+        {renderTemplateHeader({ title, subtitle, actions, header, nav })}
+        {body}
+      </Screen>
+    </PushedPage>
   );
 }
 

package/src/layouts/Screen.chromeClearance.spec.tsx

@@ -7,6 +7,7 @@ import { renderWithProviders } from "@multiplatform.one/test-utils";
 import { act, cleanup, screen } from "@testing-library/react";
 import { afterEach, expect, it } from "vitest";
 import { setBottomChromeInset } from "../appShell/bottomChrome";
+import { BottomAccessory } from "./bottomAccessory";
 import { Screen } from "./page";
 
 const bar = Symbol("bar");
@@ -39,3 +40,30 @@ it("clears the bar on a screen that does not scroll", () => {
   renderWithProviders(<Screen scroll={false}>row</Screen>);
   expect(screen.getByTestId("screen-chrome-clearance")).toBeTruthy();
 });
+
+it("hands the clearance to a slot accessory that stands on a bar it does not ride (FZ-7995)", () => {
+  act(() => setBottomChromeInset(bar, 83));
+  renderWithProviders(
+    <Screen>
+      row
+      <BottomAccessory>
+        <span data-testid="pager">pager</span>
+      </BottomAccessory>
+    </Screen>,
+  );
+  expect(screen.queryByTestId("screen-chrome-clearance")).toBeNull();
+  const lift = screen.getByTestId("bottom-accessory-lift");
+  expect(lift.contains(screen.getByTestId("pager"))).toBe(true);
+  expect(getComputedStyle(lift).paddingBottom === "83px" || /83px/.test(lift.outerHTML)).toBe(true);
+});
+
+it("grows its scrolling column to its content, so the clearance ends the content, not the viewport", () => {
+  act(() => setBottomChromeInset(bar, 77));
+  renderWithProviders(<Screen>row</Screen>);
+  const column = screen.getByTestId("screen");
+  const style = getComputedStyle(column);
+  const html = column.outerHTML;
+  expect(style.flexShrink === "0" || /_fs-0\b|flex-shrink: 0/.test(html)).toBe(true);
+  expect(style.flexBasis === "0px" || /_fb-0px\b|flex-basis: 0px/.test(html)).toBe(false);
+  expect(column.nextElementSibling).toBe(screen.getByTestId("screen-chrome-clearance"));
+});

package/src/layouts/ViewSwitcher.native-press.spec.tsx

@@ -0,0 +1,55 @@
+/**
+ * FZ-8991, under tamagui's NATIVE build (vitest.native.config.mjs). On the iOS
+ * simulator One's Moves list ignored every tap on the ViewSwitcher's Table
+ * segment, so a phone user could never reach the table view. A press on a
+ * segment's label has to reach the segment and switch the view.
+ */
+import { cleanup, fireEvent, screen } from "@testing-library/react";
+import { renderWithProviders } from "@multiplatform.one/test-utils";
+import { isWeb } from "tamagui";
+import { afterEach, describe, expect, it, vi } from "vitest";
+import { ViewSwitcher } from "./ViewSwitcher";
+
+afterEach(cleanup);
+
+const views = [
+  { type: "list", label: "List" },
+  { type: "table", label: "Table" },
+];
+
+function press(el: Element) {
+  fireEvent.mouseDown(el, { button: 0, buttons: 1 });
+  fireEvent.mouseUp(el, { button: 0, buttons: 0 });
+}
+
+describe("ViewSwitcher press on native", () => {
+  it("runs tamagui's native build", () => {
+    expect(isWeb).toBe(false);
+  });
+
+  it("a press on the Table segment switches to table", () => {
+    const onViewChange = vi.fn();
+    renderWithProviders(
+      <ViewSwitcher views={views} currentView="list" onViewChange={onViewChange} />,
+    );
+    press(screen.getByText("Table"));
+    expect(onViewChange).toHaveBeenCalledWith("table");
+  });
+
+  it("a press on the List segment switches back to list", () => {
+    const onViewChange = vi.fn();
+    renderWithProviders(
+      <ViewSwitcher views={views} currentView="table" onViewChange={onViewChange} />,
+    );
+    press(screen.getByText("List"));
+    expect(onViewChange).toHaveBeenCalledWith("list");
+  });
+
+  // The selected state rides accessibilityState, which this DOM shim does not
+  // render; the simulator's accessibility tree is where that is checked.
+  it("each segment is a named button", () => {
+    renderWithProviders(<ViewSwitcher views={views} currentView="list" onViewChange={() => {}} />);
+    const buttons = screen.getAllByRole("button");
+    expect(buttons.map((b) => b.getAttribute("aria-label"))).toEqual(["List", "Table"]);
+  });
+});

package/src/layouts/ViewSwitcher.tsx

@@ -126,7 +126,10 @@ export function ViewSwitcher({
       overflow="hidden"
       focusStyle={groupRing}
       focusVisibleStyle={groupRing}
-      focusWithinStyle={groupRing}
+      // FZ-8991: on native a focusWithinStyle hands every descendant focus
+      // events, and the segment's label then takes the touch, so the segment's
+      // onPress never runs. The ring is a keyboard affordance: web only.
+      {...(isWeb ? { focusWithinStyle: groupRing } : undefined)}
       // Carbon / Apple equal-width: inline style so Tamagui's flex class
       // cannot drop `gridAutoFlow` (a Tamagui `display="grid"` prop did).
       {...(isWeb
@@ -167,7 +170,15 @@ export function ViewSwitcher({
           <ToggleGroup.Item
             key={view.type}
             value={view.type}
-            {...(isWeb ? { tabIndex: isTabStop ? 0 : -1 } : undefined)}
+            {...(isWeb
+              ? { tabIndex: isTabStop ? 0 : -1 }
+              : {
+                  accessible: true,
+                  role: "button" as const,
+                  accessibilityRole: "button" as const,
+                  accessibilityLabel: view.label,
+                  accessibilityState: { selected: isSelected },
+                })}
             paddingHorizontal={knobProps.tab.paddingHorizontal}
             width="auto"
             height={knobProps.tab.height}

package/src/layouts/bottomAccessory.tsx

@@ -4,7 +4,10 @@
  * UIPageControl under a paged list), not inline after the content.
  *
  * Under a floating TabBar the accessory moves into the bar, which floats it
- * as its own capsule above the tab capsule (LC-150). Otherwise a page shell
+ * as its own capsule above the tab capsule (LC-150), and under the system tab
+ * bar on iOS 26 into its bottom accessory (FZ-7995). A tab bar that hosts no
+ * accessory (the system bar before iOS 26) still covers the bottom of the
+ * screen, so the slot's bar stands on it instead of on the home indicator. Otherwise a page shell
  * (`Screen`) owns one bottom-accessory slot. Any component
  * hands it a control with `<BottomAccessory>`; the shell draws it in a bar
  * under its scroll view that stays put while the content scrolls, so the
@@ -30,7 +33,11 @@ import {
   type ReactNode,
 } from "react";
 import { YStack, isWeb } from "tamagui";
-import { setBottomAccessory, useFloatingBarMounted } from "../appShell/bottomChrome";
+import {
+  setBottomAccessory,
+  useBottomChromeInset,
+  useFloatingBarMounted,
+} from "../appShell/bottomChrome";
 import { componentColors } from "../componentColors";
 import { BottomSafeArea } from "./bottomSafeArea";
 
@@ -140,6 +147,15 @@ export function BottomAccessory({ children }: BottomAccessoryProps) {
 }
 
 /** A page shell's slot: the bar the registered accessories render in. */
+/** True while a page's slot holds an accessory. */
+export function useBottomAccessoryOccupied(store: BottomAccessoryStore): boolean {
+  return useSyncExternalStore(
+    store.subscribe,
+    () => store.getSnapshot().length > 0,
+    () => false,
+  );
+}
+
 export function BottomAccessoryHost({
   store,
   inset,
@@ -161,8 +177,8 @@ export function BottomAccessoryHost({
 }
 
 /**
- * The bar: the page's fill under a top hairline, and the home indicator's
- * inset below the controls.
+ * The bar: the page's fill under a top hairline, and below the controls the
+ * home indicator's inset, or in a page's slot the height a tab bar covers.
  */
 function BottomAccessoryBar({
   children,
@@ -176,6 +192,20 @@ function BottomAccessoryBar({
   hosted?: boolean;
 }) {
   const { knobProps } = useResolvedKnobs({ component: "ScreenToolbar" });
+  const chromeInset = useBottomChromeInset();
+  const lift = hosted && chromeInset > 0;
+  const controls = (
+    <YStack
+      width="100%"
+      {...(maxWidth ? { maxWidth, alignSelf: "center" as const } : null)}
+      alignItems="center"
+      paddingHorizontal={(inset ?? knobProps.panelPadding.padding) as "$4"}
+      paddingVertical={knobProps.gap.gap as "$2"}
+      {...knobProps.gap}
+    >
+      {children}
+    </YStack>
+  );
   return (
     <Surface bar>
       <YStack
@@ -188,18 +218,13 @@ function BottomAccessoryBar({
         borderColor={componentColors.divider as never}
         style={webSticky as never}
       >
-        <BottomSafeArea>
-          <YStack
-            width="100%"
-            {...(maxWidth ? { maxWidth, alignSelf: "center" as const } : null)}
-            alignItems="center"
-            paddingHorizontal={(inset ?? knobProps.panelPadding.padding) as "$4"}
-            paddingVertical={knobProps.gap.gap as "$2"}
-            {...knobProps.gap}
-          >
-            {children}
+        {lift ? (
+          <YStack width="100%" paddingBottom={chromeInset} data-testid="bottom-accessory-lift">
+            {controls}
           </YStack>
-        </BottomSafeArea>
+        ) : (
+          <BottomSafeArea>{controls}</BottomSafeArea>
+        )}
       </YStack>
     </Surface>
   );

package/src/layouts/page.tsx

@@ -40,7 +40,7 @@ import {
   type ButtonProps,
 } from "@multiplatform.one/forms";
 import { CaretLeftIcon, CaretRightIcon, DotsThreeIcon } from "@phosphor-icons/react";
-import { useState, type ReactNode } from "react";
+import { createContext, useContext, useState, type ReactNode } from "react";
 import { barTitleSpan, sideExtents } from "./barTitleSpan";
 import type { LayoutChangeEvent, NativeScrollEvent, NativeSyntheticEvent } from "react-native";
 import type { ScrollViewProps as TamaguiScrollViewProps, XStackProps, YStackProps } from "tamagui";
@@ -66,6 +66,7 @@ import { ScrollView } from "../ScrollView";
 import { KeyboardAvoidingWrapper } from "./KeyboardAvoidingWrapper";
 import {
   BottomAccessoryHost,
+  useBottomAccessoryOccupied,
   BottomAccessoryScope,
   createBottomAccessoryStore,
 } from "./bottomAccessory";
@@ -293,7 +294,10 @@ function PageShell({
     <YStack
       ref={scrollState.contentRoot as never}
       data-testid="screen"
-      flex={1}
+      // In a scroll view the column grows to its content (basis auto, no
+      // shrink): with flex 1 it was held to the viewport on web, its rows
+      // overflowed it, and the chrome clearance after it landed mid-list.
+      {...(scroll ? { flexGrow: 1, flexShrink: 0, flexBasis: "auto" as const } : { flex: 1 })}
       width="100%"
       {...(maxWidth && !bleed ? { maxWidth, alignSelf: "center" } : null)}
       {...(noPadding ? null : knobProps.panelPadding)}
@@ -334,8 +338,12 @@ function PageShell({
   };
 
   // The floating tab bar covers the bottom of the screen; content scrolls
-  // under it, and this clears its last row.
-  const chromeClearance = <BottomChromeClearance testID="screen-chrome-clearance" />;
+  // under it, and this clears its last row. A slot accessory stands on the bar
+  // and ends the scroll view above it, so it takes the clearance instead.
+  const accessoryOccupied = useBottomAccessoryOccupied(accessories);
+  const chromeClearance = accessoryOccupied ? null : (
+    <BottomChromeClearance testID="screen-chrome-clearance" />
+  );
 
   if (!scroll) {
     return shell(
@@ -416,6 +424,32 @@ export interface PageHeaderProps extends YStackProps {
   titleScale?: PageTitleScale;
 }
 
+const PushedPageContext = createContext<"inline" | "hero" | null>(null);
+
+/**
+ * LC-270 PUSHED-PAGE-INLINE-TITLE: marks a pushed page, a detail or form page
+ * reached through a back control. At compact width its title rides the top
+ * bar, centred between back and the actions, and its `PageHeader` draws no
+ * large title. Root pages keep LC-157's large title. `hero` is the App Store
+ * and Music variant: the page's own title (an identity block's name) stays in
+ * the content, the bar shows nothing at rest, and the same title fades into
+ * the bar once that name scrolls out of view (LC-157's measured collapse).
+ */
+export function PushedPage({ hero = false, children }: { hero?: boolean; children: ReactNode }) {
+  return (
+    <PushedPageContext.Provider value={hero ? "hero" : "inline"}>
+      {children}
+    </PushedPageContext.Provider>
+  );
+}
+
+/** True when the page's title belongs in its top bar from rest (LC-270). */
+export function useInlinePageTitle(): boolean {
+  const pushed = useContext(PushedPageContext);
+  const compact = useLayoutSizeClass() === "compact";
+  return pushed === "inline" && compact;
+}
+
 /**
  * Standard page header (Polaris Page / Primer PageHeader / Linear).
  *
@@ -452,24 +486,32 @@ export function PageHeader({
   // LC-157: the page title is the Screen's large title; its top bar shows it
   // once it scrolls away.
   const largeTitle = useLargeTitle(title, headingLevel === 1 && !heading);
+  // LC-270: a pushed page's title is in its top bar at compact width.
+  const inlineTitle = useInlinePageTitle() && headingLevel === 1;
+  // LC-143: a phone's page title takes the width its actions leave, on one
+  // line, so wide actions truncate it instead of breaking it into letters.
+  const compact = useLayoutSizeClass() === "compact";
   // D-11: the page-title step comes from the knob (`moderate` by default), so
   // one dial re-scales every composed screen; `titleScale` is the explicit
   // per-instance eject and resolves through the same table. The semantic tag
   // still follows headingLevel — the step is emphasis, not structure.
   const titleSize = titleScale ? resolvePageTitleScale(titleScale) : knobProps.pageTitle;
-  const titleNode =
-    heading ??
-    (title ? (
-      <TitleTag
-        margin={0}
-        {...largeTitle}
-        {...titleSize}
-        {...knobProps.heading}
-        {...(knobProps.heading.fontWeight ? { "data-font-weight-knob": "bold" } : null)}
-      >
-        {title}
-      </TitleTag>
-    ) : null);
+  const titleNode = inlineTitle
+    ? null
+    : (heading ??
+      (title ? (
+        <TitleTag
+          margin={0}
+          {...(compact ? { numberOfLines: 1 } : null)}
+          {...largeTitle}
+          {...titleSize}
+          {...knobProps.heading}
+          {...(knobProps.heading.fontWeight ? { "data-font-weight-knob": "bold" } : null)}
+        >
+          {title}
+        </TitleTag>
+      ) : null));
+  if (inlineTitle && !subtitle && !status && !actions && !nav && !children) return null;
 
   // When nav is present the strip's active indicator sits ON this rule, so
   // there is one hairline — not a second competing line. The header then
@@ -688,6 +730,9 @@ function useBarTitleSpan() {
   };
 }
 
+// LC-270: the pushed page's bar title is the page's heading.
+const pageTitleRole = { role: "heading", "aria-level": 1 } as const;
+
 function BarTitle({
   title,
   span,
@@ -766,6 +811,7 @@ function InlineToolbar({ leading, trailing, title, children, ...rest }: ScreenTo
   const bleed = insetToken ? { marginHorizontal: negateSpaceToken(insetToken) as "$4" } : null;
   // LC-145: a phone top bar is one row; the leading group shrinks first.
   const oneRow = useLayoutSizeClass() === "compact";
+  const pushedTitle = useInlinePageTitle();
   // LC-153: the toolbar is a bar, so its neutral buttons paint plain.
   return (
     <Surface bar>
@@ -804,7 +850,12 @@ function InlineToolbar({ leading, trailing, title, children, ...rest }: ScreenTo
           {trailing}
         </IconButtonGroup>
         {title ? (
-          <BarTitle title={title} span={titleSpan.span} onTitleWidth={titleSpan.measureTitle} />
+          <BarTitle
+            title={title}
+            span={titleSpan.span}
+            onTitleWidth={titleSpan.measureTitle}
+            {...(pushedTitle ? pageTitleRole : null)}
+          />
         ) : null}
       </XStack>
     </Surface>
@@ -834,6 +885,8 @@ function PinnedTopBar({
   const titleSpan = useBarTitleSpan();
   const motion = transitionProps(knobProps.motion.control);
   const title = inlineTitle ?? largeTitle;
+  // LC-270: a pushed page shows its title in the bar from rest, as its heading.
+  const pushedTitle = useInlinePageTitle();
   // LC-153: the pinned bar is a bar, so its neutral buttons paint plain.
   return (
     <Surface bar>
@@ -888,7 +941,8 @@ function PinnedTopBar({
               title={title}
               span={titleSpan.span}
               onTitleWidth={titleSpan.measureTitle}
-              shown={Boolean(inlineTitle) || collapsed}
+              shown={Boolean(inlineTitle) || collapsed || pushedTitle}
+              {...(pushedTitle ? pageTitleRole : null)}
               {...motion}
             />
           ) : null}