@porsche-design-system/components-react 4.6.0-rc.0 → 4.6.0-rc.2

package/bin/pds-skill.js

@@ -1,13 +1,16 @@
 #!/usr/bin/env node
 
-// Links a locally installed Porsche Design System wrapper skill into the consumer project. Every
-// wrapper exposes this same bin through the local node_modules/.bin directory; --package selects
-// which installed wrapper supplies the skill, independently of which wrapper supplies the bin.
+// Links locally installed Porsche Design System wrapper skills into the consumer project.
+// Every wrapper package exposes this same bin through the local node_modules/.bin directory;
+// --package selects which installed wrapper supplies the skills, independently of which
+// wrapper supplies the bin.
 //
-// --location is the destination parent directory for the link (e.g. `.claude/skills`, `.agents`,
-// `.github/skills`). Relative locations resolve from the cwd.
+// --location is the destination parent directory for the skill links (e.g. `.claude/skills`,
+// `.agents`, `.github/skills`). Relative locations resolve from the cwd.
 //
-//   pds-skill --package <package> --location <dir>
+// --skill may be repeated to install only named skills. Omit it to install all discovered skills.
+//
+//   pds-skill --package <package> --location <dir> [--skill <name>...]
 //
 // This is the canonical source copied into all four wrapper package distributions by their
 // `build:subPackages:skill:bin` steps.
@@ -23,13 +26,14 @@ const SUPPORTED_PACKAGES = [
   '@porsche-design-system/components-vue',
 ];
 const USAGE = [
-  'Usage: pds-skill --package <package> --location <dir>',
+  'Usage: pds-skill --package <package> --location <dir> [--skill <name>...]',
   '',
   'Required options:',
   '  -p, --package <package>  locally installed Porsche Design System wrapper',
-  '  -l, --location <dir>     destination parent directory for the skill link',
+  '  -l, --location <dir>     destination parent directory for the skill links',
   '',
   'Options:',
+  '  -s, --skill <name>       install only the named skill (repeatable); omit to install all',
   '  -h, --help               print this usage',
   '',
   `Supported packages: ${SUPPORTED_PACKAGES.join(', ')}`,
@@ -50,6 +54,7 @@ const parseOptions = (args) => {
       options: {
         package: { type: 'string', short: 'p' },
         location: { type: 'string', short: 'l' },
+        skill: { type: 'string', short: 's', multiple: true },
         help: { type: 'boolean', short: 'h' },
       },
       strict: true,
@@ -60,8 +65,6 @@ const parseOptions = (args) => {
   }
 };
 
-const linkNameFromPackage = (packageName) => packageName.slice(1).replace('/', '-');
-
 const readPackageManifest = (packageJsonPath) => {
   let content;
   try {
@@ -86,7 +89,21 @@ const readPackageManifest = (packageJsonPath) => {
   }
 };
 
-const validateSkillEntry = (skillMdPath) => {
+/** Parse the frontmatter `name:` value from SKILL.md content. Returns null if not found. */
+const parseFrontmatterName = (content) => {
+  const fmMatch = content.match(/^---\n([\s\S]*?)\n---/);
+  if (!fmMatch) {
+    return null;
+  }
+  const nameMatch = fmMatch[1].match(/^name:\s*(\S+)/m);
+  return nameMatch ? nameMatch[1] : null;
+};
+
+/**
+ * Validate that the SKILL.md at skillMdPath is a readable regular file with a frontmatter name
+ * matching expectedName. Calls fail() on any violation.
+ */
+const validateSkillMd = (skillMdPath, expectedName) => {
   let stats;
   try {
     stats = fs.statSync(skillMdPath);
@@ -104,18 +121,45 @@ const validateSkillEntry = (skillMdPath) => {
     fail(`${skillMdPath} is not a file. Reinstall the package and re-run.`);
   }
 
+  let content;
   try {
-    const descriptor = fs.openSync(skillMdPath, 'r');
-    fs.closeSync(descriptor);
+    content = fs.readFileSync(skillMdPath, 'utf8');
   } catch (error) {
     if (isPermissionError(error)) {
       fail(`Cannot read ${skillMdPath}: permission denied. Check the package permissions and re-run.`);
     }
     throw error;
   }
+
+  const name = parseFrontmatterName(content);
+  if (name !== expectedName) {
+    fail(
+      `${skillMdPath} has frontmatter name "${name ?? '(none)'}" but its directory is "${expectedName}". Reinstall the package and re-run.`
+    );
+  }
+};
+
+/** Preflight the destination link path. Fails if something other than a symlink (or nothing) exists there. */
+const preflightDestLink = (linkPath, show) => {
+  let existing;
+  try {
+    existing = fs.lstatSync(linkPath);
+  } catch (error) {
+    if (error.code === 'ENOENT') {
+      return;
+    }
+    if (isPermissionError(error)) {
+      fail(`Cannot inspect ${show(linkPath)}: permission denied. Check the destination permissions and re-run.`);
+    }
+    throw error;
+  }
+  if (!existing.isSymbolicLink()) {
+    fail(`Refusing to replace ${show(linkPath)}: it exists and is not a symlink. Remove it manually and re-run.`);
+  }
 };
 
-const skillDirFromPackage = (packageName, cwd) => {
+/** Resolve the installed package directory by walking up from cwd. Fails if not found. */
+const resolvePackageDir = (packageName, cwd) => {
   if (!SUPPORTED_PACKAGES.includes(packageName)) {
     fail(`Unsupported package: ${packageName}\n${USAGE}`);
   }
@@ -130,9 +174,7 @@ const skillDirFromPackage = (packageName, cwd) => {
       if (installedName !== packageName) {
         fail(`Expected ${packageName} at ${packageDir}, but found ${installedName || 'a package without a name'}.`);
       }
-      const skillDir = path.join(packageDir, 'skill');
-      validateSkillEntry(path.join(skillDir, 'SKILL.md'));
-      return skillDir;
+      return packageDir;
     }
 
     const parent = path.dirname(dir);
@@ -143,20 +185,36 @@ const skillDirFromPackage = (packageName, cwd) => {
   }
 };
 
+/** Discover sorted child directory names under skillsDir. Returns empty array if the dir is absent. */
+const discoverSkillNames = (skillsDir) => {
+  let entries;
+  try {
+    entries = fs.readdirSync(skillsDir, { withFileTypes: true });
+  } catch (error) {
+    if (isMissingPathError(error)) {
+      return [];
+    }
+    if (isPermissionError(error)) {
+      fail(`Cannot read ${skillsDir}: permission denied. Check the package permissions and re-run.`);
+    }
+    throw error;
+  }
+  return entries
+    .filter((e) => e.isDirectory())
+    .map((e) => e.name)
+    .sort();
+};
+
 const main = () => {
   const options = parseOptions(process.argv.slice(2));
   if (options.help) {
     console.log(USAGE);
     return;
   }
-  const missingOptions = [
-    !options.package && '--package',
-    !options.location && '--location',
-  ].filter(Boolean);
+
+  const missingOptions = [!options.package && '--package', !options.location && '--location'].filter(Boolean);
   if (missingOptions.length > 0) {
-    fail(
-      `Missing required option${missingOptions.length > 1 ? 's' : ''}: ${missingOptions.join(' and ')}\n${USAGE}`
-    );
+    fail(`Missing required option${missingOptions.length > 1 ? 's' : ''}: ${missingOptions.join(' and ')}\n${USAGE}`);
   }
 
   if (process.versions.pnp) {
@@ -168,92 +226,121 @@ const main = () => {
   const cwd = process.cwd();
   const packageName = options.package;
   const destArg = options.location;
-  const skillDir = skillDirFromPackage(packageName, cwd);
-  const linkName = linkNameFromPackage(packageName);
+  const requestedSkills = options.skill ?? [];
+
+  const packageDir = resolvePackageDir(packageName, cwd);
+  const skillsDir = path.join(packageDir, 'skills');
+  const discovered = discoverSkillNames(skillsDir);
+
+  if (discovered.length === 0) {
+    fail(`The installed package does not ship any skills at ${skillsDir}. Upgrade the package and re-run.`);
+  }
+
+  // Validate --skill filters; unknown names fail clearly.
+  if (requestedSkills.length > 0) {
+    const unknown = requestedSkills.filter((s) => !discovered.includes(s));
+    if (unknown.length > 0) {
+      fail(
+        `Unknown skill${unknown.length > 1 ? 's' : ''}: ${unknown.join(', ')}. ` +
+          `Available: ${[...discovered].sort().join(', ')}.`
+      );
+    }
+  }
+
+  // Deterministic sorted selection.
+  const selected =
+    requestedSkills.length > 0
+      ? [...new Set(requestedSkills)].filter((s) => discovered.includes(s)).sort()
+      : discovered;
 
-  const skillsDir = path.isAbsolute(destArg) ? destArg : path.resolve(cwd, destArg);
-  const linkPath = path.join(skillsDir, linkName);
+  const destDir = path.isAbsolute(destArg) ? destArg : path.resolve(cwd, destArg);
 
-  // Prefer a cwd-relative path in messages; use the absolute path when the link lives outside it.
+  // Prefer a cwd-relative path in messages; fall back to absolute when outside.
   const show = (target) => {
     const rel = path.relative(cwd, target);
     return rel && !rel.startsWith('..') && !path.isAbsolute(rel) ? rel : target;
   };
 
+  // Preflight every selected skill tree before touching the destination at all.
+  for (const skillName of selected) {
+    validateSkillMd(path.join(skillsDir, skillName, 'SKILL.md'), skillName);
+  }
+
   try {
-    fs.mkdirSync(skillsDir, { recursive: true });
+    fs.mkdirSync(destDir, { recursive: true });
   } catch (error) {
     if (error.code === 'ENOTDIR' || error.code === 'EEXIST') {
-      fail(`Cannot create ${show(skillsDir)}: a parent path exists as a file, not a directory. Remove it and re-run.`);
+      fail(`Cannot create ${show(destDir)}: a parent path exists as a file, not a directory. Remove it and re-run.`);
     }
     if (isPermissionError(error)) {
-      fail(`Cannot create ${show(skillsDir)}: permission denied. Check the destination permissions and re-run.`);
+      fail(`Cannot create ${show(destDir)}: permission denied. Check the destination permissions and re-run.`);
     }
     throw error;
   }
 
-  // Idempotent, but only for the symlink we own: repoint an existing symlink (including a
-  // dangling one), and refuse to touch a real directory a user may have hand-maintained here —
-  // never recursively delete it.
-  let existing = null;
-  try {
-    existing = fs.lstatSync(linkPath);
-  } catch (error) {
-    if (error.code === 'ENOENT') {
-      existing = null;
-    } else if (isPermissionError(error)) {
-      fail(`Cannot inspect ${show(linkPath)}: permission denied. Check the destination permissions and re-run.`);
-    } else {
-      throw error;
-    }
+  // Preflight all destination links before any mutation.
+  for (const skillName of selected) {
+    preflightDestLink(path.join(destDir, skillName), show);
   }
-  if (existing) {
-    if (!existing.isSymbolicLink()) {
-      fail(`Refusing to replace ${show(linkPath)}: it exists and is not a symlink. Remove it manually and re-run.`);
-    }
 
+  // All preflights passed — perform link operations.
+  const linkType = process.platform === 'win32' ? 'junction' : 'dir';
+  for (const skillName of selected) {
+    const skillDir = path.join(skillsDir, skillName);
+    const linkPath = path.join(destDir, skillName);
+
+    // Idempotent: repoint an existing symlink (including a dangling one), but never touch a
+    // real directory a user may have hand-maintained — the preflight above already rejected that.
+    let existingLink = null;
     try {
-      if (fs.realpathSync(linkPath) === fs.realpathSync(skillDir)) {
-        console.log(`Porsche Design System skill already linked: ${show(linkPath)} -> ${skillDir}`);
-        return;
-      }
+      existingLink = fs.lstatSync(linkPath);
     } catch (error) {
-      if (error.code === 'ENOENT') {
-        // The existing link is dangling and can be replaced.
-      } else if (isPermissionError(error)) {
-        fail(`Cannot inspect ${show(linkPath)}: permission denied. Check the destination permissions and re-run.`);
-      } else {
+      if (error.code !== 'ENOENT') {
+        throw error;
+      }
+    }
+
+    if (existingLink?.isSymbolicLink()) {
+      try {
+        if (fs.realpathSync(linkPath) === fs.realpathSync(skillDir)) {
+          console.log(`Porsche Design System skill already linked: ${show(linkPath)} -> ${skillDir}`);
+          continue;
+        }
+      } catch (error) {
+        if (error.code !== 'ENOENT') {
+          if (isPermissionError(error)) {
+            fail(`Cannot inspect ${show(linkPath)}: permission denied. Check the destination permissions and re-run.`);
+          }
+          throw error;
+        }
+        // Dangling symlink — fall through to replace it.
+      }
+      try {
+        fs.rmSync(linkPath, { force: true });
+      } catch (error) {
+        if (isPermissionError(error)) {
+          fail(`Cannot replace ${show(linkPath)}: permission denied. Check the destination permissions and re-run.`);
+        }
         throw error;
       }
     }
+
     try {
-      fs.rmSync(linkPath, { force: true });
+      fs.symlinkSync(skillDir, linkPath, linkType);
     } catch (error) {
+      if (process.platform === 'win32' && error.code === 'EPERM') {
+        fail(
+          `Could not create the skill junction on Windows (EPERM). Check the destination permissions or create it manually:\n  mklink /J "${linkPath}" "${skillDir}"`
+        );
+      }
       if (isPermissionError(error)) {
-        fail(`Cannot replace ${show(linkPath)}: permission denied. Check the destination permissions and re-run.`);
+        fail(`Cannot create ${show(linkPath)}: permission denied. Check the destination permissions and re-run.`);
       }
       throw error;
     }
-  }
 
-  // Windows has no unprivileged directory symlink; a junction needs no elevation and works with
-  // the absolute target we already hold. macOS/Linux use a normal directory symlink.
-  const linkType = process.platform === 'win32' ? 'junction' : 'dir';
-  try {
-    fs.symlinkSync(skillDir, linkPath, linkType);
-  } catch (error) {
-    if (process.platform === 'win32' && error.code === 'EPERM') {
-      fail(
-        `Could not create the skill junction on Windows (EPERM). Check the destination permissions or create it manually:\n  mklink /J "${linkPath}" "${skillDir}"`
-      );
-    }
-    if (isPermissionError(error)) {
-      fail(`Cannot create ${show(linkPath)}: permission denied. Check the destination permissions and re-run.`);
-    }
-    throw error;
+    console.log(`Linked Porsche Design System skill: ${show(linkPath)} -> ${skillDir}`);
   }
-
-  console.log(`Linked Porsche Design System skill: ${show(linkPath)} -> ${skillDir}`);
 };
 
 main();

package/cjs/lib/components/ai-tag.wrapper.cjs

@@ -6,7 +6,7 @@ var react = require('react');
 var hooks = require('../../hooks.cjs');
 var utils = require('../../utils.cjs');
 
-const PAiTag = /*#__PURE__*/ react.forwardRef(({ locale = 'en_US', variant = 'generated', className, ...rest }, ref) => {
+const PAiTag = /*#__PURE__*/ react.forwardRef(({ locale = 'en-US', variant = 'generated', className, ...rest }, ref) => {
     const elementRef = react.useRef(undefined);
     const WebComponentTag = hooks.usePrefix('p-ai-tag');
     const propsToSync = [locale, variant];

package/cjs/lib/components/radio-group.wrapper.cjs

@@ -6,7 +6,7 @@ var react = require('react');
 var hooks = require('../../hooks.cjs');
 var utils = require('../../utils.cjs');
 
-const PRadioGroup = /*#__PURE__*/ react.forwardRef(({ compact = false, description = '', direction = 'column', disabled = false, form, hideLabel = false, label = '', loading = false, message = '', name, onBlur, onChange, required = false, state = 'none', value = '', className, ...rest }, ref) => {
+const PRadioGroup = /*#__PURE__*/ react.forwardRef(({ compact = false, description = '', direction = 'column', disabled = false, form, hideLabel = false, label = '', loading = false, message = '', name, onBlur, onChange, required = false, state = 'none', value, className, ...rest }, ref) => {
     const elementRef = react.useRef(undefined);
     hooks.useEventCallback(elementRef, 'blur', onBlur);
     hooks.useEventCallback(elementRef, 'change', onChange);

package/esm/lib/components/ai-tag.wrapper.d.ts

@@ -2,8 +2,8 @@ import type { BaseProps } from '../../BaseProps';
 import type { AiTagLocale, AiTagVariant } from '../types';
 export type PAiTagProps = BaseProps & {
     /**
-     * Locale for the AI text (ISO format, e.g. "de_DE").
-     * @default 'en_US'
+     * Market locale for the AI text (BCP47, e.g. `en-US`). Language-only `en` is supported for international markets. POSIX forms (e.g. `en_US`) are deprecated but still accepted. Copy is resolved by language; unknown languages fall back to English.
+     * @default 'en-US'
      */
     locale?: AiTagLocale;
     /**
@@ -14,8 +14,8 @@ export type PAiTagProps = BaseProps & {
 };
 export declare const PAiTag: import("react").ForwardRefExoticComponent<Omit<import("react").DOMAttributes<{}>, "onChange" | "onInput" | "onToggle"> & Pick<import("react").HTMLAttributes<{}>, "suppressHydrationWarning" | "autoFocus" | "className" | "dir" | "hidden" | "id" | "inert" | "inputMode" | "lang" | "slot" | "style" | "tabIndex" | "title" | "translate" | "role"> & {
     /**
-     * Locale for the AI text (ISO format, e.g. "de_DE").
-     * @default 'en_US'
+     * Market locale for the AI text (BCP47, e.g. `en-US`). Language-only `en` is supported for international markets. POSIX forms (e.g. `en_US`) are deprecated but still accepted. Copy is resolved by language; unknown languages fall back to English.
+     * @default 'en-US'
      */
     locale?: AiTagLocale;
     /**

package/esm/lib/components/ai-tag.wrapper.mjs

@@ -4,7 +4,7 @@ import { forwardRef, useRef } from 'react';
 import { usePrefix, useBrowserLayoutEffect, useMergedClass } from '../../hooks.mjs';
 import { syncRef } from '../../utils.mjs';
 
-const PAiTag = /*#__PURE__*/ forwardRef(({ locale = 'en_US', variant = 'generated', className, ...rest }, ref) => {
+const PAiTag = /*#__PURE__*/ forwardRef(({ locale = 'en-US', variant = 'generated', className, ...rest }, ref) => {
     const elementRef = useRef(undefined);
     const WebComponentTag = usePrefix('p-ai-tag');
     const propsToSync = [locale, variant];

package/esm/lib/components/input-number.wrapper.d.ts

@@ -66,11 +66,11 @@ export type PInputNumberProps = BaseProps & {
      */
     onBlur?: (event: CustomEvent<InputNumberBlurEventDetail>) => void;
     /**
-     * Emitted when the number input loses focus after its value was changed.
+     * Emitted when the number input loses focus after its value was changed. The component value and native event target value are strings after user input.
      */
     onChange?: (event: CustomEvent<InputNumberChangeEventDetail>) => void;
     /**
-     * Emitted when the value has been changed as a direct result of a user action.
+     * Emitted when the value has been changed as a direct result of a user action. The component value and native event target value are strings.
      */
     onInput?: (event: CustomEvent<InputNumberInputEventDetail>) => void;
     /**
@@ -99,7 +99,7 @@ export type PInputNumberProps = BaseProps & {
      */
     step?: number;
     /**
-     * Sets the current numeric value of the field.
+     * Sets the current numeric value. Strings and numbers are accepted for programmatic assignment, but user input updates the value as a string to mirror native input behavior.
      * @default ''
      */
     value?: string | number | null;
@@ -170,11 +170,11 @@ export declare const PInputNumber: import("react").ForwardRefExoticComponent<Omi
      */
     onBlur?: (event: CustomEvent<InputNumberBlurEventDetail>) => void;
     /**
-     * Emitted when the number input loses focus after its value was changed.
+     * Emitted when the number input loses focus after its value was changed. The component value and native event target value are strings after user input.
      */
     onChange?: (event: CustomEvent<InputNumberChangeEventDetail>) => void;
     /**
-     * Emitted when the value has been changed as a direct result of a user action.
+     * Emitted when the value has been changed as a direct result of a user action. The component value and native event target value are strings.
      */
     onInput?: (event: CustomEvent<InputNumberInputEventDetail>) => void;
     /**
@@ -203,7 +203,7 @@ export declare const PInputNumber: import("react").ForwardRefExoticComponent<Omi
      */
     step?: number;
     /**
-     * Sets the current numeric value of the field.
+     * Sets the current numeric value. Strings and numbers are accepted for programmatic assignment, but user input updates the value as a string to mirror native input behavior.
      * @default ''
      */
     value?: string | number | null;

package/esm/lib/components/input-text.wrapper.d.ts

@@ -66,11 +66,11 @@ export type PInputTextProps = BaseProps & {
      */
     onBlur?: (event: CustomEvent<InputTextBlurEventDetail>) => void;
     /**
-     * Emitted when the input loses focus after its value was changed.
+     * Emitted when the input loses focus after its value was changed. The component value and native event target value are strings after user input.
      */
     onChange?: (event: CustomEvent<InputTextChangeEventDetail>) => void;
     /**
-     * Emitted on every value change as the user types.
+     * Emitted on every value change as the user types. The component value and native event target value are strings.
      */
     onInput?: (event: CustomEvent<InputTextInputEventDetail>) => void;
     /**
@@ -98,7 +98,7 @@ export type PInputTextProps = BaseProps & {
      */
     state?: InputTextState;
     /**
-     * Sets the current text value of the input field.
+     * Sets the current text value. Numbers are accepted for programmatic assignment, but user input updates the value as a string.
      * @default ''
      */
     value?: string | number | null;
@@ -169,11 +169,11 @@ export declare const PInputText: import("react").ForwardRefExoticComponent<Omit<
      */
     onBlur?: (event: CustomEvent<InputTextBlurEventDetail>) => void;
     /**
-     * Emitted when the input loses focus after its value was changed.
+     * Emitted when the input loses focus after its value was changed. The component value and native event target value are strings after user input.
      */
     onChange?: (event: CustomEvent<InputTextChangeEventDetail>) => void;
     /**
-     * Emitted on every value change as the user types.
+     * Emitted on every value change as the user types. The component value and native event target value are strings.
      */
     onInput?: (event: CustomEvent<InputTextInputEventDetail>) => void;
     /**
@@ -201,7 +201,7 @@ export declare const PInputText: import("react").ForwardRefExoticComponent<Omit<
      */
     state?: InputTextState;
     /**
-     * Sets the current text value of the input field.
+     * Sets the current text value. Numbers are accepted for programmatic assignment, but user input updates the value as a string.
      * @default ''
      */
     value?: string | number | null;

package/esm/lib/components/multi-select-option.wrapper.d.ts

@@ -6,7 +6,7 @@ export type PMultiSelectOptionProps = BaseProps & {
      */
     disabled?: boolean;
     /**
-     * Sets the value submitted with the form data when this option is selected in the parent multi-select.
+     * Sets the required option value submitted with the form data when selected. Must be a string or number.
      */
     value: string | number;
 };
@@ -17,7 +17,7 @@ export declare const PMultiSelectOption: import("react").ForwardRefExoticCompone
      */
     disabled?: boolean;
     /**
-     * Sets the value submitted with the form data when this option is selected in the parent multi-select.
+     * Sets the required option value submitted with the form data when selected. Must be a string or number.
      */
     value: string | number;
 } & {

package/esm/lib/components/pin-code.wrapper.d.ts

@@ -54,7 +54,7 @@ export type PPinCodeProps = BaseProps & {
      */
     onBlur?: (event: CustomEvent<void>) => void;
     /**
-     * Emitted when the pin code value changes as the user types, carrying the new concatenated value in the event detail.
+     * Emitted when the pin code value changes as the user types, carrying `{ value: string; isComplete: boolean }` in the event detail.
      */
     onChange?: (event: CustomEvent<PinCodeChangeEventDetail>) => void;
     /**
@@ -73,10 +73,10 @@ export type PPinCodeProps = BaseProps & {
      */
     type?: PinCodeType;
     /**
-     * Sets the current concatenated value of all pin code fields and allows setting the initial value.
+     * Sets the current concatenated value. Numbers are accepted for programmatic assignment, but user input updates the value as a string.
      * @default ''
      */
-    value?: string;
+    value?: string | number | null;
 };
 export declare const PPinCode: import("react").ForwardRefExoticComponent<Omit<import("react").DOMAttributes<{}>, "onChange" | "onInput" | "onToggle"> & Pick<import("react").HTMLAttributes<{}>, "suppressHydrationWarning" | "autoFocus" | "className" | "dir" | "hidden" | "id" | "inert" | "inputMode" | "lang" | "slot" | "style" | "tabIndex" | "title" | "translate" | "role"> & {
     /**
@@ -132,7 +132,7 @@ export declare const PPinCode: import("react").ForwardRefExoticComponent<Omit<im
      */
     onBlur?: (event: CustomEvent<void>) => void;
     /**
-     * Emitted when the pin code value changes as the user types, carrying the new concatenated value in the event detail.
+     * Emitted when the pin code value changes as the user types, carrying `{ value: string; isComplete: boolean }` in the event detail.
      */
     onChange?: (event: CustomEvent<PinCodeChangeEventDetail>) => void;
     /**
@@ -151,10 +151,10 @@ export declare const PPinCode: import("react").ForwardRefExoticComponent<Omit<im
      */
     type?: PinCodeType;
     /**
-     * Sets the current concatenated value of all pin code fields and allows setting the initial value.
+     * Sets the current concatenated value. Numbers are accepted for programmatic assignment, but user input updates the value as a string.
      * @default ''
      */
-    value?: string;
+    value?: string | number | null;
 } & {
     children?: import("react").ReactNode | undefined;
 } & import("react").RefAttributes<HTMLElement>>;

package/esm/lib/components/radio-group-option.wrapper.d.ts

@@ -15,9 +15,9 @@ export type PRadioGroupOptionProps = BaseProps & {
      */
     loading?: boolean;
     /**
-     * Sets the value submitted with the form data when this radio option is selected within its parent group.
+     * Sets the required option value. Must be a string or number and is selected when it strictly matches the parent `p-radio-group` value by type and value.
      */
-    value?: string;
+    value: string | number;
 };
 export declare const PRadioGroupOption: import("react").ForwardRefExoticComponent<Omit<import("react").DOMAttributes<{}>, "onChange" | "onInput" | "onToggle"> & Pick<import("react").HTMLAttributes<{}>, "suppressHydrationWarning" | "autoFocus" | "className" | "dir" | "hidden" | "id" | "inert" | "inputMode" | "lang" | "slot" | "style" | "tabIndex" | "title" | "translate" | "role"> & {
     /**
@@ -35,9 +35,9 @@ export declare const PRadioGroupOption: import("react").ForwardRefExoticComponen
      */
     loading?: boolean;
     /**
-     * Sets the value submitted with the form data when this radio option is selected within its parent group.
+     * Sets the required option value. Must be a string or number and is selected when it strictly matches the parent `p-radio-group` value by type and value.
      */
-    value?: string;
+    value: string | number;
 } & {
     children?: import("react").ReactNode | undefined;
 } & import("react").RefAttributes<HTMLElement>>;

package/esm/lib/components/radio-group.wrapper.d.ts

@@ -68,10 +68,9 @@ export type PRadioGroupProps = BaseProps & {
      */
     state?: RadioGroupState;
     /**
-     * Sets the currently selected value that pre-selects the matching radio option and reflects user changes.
-     * @default ''
+     * Sets the currently selected value that pre-selects the matching radio option and reflects user changes. Matches an option strictly by type and value, meaning string or number only match an option whose value has the same type and equal value. Use undefined or null for no preselection; these values never match an option because every option requires a string or number value.  Please note that FormData always serializes values as strings, so when participating in a native (uncontrolled) form a number value is restored as string via formStateRestoreCallback and will no longer strictly match a number-typed option. This limitation only applies to native form state restoration; in controlled forms (where the consumer manages value directly via the change event), the number type is preserved end-to-end.
      */
-    value?: string;
+    value?: string | number | null;
 };
 export declare const PRadioGroup: import("react").ForwardRefExoticComponent<Omit<import("react").DOMAttributes<{}>, "onChange" | "onInput" | "onToggle"> & Pick<import("react").HTMLAttributes<{}>, "suppressHydrationWarning" | "autoFocus" | "className" | "dir" | "hidden" | "id" | "inert" | "inputMode" | "lang" | "slot" | "style" | "tabIndex" | "title" | "translate" | "role"> & {
     /**
@@ -141,10 +140,9 @@ export declare const PRadioGroup: import("react").ForwardRefExoticComponent<Omit
      */
     state?: RadioGroupState;
     /**
-     * Sets the currently selected value that pre-selects the matching radio option and reflects user changes.
-     * @default ''
+     * Sets the currently selected value that pre-selects the matching radio option and reflects user changes. Matches an option strictly by type and value, meaning string or number only match an option whose value has the same type and equal value. Use undefined or null for no preselection; these values never match an option because every option requires a string or number value.  Please note that FormData always serializes values as strings, so when participating in a native (uncontrolled) form a number value is restored as string via formStateRestoreCallback and will no longer strictly match a number-typed option. This limitation only applies to native form state restoration; in controlled forms (where the consumer manages value directly via the change event), the number type is preserved end-to-end.
      */
-    value?: string;
+    value?: string | number | null;
 } & {
     children?: import("react").ReactNode | undefined;
 } & import("react").RefAttributes<HTMLElement>>;

package/esm/lib/components/radio-group.wrapper.mjs

@@ -4,7 +4,7 @@ import { forwardRef, useRef } from 'react';
 import { useEventCallback, usePrefix, useBrowserLayoutEffect, useMergedClass } from '../../hooks.mjs';
 import { syncRef } from '../../utils.mjs';
 
-const PRadioGroup = /*#__PURE__*/ forwardRef(({ compact = false, description = '', direction = 'column', disabled = false, form, hideLabel = false, label = '', loading = false, message = '', name, onBlur, onChange, required = false, state = 'none', value = '', className, ...rest }, ref) => {
+const PRadioGroup = /*#__PURE__*/ forwardRef(({ compact = false, description = '', direction = 'column', disabled = false, form, hideLabel = false, label = '', loading = false, message = '', name, onBlur, onChange, required = false, state = 'none', value, className, ...rest }, ref) => {
     const elementRef = useRef(undefined);
     useEventCallback(elementRef, 'blur', onBlur);
     useEventCallback(elementRef, 'change', onChange);