@the-portland-company/shell 0.87.1 → 0.89.0

package/dist/{index-bfbWLC7_.d.cts → index-CZylXAP4.d.cts}

@@ -1,7 +1,41 @@
 import * as react_jsx_runtime from 'react/jsx-runtime';
-import { ReactNode, ComponentType, CSSProperties } from 'react';
+import * as react from 'react';
+import { ReactNode, CSSProperties, ButtonHTMLAttributes, AnchorHTMLAttributes, ElementType, InputHTMLAttributes, SelectHTMLAttributes, TextareaHTMLAttributes, ComponentType } from 'react';
 import { ThemePreference as ThemePreference$1 } from './theme-preference.cjs';
 
+type CardPadding = 'none' | 'sm' | 'md' | 'lg';
+type CardProps = {
+    /** Heading text. With none of the structured props below it renders as a plain `<h3>` inside the padded box. */
+    title?: ReactNode;
+    /** Secondary line under the title. Switches the card to the structured header layout. */
+    subtitle?: ReactNode;
+    /** Right-aligned header content (a link, chip or count). Same as `actions`; both may be set. */
+    aside?: ReactNode;
+    /** Right-aligned header buttons. */
+    actions?: ReactNode;
+    /** Bottom strip separated by a top border. */
+    footer?: ReactNode;
+    children?: ReactNode;
+    /** Padding of the card (legacy layout) or of the body (structured layout). Default `md` (p-6). */
+    padding?: CardPadding;
+    /** Replaces the body padding classes in the structured layout (e.g. `px-7 pb-6 pt-6`). */
+    bodyClassName?: string;
+    minH?: string | number;
+    className?: string;
+    style?: CSSProperties;
+    [key: string]: unknown;
+};
+/**
+ * Shared Card. Surface, border and text come from the `--app-card-*` tokens, which
+ * have light values on `:root` and dark values under `.dark`
+ * (chrome.css), so a card is correct in both themes.
+ *
+ * Plain `<Card title>` keeps the original layout (padding on the card, h3 above the
+ * content). Passing `subtitle`, `aside`, `actions`, `footer` or `bodyClassName` switches to
+ * the structured layout: bordered header, body, bordered footer.
+ */
+declare function Card({ title, subtitle, aside, actions, footer, children, padding, bodyClassName, minH, className, style, ...props }: CardProps): react_jsx_runtime.JSX.Element;
+
 type FormColumnProps = {
     children: ReactNode;
     className?: string;
@@ -19,6 +53,239 @@ type FormColumnProps = {
  */
 declare function FormColumn({ children, className }: FormColumnProps): react_jsx_runtime.JSX.Element;
 
+type BreadcrumbItem$1 = {
+    label: string;
+    href?: string;
+};
+/** The three Modes a page header's eyebrow can announce (Reference/UI-Platform
+ * → "Per-mode branding"). */
+type PageHeaderMode = 'relationship' | 'campaign' | 'petition';
+type PageHeaderProps = {
+    title?: ReactNode;
+    /**
+     * The operating Mode this page belongs to. When set, the 11px uppercase
+     * mode eyebrow ("Relationship mode" / "Campaign mode" / "Petition mode")
+     * renders above the title by DEFAULT — Reference/UI-Platform → "Page
+     * header": "Left: an 11px uppercase mode eyebrow ... in the mode color
+     * (`modes.<mode>.primary`)". Pass `showEyebrow={false}` to suppress it.
+     */
+    mode?: PageHeaderMode;
+    /** Overrides the eyebrow text the `mode` default would produce. */
+    eyebrow?: string;
+    /** Set false to suppress the eyebrow even when `mode` is passed. Default true. */
+    showEyebrow?: boolean;
+    /** Optional one-line subtitle, 15px G4, directly under the title. */
+    subtitle?: ReactNode;
+    breadcrumbs?: BreadcrumbItem$1[];
+    actions?: ReactNode;
+    tabBar?: ReactNode;
+    maxW?: string;
+    hideSidebar?: boolean;
+};
+
+type ButtonVariant = 'primary' | 'secondary' | 'ghost' | 'danger';
+type ButtonSize = 'md' | 'sm';
+type ButtonProps = Omit<ButtonHTMLAttributes<HTMLButtonElement>, 'type'> & Omit<AnchorHTMLAttributes<HTMLAnchorElement>, 'type'> & {
+    /** Visual style. Default `primary`. */
+    variant?: ButtonVariant;
+    /** `md` is 44px tall (default), `sm` is 36px. */
+    size?: ButtonSize;
+    /** Shows a spinner, sets `aria-busy`, and blocks interaction. */
+    loading?: boolean;
+    disabled?: boolean;
+    /** Renders a link-button. Without `as`, `href` renders an `<a>`. */
+    href?: string;
+    /** Element or component to render as (e.g. a router `Link`). */
+    as?: ElementType;
+    type?: 'button' | 'submit' | 'reset';
+    children?: ReactNode;
+    className?: string;
+    /** Extra props for the rendered element (e.g. a router Link's `to`). */
+    to?: string;
+};
+/**
+ * The shared button. Apps use this instead of a local Button. 5px radius, 12px
+ * horizontal padding; primary uses the shell's `--app-btn-primary-*` tokens
+ * (Specs buttonPrimary). Pass `href` (or `as`) for a link-button.
+ */
+declare const Button: react.ForwardRefExoticComponent<Omit<ButtonHTMLAttributes<HTMLButtonElement>, "type"> & Omit<AnchorHTMLAttributes<HTMLAnchorElement>, "type"> & {
+    /** Visual style. Default `primary`. */
+    variant?: ButtonVariant;
+    /** `md` is 44px tall (default), `sm` is 36px. */
+    size?: ButtonSize;
+    /** Shows a spinner, sets `aria-busy`, and blocks interaction. */
+    loading?: boolean;
+    disabled?: boolean;
+    /** Renders a link-button. Without `as`, `href` renders an `<a>`. */
+    href?: string;
+    /** Element or component to render as (e.g. a router `Link`). */
+    as?: ElementType;
+    type?: "button" | "submit" | "reset";
+    children?: ReactNode;
+    className?: string;
+    /** Extra props for the rendered element (e.g. a router Link's `to`). */
+    to?: string;
+} & react.RefAttributes<HTMLElement>>;
+
+type FieldChromeProps = {
+    /** Visible label rendered above the control. */
+    label?: ReactNode;
+    /** Helper text under the control; replaced by `error` when one is set. */
+    helperText?: ReactNode;
+    /** Error message. Truthy marks the control invalid (aria-invalid). */
+    error?: ReactNode;
+};
+
+/**
+ * Text-like input types the field styling supports. Checkbox has `Checkbox` and
+ * file has `FileInput`; radio, range and color need their own native layout and are
+ * not supported here.
+ */
+type InputType = 'text' | 'email' | 'password' | 'search' | 'tel' | 'url' | 'number' | 'date' | 'time' | 'datetime-local' | 'month' | 'week';
+type InputProps = Omit<InputHTMLAttributes<HTMLInputElement>, 'type'> & FieldChromeProps & {
+    /** Text-like types only (see `InputType`). Default `text`. */
+    type?: InputType;
+    /** Class for the control itself; the wrapper takes `wrapperClassName`. */
+    className?: string;
+    wrapperClassName?: string;
+    /** Marks the control invalid without an error message. */
+    invalid?: boolean;
+};
+/**
+ * Shared Input. Apps use this instead of a local Input. 5px radius, 12px
+ * horizontal padding, 44px control height, shell `--app-field-*` tokens.
+ */
+declare const Input: react.ForwardRefExoticComponent<Omit<InputHTMLAttributes<HTMLInputElement>, "type"> & FieldChromeProps & {
+    /** Text-like types only (see `InputType`). Default `text`. */
+    type?: InputType;
+    /** Class for the control itself; the wrapper takes `wrapperClassName`. */
+    className?: string;
+    wrapperClassName?: string;
+    /** Marks the control invalid without an error message. */
+    invalid?: boolean;
+} & react.RefAttributes<HTMLInputElement>>;
+
+type SelectProps = SelectHTMLAttributes<HTMLSelectElement> & FieldChromeProps & {
+    /** Class for the control itself; the wrapper takes `wrapperClassName`. */
+    className?: string;
+    wrapperClassName?: string;
+    /** Marks the control invalid without an error message. */
+    invalid?: boolean;
+};
+/**
+ * Shared Select. Apps use this instead of a local Select. 5px radius, 12px
+ * horizontal padding, 44px control height, shell `--app-field-*` tokens.
+ */
+declare const Select: react.ForwardRefExoticComponent<SelectHTMLAttributes<HTMLSelectElement> & FieldChromeProps & {
+    /** Class for the control itself; the wrapper takes `wrapperClassName`. */
+    className?: string;
+    wrapperClassName?: string;
+    /** Marks the control invalid without an error message. */
+    invalid?: boolean;
+} & react.RefAttributes<HTMLSelectElement>>;
+
+type TextareaProps = TextareaHTMLAttributes<HTMLTextAreaElement> & FieldChromeProps & {
+    /** Class for the control itself; the wrapper takes `wrapperClassName`. */
+    className?: string;
+    wrapperClassName?: string;
+    /** Marks the control invalid without an error message. */
+    invalid?: boolean;
+};
+/**
+ * Shared Textarea. Apps use this instead of a local Textarea. 5px radius, 12px
+ * horizontal padding, 88px minimum height, shell `--app-field-*` tokens.
+ */
+declare const Textarea: react.ForwardRefExoticComponent<TextareaHTMLAttributes<HTMLTextAreaElement> & FieldChromeProps & {
+    /** Class for the control itself; the wrapper takes `wrapperClassName`. */
+    className?: string;
+    wrapperClassName?: string;
+    /** Marks the control invalid without an error message. */
+    invalid?: boolean;
+} & react.RefAttributes<HTMLTextAreaElement>>;
+
+type CheckboxProps = Omit<InputHTMLAttributes<HTMLInputElement>, 'type'> & {
+    /** Visible label, clickable. */
+    label?: ReactNode;
+    /** Secondary text under the label. */
+    description?: ReactNode;
+    /** Mixed state (set on the DOM node; `checked` still controls the underlying value). */
+    indeterminate?: boolean;
+    /** Marks the checkbox invalid (red outline, aria-invalid). */
+    invalid?: boolean;
+    /** Class for the `<input>`; the row takes `wrapperClassName`. */
+    className?: string;
+    wrapperClassName?: string;
+};
+/**
+ * Shared Checkbox. The whole row is a 44px-tall touch target (label wraps the
+ * control); colors come from the shell tokens, with the accent as the fill.
+ */
+declare const Checkbox: react.ForwardRefExoticComponent<Omit<InputHTMLAttributes<HTMLInputElement>, "type"> & {
+    /** Visible label, clickable. */
+    label?: ReactNode;
+    /** Secondary text under the label. */
+    description?: ReactNode;
+    /** Mixed state (set on the DOM node; `checked` still controls the underlying value). */
+    indeterminate?: boolean;
+    /** Marks the checkbox invalid (red outline, aria-invalid). */
+    invalid?: boolean;
+    /** Class for the `<input>`; the row takes `wrapperClassName`. */
+    className?: string;
+    wrapperClassName?: string;
+} & react.RefAttributes<HTMLInputElement>>;
+
+type FileInputProps = Omit<InputHTMLAttributes<HTMLInputElement>, 'type' | 'value' | 'defaultValue'> & FieldChromeProps & {
+    /** Class for the control itself; the wrapper takes `wrapperClassName`. */
+    className?: string;
+    wrapperClassName?: string;
+    /** Marks the control invalid without an error message. */
+    invalid?: boolean;
+};
+/**
+ * Shared file picker (`<input type="file">`). Same label/helper/error chrome and
+ * field tokens as `Input`; the native "Choose file" button is styled with the
+ * secondary-button tokens. Use `accept` / `multiple` as usual.
+ */
+declare const FileInput: react.ForwardRefExoticComponent<Omit<InputHTMLAttributes<HTMLInputElement>, "value" | "type" | "defaultValue"> & FieldChromeProps & {
+    /** Class for the control itself; the wrapper takes `wrapperClassName`. */
+    className?: string;
+    wrapperClassName?: string;
+    /** Marks the control invalid without an error message. */
+    invalid?: boolean;
+} & react.RefAttributes<HTMLInputElement>>;
+
+type BreadcrumbItem = {
+    label: string;
+    href?: string;
+};
+type BreadcrumbBarProps = {
+    breadcrumbs?: BreadcrumbItem[];
+    actions?: ReactNode;
+    maxW?: string;
+};
+
+type HeaderTabBarItem = {
+    id: string;
+    label: string;
+    icon: ReactNode;
+    disabled?: boolean;
+};
+type HeaderTabBarProps = {
+    items: HeaderTabBarItem[];
+    activeId: string;
+    onChange: (id: string) => void;
+    className?: string;
+    ariaLabel?: string;
+};
+/**
+ * @deprecated Use `NavTabStrip` from `@the-portland-company/shell/native` —
+ * the ONE canonical page tab strip (underlined text tabs with a 2px underline
+ * in the mode color, Brand guideline "Tabs are an underlined strip").
+ * `HeaderTabBar` is icon-only and filled, cannot render link tabs, and needs
+ * Chakra. Warns in development.
+ */
+declare function HeaderTabBar({ items, activeId, onChange, className, ariaLabel, }: HeaderTabBarProps): react_jsx_runtime.JSX.Element;
+
 /**
  * The six canonical top-bar action slots (Reference/Global-Rules v9 → top-bar
  * icons). Each slot's GLYPH is unique and comes from the Brand API
@@ -422,6 +689,15 @@ declare function useThemePreference(): {
     setValue: (next: ThemePreference) => void;
 };
 
+/** Page header for apps with no react-router: breadcrumbs render as plain anchors. */
+declare function PageHeader(props: PageHeaderProps): react_jsx_runtime.JSX.Element;
+
+/**
+ * @deprecated Not for app use: the breadcrumb trail is retired. Kept for parity
+ * with the main entry; breadcrumb links render as plain anchors.
+ */
+declare function BreadcrumbBar(props: BreadcrumbBarProps): react_jsx_runtime.JSX.Element;
+
 /**
  * Icon slots used by the standard menus. The shell stays icon-library-agnostic:
  * callers map each key to their own icon components (lucide, react-icons, …).
@@ -1059,4 +1335,4 @@ type NavAppShellProps = {
 };
 declare function NavAppShell({ sidebar, topBar, betaBanner, contentWrapper, accountMenuPlacement, modeId, children, }: NavAppShellProps): react_jsx_runtime.JSX.Element;
 
-export { type NavRoleBadge as $, type ChromeNotificationQuarantine as A, BETA_BANNER_DISMISS_KEY as B, type CommsNotification as C, type ChromeNotificationReply as D, type ChromeNotificationsPayload as E, FormColumn as F, type ChromeOrgSummary as G, type CommunicationsFuelStatus as H, type CreditHealthState as I, type CreditTypeKey as J, CreditsAction as K, type CreditsIconState as L, FuelAction as M, type NavItem as N, type FuelChannelStatus as O, NavAppShell as P, type NavAppShellProps as Q, NavBetaBanner as R, type StandardNavIconKey as S, type NavBetaBannerProps as T, type NavBrand as U, NavChromeProvider as V, NavDisplayAction as W, type NavLinkProps as X, type NavLinkedAccount as Y, type NavModeOption as Z, type NavOrg as _, type CommsNotificationKind as a, NavSidebar as a0, type NavSidebarProps as a1, type NavTab as a2, NavTabStrip as a3, type NavTabStripProps as a4, NavThemeControl as a5, NavTopBar as a6, type NavTopBarAction as a7, type NavTopBarProps as a8, type NavUser as a9, useChromeMe as aA, useChromeOrgs as aB, useNavChromeDedupedFetch as aC, useNavChromeFetcher as aD, useThemePreference as aE, NotificationsAction as aa, SPECS_ORIGIN as ab, SpecOverlayAction as ac, type StandardNavOptions as ad, SupportAction as ae, type ThemePreference as af, TopBarCountBadge as ag, type TopBarIconTone as ah, TopBarPanelArrow as ai, TopBarPopover as aj, TopBarTooltip as ak, TopBarWidgetSlot as al, clearBetaBannerDismissal as am, creditGaugeRatio as an, creditStateWord as ao, creditTooltipLine as ap, creditsAriaLabel as aq, creditsIconState as ar, envChipClasses as as, isNavItemActive as at, modeIdFromLabel as au, resolveOrgLogoUrl as av, shortEnvLabel as aw, shortUserName as ax, standardPolitogyNav as ay, topBarIconButtonClass as az, type NotificationsAdapter as b, type NotificationsFeed as c, createCommsNotificationsAdapter as d, emptyNotificationsFeed as e, type NavIcon as f, type NavBreadcrumb as g, type StandardNavMode as h, type NavLinkComponent as i, type NavChromeFetcher as j, type NavMode as k, type NavUserMenu as l, type NavOrgOption as m, normalizeNotificationsFeed as n, type NavFooterLink as o, type NavFooter as p, type NavDisplayMode as q, CAMPAIGN_FEATURE_AVAILABILITY as r, CORE_APP_ORIGIN as s, CORE_BILLING_PATH as t, CREDIT_TYPE_LABELS as u, CREDIT_TYPE_ORDER as v, type CampaignFeatureAvailability as w, type ChromeMe as x, type ChromeNotificationAlert as y, type ChromeNotificationImport as z };
+export { type ChromeNotificationQuarantine as $, type NavChromeFetcher as A, type BreadcrumbBarProps as B, Card as C, type NavMode as D, type NavUserMenu as E, FileInput as F, type NavOrgOption as G, HeaderTabBar as H, Input as I, type NavFooterLink as J, type NavFooter as K, type NavDisplayMode as L, BETA_BANNER_DISMISS_KEY as M, type NavItem as N, BreadcrumbBar as O, type PageHeaderProps as P, CAMPAIGN_FEATURE_AVAILABILITY as Q, CORE_APP_ORIGIN as R, Select as S, Textarea as T, CORE_BILLING_PATH as U, CREDIT_TYPE_LABELS as V, CREDIT_TYPE_ORDER as W, type CampaignFeatureAvailability as X, type ChromeMe as Y, type ChromeNotificationAlert as Z, type ChromeNotificationImport as _, Button as a, useNavChromeFetcher as a$, type ChromeNotificationReply as a0, type ChromeNotificationsPayload as a1, type ChromeOrgSummary as a2, type CommunicationsFuelStatus as a3, type CreditHealthState as a4, type CreditTypeKey as a5, CreditsAction as a6, type CreditsIconState as a7, FuelAction as a8, type FuelChannelStatus as a9, SpecOverlayAction as aA, type StandardNavOptions as aB, SupportAction as aC, type ThemePreference as aD, TopBarCountBadge as aE, type TopBarIconTone as aF, TopBarPanelArrow as aG, TopBarPopover as aH, TopBarTooltip as aI, TopBarWidgetSlot as aJ, clearBetaBannerDismissal as aK, creditGaugeRatio as aL, creditStateWord as aM, creditTooltipLine as aN, creditsAriaLabel as aO, creditsIconState as aP, envChipClasses as aQ, isNavItemActive as aR, modeIdFromLabel as aS, resolveOrgLogoUrl as aT, shortEnvLabel as aU, shortUserName as aV, standardPolitogyNav as aW, topBarIconButtonClass as aX, useChromeMe as aY, useChromeOrgs as aZ, useNavChromeDedupedFetch as a_, NavAppShell as aa, type NavAppShellProps as ab, NavBetaBanner as ac, type NavBetaBannerProps as ad, type NavBrand as ae, NavChromeProvider as af, NavDisplayAction as ag, type NavLinkProps as ah, type NavLinkedAccount as ai, type NavModeOption as aj, type NavOrg as ak, type NavRoleBadge as al, NavSidebar as am, type NavSidebarProps as an, type NavTab as ao, NavTabStrip as ap, type NavTabStripProps as aq, NavThemeControl as ar, NavTopBar as as, type NavTopBarAction as at, type NavTopBarProps as au, type NavUser as av, NotificationsAction as aw, PageHeader as ax, type PageHeaderMode as ay, SPECS_ORIGIN as az, type ButtonProps as b, useThemePreference as b0, type ButtonSize as c, type ButtonVariant as d, type CardPadding as e, type CardProps as f, Checkbox as g, type CheckboxProps as h, type CommsNotification as i, type CommsNotificationKind as j, type FileInputProps as k, FormColumn as l, type HeaderTabBarItem as m, type InputProps as n, type NotificationsAdapter as o, type NotificationsFeed as p, type SelectProps as q, type TextareaProps as r, createCommsNotificationsAdapter as s, emptyNotificationsFeed as t, normalizeNotificationsFeed as u, type StandardNavIconKey as v, type NavIcon as w, type NavBreadcrumb as x, type StandardNavMode as y, type NavLinkComponent as z };

package/dist/{index-C31E7M9l.d.ts → index-DwkSyAip.d.ts}

@@ -1,7 +1,41 @@
 import * as react_jsx_runtime from 'react/jsx-runtime';
-import { ReactNode, ComponentType, CSSProperties } from 'react';
+import * as react from 'react';
+import { ReactNode, CSSProperties, ButtonHTMLAttributes, AnchorHTMLAttributes, ElementType, InputHTMLAttributes, SelectHTMLAttributes, TextareaHTMLAttributes, ComponentType } from 'react';
 import { ThemePreference as ThemePreference$1 } from './theme-preference.js';
 
+type CardPadding = 'none' | 'sm' | 'md' | 'lg';
+type CardProps = {
+    /** Heading text. With none of the structured props below it renders as a plain `<h3>` inside the padded box. */
+    title?: ReactNode;
+    /** Secondary line under the title. Switches the card to the structured header layout. */
+    subtitle?: ReactNode;
+    /** Right-aligned header content (a link, chip or count). Same as `actions`; both may be set. */
+    aside?: ReactNode;
+    /** Right-aligned header buttons. */
+    actions?: ReactNode;
+    /** Bottom strip separated by a top border. */
+    footer?: ReactNode;
+    children?: ReactNode;
+    /** Padding of the card (legacy layout) or of the body (structured layout). Default `md` (p-6). */
+    padding?: CardPadding;
+    /** Replaces the body padding classes in the structured layout (e.g. `px-7 pb-6 pt-6`). */
+    bodyClassName?: string;
+    minH?: string | number;
+    className?: string;
+    style?: CSSProperties;
+    [key: string]: unknown;
+};
+/**
+ * Shared Card. Surface, border and text come from the `--app-card-*` tokens, which
+ * have light values on `:root` and dark values under `.dark`
+ * (chrome.css), so a card is correct in both themes.
+ *
+ * Plain `<Card title>` keeps the original layout (padding on the card, h3 above the
+ * content). Passing `subtitle`, `aside`, `actions`, `footer` or `bodyClassName` switches to
+ * the structured layout: bordered header, body, bordered footer.
+ */
+declare function Card({ title, subtitle, aside, actions, footer, children, padding, bodyClassName, minH, className, style, ...props }: CardProps): react_jsx_runtime.JSX.Element;
+
 type FormColumnProps = {
     children: ReactNode;
     className?: string;
@@ -19,6 +53,239 @@ type FormColumnProps = {
  */
 declare function FormColumn({ children, className }: FormColumnProps): react_jsx_runtime.JSX.Element;
 
+type BreadcrumbItem$1 = {
+    label: string;
+    href?: string;
+};
+/** The three Modes a page header's eyebrow can announce (Reference/UI-Platform
+ * → "Per-mode branding"). */
+type PageHeaderMode = 'relationship' | 'campaign' | 'petition';
+type PageHeaderProps = {
+    title?: ReactNode;
+    /**
+     * The operating Mode this page belongs to. When set, the 11px uppercase
+     * mode eyebrow ("Relationship mode" / "Campaign mode" / "Petition mode")
+     * renders above the title by DEFAULT — Reference/UI-Platform → "Page
+     * header": "Left: an 11px uppercase mode eyebrow ... in the mode color
+     * (`modes.<mode>.primary`)". Pass `showEyebrow={false}` to suppress it.
+     */
+    mode?: PageHeaderMode;
+    /** Overrides the eyebrow text the `mode` default would produce. */
+    eyebrow?: string;
+    /** Set false to suppress the eyebrow even when `mode` is passed. Default true. */
+    showEyebrow?: boolean;
+    /** Optional one-line subtitle, 15px G4, directly under the title. */
+    subtitle?: ReactNode;
+    breadcrumbs?: BreadcrumbItem$1[];
+    actions?: ReactNode;
+    tabBar?: ReactNode;
+    maxW?: string;
+    hideSidebar?: boolean;
+};
+
+type ButtonVariant = 'primary' | 'secondary' | 'ghost' | 'danger';
+type ButtonSize = 'md' | 'sm';
+type ButtonProps = Omit<ButtonHTMLAttributes<HTMLButtonElement>, 'type'> & Omit<AnchorHTMLAttributes<HTMLAnchorElement>, 'type'> & {
+    /** Visual style. Default `primary`. */
+    variant?: ButtonVariant;
+    /** `md` is 44px tall (default), `sm` is 36px. */
+    size?: ButtonSize;
+    /** Shows a spinner, sets `aria-busy`, and blocks interaction. */
+    loading?: boolean;
+    disabled?: boolean;
+    /** Renders a link-button. Without `as`, `href` renders an `<a>`. */
+    href?: string;
+    /** Element or component to render as (e.g. a router `Link`). */
+    as?: ElementType;
+    type?: 'button' | 'submit' | 'reset';
+    children?: ReactNode;
+    className?: string;
+    /** Extra props for the rendered element (e.g. a router Link's `to`). */
+    to?: string;
+};
+/**
+ * The shared button. Apps use this instead of a local Button. 5px radius, 12px
+ * horizontal padding; primary uses the shell's `--app-btn-primary-*` tokens
+ * (Specs buttonPrimary). Pass `href` (or `as`) for a link-button.
+ */
+declare const Button: react.ForwardRefExoticComponent<Omit<ButtonHTMLAttributes<HTMLButtonElement>, "type"> & Omit<AnchorHTMLAttributes<HTMLAnchorElement>, "type"> & {
+    /** Visual style. Default `primary`. */
+    variant?: ButtonVariant;
+    /** `md` is 44px tall (default), `sm` is 36px. */
+    size?: ButtonSize;
+    /** Shows a spinner, sets `aria-busy`, and blocks interaction. */
+    loading?: boolean;
+    disabled?: boolean;
+    /** Renders a link-button. Without `as`, `href` renders an `<a>`. */
+    href?: string;
+    /** Element or component to render as (e.g. a router `Link`). */
+    as?: ElementType;
+    type?: "button" | "submit" | "reset";
+    children?: ReactNode;
+    className?: string;
+    /** Extra props for the rendered element (e.g. a router Link's `to`). */
+    to?: string;
+} & react.RefAttributes<HTMLElement>>;
+
+type FieldChromeProps = {
+    /** Visible label rendered above the control. */
+    label?: ReactNode;
+    /** Helper text under the control; replaced by `error` when one is set. */
+    helperText?: ReactNode;
+    /** Error message. Truthy marks the control invalid (aria-invalid). */
+    error?: ReactNode;
+};
+
+/**
+ * Text-like input types the field styling supports. Checkbox has `Checkbox` and
+ * file has `FileInput`; radio, range and color need their own native layout and are
+ * not supported here.
+ */
+type InputType = 'text' | 'email' | 'password' | 'search' | 'tel' | 'url' | 'number' | 'date' | 'time' | 'datetime-local' | 'month' | 'week';
+type InputProps = Omit<InputHTMLAttributes<HTMLInputElement>, 'type'> & FieldChromeProps & {
+    /** Text-like types only (see `InputType`). Default `text`. */
+    type?: InputType;
+    /** Class for the control itself; the wrapper takes `wrapperClassName`. */
+    className?: string;
+    wrapperClassName?: string;
+    /** Marks the control invalid without an error message. */
+    invalid?: boolean;
+};
+/**
+ * Shared Input. Apps use this instead of a local Input. 5px radius, 12px
+ * horizontal padding, 44px control height, shell `--app-field-*` tokens.
+ */
+declare const Input: react.ForwardRefExoticComponent<Omit<InputHTMLAttributes<HTMLInputElement>, "type"> & FieldChromeProps & {
+    /** Text-like types only (see `InputType`). Default `text`. */
+    type?: InputType;
+    /** Class for the control itself; the wrapper takes `wrapperClassName`. */
+    className?: string;
+    wrapperClassName?: string;
+    /** Marks the control invalid without an error message. */
+    invalid?: boolean;
+} & react.RefAttributes<HTMLInputElement>>;
+
+type SelectProps = SelectHTMLAttributes<HTMLSelectElement> & FieldChromeProps & {
+    /** Class for the control itself; the wrapper takes `wrapperClassName`. */
+    className?: string;
+    wrapperClassName?: string;
+    /** Marks the control invalid without an error message. */
+    invalid?: boolean;
+};
+/**
+ * Shared Select. Apps use this instead of a local Select. 5px radius, 12px
+ * horizontal padding, 44px control height, shell `--app-field-*` tokens.
+ */
+declare const Select: react.ForwardRefExoticComponent<SelectHTMLAttributes<HTMLSelectElement> & FieldChromeProps & {
+    /** Class for the control itself; the wrapper takes `wrapperClassName`. */
+    className?: string;
+    wrapperClassName?: string;
+    /** Marks the control invalid without an error message. */
+    invalid?: boolean;
+} & react.RefAttributes<HTMLSelectElement>>;
+
+type TextareaProps = TextareaHTMLAttributes<HTMLTextAreaElement> & FieldChromeProps & {
+    /** Class for the control itself; the wrapper takes `wrapperClassName`. */
+    className?: string;
+    wrapperClassName?: string;
+    /** Marks the control invalid without an error message. */
+    invalid?: boolean;
+};
+/**
+ * Shared Textarea. Apps use this instead of a local Textarea. 5px radius, 12px
+ * horizontal padding, 88px minimum height, shell `--app-field-*` tokens.
+ */
+declare const Textarea: react.ForwardRefExoticComponent<TextareaHTMLAttributes<HTMLTextAreaElement> & FieldChromeProps & {
+    /** Class for the control itself; the wrapper takes `wrapperClassName`. */
+    className?: string;
+    wrapperClassName?: string;
+    /** Marks the control invalid without an error message. */
+    invalid?: boolean;
+} & react.RefAttributes<HTMLTextAreaElement>>;
+
+type CheckboxProps = Omit<InputHTMLAttributes<HTMLInputElement>, 'type'> & {
+    /** Visible label, clickable. */
+    label?: ReactNode;
+    /** Secondary text under the label. */
+    description?: ReactNode;
+    /** Mixed state (set on the DOM node; `checked` still controls the underlying value). */
+    indeterminate?: boolean;
+    /** Marks the checkbox invalid (red outline, aria-invalid). */
+    invalid?: boolean;
+    /** Class for the `<input>`; the row takes `wrapperClassName`. */
+    className?: string;
+    wrapperClassName?: string;
+};
+/**
+ * Shared Checkbox. The whole row is a 44px-tall touch target (label wraps the
+ * control); colors come from the shell tokens, with the accent as the fill.
+ */
+declare const Checkbox: react.ForwardRefExoticComponent<Omit<InputHTMLAttributes<HTMLInputElement>, "type"> & {
+    /** Visible label, clickable. */
+    label?: ReactNode;
+    /** Secondary text under the label. */
+    description?: ReactNode;
+    /** Mixed state (set on the DOM node; `checked` still controls the underlying value). */
+    indeterminate?: boolean;
+    /** Marks the checkbox invalid (red outline, aria-invalid). */
+    invalid?: boolean;
+    /** Class for the `<input>`; the row takes `wrapperClassName`. */
+    className?: string;
+    wrapperClassName?: string;
+} & react.RefAttributes<HTMLInputElement>>;
+
+type FileInputProps = Omit<InputHTMLAttributes<HTMLInputElement>, 'type' | 'value' | 'defaultValue'> & FieldChromeProps & {
+    /** Class for the control itself; the wrapper takes `wrapperClassName`. */
+    className?: string;
+    wrapperClassName?: string;
+    /** Marks the control invalid without an error message. */
+    invalid?: boolean;
+};
+/**
+ * Shared file picker (`<input type="file">`). Same label/helper/error chrome and
+ * field tokens as `Input`; the native "Choose file" button is styled with the
+ * secondary-button tokens. Use `accept` / `multiple` as usual.
+ */
+declare const FileInput: react.ForwardRefExoticComponent<Omit<InputHTMLAttributes<HTMLInputElement>, "value" | "type" | "defaultValue"> & FieldChromeProps & {
+    /** Class for the control itself; the wrapper takes `wrapperClassName`. */
+    className?: string;
+    wrapperClassName?: string;
+    /** Marks the control invalid without an error message. */
+    invalid?: boolean;
+} & react.RefAttributes<HTMLInputElement>>;
+
+type BreadcrumbItem = {
+    label: string;
+    href?: string;
+};
+type BreadcrumbBarProps = {
+    breadcrumbs?: BreadcrumbItem[];
+    actions?: ReactNode;
+    maxW?: string;
+};
+
+type HeaderTabBarItem = {
+    id: string;
+    label: string;
+    icon: ReactNode;
+    disabled?: boolean;
+};
+type HeaderTabBarProps = {
+    items: HeaderTabBarItem[];
+    activeId: string;
+    onChange: (id: string) => void;
+    className?: string;
+    ariaLabel?: string;
+};
+/**
+ * @deprecated Use `NavTabStrip` from `@the-portland-company/shell/native` —
+ * the ONE canonical page tab strip (underlined text tabs with a 2px underline
+ * in the mode color, Brand guideline "Tabs are an underlined strip").
+ * `HeaderTabBar` is icon-only and filled, cannot render link tabs, and needs
+ * Chakra. Warns in development.
+ */
+declare function HeaderTabBar({ items, activeId, onChange, className, ariaLabel, }: HeaderTabBarProps): react_jsx_runtime.JSX.Element;
+
 /**
  * The six canonical top-bar action slots (Reference/Global-Rules v9 → top-bar
  * icons). Each slot's GLYPH is unique and comes from the Brand API
@@ -422,6 +689,15 @@ declare function useThemePreference(): {
     setValue: (next: ThemePreference) => void;
 };
 
+/** Page header for apps with no react-router: breadcrumbs render as plain anchors. */
+declare function PageHeader(props: PageHeaderProps): react_jsx_runtime.JSX.Element;
+
+/**
+ * @deprecated Not for app use: the breadcrumb trail is retired. Kept for parity
+ * with the main entry; breadcrumb links render as plain anchors.
+ */
+declare function BreadcrumbBar(props: BreadcrumbBarProps): react_jsx_runtime.JSX.Element;
+
 /**
  * Icon slots used by the standard menus. The shell stays icon-library-agnostic:
  * callers map each key to their own icon components (lucide, react-icons, …).
@@ -1059,4 +1335,4 @@ type NavAppShellProps = {
 };
 declare function NavAppShell({ sidebar, topBar, betaBanner, contentWrapper, accountMenuPlacement, modeId, children, }: NavAppShellProps): react_jsx_runtime.JSX.Element;
 
-export { type NavRoleBadge as $, type ChromeNotificationQuarantine as A, BETA_BANNER_DISMISS_KEY as B, type CommsNotification as C, type ChromeNotificationReply as D, type ChromeNotificationsPayload as E, FormColumn as F, type ChromeOrgSummary as G, type CommunicationsFuelStatus as H, type CreditHealthState as I, type CreditTypeKey as J, CreditsAction as K, type CreditsIconState as L, FuelAction as M, type NavItem as N, type FuelChannelStatus as O, NavAppShell as P, type NavAppShellProps as Q, NavBetaBanner as R, type StandardNavIconKey as S, type NavBetaBannerProps as T, type NavBrand as U, NavChromeProvider as V, NavDisplayAction as W, type NavLinkProps as X, type NavLinkedAccount as Y, type NavModeOption as Z, type NavOrg as _, type CommsNotificationKind as a, NavSidebar as a0, type NavSidebarProps as a1, type NavTab as a2, NavTabStrip as a3, type NavTabStripProps as a4, NavThemeControl as a5, NavTopBar as a6, type NavTopBarAction as a7, type NavTopBarProps as a8, type NavUser as a9, useChromeMe as aA, useChromeOrgs as aB, useNavChromeDedupedFetch as aC, useNavChromeFetcher as aD, useThemePreference as aE, NotificationsAction as aa, SPECS_ORIGIN as ab, SpecOverlayAction as ac, type StandardNavOptions as ad, SupportAction as ae, type ThemePreference as af, TopBarCountBadge as ag, type TopBarIconTone as ah, TopBarPanelArrow as ai, TopBarPopover as aj, TopBarTooltip as ak, TopBarWidgetSlot as al, clearBetaBannerDismissal as am, creditGaugeRatio as an, creditStateWord as ao, creditTooltipLine as ap, creditsAriaLabel as aq, creditsIconState as ar, envChipClasses as as, isNavItemActive as at, modeIdFromLabel as au, resolveOrgLogoUrl as av, shortEnvLabel as aw, shortUserName as ax, standardPolitogyNav as ay, topBarIconButtonClass as az, type NotificationsAdapter as b, type NotificationsFeed as c, createCommsNotificationsAdapter as d, emptyNotificationsFeed as e, type NavIcon as f, type NavBreadcrumb as g, type StandardNavMode as h, type NavLinkComponent as i, type NavChromeFetcher as j, type NavMode as k, type NavUserMenu as l, type NavOrgOption as m, normalizeNotificationsFeed as n, type NavFooterLink as o, type NavFooter as p, type NavDisplayMode as q, CAMPAIGN_FEATURE_AVAILABILITY as r, CORE_APP_ORIGIN as s, CORE_BILLING_PATH as t, CREDIT_TYPE_LABELS as u, CREDIT_TYPE_ORDER as v, type CampaignFeatureAvailability as w, type ChromeMe as x, type ChromeNotificationAlert as y, type ChromeNotificationImport as z };
+export { type ChromeNotificationQuarantine as $, type NavChromeFetcher as A, type BreadcrumbBarProps as B, Card as C, type NavMode as D, type NavUserMenu as E, FileInput as F, type NavOrgOption as G, HeaderTabBar as H, Input as I, type NavFooterLink as J, type NavFooter as K, type NavDisplayMode as L, BETA_BANNER_DISMISS_KEY as M, type NavItem as N, BreadcrumbBar as O, type PageHeaderProps as P, CAMPAIGN_FEATURE_AVAILABILITY as Q, CORE_APP_ORIGIN as R, Select as S, Textarea as T, CORE_BILLING_PATH as U, CREDIT_TYPE_LABELS as V, CREDIT_TYPE_ORDER as W, type CampaignFeatureAvailability as X, type ChromeMe as Y, type ChromeNotificationAlert as Z, type ChromeNotificationImport as _, Button as a, useNavChromeFetcher as a$, type ChromeNotificationReply as a0, type ChromeNotificationsPayload as a1, type ChromeOrgSummary as a2, type CommunicationsFuelStatus as a3, type CreditHealthState as a4, type CreditTypeKey as a5, CreditsAction as a6, type CreditsIconState as a7, FuelAction as a8, type FuelChannelStatus as a9, SpecOverlayAction as aA, type StandardNavOptions as aB, SupportAction as aC, type ThemePreference as aD, TopBarCountBadge as aE, type TopBarIconTone as aF, TopBarPanelArrow as aG, TopBarPopover as aH, TopBarTooltip as aI, TopBarWidgetSlot as aJ, clearBetaBannerDismissal as aK, creditGaugeRatio as aL, creditStateWord as aM, creditTooltipLine as aN, creditsAriaLabel as aO, creditsIconState as aP, envChipClasses as aQ, isNavItemActive as aR, modeIdFromLabel as aS, resolveOrgLogoUrl as aT, shortEnvLabel as aU, shortUserName as aV, standardPolitogyNav as aW, topBarIconButtonClass as aX, useChromeMe as aY, useChromeOrgs as aZ, useNavChromeDedupedFetch as a_, NavAppShell as aa, type NavAppShellProps as ab, NavBetaBanner as ac, type NavBetaBannerProps as ad, type NavBrand as ae, NavChromeProvider as af, NavDisplayAction as ag, type NavLinkProps as ah, type NavLinkedAccount as ai, type NavModeOption as aj, type NavOrg as ak, type NavRoleBadge as al, NavSidebar as am, type NavSidebarProps as an, type NavTab as ao, NavTabStrip as ap, type NavTabStripProps as aq, NavThemeControl as ar, NavTopBar as as, type NavTopBarAction as at, type NavTopBarProps as au, type NavUser as av, NotificationsAction as aw, PageHeader as ax, type PageHeaderMode as ay, SPECS_ORIGIN as az, type ButtonProps as b, useThemePreference as b0, type ButtonSize as c, type ButtonVariant as d, type CardPadding as e, type CardProps as f, Checkbox as g, type CheckboxProps as h, type CommsNotification as i, type CommsNotificationKind as j, type FileInputProps as k, FormColumn as l, type HeaderTabBarItem as m, type InputProps as n, type NotificationsAdapter as o, type NotificationsFeed as p, type SelectProps as q, type TextareaProps as r, createCommsNotificationsAdapter as s, emptyNotificationsFeed as t, normalizeNotificationsFeed as u, type StandardNavIconKey as v, type NavIcon as w, type NavBreadcrumb as x, type StandardNavMode as y, type NavLinkComponent as z };