@pantheon-systems/pds-toolkit-react 2.0.0-alpha.85 → 2.0.0-alpha.87

package/codemods/v1-to-v2/mappings.json

@@ -260,7 +260,7 @@
 				"component": "Icon",
 				"from": "iconSize",
 				"to": "size",
-				"reason": "The iconSize prop has been renamed to size for consistency across V2 icon components. The default ('l') is unchanged, but the 'xs' (10px) value has been removed (see props.typeChanges) — use 's' instead."
+				"reason": "The iconSize prop has been renamed to size for consistency across V2 icon components. The size scale has since been redesigned (see props.typeChanges) — the current default is 'xl' (20px), not v1's default 'l'/20px directly, since every step was renumbered along the way. Net effect for a v1 consumer migrating straight to the current scale: the rendered default size is unchanged (20px), only its name changed."
 			},
 			{
 				"component": "CloseButton",
@@ -272,7 +272,7 @@
 				"component": "PlatformIcon",
 				"from": "iconSize",
 				"to": "size",
-				"reason": "The iconSize prop has been renamed to size for consistency with V2 component conventions. Size values have also changed to align with the Icon component scale — 'xs', 's', 'm', 'l', 'xl', '2xl', '3xl' — replacing the previous 1.2× ratio scale. The pixel sizes for 'l', 'xl', and '2xl' are different: l is now 1.25rem (was 1.2rem), xl is 1.5rem (was 1.44rem), 2xl is 2rem (was 1.728rem)."
+				"reason": "The iconSize prop has been renamed to size for consistency with V2 component conventions. Size values have also changed to align with the Icon component's scale at the time — 'xs', 's', 'm', 'l', 'xl', '2xl', '3xl' — replacing the previous 1.2× ratio scale. The pixel sizes for 'l', 'xl', and '2xl' are different: l is now 1.25rem (was 1.2rem), xl is 1.5rem (was 1.44rem), 2xl is 2rem (was 1.728rem). Note: Icon's own scale has since been redesigned again (see Icon's props.typeChanges) and PlatformIcon was not updated to match — PlatformIcon keeps this xs/s/m/l/xl/2xl/3xl (10-40px) scale, independently of Icon's current one."
 			},
 			{
 				"component": "FileDiff",
@@ -625,6 +625,18 @@
 				"prop": "defaultPresetLabel",
 				"description": "New optional prop naming which presets entry (by its own label) starts out active. The named preset renders pressed in the list, its computed range seeds the selection so the calendar opens on it, and the trigger renders as a real selection rather than muted placeholder text. onChange is deliberately not called for this initial value. Mount-only, like defaultValue on an HTML input, and a no-op (development warning only) when the label matches no entry.",
 				"usage": "Set defaultPresetLabel to one of your presets' labels when the surface's underlying query already has a default window (e.g. a log viewer defaulting to the last 15 minutes), so the trigger reports what is actually on screen. Read your own initial state from the same constant you pass here rather than waiting for onChange. Requires presets and mode='range'."
+			},
+			{
+				"component": "Datepicker",
+				"prop": "hourCycle",
+				"description": "New optional prop setting the hour format of the showTime field(s), forwarded to each embedded Timepicker. Defaults to 12 (hour + AM/PM, e.g. \"12:30 PM\"); 24 renders a 24-hour segment with no AM/PM (e.g. \"13:30\"). Existing pickers are unchanged.",
+				"usage": "Set hourCycle={24} on a surface whose other timestamps are already 24-hour, such as a log viewer. It cannot be reached through locale — the embedded fields always receive an explicit hourCycle, which overrides locale-derived formatting."
+			},
+			{
+				"component": "Datepicker",
+				"prop": "showTodayButton",
+				"description": "New opt-out prop for the calendar footer's \"Today\" button. Defaults to true, so existing footers are unchanged; false leaves just the end-aligned buttons — Clear, plus Done when mode is \"range\" or showTime is set.",
+				"usage": "Set showTodayButton={false} where jumping to today is meaningless or redundant — e.g. a range picker whose presets already cover the current window. Blanking translationStrings.todayButton only empties the label, leaving the button in place."
 			}
 		],
 		"removals": [
@@ -866,7 +878,7 @@
 				"v1Default": "'sm'",
 				"v2Default": "'m'",
 				"reason": "Default trigger icon size changed from 'sm' to 'm' to align with new standardized size naming and provide better default visibility.",
-				"migration": "If you relied on the default trigger icon size being small, explicitly pass triggerIconSize='s' to maintain the v1 appearance."
+				"migration": "If you relied on the default trigger icon size being small, explicitly pass triggerIconSize='xs' to maintain the v1 appearance (the Icon size scale has since been redesigned — 'xs' is the current name for that same 12px size, not 's', which now means 14px)."
 			},
 			{
 				"component": "ComparisonList",
@@ -897,13 +909,18 @@
 			{
 				"component": "Icon",
 				"prop": "size",
-				"description": "The 'xs' size value has been removed",
-				"v1Type": "'xs' | 's' | 'm' | 'l' | 'xl' | '2xl' | '3xl'",
-				"v2Type": "'s' | 'm' | 'l' | 'xl' | '2xl' | '3xl'",
+				"description": "Size scale redesigned twice since v1 — first the 10px 'xs' was dropped (early V2), then the whole scale was later redone to align with the typography scale, reintroducing an 'xs' step at a different (12px) value. This entry describes the net v1 → current-V2 delta.",
+				"v1Type": "'xs' (10px) | 's' (12px) | 'm' (16px) | 'l' (20px) | 'xl' (24px) | '2xl' (32px) | '3xl' (40px)",
+				"v2Type": "'xs' (12px) | 's' (14px) | 'm' (16px) | 'l' (18px) | 'xl' (20px) | '2xl' (24px) | '3xl' (28px) | '4xl' (32px)",
 				"migration": {
-					"xs": "s (removed, use 's' instead)"
+					"xs": "xs (v1's 10px 'xs' was removed at the initial V2 release, with 's'/12px as the recommended substitute at the time; that same 12px slot is now named 'xs' again — use size='xs' for the closest available match)",
+					"s": "xs (same 12px value, renamed)",
+					"l": "xl (same 20px value, renamed)",
+					"xl": "2xl (same 24px value, renamed)",
+					"2xl": "4xl (same 32px value, renamed)",
+					"3xl": "removed, no replacement (40px step retired; nearest available is '4xl' at 32px)"
 				},
-				"reason": "The 10px 'xs' icon size has been removed in v2. It had a single internal usage (the TagsInput remove button, now 's'/12px) and is superseded by 's'. Use size='s' instead."
+				"reason": "V1's 10px 'xs' was removed at the initial V2 release (superseded by 's', then 12px). V2's scale was later redesigned to align with the typography scale: every remaining name shifted up one step to keep its pixel value, three new in-between sizes were added ('s' 14px, 'l' 18px, '3xl' 28px), 'xs' was reintroduced at 12px (unrelated to v1's 10px 'xs'), and the old 40px '3xl' step was retired with no replacement."
 			},
 			{
 				"component": "FlexContainer",
@@ -1139,15 +1156,15 @@
 			{
 				"component": "Tooltip",
 				"prop": "triggerIconSize",
-				"description": "Size naming convention updated to match standardized naming",
+				"description": "Size naming convention updated to match standardized naming, then later widened to accept the full redesigned Icon size scale.",
 				"v1Type": "'sm' | 'md' | 'lg'",
-				"v2Type": "'s' | 'm' | 'l'",
+				"v2Type": "IconSize ('xs' | 's' | 'm' | 'l' | 'xl' | '2xl' | '3xl' | '4xl')",
 				"migration": {
-					"sm": "s",
-					"md": "m",
-					"lg": "l"
+					"sm": "xs (same 12px value — was briefly 's' under the initial V2 scale, since renamed)",
+					"md": "m (unchanged, 16px)",
+					"lg": "xl (same 20px value — was briefly 'l' under the initial V2 scale, since renamed)"
 				},
-				"reason": "Standardized size naming across all components. The 'sm', 'md', and 'lg' values have been shortened to 's', 'm', and 'l' for consistency."
+				"reason": "Standardized size naming across all components at the initial V2 release ('sm'/'md'/'lg' → 's'/'m'/'l'), then the prop's type was widened to the full Icon size scale once that scale was redesigned to align with typography sizes — every retained value keeps its pixel size but was renamed again in the process (see Icon's props.typeChanges for the full picture)."
 			},
 			{
 				"component": "Badge",

package/dist/components/Popover/Popover.d.ts

@@ -1,5 +1,5 @@
 import { ComponentPropsWithoutRef, ReactNode } from 'react';
-import { FuiPlacement } from '../../libs/types/custom-types';
+import { FuiPlacement, IconSize } from '../../libs/types/custom-types';
 import './popover.css';
 export interface PopoverProps extends Omit<ComponentPropsWithoutRef<'div'>, 'content'> {
     /**
@@ -61,7 +61,7 @@ export interface PopoverProps extends Omit<ComponentPropsWithoutRef<'div'>, 'con
     /**
      * Size of the trigger icon. Uses PDS Icon sizing.
      */
-    triggerIconSize?: 's' | 'm' | 'l';
+    triggerIconSize?: IconSize;
 }
 /**
  * Popover UI component

package/dist/components/StatusScrim/StatusScrim.d.ts

@@ -0,0 +1,22 @@
+import { ComponentPropsWithoutRef } from 'react';
+import './status-scrim.css';
+export type StatusScrimStatus = 'frozen' | 'restricted';
+export interface StatusScrimProps extends ComponentPropsWithoutRef<'div'> {
+    /**
+     * Additional class names
+     */
+    className?: string;
+    /**
+     * Label text. Defaults to 'Frozen' / 'Restricted' based on status; override
+     * for translation.
+     */
+    label?: string;
+    /**
+     * Which status the scrim represents. Sets the icon and default label.
+     */
+    status: StatusScrimStatus;
+}
+/**
+ * StatusScrim UI component
+ */
+export declare const StatusScrim: ({ className, label, status, ...props }: StatusScrimProps) => import("react/jsx-runtime").JSX.Element;

package/dist/components/Table/Table.d.ts

@@ -47,8 +47,24 @@ export interface TableColumn {
      * `hasMobileDetailSheet`). Has no effect above the mobile breakpoint.
      */
     cardVisible?: boolean;
+    /**
+     * Additional class name applied to this column's body `<td>` cells
+     * (including loading-state skeleton cells). Use for column-specific
+     * styling — width, `white-space: nowrap`, padding — that can't be
+     * expressed by a prop, without reaching into the table's rendered
+     * markup from outside with `:nth-child` selectors. Has no effect on
+     * mobile cards.
+     */
+    cellClassName?: string;
     /** Content to display in the header cell. */
     header: ReactNode;
+    /**
+     * Additional class name applied to this column's `<th>` header cell.
+     * See `cellClassName` for the equivalent on body cells — a column
+     * needing the same styling in both (e.g. a shared width, for
+     * alignment) should pass the same class to both props.
+     */
+    headerClassName?: string;
     /** Stable identifier used for rendering cell content from rowData. */
     id: string;
     /** When true, renders a sort button next to the header label. */
@@ -85,6 +101,11 @@ export interface TableProps extends ComponentPropsWithoutRef<'table'> {
      * Only applies in uncontrolled sort mode.
      */
     defaultSortOrder?: SortOrder;
+    /**
+     * Cell padding density. `'compact'` reduces padding for denser data
+     * tables. Has no effect on mobile cards (see `hasMobileCards`).
+     */
+    density?: 'standard' | 'compact';
     /**
      * When `true` (default), renders built-in prev/next navigation buttons in
      * the detail panel footer. Set to `false` to hide the footer entirely.
@@ -211,6 +232,14 @@ export interface TableProps extends ComponentPropsWithoutRef<'table'> {
      * a sheet and keeps calling `onRowInspect` directly, matching desktop.
      */
     hasMobileDetailSheet?: boolean;
+    /**
+     * When true, renders the table inside a Panel with no padding. Automatically
+     * applies first-column spacing and removes the last row's bottom border so
+     * it doesn't double up against the footer border. Has no effect at the
+     * mobile breakpoint (see `hasMobileCards`) — cards sit flush against the
+     * page background instead of inside a Panel.
+     */
+    hasPanel?: boolean;
     /**
      * ID of the currently inspected row. When provided, that row receives a
      * highlighted background. Use the same ID space as `getRowId`. Only
@@ -314,14 +343,6 @@ export interface TableProps extends ComponentPropsWithoutRef<'table'> {
      * English defaults are used. Override for translation.
      */
     paginationLabels?: PaginationCompactProps['labelStrings'];
-    /**
-     * When true, renders the table inside a Panel with no padding. Automatically
-     * applies first-column spacing and removes the last row's bottom border so
-     * it doesn't double up against the footer border. Has no effect at the
-     * mobile breakpoint (see `hasMobileCards`) — cards sit flush against the
-     * page background instead of inside a Panel.
-     */
-    panel?: boolean;
     /**
      * Accessible label for the detail panel "previous row" button.
      * Defaults to `'Previous row'`. Override for translation.
@@ -372,4 +393,4 @@ export interface TableProps extends ComponentPropsWithoutRef<'table'> {
      */
     totalItemCount?: number;
 }
-export declare const Table: ({ className, closeDetailPanelLabel, columns, currentPage, defaultSortKey, defaultSortOrder, detailPanelNav, detailPanelTitle, detailPanelWidth, emptyState, emptyStateHeading, emptyStateMessage, footer, getDetailPanelPositionLabel, getPageSizeLabel, getRowClassName, getRowId, getRowSelectDisabledReason, getSelectRowLabel, getSortLabel, hasDesktopDetailPanel, hasMobileCards, hasMobileDetailSheet, inspectedRowId, isLoading, isRowSelectable, itemsPerPage, loadingRowCount, maxHeight, minHeight, nextDetailPanelRowLabel, onDetailPanelNext, onDetailPanelPrev, onPageChange, onPageSizeChange, onRowInspect, onRowSelectionChange, onSort, pageSizeOptions, pageSizeSelectLabel, paginationLabels, panel, prevDetailPanelRowLabel, renderDetailPanel, renderDetailPanelFooter, rowData, selectAllLabel, selectedRows, sortKey, sortOrder, totalItemCount, ...props }: TableProps) => import("react/jsx-runtime").JSX.Element;
+export declare const Table: ({ className, closeDetailPanelLabel, columns, currentPage, defaultSortKey, defaultSortOrder, density, detailPanelNav, detailPanelTitle, detailPanelWidth, emptyState, emptyStateHeading, emptyStateMessage, footer, getDetailPanelPositionLabel, getPageSizeLabel, getRowClassName, getRowId, getRowSelectDisabledReason, getSelectRowLabel, getSortLabel, hasDesktopDetailPanel, hasMobileCards, hasMobileDetailSheet, hasPanel, inspectedRowId, isLoading, isRowSelectable, itemsPerPage, loadingRowCount, maxHeight, minHeight, nextDetailPanelRowLabel, onDetailPanelNext, onDetailPanelPrev, onPageChange, onPageSizeChange, onRowInspect, onRowSelectionChange, onSort, pageSizeOptions, pageSizeSelectLabel, paginationLabels, prevDetailPanelRowLabel, renderDetailPanel, renderDetailPanelFooter, rowData, selectAllLabel, selectedRows, sortKey, sortOrder, totalItemCount, ...props }: TableProps) => import("react/jsx-runtime").JSX.Element;

package/dist/components/Tooltip/Tooltip.d.ts

@@ -1,6 +1,6 @@
 import { ComponentPropsWithoutRef, ReactNode } from 'react';
 import { Placement } from '@floating-ui/react';
-import { FuiOffset } from '../../libs/types/custom-types';
+import { FuiOffset, IconSize } from '../../libs/types/custom-types';
 import './tooltip.css';
 interface TooltipProps extends ComponentPropsWithoutRef<'div'> {
     /**
@@ -49,7 +49,7 @@ interface TooltipProps extends ComponentPropsWithoutRef<'div'> {
     /**
      * Size of the trigger icon. Uses PDS Icon sizing.
      */
-    triggerIconSize?: 's' | 'm' | 'l';
+    triggerIconSize?: IconSize;
     /**
      * Z-index value for the tooltip container. In most cases, the default value should be retained.
      */

package/dist/components/buttons/MenuButton/MenuButton.d.ts

@@ -1,4 +1,5 @@
-import { ComponentPropsWithRef, ReactNode } from 'react';
+import { ComponentPropsWithRef, ReactNode, RefObject } from 'react';
+import { type Placement } from '@floating-ui/react';
 import { StatusDotType } from '../../../libs/components/StatusDot/StatusDot';
 import { ButtonVariant, HeadingItemType, LinkItemType, MenuItemType, NodeItemType, SeparatorItemType } from '../../../libs/types/custom-types';
 import { TallyProps } from '../../badges/Tally/Tally';
@@ -65,6 +66,21 @@ export interface MenuButtonProps extends ComponentPropsWithRef<'span'> {
      * default (which can otherwise leave focus on an ancestor panel).
      */
     onOpenChange?: (isOpen: boolean) => void;
+    /**
+     * Preferred placement of the dropdown panel relative to its anchor.
+     * Defaults to `bottom-start` (current behavior). `SplitButton` passes
+     * this through unchanged — see its own `placement` prop.
+     */
+    placement?: Placement;
+    /**
+     * Ref to an ancestor element that Floating UI should use as the
+     * *position* reference (while the trigger button remains the
+     * *interaction* reference for click/keyboard). Set internally by
+     * `SplitButton` when `isSplitButton` is true, so the panel anchors to
+     * the whole split-button control instead of just the caret half. Not
+     * intended for direct use outside `SplitButton`.
+     */
+    positionReferenceRef?: RefObject<HTMLElement | null>;
     /**
      * Which size of button to render.
      */

package/dist/components/buttons/SplitButton/SplitButton.d.ts

@@ -1,4 +1,5 @@
 import { ComponentPropsWithoutRef } from 'react';
+import type { Placement } from '@floating-ui/react';
 import { ButtonVariant, LinkItemType, MenuItemType } from '../../../libs/types/custom-types';
 import { PDSIcon } from '../../icons/Icon/Icon';
 import './split-button.css';
@@ -11,6 +12,16 @@ interface SplitButtonProps extends ComponentPropsWithoutRef<'span'> {
      * Array of menu items
      */
     actionItems: Array<LinkItemType | MenuItemType>;
+    /**
+     * Anchor the actions menu panel to the whole button (primary action +
+     * caret combined) instead of just the caret trigger. Defaults to
+     * `false` — the panel positions relative to the caret alone, matching
+     * current behavior. Set this when `placement` needs to align the panel
+     * with an edge of the whole control (e.g. `bottom-start` under the
+     * primary action's left edge, for a table row action) rather than just
+     * the caret's narrow width.
+     */
+    anchorToFullButton?: boolean;
     /**
      * Additional class names
      */
@@ -32,6 +43,14 @@ interface SplitButtonProps extends ComponentPropsWithoutRef<'span'> {
      * Label for the buttons additional actions menu.
      */
     moreActionsLabel?: string;
+    /**
+     * Preferred placement of the actions menu panel. Defaults to
+     * `bottom-start`, matching `MenuButton`'s own default. Aligns relative
+     * to the caret trigger alone unless `anchorToFullButton` is set, in
+     * which case it aligns relative to the whole control instead. Passed
+     * straight through to the underlying `MenuButton`.
+     */
+    placement?: Placement;
     /**
      * Which size of button to render
      */
@@ -44,5 +63,5 @@ interface SplitButtonProps extends ComponentPropsWithoutRef<'span'> {
 /**
  * A component used to render a button with a primary action and a menu of additional options
  */
-export declare const SplitButton: ({ actionItems, className, disabled, iconName, id, moreActionsLabel, size, variant, ...props }: SplitButtonProps) => import("react/jsx-runtime").JSX.Element;
+export declare const SplitButton: ({ actionItems, anchorToFullButton, className, disabled, iconName, id, moreActionsLabel, placement, size, variant, ...props }: SplitButtonProps) => import("react/jsx-runtime").JSX.Element;
 export {};

package/dist/components/icons/Icon/generated-icon-data.d.ts

@@ -3,7 +3,7 @@
  *
  * Generated by: npm run generate:icon-data
  * Source: icon-registry.ts + Font Awesome packages + custom-icons.tsx
- * Generated: 2026-09-11T22:06:16.665Z
+ * Generated: 2026-09-16T22:12:38.309Z
  */
 import { customIcons } from './custom-icons';
 export { customIcons };

package/dist/components/inputs/Datepicker/Datepicker.d.ts

@@ -137,6 +137,14 @@ interface DatepickerSharedProps extends DatepickerHTMLProps {
      * doesn't prescribe what goes there.
      */
     footerNote?: ReactNode;
+    /**
+     * Hour format for the `showTime` field(s), forwarded to each embedded
+     * `Timepicker`. `12` displays hour + AM/PM (e.g. "12:30 PM"); `24`
+     * displays a 24-hour hour segment with no AM/PM (e.g. "13:30"). Not
+     * derivable from `locale` — the embedded fields always receive an
+     * explicit `hourCycle`, which overrides locale-derived formatting.
+     */
+    hourCycle?: 12 | 24;
     /**
      * Input ID.
      */
@@ -234,6 +242,14 @@ interface DatepickerSharedProps extends DatepickerHTMLProps {
      * date. Has no effect unless `showTime` is also true.
      */
     showTimeZoneSwitcher?: boolean;
+    /**
+     * Whether the calendar footer includes its "Today" button. Defaults to
+     * `true`. Set to `false` to leave only the end-aligned buttons —
+     * `Clear`, plus `Done` when `mode` is `'range'` or `showTime` is set.
+     * Blanking `translationStrings.todayButton` only empties the label,
+     * leaving the button itself in place.
+     */
+    showTodayButton?: boolean;
     /**
      * IANA time zone identifier (e.g. "America/Los_Angeles", "UTC") used to
      * combine the selected date with `showTime`'s entered time-of-day into a
@@ -318,5 +334,5 @@ export type DatepickerProps = SingleDatepickerProps | RangeDatepickerProps;
 /**
  * Datepicker UI component.
  */
-export declare const Datepicker: ({ allowCustomRange, allowDateRangeSelection, className, defaultPresetLabel, disabled, footerNote, id, inputWidth, inputWidthMin, label, locale, maxDate, message, minDate, mode, onChange, placeholder, presets, required, showLabel, showPresetCalendar, showTime, showTimeZoneSwitcher, timeZone, tooltipText, translationStrings: translationStringsProp, validationMessage, validationStatus, value, visibleMonths, ...props }: DatepickerProps) => import("react/jsx-runtime").JSX.Element;
+export declare const Datepicker: ({ allowCustomRange, allowDateRangeSelection, className, defaultPresetLabel, disabled, footerNote, hourCycle, id, inputWidth, inputWidthMin, label, locale, maxDate, message, minDate, mode, onChange, placeholder, presets, required, showLabel, showPresetCalendar, showTime, showTimeZoneSwitcher, showTodayButton, timeZone, tooltipText, translationStrings: translationStringsProp, validationMessage, validationStatus, value, visibleMonths, ...props }: DatepickerProps) => import("react/jsx-runtime").JSX.Element;
 export {};

package/dist/components/navigation/BookmarksMenu/BookmarksMenu.d.ts

@@ -0,0 +1,151 @@
+import { ComponentPropsWithoutRef, ReactNode } from 'react';
+import { MenuItemType } from '../../../libs/types/custom-types';
+import './bookmarks-menu.css';
+/**
+ * A single bookmark row, shared by `BookmarksMenu` and `BookmarksPanel`.
+ */
+export type BookmarkItem = {
+    /**
+     * Stable id, used for React list keys. Omit only if `title` is
+     * guaranteed unique across the list.
+     */
+    id?: string;
+    /**
+     * Link element the row navigates to on selection (e.g. `<a href='...'>`
+     * or a router `Link`).
+     */
+    linkContent: ReactNode;
+    /**
+     * Removes the bookmark. Omit to hide the kebab's Remove action.
+     */
+    onRemove?: () => void;
+    /**
+     * Renames the bookmark. Omit to hide the kebab's Rename action.
+     */
+    onRename?: () => void;
+    /**
+     * Secondary text below the title (e.g. site/team name).
+     */
+    subtitle?: string;
+    /**
+     * Bookmark title.
+     */
+    title: string;
+};
+/**
+ * Translation strings shared by `buildBookmarkMenuItems`'s two callers
+ * (`BookmarksMenu`, `BookmarksPanel`).
+ */
+export type BookmarkMenuItemLabels = {
+    /**
+     * Returns the accessible label for the Remove action when it's critical
+     * (destructive) styled.
+     * Defaults to `(bookmark) => \`Remove ${bookmark.title}\``.
+     */
+    getRemoveCriticalLabel?: (bookmark: BookmarkItem) => string;
+    /**
+     * Label for the kebab's Remove action.
+     * @default 'Remove'
+     */
+    removeLabel?: string;
+    /**
+     * Label for the kebab's Rename action.
+     * @default 'Rename'
+     */
+    renameLabel?: string;
+};
+/**
+ * Builds the kebab's Rename/Remove menu items for a bookmark row.
+ */
+export declare const buildBookmarkMenuItems: (bookmark: BookmarkItem, labels?: BookmarkMenuItemLabels) => MenuItemType[];
+/**
+ * Centered icon + message shown in place of the bookmark list when empty.
+ */
+export declare const BookmarksEmptyState: ({ text }: {
+    text: string;
+}) => import("react/jsx-runtime").JSX.Element;
+/**
+ * Prop types for BookmarksMenu
+ */
+export interface BookmarksMenuProps extends ComponentPropsWithoutRef<'span'> {
+    /**
+     * Aria label for the trigger button.
+     * @default 'Bookmarks'
+     */
+    ariaLabel?: string;
+    /**
+     * The user's bookmarks.
+     */
+    bookmarks?: BookmarkItem[];
+    /**
+     * Additional class names
+     */
+    className?: string;
+    /**
+     * Label for the header's "+ Create" action.
+     * @default 'Create'
+     */
+    createLabel?: string;
+    /**
+     * Returns the accessible label for a row's kebab menu.
+     * Defaults to `(bookmark) => \`Actions for ${bookmark.title}\``.
+     */
+    getMenuAriaLabel?: (bookmark: BookmarkItem) => string;
+    /**
+     * Returns the accessible label for a row's Remove action.
+     * Defaults to `(bookmark) => \`Remove ${bookmark.title}\``.
+     */
+    getRemoveCriticalLabel?: (bookmark: BookmarkItem) => string;
+    /**
+     * Heading shown in the panel's header.
+     * @default 'Bookmarks'
+     */
+    heading?: string;
+    /**
+     * Fills the trigger icon to indicate the current page is already
+     * bookmarked. The component has no router access of its own, so the
+     * consumer derives this from its own current-page/router state.
+     */
+    isBookmarked?: boolean;
+    /**
+     * Opt in to swapping the trigger + floating panel for an inline
+     * accordion at the mobile breakpoint. Defaults to `false` —
+     * BookmarksMenu always renders its normal trigger + panel otherwise,
+     * regardless of viewport. Set this explicitly when placing
+     * BookmarksMenu inside a mobile nav menu that provides the accordion's
+     * expected layout (e.g. `Navbar`'s own mobile menu) — typically
+     * `isMobileAccordion={useIsMobile()}`, using the `useIsMobile` hook, so
+     * the swap only takes effect at the mobile breakpoint.
+     */
+    isMobileAccordion?: boolean;
+    /**
+     * Caps the panel's height in pixels. Omit to size it to the available
+     * viewport space only.
+     */
+    maxHeightValue?: number;
+    /**
+     * Text shown in place of the list when there are no bookmarks.
+     */
+    noResultsText?: string;
+    /**
+     * Called when the "+ Create" action in the panel's header is selected.
+     * Omit to hide that action entirely. The consumer owns what happens
+     * next (a modal, a new page, etc.).
+     */
+    onCreateBookmark?: () => void;
+    /**
+     * Label for a row's kebab Remove action.
+     * @default 'Remove'
+     */
+    removeLabel?: string;
+    /**
+     * Label for a row's kebab Rename action.
+     * @default 'Rename'
+     */
+    renameLabel?: string;
+}
+/**
+ * BookmarksMenu UI component. Top-nav icon trigger that opens a floating
+ * panel listing the user's bookmarks.
+ */
+export declare const BookmarksMenu: ({ ariaLabel, bookmarks, className, createLabel, getMenuAriaLabel, getRemoveCriticalLabel, heading, isBookmarked, isMobileAccordion, maxHeightValue, noResultsText, onCreateBookmark, removeLabel, renameLabel, ...props }: BookmarksMenuProps) => import("react/jsx-runtime").JSX.Element;

package/dist/components/navigation/Navbar/Navbar.d.ts

@@ -1,5 +1,6 @@
 import { ComponentPropsWithoutRef, ReactNode } from 'react';
 import { ContainerWidth } from '../../../libs/types/custom-types';
+import { GapScale } from '../../../libs/types/layout-types';
 import './navbar.css';
 /**
  * Prop types for Navbar
@@ -26,14 +27,26 @@ export interface NavbarProps extends ComponentPropsWithoutRef<'header'> {
      */
     hideBorder?: boolean;
     /**
-     * Overrides the horizontal (inline) padding of the desktop navbar bar.
-     * Accepts any CSS length (e.g. '1rem', '26px', or a token such as
-     * 'var(--pds-spacing-m)'). Applied symmetrically. Defaults to the
-     * Container's standard gutter. Useful for aligning navbar content with an
-     * adjacent app shell (e.g. the AppLayout sidebar) when placed in a `header`
-     * slot.
+     * Overrides the desktop bar's horizontal padding (any CSS length) so it
+     * can align with something outside the Navbar, e.g. a sidebar's padding.
+     * @default Container's standard gutter
      */
     inlinePadding?: string;
+    /**
+     * Gap between items in the `items-center` slot, desktop only.
+     * @default 'm'
+     */
+    itemsCenterGap?: GapScale;
+    /**
+     * Gap between items in the `items-left` slot, desktop only.
+     * @default 'm'
+     */
+    itemsLeftGap?: GapScale;
+    /**
+     * Gap between items in the `items-right` slot, desktop only.
+     * @default 'm'
+     */
+    itemsRightGap?: GapScale;
     /**
      * Translation strings for accessibility.
      */
@@ -45,4 +58,4 @@ export interface NavbarProps extends ComponentPropsWithoutRef<'header'> {
 /**
  * Navbar UI component
  */
-export declare const Navbar: ({ children, className, colorType, containerWidth, hideBorder, inlinePadding, translationStrings, ...props }: NavbarProps) => import("react/jsx-runtime").JSX.Element;
+export declare const Navbar: ({ children, className, colorType, containerWidth, hideBorder, inlinePadding, itemsCenterGap, itemsLeftGap, itemsRightGap, translationStrings, ...props }: NavbarProps) => import("react/jsx-runtime").JSX.Element;

package/dist/components/panels/BookmarksPanel/BookmarksPanel.d.ts

@@ -0,0 +1,67 @@
+import { ComponentPropsWithoutRef } from 'react';
+import { BookmarkItem } from '../../navigation/BookmarksMenu/BookmarksMenu';
+import './bookmarks-panel.css';
+/**
+ * Prop types for BookmarksPanel
+ */
+export interface BookmarksPanelProps extends ComponentPropsWithoutRef<'div'> {
+    /**
+     * The user's bookmarks.
+     */
+    bookmarks?: BookmarkItem[];
+    /**
+     * Additional class names
+     */
+    className?: string;
+    /**
+     * Caps the height of the content region only. Passed straight through
+     * to `WidgetPanel`.
+     */
+    contentMaxHeight?: string;
+    /**
+     * Label for the footer's "Create bookmark" action.
+     * @default 'Create bookmark'
+     */
+    createLabel?: string;
+    /**
+     * Returns the accessible label for a row's kebab menu.
+     * Defaults to `(bookmark) => \`Actions for ${bookmark.title}\``.
+     */
+    getMenuAriaLabel?: (bookmark: BookmarkItem) => string;
+    /**
+     * Returns the accessible label for a row's Remove action.
+     * Defaults to `(bookmark) => \`Remove ${bookmark.title}\``.
+     */
+    getRemoveCriticalLabel?: (bookmark: BookmarkItem) => string;
+    /**
+     * Heading for the panel.
+     * @default 'Bookmarks'
+     */
+    heading?: string;
+    /**
+     * Text shown in place of the list when there are no bookmarks.
+     */
+    noResultsText?: string;
+    /**
+     * Called when the "Create bookmark" footer action is selected. Omit to
+     * hide that action entirely. The consumer owns what happens next (a
+     * modal, a new page, etc.).
+     */
+    onCreateBookmark?: () => void;
+    /**
+     * Label for a row's kebab Remove action.
+     * @default 'Remove'
+     */
+    removeLabel?: string;
+    /**
+     * Label for a row's kebab Rename action.
+     * @default 'Rename'
+     */
+    renameLabel?: string;
+}
+/**
+ * BookmarksPanel UI component. Persistently-visible, embedded variant of
+ * the bookmark list for homepage/sidebar widget slots, built on
+ * `WidgetPanel`.
+ */
+export declare const BookmarksPanel: ({ bookmarks, className, contentMaxHeight, createLabel, getMenuAriaLabel, getRemoveCriticalLabel, heading, noResultsText, onCreateBookmark, removeLabel, renameLabel, ...props }: BookmarksPanelProps) => import("react/jsx-runtime").JSX.Element;

package/dist/components/panels/PanelList/PanelList.d.ts

@@ -1,6 +1,6 @@
 import { ComponentPropsWithoutRef, ReactNode } from 'react';
 import './panel-list.css';
-export type PanelListBackground = 'default' | 'secondary' | 'transparent';
+export type PanelListBackground = 'default' | 'secondary' | 'sunken' | 'transparent';
 /**
  * Prop types for PanelList
  */

package/dist/css/component-css/pds-Table.stories.css

@@ -0,0 +1 @@
+@layer pds-v1, pds-v2;@layer pds-v2{.table-story__name-col{width:100%}.table-story__insights-col{min-width:8rem;white-space:nowrap}}