@pingux/astro 2.211.0-alpha.0 → 2.212.1-alpha.0

package/lib/cjs/components/LabelValuePairs/LabelValuePairs.d.ts

@@ -0,0 +1,14 @@
+import React from 'react';
+import PairLabel from './LabelValuePairsLabel';
+import Pair from './LabelValuePairsRow';
+import PairSubvalue from './LabelValuePairsSubvalue';
+import PairValue from './LabelValuePairsValue';
+declare const LabelValuePairs: React.ForwardRefExoticComponent<import("../../index").LabelValuePairsContainerProps & React.RefAttributes<HTMLElement>>;
+declare const LabelValuePairsWithSubcomponents: typeof LabelValuePairs & {
+    Row: typeof Pair;
+    Label: typeof PairLabel;
+    Value: typeof PairValue;
+    Subvalue: typeof PairSubvalue;
+};
+export default LabelValuePairsWithSubcomponents;
+export { Pair, PairLabel, PairSubvalue, PairValue, };

package/lib/cjs/components/LabelValuePairs/LabelValuePairs.js

@@ -0,0 +1,70 @@
+"use strict";
+
+var _typeof = require("@babel/runtime-corejs3/helpers/typeof");
+var _WeakMap = require("@babel/runtime-corejs3/core-js-stable/weak-map");
+var _Object$defineProperty = require("@babel/runtime-corejs3/core-js-stable/object/define-property");
+var _Object$getOwnPropertyDescriptor = require("@babel/runtime-corejs3/core-js-stable/object/get-own-property-descriptor");
+var _interopRequireDefault = require("@babel/runtime-corejs3/helpers/interopRequireDefault");
+_Object$defineProperty(exports, "__esModule", {
+  value: true
+});
+_Object$defineProperty(exports, "Pair", {
+  enumerable: true,
+  get: function get() {
+    return _LabelValuePairsRow["default"];
+  }
+});
+_Object$defineProperty(exports, "PairLabel", {
+  enumerable: true,
+  get: function get() {
+    return _LabelValuePairsLabel["default"];
+  }
+});
+_Object$defineProperty(exports, "PairSubvalue", {
+  enumerable: true,
+  get: function get() {
+    return _LabelValuePairsSubvalue["default"];
+  }
+});
+_Object$defineProperty(exports, "PairValue", {
+  enumerable: true,
+  get: function get() {
+    return _LabelValuePairsValue["default"];
+  }
+});
+exports["default"] = void 0;
+var _extends2 = _interopRequireDefault(require("@babel/runtime-corejs3/helpers/extends"));
+var _objectWithoutProperties2 = _interopRequireDefault(require("@babel/runtime-corejs3/helpers/objectWithoutProperties"));
+var _react = _interopRequireWildcard(require("react"));
+var _index = require("../../index");
+var _LabelValuePairsLabel = _interopRequireDefault(require("./LabelValuePairsLabel"));
+var _LabelValuePairsRow = _interopRequireDefault(require("./LabelValuePairsRow"));
+var _LabelValuePairsSubvalue = _interopRequireDefault(require("./LabelValuePairsSubvalue"));
+var _LabelValuePairsValue = _interopRequireDefault(require("./LabelValuePairsValue"));
+var _react2 = require("@emotion/react");
+var _excluded = ["children"];
+function _interopRequireWildcard(e, t) { if ("function" == typeof _WeakMap) var r = new _WeakMap(), n = new _WeakMap(); return (_interopRequireWildcard = function _interopRequireWildcard(e, t) { if (!t && e && e.__esModule) return e; var o, i, f = { __proto__: null, "default": e }; if (null === e || "object" != _typeof(e) && "function" != typeof e) return f; if (o = t ? n : r) { if (o.has(e)) return o.get(e); o.set(e, f); } for (var _t in e) "default" !== _t && {}.hasOwnProperty.call(e, _t) && ((i = (o = _Object$defineProperty) && _Object$getOwnPropertyDescriptor(e, _t)) && (i.get || i.set) ? o(f, _t, i) : f[_t] = e[_t]); return f; })(e, t); }
+var displayName = 'LabelValuePairs';
+var LabelValuePairs = /*#__PURE__*/(0, _react.forwardRef)(function (props, ref) {
+  var children = props.children,
+    others = (0, _objectWithoutProperties2["default"])(props, _excluded);
+  return (0, _react2.jsx)(_index.Box, (0, _extends2["default"])({
+    ref: ref,
+    variant: "labelValuePairs.container"
+  }, others), children);
+});
+LabelValuePairs.displayName = displayName;
+
+// The subcomponents are exported bare under a `Pair*` naming family (`Pair`, `PairLabel`,
+// `PairValue`, `PairSubvalue`) as the primary, terser usage — the short `Row`/`Label` names
+// can't be exported bare from the top-level barrel (`libs/astro/src/index.ts`) because they
+// already resolve to unrelated exports there: `Label` (a form-label component) and `Row`
+// (from react-stately). Prefixing sidesteps that collision. Static properties are also
+// attached so the namespaced `<LabelValuePairs.Row>` / `.Label` / `.Value` / `.Subvalue`
+// access keeps working; inside the namespace the short names are unambiguous.
+var LabelValuePairsWithSubcomponents = LabelValuePairs;
+LabelValuePairsWithSubcomponents.Row = _LabelValuePairsRow["default"];
+LabelValuePairsWithSubcomponents.Label = _LabelValuePairsLabel["default"];
+LabelValuePairsWithSubcomponents.Value = _LabelValuePairsValue["default"];
+LabelValuePairsWithSubcomponents.Subvalue = _LabelValuePairsSubvalue["default"];
+var _default = exports["default"] = LabelValuePairsWithSubcomponents;

package/lib/cjs/components/LabelValuePairs/LabelValuePairs.mdx

@@ -0,0 +1,69 @@
+import { Meta } from '@storybook/addon-docs/blocks';
+import * as LabelValuePairsStories from './LabelValuePairs.stories';
+
+<Meta of={LabelValuePairsStories} isTemplate />
+
+# LabelValuePairs
+
+LabelValuePairs renders a vertical list of labelled key/value rows. It is intended for read-only detail views such as slide-over panels, summary tabs, and profile pages.
+
+Pairs are composed from child components. Each pair supports four value display modes, an optional help hint tooltip, a secondary sub-label, and an optional inline label icon or action element. Pairs with a falsy value are suppressed unless the pair is in a loading state.
+
+```jsx
+import { Icon, LabelValuePairs, Pair, PairLabel, PairValue, PairSubvalue } from '@pingux/astro';
+
+<LabelValuePairs>
+  <Pair>
+    <PairLabel helpHint="...">
+      Username
+      <Icon aria-hidden="true" title={{ name: '' }} icon={InformationIcon} />
+    </PairLabel>
+    <PairSubvalue>Optional secondary text</PairSubvalue>
+    <PairValue valueType={ValueTypes.COPYABLE}>jsmith</PairValue>
+  </Pair>
+</LabelValuePairs>
+```
+
+### Required Components
+
+`LabelValuePairs` is a public composition API, not a standalone data-driven component. Each pair must be composed from these building blocks, available both as named exports (`Pair`, `PairLabel`, `PairValue`, `PairSubvalue`) and, equivalently, as static properties on the parent (`LabelValuePairs.Row`, `.Label`, `.Value`, `.Subvalue`):
+
+- **`Pair`** — wraps one labelled entry. Expects a `PairLabel`, optionally a `PairSubvalue`, and a `PairValue` as children. Suppresses itself (renders nothing) when its `PairValue` child's content is falsy and not loading.
+- **`PairLabel`** — the pair's heading text, rendered as an `<h5>`. Accepts an optional `helpHint` prop. Its first child is the label text; an optional second child renders alongside it as an icon or action element (e.g. an `Icon` or `IconButton`).
+- **`PairValue`** — the pair's value content. Accepts `valueType` (see Value Types below) and `isLoading`.
+- **`PairSubvalue`** — optional secondary text rendered beneath the label.
+
+### Value Types
+
+Use the exported `ValueTypes` constant to select the display mode for a `PairValue`'s content.
+
+| `valueType` | Behavior |
+| ---- | --------- |
+| _(omitted)_ | Renders the value as plain `Text`. |
+| `ValueTypes.COPYABLE` | Wraps the value in `CopyText`, adding a copy-to-clipboard button. |
+| `ValueTypes.MASKED` | Displays bullet characters by default. An eye toggle reveals or hides the real value. |
+| `ValueTypes.ELEMENT` | Renders `Value`'s children directly as a React node — use for custom content. |
+
+### Loading State
+
+Set `isLoading` on `PairValue` to replace the value area with a skeleton placeholder. The pair still renders its label normally, and it renders even when `PairValue` has no children — useful when data is being fetched.
+
+### Accessibility
+
+This component adheres to standard heading and landmark semantics.
+
+#### Keyboard Navigation
+
+| Keys | Functions |
+| ---- | --------- |
+| Tab | Moves focus through interactive elements: copy buttons, masked value toggles, and help hint triggers. |
+| Space or Enter | Activates the focused button (copy, show/hide, or help hint). |
+| Escape | Closes an open help hint popover. |
+
+#### Screen Readers
+
+This component uses the following attributes to assist screen readers:
+- Each label heading is rendered as an **`<h5>`** element, preserving document outline semantics.
+- The `helpHint` trigger button uses **`aria-label`** derived from the row label (e.g. `"Client ID help hint"`).
+- The masked value toggle uses **`aria-label="Show content"`** or **`"Hide content"`** to reflect the current state.
+- Loading rows use **`role="alert"`** and **`aria-live="assertive"`** on the skeleton container so screen readers announce when content becomes available.

package/lib/cjs/components/LabelValuePairs/LabelValuePairs.stories.js

@@ -0,0 +1,109 @@
+"use strict";
+
+var _Object$keys = require("@babel/runtime-corejs3/core-js-stable/object/keys");
+var _Object$getOwnPropertySymbols = require("@babel/runtime-corejs3/core-js-stable/object/get-own-property-symbols");
+var _filterInstanceProperty = require("@babel/runtime-corejs3/core-js-stable/instance/filter");
+var _Object$getOwnPropertyDescriptor = require("@babel/runtime-corejs3/core-js-stable/object/get-own-property-descriptor");
+var _forEachInstanceProperty = require("@babel/runtime-corejs3/core-js-stable/instance/for-each");
+var _Object$getOwnPropertyDescriptors = require("@babel/runtime-corejs3/core-js-stable/object/get-own-property-descriptors");
+var _Object$defineProperties = require("@babel/runtime-corejs3/core-js-stable/object/define-properties");
+var _Object$defineProperty = require("@babel/runtime-corejs3/core-js-stable/object/define-property");
+var _interopRequireDefault = require("@babel/runtime-corejs3/helpers/interopRequireDefault");
+_Object$defineProperty(exports, "__esModule", {
+  value: true
+});
+exports["default"] = exports.WithSubLabel = exports.WithMaskedValue = exports.WithLoadingState = exports.WithLabelIcon = exports.WithHelpHint = exports.WithCopyableValues = exports.Default = void 0;
+var _defineProperty2 = _interopRequireDefault(require("@babel/runtime-corejs3/helpers/defineProperty"));
+var _react = _interopRequireDefault(require("react"));
+var _CheckIcon = _interopRequireDefault(require("@pingux/mdi-react/CheckIcon"));
+var _storybookDocsLayout = _interopRequireDefault(require("../../../.storybook/storybookDocsLayout"));
+var _ = require("../..");
+var _hooks = require("../../hooks");
+var _figmaLinks = require("../../utils/designUtils/figmaLinks");
+var _statuses = _interopRequireDefault(require("../../utils/devUtils/constants/statuses"));
+var _LabelValuePairs = _interopRequireDefault(require("./LabelValuePairs.mdx"));
+var _labelValuePairsAttributes = require("./labelValuePairsAttributes");
+var _react2 = require("@emotion/react");
+function ownKeys(e, r) { var t = _Object$keys(e); if (_Object$getOwnPropertySymbols) { var o = _Object$getOwnPropertySymbols(e); r && (o = _filterInstanceProperty(o).call(o, function (r) { return _Object$getOwnPropertyDescriptor(e, r).enumerable; })), t.push.apply(t, o); } return t; }
+function _objectSpread(e) { for (var r = 1; r < arguments.length; r++) { var _context, _context2; var t = null != arguments[r] ? arguments[r] : {}; r % 2 ? _forEachInstanceProperty(_context = ownKeys(Object(t), !0)).call(_context, function (r) { (0, _defineProperty2["default"])(e, r, t[r]); }) : _Object$getOwnPropertyDescriptors ? _Object$defineProperties(e, _Object$getOwnPropertyDescriptors(t)) : _forEachInstanceProperty(_context2 = ownKeys(Object(t))).call(_context2, function (r) { _Object$defineProperty(e, r, _Object$getOwnPropertyDescriptor(t, r)); }); } return e; }
+var _default = exports["default"] = {
+  title: 'Components/LabelValuePairs',
+  component: _.LabelValuePairs,
+  parameters: {
+    docs: {
+      page: function page() {
+        return (0, _react2.jsx)(_react["default"].Fragment, null, (0, _react2.jsx)(_LabelValuePairs["default"], null), (0, _react2.jsx)(_storybookDocsLayout["default"], null));
+      }
+    }
+  },
+  argTypes: _objectSpread({}, _labelValuePairsAttributes.labelValuePairsArgTypes)
+};
+var Default = exports.Default = function Default(args) {
+  return (0, _react2.jsx)(_.LabelValuePairs, args, (0, _react2.jsx)(_.Pair, null, (0, _react2.jsx)(_.PairLabel, null, "Username"), (0, _react2.jsx)(_.PairValue, null, "jsmith")), (0, _react2.jsx)(_.Pair, null, (0, _react2.jsx)(_.PairLabel, null, "Email"), (0, _react2.jsx)(_.PairValue, null, "jsmith@example.com")), (0, _react2.jsx)(_.Pair, null, (0, _react2.jsx)(_.PairLabel, null, "Role"), (0, _react2.jsx)(_.PairValue, null, "Administrator")));
+};
+Default.parameters = {
+  design: {
+    type: 'figma',
+    url: _figmaLinks.FIGMA_LINKS.labelValuePairs["default"]
+  }
+};
+var WithCopyableValues = exports.WithCopyableValues = function WithCopyableValues(args) {
+  return (0, _react2.jsx)(_.LabelValuePairs, args, (0, _react2.jsx)(_.Pair, null, (0, _react2.jsx)(_.PairLabel, null, "API Key"), (0, _react2.jsx)(_.PairValue, {
+    valueType: _.ValueTypes.COPYABLE
+  }, "abc123def456ghi789")), (0, _react2.jsx)(_.Pair, null, (0, _react2.jsx)(_.PairLabel, null, "Client Secret"), (0, _react2.jsx)(_.PairValue, {
+    valueType: _.ValueTypes.COPYABLE
+  }, "supersecretvalue")));
+};
+var WithMaskedValue = exports.WithMaskedValue = function WithMaskedValue(args) {
+  return (0, _react2.jsx)(_.LabelValuePairs, args, (0, _react2.jsx)(_.Pair, null, (0, _react2.jsx)(_.PairLabel, null, "Password"), (0, _react2.jsx)(_.PairValue, {
+    valueType: _.ValueTypes.MASKED
+  }, "mypassword123")));
+};
+var WithHelpHint = exports.WithHelpHint = function WithHelpHint(args) {
+  return (0, _react2.jsx)(_.LabelValuePairs, args, (0, _react2.jsx)(_.Pair, null, (0, _react2.jsx)(_.PairLabel, {
+    helpHint: "This is the unique identifier for your OAuth application."
+  }, "Client ID"), (0, _react2.jsx)(_.PairValue, null, "client-abc-123")));
+};
+var WithSubLabel = exports.WithSubLabel = function WithSubLabel(args) {
+  return (0, _react2.jsx)(_.LabelValuePairs, args, (0, _react2.jsx)(_.Pair, null, (0, _react2.jsx)(_.PairLabel, null, "Domain"), (0, _react2.jsx)(_.PairSubvalue, null, "The primary domain for your environment."), (0, _react2.jsx)(_.PairValue, null, "example.com")));
+};
+var WithLabelIcon = exports.WithLabelIcon = function WithLabelIcon(args) {
+  var _useGetTheme = (0, _hooks.useGetTheme)(),
+    isOnyx = _useGetTheme.themeState.isOnyx;
+  var icon = isOnyx ? (0, _react2.jsx)(_.IconWrapper, {
+    icon: _CheckIcon["default"],
+    color: "green",
+    size: "xs",
+    isCircle: true,
+    title: {
+      name: 'Verified'
+    },
+    iconProps: {
+      size: 'sm'
+    }
+  }) : (0, _react2.jsx)(_.NoticeIcon, {
+    color: "green",
+    status: _statuses["default"].SUCCESS,
+    "aria-label": "".concat(_statuses["default"].SUCCESS, "-icon"),
+    size: "xs"
+  });
+  return (0, _react2.jsx)(_.LabelValuePairs, args, (0, _react2.jsx)(_.Pair, null, (0, _react2.jsx)(_.PairLabel, null, "Status", (0, _react2.jsx)(_.Box, {
+    isRow: true,
+    gap: "xs",
+    alignItems: "center"
+  }, icon, (0, _react2.jsx)(_.Text, {
+    variant: "listSubtitle",
+    color: isOnyx ? 'darkgreen' : 'green'
+  }, "Verified"))), (0, _react2.jsx)(_.PairValue, null, "Active")));
+};
+var WithLoadingState = exports.WithLoadingState = function WithLoadingState(args) {
+  return (0, _react2.jsx)(_.Box, {
+    width: "200px"
+  }, (0, _react2.jsx)(_.LabelValuePairs, args, (0, _react2.jsx)(_.Pair, null, (0, _react2.jsx)(_.PairLabel, null, "Username"), (0, _react2.jsx)(_.PairValue, {
+    isLoading: true
+  })), (0, _react2.jsx)(_.Pair, null, (0, _react2.jsx)(_.PairLabel, null, "Email"), (0, _react2.jsx)(_.PairValue, {
+    isLoading: true
+  })), (0, _react2.jsx)(_.Pair, null, (0, _react2.jsx)(_.PairLabel, null, "Role"), (0, _react2.jsx)(_.PairValue, {
+    isLoading: true
+  }))));
+};

package/lib/cjs/components/LabelValuePairs/LabelValuePairs.styles.d.ts

@@ -0,0 +1,18 @@
+declare const _default: {
+    container: {
+        gap: string;
+    };
+    fieldItem: {
+        gap: string;
+    };
+    value: {
+        fontWeight: number;
+        color: string;
+    };
+    subLabel: {
+        fontSize: string;
+        fontWeight: number;
+        color: string;
+    };
+};
+export default _default;

package/lib/cjs/components/LabelValuePairs/LabelValuePairs.styles.js

@@ -0,0 +1,28 @@
+"use strict";
+
+var _Object$defineProperty = require("@babel/runtime-corejs3/core-js-stable/object/define-property");
+_Object$defineProperty(exports, "__esModule", {
+  value: true
+});
+exports["default"] = void 0;
+var container = {
+  gap: 'md'
+};
+var fieldItem = {
+  gap: 'xs'
+};
+var value = {
+  fontWeight: 0,
+  color: 'secondary'
+};
+var subLabel = {
+  fontSize: 'sm',
+  fontWeight: 0,
+  color: 'secondary'
+};
+var _default = exports["default"] = {
+  container: container,
+  fieldItem: fieldItem,
+  value: value,
+  subLabel: subLabel
+};

package/lib/cjs/components/LabelValuePairs/LabelValuePairs.test.js

@@ -0,0 +1,315 @@
+"use strict";
+
+var _typeof = require("@babel/runtime-corejs3/helpers/typeof");
+var _Object$keys = require("@babel/runtime-corejs3/core-js-stable/object/keys");
+var _Object$getOwnPropertySymbols = require("@babel/runtime-corejs3/core-js-stable/object/get-own-property-symbols");
+var _filterInstanceProperty = require("@babel/runtime-corejs3/core-js-stable/instance/filter");
+var _Object$getOwnPropertyDescriptor = require("@babel/runtime-corejs3/core-js-stable/object/get-own-property-descriptor");
+var _forEachInstanceProperty = require("@babel/runtime-corejs3/core-js-stable/instance/for-each");
+var _Object$getOwnPropertyDescriptors = require("@babel/runtime-corejs3/core-js-stable/object/get-own-property-descriptors");
+var _Object$defineProperties = require("@babel/runtime-corejs3/core-js-stable/object/define-properties");
+var _Object$defineProperty2 = require("@babel/runtime-corejs3/core-js-stable/object/define-property");
+var _Symbol = require("@babel/runtime-corejs3/core-js-stable/symbol");
+var _Object$create = require("@babel/runtime-corejs3/core-js-stable/object/create");
+var _bindInstanceProperty = require("@babel/runtime-corejs3/core-js-stable/instance/bind");
+var _Object$getPrototypeOf = require("@babel/runtime-corejs3/core-js-stable/object/get-prototype-of");
+var _Object$setPrototypeOf = require("@babel/runtime-corejs3/core-js-stable/object/set-prototype-of");
+var _Symbol$asyncIterator = require("@babel/runtime-corejs3/core-js-stable/symbol/async-iterator");
+var _Promise = require("@babel/runtime-corejs3/core-js-stable/promise");
+var _Symbol$iterator = require("@babel/runtime-corejs3/core-js-stable/symbol/iterator");
+var _reverseInstanceProperty = require("@babel/runtime-corejs3/core-js-stable/instance/reverse");
+var _WeakMap = require("@babel/runtime-corejs3/core-js-stable/weak-map");
+var _interopRequireDefault = require("@babel/runtime-corejs3/helpers/interopRequireDefault");
+var _defineProperty2 = _interopRequireDefault(require("@babel/runtime-corejs3/core-js-stable/object/define-property"));
+var _repeat = _interopRequireDefault(require("@babel/runtime-corejs3/core-js-stable/instance/repeat"));
+var _asyncToGenerator2 = _interopRequireDefault(require("@babel/runtime-corejs3/helpers/asyncToGenerator"));
+var _defineProperty3 = _interopRequireDefault(require("@babel/runtime-corejs3/helpers/defineProperty"));
+var _react = _interopRequireDefault(require("react"));
+var _InformationIcon = _interopRequireDefault(require("@pingux/mdi-react/InformationIcon"));
+var _userEvent = _interopRequireDefault(require("@testing-library/user-event"));
+var _index = require("../../index");
+var _testWrapper = require("../../utils/testUtils/testWrapper");
+var _universalComponentTest = require("../../utils/testUtils/universalComponentTest");
+var _ = _interopRequireWildcard(require("."));
+var _react2 = require("@emotion/react");
+function _interopRequireWildcard(e, t) { if ("function" == typeof _WeakMap) var r = new _WeakMap(), n = new _WeakMap(); return (_interopRequireWildcard = function _interopRequireWildcard(e, t) { if (!t && e && e.__esModule) return e; var o, i, f = { __proto__: null, "default": e }; if (null === e || "object" != _typeof(e) && "function" != typeof e) return f; if (o = t ? n : r) { if (o.has(e)) return o.get(e); o.set(e, f); } for (var _t2 in e) "default" !== _t2 && {}.hasOwnProperty.call(e, _t2) && ((i = (o = _Object$defineProperty2) && _Object$getOwnPropertyDescriptor(e, _t2)) && (i.get || i.set) ? o(f, _t2, i) : f[_t2] = e[_t2]); return f; })(e, t); }
+function _regeneratorRuntime() { "use strict"; var r = _regenerator(), e = r.m(_regeneratorRuntime), t = (_Object$getPrototypeOf ? _Object$getPrototypeOf(e) : e.__proto__).constructor; function n(r) { var e = "function" == typeof r && r.constructor; return !!e && (e === t || "GeneratorFunction" === (e.displayName || e.name)); } var o = { "throw": 1, "return": 2, "break": 3, "continue": 3 }; function a(r) { var e, t; return function (n) { e || (e = { stop: function stop() { return t(n.a, 2); }, "catch": function _catch() { return n.v; }, abrupt: function abrupt(r, e) { return t(n.a, o[r], e); }, delegateYield: function delegateYield(r, o, a) { return e.resultName = o, t(n.d, _regeneratorValues(r), a); }, finish: function finish(r) { return t(n.f, r); } }, t = function t(r, _t, o) { n.p = e.prev, n.n = e.next; try { return r(_t, o); } finally { e.next = n.n; } }), e.resultName && (e[e.resultName] = n.v, e.resultName = void 0), e.sent = n.v, e.next = n.n; try { return r.call(this, e); } finally { n.p = e.prev, n.n = e.next; } }; } return (_regeneratorRuntime = function _regeneratorRuntime() { return { wrap: function wrap(e, t, n, o) { return r.w(a(e), t, n, o && _reverseInstanceProperty(o).call(o)); }, isGeneratorFunction: n, mark: r.m, awrap: function awrap(r, e) { return new _OverloadYield(r, e); }, AsyncIterator: _regeneratorAsyncIterator, async: function async(r, e, t, o, u) { return (n(e) ? _regeneratorAsyncGen : _regeneratorAsync)(a(r), e, t, o, u); }, keys: _regeneratorKeys, values: _regeneratorValues }; })(); }
+function _regeneratorValues(e) { if (null != e) { var t = e["function" == typeof _Symbol && _Symbol$iterator || "@@iterator"], r = 0; if (t) return t.call(e); if ("function" == typeof e.next) return e; if (!isNaN(e.length)) return { next: function next() { return e && r >= e.length && (e = void 0), { value: e && e[r++], done: !e }; } }; } throw new TypeError(_typeof(e) + " is not iterable"); }
+function _regeneratorKeys(e) { var n = Object(e), r = []; for (var t in n) r.unshift(t); return function e() { for (; r.length;) if ((t = r.pop()) in n) return e.value = t, e.done = !1, e; return e.done = !0, e; }; }
+function _regeneratorAsync(n, e, r, t, o) { var a = _regeneratorAsyncGen(n, e, r, t, o); return a.next().then(function (n) { return n.done ? n.value : a.next(); }); }
+function _regeneratorAsyncGen(r, e, t, o, n) { return new _regeneratorAsyncIterator(_regenerator().w(r, e, t, o), n || _Promise); }
+function _regeneratorAsyncIterator(t, e) { function n(r, o, i, f) { try { var c = t[r](o), u = c.value; return u instanceof _OverloadYield ? e.resolve(u.v).then(function (t) { n("next", t, i, f); }, function (t) { n("throw", t, i, f); }) : e.resolve(u).then(function (t) { c.value = t, i(c); }, function (t) { return n("throw", t, i, f); }); } catch (t) { f(t); } } var r; this.next || (_regeneratorDefine2(_regeneratorAsyncIterator.prototype), _regeneratorDefine2(_regeneratorAsyncIterator.prototype, "function" == typeof _Symbol && _Symbol$asyncIterator || "@asyncIterator", function () { return this; })), _regeneratorDefine2(this, "_invoke", function (t, o, i) { function f() { return new e(function (e, r) { n(t, i, e, r); }); } return r = r ? r.then(f, f) : f(); }, !0); }
+function _regenerator() { /*! regenerator-runtime -- Copyright (c) 2014-present, Facebook, Inc. -- license (MIT): https://github.com/babel/babel/blob/main/packages/babel-helpers/LICENSE */ var e, t, r = "function" == typeof _Symbol ? _Symbol : {}, n = r.iterator || "@@iterator", o = r.toStringTag || "@@toStringTag"; function i(r, n, o, i) { var c = n && n.prototype instanceof Generator ? n : Generator, u = _Object$create(c.prototype); return _regeneratorDefine2(u, "_invoke", function (r, n, o) { var i, c, u, f = 0, p = o || [], y = !1, G = { p: 0, n: 0, v: e, a: d, f: _bindInstanceProperty(d).call(d, e, 4), d: function d(t, r) { return i = t, c = 0, u = e, G.n = r, a; } }; function d(r, n) { for (c = r, u = n, t = 0; !y && f && !o && t < p.length; t++) { var o, i = p[t], d = G.p, l = i[2]; r > 3 ? (o = l === n) && (u = i[(c = i[4]) ? 5 : (c = 3, 3)], i[4] = i[5] = e) : i[0] <= d && ((o = r < 2 && d < i[1]) ? (c = 0, G.v = n, G.n = i[1]) : d < l && (o = r < 3 || i[0] > n || n > l) && (i[4] = r, i[5] = n, G.n = l, c = 0)); } if (o || r > 1) return a; throw y = !0, n; } return function (o, p, l) { if (f > 1) throw TypeError("Generator is already running"); for (y && 1 === p && d(p, l), c = p, u = l; (t = c < 2 ? e : u) || !y;) { i || (c ? c < 3 ? (c > 1 && (G.n = -1), d(c, u)) : G.n = u : G.v = u); try { if (f = 2, i) { if (c || (o = "next"), t = i[o]) { if (!(t = t.call(i, u))) throw TypeError("iterator result is not an object"); if (!t.done) return t; u = t.value, c < 2 && (c = 0); } else 1 === c && (t = i["return"]) && t.call(i), c < 2 && (u = TypeError("The iterator does not provide a '" + o + "' method"), c = 1); i = e; } else if ((t = (y = G.n < 0) ? u : r.call(n, G)) !== a) break; } catch (t) { i = e, c = 1, u = t; } finally { f = 1; } } return { value: t, done: y }; }; }(r, o, i), !0), u; } var a = {}; function Generator() {} function GeneratorFunction() {} function GeneratorFunctionPrototype() {} t = _Object$getPrototypeOf; var c = [][n] ? t(t([][n]())) : (_regeneratorDefine2(t = {}, n, function () { return this; }), t), u = GeneratorFunctionPrototype.prototype = Generator.prototype = _Object$create(c); function f(e) { return _Object$setPrototypeOf ? _Object$setPrototypeOf(e, GeneratorFunctionPrototype) : (e.__proto__ = GeneratorFunctionPrototype, _regeneratorDefine2(e, o, "GeneratorFunction")), e.prototype = _Object$create(u), e; } return GeneratorFunction.prototype = GeneratorFunctionPrototype, _regeneratorDefine2(u, "constructor", GeneratorFunctionPrototype), _regeneratorDefine2(GeneratorFunctionPrototype, "constructor", GeneratorFunction), GeneratorFunction.displayName = "GeneratorFunction", _regeneratorDefine2(GeneratorFunctionPrototype, o, "GeneratorFunction"), _regeneratorDefine2(u), _regeneratorDefine2(u, o, "Generator"), _regeneratorDefine2(u, n, function () { return this; }), _regeneratorDefine2(u, "toString", function () { return "[object Generator]"; }), (_regenerator = function _regenerator() { return { w: i, m: f }; })(); }
+function _regeneratorDefine2(e, r, n, t) { var i = _Object$defineProperty2; try { i({}, "", {}); } catch (e) { i = 0; } _regeneratorDefine2 = function _regeneratorDefine(e, r, n, t) { function o(r, n) { _regeneratorDefine2(e, r, function (e) { return this._invoke(r, n, e); }); } r ? i ? i(e, r, { value: n, enumerable: !t, configurable: !t, writable: !t }) : e[r] = n : (o("next", 0), o("throw", 1), o("return", 2)); }, _regeneratorDefine2(e, r, n, t); }
+function _OverloadYield(e, d) { this.v = e, this.k = d; }
+function ownKeys(e, r) { var t = _Object$keys(e); if (_Object$getOwnPropertySymbols) { var o = _Object$getOwnPropertySymbols(e); r && (o = _filterInstanceProperty(o).call(o, function (r) { return _Object$getOwnPropertyDescriptor(e, r).enumerable; })), t.push.apply(t, o); } return t; }
+function _objectSpread(e) { for (var r = 1; r < arguments.length; r++) { var _context5, _context6; var t = null != arguments[r] ? arguments[r] : {}; r % 2 ? _forEachInstanceProperty(_context5 = ownKeys(Object(t), !0)).call(_context5, function (r) { (0, _defineProperty3["default"])(e, r, t[r]); }) : _Object$getOwnPropertyDescriptors ? _Object$defineProperties(e, _Object$getOwnPropertyDescriptors(t)) : _forEachInstanceProperty(_context6 = ownKeys(Object(t))).call(_context6, function (r) { _Object$defineProperty2(e, r, _Object$getOwnPropertyDescriptor(t, r)); }); } return e; }
+var originalClipboard = _objectSpread({}, global.navigator.clipboard);
+var getComponent = function getComponent(children) {
+  return (0, _testWrapper.render)((0, _react2.jsx)(_["default"], null, children));
+};
+
+// Needs to be added to each components test file
+(0, _universalComponentTest.universalComponentTests)({
+  renderComponent: function renderComponent(props) {
+    return (0, _react2.jsx)(_["default"], props, (0, _react2.jsx)(_.Pair, null, (0, _react2.jsx)(_.PairLabel, null, "Username"), (0, _react2.jsx)(_.PairValue, null, "jsmith")));
+  }
+});
+test('renders a row for each field with a value', function () {
+  getComponent((0, _react2.jsx)(_.Pair, null, (0, _react2.jsx)(_.PairLabel, null, "Username"), (0, _react2.jsx)(_.PairValue, null, "jsmith")));
+  expect(_testWrapper.screen.getByText('Username')).toBeInTheDocument();
+  expect(_testWrapper.screen.getByText('jsmith')).toBeInTheDocument();
+});
+test('rows with falsy value are not rendered unless isLoading is true', function () {
+  getComponent((0, _react2.jsx)(_react["default"].Fragment, null, (0, _react2.jsx)(_.Pair, null, (0, _react2.jsx)(_.PairLabel, null, "Empty Field"), (0, _react2.jsx)(_.PairValue, null)), (0, _react2.jsx)(_.Pair, null, (0, _react2.jsx)(_.PairLabel, null, "Null Field"), (0, _react2.jsx)(_.PairValue, null, null)), (0, _react2.jsx)(_.Pair, null, (0, _react2.jsx)(_.PairLabel, null, "Visible Field"), (0, _react2.jsx)(_.PairValue, null, "some value"))));
+  expect(_testWrapper.screen.queryByText('Empty Field')).not.toBeInTheDocument();
+  expect(_testWrapper.screen.queryByText('Null Field')).not.toBeInTheDocument();
+  expect(_testWrapper.screen.getByText('Visible Field')).toBeInTheDocument();
+});
+test('rows with falsy value are rendered when isLoading is true', function () {
+  getComponent((0, _react2.jsx)(_.Pair, null, (0, _react2.jsx)(_.PairLabel, null, "Loading Field"), (0, _react2.jsx)(_.PairValue, {
+    isLoading: true
+  })));
+  expect(_testWrapper.screen.getByText('Loading Field')).toBeInTheDocument();
+});
+describe('valueType COPYABLE', function () {
+  beforeEach(function () {
+    var mockClipboard = {
+      writeText: jest.fn()
+    };
+    (0, _defineProperty2["default"])(window, 'navigator', {
+      value: {
+        clipboard: mockClipboard
+      },
+      configurable: true
+    });
+    global.document.execCommand = jest.fn();
+    jest.spyOn(document, 'execCommand').mockReturnValue(true);
+  });
+  afterEach(function () {
+    jest.resetAllMocks();
+    (0, _defineProperty2["default"])(window, 'navigator', {
+      value: {
+        clipboard: originalClipboard
+      },
+      configurable: true
+    });
+  });
+  test('renders a copy-to-clipboard button', function () {
+    getComponent((0, _react2.jsx)(_.Pair, null, (0, _react2.jsx)(_.PairLabel, null, "API Key"), (0, _react2.jsx)(_.PairValue, {
+      valueType: _.ValueTypes.COPYABLE
+    }, "abc123")));
+    expect(_testWrapper.screen.getByLabelText('copy to clipboard')).toBeInTheDocument();
+  });
+  test('clicking the copy button writes the field value to the clipboard', /*#__PURE__*/(0, _asyncToGenerator2["default"])(/*#__PURE__*/_regeneratorRuntime().mark(function _callee2() {
+    var fieldValue, button;
+    return _regeneratorRuntime().wrap(function _callee2$(_context2) {
+      while (1) switch (_context2.prev = _context2.next) {
+        case 0:
+          fieldValue = 'abc123';
+          getComponent((0, _react2.jsx)(_.Pair, null, (0, _react2.jsx)(_.PairLabel, null, "API Key"), (0, _react2.jsx)(_.PairValue, {
+            valueType: _.ValueTypes.COPYABLE
+          }, fieldValue)));
+          button = _testWrapper.screen.getByLabelText('copy to clipboard');
+          _context2.next = 5;
+          return (0, _testWrapper.act)(/*#__PURE__*/(0, _asyncToGenerator2["default"])(/*#__PURE__*/_regeneratorRuntime().mark(function _callee() {
+            return _regeneratorRuntime().wrap(function _callee$(_context) {
+              while (1) switch (_context.prev = _context.next) {
+                case 0:
+                  return _context.abrupt("return", _userEvent["default"].click(button));
+                case 1:
+                case "end":
+                  return _context.stop();
+              }
+            }, _callee);
+          })));
+        case 5:
+          expect(navigator.clipboard.writeText).toHaveBeenCalledTimes(1);
+          expect(navigator.clipboard.writeText).toHaveBeenCalledWith(fieldValue);
+        case 7:
+        case "end":
+          return _context2.stop();
+      }
+    }, _callee2);
+  })));
+});
+test('valueType ELEMENT renders the provided node directly', function () {
+  var customNode = (0, _react2.jsx)("span", {
+    "data-testid": "custom-element"
+  }, "Custom Element");
+  getComponent((0, _react2.jsx)(_.Pair, null, (0, _react2.jsx)(_.PairLabel, null, "Custom"), (0, _react2.jsx)(_.PairValue, {
+    valueType: _.ValueTypes.ELEMENT
+  }, customNode)));
+  expect(_testWrapper.screen.getByTestId('custom-element')).toBeInTheDocument();
+  expect(_testWrapper.screen.getByText('Custom Element')).toBeInTheDocument();
+});
+test('valueType MASKED renders bullet characters by default', function () {
+  var _context3;
+  var secretValue = 'secret';
+  getComponent((0, _react2.jsx)(_.Pair, null, (0, _react2.jsx)(_.PairLabel, null, "Password"), (0, _react2.jsx)(_.PairValue, {
+    valueType: _.ValueTypes.MASKED
+  }, secretValue)));
+  var bullets = (0, _repeat["default"])(_context3 = '•').call(_context3, secretValue.length);
+  expect(_testWrapper.screen.getByText(bullets)).toBeInTheDocument();
+});
+test('masked toggle has aria-label "Show content" initially, clicking reveals value and changes label to "Hide content"', /*#__PURE__*/(0, _asyncToGenerator2["default"])(/*#__PURE__*/_regeneratorRuntime().mark(function _callee3() {
+  var secretValue, showButton;
+  return _regeneratorRuntime().wrap(function _callee3$(_context4) {
+    while (1) switch (_context4.prev = _context4.next) {
+      case 0:
+        secretValue = 'mypassword';
+        getComponent((0, _react2.jsx)(_.Pair, null, (0, _react2.jsx)(_.PairLabel, null, "Secret"), (0, _react2.jsx)(_.PairValue, {
+          valueType: _.ValueTypes.MASKED
+        }, secretValue)));
+        showButton = _testWrapper.screen.getByLabelText('Show content');
+        expect(showButton).toBeInTheDocument();
+
+        // The actual value should not be visible yet
+        expect(_testWrapper.screen.queryByText(secretValue)).not.toBeInTheDocument();
+        _context4.next = 7;
+        return _userEvent["default"].click(showButton);
+      case 7:
+        // After click: value is revealed and button label changes
+        expect(_testWrapper.screen.getByText(secretValue)).toBeInTheDocument();
+        expect(_testWrapper.screen.getByLabelText('Hide content')).toBeInTheDocument();
+      case 9:
+      case "end":
+        return _context4.stop();
+    }
+  }, _callee3);
+})));
+test('isLoading renders the skeleton and has role="alert" in the DOM', function () {
+  getComponent((0, _react2.jsx)(_.Pair, null, (0, _react2.jsx)(_.PairLabel, null, "Loading Row"), (0, _react2.jsx)(_.PairValue, {
+    isLoading: true
+  }, "will be replaced")));
+  expect(_testWrapper.screen.getByRole('alert')).toBeInTheDocument();
+});
+test('isLoading renders even when value is falsy', function () {
+  getComponent((0, _react2.jsx)(_.Pair, null, (0, _react2.jsx)(_.PairLabel, null, "Empty Loading Row"), (0, _react2.jsx)(_.PairValue, {
+    isLoading: true
+  }, undefined)));
+  expect(_testWrapper.screen.getByText('Empty Loading Row')).toBeInTheDocument();
+  expect(_testWrapper.screen.getByRole('alert')).toBeInTheDocument();
+});
+test('helpHint content appears and trigger button has expected aria-label', function () {
+  var helpText = 'This is some help content';
+  var fieldLabel = 'Help Field';
+  getComponent((0, _react2.jsx)(_.Pair, null, (0, _react2.jsx)(_.PairLabel, {
+    helpHint: helpText
+  }, fieldLabel), (0, _react2.jsx)(_.PairValue, null, "value here")));
+  var expectedAriaLabel = "".concat(fieldLabel, " help hint");
+  expect(_testWrapper.screen.getByLabelText(expectedAriaLabel)).toBeInTheDocument();
+});
+test('Subvalue renders when provided', function () {
+  getComponent((0, _react2.jsx)(_.Pair, null, (0, _react2.jsx)(_.PairLabel, null, "Main Label"), (0, _react2.jsx)(_.PairSubvalue, null, "Secondary label text"), (0, _react2.jsx)(_.PairValue, null, "some value")));
+  expect(_testWrapper.screen.getByText('Secondary label text')).toBeInTheDocument();
+});
+test('second child renders as an icon element when provided', function () {
+  getComponent((0, _react2.jsx)(_.Pair, null, (0, _react2.jsx)(_.PairLabel, null, "Icon Field", (0, _react2.jsx)(_index.Icon, {
+    "aria-hidden": "true",
+    title: {
+      name: ''
+    },
+    icon: _InformationIcon["default"]
+  })), (0, _react2.jsx)(_.PairValue, null, "icon value")));
+  // the icon is aria-hidden so must query with hidden: true
+  var icons = _testWrapper.screen.getAllByRole('img', {
+    hidden: true
+  });
+  expect(icons.length).toBeGreaterThan(0);
+});
+describe('sub-component prop passthrough', function () {
+  test('PairLabel forwards containerProps and textProps, and renders a second child as an icon', function () {
+    getComponent((0, _react2.jsx)(_.Pair, null, (0, _react2.jsx)(_.PairLabel, {
+      containerProps: {
+        'data-testid': 'label-container'
+      },
+      textProps: {
+        'data-testid': 'label-text'
+      }
+    }, "Field", (0, _react2.jsx)(_index.Icon, {
+      "data-testid": "label-icon",
+      "aria-hidden": "true",
+      title: {
+        name: ''
+      },
+      icon: _InformationIcon["default"]
+    })), (0, _react2.jsx)(_.PairValue, null, "value")));
+    expect(_testWrapper.screen.getByTestId('label-container')).toBeInTheDocument();
+    expect(_testWrapper.screen.getByTestId('label-text')).toBeInTheDocument();
+    expect(_testWrapper.screen.getByTestId('label-icon')).toBeInTheDocument();
+  });
+  test('PairLabel forwards helpHintProps to the HelpHint popover trigger', function () {
+    getComponent((0, _react2.jsx)(_.Pair, null, (0, _react2.jsx)(_.PairLabel, {
+      helpHint: "Help content",
+      helpHintProps: {
+        'data-testid': 'label-help-hint'
+      }
+    }, "Field"), (0, _react2.jsx)(_.PairValue, null, "value")));
+    expect(_testWrapper.screen.getByTestId('label-help-hint')).toBeInTheDocument();
+  });
+  test('PairValue forwards containerProps and textProps for the default text display', function () {
+    getComponent((0, _react2.jsx)(_.Pair, null, (0, _react2.jsx)(_.PairLabel, null, "Field"), (0, _react2.jsx)(_.PairValue, {
+      containerProps: {
+        'data-testid': 'value-container'
+      },
+      textProps: {
+        'data-testid': 'value-text'
+      }
+    }, "value")));
+    expect(_testWrapper.screen.getByTestId('value-text')).toBeInTheDocument();
+  });
+  test('PairValue forwards containerProps and textProps for COPYABLE values', function () {
+    getComponent((0, _react2.jsx)(_.Pair, null, (0, _react2.jsx)(_.PairLabel, null, "Field"), (0, _react2.jsx)(_.PairValue, {
+      valueType: _.ValueTypes.COPYABLE,
+      containerProps: {
+        'data-testid': 'copy-container'
+      },
+      textProps: {
+        'data-testid': 'copy-text'
+      }
+    }, "abc123")));
+    expect(_testWrapper.screen.getByTestId('copy-container')).toBeInTheDocument();
+    expect(_testWrapper.screen.getByTestId('copy-text')).toBeInTheDocument();
+  });
+  test('PairValue forwards containerProps, textProps, iconProps, and iconButtonProps for MASKED values', function () {
+    getComponent((0, _react2.jsx)(_.Pair, null, (0, _react2.jsx)(_.PairLabel, null, "Field"), (0, _react2.jsx)(_.PairValue, {
+      valueType: _.ValueTypes.MASKED,
+      containerProps: {
+        'data-testid': 'masked-container'
+      },
+      textProps: {
+        'data-testid': 'masked-text'
+      },
+      iconProps: {
+        'data-testid': 'masked-icon'
+      },
+      iconButtonProps: {
+        'data-testid': 'masked-icon-button'
+      }
+    }, "secret")));
+    expect(_testWrapper.screen.getByTestId('masked-container')).toBeInTheDocument();
+    expect(_testWrapper.screen.getByTestId('masked-text')).toBeInTheDocument();
+    expect(_testWrapper.screen.getByTestId('masked-icon')).toBeInTheDocument();
+    expect(_testWrapper.screen.getByTestId('masked-icon-button')).toBeInTheDocument();
+  });
+  test('PairValue forwards skeletonProps and containerProps when isLoading', function () {
+    getComponent((0, _react2.jsx)(_.Pair, null, (0, _react2.jsx)(_.PairLabel, null, "Field"), (0, _react2.jsx)(_.PairValue, {
+      isLoading: true,
+      containerProps: {
+        'data-testid': 'loading-container'
+      },
+      skeletonProps: {
+        'data-testid': 'loading-skeleton'
+      }
+    })));
+    expect(_testWrapper.screen.getByTestId('loading-container')).toBeInTheDocument();
+    expect(_testWrapper.screen.getByTestId('loading-skeleton')).toBeInTheDocument();
+  });
+  test('PairSubvalue forwards TextProps directly', function () {
+    getComponent((0, _react2.jsx)(_.Pair, null, (0, _react2.jsx)(_.PairLabel, null, "Field"), (0, _react2.jsx)(_.PairSubvalue, {
+      "data-testid": "subvalue-text"
+    }, "Secondary text"), (0, _react2.jsx)(_.PairValue, null, "value")));
+    expect(_testWrapper.screen.getByTestId('subvalue-text')).toBeInTheDocument();
+  });
+});

package/lib/cjs/components/LabelValuePairs/LabelValuePairsLabel.d.ts

@@ -0,0 +1,4 @@
+import React from 'react';
+import { LabelValuePairsLabelProps } from '../../types';
+declare const PairLabel: React.ForwardRefExoticComponent<LabelValuePairsLabelProps & React.RefAttributes<HTMLElement>>;
+export default PairLabel;