@the-portland-company/shell 0.87.1 → 0.88.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.
@@ -1,7 +1,18 @@
1
1
  import * as react_jsx_runtime from 'react/jsx-runtime';
2
- import { ReactNode, ComponentType, CSSProperties } from 'react';
2
+ import * as react from 'react';
3
+ import { ReactNode, CSSProperties, ButtonHTMLAttributes, AnchorHTMLAttributes, ElementType, InputHTMLAttributes, SelectHTMLAttributes, TextareaHTMLAttributes, ComponentType } from 'react';
3
4
  import { ThemePreference as ThemePreference$1 } from './theme-preference.js';
4
5
 
6
+ type CardProps = {
7
+ title?: string;
8
+ children: ReactNode;
9
+ minH?: string | number;
10
+ className?: string;
11
+ style?: CSSProperties;
12
+ [key: string]: unknown;
13
+ };
14
+ declare function Card({ title, children, minH, className, style, ...props }: CardProps): react_jsx_runtime.JSX.Element;
15
+
5
16
  type FormColumnProps = {
6
17
  children: ReactNode;
7
18
  className?: string;
@@ -19,6 +30,187 @@ type FormColumnProps = {
19
30
  */
20
31
  declare function FormColumn({ children, className }: FormColumnProps): react_jsx_runtime.JSX.Element;
21
32
 
33
+ type BreadcrumbItem$1 = {
34
+ label: string;
35
+ href?: string;
36
+ };
37
+ /** The three Modes a page header's eyebrow can announce (Reference/UI-Platform
38
+ * → "Per-mode branding"). */
39
+ type PageHeaderMode = 'relationship' | 'campaign' | 'petition';
40
+ type PageHeaderProps = {
41
+ title?: ReactNode;
42
+ /**
43
+ * The operating Mode this page belongs to. When set, the 11px uppercase
44
+ * mode eyebrow ("Relationship mode" / "Campaign mode" / "Petition mode")
45
+ * renders above the title by DEFAULT — Reference/UI-Platform → "Page
46
+ * header": "Left: an 11px uppercase mode eyebrow ... in the mode color
47
+ * (`modes.<mode>.primary`)". Pass `showEyebrow={false}` to suppress it.
48
+ */
49
+ mode?: PageHeaderMode;
50
+ /** Overrides the eyebrow text the `mode` default would produce. */
51
+ eyebrow?: string;
52
+ /** Set false to suppress the eyebrow even when `mode` is passed. Default true. */
53
+ showEyebrow?: boolean;
54
+ /** Optional one-line subtitle, 15px G4, directly under the title. */
55
+ subtitle?: ReactNode;
56
+ breadcrumbs?: BreadcrumbItem$1[];
57
+ actions?: ReactNode;
58
+ tabBar?: ReactNode;
59
+ maxW?: string;
60
+ hideSidebar?: boolean;
61
+ };
62
+
63
+ type ButtonVariant = 'primary' | 'secondary' | 'ghost' | 'danger';
64
+ type ButtonSize = 'md' | 'sm';
65
+ type ButtonProps = Omit<ButtonHTMLAttributes<HTMLButtonElement>, 'type'> & Omit<AnchorHTMLAttributes<HTMLAnchorElement>, 'type'> & {
66
+ /** Visual style. Default `primary`. */
67
+ variant?: ButtonVariant;
68
+ /** `md` is 44px tall (default), `sm` is 36px. */
69
+ size?: ButtonSize;
70
+ /** Shows a spinner, sets `aria-busy`, and blocks interaction. */
71
+ loading?: boolean;
72
+ disabled?: boolean;
73
+ /** Renders a link-button. Without `as`, `href` renders an `<a>`. */
74
+ href?: string;
75
+ /** Element or component to render as (e.g. a router `Link`). */
76
+ as?: ElementType;
77
+ type?: 'button' | 'submit' | 'reset';
78
+ children?: ReactNode;
79
+ className?: string;
80
+ /** Extra props for the rendered element (e.g. a router Link's `to`). */
81
+ to?: string;
82
+ };
83
+ /**
84
+ * The shared button. Apps use this instead of a local Button. 5px radius, 12px
85
+ * horizontal padding; primary uses the shell's `--app-btn-primary-*` tokens
86
+ * (Specs buttonPrimary). Pass `href` (or `as`) for a link-button.
87
+ */
88
+ declare const Button: react.ForwardRefExoticComponent<Omit<ButtonHTMLAttributes<HTMLButtonElement>, "type"> & Omit<AnchorHTMLAttributes<HTMLAnchorElement>, "type"> & {
89
+ /** Visual style. Default `primary`. */
90
+ variant?: ButtonVariant;
91
+ /** `md` is 44px tall (default), `sm` is 36px. */
92
+ size?: ButtonSize;
93
+ /** Shows a spinner, sets `aria-busy`, and blocks interaction. */
94
+ loading?: boolean;
95
+ disabled?: boolean;
96
+ /** Renders a link-button. Without `as`, `href` renders an `<a>`. */
97
+ href?: string;
98
+ /** Element or component to render as (e.g. a router `Link`). */
99
+ as?: ElementType;
100
+ type?: "button" | "submit" | "reset";
101
+ children?: ReactNode;
102
+ className?: string;
103
+ /** Extra props for the rendered element (e.g. a router Link's `to`). */
104
+ to?: string;
105
+ } & react.RefAttributes<HTMLElement>>;
106
+
107
+ type FieldChromeProps = {
108
+ /** Visible label rendered above the control. */
109
+ label?: ReactNode;
110
+ /** Helper text under the control; replaced by `error` when one is set. */
111
+ helperText?: ReactNode;
112
+ /** Error message. Truthy marks the control invalid (aria-invalid). */
113
+ error?: ReactNode;
114
+ };
115
+
116
+ /**
117
+ * Text-like input types the field styling supports. Checkbox, radio, range,
118
+ * file and color need their own native layout and are not supported here.
119
+ */
120
+ type InputType = 'text' | 'email' | 'password' | 'search' | 'tel' | 'url' | 'number' | 'date' | 'time' | 'datetime-local' | 'month' | 'week';
121
+ type InputProps = Omit<InputHTMLAttributes<HTMLInputElement>, 'type'> & FieldChromeProps & {
122
+ /** Text-like types only (see `InputType`). Default `text`. */
123
+ type?: InputType;
124
+ /** Class for the control itself; the wrapper takes `wrapperClassName`. */
125
+ className?: string;
126
+ wrapperClassName?: string;
127
+ /** Marks the control invalid without an error message. */
128
+ invalid?: boolean;
129
+ };
130
+ /**
131
+ * Shared Input. Apps use this instead of a local Input. 5px radius, 12px
132
+ * horizontal padding, 44px control height, shell `--app-field-*` tokens.
133
+ */
134
+ declare const Input: react.ForwardRefExoticComponent<Omit<InputHTMLAttributes<HTMLInputElement>, "type"> & FieldChromeProps & {
135
+ /** Text-like types only (see `InputType`). Default `text`. */
136
+ type?: InputType;
137
+ /** Class for the control itself; the wrapper takes `wrapperClassName`. */
138
+ className?: string;
139
+ wrapperClassName?: string;
140
+ /** Marks the control invalid without an error message. */
141
+ invalid?: boolean;
142
+ } & react.RefAttributes<HTMLInputElement>>;
143
+
144
+ type SelectProps = SelectHTMLAttributes<HTMLSelectElement> & FieldChromeProps & {
145
+ /** Class for the control itself; the wrapper takes `wrapperClassName`. */
146
+ className?: string;
147
+ wrapperClassName?: string;
148
+ /** Marks the control invalid without an error message. */
149
+ invalid?: boolean;
150
+ };
151
+ /**
152
+ * Shared Select. Apps use this instead of a local Select. 5px radius, 12px
153
+ * horizontal padding, 44px control height, shell `--app-field-*` tokens.
154
+ */
155
+ declare const Select: react.ForwardRefExoticComponent<SelectHTMLAttributes<HTMLSelectElement> & FieldChromeProps & {
156
+ /** Class for the control itself; the wrapper takes `wrapperClassName`. */
157
+ className?: string;
158
+ wrapperClassName?: string;
159
+ /** Marks the control invalid without an error message. */
160
+ invalid?: boolean;
161
+ } & react.RefAttributes<HTMLSelectElement>>;
162
+
163
+ type TextareaProps = TextareaHTMLAttributes<HTMLTextAreaElement> & FieldChromeProps & {
164
+ /** Class for the control itself; the wrapper takes `wrapperClassName`. */
165
+ className?: string;
166
+ wrapperClassName?: string;
167
+ /** Marks the control invalid without an error message. */
168
+ invalid?: boolean;
169
+ };
170
+ /**
171
+ * Shared Textarea. Apps use this instead of a local Textarea. 5px radius, 12px
172
+ * horizontal padding, 88px minimum height, shell `--app-field-*` tokens.
173
+ */
174
+ declare const Textarea: react.ForwardRefExoticComponent<TextareaHTMLAttributes<HTMLTextAreaElement> & FieldChromeProps & {
175
+ /** Class for the control itself; the wrapper takes `wrapperClassName`. */
176
+ className?: string;
177
+ wrapperClassName?: string;
178
+ /** Marks the control invalid without an error message. */
179
+ invalid?: boolean;
180
+ } & react.RefAttributes<HTMLTextAreaElement>>;
181
+
182
+ type BreadcrumbItem = {
183
+ label: string;
184
+ href?: string;
185
+ };
186
+ type BreadcrumbBarProps = {
187
+ breadcrumbs?: BreadcrumbItem[];
188
+ actions?: ReactNode;
189
+ maxW?: string;
190
+ };
191
+
192
+ type HeaderTabBarItem = {
193
+ id: string;
194
+ label: string;
195
+ icon: ReactNode;
196
+ disabled?: boolean;
197
+ };
198
+ type HeaderTabBarProps = {
199
+ items: HeaderTabBarItem[];
200
+ activeId: string;
201
+ onChange: (id: string) => void;
202
+ className?: string;
203
+ ariaLabel?: string;
204
+ };
205
+ /**
206
+ * @deprecated Use `NavTabStrip` from `@the-portland-company/shell/native` —
207
+ * the ONE canonical page tab strip (underlined text tabs with a 2px underline
208
+ * in the mode color, Brand guideline "Tabs are an underlined strip").
209
+ * `HeaderTabBar` is icon-only and filled, cannot render link tabs, and needs
210
+ * Chakra. Warns in development.
211
+ */
212
+ declare function HeaderTabBar({ items, activeId, onChange, className, ariaLabel, }: HeaderTabBarProps): react_jsx_runtime.JSX.Element;
213
+
22
214
  /**
23
215
  * The six canonical top-bar action slots (Reference/Global-Rules v9 → top-bar
24
216
  * icons). Each slot's GLYPH is unique and comes from the Brand API
@@ -422,6 +614,15 @@ declare function useThemePreference(): {
422
614
  setValue: (next: ThemePreference) => void;
423
615
  };
424
616
 
617
+ /** Page header for apps with no react-router: breadcrumbs render as plain anchors. */
618
+ declare function PageHeader(props: PageHeaderProps): react_jsx_runtime.JSX.Element;
619
+
620
+ /**
621
+ * @deprecated Not for app use: the breadcrumb trail is retired. Kept for parity
622
+ * with the main entry; breadcrumb links render as plain anchors.
623
+ */
624
+ declare function BreadcrumbBar(props: BreadcrumbBarProps): react_jsx_runtime.JSX.Element;
625
+
425
626
  /**
426
627
  * Icon slots used by the standard menus. The shell stays icon-library-agnostic:
427
628
  * callers map each key to their own icon components (lucide, react-icons, …).
@@ -1059,4 +1260,4 @@ type NavAppShellProps = {
1059
1260
  };
1060
1261
  declare function NavAppShell({ sidebar, topBar, betaBanner, contentWrapper, accountMenuPlacement, modeId, children, }: NavAppShellProps): react_jsx_runtime.JSX.Element;
1061
1262
 
1062
- 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 };
1263
+ export { type CreditTypeKey as $, type NavDisplayMode as A, type BreadcrumbBarProps as B, Card as C, BETA_BANNER_DISMISS_KEY as D, BreadcrumbBar as E, FormColumn as F, CAMPAIGN_FEATURE_AVAILABILITY as G, HeaderTabBar as H, Input as I, CORE_APP_ORIGIN as J, CORE_BILLING_PATH as K, CREDIT_TYPE_LABELS as L, CREDIT_TYPE_ORDER as M, type NavItem as N, type CampaignFeatureAvailability as O, type PageHeaderProps as P, type ChromeMe as Q, type ChromeNotificationAlert as R, Select as S, Textarea as T, type ChromeNotificationImport as U, type ChromeNotificationQuarantine as V, type ChromeNotificationReply as W, type ChromeNotificationsPayload as X, type ChromeOrgSummary as Y, type CommunicationsFuelStatus as Z, type CreditHealthState as _, Button as a, CreditsAction as a0, type CreditsIconState as a1, FuelAction as a2, type FuelChannelStatus as a3, NavAppShell as a4, type NavAppShellProps as a5, NavBetaBanner as a6, type NavBetaBannerProps as a7, type NavBrand as a8, NavChromeProvider as a9, TopBarPanelArrow as aA, TopBarPopover as aB, TopBarTooltip as aC, TopBarWidgetSlot as aD, clearBetaBannerDismissal as aE, creditGaugeRatio as aF, creditStateWord as aG, creditTooltipLine as aH, creditsAriaLabel as aI, creditsIconState as aJ, envChipClasses as aK, isNavItemActive as aL, modeIdFromLabel as aM, resolveOrgLogoUrl as aN, shortEnvLabel as aO, shortUserName as aP, standardPolitogyNav as aQ, topBarIconButtonClass as aR, useChromeMe as aS, useChromeOrgs as aT, useNavChromeDedupedFetch as aU, useNavChromeFetcher as aV, useThemePreference as aW, NavDisplayAction as aa, type NavLinkProps as ab, type NavLinkedAccount as ac, type NavModeOption as ad, type NavOrg as ae, type NavRoleBadge as af, NavSidebar as ag, type NavSidebarProps as ah, type NavTab as ai, NavTabStrip as aj, type NavTabStripProps as ak, NavThemeControl as al, NavTopBar as am, type NavTopBarAction as an, type NavTopBarProps as ao, type NavUser as ap, NotificationsAction as aq, PageHeader as ar, type PageHeaderMode as as, SPECS_ORIGIN as at, SpecOverlayAction as au, type StandardNavOptions as av, SupportAction as aw, type ThemePreference as ax, TopBarCountBadge as ay, type TopBarIconTone as az, type ButtonProps as b, type ButtonSize as c, type ButtonVariant as d, type CommsNotification as e, type CommsNotificationKind as f, type HeaderTabBarItem as g, type InputProps as h, type NotificationsAdapter as i, type NotificationsFeed as j, type SelectProps as k, type TextareaProps as l, createCommsNotificationsAdapter as m, emptyNotificationsFeed as n, normalizeNotificationsFeed as o, type StandardNavIconKey as p, type NavIcon as q, type NavBreadcrumb as r, type StandardNavMode as s, type NavLinkComponent as t, type NavChromeFetcher as u, type NavMode as v, type NavUserMenu as w, type NavOrgOption as x, type NavFooterLink as y, type NavFooter as z };
@@ -1,7 +1,18 @@
1
1
  import * as react_jsx_runtime from 'react/jsx-runtime';
2
- import { ReactNode, ComponentType, CSSProperties } from 'react';
2
+ import * as react from 'react';
3
+ import { ReactNode, CSSProperties, ButtonHTMLAttributes, AnchorHTMLAttributes, ElementType, InputHTMLAttributes, SelectHTMLAttributes, TextareaHTMLAttributes, ComponentType } from 'react';
3
4
  import { ThemePreference as ThemePreference$1 } from './theme-preference.cjs';
4
5
 
6
+ type CardProps = {
7
+ title?: string;
8
+ children: ReactNode;
9
+ minH?: string | number;
10
+ className?: string;
11
+ style?: CSSProperties;
12
+ [key: string]: unknown;
13
+ };
14
+ declare function Card({ title, children, minH, className, style, ...props }: CardProps): react_jsx_runtime.JSX.Element;
15
+
5
16
  type FormColumnProps = {
6
17
  children: ReactNode;
7
18
  className?: string;
@@ -19,6 +30,187 @@ type FormColumnProps = {
19
30
  */
20
31
  declare function FormColumn({ children, className }: FormColumnProps): react_jsx_runtime.JSX.Element;
21
32
 
33
+ type BreadcrumbItem$1 = {
34
+ label: string;
35
+ href?: string;
36
+ };
37
+ /** The three Modes a page header's eyebrow can announce (Reference/UI-Platform
38
+ * → "Per-mode branding"). */
39
+ type PageHeaderMode = 'relationship' | 'campaign' | 'petition';
40
+ type PageHeaderProps = {
41
+ title?: ReactNode;
42
+ /**
43
+ * The operating Mode this page belongs to. When set, the 11px uppercase
44
+ * mode eyebrow ("Relationship mode" / "Campaign mode" / "Petition mode")
45
+ * renders above the title by DEFAULT — Reference/UI-Platform → "Page
46
+ * header": "Left: an 11px uppercase mode eyebrow ... in the mode color
47
+ * (`modes.<mode>.primary`)". Pass `showEyebrow={false}` to suppress it.
48
+ */
49
+ mode?: PageHeaderMode;
50
+ /** Overrides the eyebrow text the `mode` default would produce. */
51
+ eyebrow?: string;
52
+ /** Set false to suppress the eyebrow even when `mode` is passed. Default true. */
53
+ showEyebrow?: boolean;
54
+ /** Optional one-line subtitle, 15px G4, directly under the title. */
55
+ subtitle?: ReactNode;
56
+ breadcrumbs?: BreadcrumbItem$1[];
57
+ actions?: ReactNode;
58
+ tabBar?: ReactNode;
59
+ maxW?: string;
60
+ hideSidebar?: boolean;
61
+ };
62
+
63
+ type ButtonVariant = 'primary' | 'secondary' | 'ghost' | 'danger';
64
+ type ButtonSize = 'md' | 'sm';
65
+ type ButtonProps = Omit<ButtonHTMLAttributes<HTMLButtonElement>, 'type'> & Omit<AnchorHTMLAttributes<HTMLAnchorElement>, 'type'> & {
66
+ /** Visual style. Default `primary`. */
67
+ variant?: ButtonVariant;
68
+ /** `md` is 44px tall (default), `sm` is 36px. */
69
+ size?: ButtonSize;
70
+ /** Shows a spinner, sets `aria-busy`, and blocks interaction. */
71
+ loading?: boolean;
72
+ disabled?: boolean;
73
+ /** Renders a link-button. Without `as`, `href` renders an `<a>`. */
74
+ href?: string;
75
+ /** Element or component to render as (e.g. a router `Link`). */
76
+ as?: ElementType;
77
+ type?: 'button' | 'submit' | 'reset';
78
+ children?: ReactNode;
79
+ className?: string;
80
+ /** Extra props for the rendered element (e.g. a router Link's `to`). */
81
+ to?: string;
82
+ };
83
+ /**
84
+ * The shared button. Apps use this instead of a local Button. 5px radius, 12px
85
+ * horizontal padding; primary uses the shell's `--app-btn-primary-*` tokens
86
+ * (Specs buttonPrimary). Pass `href` (or `as`) for a link-button.
87
+ */
88
+ declare const Button: react.ForwardRefExoticComponent<Omit<ButtonHTMLAttributes<HTMLButtonElement>, "type"> & Omit<AnchorHTMLAttributes<HTMLAnchorElement>, "type"> & {
89
+ /** Visual style. Default `primary`. */
90
+ variant?: ButtonVariant;
91
+ /** `md` is 44px tall (default), `sm` is 36px. */
92
+ size?: ButtonSize;
93
+ /** Shows a spinner, sets `aria-busy`, and blocks interaction. */
94
+ loading?: boolean;
95
+ disabled?: boolean;
96
+ /** Renders a link-button. Without `as`, `href` renders an `<a>`. */
97
+ href?: string;
98
+ /** Element or component to render as (e.g. a router `Link`). */
99
+ as?: ElementType;
100
+ type?: "button" | "submit" | "reset";
101
+ children?: ReactNode;
102
+ className?: string;
103
+ /** Extra props for the rendered element (e.g. a router Link's `to`). */
104
+ to?: string;
105
+ } & react.RefAttributes<HTMLElement>>;
106
+
107
+ type FieldChromeProps = {
108
+ /** Visible label rendered above the control. */
109
+ label?: ReactNode;
110
+ /** Helper text under the control; replaced by `error` when one is set. */
111
+ helperText?: ReactNode;
112
+ /** Error message. Truthy marks the control invalid (aria-invalid). */
113
+ error?: ReactNode;
114
+ };
115
+
116
+ /**
117
+ * Text-like input types the field styling supports. Checkbox, radio, range,
118
+ * file and color need their own native layout and are not supported here.
119
+ */
120
+ type InputType = 'text' | 'email' | 'password' | 'search' | 'tel' | 'url' | 'number' | 'date' | 'time' | 'datetime-local' | 'month' | 'week';
121
+ type InputProps = Omit<InputHTMLAttributes<HTMLInputElement>, 'type'> & FieldChromeProps & {
122
+ /** Text-like types only (see `InputType`). Default `text`. */
123
+ type?: InputType;
124
+ /** Class for the control itself; the wrapper takes `wrapperClassName`. */
125
+ className?: string;
126
+ wrapperClassName?: string;
127
+ /** Marks the control invalid without an error message. */
128
+ invalid?: boolean;
129
+ };
130
+ /**
131
+ * Shared Input. Apps use this instead of a local Input. 5px radius, 12px
132
+ * horizontal padding, 44px control height, shell `--app-field-*` tokens.
133
+ */
134
+ declare const Input: react.ForwardRefExoticComponent<Omit<InputHTMLAttributes<HTMLInputElement>, "type"> & FieldChromeProps & {
135
+ /** Text-like types only (see `InputType`). Default `text`. */
136
+ type?: InputType;
137
+ /** Class for the control itself; the wrapper takes `wrapperClassName`. */
138
+ className?: string;
139
+ wrapperClassName?: string;
140
+ /** Marks the control invalid without an error message. */
141
+ invalid?: boolean;
142
+ } & react.RefAttributes<HTMLInputElement>>;
143
+
144
+ type SelectProps = SelectHTMLAttributes<HTMLSelectElement> & FieldChromeProps & {
145
+ /** Class for the control itself; the wrapper takes `wrapperClassName`. */
146
+ className?: string;
147
+ wrapperClassName?: string;
148
+ /** Marks the control invalid without an error message. */
149
+ invalid?: boolean;
150
+ };
151
+ /**
152
+ * Shared Select. Apps use this instead of a local Select. 5px radius, 12px
153
+ * horizontal padding, 44px control height, shell `--app-field-*` tokens.
154
+ */
155
+ declare const Select: react.ForwardRefExoticComponent<SelectHTMLAttributes<HTMLSelectElement> & FieldChromeProps & {
156
+ /** Class for the control itself; the wrapper takes `wrapperClassName`. */
157
+ className?: string;
158
+ wrapperClassName?: string;
159
+ /** Marks the control invalid without an error message. */
160
+ invalid?: boolean;
161
+ } & react.RefAttributes<HTMLSelectElement>>;
162
+
163
+ type TextareaProps = TextareaHTMLAttributes<HTMLTextAreaElement> & FieldChromeProps & {
164
+ /** Class for the control itself; the wrapper takes `wrapperClassName`. */
165
+ className?: string;
166
+ wrapperClassName?: string;
167
+ /** Marks the control invalid without an error message. */
168
+ invalid?: boolean;
169
+ };
170
+ /**
171
+ * Shared Textarea. Apps use this instead of a local Textarea. 5px radius, 12px
172
+ * horizontal padding, 88px minimum height, shell `--app-field-*` tokens.
173
+ */
174
+ declare const Textarea: react.ForwardRefExoticComponent<TextareaHTMLAttributes<HTMLTextAreaElement> & FieldChromeProps & {
175
+ /** Class for the control itself; the wrapper takes `wrapperClassName`. */
176
+ className?: string;
177
+ wrapperClassName?: string;
178
+ /** Marks the control invalid without an error message. */
179
+ invalid?: boolean;
180
+ } & react.RefAttributes<HTMLTextAreaElement>>;
181
+
182
+ type BreadcrumbItem = {
183
+ label: string;
184
+ href?: string;
185
+ };
186
+ type BreadcrumbBarProps = {
187
+ breadcrumbs?: BreadcrumbItem[];
188
+ actions?: ReactNode;
189
+ maxW?: string;
190
+ };
191
+
192
+ type HeaderTabBarItem = {
193
+ id: string;
194
+ label: string;
195
+ icon: ReactNode;
196
+ disabled?: boolean;
197
+ };
198
+ type HeaderTabBarProps = {
199
+ items: HeaderTabBarItem[];
200
+ activeId: string;
201
+ onChange: (id: string) => void;
202
+ className?: string;
203
+ ariaLabel?: string;
204
+ };
205
+ /**
206
+ * @deprecated Use `NavTabStrip` from `@the-portland-company/shell/native` —
207
+ * the ONE canonical page tab strip (underlined text tabs with a 2px underline
208
+ * in the mode color, Brand guideline "Tabs are an underlined strip").
209
+ * `HeaderTabBar` is icon-only and filled, cannot render link tabs, and needs
210
+ * Chakra. Warns in development.
211
+ */
212
+ declare function HeaderTabBar({ items, activeId, onChange, className, ariaLabel, }: HeaderTabBarProps): react_jsx_runtime.JSX.Element;
213
+
22
214
  /**
23
215
  * The six canonical top-bar action slots (Reference/Global-Rules v9 → top-bar
24
216
  * icons). Each slot's GLYPH is unique and comes from the Brand API
@@ -422,6 +614,15 @@ declare function useThemePreference(): {
422
614
  setValue: (next: ThemePreference) => void;
423
615
  };
424
616
 
617
+ /** Page header for apps with no react-router: breadcrumbs render as plain anchors. */
618
+ declare function PageHeader(props: PageHeaderProps): react_jsx_runtime.JSX.Element;
619
+
620
+ /**
621
+ * @deprecated Not for app use: the breadcrumb trail is retired. Kept for parity
622
+ * with the main entry; breadcrumb links render as plain anchors.
623
+ */
624
+ declare function BreadcrumbBar(props: BreadcrumbBarProps): react_jsx_runtime.JSX.Element;
625
+
425
626
  /**
426
627
  * Icon slots used by the standard menus. The shell stays icon-library-agnostic:
427
628
  * callers map each key to their own icon components (lucide, react-icons, …).
@@ -1059,4 +1260,4 @@ type NavAppShellProps = {
1059
1260
  };
1060
1261
  declare function NavAppShell({ sidebar, topBar, betaBanner, contentWrapper, accountMenuPlacement, modeId, children, }: NavAppShellProps): react_jsx_runtime.JSX.Element;
1061
1262
 
1062
- 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 };
1263
+ export { type CreditTypeKey as $, type NavDisplayMode as A, type BreadcrumbBarProps as B, Card as C, BETA_BANNER_DISMISS_KEY as D, BreadcrumbBar as E, FormColumn as F, CAMPAIGN_FEATURE_AVAILABILITY as G, HeaderTabBar as H, Input as I, CORE_APP_ORIGIN as J, CORE_BILLING_PATH as K, CREDIT_TYPE_LABELS as L, CREDIT_TYPE_ORDER as M, type NavItem as N, type CampaignFeatureAvailability as O, type PageHeaderProps as P, type ChromeMe as Q, type ChromeNotificationAlert as R, Select as S, Textarea as T, type ChromeNotificationImport as U, type ChromeNotificationQuarantine as V, type ChromeNotificationReply as W, type ChromeNotificationsPayload as X, type ChromeOrgSummary as Y, type CommunicationsFuelStatus as Z, type CreditHealthState as _, Button as a, CreditsAction as a0, type CreditsIconState as a1, FuelAction as a2, type FuelChannelStatus as a3, NavAppShell as a4, type NavAppShellProps as a5, NavBetaBanner as a6, type NavBetaBannerProps as a7, type NavBrand as a8, NavChromeProvider as a9, TopBarPanelArrow as aA, TopBarPopover as aB, TopBarTooltip as aC, TopBarWidgetSlot as aD, clearBetaBannerDismissal as aE, creditGaugeRatio as aF, creditStateWord as aG, creditTooltipLine as aH, creditsAriaLabel as aI, creditsIconState as aJ, envChipClasses as aK, isNavItemActive as aL, modeIdFromLabel as aM, resolveOrgLogoUrl as aN, shortEnvLabel as aO, shortUserName as aP, standardPolitogyNav as aQ, topBarIconButtonClass as aR, useChromeMe as aS, useChromeOrgs as aT, useNavChromeDedupedFetch as aU, useNavChromeFetcher as aV, useThemePreference as aW, NavDisplayAction as aa, type NavLinkProps as ab, type NavLinkedAccount as ac, type NavModeOption as ad, type NavOrg as ae, type NavRoleBadge as af, NavSidebar as ag, type NavSidebarProps as ah, type NavTab as ai, NavTabStrip as aj, type NavTabStripProps as ak, NavThemeControl as al, NavTopBar as am, type NavTopBarAction as an, type NavTopBarProps as ao, type NavUser as ap, NotificationsAction as aq, PageHeader as ar, type PageHeaderMode as as, SPECS_ORIGIN as at, SpecOverlayAction as au, type StandardNavOptions as av, SupportAction as aw, type ThemePreference as ax, TopBarCountBadge as ay, type TopBarIconTone as az, type ButtonProps as b, type ButtonSize as c, type ButtonVariant as d, type CommsNotification as e, type CommsNotificationKind as f, type HeaderTabBarItem as g, type InputProps as h, type NotificationsAdapter as i, type NotificationsFeed as j, type SelectProps as k, type TextareaProps as l, createCommsNotificationsAdapter as m, emptyNotificationsFeed as n, normalizeNotificationsFeed as o, type StandardNavIconKey as p, type NavIcon as q, type NavBreadcrumb as r, type StandardNavMode as s, type NavLinkComponent as t, type NavChromeFetcher as u, type NavMode as v, type NavUserMenu as w, type NavOrgOption as x, type NavFooterLink as y, type NavFooter as z };