orcs-design-system 3.3.76 → 3.4.0

package/README.md

@@ -76,13 +76,49 @@ npm run deploy-storybook
 
 ## Using ORCS in a project
 
-In your project's root, install ORCS and styled-components:
+### GitHub Packages (Recommended)
+
+For internal repositories, use the GitHub Packages version `@teamform/orcs-design-system`. This package is published in parallel with the public version and uses your existing GitHub authentication.
+
+**Setup:**
+
+1. Add `.npmrc` to your repository root with the following content:
+   ```ini
+   @teamform:registry=https://npm.pkg.github.com
+   //npm.pkg.github.com/:_authToken=${GITHUB_TOKEN}
+   ```
+
+2. Update `package.json` to use npm aliases (no code changes needed):
+   ```json
+   {
+     "dependencies": {
+       "orcs-design-system": "npm:@teamform/orcs-design-system@^3.4.0"
+     }
+   }
+   ```
+
+3. Install: `npm install`
+
+**Note:** In GitHub Actions, `GITHUB_TOKEN` is automatically available. For local development, set `GITHUB_TOKEN` as an environment variable with a Personal Access Token (with `read:packages` permission).
+
+Your imports remain the same:
+```javascript
+import { Box } from 'orcs-design-system';
+```
+
+### Public Package (Deprecated)
+
+> **⚠️ Deprecated**: The public npm package (`orcs-design-system`) is deprecated and will be removed by January 2026 at the latest. Please migrate to the GitHub Packages version (`@teamform/orcs-design-system`) as soon as possible.
+
+If you are still using the public package, you can install it with:
 
 ```
 npm i orcs-design-system
 npm i styled-components
 ```
 
+However, **new projects should use the GitHub Packages version** (see above).
+
 ### Using components
 
 Once ORCS is installed, you can directly import components. For example, for `Box`:
@@ -125,6 +161,10 @@ import { ThemeProvider } from "styled-components"
 
 Variables can be referenced using `theme.arrayName.variableAlias`. When using Styled System props, components refer to the theme field associated with the prop as set out in the [reference table](https://styled-system.com/table).
 
+### Styled Components v6
+
+This design system uses **styled-components v6**. When creating or updating styled components, **always use the `&` prefix for pseudo-selectors** (e.g., `&:checked`, `&:focus`, `&:hover`) to ensure proper CSS specificity. See component documentation (e.g., Checkbox, Toggle) for examples.
+
 ### Using icons
 
 You will need to add the icon library that we are using (which is Font Awesome). To do this, install the Font Awesome packages:

package/es/assets/Colour/index.js

@@ -8,7 +8,7 @@ export const Colour = /*#__PURE__*/styled("div").withConfig({
   componentId: "sc-uyvdow-0"
 })(props => {
   return css({
-    backgroundColor: themeGet(`colors.${props.bg}`)(props),
+    backgroundColor: themeGet("colors.".concat(props.bg))(props),
     width: "75px",
     height: "75px"
   });

package/es/components/ActionsMenu/index.js

@@ -1,3 +1,9 @@
+import _objectWithoutProperties from "@babel/runtime/helpers/objectWithoutProperties";
+import _defineProperty from "@babel/runtime/helpers/defineProperty";
+const _excluded = ["as"],
+  _excluded2 = ["theme", "onToggle", "toggleState", "direction", "menuWidth", "customTriggerComponent", "renderTrigger", "children", "ariaLabel", "onTriggerFocus", "closeMenu", "closeOnClick", "data-testid", "variant", "disabled"];
+function ownKeys(e, r) { var t = Object.keys(e); if (Object.getOwnPropertySymbols) { var o = Object.getOwnPropertySymbols(e); r && (o = o.filter(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 t = null != arguments[r] ? arguments[r] : {}; r % 2 ? ownKeys(Object(t), !0).forEach(function (r) { _defineProperty(e, r, t[r]); }) : Object.getOwnPropertyDescriptors ? Object.defineProperties(e, Object.getOwnPropertyDescriptors(t)) : ownKeys(Object(t)).forEach(function (r) { Object.defineProperty(e, r, Object.getOwnPropertyDescriptor(t, r)); }); } return e; }
 import React, { useState, useImperativeHandle, createContext, useContext, useMemo, useId, useLayoutEffect } from "react";
 import styled, { css, ThemeProvider } from "styled-components";
 import PropTypes from "prop-types";
@@ -99,17 +105,20 @@ export const ActionsMenuHeading = /*#__PURE__*/styled(props => {
   // // Only sets `aria-labelledby` on the Popover root element
   // // if this component is mounted inside it.
   useLayoutEffect(() => {
-    actionMenu?.setLabelId?.(id);
-    return () => actionMenu?.setLabelId?.(undefined);
+    var _actionMenu$setLabelI;
+    actionMenu === null || actionMenu === void 0 || (_actionMenu$setLabelI = actionMenu.setLabelId) === null || _actionMenu$setLabelI === void 0 || _actionMenu$setLabelI.call(actionMenu, id);
+    return () => {
+      var _actionMenu$setLabelI2;
+      return actionMenu === null || actionMenu === void 0 || (_actionMenu$setLabelI2 = actionMenu.setLabelId) === null || _actionMenu$setLabelI2 === void 0 ? void 0 : _actionMenu$setLabelI2.call(actionMenu, undefined);
+    };
   }, [id, actionMenu]);
-  return /*#__PURE__*/_jsx("div", {
-    ...props,
+  return /*#__PURE__*/_jsx("div", _objectSpread(_objectSpread({}, props), {}, {
     onKeyUp: e => {
-      if (e.key === commonKeys.ENTER && props?.canClick) {
-        props?.onClick();
+      if (e.key === commonKeys.ENTER && props !== null && props !== void 0 && props.canClick) {
+        props === null || props === void 0 || props.onClick();
       }
     }
-  });
+  }));
 }).attrs({
   tabIndex: "0",
   role: "button"
@@ -123,54 +132,47 @@ const StyledNavLink = /*#__PURE__*/styled(NavLink).withConfig({
   componentId: "sc-yvbni2-7"
 })(["text-decoration:none;"]);
 export const ActionsMenuItem = /*#__PURE__*/styled(props => {
+  var _actionMenu$getItemPr;
   const {
     id,
     onItemClick,
     actionMenu
   } = useContext(ActionMenuContext);
   const {
-    as,
-    ...others
-  } = props;
+      as
+    } = props,
+    others = _objectWithoutProperties(props, _excluded);
   const Component = as ? as : others.href ? "a" : "button";
   const disabled = props.disabled;
-  let newProps = {
-    ...others,
-    ...(actionMenu?.getItemProps?.() || {})
-  };
+  let newProps = _objectSpread(_objectSpread({}, others), (actionMenu === null || actionMenu === void 0 || (_actionMenu$getItemPr = actionMenu.getItemProps) === null || _actionMenu$getItemPr === void 0 ? void 0 : _actionMenu$getItemPr.call(actionMenu)) || {});
   const {
     onClick: originalOnClick
   } = newProps;
   const onClick = useMemo(() => e => {
-    onItemClick?.(e);
-    originalOnClick?.(e);
+    onItemClick === null || onItemClick === void 0 || onItemClick(e);
+    originalOnClick === null || originalOnClick === void 0 || originalOnClick(e);
   }, [originalOnClick, onItemClick]);
   if (props.to) {
     const LinkedComponent = props.Component || Component;
     return /*#__PURE__*/_jsx(StyledNavLink, {
       to: props.to,
-      children: /*#__PURE__*/_jsx(LinkedComponent, {
-        ...newProps
-      })
+      children: /*#__PURE__*/_jsx(LinkedComponent, _objectSpread({}, newProps))
     });
   }
   if (Component === "button") {
-    newProps = {
-      ...others,
+    newProps = _objectSpread(_objectSpread({}, others), {}, {
       type: "button",
       ["data-action-menu-id"]: id
-    };
+    });
   }
-  if (props.Component) return /*#__PURE__*/_jsx(props.Component, {
-    ...newProps,
+  if (props.Component) return /*#__PURE__*/_jsx(props.Component, _objectSpread(_objectSpread({}, newProps), {}, {
     onClick: onClick,
     disabled: disabled
-  });
-  return /*#__PURE__*/_jsx(Component, {
-    ...newProps,
+  }));
+  return /*#__PURE__*/_jsx(Component, _objectSpread(_objectSpread({}, newProps), {}, {
     onClick: onClick,
     disabled: disabled
-  });
+  }));
 }).attrs({
   role: "menuitem"
 }).withConfig({
@@ -184,52 +186,49 @@ export const ActionsMenuItem = /*#__PURE__*/styled(props => {
 });
 export const ActionsMenuBody = _ref2 => {
   let {
-    theme,
-    onToggle,
-    toggleState,
-    // direction - Deprecated
-    direction = "right-start",
-    menuWidth,
-    customTriggerComponent,
-    renderTrigger,
-    children,
-    ariaLabel = "Options Menu",
-    onTriggerFocus,
-    closeMenu,
-    closeOnClick = false,
-    "data-testid": dataTestId = "ActionsMenu",
-    variant = "default",
-    disabled = false,
-    ...props
-  } = _ref2;
+      theme,
+      onToggle,
+      toggleState,
+      // direction - Deprecated
+      direction = "right-start",
+      menuWidth,
+      customTriggerComponent,
+      renderTrigger,
+      children,
+      ariaLabel = "Options Menu",
+      onTriggerFocus,
+      closeMenu,
+      closeOnClick = false,
+      "data-testid": dataTestId = "ActionsMenu",
+      variant = "default",
+      disabled = false
+    } = _ref2,
+    props = _objectWithoutProperties(_ref2, _excluded2);
   const id = useId();
   const actionMenu = useActionMenu({
     placement: direction,
     open: toggleState,
     onOpenChange: (_, e) => {
       if (e) {
-        onToggle?.(e);
+        onToggle === null || onToggle === void 0 || onToggle(e);
       }
     }
   });
   const childrenRef = children.ref;
   const triggerRef = useMergeRefs([actionMenu.refs.setReference, childrenRef]);
   const ref = useMergeRefs([actionMenu.refs.setFloating]);
-  const triggerProps = useMemo(() => ({
+  const triggerProps = useMemo(() => _objectSpread({
     "aria-label": ariaLabel,
     onFocus: onTriggerFocus,
     id,
-    disabled,
-    ...actionMenu.getReferenceProps({
-      ...props,
-      onClick: disabled ? undefined : onToggle,
-      ref: triggerRef,
-      "data-state": actionMenu.open ? "open" : "closed",
-      "data-testid": dataTestId
-    })
-  }), [ariaLabel, onTriggerFocus, id, actionMenu, onToggle, props, triggerRef, dataTestId, disabled]);
-  let triggerComponent = /*#__PURE__*/_jsxs(Control, {
-    ...triggerProps,
+    disabled
+  }, actionMenu.getReferenceProps(_objectSpread(_objectSpread({}, props), {}, {
+    onClick: disabled ? undefined : onToggle,
+    ref: triggerRef,
+    "data-state": actionMenu.open ? "open" : "closed",
+    "data-testid": dataTestId
+  }))), [ariaLabel, onTriggerFocus, id, actionMenu, onToggle, props, triggerRef, dataTestId, disabled]);
+  let triggerComponent = /*#__PURE__*/_jsxs(Control, _objectSpread(_objectSpread({}, triggerProps), {}, {
     variant: variant,
     disabled: disabled,
     children: [/*#__PURE__*/_jsx(Dots, {
@@ -239,16 +238,16 @@ export const ActionsMenuBody = _ref2 => {
       className: "actionsMenu__cross",
       variant: variant
     })]
-  });
+  }));
   if (renderTrigger) {
     triggerComponent = renderTrigger(triggerProps);
   }
   if (customTriggerComponent) {
-    triggerComponent = /*#__PURE__*/_jsx("div", {
-      role: "button",
-      ...triggerProps,
+    triggerComponent = /*#__PURE__*/_jsx("div", _objectSpread(_objectSpread({
+      role: "button"
+    }, triggerProps), {}, {
       children: customTriggerComponent
-    });
+    }));
   }
   const value = useMemo(() => ({
     id,
@@ -259,28 +258,26 @@ export const ActionsMenuBody = _ref2 => {
     },
     actionMenu
   }), [closeOnClick, closeMenu, id, actionMenu]);
-  const style = useMemo(() => ({
-    ...actionMenu.floatingStyles,
+  const style = useMemo(() => _objectSpread(_objectSpread({}, actionMenu.floatingStyles), {}, {
     zIndex: getFloatingUiZIndex(actionMenu.refs.reference)
   }), [actionMenu.floatingStyles, actionMenu.refs.reference]);
-  const menuDataTestId = useMemo(() => `${dataTestId}__menu`, [dataTestId]);
+  const menuDataTestId = useMemo(() => "".concat(dataTestId, "__menu"), [dataTestId]);
   const {
     getFloatingProps
   } = actionMenu;
   const floatingProps = useMemo(() => getFloatingProps(props), [getFloatingProps, props]);
   const component = /*#__PURE__*/_jsx(ActionMenuContext.Provider, {
     value: value,
-    children: /*#__PURE__*/_jsxs(Wrapper, {
-      ...props,
+    children: /*#__PURE__*/_jsxs(Wrapper, _objectSpread(_objectSpread({}, props), {}, {
       children: [triggerComponent, toggleState ? /*#__PURE__*/_jsx(FloatingPortal, {
         root: getFloatingUiRootElement(actionMenu.refs.reference),
         children: /*#__PURE__*/_jsx(FloatingFocusManager, {
           context: actionMenu.context,
           modal: true,
-          children: /*#__PURE__*/_jsx(StyledActionsMenuContainer, {
+          children: /*#__PURE__*/_jsx(StyledActionsMenuContainer, _objectSpread(_objectSpread({
             "aria-labelledby": actionMenu.labelId,
-            "data-testid": menuDataTestId,
-            ...floatingProps,
+            "data-testid": menuDataTestId
+          }, floatingProps), {}, {
             style: style,
             className: "actionMenu-content visible",
             "aria-hidden": "false",
@@ -290,7 +287,7 @@ export const ActionsMenuBody = _ref2 => {
               isOpen: toggleState,
               children: children
             })
-          })
+          }))
         })
       }) :
       /*#__PURE__*/
@@ -310,7 +307,7 @@ export const ActionsMenuBody = _ref2 => {
           children: children
         })
       })]
-    })
+    }))
   });
   return theme ? /*#__PURE__*/_jsx(ThemeProvider, {
     theme: theme,
@@ -349,13 +346,12 @@ const ActionsMenu = /*#__PURE__*/React.forwardRef((props, ref) => {
       setToggle(false);
     }
   }));
-  return /*#__PURE__*/_jsx(ActionsMenuBody, {
-    ...props,
+  return /*#__PURE__*/_jsx(ActionsMenuBody, _objectSpread(_objectSpread({}, props), {}, {
     closeMenu: () => setToggle(false),
     toggleState: toggleState,
     onToggle: onToggle,
     children: props.children
-  });
+  }));
 });
 ActionsMenu.propTypes = {
   isOpen: PropTypes.bool,

package/es/components/ActionsMenu/useActionMenu.js

@@ -1,3 +1,6 @@
+import _defineProperty from "@babel/runtime/helpers/defineProperty";
+function ownKeys(e, r) { var t = Object.keys(e); if (Object.getOwnPropertySymbols) { var o = Object.getOwnPropertySymbols(e); r && (o = o.filter(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 t = null != arguments[r] ? arguments[r] : {}; r % 2 ? ownKeys(Object(t), !0).forEach(function (r) { _defineProperty(e, r, t[r]); }) : Object.getOwnPropertyDescriptors ? Object.defineProperties(e, Object.getOwnPropertyDescriptors(t)) : ownKeys(Object(t)).forEach(function (r) { Object.defineProperty(e, r, Object.getOwnPropertyDescriptor(t, r)); }); } return e; }
 import React, { useCallback, useMemo, useRef, useState } from "react";
 import { useFloating, autoUpdate, offset, flip, shift, useClick, useDismiss, useRole, useInteractions, FloatingArrow, arrow } from "@floating-ui/react";
 import { jsx as _jsx } from "react/jsx-runtime";
@@ -14,8 +17,8 @@ export default function useActionMenu(_ref) {
   const [labelId, setLabelId] = useState();
   const [descriptionId, setDescriptionId] = useState();
   const arrowRef = useRef();
-  const open = controlledOpen ?? uncontrolledOpen;
-  const setOpen = setControlledOpen ?? setUncontrolledOpen;
+  const open = controlledOpen !== null && controlledOpen !== void 0 ? controlledOpen : uncontrolledOpen;
+  const setOpen = setControlledOpen !== null && setControlledOpen !== void 0 ? setControlledOpen : setUncontrolledOpen;
   const data = useFloating({
     placement,
     open,
@@ -44,11 +47,10 @@ export default function useActionMenu(_ref) {
     ref: arrowRef,
     context: context
   }), [context]);
-  return useMemo(() => ({
+  return useMemo(() => _objectSpread(_objectSpread(_objectSpread({
     open,
-    setOpen,
-    ...interactions,
-    ...data,
+    setOpen
+  }, interactions), data), {}, {
     modal,
     labelId,
     descriptionId,

package/es/components/Avatar/CroppedImage.js

@@ -22,10 +22,11 @@ const resolveCustomSize = (customSize, props) => {
   if (customSize.includes("px") || customSize.includes("rem") || customSize.includes("em") || customSize.includes("%")) {
     return customSize;
   } else {
-    return themeGet(`avatarScale.${customSize}`)(props) || customSize;
+    return themeGet("avatarScale.".concat(customSize))(props) || customSize;
   }
 };
 const CroppedImage = _ref => {
+  var _croppedAreaPercent$x, _croppedAreaPercent$y;
   let {
     src,
     alt,
@@ -35,12 +36,12 @@ const CroppedImage = _ref => {
   } = _ref;
   const scale = 100 / (croppedAreaPercent.width || 1);
   const transform = {
-    x: `${-(croppedAreaPercent.x ?? 0) * scale}%`,
-    y: `${-(croppedAreaPercent.y ?? 0) * scale}%`,
+    x: "".concat(-((_croppedAreaPercent$x = croppedAreaPercent.x) !== null && _croppedAreaPercent$x !== void 0 ? _croppedAreaPercent$x : 0) * scale, "%"),
+    y: "".concat(-((_croppedAreaPercent$y = croppedAreaPercent.y) !== null && _croppedAreaPercent$y !== void 0 ? _croppedAreaPercent$y : 0) * scale, "%"),
     scale
   };
   const imageStyle = {
-    transform: `translate3d(${transform.x}, ${transform.y}, 0) scale3d(${transform.scale}, ${transform.scale}, 1)`,
+    transform: "translate3d(".concat(transform.x, ", ").concat(transform.y, ", 0) scale3d(").concat(transform.scale, ", ").concat(transform.scale, ", 1)"),
     width: "calc(100% + 0.5px)",
     height: "auto"
   };