@planningcenter/tapestry 3.2.3-rc.1 → 3.2.3-rc.11

package/dist/components/link/BaseLink.js.map

@@ -1 +1 @@
-{"version":3,"file":"BaseLink.js","sources":["../../../src/components/link/BaseLink.tsx"],"sourcesContent":["import \"../button/btn.css\"\n\nimport {\n  BaseComponentProps,\n  COMPONENT_KIND_CLASS_MAP,\n  COMPONENT_SIZE_CLASS_MAP,\n  ComponentKind,\n  ComponentSize,\n  enhanceElementWithClassName,\n} from \"@utilities/buttonLinkShared\"\nimport classNames from \"classnames\"\nimport React, { AnchorHTMLAttributes, forwardRef } from \"react\"\n\nexport interface BaseLinkElementProps\n  extends BaseComponentProps,\n    Omit<\n      AnchorHTMLAttributes<HTMLAnchorElement>,\n      keyof BaseComponentProps | \"children\"\n    > {\n  children?: React.ReactNode\n  external?: boolean\n  href: string\n  kind?: ComponentKind\n  label?: React.ReactNode\n}\n\nconst buildComponentClassName = (\n  size?: ComponentSize,\n  kind?: ComponentKind,\n  fullWidth?: boolean,\n  className?: string\n): string => {\n  return classNames(\n    \"tds-btn\",\n    size && size !== \"md\" && kind && COMPONENT_SIZE_CLASS_MAP[size],\n    kind && COMPONENT_KIND_CLASS_MAP[kind],\n    fullWidth && \"tds-btn--full-width\",\n    className\n  )\n}\n\nexport const BaseLink = forwardRef<HTMLAnchorElement, BaseLinkElementProps>(\n  (\n    {\n      children,\n      className,\n      external = false,\n      fullWidth,\n      href,\n      kind,\n      label,\n      prefix,\n      size,\n      suffix,\n      ...restProps\n    }: BaseLinkElementProps,\n    ref\n  ) => {\n    const combinedClassName = buildComponentClassName(\n      size,\n      kind,\n      fullWidth,\n      className\n    )\n\n    const prefixElement = enhanceElementWithClassName(prefix, \"prefix\")\n    const suffixElement = enhanceElementWithClassName(suffix, \"suffix\")\n    const externalProps = external\n      ? { rel: \"noopener noreferrer\", target: \"_blank\" }\n      : {}\n\n    return (\n      <a\n        href={href}\n        className={combinedClassName}\n        ref={ref}\n        {...restProps}\n        {...externalProps}\n      >\n        {prefixElement}\n        {label || children}\n        {suffixElement}\n      </a>\n    )\n  }\n)\n\nBaseLink.displayName = \"BaseLink\"\n"],"names":["React"],"mappings":";;;;AA0BA,MAAM,uBAAuB,GAAG,CAC9B,IAAoB,EACpB,IAAoB,EACpB,SAAmB,EACnB,SAAkB,KACR;AACV,IAAA,OAAO,UAAU,CACf,SAAS,EACT,IAAI,IAAI,IAAI,KAAK,IAAI,IAAI,IAAI,IAAI,wBAAwB,CAAC,IAAI,CAAC,EAC/D,IAAI,IAAI,wBAAwB,CAAC,IAAI,CAAC,EACtC,SAAS,IAAI,qBAAqB,EAClC,SAAS,CACV;AACH,CAAC;AAEM,MAAM,QAAQ,GAAG,UAAU,CAChC,CACE,EACE,QAAQ,EACR,SAAS,EACT,QAAQ,GAAG,KAAK,EAChB,SAAS,EACT,IAAI,EACJ,IAAI,EACJ,KAAK,EACL,MAAM,EACN,IAAI,EACJ,MAAM,EACN,GAAG,SAAS,EACS,EACvB,GAAG,KACD;AACF,IAAA,MAAM,iBAAiB,GAAG,uBAAuB,CAC/C,IAAI,EACJ,IAAI,EACJ,SAAS,EACT,SAAS,CACV;IAED,MAAM,aAAa,GAAG,2BAA2B,CAAC,MAAM,EAAE,QAAQ,CAAC;IACnE,MAAM,aAAa,GAAG,2BAA2B,CAAC,MAAM,EAAE,QAAQ,CAAC;IACnE,MAAM,aAAa,GAAG;UAClB,EAAE,GAAG,EAAE,qBAAqB,EAAE,MAAM,EAAE,QAAQ;UAC9C,EAAE;AAEN,IAAA,QACEA,cAAA,CAAA,aAAA,CAAA,GAAA,EAAA,EACE,IAAI,EAAE,IAAI,EACV,SAAS,EAAE,iBAAiB,EAC5B,GAAG,EAAE,GAAG,EAAA,GACJ,SAAS,KACT,aAAa,EAAA;QAEhB,aAAa;AACb,QAAA,KAAK,IAAI,QAAQ;QACjB,aAAa,CACZ;AAER,CAAC;AAGH,QAAQ,CAAC,WAAW,GAAG,UAAU;;;;"}
+{"version":3,"file":"BaseLink.js","sources":["../../../src/components/link/BaseLink.tsx"],"sourcesContent":["import \"../button/btn.css\"\n\nimport {\n  BaseComponentProps,\n  COMPONENT_KIND_CLASS_MAP,\n  COMPONENT_SIZE_CLASS_MAP,\n  ComponentKind,\n  ComponentSize,\n  enhanceElementWithClassName,\n} from \"@utilities/buttonLinkShared\"\nimport classNames from \"classnames\"\nimport React, { AnchorHTMLAttributes, forwardRef } from \"react\"\n\nexport interface BaseLinkElementProps\n  extends BaseComponentProps,\n    Omit<\n      AnchorHTMLAttributes<HTMLAnchorElement>,\n      keyof BaseComponentProps | \"children\"\n    > {\n  children?: React.ReactNode\n  external?: boolean\n  href: string\n  kind?: ComponentKind\n  label?: React.ReactNode\n}\n\nconst buildComponentClassName = (\n  size?: ComponentSize,\n  kind?: ComponentKind,\n  fullWidth?: boolean,\n  className?: string\n): string => {\n  return classNames(\n    kind && \"tds-btn\",\n    size && size !== \"md\" && kind && COMPONENT_SIZE_CLASS_MAP[size],\n    kind && COMPONENT_KIND_CLASS_MAP[kind],\n    fullWidth && \"tds-btn--full-width\",\n    className\n  )\n}\n\nexport const BaseLink = forwardRef<HTMLAnchorElement, BaseLinkElementProps>(\n  (\n    {\n      children,\n      className,\n      external = false,\n      fullWidth,\n      href,\n      kind,\n      label,\n      prefix,\n      size,\n      suffix,\n      ...restProps\n    }: BaseLinkElementProps,\n    ref\n  ) => {\n    const combinedClassName = buildComponentClassName(\n      size,\n      kind,\n      fullWidth,\n      className\n    )\n\n    const prefixElement = enhanceElementWithClassName(prefix, \"prefix\")\n    const suffixElement = enhanceElementWithClassName(suffix, \"suffix\")\n    const externalProps = external\n      ? { rel: \"noopener noreferrer\", target: \"_blank\" }\n      : {}\n\n    return (\n      <a\n        href={href}\n        className={combinedClassName}\n        ref={ref}\n        {...restProps}\n        {...externalProps}\n      >\n        {prefixElement}\n        {label || children}\n        {suffixElement}\n      </a>\n    )\n  }\n)\n\nBaseLink.displayName = \"BaseLink\"\n"],"names":["React"],"mappings":";;;;AA0BA,MAAM,uBAAuB,GAAG,CAC9B,IAAoB,EACpB,IAAoB,EACpB,SAAmB,EACnB,SAAkB,KACR;AACV,IAAA,OAAO,UAAU,CACf,IAAI,IAAI,SAAS,EACjB,IAAI,IAAI,IAAI,KAAK,IAAI,IAAI,IAAI,IAAI,wBAAwB,CAAC,IAAI,CAAC,EAC/D,IAAI,IAAI,wBAAwB,CAAC,IAAI,CAAC,EACtC,SAAS,IAAI,qBAAqB,EAClC,SAAS,CACV;AACH,CAAC;AAEM,MAAM,QAAQ,GAAG,UAAU,CAChC,CACE,EACE,QAAQ,EACR,SAAS,EACT,QAAQ,GAAG,KAAK,EAChB,SAAS,EACT,IAAI,EACJ,IAAI,EACJ,KAAK,EACL,MAAM,EACN,IAAI,EACJ,MAAM,EACN,GAAG,SAAS,EACS,EACvB,GAAG,KACD;AACF,IAAA,MAAM,iBAAiB,GAAG,uBAAuB,CAC/C,IAAI,EACJ,IAAI,EACJ,SAAS,EACT,SAAS,CACV;IAED,MAAM,aAAa,GAAG,2BAA2B,CAAC,MAAM,EAAE,QAAQ,CAAC;IACnE,MAAM,aAAa,GAAG,2BAA2B,CAAC,MAAM,EAAE,QAAQ,CAAC;IACnE,MAAM,aAAa,GAAG;UAClB,EAAE,GAAG,EAAE,qBAAqB,EAAE,MAAM,EAAE,QAAQ;UAC9C,EAAE;AAEN,IAAA,QACEA,cAAA,CAAA,aAAA,CAAA,GAAA,EAAA,EACE,IAAI,EAAE,IAAI,EACV,SAAS,EAAE,iBAAiB,EAC5B,GAAG,EAAE,GAAG,EAAA,GACJ,SAAS,KACT,aAAa,EAAA;QAEhB,aAAa;AACb,QAAA,KAAK,IAAI,QAAQ;QACjB,aAAa,CACZ;AAER,CAAC;AAGH,QAAQ,CAAC,WAAW,GAAG,UAAU;;;;"}

package/dist/components/link/IconLink.d.ts

@@ -3,10 +3,12 @@ import React from "react";
 import { BaseLinkElementProps } from "./BaseLink";
 export type IconLinkProps = Omit<BaseLinkElementProps, "label" | "children"> & {
     "aria-label": string;
+    /** The icon element to display. */
     icon: React.ReactNode;
 };
 export declare const IconLink: React.ForwardRefExoticComponent<Omit<BaseLinkElementProps, "label" | "children"> & {
     "aria-label": string;
+    /** The icon element to display. */
     icon: React.ReactNode;
 } & React.RefAttributes<HTMLAnchorElement>>;
 //# sourceMappingURL=IconLink.d.ts.map

package/dist/components/link/IconLink.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"IconLink.d.ts","sourceRoot":"","sources":["../../../src/components/link/IconLink.tsx"],"names":[],"mappings":"AAAA,OAAO,mBAAmB,CAAA;AAG1B,OAAO,KAAqB,MAAM,OAAO,CAAA;AAEzC,OAAO,EAAY,oBAAoB,EAAE,MAAM,YAAY,CAAA;AAE3D,MAAM,MAAM,aAAa,GAAG,IAAI,CAAC,oBAAoB,EAAE,OAAO,GAAG,UAAU,CAAC,GAAG;IAC7E,YAAY,EAAE,MAAM,CAAA;IACpB,IAAI,EAAE,KAAK,CAAC,SAAS,CAAA;CACtB,CAAA;AAED,eAAO,MAAM,QAAQ;kBAJL,MAAM;UACd,KAAK,CAAC,SAAS;2CAiBtB,CAAA"}
+{"version":3,"file":"IconLink.d.ts","sourceRoot":"","sources":["../../../src/components/link/IconLink.tsx"],"names":[],"mappings":"AAAA,OAAO,mBAAmB,CAAA;AAG1B,OAAO,KAAqB,MAAM,OAAO,CAAA;AAEzC,OAAO,EAAY,oBAAoB,EAAE,MAAM,YAAY,CAAA;AAE3D,MAAM,MAAM,aAAa,GAAG,IAAI,CAAC,oBAAoB,EAAE,OAAO,GAAG,UAAU,CAAC,GAAG;IAC7E,YAAY,EAAE,MAAM,CAAA;IACpB,mCAAmC;IACnC,IAAI,EAAE,KAAK,CAAC,SAAS,CAAA;CACtB,CAAA;AAED,eAAO,MAAM,QAAQ;kBALL,MAAM;IACpB,mCAAmC;UAC7B,KAAK,CAAC,SAAS;2CAiBtB,CAAA"}

package/dist/components/link/IconLink.js.map

@@ -1 +1 @@
-{"version":3,"file":"IconLink.js","sources":["../../../src/components/link/IconLink.tsx"],"sourcesContent":["import \"../button/btn.css\"\n\nimport classNames from \"classnames\"\nimport React, { forwardRef } from \"react\"\n\nimport { BaseLink, BaseLinkElementProps } from \"./BaseLink\"\n\nexport type IconLinkProps = Omit<BaseLinkElementProps, \"label\" | \"children\"> & {\n  \"aria-label\": string\n  icon: React.ReactNode\n}\n\nexport const IconLink = forwardRef<HTMLAnchorElement, IconLinkProps>(\n  ({ className, href, icon, ...restProps }: IconLinkProps, ref) => {\n    const iconOnlyClassName = classNames(\"tds-btn--icononly\", className)\n\n    return (\n      <BaseLink\n        href={href}\n        label={icon}\n        className={iconOnlyClassName}\n        ref={ref}\n        {...restProps}\n      />\n    )\n  }\n)\n\nIconLink.displayName = \"IconLink\"\n"],"names":["React"],"mappings":";;;;MAYa,QAAQ,GAAG,UAAU,CAChC,CAAC,EAAE,SAAS,EAAE,IAAI,EAAE,IAAI,EAAE,GAAG,SAAS,EAAiB,EAAE,GAAG,KAAI;IAC9D,MAAM,iBAAiB,GAAG,UAAU,CAAC,mBAAmB,EAAE,SAAS,CAAC;IAEpE,QACEA,6BAAC,QAAQ,EAAA,EACP,IAAI,EAAE,IAAI,EACV,KAAK,EAAE,IAAI,EACX,SAAS,EAAE,iBAAiB,EAC5B,GAAG,EAAE,GAAG,EAAA,GACJ,SAAS,EAAA,CACb;AAEN,CAAC;AAGH,QAAQ,CAAC,WAAW,GAAG,UAAU;;;;"}
+{"version":3,"file":"IconLink.js","sources":["../../../src/components/link/IconLink.tsx"],"sourcesContent":["import \"../button/btn.css\"\n\nimport classNames from \"classnames\"\nimport React, { forwardRef } from \"react\"\n\nimport { BaseLink, BaseLinkElementProps } from \"./BaseLink\"\n\nexport type IconLinkProps = Omit<BaseLinkElementProps, \"label\" | \"children\"> & {\n  \"aria-label\": string\n  /** The icon element to display. */\n  icon: React.ReactNode\n}\n\nexport const IconLink = forwardRef<HTMLAnchorElement, IconLinkProps>(\n  ({ className, href, icon, ...restProps }: IconLinkProps, ref) => {\n    const iconOnlyClassName = classNames(\"tds-btn--icononly\", className)\n\n    return (\n      <BaseLink\n        href={href}\n        label={icon}\n        className={iconOnlyClassName}\n        ref={ref}\n        {...restProps}\n      />\n    )\n  }\n)\n\nIconLink.displayName = \"IconLink\"\n"],"names":["React"],"mappings":";;;;MAaa,QAAQ,GAAG,UAAU,CAChC,CAAC,EAAE,SAAS,EAAE,IAAI,EAAE,IAAI,EAAE,GAAG,SAAS,EAAiB,EAAE,GAAG,KAAI;IAC9D,MAAM,iBAAiB,GAAG,UAAU,CAAC,mBAAmB,EAAE,SAAS,CAAC;IAEpE,QACEA,6BAAC,QAAQ,EAAA,EACP,IAAI,EAAE,IAAI,EACV,KAAK,EAAE,IAAI,EACX,SAAS,EAAE,iBAAiB,EAC5B,GAAG,EAAE,GAAG,EAAA,GACJ,SAAS,EAAA,CACb;AAEN,CAAC;AAGH,QAAQ,CAAC,WAAW,GAAG,UAAU;;;;"}

package/dist/components/page-header/PageHeader.d.ts

@@ -1,7 +1,8 @@
 import React from "react";
 export declare function PageHeader({ children, actions, navigation, className, inactive, profile, }: {
     /**
-     * Additional content (typically actions) that complements the primary slot.
+     * Actions to be displayed on the right side of the header. Elements
+     * should be styled as buttons.
      */
     actions?: React.ReactNode;
     /**
@@ -14,8 +15,10 @@ export declare function PageHeader({ children, actions, navigation, className, i
      */
     inactive?: boolean;
     /**
-     * Navigation for the page. Should contain an unstyled unordered list (ul)
-     * that contains a list of links or buttons.
+     * Navigation links to be displayed on the left side of the header.
+     * Contents should be an unordered list with items being links or
+     * buttons. Specify `selected` for the active link (as well as adding
+     * `aria-current="page"` for accessibility).
      */
     navigation?: React.ReactNode;
     /**

package/dist/components/page-header/PageHeader.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"PageHeader.d.ts","sourceRoot":"","sources":["../../../src/components/page-header/PageHeader.tsx"],"names":[],"mappings":"AACA,OAAO,KAA4B,MAAM,OAAO,CAAA;AAEhD,wBAAgB,UAAU,CAAC,EACzB,QAAQ,EACR,OAAO,EACP,UAAU,EACV,SAAS,EACT,QAAgB,EAChB,OAAe,GAChB,EAAE;IACD;;OAEG;IACH,OAAO,CAAC,EAAE,KAAK,CAAC,SAAS,CAAA;IACzB;;OAEG;IACH,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAA;IACzB,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB;;OAEG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB;;;OAGG;IACH,UAAU,CAAC,EAAE,KAAK,CAAC,SAAS,CAAA;IAC5B;;OAEG;IACH,OAAO,CAAC,EAAE,OAAO,CAAA;CAClB,qBA+BA"}
+{"version":3,"file":"PageHeader.d.ts","sourceRoot":"","sources":["../../../src/components/page-header/PageHeader.tsx"],"names":[],"mappings":"AACA,OAAO,KAA4B,MAAM,OAAO,CAAA;AAEhD,wBAAgB,UAAU,CAAC,EACzB,QAAQ,EACR,OAAO,EACP,UAAU,EACV,SAAS,EACT,QAAgB,EAChB,OAAe,GAChB,EAAE;IACD;;;OAGG;IACH,OAAO,CAAC,EAAE,KAAK,CAAC,SAAS,CAAA;IACzB;;OAEG;IACH,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAA;IACzB,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB;;OAEG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB;;;;;OAKG;IACH,UAAU,CAAC,EAAE,KAAK,CAAC,SAAS,CAAA;IAC5B;;OAEG;IACH,OAAO,CAAC,EAAE,OAAO,CAAA;CAClB,qBA+BA"}

package/dist/components/page-header/PageHeader.js.map

@@ -1 +1 @@
-{"version":3,"file":"PageHeader.js","sources":["../../../src/components/page-header/PageHeader.tsx"],"sourcesContent":["import classNames from \"classnames\"\nimport React, { useEffect, useRef } from \"react\"\n\nexport function PageHeader({\n  children,\n  actions,\n  navigation,\n  className,\n  inactive = false,\n  profile = false,\n}: {\n  /**\n   * Additional content (typically actions) that complements the primary slot.\n   */\n  actions?: React.ReactNode\n  /**\n   * The main content of the page header. It will be displayed prominently. For simple pages, providing a h1 will suffice.\n   */\n  children: React.ReactNode\n  className?: string\n  /**\n   * Indicates whether the page header is inactive or not. When set to true, the page header is visually inactive\n   */\n  inactive?: boolean\n  /**\n   * Navigation for the page. Should contain an unstyled unordered list (ul)\n   * that contains a list of links or buttons.\n   */\n  navigation?: React.ReactNode\n  /**\n   * Indicates whether the page header is a profile page header or not. When set to true, the page header will visually center the title and actions at mobile breakpoints.\n   */\n  profile?: boolean\n}) {\n  const hasMultiActions = actions\n    ? React.isValidElement(actions) && actions.type === React.Fragment\n      ? React.Children.count(actions.props.children) > 1\n      : React.Children.count(actions) > 1\n    : false\n\n  const nav = useScrollToSelected(navigation)\n\n  return (\n    <header\n      className={classNames(\"tds-page-header\", className, {\n        \"has-multi-actions\": hasMultiActions,\n        \"has-nav\": !!navigation,\n        inactive,\n        \"tds-page-header--profile\": profile,\n      })}\n    >\n      <div className=\"tds-page-header__title-bar\">\n        <div className=\"tds-page-header__primary\">{children}</div>\n        {actions && (\n          <div className=\"tds-page-header__actions tds-no-print\">{actions}</div>\n        )}\n      </div>\n      {navigation && (\n        <nav ref={nav} className=\"tds-page-header__nav tds-no-print\">\n          {navigation}\n        </nav>\n      )}\n    </header>\n  )\n}\n\nfunction useScrollToSelected(navigation: React.ReactNode) {\n  const nav = useRef<HTMLElement>(null)\n  useEffect(() => {\n    if (!nav.current) return\n    const ulElement = nav.current.querySelector(\"ul\")\n    if (!ulElement) return\n    const selectedItem = ulElement.querySelector(\".selected\")\n    if (selectedItem) {\n      const bounds = selectedItem.getBoundingClientRect()\n      const ulBounds = ulElement.getBoundingClientRect()\n      if (bounds.right > ulBounds.right || bounds.left < ulBounds.left) {\n        ulElement.scrollTo({\n          left: ulElement.scrollLeft + bounds.left - ulBounds.left,\n        })\n      }\n    }\n  }, [navigation])\n  return nav\n}\n"],"names":[],"mappings":";;;SAGgB,UAAU,CAAC,EACzB,QAAQ,EACR,OAAO,EACP,UAAU,EACV,SAAS,EACT,QAAQ,GAAG,KAAK,EAChB,OAAO,GAAG,KAAK,GAwBhB,EAAA;IACC,MAAM,eAAe,GAAG;AACtB,UAAE,KAAK,CAAC,cAAc,CAAC,OAAO,CAAC,IAAI,OAAO,CAAC,IAAI,KAAK,KAAK,CAAC;AACxD,cAAE,KAAK,CAAC,QAAQ,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,QAAQ,CAAC,GAAG;cAC/C,KAAK,CAAC,QAAQ,CAAC,KAAK,CAAC,OAAO,CAAC,GAAG;UAClC,KAAK;AAET,IAAA,MAAM,GAAG,GAAG,mBAAmB,CAAC,UAAU,CAAC;IAE3C,QACE,gCACE,SAAS,EAAE,UAAU,CAAC,iBAAiB,EAAE,SAAS,EAAE;AAClD,YAAA,mBAAmB,EAAE,eAAe;YACpC,SAAS,EAAE,CAAC,CAAC,UAAU;YACvB,QAAQ;AACR,YAAA,0BAA0B,EAAE,OAAO;SACpC,CAAC,EAAA;QAEF,KAAA,CAAA,aAAA,CAAA,KAAA,EAAA,EAAK,SAAS,EAAC,4BAA4B,EAAA;AACzC,YAAA,KAAA,CAAA,aAAA,CAAA,KAAA,EAAA,EAAK,SAAS,EAAC,0BAA0B,EAAA,EAAE,QAAQ,CAAO;YACzD,OAAO,KACN,KAAA,CAAA,aAAA,CAAA,KAAA,EAAA,EAAK,SAAS,EAAC,uCAAuC,EAAA,EAAE,OAAO,CAAO,CACvE,CACG;AACL,QAAA,UAAU,KACT,KAAA,CAAA,aAAA,CAAA,KAAA,EAAA,EAAK,GAAG,EAAE,GAAG,EAAE,SAAS,EAAC,mCAAmC,IACzD,UAAU,CACP,CACP,CACM;AAEb;AAEA,SAAS,mBAAmB,CAAC,UAA2B,EAAA;AACtD,IAAA,MAAM,GAAG,GAAG,MAAM,CAAc,IAAI,CAAC;IACrC,SAAS,CAAC,MAAK;QACb,IAAI,CAAC,GAAG,CAAC,OAAO;YAAE;QAClB,MAAM,SAAS,GAAG,GAAG,CAAC,OAAO,CAAC,aAAa,CAAC,IAAI,CAAC;AACjD,QAAA,IAAI,CAAC,SAAS;YAAE;QAChB,MAAM,YAAY,GAAG,SAAS,CAAC,aAAa,CAAC,WAAW,CAAC;QACzD,IAAI,YAAY,EAAE;AAChB,YAAA,MAAM,MAAM,GAAG,YAAY,CAAC,qBAAqB,EAAE;AACnD,YAAA,MAAM,QAAQ,GAAG,SAAS,CAAC,qBAAqB,EAAE;AAClD,YAAA,IAAI,MAAM,CAAC,KAAK,GAAG,QAAQ,CAAC,KAAK,IAAI,MAAM,CAAC,IAAI,GAAG,QAAQ,CAAC,IAAI,EAAE;gBAChE,SAAS,CAAC,QAAQ,CAAC;oBACjB,IAAI,EAAE,SAAS,CAAC,UAAU,GAAG,MAAM,CAAC,IAAI,GAAG,QAAQ,CAAC,IAAI;AACzD,iBAAA,CAAC;YACJ;QACF;AACF,IAAA,CAAC,EAAE,CAAC,UAAU,CAAC,CAAC;AAChB,IAAA,OAAO,GAAG;AACZ;;;;"}
+{"version":3,"file":"PageHeader.js","sources":["../../../src/components/page-header/PageHeader.tsx"],"sourcesContent":["import classNames from \"classnames\"\nimport React, { useEffect, useRef } from \"react\"\n\nexport function PageHeader({\n  children,\n  actions,\n  navigation,\n  className,\n  inactive = false,\n  profile = false,\n}: {\n  /**\n   * Actions to be displayed on the right side of the header. Elements\n   * should be styled as buttons.\n   */\n  actions?: React.ReactNode\n  /**\n   * The main content of the page header. It will be displayed prominently. For simple pages, providing a h1 will suffice.\n   */\n  children: React.ReactNode\n  className?: string\n  /**\n   * Indicates whether the page header is inactive or not. When set to true, the page header is visually inactive\n   */\n  inactive?: boolean\n  /**\n   * Navigation links to be displayed on the left side of the header.\n   * Contents should be an unordered list with items being links or\n   * buttons. Specify `selected` for the active link (as well as adding\n   * `aria-current=\"page\"` for accessibility).\n   */\n  navigation?: React.ReactNode\n  /**\n   * Indicates whether the page header is a profile page header or not. When set to true, the page header will visually center the title and actions at mobile breakpoints.\n   */\n  profile?: boolean\n}) {\n  const hasMultiActions = actions\n    ? React.isValidElement(actions) && actions.type === React.Fragment\n      ? React.Children.count(actions.props.children) > 1\n      : React.Children.count(actions) > 1\n    : false\n\n  const nav = useScrollToSelected(navigation)\n\n  return (\n    <header\n      className={classNames(\"tds-page-header\", className, {\n        \"has-multi-actions\": hasMultiActions,\n        \"has-nav\": !!navigation,\n        inactive,\n        \"tds-page-header--profile\": profile,\n      })}\n    >\n      <div className=\"tds-page-header__title-bar\">\n        <div className=\"tds-page-header__primary\">{children}</div>\n        {actions && (\n          <div className=\"tds-page-header__actions tds-no-print\">{actions}</div>\n        )}\n      </div>\n      {navigation && (\n        <nav ref={nav} className=\"tds-page-header__nav tds-no-print\">\n          {navigation}\n        </nav>\n      )}\n    </header>\n  )\n}\n\nfunction useScrollToSelected(navigation: React.ReactNode) {\n  const nav = useRef<HTMLElement>(null)\n  useEffect(() => {\n    if (!nav.current) return\n    const ulElement = nav.current.querySelector(\"ul\")\n    if (!ulElement) return\n    const selectedItem = ulElement.querySelector(\".selected\")\n    if (selectedItem) {\n      const bounds = selectedItem.getBoundingClientRect()\n      const ulBounds = ulElement.getBoundingClientRect()\n      if (bounds.right > ulBounds.right || bounds.left < ulBounds.left) {\n        ulElement.scrollTo({\n          left: ulElement.scrollLeft + bounds.left - ulBounds.left,\n        })\n      }\n    }\n  }, [navigation])\n  return nav\n}\n"],"names":[],"mappings":";;;SAGgB,UAAU,CAAC,EACzB,QAAQ,EACR,OAAO,EACP,UAAU,EACV,SAAS,EACT,QAAQ,GAAG,KAAK,EAChB,OAAO,GAAG,KAAK,GA2BhB,EAAA;IACC,MAAM,eAAe,GAAG;AACtB,UAAE,KAAK,CAAC,cAAc,CAAC,OAAO,CAAC,IAAI,OAAO,CAAC,IAAI,KAAK,KAAK,CAAC;AACxD,cAAE,KAAK,CAAC,QAAQ,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,QAAQ,CAAC,GAAG;cAC/C,KAAK,CAAC,QAAQ,CAAC,KAAK,CAAC,OAAO,CAAC,GAAG;UAClC,KAAK;AAET,IAAA,MAAM,GAAG,GAAG,mBAAmB,CAAC,UAAU,CAAC;IAE3C,QACE,gCACE,SAAS,EAAE,UAAU,CAAC,iBAAiB,EAAE,SAAS,EAAE;AAClD,YAAA,mBAAmB,EAAE,eAAe;YACpC,SAAS,EAAE,CAAC,CAAC,UAAU;YACvB,QAAQ;AACR,YAAA,0BAA0B,EAAE,OAAO;SACpC,CAAC,EAAA;QAEF,KAAA,CAAA,aAAA,CAAA,KAAA,EAAA,EAAK,SAAS,EAAC,4BAA4B,EAAA;AACzC,YAAA,KAAA,CAAA,aAAA,CAAA,KAAA,EAAA,EAAK,SAAS,EAAC,0BAA0B,EAAA,EAAE,QAAQ,CAAO;YACzD,OAAO,KACN,KAAA,CAAA,aAAA,CAAA,KAAA,EAAA,EAAK,SAAS,EAAC,uCAAuC,EAAA,EAAE,OAAO,CAAO,CACvE,CACG;AACL,QAAA,UAAU,KACT,KAAA,CAAA,aAAA,CAAA,KAAA,EAAA,EAAK,GAAG,EAAE,GAAG,EAAE,SAAS,EAAC,mCAAmC,IACzD,UAAU,CACP,CACP,CACM;AAEb;AAEA,SAAS,mBAAmB,CAAC,UAA2B,EAAA;AACtD,IAAA,MAAM,GAAG,GAAG,MAAM,CAAc,IAAI,CAAC;IACrC,SAAS,CAAC,MAAK;QACb,IAAI,CAAC,GAAG,CAAC,OAAO;YAAE;QAClB,MAAM,SAAS,GAAG,GAAG,CAAC,OAAO,CAAC,aAAa,CAAC,IAAI,CAAC;AACjD,QAAA,IAAI,CAAC,SAAS;YAAE;QAChB,MAAM,YAAY,GAAG,SAAS,CAAC,aAAa,CAAC,WAAW,CAAC;QACzD,IAAI,YAAY,EAAE;AAChB,YAAA,MAAM,MAAM,GAAG,YAAY,CAAC,qBAAqB,EAAE;AACnD,YAAA,MAAM,QAAQ,GAAG,SAAS,CAAC,qBAAqB,EAAE;AAClD,YAAA,IAAI,MAAM,CAAC,KAAK,GAAG,QAAQ,CAAC,KAAK,IAAI,MAAM,CAAC,IAAI,GAAG,QAAQ,CAAC,IAAI,EAAE;gBAChE,SAAS,CAAC,QAAQ,CAAC;oBACjB,IAAI,EAAE,SAAS,CAAC,UAAU,GAAG,MAAM,CAAC,IAAI,GAAG,QAAQ,CAAC,IAAI;AACzD,iBAAA,CAAC;YACJ;QACF;AACF,IAAA,CAAC,EAAE,CAAC,UAAU,CAAC,CAAC;AAChB,IAAA,OAAO,GAAG;AACZ;;;;"}

package/dist/components/radio/Radio.d.ts

@@ -2,8 +2,11 @@ import "./index.css";
 import React, { InputHTMLAttributes } from "react";
 export type RadioSize = "md" | "sm";
 interface RadioBaseProps {
+    /** Optional description text that appears below the radio label. */
     description?: string;
+    /** The name of the radio group. All radios in the group must have the same name. */
     name: string;
+    /** The size of the radio. */
     size?: RadioSize;
 }
 interface RadioWithLabel extends RadioBaseProps {

package/dist/components/radio/Radio.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Radio.d.ts","sourceRoot":"","sources":["../../../src/components/radio/Radio.tsx"],"names":[],"mappings":"AAAA,OAAO,aAAa,CAAA;AAIpB,OAAO,KAAK,EAAE,EAAc,mBAAmB,EAAE,MAAM,OAAO,CAAA;AAE9D,MAAM,MAAM,SAAS,GAAG,IAAI,GAAG,IAAI,CAAA;AAEnC,UAAU,cAAc;IACtB,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,CAAC,EAAE,SAAS,CAAA;CACjB;AAED,UAAU,cAAe,SAAQ,cAAc;IAC7C,iBAAiB,CAAC,EAAE,KAAK,CAAA;IACzB;;;;;OAKG;IACH,KAAK,EAAE,KAAK,CAAC,SAAS,CAAA;CACvB;AAED,UAAU,uBAAwB,SAAQ,cAAc;IACtD,iBAAiB,EAAE,MAAM,CAAA;IACzB,KAAK,CAAC,EAAE,KAAK,CAAA;CACd;AAED,MAAM,MAAM,UAAU,GAAG,cAAc,GAAG,uBAAuB,CAAA;AAEjE,MAAM,MAAM,iBAAiB,GAAG,IAAI,CAClC,mBAAmB,CAAC,gBAAgB,CAAC,EACrC,MAAM,UAAU,GAAG,MAAM,CAC1B,GACC,UAAU,CAAA;AAEZ;;;;;;;;;;;;;;GAcG;AACH,eAAO,MAAM,KAAK,4FAuCjB,CAAA"}
+{"version":3,"file":"Radio.d.ts","sourceRoot":"","sources":["../../../src/components/radio/Radio.tsx"],"names":[],"mappings":"AAAA,OAAO,aAAa,CAAA;AAIpB,OAAO,KAAK,EAAE,EAAc,mBAAmB,EAAE,MAAM,OAAO,CAAA;AAE9D,MAAM,MAAM,SAAS,GAAG,IAAI,GAAG,IAAI,CAAA;AAEnC,UAAU,cAAc;IACtB,oEAAoE;IACpE,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,oFAAoF;IACpF,IAAI,EAAE,MAAM,CAAA;IACZ,6BAA6B;IAC7B,IAAI,CAAC,EAAE,SAAS,CAAA;CACjB;AAED,UAAU,cAAe,SAAQ,cAAc;IAC7C,iBAAiB,CAAC,EAAE,KAAK,CAAA;IACzB;;;;;OAKG;IACH,KAAK,EAAE,KAAK,CAAC,SAAS,CAAA;CACvB;AAED,UAAU,uBAAwB,SAAQ,cAAc;IACtD,iBAAiB,EAAE,MAAM,CAAA;IACzB,KAAK,CAAC,EAAE,KAAK,CAAA;CACd;AAED,MAAM,MAAM,UAAU,GAAG,cAAc,GAAG,uBAAuB,CAAA;AAEjE,MAAM,MAAM,iBAAiB,GAAG,IAAI,CAClC,mBAAmB,CAAC,gBAAgB,CAAC,EACrC,MAAM,UAAU,GAAG,MAAM,CAC1B,GACC,UAAU,CAAA;AAEZ;;;;;;;;;;;;;;GAcG;AACH,eAAO,MAAM,KAAK,4FAuCjB,CAAA"}

package/dist/components/radio/Radio.js.map

@@ -1 +1 @@
-{"version":3,"file":"Radio.js","sources":["../../../src/components/radio/Radio.tsx"],"sourcesContent":["import \"./index.css\"\n\nimport { useId } from \"@utilities/useId\"\nimport classNames from \"classnames\"\nimport React, { forwardRef, InputHTMLAttributes } from \"react\"\n\nexport type RadioSize = \"md\" | \"sm\"\n\ninterface RadioBaseProps {\n  description?: string\n  name: string\n  size?: RadioSize\n}\n\ninterface RadioWithLabel extends RadioBaseProps {\n  \"aria-labelledby\"?: never\n  /**\n   * Label content for the radio. When using non-string content\n   * (e.g. JSX), it must not contain interactive elements. This\n   * includes native HTML elements such as `<a>` and `<button>`, as\n   * well as Tapestry or Tapestry-React interactive components.\n   */\n  label: React.ReactNode\n}\n\ninterface RadioWithAriaLabelledBy extends RadioBaseProps {\n  \"aria-labelledby\": string\n  label?: never\n}\n\nexport type RadioProps = RadioWithLabel | RadioWithAriaLabelledBy\n\nexport type RadioElementProps = Omit<\n  InputHTMLAttributes<HTMLInputElement>,\n  keyof RadioProps | \"type\"\n> &\n  RadioProps\n\n/**\n * A radio component that renders as a radio input with label.\n * Supports various sizes.\n * Must have a name attribute.\n *\n * **Required:** You must provide either:\n * - `label` - Label content for the radio\n * - `aria-labelledby` - ID of an external element that provides the label\n *\n * When using non-string content for `label` (e.g. JSX), it must not contain\n * interactive elements. This includes native HTML elements such as `<a>` and\n * `<button>`, as well as Tapestry or Tapestry-React interactive components.\n *\n * @component\n */\nexport const Radio = forwardRef<HTMLInputElement, RadioElementProps>(\n  (\n    {\n      className,\n      description,\n      id,\n      label,\n      size = \"md\",\n      ...restProps\n    }: RadioElementProps,\n    ref\n  ) => {\n    const combinedClassName = classNames(\n      \"tds-radio\",\n      size && size === \"sm\" && `tds-radio--sm`,\n      className\n    )\n\n    const stableId = useId()\n    const radioId = id || `tds-radio-${stableId}`\n\n    return (\n      <div className={combinedClassName}>\n        <input\n          {...restProps}\n          aria-describedby={description ? `${radioId}-description` : undefined}\n          id={radioId}\n          ref={ref}\n          type=\"radio\"\n        />\n        {label && <label htmlFor={radioId}>{label}</label>}\n        {description && (\n          <p id={`${radioId}-description`} className=\"tds-radio-description\">\n            {description}\n          </p>\n        )}\n      </div>\n    )\n  }\n)\n\nRadio.displayName = \"Radio\"\n"],"names":["React"],"mappings":";;;;AAsCA;;;;;;;;;;;;;;AAcG;AACI,MAAM,KAAK,GAAG,UAAU,CAC7B,CACE,EACE,SAAS,EACT,WAAW,EACX,EAAE,EACF,KAAK,EACL,IAAI,GAAG,IAAI,EACX,GAAG,SAAS,EACM,EACpB,GAAG,KACD;AACF,IAAA,MAAM,iBAAiB,GAAG,UAAU,CAClC,WAAW,EACX,IAAI,IAAI,IAAI,KAAK,IAAI,IAAI,CAAA,aAAA,CAAe,EACxC,SAAS,CACV;AAED,IAAA,MAAM,QAAQ,GAAG,KAAK,EAAE;AACxB,IAAA,MAAM,OAAO,GAAG,EAAE,IAAI,CAAA,UAAA,EAAa,QAAQ,EAAE;AAE7C,IAAA,QACEA,cAAA,CAAA,aAAA,CAAA,KAAA,EAAA,EAAK,SAAS,EAAE,iBAAiB,EAAA;QAC/BA,cAAA,CAAA,aAAA,CAAA,OAAA,EAAA,EAAA,GACM,SAAS,EAAA,kBAAA,EACK,WAAW,GAAG,CAAA,EAAG,OAAO,CAAA,YAAA,CAAc,GAAG,SAAS,EACpE,EAAE,EAAE,OAAO,EACX,GAAG,EAAE,GAAG,EACR,IAAI,EAAC,OAAO,EAAA,CACZ;AACD,QAAA,KAAK,IAAIA,cAAA,CAAA,aAAA,CAAA,OAAA,EAAA,EAAO,OAAO,EAAE,OAAO,EAAA,EAAG,KAAK,CAAS;AACjD,QAAA,WAAW,KACVA,cAAA,CAAA,aAAA,CAAA,GAAA,EAAA,EAAG,EAAE,EAAE,CAAA,EAAG,OAAO,CAAA,YAAA,CAAc,EAAE,SAAS,EAAC,uBAAuB,EAAA,EAC/D,WAAW,CACV,CACL,CACG;AAEV,CAAC;AAGH,KAAK,CAAC,WAAW,GAAG,OAAO;;;;"}
+{"version":3,"file":"Radio.js","sources":["../../../src/components/radio/Radio.tsx"],"sourcesContent":["import \"./index.css\"\n\nimport { useId } from \"@utilities/useId\"\nimport classNames from \"classnames\"\nimport React, { forwardRef, InputHTMLAttributes } from \"react\"\n\nexport type RadioSize = \"md\" | \"sm\"\n\ninterface RadioBaseProps {\n  /** Optional description text that appears below the radio label. */\n  description?: string\n  /** The name of the radio group. All radios in the group must have the same name. */\n  name: string\n  /** The size of the radio. */\n  size?: RadioSize\n}\n\ninterface RadioWithLabel extends RadioBaseProps {\n  \"aria-labelledby\"?: never\n  /**\n   * Label content for the radio. When using non-string content\n   * (e.g. JSX), it must not contain interactive elements. This\n   * includes native HTML elements such as `<a>` and `<button>`, as\n   * well as Tapestry or Tapestry-React interactive components.\n   */\n  label: React.ReactNode\n}\n\ninterface RadioWithAriaLabelledBy extends RadioBaseProps {\n  \"aria-labelledby\": string\n  label?: never\n}\n\nexport type RadioProps = RadioWithLabel | RadioWithAriaLabelledBy\n\nexport type RadioElementProps = Omit<\n  InputHTMLAttributes<HTMLInputElement>,\n  keyof RadioProps | \"type\"\n> &\n  RadioProps\n\n/**\n * A radio component that renders as a radio input with label.\n * Supports various sizes.\n * Must have a name attribute.\n *\n * **Required:** You must provide either:\n * - `label` - Label content for the radio\n * - `aria-labelledby` - ID of an external element that provides the label\n *\n * When using non-string content for `label` (e.g. JSX), it must not contain\n * interactive elements. This includes native HTML elements such as `<a>` and\n * `<button>`, as well as Tapestry or Tapestry-React interactive components.\n *\n * @component\n */\nexport const Radio = forwardRef<HTMLInputElement, RadioElementProps>(\n  (\n    {\n      className,\n      description,\n      id,\n      label,\n      size = \"md\",\n      ...restProps\n    }: RadioElementProps,\n    ref\n  ) => {\n    const combinedClassName = classNames(\n      \"tds-radio\",\n      size && size === \"sm\" && `tds-radio--sm`,\n      className\n    )\n\n    const stableId = useId()\n    const radioId = id || `tds-radio-${stableId}`\n\n    return (\n      <div className={combinedClassName}>\n        <input\n          {...restProps}\n          aria-describedby={description ? `${radioId}-description` : undefined}\n          id={radioId}\n          ref={ref}\n          type=\"radio\"\n        />\n        {label && <label htmlFor={radioId}>{label}</label>}\n        {description && (\n          <p id={`${radioId}-description`} className=\"tds-radio-description\">\n            {description}\n          </p>\n        )}\n      </div>\n    )\n  }\n)\n\nRadio.displayName = \"Radio\"\n"],"names":["React"],"mappings":";;;;AAyCA;;;;;;;;;;;;;;AAcG;AACI,MAAM,KAAK,GAAG,UAAU,CAC7B,CACE,EACE,SAAS,EACT,WAAW,EACX,EAAE,EACF,KAAK,EACL,IAAI,GAAG,IAAI,EACX,GAAG,SAAS,EACM,EACpB,GAAG,KACD;AACF,IAAA,MAAM,iBAAiB,GAAG,UAAU,CAClC,WAAW,EACX,IAAI,IAAI,IAAI,KAAK,IAAI,IAAI,CAAA,aAAA,CAAe,EACxC,SAAS,CACV;AAED,IAAA,MAAM,QAAQ,GAAG,KAAK,EAAE;AACxB,IAAA,MAAM,OAAO,GAAG,EAAE,IAAI,CAAA,UAAA,EAAa,QAAQ,EAAE;AAE7C,IAAA,QACEA,cAAA,CAAA,aAAA,CAAA,KAAA,EAAA,EAAK,SAAS,EAAE,iBAAiB,EAAA;QAC/BA,cAAA,CAAA,aAAA,CAAA,OAAA,EAAA,EAAA,GACM,SAAS,EAAA,kBAAA,EACK,WAAW,GAAG,CAAA,EAAG,OAAO,CAAA,YAAA,CAAc,GAAG,SAAS,EACpE,EAAE,EAAE,OAAO,EACX,GAAG,EAAE,GAAG,EACR,IAAI,EAAC,OAAO,EAAA,CACZ;AACD,QAAA,KAAK,IAAIA,cAAA,CAAA,aAAA,CAAA,OAAA,EAAA,EAAO,OAAO,EAAE,OAAO,EAAA,EAAG,KAAK,CAAS;AACjD,QAAA,WAAW,KACVA,cAAA,CAAA,aAAA,CAAA,GAAA,EAAA,EAAG,EAAE,EAAE,CAAA,EAAG,OAAO,CAAA,YAAA,CAAc,EAAE,SAAS,EAAC,uBAAuB,EAAA,EAC/D,WAAW,CACV,CACL,CACG;AAEV,CAAC;AAGH,KAAK,CAAC,WAAW,GAAG,OAAO;;;;"}

package/dist/components/radio-group/RadioGroup.d.ts

@@ -2,9 +2,13 @@ import "./index.css";
 import React, { FieldsetHTMLAttributes } from "react";
 export type RadioGroupSize = "md" | "sm";
 export interface RadioGroupProps {
+    /** Optional description text that appears below the label. */
     description?: string;
+    /** Is invalid. If true, include a description to explain why; and if no description is provided, description defaults to "Please select an option". */
     invalid?: boolean;
+    /** The label text (required). Renders as `<legend>` (not `<label>`) because `RadioGroup` is a `<fieldset>`. */
     label: string;
+    /** The size. Does not affect child radios. */
     size?: RadioGroupSize;
 }
 export type RadioGroupElementProps = Omit<FieldsetHTMLAttributes<HTMLFieldSetElement>, keyof RadioGroupProps> & RadioGroupProps;

package/dist/components/radio-group/RadioGroup.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"RadioGroup.d.ts","sourceRoot":"","sources":["../../../src/components/radio-group/RadioGroup.tsx"],"names":[],"mappings":"AAAA,OAAO,aAAa,CAAA;AAKpB,OAAO,KAAK,EAAE,EAAE,sBAAsB,EAAE,MAAM,OAAO,CAAA;AAErD,MAAM,MAAM,cAAc,GAAG,IAAI,GAAG,IAAI,CAAA;AAExC,MAAM,WAAW,eAAe;IAC9B,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,OAAO,CAAC,EAAE,OAAO,CAAA;IACjB,KAAK,EAAE,MAAM,CAAA;IACb,IAAI,CAAC,EAAE,cAAc,CAAA;CACtB;AAED,MAAM,MAAM,sBAAsB,GAAG,IAAI,CACvC,sBAAsB,CAAC,mBAAmB,CAAC,EAC3C,MAAM,eAAe,CACtB,GACC,eAAe,CAAA;AAEjB;;;;;;;GAOG;AACH,eAAO,MAAM,UAAU;+EAQpB,sBAAsB;;CAiCxB,CAAA"}
+{"version":3,"file":"RadioGroup.d.ts","sourceRoot":"","sources":["../../../src/components/radio-group/RadioGroup.tsx"],"names":[],"mappings":"AAAA,OAAO,aAAa,CAAA;AAKpB,OAAO,KAAK,EAAE,EAAE,sBAAsB,EAAE,MAAM,OAAO,CAAA;AAErD,MAAM,MAAM,cAAc,GAAG,IAAI,GAAG,IAAI,CAAA;AAExC,MAAM,WAAW,eAAe;IAC9B,8DAA8D;IAC9D,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,uJAAuJ;IACvJ,OAAO,CAAC,EAAE,OAAO,CAAA;IACjB,+GAA+G;IAC/G,KAAK,EAAE,MAAM,CAAA;IACb,8CAA8C;IAC9C,IAAI,CAAC,EAAE,cAAc,CAAA;CACtB;AAED,MAAM,MAAM,sBAAsB,GAAG,IAAI,CACvC,sBAAsB,CAAC,mBAAmB,CAAC,EAC3C,MAAM,eAAe,CACtB,GACC,eAAe,CAAA;AAEjB;;;;;;;GAOG;AACH,eAAO,MAAM,UAAU;+EAQpB,sBAAsB;;CAiCxB,CAAA"}

package/dist/components/radio-group/RadioGroup.js.map

@@ -1 +1 @@
-{"version":3,"file":"RadioGroup.js","sources":["../../../src/components/radio-group/RadioGroup.tsx"],"sourcesContent":["import \"./index.css\"\n\nimport Icon from \"@utilities/Icon\"\nimport { useId } from \"@utilities/useId\"\nimport classNames from \"classnames\"\nimport React, { FieldsetHTMLAttributes } from \"react\"\n\nexport type RadioGroupSize = \"md\" | \"sm\"\n\nexport interface RadioGroupProps {\n  description?: string\n  invalid?: boolean\n  label: string\n  size?: RadioGroupSize\n}\n\nexport type RadioGroupElementProps = Omit<\n  FieldsetHTMLAttributes<HTMLFieldSetElement>,\n  keyof RadioGroupProps\n> &\n  RadioGroupProps\n\n/**\n * A radio group component that renders as a fieldset with legend.\n * Use to group two or more Radio components.\n * Supports label and description text, sizes, invalid, and disabled state.\n * Label is required and must be a string. Renders as <legend>.\n *\n * @component\n */\nexport const RadioGroup = ({\n  children,\n  className,\n  description,\n  invalid,\n  label,\n  size = \"md\",\n  ...restProps\n}: RadioGroupElementProps) => {\n  const combinedClassName = classNames(\n    \"tds-radio-group\",\n    size && size === \"sm\" && \"tds-radio-group--sm\",\n    className\n  )\n  const stableId = useId()\n\n  const displayDescription =\n    description || (invalid ? \"Please select an option\" : undefined)\n  const descriptionId = `tds-radio-group-${stableId}-description`\n\n  return (\n    <fieldset\n      {...restProps}\n      aria-describedby={displayDescription ? descriptionId : undefined}\n      aria-invalid={invalid ? \"true\" : undefined}\n      className={combinedClassName}\n    >\n      <legend>{label}</legend>\n      {displayDescription && (\n        <p id={descriptionId} className=\"tds-radio-group-description\">\n          <Icon\n            className=\"tds-radio-group-description-invalid-icon\"\n            symbol=\"general#exclamation-triangle\"\n            aria-hidden\n          />\n          {displayDescription}\n        </p>\n      )}\n      <div className=\"tds-radio-group-fields\">{children}</div>\n    </fieldset>\n  )\n}\n\nRadioGroup.displayName = \"RadioGroup\"\n"],"names":["React"],"mappings":";;;;;AAsBA;;;;;;;AAOG;AACI,MAAM,UAAU,GAAG,CAAC,EACzB,QAAQ,EACR,SAAS,EACT,WAAW,EACX,OAAO,EACP,KAAK,EACL,IAAI,GAAG,IAAI,EACX,GAAG,SAAS,EACW,KAAI;AAC3B,IAAA,MAAM,iBAAiB,GAAG,UAAU,CAClC,iBAAiB,EACjB,IAAI,IAAI,IAAI,KAAK,IAAI,IAAI,qBAAqB,EAC9C,SAAS,CACV;AACD,IAAA,MAAM,QAAQ,GAAG,KAAK,EAAE;AAExB,IAAA,MAAM,kBAAkB,GACtB,WAAW,KAAK,OAAO,GAAG,yBAAyB,GAAG,SAAS,CAAC;AAClE,IAAA,MAAM,aAAa,GAAG,CAAA,gBAAA,EAAmB,QAAQ,cAAc;IAE/D,QACEA,cAAA,CAAA,aAAA,CAAA,UAAA,EAAA,EAAA,GACM,SAAS,EAAA,kBAAA,EACK,kBAAkB,GAAG,aAAa,GAAG,SAAS,kBAClD,OAAO,GAAG,MAAM,GAAG,SAAS,EAC1C,SAAS,EAAE,iBAAiB,EAAA;AAE5B,QAAAA,cAAA,CAAA,aAAA,CAAA,QAAA,EAAA,IAAA,EAAS,KAAK,CAAU;QACvB,kBAAkB,KACjBA,cAAA,CAAA,aAAA,CAAA,GAAA,EAAA,EAAG,EAAE,EAAE,aAAa,EAAE,SAAS,EAAC,6BAA6B,EAAA;YAC3DA,cAAA,CAAA,aAAA,CAAC,IAAI,IACH,SAAS,EAAC,0CAA0C,EACpD,MAAM,EAAC,8BAA8B,EAAA,aAAA,EAAA,IAAA,EAAA,CAErC;AACD,YAAA,kBAAkB,CACjB,CACL;QACDA,cAAA,CAAA,aAAA,CAAA,KAAA,EAAA,EAAK,SAAS,EAAC,wBAAwB,EAAA,EAAE,QAAQ,CAAO,CAC/C;AAEf;AAEA,UAAU,CAAC,WAAW,GAAG,YAAY;;;;"}
+{"version":3,"file":"RadioGroup.js","sources":["../../../src/components/radio-group/RadioGroup.tsx"],"sourcesContent":["import \"./index.css\"\n\nimport Icon from \"@utilities/Icon\"\nimport { useId } from \"@utilities/useId\"\nimport classNames from \"classnames\"\nimport React, { FieldsetHTMLAttributes } from \"react\"\n\nexport type RadioGroupSize = \"md\" | \"sm\"\n\nexport interface RadioGroupProps {\n  /** Optional description text that appears below the label. */\n  description?: string\n  /** Is invalid. If true, include a description to explain why; and if no description is provided, description defaults to \"Please select an option\". */\n  invalid?: boolean\n  /** The label text (required). Renders as `<legend>` (not `<label>`) because `RadioGroup` is a `<fieldset>`. */\n  label: string\n  /** The size. Does not affect child radios. */\n  size?: RadioGroupSize\n}\n\nexport type RadioGroupElementProps = Omit<\n  FieldsetHTMLAttributes<HTMLFieldSetElement>,\n  keyof RadioGroupProps\n> &\n  RadioGroupProps\n\n/**\n * A radio group component that renders as a fieldset with legend.\n * Use to group two or more Radio components.\n * Supports label and description text, sizes, invalid, and disabled state.\n * Label is required and must be a string. Renders as <legend>.\n *\n * @component\n */\nexport const RadioGroup = ({\n  children,\n  className,\n  description,\n  invalid,\n  label,\n  size = \"md\",\n  ...restProps\n}: RadioGroupElementProps) => {\n  const combinedClassName = classNames(\n    \"tds-radio-group\",\n    size && size === \"sm\" && \"tds-radio-group--sm\",\n    className\n  )\n  const stableId = useId()\n\n  const displayDescription =\n    description || (invalid ? \"Please select an option\" : undefined)\n  const descriptionId = `tds-radio-group-${stableId}-description`\n\n  return (\n    <fieldset\n      {...restProps}\n      aria-describedby={displayDescription ? descriptionId : undefined}\n      aria-invalid={invalid ? \"true\" : undefined}\n      className={combinedClassName}\n    >\n      <legend>{label}</legend>\n      {displayDescription && (\n        <p id={descriptionId} className=\"tds-radio-group-description\">\n          <Icon\n            className=\"tds-radio-group-description-invalid-icon\"\n            symbol=\"general#exclamation-triangle\"\n            aria-hidden\n          />\n          {displayDescription}\n        </p>\n      )}\n      <div className=\"tds-radio-group-fields\">{children}</div>\n    </fieldset>\n  )\n}\n\nRadioGroup.displayName = \"RadioGroup\"\n"],"names":["React"],"mappings":";;;;;AA0BA;;;;;;;AAOG;AACI,MAAM,UAAU,GAAG,CAAC,EACzB,QAAQ,EACR,SAAS,EACT,WAAW,EACX,OAAO,EACP,KAAK,EACL,IAAI,GAAG,IAAI,EACX,GAAG,SAAS,EACW,KAAI;AAC3B,IAAA,MAAM,iBAAiB,GAAG,UAAU,CAClC,iBAAiB,EACjB,IAAI,IAAI,IAAI,KAAK,IAAI,IAAI,qBAAqB,EAC9C,SAAS,CACV;AACD,IAAA,MAAM,QAAQ,GAAG,KAAK,EAAE;AAExB,IAAA,MAAM,kBAAkB,GACtB,WAAW,KAAK,OAAO,GAAG,yBAAyB,GAAG,SAAS,CAAC;AAClE,IAAA,MAAM,aAAa,GAAG,CAAA,gBAAA,EAAmB,QAAQ,cAAc;IAE/D,QACEA,cAAA,CAAA,aAAA,CAAA,UAAA,EAAA,EAAA,GACM,SAAS,EAAA,kBAAA,EACK,kBAAkB,GAAG,aAAa,GAAG,SAAS,kBAClD,OAAO,GAAG,MAAM,GAAG,SAAS,EAC1C,SAAS,EAAE,iBAAiB,EAAA;AAE5B,QAAAA,cAAA,CAAA,aAAA,CAAA,QAAA,EAAA,IAAA,EAAS,KAAK,CAAU;QACvB,kBAAkB,KACjBA,cAAA,CAAA,aAAA,CAAA,GAAA,EAAA,EAAG,EAAE,EAAE,aAAa,EAAE,SAAS,EAAC,6BAA6B,EAAA;YAC3DA,cAAA,CAAA,aAAA,CAAC,IAAI,IACH,SAAS,EAAC,0CAA0C,EACpD,MAAM,EAAC,8BAA8B,EAAA,aAAA,EAAA,IAAA,EAAA,CAErC;AACD,YAAA,kBAAkB,CACjB,CACL;QACDA,cAAA,CAAA,aAAA,CAAA,KAAA,EAAA,EAAK,SAAS,EAAC,wBAAwB,EAAA,EAAE,QAAQ,CAAO,CAC/C;AAEf;AAEA,UAAU,CAAC,WAAW,GAAG,YAAY;;;;"}

package/dist/components/select/Select.d.ts

@@ -1,7 +1,13 @@
 import "./index.css";
 import React, { type SelectHTMLAttributes } from "react";
 export type SelectSize = "lg" | "md";
+/**
+ * String-labelled option variant. Valid in both native (`complex={false}`)
+ * and complex (`complex={true}`) modes. The `label` doubles as the type-ahead
+ * search target.
+ */
 export interface SelectOptionWithTextLabel {
+    /** Arbitrary `data-*` attributes are forwarded to the rendered option. */
     [key: `data-${string}`]: boolean | number | string | undefined;
     /** Whether this option is non-interactive. */
     disabled?: boolean;
@@ -9,19 +15,40 @@ export interface SelectOptionWithTextLabel {
     /** Displayed as the option content and used for type-ahead matching. */
     label: string;
     textValue?: never;
+    /** Unique identifier for the option. */
     value: string;
 }
+/**
+ * Rich-content option variant. The popover (`complex={true}`) renders the
+ * `label` node directly; the native `<select>` (`complex={false}`) falls back
+ * to `textValue` for the visible text. Requires a plain-text `textValue` so
+ * type-ahead matching, screen reader announcements, and the native fallback
+ * all have something stable to use.
+ */
 export interface SelectOptionWithNodeLabel {
+    /** Arbitrary `data-*` attributes are forwarded to the rendered option. */
     [key: `data-${string}`]: boolean | number | string | undefined;
     /** Whether this option is non-interactive. */
     disabled?: boolean;
     divider?: never;
-    /** Displayed as the option content. Accepts React nodes in complex mode. */
+    /**
+     * Option content. Rendered as JSX in complex mode; in native mode, the
+     * visible text comes from `textValue` instead.
+     */
     label: React.ReactNode;
-    /** Plain-text fallback for type-ahead matching when `label` is a React node. */
+    /**
+     * Plain-text fallback for type-ahead matching, screen reader
+     * announcements, and the native `<select>`'s visible option text when
+     * `label` is a React node.
+     */
     textValue: string;
+    /** Unique identifier for the option. */
     value: string;
 }
+/**
+ * Visual-separator option variant. Renders a divider line between options
+ * (or between groups of options). Carries no value of its own.
+ */
 export interface SelectOptionDivider {
     disabled?: never;
     /** Renders a visual separator between options. */
@@ -31,21 +58,38 @@ export interface SelectOptionDivider {
     value?: never;
 }
 export type SelectOption = SelectOptionDivider | SelectOptionWithNodeLabel | SelectOptionWithTextLabel;
+/**
+ * A group entry in `Select`'s `options` array. Renders a heading above its
+ * `options` and nests them visually beneath it.
+ */
 export interface SelectOptionsGroup {
-    /** Whether all options in this group are non-interactive. */
+    /**
+     * Whether all options in this group are non-interactive. Disables every
+     * nested option regardless of its own `disabled` flag.
+     */
     disabled?: boolean;
     /** Visible heading displayed above the group's options. */
     label: string;
-    /** The selectable options within this group. */
+    /** The selectable options nested under this group. */
     options: SelectOption[];
 }
 export type SelectItem = SelectOption | SelectOptionsGroup;
 interface SelectBaseProps {
-    /** When true, renders as a popover listbox instead of a native `<select>`. */
+    /**
+     * When true, renders as a popover listbox instead of a native `<select>`.
+     * Enables rich content in options (icons, descriptions).
+     */
     complex?: boolean;
-    /** Helper text displayed below the select. Styled as error text when `invalid`. */
+    /**
+     * Helper text displayed below the select. Styled as error text when
+     * `invalid`. Defaults to `"Please select an option"` when `invalid` is true
+     * and no description is provided.
+     */
     description?: string;
-    /** Whether the select is in an invalid state. */
+    /**
+     * Whether the select is in an invalid state. Shows the default description
+     * if none is provided.
+     */
     invalid?: boolean;
     /** A flat or mixed array of options and option groups. */
     options: SelectItem[];
@@ -57,7 +101,10 @@ interface SelectBaseProps {
 interface SelectWithVisibleLabel extends SelectBaseProps {
     /** If true, the label is visually hidden and set as aria-label. */
     hideLabel?: false;
-    /** The label text for the select. */
+    /**
+     * The label text for the select. Required unless `aria-label` or
+     * `aria-labelledby` is provided.
+     */
     label: string;
 }
 interface SelectWithHiddenLabel extends SelectBaseProps {
@@ -73,7 +120,10 @@ interface SelectWithAriaLabel extends SelectBaseProps {
     label?: never;
 }
 interface SelectWithAriaLabelledBy extends SelectBaseProps {
-    /** ID of an external label element. Use instead of `label`. */
+    /**
+     * ID of an external label element. Use instead of `label` when a visible
+     * label exists elsewhere on the page.
+     */
     "aria-labelledby": string;
     hideLabel?: never;
     label?: never;

package/dist/components/select/Select.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Select.d.ts","sourceRoot":"","sources":["../../../src/components/select/Select.tsx"],"names":[],"mappings":"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"}
+{"version":3,"file":"Select.d.ts","sourceRoot":"","sources":["../../../src/components/select/Select.tsx"],"names":[],"mappings":"AAAA,OAAO,aAAa,CAAA;AAKpB,OAAO,KAAK,EAAE,EAAc,KAAK,oBAAoB,EAAU,MAAM,OAAO,CAAA;AAS5E,MAAM,MAAM,UAAU,GAAG,IAAI,GAAG,IAAI,CAAA;AAEpC;;;;GAIG;AACH,MAAM,WAAW,yBAAyB;IACxC,0EAA0E;IAC1E,CAAC,GAAG,EAAE,QAAQ,MAAM,EAAE,GAAG,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,SAAS,CAAA;IAC9D,8CAA8C;IAC9C,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB,OAAO,CAAC,EAAE,KAAK,CAAA;IACf,wEAAwE;IACxE,KAAK,EAAE,MAAM,CAAA;IACb,SAAS,CAAC,EAAE,KAAK,CAAA;IACjB,wCAAwC;IACxC,KAAK,EAAE,MAAM,CAAA;CACd;AAED;;;;;;GAMG;AACH,MAAM,WAAW,yBAAyB;IACxC,0EAA0E;IAC1E,CAAC,GAAG,EAAE,QAAQ,MAAM,EAAE,GAAG,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,SAAS,CAAA;IAC9D,8CAA8C;IAC9C,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB,OAAO,CAAC,EAAE,KAAK,CAAA;IACf;;;OAGG;IACH,KAAK,EAAE,KAAK,CAAC,SAAS,CAAA;IACtB;;;;OAIG;IACH,SAAS,EAAE,MAAM,CAAA;IACjB,wCAAwC;IACxC,KAAK,EAAE,MAAM,CAAA;CACd;AAED;;;GAGG;AACH,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,EAAE,KAAK,CAAA;IAChB,kDAAkD;IAClD,OAAO,EAAE,IAAI,CAAA;IACb,KAAK,CAAC,EAAE,KAAK,CAAA;IACb,SAAS,CAAC,EAAE,KAAK,CAAA;IACjB,KAAK,CAAC,EAAE,KAAK,CAAA;CACd;AAED,MAAM,MAAM,YAAY,GACpB,mBAAmB,GACnB,yBAAyB,GACzB,yBAAyB,CAAA;AAE7B;;;GAGG;AACH,MAAM,WAAW,kBAAkB;IACjC;;;OAGG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB,2DAA2D;IAC3D,KAAK,EAAE,MAAM,CAAA;IACb,sDAAsD;IACtD,OAAO,EAAE,YAAY,EAAE,CAAA;CACxB;AAED,MAAM,MAAM,UAAU,GAAG,YAAY,GAAG,kBAAkB,CAAA;AAM1D,UAAU,eAAe;IACvB;;;OAGG;IACH,OAAO,CAAC,EAAE,OAAO,CAAA;IACjB;;;;OAIG;IACH,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB;;;OAGG;IACH,OAAO,CAAC,EAAE,OAAO,CAAA;IACjB,0DAA0D;IAC1D,OAAO,EAAE,UAAU,EAAE,CAAA;IACrB,2FAA2F;IAC3F,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,8BAA8B;IAC9B,IAAI,CAAC,EAAE,UAAU,CAAA;CAClB;AAED,UAAU,sBAAuB,SAAQ,eAAe;IACtD,mEAAmE;IACnE,SAAS,CAAC,EAAE,KAAK,CAAA;IACjB;;;OAGG;IACH,KAAK,EAAE,MAAM,CAAA;CACd;AAED,UAAU,qBAAsB,SAAQ,eAAe;IACrD,mEAAmE;IACnE,SAAS,EAAE,IAAI,CAAA;IACf,mEAAmE;IACnE,KAAK,EAAE,MAAM,CAAA;CACd;AAED,UAAU,mBAAoB,SAAQ,eAAe;IACnD,yEAAyE;IACzE,YAAY,EAAE,MAAM,CAAA;IACpB,SAAS,CAAC,EAAE,KAAK,CAAA;IACjB,KAAK,CAAC,EAAE,KAAK,CAAA;CACd;AAED,UAAU,wBAAyB,SAAQ,eAAe;IACxD;;;OAGG;IACH,iBAAiB,EAAE,MAAM,CAAA;IACzB,SAAS,CAAC,EAAE,KAAK,CAAA;IACjB,KAAK,CAAC,EAAE,KAAK,CAAA;CACd;AAED,MAAM,MAAM,WAAW,GACnB,mBAAmB,GACnB,wBAAwB,GACxB,qBAAqB,GACrB,sBAAsB,CAAA;AAE1B,KAAK,sBAAsB,GAAG,IAAI,CAChC,oBAAoB,CAAC,iBAAiB,CAAC,EACvC,MAAM,WAAW,GAAG,UAAU,GAAG,MAAM,CACxC,CAAA;AAED,MAAM,MAAM,wBAAwB,GAAG,sBAAsB,GAC3D,WAAW,GAAG;IACZ,OAAO,CAAC,EAAE,KAAK,CAAA;CAChB,CAAA;AAEH,MAAM,MAAM,yBAAyB,GAAG,sBAAsB,GAC5D,WAAW,GAAG;IACZ,OAAO,EAAE,IAAI,CAAA;CACd,CAAA;AAEH,MAAM,MAAM,kBAAkB,GAC1B,wBAAwB,GACxB,yBAAyB,CAAA;AAkB7B,eAAO,MAAM,MAAM,8FAgHlB,CAAA"}

package/dist/components/select/Select.js.map

@@ -1 +1 @@
-{"version":3,"file":"Select.js","sources":["../../../src/components/select/Select.tsx"],"sourcesContent":["import \"./index.css\"\n\nimport Icon from \"@utilities/Icon\"\nimport { useId } from \"@utilities/useId\"\nimport classNames from \"classnames\"\nimport React, { forwardRef, type SelectHTMLAttributes, useRef } from \"react\"\n\nimport { SelectNative } from \"./SelectNative\"\nimport { SelectPopover } from \"./SelectPopover\"\n\n// ---------------------------------------------------------------------------\n// Shared types\n// ---------------------------------------------------------------------------\n\nexport type SelectSize = \"lg\" | \"md\"\n\nexport interface SelectOptionWithTextLabel {\n  [key: `data-${string}`]: boolean | number | string | undefined\n  /** Whether this option is non-interactive. */\n  disabled?: boolean\n  divider?: never\n  /** Displayed as the option content and used for type-ahead matching. */\n  label: string\n  textValue?: never\n  value: string\n}\n\nexport interface SelectOptionWithNodeLabel {\n  [key: `data-${string}`]: boolean | number | string | undefined\n  /** Whether this option is non-interactive. */\n  disabled?: boolean\n  divider?: never\n  /** Displayed as the option content. Accepts React nodes in complex mode. */\n  label: React.ReactNode\n  /** Plain-text fallback for type-ahead matching when `label` is a React node. */\n  textValue: string\n  value: string\n}\n\nexport interface SelectOptionDivider {\n  disabled?: never\n  /** Renders a visual separator between options. */\n  divider: true\n  label?: never\n  textValue?: never\n  value?: never\n}\n\nexport type SelectOption =\n  | SelectOptionDivider\n  | SelectOptionWithNodeLabel\n  | SelectOptionWithTextLabel\n\nexport interface SelectOptionsGroup {\n  /** Whether all options in this group are non-interactive. */\n  disabled?: boolean\n  /** Visible heading displayed above the group's options. */\n  label: string\n  /** The selectable options within this group. */\n  options: SelectOption[]\n}\n\nexport type SelectItem = SelectOption | SelectOptionsGroup\n\n// ---------------------------------------------------------------------------\n// Select component props\n// ---------------------------------------------------------------------------\n\ninterface SelectBaseProps {\n  /** When true, renders as a popover listbox instead of a native `<select>`. */\n  complex?: boolean\n  /** Helper text displayed below the select. Styled as error text when `invalid`. */\n  description?: string\n  /** Whether the select is in an invalid state. */\n  invalid?: boolean\n  /** A flat or mixed array of options and option groups. */\n  options: SelectItem[]\n  /** Placeholder text shown when no option is selected. Defaults to `\"Select an option\"`. */\n  placeholder?: string\n  /** The size of the select. */\n  size?: SelectSize\n}\n\ninterface SelectWithVisibleLabel extends SelectBaseProps {\n  /** If true, the label is visually hidden and set as aria-label. */\n  hideLabel?: false\n  /** The label text for the select. */\n  label: string\n}\n\ninterface SelectWithHiddenLabel extends SelectBaseProps {\n  /** If true, the label is visually hidden and set as aria-label. */\n  hideLabel: true\n  /** The label text for the select. Must be a string when hidden. */\n  label: string\n}\n\ninterface SelectWithAriaLabel extends SelectBaseProps {\n  /** Accessible label for the select. Use when no visible label exists. */\n  \"aria-label\": string\n  hideLabel?: never\n  label?: never\n}\n\ninterface SelectWithAriaLabelledBy extends SelectBaseProps {\n  /** ID of an external label element. Use instead of `label`. */\n  \"aria-labelledby\": string\n  hideLabel?: never\n  label?: never\n}\n\nexport type SelectProps =\n  | SelectWithAriaLabel\n  | SelectWithAriaLabelledBy\n  | SelectWithHiddenLabel\n  | SelectWithVisibleLabel\n\ntype BaseSelectElementProps = Omit<\n  SelectHTMLAttributes<HTMLSelectElement>,\n  keyof SelectProps | \"multiple\" | \"size\"\n>\n\nexport type NativeSelectElementProps = BaseSelectElementProps &\n  SelectProps & {\n    complex?: false\n  }\n\nexport type ComplexSelectElementProps = BaseSelectElementProps &\n  SelectProps & {\n    complex: true\n  }\n\nexport type SelectElementProps =\n  | NativeSelectElementProps\n  | ComplexSelectElementProps\n\nfunction normalizeSelectValue(\n  value:\n    | NativeSelectElementProps[\"defaultValue\"]\n    | NativeSelectElementProps[\"value\"]\n    | ComplexSelectElementProps[\"defaultValue\"]\n    | ComplexSelectElementProps[\"value\"]\n) {\n  if (value === undefined || value === null) return undefined\n  if (Array.isArray(value)) return value[0]\n  return String(value)\n}\n\n// ---------------------------------------------------------------------------\n// Select (public)\n// ---------------------------------------------------------------------------\n\nexport const Select = forwardRef<HTMLSelectElement, SelectElementProps>(\n  function Select(props: SelectElementProps, ref) {\n    const {\n      \"aria-label\": userAriaLabel,\n      \"aria-labelledby\": userAriaLabelledBy,\n      className,\n      complex,\n      defaultValue,\n      description,\n      hideLabel,\n      id,\n      invalid,\n      label,\n      onChange,\n      options,\n      placeholder,\n      required,\n      size,\n      value,\n      ...restProps\n    } = props\n\n    const triggerRef = useRef<HTMLButtonElement>(null)\n    const stableId = useId()\n    const controlId = id || `tds-select-${stableId}`\n    const labelId = `${controlId}-label`\n    const resolvedDescription =\n      description || (invalid ? \"Please select an option\" : undefined)\n    const descriptionId = resolvedDescription\n      ? `${controlId}-description`\n      : undefined\n    const computedClassName = classNames(\n      \"tds-select\",\n      {\n        \"tds-select--invalid\": invalid,\n        \"tds-select--lg\": size === \"lg\",\n        \"tds-select--required\": required,\n      },\n      className\n    )\n\n    const normalizedDefaultValue = normalizeSelectValue(defaultValue)\n    const normalizedValue = normalizeSelectValue(value)\n\n    const computedDefaultValue =\n      normalizedDefaultValue === undefined && normalizedValue === undefined\n        ? \"\"\n        : normalizedDefaultValue\n    const effectivePlaceholder =\n      normalizedDefaultValue !== undefined && normalizedDefaultValue !== \"\"\n        ? null\n        : placeholder || \"Select an option\"\n    const showLabel = !!label && !hideLabel\n    const computedAriaLabel = userAriaLabel ?? (hideLabel ? label : undefined)\n    const computedAriaLabelledBy =\n      userAriaLabelledBy ??\n      (computedAriaLabel || !showLabel ? undefined : labelId)\n\n    const sharedControlProps = {\n      ...restProps,\n      \"aria-describedby\": descriptionId,\n      \"aria-label\": computedAriaLabel,\n      \"aria-labelledby\": computedAriaLabelledBy,\n      defaultValue: computedDefaultValue,\n      invalid,\n      options,\n      placeholder: effectivePlaceholder,\n      required,\n      value: normalizedValue,\n    }\n\n    const handleComplexLabelClick = () => triggerRef.current?.focus()\n\n    const SelectComponent = complex ? SelectPopover : SelectNative\n\n    return (\n      <div className={computedClassName}>\n        {showLabel &&\n          (complex ? (\n            // eslint-disable-next-line jsx-a11y/click-events-have-key-events, jsx-a11y/no-static-element-interactions -- mirrors native label click-to-focus; keyboard users interact with the combobox directly\n            <div\n              className=\"tds-select-label\"\n              id={labelId}\n              onClick={handleComplexLabelClick}\n            >\n              {label}\n            </div>\n          ) : (\n            <label htmlFor={controlId} id={labelId}>\n              {label}\n            </label>\n          ))}\n        <SelectComponent\n          {...sharedControlProps}\n          ref={ref}\n          id={controlId}\n          onChange={onChange}\n          {...(complex && { triggerRef })}\n        />\n        {resolvedDescription && descriptionId && (\n          <p className=\"tds-select-description\" id={descriptionId}>\n            <Icon\n              aria-hidden\n              className=\"tds-select-description-invalid-icon\"\n              symbol=\"general#exclamation-triangle\"\n            />\n            {resolvedDescription}\n          </p>\n        )}\n      </div>\n    )\n  }\n)\n\nSelect.displayName = \"Select\"\n"],"names":["React"],"mappings":"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"}
+{"version":3,"file":"Select.js","sources":["../../../src/components/select/Select.tsx"],"sourcesContent":["import \"./index.css\"\n\nimport Icon from \"@utilities/Icon\"\nimport { useId } from \"@utilities/useId\"\nimport classNames from \"classnames\"\nimport React, { forwardRef, type SelectHTMLAttributes, useRef } from \"react\"\n\nimport { SelectNative } from \"./SelectNative\"\nimport { SelectPopover } from \"./SelectPopover\"\n\n// ---------------------------------------------------------------------------\n// Shared types\n// ---------------------------------------------------------------------------\n\nexport type SelectSize = \"lg\" | \"md\"\n\n/**\n * String-labelled option variant. Valid in both native (`complex={false}`)\n * and complex (`complex={true}`) modes. The `label` doubles as the type-ahead\n * search target.\n */\nexport interface SelectOptionWithTextLabel {\n  /** Arbitrary `data-*` attributes are forwarded to the rendered option. */\n  [key: `data-${string}`]: boolean | number | string | undefined\n  /** Whether this option is non-interactive. */\n  disabled?: boolean\n  divider?: never\n  /** Displayed as the option content and used for type-ahead matching. */\n  label: string\n  textValue?: never\n  /** Unique identifier for the option. */\n  value: string\n}\n\n/**\n * Rich-content option variant. The popover (`complex={true}`) renders the\n * `label` node directly; the native `<select>` (`complex={false}`) falls back\n * to `textValue` for the visible text. Requires a plain-text `textValue` so\n * type-ahead matching, screen reader announcements, and the native fallback\n * all have something stable to use.\n */\nexport interface SelectOptionWithNodeLabel {\n  /** Arbitrary `data-*` attributes are forwarded to the rendered option. */\n  [key: `data-${string}`]: boolean | number | string | undefined\n  /** Whether this option is non-interactive. */\n  disabled?: boolean\n  divider?: never\n  /**\n   * Option content. Rendered as JSX in complex mode; in native mode, the\n   * visible text comes from `textValue` instead.\n   */\n  label: React.ReactNode\n  /**\n   * Plain-text fallback for type-ahead matching, screen reader\n   * announcements, and the native `<select>`'s visible option text when\n   * `label` is a React node.\n   */\n  textValue: string\n  /** Unique identifier for the option. */\n  value: string\n}\n\n/**\n * Visual-separator option variant. Renders a divider line between options\n * (or between groups of options). Carries no value of its own.\n */\nexport interface SelectOptionDivider {\n  disabled?: never\n  /** Renders a visual separator between options. */\n  divider: true\n  label?: never\n  textValue?: never\n  value?: never\n}\n\nexport type SelectOption =\n  | SelectOptionDivider\n  | SelectOptionWithNodeLabel\n  | SelectOptionWithTextLabel\n\n/**\n * A group entry in `Select`'s `options` array. Renders a heading above its\n * `options` and nests them visually beneath it.\n */\nexport interface SelectOptionsGroup {\n  /**\n   * Whether all options in this group are non-interactive. Disables every\n   * nested option regardless of its own `disabled` flag.\n   */\n  disabled?: boolean\n  /** Visible heading displayed above the group's options. */\n  label: string\n  /** The selectable options nested under this group. */\n  options: SelectOption[]\n}\n\nexport type SelectItem = SelectOption | SelectOptionsGroup\n\n// ---------------------------------------------------------------------------\n// Select component props\n// ---------------------------------------------------------------------------\n\ninterface SelectBaseProps {\n  /**\n   * When true, renders as a popover listbox instead of a native `<select>`.\n   * Enables rich content in options (icons, descriptions).\n   */\n  complex?: boolean\n  /**\n   * Helper text displayed below the select. Styled as error text when\n   * `invalid`. Defaults to `\"Please select an option\"` when `invalid` is true\n   * and no description is provided.\n   */\n  description?: string\n  /**\n   * Whether the select is in an invalid state. Shows the default description\n   * if none is provided.\n   */\n  invalid?: boolean\n  /** A flat or mixed array of options and option groups. */\n  options: SelectItem[]\n  /** Placeholder text shown when no option is selected. Defaults to `\"Select an option\"`. */\n  placeholder?: string\n  /** The size of the select. */\n  size?: SelectSize\n}\n\ninterface SelectWithVisibleLabel extends SelectBaseProps {\n  /** If true, the label is visually hidden and set as aria-label. */\n  hideLabel?: false\n  /**\n   * The label text for the select. Required unless `aria-label` or\n   * `aria-labelledby` is provided.\n   */\n  label: string\n}\n\ninterface SelectWithHiddenLabel extends SelectBaseProps {\n  /** If true, the label is visually hidden and set as aria-label. */\n  hideLabel: true\n  /** The label text for the select. Must be a string when hidden. */\n  label: string\n}\n\ninterface SelectWithAriaLabel extends SelectBaseProps {\n  /** Accessible label for the select. Use when no visible label exists. */\n  \"aria-label\": string\n  hideLabel?: never\n  label?: never\n}\n\ninterface SelectWithAriaLabelledBy extends SelectBaseProps {\n  /**\n   * ID of an external label element. Use instead of `label` when a visible\n   * label exists elsewhere on the page.\n   */\n  \"aria-labelledby\": string\n  hideLabel?: never\n  label?: never\n}\n\nexport type SelectProps =\n  | SelectWithAriaLabel\n  | SelectWithAriaLabelledBy\n  | SelectWithHiddenLabel\n  | SelectWithVisibleLabel\n\ntype BaseSelectElementProps = Omit<\n  SelectHTMLAttributes<HTMLSelectElement>,\n  keyof SelectProps | \"multiple\" | \"size\"\n>\n\nexport type NativeSelectElementProps = BaseSelectElementProps &\n  SelectProps & {\n    complex?: false\n  }\n\nexport type ComplexSelectElementProps = BaseSelectElementProps &\n  SelectProps & {\n    complex: true\n  }\n\nexport type SelectElementProps =\n  | NativeSelectElementProps\n  | ComplexSelectElementProps\n\nfunction normalizeSelectValue(\n  value:\n    | NativeSelectElementProps[\"defaultValue\"]\n    | NativeSelectElementProps[\"value\"]\n    | ComplexSelectElementProps[\"defaultValue\"]\n    | ComplexSelectElementProps[\"value\"]\n) {\n  if (value === undefined || value === null) return undefined\n  if (Array.isArray(value)) return value[0]\n  return String(value)\n}\n\n// ---------------------------------------------------------------------------\n// Select (public)\n// ---------------------------------------------------------------------------\n\nexport const Select = forwardRef<HTMLSelectElement, SelectElementProps>(\n  function Select(props: SelectElementProps, ref) {\n    const {\n      \"aria-label\": userAriaLabel,\n      \"aria-labelledby\": userAriaLabelledBy,\n      className,\n      complex,\n      defaultValue,\n      description,\n      hideLabel,\n      id,\n      invalid,\n      label,\n      onChange,\n      options,\n      placeholder,\n      required,\n      size,\n      value,\n      ...restProps\n    } = props\n\n    const triggerRef = useRef<HTMLButtonElement>(null)\n    const stableId = useId()\n    const controlId = id || `tds-select-${stableId}`\n    const labelId = `${controlId}-label`\n    const resolvedDescription =\n      description || (invalid ? \"Please select an option\" : undefined)\n    const descriptionId = resolvedDescription\n      ? `${controlId}-description`\n      : undefined\n    const computedClassName = classNames(\n      \"tds-select\",\n      {\n        \"tds-select--invalid\": invalid,\n        \"tds-select--lg\": size === \"lg\",\n        \"tds-select--required\": required,\n      },\n      className\n    )\n\n    const normalizedDefaultValue = normalizeSelectValue(defaultValue)\n    const normalizedValue = normalizeSelectValue(value)\n\n    const computedDefaultValue =\n      normalizedDefaultValue === undefined && normalizedValue === undefined\n        ? \"\"\n        : normalizedDefaultValue\n    const effectivePlaceholder =\n      normalizedDefaultValue !== undefined && normalizedDefaultValue !== \"\"\n        ? null\n        : placeholder || \"Select an option\"\n    const showLabel = !!label && !hideLabel\n    const computedAriaLabel = userAriaLabel ?? (hideLabel ? label : undefined)\n    const computedAriaLabelledBy =\n      userAriaLabelledBy ??\n      (computedAriaLabel || !showLabel ? undefined : labelId)\n\n    const sharedControlProps = {\n      ...restProps,\n      \"aria-describedby\": descriptionId,\n      \"aria-label\": computedAriaLabel,\n      \"aria-labelledby\": computedAriaLabelledBy,\n      defaultValue: computedDefaultValue,\n      invalid,\n      options,\n      placeholder: effectivePlaceholder,\n      required,\n      value: normalizedValue,\n    }\n\n    const handleComplexLabelClick = () => triggerRef.current?.focus()\n\n    const SelectComponent = complex ? SelectPopover : SelectNative\n\n    return (\n      <div className={computedClassName}>\n        {showLabel &&\n          (complex ? (\n            // eslint-disable-next-line jsx-a11y/click-events-have-key-events, jsx-a11y/no-static-element-interactions -- mirrors native label click-to-focus; keyboard users interact with the combobox directly\n            <div\n              className=\"tds-select-label\"\n              id={labelId}\n              onClick={handleComplexLabelClick}\n            >\n              {label}\n            </div>\n          ) : (\n            <label htmlFor={controlId} id={labelId}>\n              {label}\n            </label>\n          ))}\n        <SelectComponent\n          {...sharedControlProps}\n          ref={ref}\n          id={controlId}\n          onChange={onChange}\n          {...(complex && { triggerRef })}\n        />\n        {resolvedDescription && descriptionId && (\n          <p className=\"tds-select-description\" id={descriptionId}>\n            <Icon\n              aria-hidden\n              className=\"tds-select-description-invalid-icon\"\n              symbol=\"general#exclamation-triangle\"\n            />\n            {resolvedDescription}\n          </p>\n        )}\n      </div>\n    )\n  }\n)\n\nSelect.displayName = \"Select\"\n"],"names":["React"],"mappings":"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"}

package/dist/components/time-field/TimeField.d.ts

@@ -1,11 +1,11 @@
 import "./index.css";
 import type { CalendarDateTime, Time, ZonedDateTime } from "@internationalized/date";
-import React, { type AriaAttributes } from "react";
+import type { CombineAriaPropsWithCustomProps } from "../../utilities/reactAriaProps";
+import React from "react";
+import { type TimeFieldProps as AriaTimeFieldProps } from "react-aria-components";
 export type TimeFieldSize = "md" | "lg";
 export type TimeFieldValue = CalendarDateTime | Time | ZonedDateTime;
 export interface TimeFieldProps {
-    /** The default uncontrolled value (e.g. `new Time(9, 30)` or `new CalendarDateTime(2025, 1, 1, 9, 30)`). */
-    defaultValue?: TimeFieldValue | null;
     /** Helper text displayed below the component. Styled as error text when `invalid` is `true`. */
     description?: string;
     /** Disables the field. */
@@ -14,10 +14,6 @@ export interface TimeFieldProps {
     forceLeadingZeros?: boolean;
     /** If `true`, renders the label visually hidden. */
     hideLabel?: boolean;
-    /** If `true`, hides the time zone abbreviation for ZonedDateTime values. */
-    hideTimeZone?: boolean;
-    /** Whether to display in 12 or 24 hour format. By default, determined by locale. */
-    hourCycle?: 12 | 24;
     /** If `true`, applies error styling to the field and description. */
     invalid?: boolean;
     /** Accessible label for the field. */
@@ -26,22 +22,16 @@ export interface TimeFieldProps {
     max?: TimeFieldValue;
     /** The minimum allowed time (e.g. `new Time(9, 0)`). */
     min?: TimeFieldValue;
-    /** Field name for form submission. */
-    name?: string;
-    /** Called when the value changes. */
-    onChange?: (value: TimeFieldValue | null) => void;
     /** Allows the value to be read but not changed. */
     readOnly?: boolean;
     /** If `true`, appends an asterisk after the label text. */
     required?: boolean;
     /** The size of the time field. */
     size?: TimeFieldSize;
-    /** The controlled value (e.g. `new Time(9, 30)` or `new CalendarDateTime(2025, 1, 1, 9, 30)`). */
-    value?: TimeFieldValue | null;
 }
-export type TimeFieldElementProps = TimeFieldProps & Omit<AriaAttributes, keyof TimeFieldProps> & {
-    className?: string;
-    id?: string;
-};
-export declare function TimeField({ className, defaultValue, description, disabled, forceLeadingZeros, hideLabel, hideTimeZone, hourCycle, invalid, label, max, min, name, onChange, readOnly, required, size, value, ...restProps }: TimeFieldElementProps): React.JSX.Element;
+type AriaTimeFieldPropsToOmit = "children" | "granularity" | "placeholderValue" | "shouldForceLeadingZeros" | "slot";
+type AriaTimeFieldPropsToInclude = "defaultValue" | "hideTimeZone" | "hourCycle" | "name" | "onChange" | "value";
+export type TimeFieldElementProps = CombineAriaPropsWithCustomProps<AriaTimeFieldProps<TimeFieldValue>, TimeFieldProps, AriaTimeFieldPropsToOmit, AriaTimeFieldPropsToInclude>;
+export declare function TimeField({ className, description, disabled, forceLeadingZeros, hideLabel, invalid, label, max, min, readOnly, required, size, ...restProps }: TimeFieldElementProps): React.JSX.Element;
+export {};
 //# sourceMappingURL=TimeField.d.ts.map

package/dist/components/time-field/TimeField.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"TimeField.d.ts","sourceRoot":"","sources":["../../../src/components/time-field/TimeField.tsx"],"names":[],"mappings":"AAAA,OAAO,aAAa,CAAA;AAEpB,OAAO,KAAK,EACV,gBAAgB,EAChB,IAAI,EACJ,aAAa,EACd,MAAM,yBAAyB,CAAA;AAGhC,OAAO,KAAK,EAAE,EAAE,KAAK,cAAc,EAAE,MAAM,OAAO,CAAA;AASlD,MAAM,MAAM,aAAa,GAAG,IAAI,GAAG,IAAI,CAAA;AAEvC,MAAM,MAAM,cAAc,GAAG,gBAAgB,GAAG,IAAI,GAAG,aAAa,CAAA;AAEpE,MAAM,WAAW,cAAc;IAC7B,4GAA4G;IAC5G,YAAY,CAAC,EAAE,cAAc,GAAG,IAAI,CAAA;IACpC,gGAAgG;IAChG,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,0BAA0B;IAC1B,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB,+DAA+D;IAC/D,iBAAiB,CAAC,EAAE,OAAO,CAAA;IAC3B,oDAAoD;IACpD,SAAS,CAAC,EAAE,OAAO,CAAA;IACnB,4EAA4E;IAC5E,YAAY,CAAC,EAAE,OAAO,CAAA;IACtB,oFAAoF;IACpF,SAAS,CAAC,EAAE,EAAE,GAAG,EAAE,CAAA;IACnB,qEAAqE;IACrE,OAAO,CAAC,EAAE,OAAO,CAAA;IACjB,sCAAsC;IACtC,KAAK,EAAE,MAAM,CAAA;IACb,yDAAyD;IACzD,GAAG,CAAC,EAAE,cAAc,CAAA;IACpB,wDAAwD;IACxD,GAAG,CAAC,EAAE,cAAc,CAAA;IACpB,sCAAsC;IACtC,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,qCAAqC;IACrC,QAAQ,CAAC,EAAE,CAAC,KAAK,EAAE,cAAc,GAAG,IAAI,KAAK,IAAI,CAAA;IACjD,mDAAmD;IACnD,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB,2DAA2D;IAC3D,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB,kCAAkC;IAClC,IAAI,CAAC,EAAE,aAAa,CAAA;IACpB,kGAAkG;IAClG,KAAK,CAAC,EAAE,cAAc,GAAG,IAAI,CAAA;CAC9B;AAED,MAAM,MAAM,qBAAqB,GAAG,cAAc,GAChD,IAAI,CAAC,cAAc,EAAE,MAAM,cAAc,CAAC,GAAG;IAC3C,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,EAAE,CAAC,EAAE,MAAM,CAAA;CACZ,CAAA;AAEH,wBAAgB,SAAS,CAAC,EACxB,SAAS,EACT,YAAY,EACZ,WAAW,EACX,QAAQ,EACR,iBAAiB,EACjB,SAAS,EACT,YAAY,EACZ,SAAS,EACT,OAAO,EACP,KAAK,EACL,GAAG,EACH,GAAG,EACH,IAAI,EACJ,QAAQ,EACR,QAAQ,EACR,QAAQ,EACR,IAAW,EACX,KAAK,EACL,GAAG,SAAS,EACb,EAAE,qBAAqB,qBAwDvB"}
+{"version":3,"file":"TimeField.d.ts","sourceRoot":"","sources":["../../../src/components/time-field/TimeField.tsx"],"names":[],"mappings":"AAAA,OAAO,aAAa,CAAA;AAEpB,OAAO,KAAK,EACV,gBAAgB,EAChB,IAAI,EACJ,aAAa,EACd,MAAM,yBAAyB,CAAA;AAEhC,OAAO,KAAK,EAAE,+BAA+B,EAAE,MAAM,2BAA2B,CAAA;AAEhF,OAAO,KAAK,MAAM,OAAO,CAAA;AACzB,OAAO,EAML,KAAK,cAAc,IAAI,kBAAkB,EAC1C,MAAM,uBAAuB,CAAA;AAE9B,MAAM,MAAM,aAAa,GAAG,IAAI,GAAG,IAAI,CAAA;AAEvC,MAAM,MAAM,cAAc,GAAG,gBAAgB,GAAG,IAAI,GAAG,aAAa,CAAA;AAEpE,MAAM,WAAW,cAAc;IAC7B,gGAAgG;IAChG,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,0BAA0B;IAC1B,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB,+DAA+D;IAC/D,iBAAiB,CAAC,EAAE,OAAO,CAAA;IAC3B,oDAAoD;IACpD,SAAS,CAAC,EAAE,OAAO,CAAA;IACnB,qEAAqE;IACrE,OAAO,CAAC,EAAE,OAAO,CAAA;IACjB,sCAAsC;IACtC,KAAK,EAAE,MAAM,CAAA;IACb,yDAAyD;IACzD,GAAG,CAAC,EAAE,cAAc,CAAA;IACpB,wDAAwD;IACxD,GAAG,CAAC,EAAE,cAAc,CAAA;IACpB,mDAAmD;IACnD,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB,2DAA2D;IAC3D,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB,kCAAkC;IAClC,IAAI,CAAC,EAAE,aAAa,CAAA;CACrB;AAED,KAAK,wBAAwB,GACzB,UAAU,GACV,aAAa,GACb,kBAAkB,GAClB,yBAAyB,GACzB,MAAM,CAAA;AAEV,KAAK,2BAA2B,GAC5B,cAAc,GACd,cAAc,GACd,WAAW,GACX,MAAM,GACN,UAAU,GACV,OAAO,CAAA;AAEX,MAAM,MAAM,qBAAqB,GAAG,+BAA+B,CACjE,kBAAkB,CAAC,cAAc,CAAC,EAClC,cAAc,EACd,wBAAwB,EACxB,2BAA2B,CAC5B,CAAA;AAED,wBAAgB,SAAS,CAAC,EACxB,SAAS,EACT,WAAW,EACX,QAAQ,EACR,iBAAiB,EACjB,SAAS,EACT,OAAO,EACP,KAAK,EACL,GAAG,EACH,GAAG,EACH,QAAQ,EACR,QAAQ,EACR,IAAW,EACX,GAAG,SAAS,EACb,EAAE,qBAAqB,qBAkDvB"}

package/dist/components/time-field/TimeField.js

@@ -3,9 +3,9 @@ import classNames from 'classnames';
 import React__default from 'react';
 import { TimeField as TimeField$1, Label, DateInput, DateSegment, Text } from 'react-aria-components';
 
-function TimeField({ className, defaultValue, description, disabled, forceLeadingZeros, hideLabel, hideTimeZone, hourCycle, invalid, label, max, min, name, onChange, readOnly, required, size = "md", value, ...restProps }) {
+function TimeField({ className, description, disabled, forceLeadingZeros, hideLabel, invalid, label, max, min, readOnly, required, size = "md", ...restProps }) {
     const combinedClassName = classNames("tds-time-field", { "tds-time-field--lg": size === "lg" }, className);
-    return (React__default.createElement(TimeField$1, { ...restProps, "aria-label": hideLabel ? label : undefined, className: combinedClassName, defaultValue: defaultValue, granularity: "minute", hideTimeZone: hideTimeZone, hourCycle: hourCycle, isDisabled: disabled, isInvalid: invalid, isReadOnly: readOnly, isRequired: required, maxValue: max ?? undefined, minValue: min ?? undefined, name: name, onChange: onChange ?? undefined, shouldForceLeadingZeros: forceLeadingZeros, value: value },
+    return (React__default.createElement(TimeField$1, { ...restProps, "aria-label": hideLabel ? label : undefined, className: combinedClassName, granularity: "minute", isDisabled: disabled, isInvalid: invalid, isReadOnly: readOnly, isRequired: required, maxValue: max ?? undefined, minValue: min ?? undefined, shouldForceLeadingZeros: forceLeadingZeros },
         !hideLabel && React__default.createElement(Label, { className: "tds-time-field-label" }, label),
         React__default.createElement(DateInput, { className: "tds-time-field-input" }, (segment) => (React__default.createElement(DateSegment, { className: segment.type === "literal"
                 ? "tds-time-field-segment-separator"

package/dist/components/time-field/TimeField.js.map

@@ -1 +1 @@
-{"version":3,"file":"TimeField.js","sources":["../../../src/components/time-field/TimeField.tsx"],"sourcesContent":["import \"./index.css\"\n\nimport type {\n  CalendarDateTime,\n  Time,\n  ZonedDateTime,\n} from \"@internationalized/date\"\nimport Icon from \"@utilities/Icon\"\nimport classNames from \"classnames\"\nimport React, { type AriaAttributes } from \"react\"\nimport {\n  DateInput,\n  DateSegment,\n  Label,\n  Text,\n  TimeField as AriaTimeField,\n} from \"react-aria-components\"\n\nexport type TimeFieldSize = \"md\" | \"lg\"\n\nexport type TimeFieldValue = CalendarDateTime | Time | ZonedDateTime\n\nexport interface TimeFieldProps {\n  /** The default uncontrolled value (e.g. `new Time(9, 30)` or `new CalendarDateTime(2025, 1, 1, 9, 30)`). */\n  defaultValue?: TimeFieldValue | null\n  /** Helper text displayed below the component. Styled as error text when `invalid` is `true`. */\n  description?: string\n  /** Disables the field. */\n  disabled?: boolean\n  /** If `true`, always shows leading zeros in the hour field. */\n  forceLeadingZeros?: boolean\n  /** If `true`, renders the label visually hidden. */\n  hideLabel?: boolean\n  /** If `true`, hides the time zone abbreviation for ZonedDateTime values. */\n  hideTimeZone?: boolean\n  /** Whether to display in 12 or 24 hour format. By default, determined by locale. */\n  hourCycle?: 12 | 24\n  /** If `true`, applies error styling to the field and description. */\n  invalid?: boolean\n  /** Accessible label for the field. */\n  label: string\n  /** The maximum allowed time (e.g. `new Time(17, 0)`). */\n  max?: TimeFieldValue\n  /** The minimum allowed time (e.g. `new Time(9, 0)`). */\n  min?: TimeFieldValue\n  /** Field name for form submission. */\n  name?: string\n  /** Called when the value changes. */\n  onChange?: (value: TimeFieldValue | null) => void\n  /** Allows the value to be read but not changed. */\n  readOnly?: boolean\n  /** If `true`, appends an asterisk after the label text. */\n  required?: boolean\n  /** The size of the time field. */\n  size?: TimeFieldSize\n  /** The controlled value (e.g. `new Time(9, 30)` or `new CalendarDateTime(2025, 1, 1, 9, 30)`). */\n  value?: TimeFieldValue | null\n}\n\nexport type TimeFieldElementProps = TimeFieldProps &\n  Omit<AriaAttributes, keyof TimeFieldProps> & {\n    className?: string\n    id?: string\n  }\n\nexport function TimeField({\n  className,\n  defaultValue,\n  description,\n  disabled,\n  forceLeadingZeros,\n  hideLabel,\n  hideTimeZone,\n  hourCycle,\n  invalid,\n  label,\n  max,\n  min,\n  name,\n  onChange,\n  readOnly,\n  required,\n  size = \"md\",\n  value,\n  ...restProps\n}: TimeFieldElementProps) {\n  const combinedClassName = classNames(\n    \"tds-time-field\",\n    { \"tds-time-field--lg\": size === \"lg\" },\n    className\n  )\n\n  return (\n    <AriaTimeField\n      {...restProps}\n      aria-label={hideLabel ? label : undefined}\n      className={combinedClassName}\n      defaultValue={defaultValue}\n      granularity=\"minute\"\n      hideTimeZone={hideTimeZone}\n      hourCycle={hourCycle}\n      isDisabled={disabled}\n      isInvalid={invalid}\n      isReadOnly={readOnly}\n      isRequired={required}\n      maxValue={max ?? undefined}\n      minValue={min ?? undefined}\n      name={name}\n      onChange={onChange ?? undefined}\n      shouldForceLeadingZeros={forceLeadingZeros}\n      value={value}\n    >\n      {!hideLabel && <Label className=\"tds-time-field-label\">{label}</Label>}\n      <DateInput className=\"tds-time-field-input\">\n        {(segment) => (\n          <DateSegment\n            className={\n              segment.type === \"literal\"\n                ? \"tds-time-field-segment-separator\"\n                : \"tds-time-field-segment\"\n            }\n            segment={segment}\n          />\n        )}\n      </DateInput>\n      {description && (\n        <Text\n          elementType=\"p\"\n          className=\"tds-time-field-description\"\n          slot=\"description\"\n        >\n          <Icon\n            aria-hidden\n            className=\"tds-time-field-description-invalid-icon\"\n            symbol=\"general#exclamation-triangle\"\n          />\n          {description}\n        </Text>\n      )}\n    </AriaTimeField>\n  )\n}\n"],"names":["React","AriaTimeField"],"mappings":";;;;;AAiEM,SAAU,SAAS,CAAC,EACxB,SAAS,EACT,YAAY,EACZ,WAAW,EACX,QAAQ,EACR,iBAAiB,EACjB,SAAS,EACT,YAAY,EACZ,SAAS,EACT,OAAO,EACP,KAAK,EACL,GAAG,EACH,GAAG,EACH,IAAI,EACJ,QAAQ,EACR,QAAQ,EACR,QAAQ,EACR,IAAI,GAAG,IAAI,EACX,KAAK,EACL,GAAG,SAAS,EACU,EAAA;AACtB,IAAA,MAAM,iBAAiB,GAAG,UAAU,CAClC,gBAAgB,EAChB,EAAE,oBAAoB,EAAE,IAAI,KAAK,IAAI,EAAE,EACvC,SAAS,CACV;AAED,IAAA,QACEA,cAAA,CAAA,aAAA,CAACC,WAAa,EAAA,EAAA,GACR,SAAS,gBACD,SAAS,GAAG,KAAK,GAAG,SAAS,EACzC,SAAS,EAAE,iBAAiB,EAC5B,YAAY,EAAE,YAAY,EAC1B,WAAW,EAAC,QAAQ,EACpB,YAAY,EAAE,YAAY,EAC1B,SAAS,EAAE,SAAS,EACpB,UAAU,EAAE,QAAQ,EACpB,SAAS,EAAE,OAAO,EAClB,UAAU,EAAE,QAAQ,EACpB,UAAU,EAAE,QAAQ,EACpB,QAAQ,EAAE,GAAG,IAAI,SAAS,EAC1B,QAAQ,EAAE,GAAG,IAAI,SAAS,EAC1B,IAAI,EAAE,IAAI,EACV,QAAQ,EAAE,QAAQ,IAAI,SAAS,EAC/B,uBAAuB,EAAE,iBAAiB,EAC1C,KAAK,EAAE,KAAK,EAAA;QAEX,CAAC,SAAS,IAAID,cAAA,CAAA,aAAA,CAAC,KAAK,EAAA,EAAC,SAAS,EAAC,sBAAsB,EAAA,EAAE,KAAK,CAAS;QACtEA,cAAA,CAAA,aAAA,CAAC,SAAS,IAAC,SAAS,EAAC,sBAAsB,EAAA,EACxC,CAAC,OAAO,MACPA,cAAA,CAAA,aAAA,CAAC,WAAW,EAAA,EACV,SAAS,EACP,OAAO,CAAC,IAAI,KAAK;AACf,kBAAE;kBACA,wBAAwB,EAE9B,OAAO,EAAE,OAAO,EAAA,CAChB,CACH,CACS;AACX,QAAA,WAAW,KACVA,cAAA,CAAA,aAAA,CAAC,IAAI,IACH,WAAW,EAAC,GAAG,EACf,SAAS,EAAC,4BAA4B,EACtC,IAAI,EAAC,aAAa,EAAA;YAElBA,cAAA,CAAA,aAAA,CAAC,IAAI,yBAEH,SAAS,EAAC,yCAAyC,EACnD,MAAM,EAAC,8BAA8B,EAAA,CACrC;AACD,YAAA,WAAW,CACP,CACR,CACa;AAEpB;;;;"}
+{"version":3,"file":"TimeField.js","sources":["../../../src/components/time-field/TimeField.tsx"],"sourcesContent":["import \"./index.css\"\n\nimport type {\n  CalendarDateTime,\n  Time,\n  ZonedDateTime,\n} from \"@internationalized/date\"\nimport Icon from \"@utilities/Icon\"\nimport type { CombineAriaPropsWithCustomProps } from \"@utilities/reactAriaProps\"\nimport classNames from \"classnames\"\nimport React from \"react\"\nimport {\n  DateInput,\n  DateSegment,\n  Label,\n  Text,\n  TimeField as AriaTimeField,\n  type TimeFieldProps as AriaTimeFieldProps,\n} from \"react-aria-components\"\n\nexport type TimeFieldSize = \"md\" | \"lg\"\n\nexport type TimeFieldValue = CalendarDateTime | Time | ZonedDateTime\n\nexport interface TimeFieldProps {\n  /** Helper text displayed below the component. Styled as error text when `invalid` is `true`. */\n  description?: string\n  /** Disables the field. */\n  disabled?: boolean\n  /** If `true`, always shows leading zeros in the hour field. */\n  forceLeadingZeros?: boolean\n  /** If `true`, renders the label visually hidden. */\n  hideLabel?: boolean\n  /** If `true`, applies error styling to the field and description. */\n  invalid?: boolean\n  /** Accessible label for the field. */\n  label: string\n  /** The maximum allowed time (e.g. `new Time(17, 0)`). */\n  max?: TimeFieldValue\n  /** The minimum allowed time (e.g. `new Time(9, 0)`). */\n  min?: TimeFieldValue\n  /** Allows the value to be read but not changed. */\n  readOnly?: boolean\n  /** If `true`, appends an asterisk after the label text. */\n  required?: boolean\n  /** The size of the time field. */\n  size?: TimeFieldSize\n}\n\ntype AriaTimeFieldPropsToOmit =\n  | \"children\"\n  | \"granularity\"\n  | \"placeholderValue\"\n  | \"shouldForceLeadingZeros\"\n  | \"slot\"\n\ntype AriaTimeFieldPropsToInclude =\n  | \"defaultValue\"\n  | \"hideTimeZone\"\n  | \"hourCycle\"\n  | \"name\"\n  | \"onChange\"\n  | \"value\"\n\nexport type TimeFieldElementProps = CombineAriaPropsWithCustomProps<\n  AriaTimeFieldProps<TimeFieldValue>,\n  TimeFieldProps,\n  AriaTimeFieldPropsToOmit,\n  AriaTimeFieldPropsToInclude\n>\n\nexport function TimeField({\n  className,\n  description,\n  disabled,\n  forceLeadingZeros,\n  hideLabel,\n  invalid,\n  label,\n  max,\n  min,\n  readOnly,\n  required,\n  size = \"md\",\n  ...restProps\n}: TimeFieldElementProps) {\n  const combinedClassName = classNames(\n    \"tds-time-field\",\n    { \"tds-time-field--lg\": size === \"lg\" },\n    className\n  )\n\n  return (\n    <AriaTimeField\n      {...restProps}\n      aria-label={hideLabel ? label : undefined}\n      className={combinedClassName}\n      granularity=\"minute\"\n      isDisabled={disabled}\n      isInvalid={invalid}\n      isReadOnly={readOnly}\n      isRequired={required}\n      maxValue={max ?? undefined}\n      minValue={min ?? undefined}\n      shouldForceLeadingZeros={forceLeadingZeros}\n    >\n      {!hideLabel && <Label className=\"tds-time-field-label\">{label}</Label>}\n      <DateInput className=\"tds-time-field-input\">\n        {(segment) => (\n          <DateSegment\n            className={\n              segment.type === \"literal\"\n                ? \"tds-time-field-segment-separator\"\n                : \"tds-time-field-segment\"\n            }\n            segment={segment}\n          />\n        )}\n      </DateInput>\n      {description && (\n        <Text\n          elementType=\"p\"\n          className=\"tds-time-field-description\"\n          slot=\"description\"\n        >\n          <Icon\n            aria-hidden\n            className=\"tds-time-field-description-invalid-icon\"\n            symbol=\"general#exclamation-triangle\"\n          />\n          {description}\n        </Text>\n      )}\n    </AriaTimeField>\n  )\n}\n"],"names":["React","AriaTimeField"],"mappings":";;;;;AAuEM,SAAU,SAAS,CAAC,EACxB,SAAS,EACT,WAAW,EACX,QAAQ,EACR,iBAAiB,EACjB,SAAS,EACT,OAAO,EACP,KAAK,EACL,GAAG,EACH,GAAG,EACH,QAAQ,EACR,QAAQ,EACR,IAAI,GAAG,IAAI,EACX,GAAG,SAAS,EACU,EAAA;AACtB,IAAA,MAAM,iBAAiB,GAAG,UAAU,CAClC,gBAAgB,EAChB,EAAE,oBAAoB,EAAE,IAAI,KAAK,IAAI,EAAE,EACvC,SAAS,CACV;IAED,QACEA,cAAA,CAAA,aAAA,CAACC,WAAa,EAAA,EAAA,GACR,SAAS,gBACD,SAAS,GAAG,KAAK,GAAG,SAAS,EACzC,SAAS,EAAE,iBAAiB,EAC5B,WAAW,EAAC,QAAQ,EACpB,UAAU,EAAE,QAAQ,EACpB,SAAS,EAAE,OAAO,EAClB,UAAU,EAAE,QAAQ,EACpB,UAAU,EAAE,QAAQ,EACpB,QAAQ,EAAE,GAAG,IAAI,SAAS,EAC1B,QAAQ,EAAE,GAAG,IAAI,SAAS,EAC1B,uBAAuB,EAAE,iBAAiB,EAAA;QAEzC,CAAC,SAAS,IAAID,cAAA,CAAA,aAAA,CAAC,KAAK,EAAA,EAAC,SAAS,EAAC,sBAAsB,EAAA,EAAE,KAAK,CAAS;QACtEA,cAAA,CAAA,aAAA,CAAC,SAAS,IAAC,SAAS,EAAC,sBAAsB,EAAA,EACxC,CAAC,OAAO,MACPA,cAAA,CAAA,aAAA,CAAC,WAAW,EAAA,EACV,SAAS,EACP,OAAO,CAAC,IAAI,KAAK;AACf,kBAAE;kBACA,wBAAwB,EAE9B,OAAO,EAAE,OAAO,EAAA,CAChB,CACH,CACS;AACX,QAAA,WAAW,KACVA,cAAA,CAAA,aAAA,CAAC,IAAI,IACH,WAAW,EAAC,GAAG,EACf,SAAS,EAAC,4BAA4B,EACtC,IAAI,EAAC,aAAa,EAAA;YAElBA,cAAA,CAAA,aAAA,CAAC,IAAI,yBAEH,SAAS,EAAC,yCAAyC,EACnD,MAAM,EAAC,8BAA8B,EAAA,CACrC;AACD,YAAA,WAAW,CACP,CACR,CACa;AAEpB;;;;"}

package/dist/components/time-field/index.d.ts

@@ -1,4 +1,4 @@
 import "./index.css";
-export type { TimeFieldElementProps, TimeFieldProps, TimeFieldSize, } from "./TimeField";
+export type { TimeFieldElementProps, TimeFieldProps, TimeFieldSize, TimeFieldValue, } from "./TimeField";
 export { TimeField } from "./TimeField";
 //# sourceMappingURL=index.d.ts.map

package/dist/components/time-field/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/components/time-field/index.ts"],"names":[],"mappings":"AAAA,OAAO,aAAa,CAAA;AAEpB,YAAY,EACV,qBAAqB,EACrB,cAAc,EACd,aAAa,GACd,MAAM,aAAa,CAAA;AACpB,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/components/time-field/index.ts"],"names":[],"mappings":"AAAA,OAAO,aAAa,CAAA;AAEpB,YAAY,EACV,qBAAqB,EACrB,cAAc,EACd,aAAa,EACb,cAAc,GACf,MAAM,aAAa,CAAA;AACpB,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAA"}

package/dist/components/toggle-switch/ToggleSwitch.d.ts

@@ -5,23 +5,29 @@ interface ToggleSwitchBaseProps {
     "aria-invalid"?: never;
     "aria-label"?: never;
     "aria-required"?: never;
+    /** Optional description text that appears below the toggle switch label. */
     description?: string;
     required?: never;
+    /** The size of the toggle switch. */
     size?: ToggleSwitchSize;
 }
 interface ToggleSwitchWithVisibleLabel extends ToggleSwitchBaseProps {
     "aria-labelledby"?: never;
+    /** When true, hides the visible label and sets it as aria-label on the input instead. */
     hideLabel?: false;
     /**
-     * Label content for the toggle switch. When using non-string content
-     * (e.g. JSX), it must not contain interactive elements. This
-     * includes native HTML elements such as `<a>` and `<button>`, as
-     * well as Tapestry or Tapestry-React interactive components.
+     * The label content for the toggle switch. Required unless
+     * `aria-labelledby` is provided to reference an external label. When
+     * using non-string content (e.g. JSX), it must not contain
+     * interactive elements. This includes native HTML elements such as
+     * `<a>` and `<button>`, as well as Tapestry or Tapestry-React
+     * interactive components.
      */
     label: React.ReactNode;
 }
 interface ToggleSwitchWithHiddenLabel extends ToggleSwitchBaseProps {
     "aria-labelledby"?: never;
+    /** When true, hides the visible label and sets it as aria-label on the input instead. */
     hideLabel: true;
     /** Label text for the toggle switch, used as an accessible `aria-label`. */
     label: string;

package/dist/components/toggle-switch/ToggleSwitch.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ToggleSwitch.d.ts","sourceRoot":"","sources":["../../../src/components/toggle-switch/ToggleSwitch.tsx"],"names":[],"mappings":"AAAA,OAAO,aAAa,CAAA;AAIpB,OAAO,KAAK,EAAE,EAAc,mBAAmB,EAAE,MAAM,OAAO,CAAA;AAE9D,MAAM,MAAM,gBAAgB,GAAG,IAAI,GAAG,IAAI,CAAA;AAE1C,UAAU,qBAAqB;IAC7B,cAAc,CAAC,EAAE,KAAK,CAAA;IACtB,YAAY,CAAC,EAAE,KAAK,CAAA;IACpB,eAAe,CAAC,EAAE,KAAK,CAAA;IACvB,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,QAAQ,CAAC,EAAE,KAAK,CAAA;IAChB,IAAI,CAAC,EAAE,gBAAgB,CAAA;CACxB;AAED,UAAU,4BAA6B,SAAQ,qBAAqB;IAClE,iBAAiB,CAAC,EAAE,KAAK,CAAA;IACzB,SAAS,CAAC,EAAE,KAAK,CAAA;IACjB;;;;;OAKG;IACH,KAAK,EAAE,KAAK,CAAC,SAAS,CAAA;CACvB;AAED,UAAU,2BAA4B,SAAQ,qBAAqB;IACjE,iBAAiB,CAAC,EAAE,KAAK,CAAA;IACzB,SAAS,EAAE,IAAI,CAAA;IACf,4EAA4E;IAC5E,KAAK,EAAE,MAAM,CAAA;CACd;AAED,UAAU,8BAA+B,SAAQ,qBAAqB;IACpE,iBAAiB,EAAE,MAAM,CAAA;IACzB,SAAS,CAAC,EAAE,KAAK,CAAA;IACjB,wDAAwD;IACxD,KAAK,CAAC,EAAE,KAAK,CAAA;CACd;AAED,MAAM,MAAM,iBAAiB,GACzB,4BAA4B,GAC5B,2BAA2B,GAC3B,8BAA8B,CAAA;AAElC,MAAM,MAAM,wBAAwB,GAAG,IAAI,CACzC,mBAAmB,CAAC,gBAAgB,CAAC,EACrC,MAAM,iBAAiB,GAAG,MAAM,GAAG,UAAU,GAAG,eAAe,CAChE,GACC,iBAAiB,CAAA;AAEnB;;;;;;;;;;GAUG;AACH,eAAO,MAAM,YAAY,mGA0DxB,CAAA"}
+{"version":3,"file":"ToggleSwitch.d.ts","sourceRoot":"","sources":["../../../src/components/toggle-switch/ToggleSwitch.tsx"],"names":[],"mappings":"AAAA,OAAO,aAAa,CAAA;AAIpB,OAAO,KAAK,EAAE,EAAc,mBAAmB,EAAE,MAAM,OAAO,CAAA;AAE9D,MAAM,MAAM,gBAAgB,GAAG,IAAI,GAAG,IAAI,CAAA;AAE1C,UAAU,qBAAqB;IAC7B,cAAc,CAAC,EAAE,KAAK,CAAA;IACtB,YAAY,CAAC,EAAE,KAAK,CAAA;IACpB,eAAe,CAAC,EAAE,KAAK,CAAA;IACvB,4EAA4E;IAC5E,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,QAAQ,CAAC,EAAE,KAAK,CAAA;IAChB,qCAAqC;IACrC,IAAI,CAAC,EAAE,gBAAgB,CAAA;CACxB;AAED,UAAU,4BAA6B,SAAQ,qBAAqB;IAClE,iBAAiB,CAAC,EAAE,KAAK,CAAA;IACzB,yFAAyF;IACzF,SAAS,CAAC,EAAE,KAAK,CAAA;IACjB;;;;;;;OAOG;IACH,KAAK,EAAE,KAAK,CAAC,SAAS,CAAA;CACvB;AAED,UAAU,2BAA4B,SAAQ,qBAAqB;IACjE,iBAAiB,CAAC,EAAE,KAAK,CAAA;IACzB,yFAAyF;IACzF,SAAS,EAAE,IAAI,CAAA;IACf,4EAA4E;IAC5E,KAAK,EAAE,MAAM,CAAA;CACd;AAED,UAAU,8BAA+B,SAAQ,qBAAqB;IACpE,iBAAiB,EAAE,MAAM,CAAA;IACzB,SAAS,CAAC,EAAE,KAAK,CAAA;IACjB,wDAAwD;IACxD,KAAK,CAAC,EAAE,KAAK,CAAA;CACd;AAED,MAAM,MAAM,iBAAiB,GACzB,4BAA4B,GAC5B,2BAA2B,GAC3B,8BAA8B,CAAA;AAElC,MAAM,MAAM,wBAAwB,GAAG,IAAI,CACzC,mBAAmB,CAAC,gBAAgB,CAAC,EACrC,MAAM,iBAAiB,GAAG,MAAM,GAAG,UAAU,GAAG,eAAe,CAChE,GACC,iBAAiB,CAAA;AAEnB;;;;;;;;;;GAUG;AACH,eAAO,MAAM,YAAY,mGA0DxB,CAAA"}

package/dist/components/toggle-switch/ToggleSwitch.js.map

@@ -1 +1 @@
-{"version":3,"file":"ToggleSwitch.js","sources":["../../../src/components/toggle-switch/ToggleSwitch.tsx"],"sourcesContent":["import \"./index.css\"\n\nimport { useId } from \"@utilities/useId\"\nimport classNames from \"classnames\"\nimport React, { forwardRef, InputHTMLAttributes } from \"react\"\n\nexport type ToggleSwitchSize = \"md\" | \"sm\"\n\ninterface ToggleSwitchBaseProps {\n  \"aria-invalid\"?: never\n  \"aria-label\"?: never\n  \"aria-required\"?: never\n  description?: string\n  required?: never\n  size?: ToggleSwitchSize\n}\n\ninterface ToggleSwitchWithVisibleLabel extends ToggleSwitchBaseProps {\n  \"aria-labelledby\"?: never\n  hideLabel?: false\n  /**\n   * Label content for the toggle switch. When using non-string content\n   * (e.g. JSX), it must not contain interactive elements. This\n   * includes native HTML elements such as `<a>` and `<button>`, as\n   * well as Tapestry or Tapestry-React interactive components.\n   */\n  label: React.ReactNode\n}\n\ninterface ToggleSwitchWithHiddenLabel extends ToggleSwitchBaseProps {\n  \"aria-labelledby\"?: never\n  hideLabel: true\n  /** Label text for the toggle switch, used as an accessible `aria-label`. */\n  label: string\n}\n\ninterface ToggleSwitchWithAriaLabelledBy extends ToggleSwitchBaseProps {\n  \"aria-labelledby\": string\n  hideLabel?: never\n  /** Not available when `aria-labelledby` is provided. */\n  label?: never\n}\n\nexport type ToggleSwitchProps =\n  | ToggleSwitchWithVisibleLabel\n  | ToggleSwitchWithHiddenLabel\n  | ToggleSwitchWithAriaLabelledBy\n\nexport type ToggleSwitchElementProps = Omit<\n  InputHTMLAttributes<HTMLInputElement>,\n  keyof ToggleSwitchProps | \"type\" | \"required\" | \"aria-required\"\n> &\n  ToggleSwitchProps\n\n/**\n * A toggle switch component that renders as a checkbox input styled as a switch.\n *\n * **Required:** You must provide either:\n * - `label` - Label content for the switch (must be a string when `hideLabel` is true)\n * - `aria-labelledby` - ID of an external element that provides the label\n *\n * When using non-string content for `label` (e.g. JSX), it must not contain\n * interactive elements. This includes native HTML elements such as `<a>` and\n * `<button>`, as well as Tapestry or Tapestry-React interactive components.\n */\nexport const ToggleSwitch = forwardRef<\n  HTMLInputElement,\n  ToggleSwitchElementProps\n>(\n  (\n    {\n      \"aria-describedby\": ariaDescribedby,\n      checked,\n      className,\n      description,\n      hideLabel = false,\n      id,\n      label,\n      size = \"md\",\n      ...restProps\n    }: ToggleSwitchElementProps,\n    ref\n  ) => {\n    const combinedClassName = classNames(\n      \"tds-toggle-switch\",\n      size && size === \"sm\" && `tds-toggle-switch--sm`,\n      hideLabel && `tds-toggle-switch--hide-label`,\n      className\n    )\n\n    const stableId = useId()\n    const toggleSwitchId = id || `tds-toggle-switch-${stableId}`\n\n    return (\n      <div className={combinedClassName}>\n        <div className=\"tds-toggle-switch-track\" aria-hidden=\"true\"></div>\n        <input\n          {...restProps}\n          id={toggleSwitchId}\n          type=\"checkbox\"\n          role=\"switch\"\n          aria-checked={checked}\n          aria-label={hideLabel ? (label as string) : undefined}\n          aria-describedby={\n            description && !hideLabel\n              ? `${toggleSwitchId}-description`\n              : ariaDescribedby\n          }\n          checked={checked}\n          ref={ref}\n        />\n        {label && !hideLabel && <label htmlFor={toggleSwitchId}>{label}</label>}\n        {description && !hideLabel && (\n          <p\n            id={`${toggleSwitchId}-description`}\n            className=\"tds-toggle-switch-description\"\n          >\n            {description}\n          </p>\n        )}\n      </div>\n    )\n  }\n)\n\nToggleSwitch.displayName = \"ToggleSwitch\"\n"],"names":["React"],"mappings":";;;;AAsDA;;;;;;;;;;AAUG;AACI,MAAM,YAAY,GAAG,UAAU,CAIpC,CACE,EACE,kBAAkB,EAAE,eAAe,EACnC,OAAO,EACP,SAAS,EACT,WAAW,EACX,SAAS,GAAG,KAAK,EACjB,EAAE,EACF,KAAK,EACL,IAAI,GAAG,IAAI,EACX,GAAG,SAAS,EACa,EAC3B,GAAG,KACD;IACF,MAAM,iBAAiB,GAAG,UAAU,CAClC,mBAAmB,EACnB,IAAI,IAAI,IAAI,KAAK,IAAI,IAAI,CAAA,qBAAA,CAAuB,EAChD,SAAS,IAAI,+BAA+B,EAC5C,SAAS,CACV;AAED,IAAA,MAAM,QAAQ,GAAG,KAAK,EAAE;AACxB,IAAA,MAAM,cAAc,GAAG,EAAE,IAAI,CAAA,kBAAA,EAAqB,QAAQ,EAAE;AAE5D,IAAA,QACEA,cAAA,CAAA,aAAA,CAAA,KAAA,EAAA,EAAK,SAAS,EAAE,iBAAiB,EAAA;AAC/B,QAAAA,cAAA,CAAA,aAAA,CAAA,KAAA,EAAA,EAAK,SAAS,EAAC,yBAAyB,EAAA,aAAA,EAAa,MAAM,EAAA,CAAO;AAClE,QAAAA,cAAA,CAAA,aAAA,CAAA,OAAA,EAAA,EAAA,GACM,SAAS,EACb,EAAE,EAAE,cAAc,EAClB,IAAI,EAAC,UAAU,EACf,IAAI,EAAC,QAAQ,EAAA,cAAA,EACC,OAAO,EAAA,YAAA,EACT,SAAS,GAAI,KAAgB,GAAG,SAAS,EAAA,kBAAA,EAEnD,WAAW,IAAI,CAAC;kBACZ,CAAA,EAAG,cAAc,CAAA,YAAA;kBACjB,eAAe,EAErB,OAAO,EAAE,OAAO,EAChB,GAAG,EAAE,GAAG,EAAA,CACR;QACD,KAAK,IAAI,CAAC,SAAS,IAAIA,cAAA,CAAA,aAAA,CAAA,OAAA,EAAA,EAAO,OAAO,EAAE,cAAc,EAAA,EAAG,KAAK,CAAS;QACtE,WAAW,IAAI,CAAC,SAAS,KACxBA,cAAA,CAAA,aAAA,CAAA,GAAA,EAAA,EACE,EAAE,EAAE,CAAA,EAAG,cAAc,cAAc,EACnC,SAAS,EAAC,+BAA+B,EAAA,EAExC,WAAW,CACV,CACL,CACG;AAEV,CAAC;AAGH,YAAY,CAAC,WAAW,GAAG,cAAc;;;;"}
+{"version":3,"file":"ToggleSwitch.js","sources":["../../../src/components/toggle-switch/ToggleSwitch.tsx"],"sourcesContent":["import \"./index.css\"\n\nimport { useId } from \"@utilities/useId\"\nimport classNames from \"classnames\"\nimport React, { forwardRef, InputHTMLAttributes } from \"react\"\n\nexport type ToggleSwitchSize = \"md\" | \"sm\"\n\ninterface ToggleSwitchBaseProps {\n  \"aria-invalid\"?: never\n  \"aria-label\"?: never\n  \"aria-required\"?: never\n  /** Optional description text that appears below the toggle switch label. */\n  description?: string\n  required?: never\n  /** The size of the toggle switch. */\n  size?: ToggleSwitchSize\n}\n\ninterface ToggleSwitchWithVisibleLabel extends ToggleSwitchBaseProps {\n  \"aria-labelledby\"?: never\n  /** When true, hides the visible label and sets it as aria-label on the input instead. */\n  hideLabel?: false\n  /**\n   * The label content for the toggle switch. Required unless\n   * `aria-labelledby` is provided to reference an external label. When\n   * using non-string content (e.g. JSX), it must not contain\n   * interactive elements. This includes native HTML elements such as\n   * `<a>` and `<button>`, as well as Tapestry or Tapestry-React\n   * interactive components.\n   */\n  label: React.ReactNode\n}\n\ninterface ToggleSwitchWithHiddenLabel extends ToggleSwitchBaseProps {\n  \"aria-labelledby\"?: never\n  /** When true, hides the visible label and sets it as aria-label on the input instead. */\n  hideLabel: true\n  /** Label text for the toggle switch, used as an accessible `aria-label`. */\n  label: string\n}\n\ninterface ToggleSwitchWithAriaLabelledBy extends ToggleSwitchBaseProps {\n  \"aria-labelledby\": string\n  hideLabel?: never\n  /** Not available when `aria-labelledby` is provided. */\n  label?: never\n}\n\nexport type ToggleSwitchProps =\n  | ToggleSwitchWithVisibleLabel\n  | ToggleSwitchWithHiddenLabel\n  | ToggleSwitchWithAriaLabelledBy\n\nexport type ToggleSwitchElementProps = Omit<\n  InputHTMLAttributes<HTMLInputElement>,\n  keyof ToggleSwitchProps | \"type\" | \"required\" | \"aria-required\"\n> &\n  ToggleSwitchProps\n\n/**\n * A toggle switch component that renders as a checkbox input styled as a switch.\n *\n * **Required:** You must provide either:\n * - `label` - Label content for the switch (must be a string when `hideLabel` is true)\n * - `aria-labelledby` - ID of an external element that provides the label\n *\n * When using non-string content for `label` (e.g. JSX), it must not contain\n * interactive elements. This includes native HTML elements such as `<a>` and\n * `<button>`, as well as Tapestry or Tapestry-React interactive components.\n */\nexport const ToggleSwitch = forwardRef<\n  HTMLInputElement,\n  ToggleSwitchElementProps\n>(\n  (\n    {\n      \"aria-describedby\": ariaDescribedby,\n      checked,\n      className,\n      description,\n      hideLabel = false,\n      id,\n      label,\n      size = \"md\",\n      ...restProps\n    }: ToggleSwitchElementProps,\n    ref\n  ) => {\n    const combinedClassName = classNames(\n      \"tds-toggle-switch\",\n      size && size === \"sm\" && `tds-toggle-switch--sm`,\n      hideLabel && `tds-toggle-switch--hide-label`,\n      className\n    )\n\n    const stableId = useId()\n    const toggleSwitchId = id || `tds-toggle-switch-${stableId}`\n\n    return (\n      <div className={combinedClassName}>\n        <div className=\"tds-toggle-switch-track\" aria-hidden=\"true\"></div>\n        <input\n          {...restProps}\n          id={toggleSwitchId}\n          type=\"checkbox\"\n          role=\"switch\"\n          aria-checked={checked}\n          aria-label={hideLabel ? (label as string) : undefined}\n          aria-describedby={\n            description && !hideLabel\n              ? `${toggleSwitchId}-description`\n              : ariaDescribedby\n          }\n          checked={checked}\n          ref={ref}\n        />\n        {label && !hideLabel && <label htmlFor={toggleSwitchId}>{label}</label>}\n        {description && !hideLabel && (\n          <p\n            id={`${toggleSwitchId}-description`}\n            className=\"tds-toggle-switch-description\"\n          >\n            {description}\n          </p>\n        )}\n      </div>\n    )\n  }\n)\n\nToggleSwitch.displayName = \"ToggleSwitch\"\n"],"names":["React"],"mappings":";;;;AA4DA;;;;;;;;;;AAUG;AACI,MAAM,YAAY,GAAG,UAAU,CAIpC,CACE,EACE,kBAAkB,EAAE,eAAe,EACnC,OAAO,EACP,SAAS,EACT,WAAW,EACX,SAAS,GAAG,KAAK,EACjB,EAAE,EACF,KAAK,EACL,IAAI,GAAG,IAAI,EACX,GAAG,SAAS,EACa,EAC3B,GAAG,KACD;IACF,MAAM,iBAAiB,GAAG,UAAU,CAClC,mBAAmB,EACnB,IAAI,IAAI,IAAI,KAAK,IAAI,IAAI,CAAA,qBAAA,CAAuB,EAChD,SAAS,IAAI,+BAA+B,EAC5C,SAAS,CACV;AAED,IAAA,MAAM,QAAQ,GAAG,KAAK,EAAE;AACxB,IAAA,MAAM,cAAc,GAAG,EAAE,IAAI,CAAA,kBAAA,EAAqB,QAAQ,EAAE;AAE5D,IAAA,QACEA,cAAA,CAAA,aAAA,CAAA,KAAA,EAAA,EAAK,SAAS,EAAE,iBAAiB,EAAA;AAC/B,QAAAA,cAAA,CAAA,aAAA,CAAA,KAAA,EAAA,EAAK,SAAS,EAAC,yBAAyB,EAAA,aAAA,EAAa,MAAM,EAAA,CAAO;AAClE,QAAAA,cAAA,CAAA,aAAA,CAAA,OAAA,EAAA,EAAA,GACM,SAAS,EACb,EAAE,EAAE,cAAc,EAClB,IAAI,EAAC,UAAU,EACf,IAAI,EAAC,QAAQ,EAAA,cAAA,EACC,OAAO,EAAA,YAAA,EACT,SAAS,GAAI,KAAgB,GAAG,SAAS,EAAA,kBAAA,EAEnD,WAAW,IAAI,CAAC;kBACZ,CAAA,EAAG,cAAc,CAAA,YAAA;kBACjB,eAAe,EAErB,OAAO,EAAE,OAAO,EAChB,GAAG,EAAE,GAAG,EAAA,CACR;QACD,KAAK,IAAI,CAAC,SAAS,IAAIA,cAAA,CAAA,aAAA,CAAA,OAAA,EAAA,EAAO,OAAO,EAAE,cAAc,EAAA,EAAG,KAAK,CAAS;QACtE,WAAW,IAAI,CAAC,SAAS,KACxBA,cAAA,CAAA,aAAA,CAAA,GAAA,EAAA,EACE,EAAE,EAAE,CAAA,EAAG,cAAc,cAAc,EACnC,SAAS,EAAC,+BAA+B,EAAA,EAExC,WAAW,CACV,CACL,CACG;AAEV,CAAC;AAGH,YAAY,CAAC,WAAW,GAAG,cAAc;;;;"}