@pantheon-systems/pds-toolkit-react 2.0.0-alpha.36 → 2.0.0-alpha.38

package/codemods/v1-to-v2/transforms/prop-renames.js

@@ -0,0 +1,109 @@
+/**
+ * Codemod: prop-renames
+ *
+ * Renames PDS v1 prop names to their v2 names on JSX elements.
+ * Driven entirely by props.renames in mappings.json.
+ *
+ * Usage (all renames):
+ *   npx jscodeshift -t codemods/v1-to-v2/transforms/prop-renames.js \
+ *     --extensions=tsx,ts,jsx,js \
+ *     src/
+ *
+ * Usage (single component — recommended for by-component migrations):
+ *   npx jscodeshift -t codemods/v1-to-v2/transforms/prop-renames.js \
+ *     --only=Button \
+ *     --extensions=tsx,ts,jsx,js \
+ *     src/
+ *
+ * Usage (multiple components):
+ *   npx jscodeshift -t codemods/v1-to-v2/transforms/prop-renames.js \
+ *     --only=Button,Icon \
+ *     --extensions=tsx,ts,jsx,js \
+ *     src/
+ *
+ * --only accepts a comma-separated list of component names.
+ *
+ * Limitations:
+ *   - Renames where `from` is a nested path (e.g. `options[].description`)
+ *     cannot be transformed at the JSX attribute level and are skipped.
+ *     These require manual review.
+ */
+
+const path = require('path');
+const mappings = require(path.join(__dirname, '../mappings.json'));
+
+// Build lookup: { 'ComponentName.oldPropName': 'newPropName' }
+// Skips entries where `from` is a nested path (contains '.' or '[]').
+function buildRenamesLookup() {
+	const lookup = {};
+	for (const entry of mappings.props.renames) {
+		const { component, from, to } = entry;
+		if (!component || !from || !to) continue;
+		// Skip nested paths — these can't be transformed at the attribute level
+		if (from.includes('.') || from.includes('[')) continue;
+		lookup[`${component}.${from}`] = to;
+	}
+	return lookup;
+}
+
+const ALL_RENAMES = buildRenamesLookup();
+
+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;
+
+		nodePath.node.attributes.forEach((attr) => {
+			if (attr.type !== 'JSXAttribute') return;
+
+			const propName = attr.name.name;
+			if (typeof propName !== 'string') return;
+
+			const newPropName = ALL_RENAMES[`${exportedName}.${propName}`];
+			if (!newPropName) return;
+
+			attr.name = j.jsxIdentifier(newPropName);
+			changed = true;
+		});
+	});
+
+	return changed ? root.toSource() : undefined;
+};
+
+module.exports.parser = 'tsx';

package/codemods/v1-to-v2/transforms/prop-value-standardization.js

@@ -4,10 +4,26 @@
  * Standardizes size-related prop values across PDS v1→v2.
  * Driven entirely by props.typeChanges[].migration in mappings.json.
  *
- * Usage:
+ * Usage (all components):
  *   npx jscodeshift -t codemods/v1-to-v2/transforms/prop-value-standardization.js \
  *     --extensions=tsx,ts,jsx,js \
  *     src/
+ *
+ * Usage (single component — recommended for by-component migrations):
+ *   npx jscodeshift -t codemods/v1-to-v2/transforms/prop-value-standardization.js \
+ *     --only=Spinner \
+ *     --extensions=tsx,ts,jsx,js \
+ *     src/
+ *
+ * Usage (multiple components):
+ *   npx jscodeshift -t codemods/v1-to-v2/transforms/prop-value-standardization.js \
+ *     --only=Spinner,Avatar \
+ *     --extensions=tsx,ts,jsx,js \
+ *     src/
+ *
+ * --only accepts a comma-separated list of exported component names. When
+ * provided, only rules for those components are applied. This prevents the
+ * transform from rewriting size values on components that are still on V1.
  */
 
 const path = require('path');
@@ -43,10 +59,22 @@ function buildMigrationLookup() {
 
 const MIGRATION_LOOKUP = buildMigrationLookup();
 
-module.exports = function transform(file, api) {
+module.exports = function transform(file, api, options) {
 	const j = api.jscodeshift;
 	const root = j(file.source);
 
+	// Parse --only flag into a Set of component names for O(1) lookup.
+	// Accepts comma-separated values: --only=Spinner,Avatar
+	const onlyComponents =
+		options && options.only
+			? new Set(
+					options.only
+						.split(',')
+						.map((s) => s.trim())
+						.filter(Boolean),
+				)
+			: null;
+
 	// Map local import name → exported component name
 	// Handles aliased imports: import { Spinner as MySpinner } → { MySpinner: 'Spinner' }
 	const localToExported = new Map();
@@ -73,6 +101,9 @@ module.exports = function transform(file, api) {
 		const exportedName = localToExported.get(nameNode.name);
 		if (!exportedName) return;
 
+		// Skip this component if --only is set and it isn't in the list
+		if (onlyComponents && !onlyComponents.has(exportedName)) return;
+
 		nodePath.node.attributes.forEach((attr) => {
 			if (attr.type !== 'JSXAttribute' || !attr.value) return;
 

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/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

@@ -3,4 +3,5 @@ export declare const reactExample = "export const ControlledExample = () => {\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/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/Dropdown/Dropdown.d.ts

@@ -25,9 +25,11 @@ export declare const Dropdown: {
     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, description, disabled, icon, index, isActive, isCritical, onClick, 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'> {
     /**
@@ -91,6 +93,40 @@ export interface DropdownItemProps extends ComponentPropsWithoutRef<'li'> {
      */
     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.
@@ -138,3 +174,13 @@ export interface DropdownFilterProps extends ComponentPropsWithoutRef<'li'> {
      */
     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/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/SiteFooter/SiteFooter.d.ts

@@ -15,7 +15,10 @@ export interface SiteFooterProps extends ComponentPropsWithoutRef<'footer'> {
      */
     className?: string;
     /**
-     * PDS container width.
+     * PDS container width, controlling the footer's max-width and inline padding.
+     * Defaults to 'full' (full width, edge-to-edge, no padding) so the containing
+     * layout or app provides the gutter; set a constrained width (e.g. 'x-wide')
+     * to have the footer constrain and pad itself.
      */
     containerWidth?: ContainerWidth;
     /**

package/dist/components/Tabs/Tabs.d.ts

@@ -30,7 +30,6 @@ interface Tabs {
         type: 'neutral' | 'critical' | 'warning' | 'info' | 'success';
     };
 }
-export type TabsSize = 's' | 'm';
 interface TabsProps extends ComponentPropsWithoutRef<'div'> {
     /**
      * Sets tabset aria label
@@ -52,10 +51,6 @@ interface TabsProps extends ComponentPropsWithoutRef<'div'> {
      * Sets currently selected tab using a zero-based index
      */
     selectedTab?: number;
-    /**
-     * Size of the tabs.
-     */
-    size?: TabsSize;
     /**
      * Array of objects for tab data
      */
@@ -64,5 +59,5 @@ interface TabsProps extends ComponentPropsWithoutRef<'div'> {
 /**
  * Tabs UI component
  */
-export declare const Tabs: ({ ariaLabel, className, defaultSelected, onActiveTabChange, selectedTab, size, tabs, ...props }: TabsProps) => import("react/jsx-runtime").JSX.Element;
+export declare const Tabs: ({ ariaLabel, className, defaultSelected, onActiveTabChange, selectedTab, tabs, ...props }: TabsProps) => import("react/jsx-runtime").JSX.Element;
 export {};

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

@@ -42,7 +42,7 @@ interface TooltipProps extends ComponentPropsWithoutRef<'div'> {
     /**
      * Size of the trigger icon. Uses PDS Icon sizing.
      */
-    triggerIconSize?: 'xs' | 's' | 'm' | 'l';
+    triggerIconSize?: 's' | 'm' | 'l';
     /**
      * Z-index value for the tooltip container. In most cases, the default value should be retained.
      */

package/dist/components/UtilityBar/UtilityBar.d.ts

@@ -1,8 +1,7 @@
 import { ComponentPropsWithoutRef, ReactNode } from 'react';
-import { GridGapOptions } from '../../libs/types/layout-types';
+import { PaddingScale } from '../../libs/types/layout-types';
 import './utility-bar.css';
 type UtilityBarBackground = 'default' | 'default-secondary' | 'transparent';
-type UtilityBarPadding = GridGapOptions | 'none';
 export interface UtilityBarProps extends ComponentPropsWithoutRef<'div'> {
     /**
      * Background color of the utility bar.
@@ -21,7 +20,7 @@ export interface UtilityBarProps extends ComponentPropsWithoutRef<'div'> {
     /**
      * Internal padding. Defaults to 'none'.
      */
-    padding?: UtilityBarPadding;
+    padding?: PaddingScale;
 }
 export declare const UtilityBar: ({ backgroundColor, children, className, padding, ...props }: UtilityBarProps) => import("react/jsx-runtime").JSX.Element;
 export {};

package/dist/components/badges/StatusBadge/StatusBadge.d.ts

@@ -27,8 +27,9 @@ export interface StatusBadgeProps extends ComponentPropsWithoutRef<'div'> {
     statusIndicatorText?: string;
     /**
      * Status type for badge. Only renders if `hasStatusIndicator` is true.
+     * Use `'working'` to show a spinner in place of the status dot.
      */
-    statusType?: StatusType | 'frozen' | 'disabled';
+    statusType?: StatusType | 'frozen' | 'disabled' | 'working';
 }
 /**
  * StatusBadge UI component

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

@@ -17,9 +17,9 @@ export interface CloseButtonProps extends ComponentPropsWithoutRef<'button'> {
      */
     onClick?: (e: React.MouseEvent<HTMLButtonElement>) => void;
     /**
-     * Size of the icon.
+     * Size of the button.
      */
-    size?: 'm' | 'l' | 'xl';
+    size?: 's' | 'm' | 'l';
 }
 /**
  * CloseButton UI component