@pantheon-systems/pds-toolkit-react 2.0.0-alpha.7 → 2.0.0-alpha.71

package/codemods/v1-to-v2/transforms/removed-prop-values.js

@@ -0,0 +1,206 @@
+/**
+ * Codemod: removed-prop-values
+ *
+ * Handles props that were removed or had specific values removed in PDS v1→v2.
+ * Driven entirely by props.removals in mappings.json.
+ *
+ * Two kinds of change:
+ *
+ * 1. Value rewrites (entries with `oldValue`):
+ *    The prop stays but a specific string value changes.
+ *    e.g. Button variant="brand-secondary" → variant="secondary"
+ *
+ * 2. Prop removals (all other entries):
+ *    - Plain removals: the prop is removed unconditionally.
+ *      e.g. <Panel hasStatusIndicator> → <Panel>
+ *    - Conditional removals (entries with `removedValues`): the prop is
+ *      removed only when its value is in the removed set; other values are
+ *      left untouched.
+ *      e.g. Card background="mint-gradient" → prop removed
+ *           Card background="default"       → unchanged
+ *
+ * Usage (all components):
+ *   npx jscodeshift -t codemods/v1-to-v2/transforms/removed-prop-values.js \
+ *     --extensions=tsx,ts,jsx,js \
+ *     src/
+ *
+ * Usage (single component — recommended for by-component migrations):
+ *   npx jscodeshift -t codemods/v1-to-v2/transforms/removed-prop-values.js \
+ *     --only=Button \
+ *     --extensions=tsx,ts,jsx,js \
+ *     src/
+ *
+ * Limitations:
+ *   - Only static string literals and boolean shorthand attributes are
+ *     transformed. Dynamic values (variables, expressions) are left as-is
+ *     and need manual review.
+ *   - Table.headers is skipped — its removal requires a structural object
+ *     shape change that cannot be automated at the attribute level.
+ */
+
+const path = require('path');
+const mappings = require(path.join(__dirname, '../mappings.json'));
+
+// Entries that are too complex to automate
+const SKIP_PROPS = new Set(['Table.headers']);
+
+function buildLookups() {
+	// { 'Component.prop.oldValue': 'newValue' }
+	const valueRewrites = {};
+	// { 'Component.prop': null | Set<removedValues> }
+	//   null   → remove the prop unconditionally
+	//   Set    → remove only when value is in the set
+	const propRemovals = {};
+
+	for (const entry of mappings.props.removals) {
+		const { component, prop } = entry;
+		if (!component || !prop) continue;
+
+		const key = `${component}.${prop}`;
+		if (SKIP_PROPS.has(key)) continue;
+
+		if (entry.oldValue) {
+			// Value rewrite: derive new value from the replacement text
+			// Replacement is prose like "Use variant=\"secondary\""
+			// Extract the first quoted value found, e.g. "secondary"
+			const match =
+				entry.replacement && entry.replacement.match(/["']([^"']+)["']/);
+			const newValue = match ? match[1] : null;
+			if (newValue) {
+				valueRewrites[`${key}.${entry.oldValue}`] = newValue;
+			}
+		} else if (entry.removedValues) {
+			// Conditional removal: remove only when value is in the set
+			propRemovals[key] = new Set(entry.removedValues);
+		} else {
+			// Unconditional removal
+			propRemovals[key] = null;
+		}
+	}
+
+	return { valueRewrites, propRemovals };
+}
+
+const { valueRewrites: ALL_VALUE_REWRITES, propRemovals: ALL_PROP_REMOVALS } =
+	buildLookups();
+
+module.exports = function transform(file, api, options) {
+	const j = api.jscodeshift;
+	const root = j(file.source);
+
+	// Parse --only flag: comma-separated component names
+	const onlyComponents =
+		options && options.only
+			? new Set(
+					options.only
+						.split(',')
+						.map((s) => s.trim())
+						.filter(Boolean),
+				)
+			: null;
+
+	// Map local import name → exported component name
+	const localToExported = new Map();
+
+	root.find(j.ImportDeclaration).forEach((nodePath) => {
+		if (nodePath.node.source.value !== '@pantheon-systems/pds-toolkit-react')
+			return;
+		nodePath.node.specifiers.forEach((spec) => {
+			if (spec.type === 'ImportSpecifier') {
+				localToExported.set(spec.local.name, spec.imported.name);
+			}
+		});
+	});
+
+	if (localToExported.size === 0) return;
+
+	let changed = false;
+
+	root.find(j.JSXOpeningElement).forEach((nodePath) => {
+		const nameNode = nodePath.node.name;
+		if (nameNode.type !== 'JSXIdentifier') return;
+
+		const exportedName = localToExported.get(nameNode.name);
+		if (!exportedName) return;
+
+		if (onlyComponents && !onlyComponents.has(exportedName)) return;
+
+		const attrsToRemove = [];
+
+		nodePath.node.attributes.forEach((attr) => {
+			if (attr.type !== 'JSXAttribute') return;
+
+			const propName = attr.name.name;
+			if (typeof propName !== 'string') return;
+
+			const key = `${exportedName}.${propName}`;
+
+			// --- Value rewrites ---
+			// String literal: variant="brand-secondary"
+			if (attr.value && attr.value.type === 'StringLiteral') {
+				const rewriteKey = `${key}.${attr.value.value}`;
+				const newValue = ALL_VALUE_REWRITES[rewriteKey];
+				if (newValue) {
+					attr.value = j.stringLiteral(newValue);
+					changed = true;
+					return;
+				}
+			}
+			// JSX expression container: variant={"brand-secondary"}
+			if (
+				attr.value &&
+				attr.value.type === 'JSXExpressionContainer' &&
+				attr.value.expression.type === 'StringLiteral'
+			) {
+				const rewriteKey = `${key}.${attr.value.expression.value}`;
+				const newValue = ALL_VALUE_REWRITES[rewriteKey];
+				if (newValue) {
+					attr.value.expression = j.stringLiteral(newValue);
+					changed = true;
+					return;
+				}
+			}
+
+			// --- Prop removals ---
+			if (!(key in ALL_PROP_REMOVALS)) return;
+			const removedValues = ALL_PROP_REMOVALS[key];
+
+			if (removedValues === null) {
+				// Unconditional removal (boolean shorthand or any value)
+				attrsToRemove.push(attr);
+				changed = true;
+				return;
+			}
+
+			// Conditional removal — only remove when value is in the removed set
+			let attrValue = null;
+			if (!attr.value) {
+				// Boolean shorthand e.g. <Card background> — unlikely but handle it
+				attrValue = 'true';
+			} else if (attr.value.type === 'StringLiteral') {
+				attrValue = attr.value.value;
+			} else if (
+				attr.value.type === 'JSXExpressionContainer' &&
+				attr.value.expression.type === 'StringLiteral'
+			) {
+				attrValue = attr.value.expression.value;
+			}
+
+			if (attrValue !== null && removedValues.has(attrValue)) {
+				attrsToRemove.push(attr);
+				changed = true;
+			}
+		});
+
+		// Remove collected attributes
+		if (attrsToRemove.length > 0) {
+			nodePath.node.attributes = nodePath.node.attributes.filter(
+				(attr) => !attrsToRemove.includes(attr),
+			);
+		}
+	});
+
+	return changed ? root.toSource() : undefined;
+};
+
+module.exports.parser = 'tsx';

package/dist/components/Avatar/Avatar.d.ts

@@ -21,6 +21,10 @@ export interface AvatarProps extends ComponentPropsWithoutRef<'div'> {
      * A link element using the router of your choice. Leave empty for no link.
      */
     linkContent?: ReactNode;
+    /**
+     * Avatar shape.
+     */
+    shape?: 'circle' | 'square';
     /**
      * Avatar size.
      */
@@ -33,4 +37,4 @@ export interface AvatarProps extends ComponentPropsWithoutRef<'div'> {
 /**
  * Avatar UI component
  */
-export declare const Avatar: ({ ariaLabel, className, hasUserFallback, imageSrc, linkContent, size, uniqueId, ...props }: AvatarProps) => import("react/jsx-runtime").JSX.Element;
+export declare const Avatar: ({ ariaLabel, className, hasUserFallback, imageSrc, linkContent, shape, size, uniqueId, ...props }: AvatarProps) => import("react/jsx-runtime").JSX.Element;

package/dist/components/Callout/Callout.d.ts

@@ -1,5 +1,5 @@
 import { ComponentPropsWithoutRef, ReactNode } from 'react';
-import { StatusType } from '../../libs/types/custom-types';
+import { HeadingLevelCommon, StatusType } from '../../libs/types/custom-types';
 import './callout.css';
 type CalloutType = StatusType | 'code' | 'earlyAccess';
 type TypeLabels = Record<CalloutType, string>;
@@ -12,6 +12,10 @@ export interface CalloutProps extends ComponentPropsWithoutRef<'div'> {
      * Additional class names
      */
     className?: string;
+    /**
+     * Semantic element for the title. Styles are identical regardless of element chosen.
+     */
+    headingLevel?: HeadingLevelCommon;
     /**
      * Callout title.
      */
@@ -28,5 +32,5 @@ export interface CalloutProps extends ComponentPropsWithoutRef<'div'> {
 /**
  * Callout UI component
  */
-export declare const Callout: ({ children, className, title, type, typeLabels, ...props }: CalloutProps) => import("react/jsx-runtime").JSX.Element;
+export declare const Callout: ({ children, className, headingLevel, title, type, typeLabels, ...props }: CalloutProps) => import("react/jsx-runtime").JSX.Element;
 export {};

package/dist/components/CodeBlock/CodeBlock.d.ts

@@ -1,4 +1,13 @@
 import { ComponentPropsWithoutRef } from 'react';
+import 'prismjs/components/prism-markup';
+import 'prismjs/components/prism-css';
+import 'prismjs/components/prism-clike';
+import 'prismjs/components/prism-javascript';
+import 'prismjs/components/prism-typescript';
+import 'prismjs/components/prism-jsx';
+import 'prismjs/components/prism-tsx';
+import 'prismjs/components/prism-json';
+import 'prismjs/components/prism-yaml';
 import 'prismjs/components/prism-bash';
 import 'prismjs/components/prism-diff';
 import './code-block.css';
@@ -16,10 +25,6 @@ export interface CodeBlockProps extends ComponentPropsWithoutRef<'div'> {
      * Code to display.
      */
     code: string;
-    /**
-     * Color type. Default is dark.
-     */
-    colorType?: 'dark' | 'light';
     /**
      * Copy button label. Aria-label and tooltip text for the copy button.
      */
@@ -81,5 +86,5 @@ export interface CodeBlockProps extends ComponentPropsWithoutRef<'div'> {
 /**
  * CodeBlock UI component
  */
-export declare const CodeBlock: ({ className, code, colorType, copyButtonLabel, hasCopyButton, hasLineNumbers, hasPrompt, height, isLoading, language, loadingLineCount, maxHeight, promptSymbol, renderAsLegacy, shouldWrap, ...props }: CodeBlockProps) => import("react/jsx-runtime").JSX.Element;
+export declare const CodeBlock: ({ className, code, copyButtonLabel, hasCopyButton, hasLineNumbers, hasPrompt, height, isLoading, language, loadingLineCount, maxHeight, promptSymbol, renderAsLegacy, shouldWrap, ...props }: CodeBlockProps) => import("react/jsx-runtime").JSX.Element;
 export {};

package/dist/components/CodeBlock/code-examples.d.ts

@@ -1,6 +1,7 @@
 export declare const logExample = "Already have image (with digest): us-docker.pkg.dev/prod-decoupled-shared/build-tools/pantheon-build:v1.0.8-node20\nThe framework expected according to the configuration is: gatsby.\nThe framework detected from the code is: vite\nERROR: Invalid option: false\ndeprecated-tools [options]\nUsage:\n  deprecated-tools -t node --min-version 18 [--max-version 20] --message-format \"Node version should be between %s and %s\" --message-data \"18 20\"\n  deprecated-tools -f .nvmrc --message-format \"The file %s is deprecated\" --message-data \".nvmrc\"\n\n  -t, --tool <tool>       Check if a tool is deprecated\n    --min-version <ver>         Minimum version supported for the tool\n    --max-version <ver>         Max version supported for the tool\n  --message-format <format>   Format of the deprecation message\n  --message-data <data>       Array of data to use in the deprecation message\n  -f, --file <file>       Check if a file is deprecated\n  --message-format <format>   Format of the deprecation message\n  --message-data <data>       Array of data to use in the deprecation message\n  -h, --help              Display this help message\nnpm WARN deprecated rimraf@2.6.3: Rimraf versions prior to v4 are no longer supported\nnpm WARN deprecated glob@7.2.3: Glob versions prior to v9 are no longer supported\n\n> @pantheon-systems/pds-toolkit-react@1.0.0-dev.213 prepare\n> husky install\n\nhusky - Git hooks installed";
 export declare const reactExample = "export const ControlledExample = () => {\n  const defaultValue = 'This is a default value';\n  const [value, setValue] = useState(defaultValue);\n\n  // This is a comment for this component.\n  return (\n    <TextInput\n      id='text-input-controlled-example'\n      label='Controlled Input example'\n      type='text'\n      hasClearButton={true}\n      onClear={() => {\n        setValue('');\n      }}\n      onChange={(event: ChangeEvent<HTMLInputElement>) => setValue(event.target.value)}\n      value={value}\n    />\n  );\n};";
-export declare const cssExample = ".pds-file-diff {\n  align-items: center;\n  display: flex;\n  gap: 0.25rem;\n  height: 1.0625rem;\n  max-width: 100%;\n  width: 100%;\n\n  .pds-file-diff__total-changes {\n    color: var(--pds-color-fg-default-secondary);\n    font-size: var(--pds-typography-size-xs);\n  }\n\n  .pds-file-diff__bars {\n    align-items: center;\n    display: flex;\n    gap: 0.125rem;\n    width: 100%;\n  }\n\n  .pds-file-diff__behind {\n    position: relative;\n\n    .pds-file-diff__behind-bar {\n      background-color: var(--pds-color-status-critical-utility);\n      border-bottom-left-radius: 6.25rem;\n      border-top-left-radius: 6.25rem;\n      height: 8px;\n      min-width: 1px;\n      right: 0px;\n      transition: width 0.3s ease;\n      width: 100%;\n    }\n  }\n\n  .pds-file-diff__ahead {\n    position: relative;\n\n    .pds-file-diff__ahead-bar {\n      background-color: var(--pds-color-status-success-utility);\n      border-bottom-right-radius: 6.25rem;\n      border-top-right-radius: 6.25rem;\n      height: 8px;\n      left: 0px;\n      min-width: 1px;\n      transition: width 0.3s ease;\n      width: 100%;\n    }\n  }\n\n  .pds-file-diff__tooltip {\n    display: block;\n    padding-inline: 0;\n  }\n}\n";
+export declare const cssExample = ".pds-file-diff {\n  align-items: center;\n  display: flex;\n  gap: 0.25rem;\n  height: 1.0625rem;\n  max-width: 100%;\n  width: 100%;\n\n  .pds-file-diff__total-changes {\n    color: var(--pds-color-foreground-default-secondary);\n    font-size: var(--pds-typography-size-xs);\n  }\n\n  .pds-file-diff__bars {\n    align-items: center;\n    display: flex;\n    gap: 0.125rem;\n    width: 100%;\n  }\n\n  .pds-file-diff__behind {\n    position: relative;\n\n    .pds-file-diff__behind-bar {\n      background-color: var(--pds-color-status-critical-utility);\n      border-bottom-left-radius: 6.25rem;\n      border-top-left-radius: 6.25rem;\n      height: 8px;\n      min-width: 1px;\n      right: 0px;\n      transition: width 0.3s ease;\n      width: 100%;\n    }\n  }\n\n  .pds-file-diff__ahead {\n    position: relative;\n\n    .pds-file-diff__ahead-bar {\n      background-color: var(--pds-color-status-success-utility);\n      border-bottom-right-radius: 6.25rem;\n      border-top-right-radius: 6.25rem;\n      height: 8px;\n      left: 0px;\n      min-width: 1px;\n      transition: width 0.3s ease;\n      width: 100%;\n    }\n  }\n\n  .pds-file-diff__tooltip {\n    display: block;\n    padding-inline: 0;\n  }\n}\n";
 export declare const diffExample = "diff --git a/influitive/index.css b/influitive/index.css\nindex 2069af6..b347ca3 100644\n--- a/influitive/index.css\n+++ b/influitive/index.css\n@@ -1,4 +1,4 @@\n #nav-container ul li.c-nav-list-item a.c-nav-item {\n   font-weight: 500 !important;\n-  font-family: 'Poppins', san-serif !important;\n+  font-family: 'Poppins', sans-serif !important;\n }";
 export declare const twigExample = "<div class=\"pds-status-badge pds-status-badge--{{ color|default('transparent')}}{% if extra_classes %} {{ extra_classes }}{% endif %}\">\n\n  {% if has_status_indicator %}\n    <span class=\"pds-status-badge__status pds-status-badge__status--{{ status_type }}\">\n      {% if status_type %}\n        <span class=\"visually-hidden\">Status: {{ status_type }}</span>\n      {% endif %}\n    </span>\n  {% endif %}\n\n  <span class=\"pds-status-badge__label\">{{ label }}</span>\n</div>";
+export declare const jsonExample = "{\n  \"site\": {\n    \"id\": \"26d20ebf-b2fb-466e-9db3-4c001db441d6\",\n    \"name\": \"my-awesome-site\",\n    \"framework\": \"wordpress\",\n    \"region\": \"United States\",\n    \"created_at\": \"2024-01-15T08:30:00+00:00\",\n    \"php_version\": \"8.3\",\n    \"upstream\": {\n      \"id\": \"e8fe8550-1ab9-4964-8838-2b9abdccf4bf\",\n      \"label\": \"WordPress\",\n      \"type\": \"core\"\n    },\n    \"environments\": [\"dev\", \"test\", \"live\"],\n    \"frozen\": false,\n    \"max_num_cdes\": 10\n  }\n}";
 export declare const legacyExample = "Composer version 2.8.6 2025-02-25 13:03:50<br>PHP version 8.3.21 (&#47;opt&#47;pantheon&#47;php8.3&#47;php)<br>Run the &quot;diagnose&quot; command to get more detailed diagnostics output.<br>Cache directory does not exist (cache-vcs-dir):<br>Cache directory does not exist (cache-repo-dir):<br>Cache directory does not exist (cache-files-dir):<br>Clearing cache (cache-dir): &#47;home&#47;pantheon-app&#47;.composer&#47;cache<br>All caches cleared.<br>Running composer install...<br>composer --no-interaction --no-progress --prefer-dist --ansi install<br><span class=\"term-fg32\">No patches supplied.</span><br><span class=\"term-fg32\">Installing dependencies from lock file (including require-dev)</span><br><span class=\"term-fg32\">Verifying lock file contents can be installed on current platform.</span><br>Nothing to install, update or remove<br><span class=\"term-fg32\">Generating autoload files</span><br><span class=\"term-fg32\">89 packages you are using are looking for funding.</span><br><span class=\"term-fg32\">Use the `composer fund` command to find out more!</span><br><span class=\"term-fg32\">phpstan&#47;extension-installer:</span> Extensions installed";

package/dist/components/CodeBlock/prism-setup.d.ts

@@ -0,0 +1,2 @@
+import Prism from 'prismjs/components/prism-core';
+export default Prism;

package/dist/components/CodeBlock/themes/index.d.ts

@@ -1,2 +1 @@
-export * from './pdsDark';
-export * from './pdsLight';
+export * from './pds';

package/dist/components/CodeBlock/themes/{pdsDark.d.ts → pds.d.ts}

@@ -1,2 +1,2 @@
 import type { PrismTheme } from 'prism-react-renderer';
-export declare const pdsDark: PrismTheme;
+export declare const pds: PrismTheme;

package/dist/components/ComparisonList/ComparisonList.d.ts

@@ -9,6 +9,7 @@ export interface ListItems {
     text: string;
     type: 'included' | 'notIncluded' | 'addon';
 }
+export type ComparisonListSize = 's' | 'm';
 export interface ComparisonListProps extends ComponentPropsWithoutRef<'div'> {
     /**
      * Additional class names
@@ -34,6 +35,10 @@ export interface ComparisonListProps extends ComponentPropsWithoutRef<'div'> {
      * Whether to show the border on list items.
      */
     showBorder?: boolean;
+    /**
+     * Size variant.
+     */
+    size?: ComparisonListSize;
     /**
      * Icon labels
      */
@@ -42,5 +47,5 @@ export interface ComparisonListProps extends ComponentPropsWithoutRef<'div'> {
 /**
  * ComparisonList UI component
  */
-export declare const ComparisonList: ({ className, listItems, listLabel, moreLink, renderTypeLabels, showBorder, typeLabels, ...props }: ComparisonListProps) => import("react/jsx-runtime").JSX.Element;
+export declare const ComparisonList: ({ className, listItems, listLabel, moreLink, renderTypeLabels, showBorder, size, typeLabels, ...props }: ComparisonListProps) => import("react/jsx-runtime").JSX.Element;
 export {};

package/dist/components/Dropdown/Dropdown.d.ts

@@ -0,0 +1,192 @@
+import { ComponentPropsWithoutRef, ReactNode } from 'react';
+import { UseDropdownOptions } from '../../utilities/hooks/useDropdown';
+import './dropdown.css';
+export interface DropdownProps extends UseDropdownOptions {
+    /**
+     * Dropdown sub-components (Trigger, Panel, etc.).
+     */
+    children?: ReactNode;
+    /**
+     * Additional class names for the root wrapper.
+     */
+    className?: string;
+    /**
+     * Use inline-block display instead of block.
+     * Useful when the dropdown trigger should size to its content
+     * (e.g., UserMenu, MenuButton) rather than fill the parent width.
+     */
+    inline?: boolean;
+}
+/**
+ * Root Dropdown component. Provides dropdown context to sub-components.
+ */
+export declare const Dropdown: {
+    ({ children, className, inline, ...options }: DropdownProps): import("react/jsx-runtime").JSX.Element;
+    Trigger: ({ children, className, showTriggerIcon, ...props }: DropdownTriggerProps) => import("react/jsx-runtime").JSX.Element;
+    Panel: ({ children, className, ...props }: DropdownPanelProps) => import("react/jsx-runtime").JSX.Element;
+    Item: ({ children, className, closeOnSelect, description, disabled, icon, index, isActive, isCritical, onClick, onKeyDown, trailingIcon, ...props }: DropdownItemProps) => import("react/jsx-runtime").JSX.Element;
+    CheckboxItem: ({ checked, children, className, description, disabled, indeterminate, index, onCheckedChange, onClick, onKeyDown, ...props }: DropdownCheckboxItemProps) => import("react/jsx-runtime").JSX.Element;
+    Heading: ({ children, className, ...props }: DropdownHeadingProps) => import("react/jsx-runtime").JSX.Element;
+    Separator: ({ className, ...props }: DropdownSeparatorProps) => import("react/jsx-runtime").JSX.Element;
+    Filter: ({ className, filterIcon, label, noResultsText, onFilterChange, placeholder, showNoResults, ...props }: DropdownFilterProps) => import("react/jsx-runtime").JSX.Element;
+    Footer: ({ children, className, ...props }: DropdownFooterProps) => import("react/jsx-runtime").JSX.Element;
+};
+export interface DropdownTriggerProps extends ComponentPropsWithoutRef<'button'> {
+    /**
+     * Trigger content (label text, icon, etc.).
+     */
+    children?: ReactNode;
+    /**
+     * Additional class names.
+     */
+    className?: string;
+    /**
+     * Show a directional icon on the trigger that indicates the dropdown can be expanded.
+     */
+    showTriggerIcon?: boolean;
+}
+export interface DropdownPanelProps extends ComponentPropsWithoutRef<'ul'> {
+    /**
+     * Panel content (Items, Headings, Separators, Filter, etc.).
+     */
+    children?: ReactNode;
+    /**
+     * Additional class names.
+     */
+    className?: string;
+}
+export interface DropdownItemProps extends ComponentPropsWithoutRef<'li'> {
+    /**
+     * Item content — label text, or a link element for navigation items.
+     */
+    children?: ReactNode;
+    /**
+     * Additional class names.
+     */
+    className?: string;
+    /**
+     * Close the dropdown when this item is clicked (default: true).
+     * Set to false for items that shouldn't dismiss the menu — e.g. one that
+     * opens a submenu or triggers a multi-step flow.
+     */
+    closeOnSelect?: boolean;
+    /**
+     * Secondary text displayed below the label.
+     */
+    description?: ReactNode;
+    /**
+     * Disabled state.
+     */
+    disabled?: boolean;
+    /**
+     * Leading content — PDSIcon name, or custom ReactNode (Avatar, etc.).
+     */
+    icon?: ReactNode;
+    /**
+     * Index of this item in the list (required for keyboard navigation).
+     */
+    index: number;
+    /**
+     * Selected or current state.
+     */
+    isActive?: boolean;
+    /**
+     * Destructive action styling.
+     */
+    isCritical?: boolean;
+    /**
+     * Trailing content — check icon, lock icon, or custom ReactNode.
+     */
+    trailingIcon?: ReactNode;
+}
+export interface DropdownCheckboxItemProps extends Omit<ComponentPropsWithoutRef<'li'>, 'onChange'> {
+    /**
+     * Checked state of the item.
+     */
+    checked?: boolean;
+    /**
+     * Item label content.
+     */
+    children?: ReactNode;
+    /**
+     * Additional class names.
+     */
+    className?: string;
+    /**
+     * Secondary text displayed below the label.
+     */
+    description?: ReactNode;
+    /**
+     * Disabled state.
+     */
+    disabled?: boolean;
+    /**
+     * Partial/mixed state — renders a dash instead of a check.
+     */
+    indeterminate?: boolean;
+    /**
+     * Index of this item in the list (required for keyboard navigation).
+     */
+    index: number;
+    /**
+     * Callback fired when the item is toggled, with the next checked value.
+     */
+    onCheckedChange?: (checked: boolean) => void;
+}
+export interface DropdownHeadingProps extends ComponentPropsWithoutRef<'li'> {
+    /**
+     * Heading text.
+     */
+    children?: ReactNode;
+    /**
+     * Additional class names.
+     */
+    className?: string;
+}
+export interface DropdownSeparatorProps extends ComponentPropsWithoutRef<'li'> {
+    /**
+     * Additional class names.
+     */
+    className?: string;
+}
+export type DropdownFilterIcon = 'filter' | 'none' | 'search';
+export interface DropdownFilterProps extends ComponentPropsWithoutRef<'li'> {
+    /**
+     * Additional class names.
+     */
+    className?: string;
+    /**
+     * Icon to display inside the filter input.
+     */
+    filterIcon?: DropdownFilterIcon;
+    /**
+     * Label for the filter input (screen readers).
+     */
+    label?: string;
+    /**
+     * Text shown when no items match the filter.
+     */
+    noResultsText?: string;
+    /**
+     * Callback when the filter value changes.
+     */
+    onFilterChange?: (value: string) => void;
+    /**
+     * Placeholder text for the filter input.
+     */
+    placeholder?: string;
+    /**
+     * Whether to show the "no results" message.
+     */
+    showNoResults?: boolean;
+}
+export interface DropdownFooterProps extends ComponentPropsWithoutRef<'li'> {
+    /**
+     * Footer content — typically a single link or button (rendered as a link).
+     */
+    children?: ReactNode;
+    /**
+     * Additional class names.
+     */
+    className?: string;
+}

package/dist/components/Dropdown/DropdownSelectedIcon.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Selected-state check mark icon for dropdown items.
+ * Used alongside the pds-dropdown__selected-icon CSS class.
+ */
+export declare const DropdownSelectedIcon: ({ className, }: {
+    className?: string;
+}) => import("react/jsx-runtime").JSX.Element;

package/dist/components/FileDiff/FileDiff.d.ts

@@ -23,7 +23,7 @@ export interface FileDiffProps extends ComponentPropsWithoutRef<'div'> {
     /**
      * Object with strings for tooltips and screen reader labels.
      */
-    labelStrings?: {
+    translationStrings?: {
         additions?: string;
         deletions?: string;
         linesChanged?: string;
@@ -32,4 +32,4 @@ export interface FileDiffProps extends ComponentPropsWithoutRef<'div'> {
 /**
  * FileDiff UI component
  */
-export declare const FileDiff: ({ additions, className, componentWidth, deletions, labelStrings, ...props }: FileDiffProps) => import("react/jsx-runtime").JSX.Element;
+export declare const FileDiff: ({ additions, className, componentWidth, deletions, translationStrings, ...props }: FileDiffProps) => import("react/jsx-runtime").JSX.Element;

package/dist/components/IdentityBlock/IdentityBlock.d.ts

@@ -0,0 +1,37 @@
+import { ComponentPropsWithoutRef } from 'react';
+import { AvatarProps } from '../Avatar/Avatar';
+import './identity-block.css';
+/**
+ * Prop types for IdentityBlock
+ */
+export interface IdentityBlockProps extends ComponentPropsWithoutRef<'div'> {
+    /**
+     * Props to pass to the Avatar component.
+     */
+    avatarProps?: AvatarProps;
+    /**
+     * Additional class names
+     */
+    className?: string;
+    /**
+     * When true, only the avatar is shown (text is hidden).
+     */
+    isSidebarCollapsed?: boolean;
+    /**
+     * When true, displays a smaller avatar with only the primary text.
+     * Secondary text is not rendered even if provided.
+     */
+    isSingleLine?: boolean;
+    /**
+     * First line of text (e.g., organization name).
+     */
+    primaryText?: string;
+    /**
+     * Second line of text (e.g., user name).
+     */
+    secondaryText?: string;
+}
+/**
+ * IdentityBlock UI component
+ */
+export declare const IdentityBlock: ({ avatarProps, className, isSidebarCollapsed, isSingleLine, primaryText, secondaryText, ...props }: IdentityBlockProps) => import("react/jsx-runtime").JSX.Element;

package/dist/components/PantheonLogo/PantheonLogo.d.ts

@@ -1,6 +1,7 @@
 import { ComponentPropsWithoutRef, ReactNode } from 'react';
 import './pantheon-logo.css';
-export type PantheonLogoDisplayType = 'full' | 'icon' | 'wordmark' | 'sub-brand' | 'sub-brand-small';
+export type PantheonLogoDisplayType = 'full' | 'icon' | 'wordmark';
+export type PantheonLogoSize = 's' | 'm' | 'l';
 /**
  * Prop types for PantheonLogo
  */
@@ -22,11 +23,11 @@ export interface PantheonLogoProps extends ComponentPropsWithoutRef<'div'> {
      */
     linkContent?: ReactNode;
     /**
-     * Accepts a fully-formed link or a string (if a static site name is desired). Will only render if the `display-type` is set to 'sub-brand'.
+     * Size of the logo. The wordmark height is the basis — `s`, `m`, and `l` map to the corresponding typography size tokens.
      */
-    subBrand?: ReactNode | string;
+    size?: PantheonLogoSize;
 }
 /**
  * PantheonLogo UI component
  */
-export declare const PantheonLogo: ({ className, colorType, displayType, linkContent, subBrand, ...props }: PantheonLogoProps) => import("react/jsx-runtime").JSX.Element;
+export declare const PantheonLogo: ({ className, colorType, displayType, linkContent, size, ...props }: PantheonLogoProps) => import("react/jsx-runtime").JSX.Element;

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

@@ -58,8 +58,12 @@ export interface PopoverProps extends Omit<ComponentPropsWithoutRef<'div'>, 'con
      * The icon to use as the trigger.
      */
     triggerIcon?: 'circleInfo' | 'circleQuestion';
+    /**
+     * Size of the trigger icon. Uses PDS Icon sizing.
+     */
+    triggerIconSize?: 's' | 'm' | 'l';
 }
 /**
  * Popover UI component
  */
-export declare const Popover: ({ className, classNameContainer, closeButtonLabel, content, customTrigger, hasCloseButton, offsetValue, onClose, placement, popoverIsOpen, setPopoverIsOpen, title, triggerAccessibleText, triggerIcon, ...props }: PopoverProps) => import("react/jsx-runtime").JSX.Element;
+export declare const Popover: ({ className, classNameContainer, closeButtonLabel, content, customTrigger, hasCloseButton, offsetValue, onClose, placement, popoverIsOpen, setPopoverIsOpen, title, triggerAccessibleText, triggerIcon, triggerIconSize, ...props }: PopoverProps) => import("react/jsx-runtime").JSX.Element;