@oslokommune/punkt-react 16.19.0 → 16.20.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@oslokommune/punkt-react",
-  "version": "16.19.0",
+  "version": "16.20.0",
   "description": "React komponentbibliotek til Punkt, et designsystem laget av Oslo Origo",
   "homepage": "https://punkt.oslo.kommune.no",
   "author": "Team Designsystem, Oslo Origo",
@@ -109,5 +109,5 @@
     "url": "https://github.com/oslokommune/punkt/issues"
   },
   "license": "MIT",
-  "gitHead": "e90194e9a4c25a6b7a5370c05889e262b4e6cfb0"
+  "gitHead": "dee5033c347f7c10530f57d5dc05c5411b75033f"
 }

package/src/components/helptext/Helptext.test.tsx

@@ -0,0 +1,98 @@
+import '@testing-library/jest-dom'
+
+import { fireEvent, render, screen } from '@testing-library/react'
+import { vi } from 'vitest'
+
+import { PktHelptext } from './Helptext'
+
+describe('PktHelptext', () => {
+  test('renders the container without the has-helptext modifier when empty', () => {
+    const { container } = render(<PktHelptext forId="field" />)
+
+    const root = container.querySelector('.pkt-inputwrapper__helptext-container')
+    expect(root).toBeInTheDocument()
+    expect(root).not.toHaveClass('pkt-inputwrapper__has-helptext')
+  })
+
+  test('renders helptext string as HTML inside the helptext div', () => {
+    const { container } = render(<PktHelptext forId="field" helptext="Hjelp <strong>her</strong>" />)
+
+    const helptext = container.querySelector(`#field-helptext`)
+    expect(helptext).toBeInTheDocument()
+    expect(helptext?.querySelector('strong')).toHaveTextContent('her')
+    expect(container.querySelector('.pkt-inputwrapper__helptext-container')).toHaveClass(
+      'pkt-inputwrapper__has-helptext',
+    )
+  })
+
+  test('renders helptext ReactNode directly', () => {
+    render(
+      <PktHelptext forId="field" helptext={<em data-testid="rn">Rich</em>} />,
+    )
+
+    expect(screen.getByTestId('rn')).toHaveTextContent('Rich')
+  })
+
+  test('renders children inside pkt-contents', () => {
+    const { container } = render(
+      <PktHelptext forId="field">
+        <span data-testid="slot">Slot content</span>
+      </PktHelptext>,
+    )
+
+    const contents = container.querySelector('.pkt-contents')
+    expect(contents).toBeInTheDocument()
+    expect(contents?.querySelector('[data-testid="slot"]')).toHaveTextContent('Slot content')
+  })
+
+  test('renders the dropdown toggle button with the default label when no button text is provided', () => {
+    render(<PktHelptext forId="field" helptextDropdown="Mer info" />)
+
+    const button = screen.getByRole('button')
+    expect(button.querySelector('.pkt-btn__text')).toHaveTextContent('Les mer')
+  })
+
+  test('renders a custom helptextDropdownButton as HTML', () => {
+    render(
+      <PktHelptext
+        forId="field"
+        helptextDropdown="Mer info"
+        helptextDropdownButton="Vis <em>detaljer</em>"
+      />,
+    )
+
+    const button = screen.getByRole('button')
+    expect(button.querySelector('em')).toHaveTextContent('detaljer')
+  })
+
+  test('toggles the dropdown open class and calls onToggleHelpText', () => {
+    const onToggle = vi.fn()
+    const { container } = render(
+      <PktHelptext
+        forId="field"
+        helptextDropdown="Mer info"
+        onToggleHelpText={onToggle}
+      />,
+    )
+
+    const expandable = container.querySelector('.pkt-inputwrapper__helptext-expandable')
+    const innerHelptext = expandable?.querySelector('.pkt-inputwrapper__helptext')
+    expect(innerHelptext).toHaveClass('pkt-inputwrapper__helptext-expandable-closed')
+
+    fireEvent.click(screen.getByRole('button'))
+    expect(innerHelptext).toHaveClass('pkt-inputwrapper__helptext-expandable-open')
+    expect(onToggle).toHaveBeenLastCalledWith(true)
+
+    fireEvent.click(screen.getByRole('button'))
+    expect(innerHelptext).toHaveClass('pkt-inputwrapper__helptext-expandable-closed')
+    expect(onToggle).toHaveBeenLastCalledWith(false)
+  })
+
+  test('does not render an id on the helptext div when forId is missing', () => {
+    const { container } = render(<PktHelptext helptext="No id here" />)
+
+    const helptext = container.querySelector('.pkt-inputwrapper__helptext')
+    expect(helptext).toBeInTheDocument()
+    expect(helptext).not.toHaveAttribute('id')
+  })
+})

package/src/components/helptext/Helptext.tsx

@@ -1,37 +1,95 @@
 'use client'
 
-import { createComponent, EventName } from '@lit/react'
-import { PktHelptext as PktElHelptext } from '@oslokommune/punkt-elements'
-// eslint-disable-next-line no-restricted-syntax -- React is required for createComponent
-import React, { FC, forwardRef, ForwardRefExoticComponent, HTMLAttributes, LegacyRef, type ReactNode } from 'react'
+import classNames from 'classnames'
+import { forwardRef, HTMLAttributes, ReactNode, useState } from 'react'
+
+import { PktIcon } from '../icon/Icon'
+
+const defaultDropdownButton = "Les mer <span class='pkt-sr-only'>om feltet</span>"
 
 export interface IPktHelptextProps extends HTMLAttributes<HTMLDivElement> {
-  helptext?: string | ReactNode | ReactNode[]
-  helptextDropdown?: string | ReactNode | ReactNode[]
+  helptext?: string | ReactNode
+  helptextDropdown?: string | ReactNode
   helptextDropdownButton?: string
   forId?: string
-  ref?: LegacyRef<HTMLDivElement>
-  onToggleHelpText?: (e: CustomEvent) => void
+  onToggleHelpText?: (isOpen: boolean) => void
 }
 
-export const LitComponent = createComponent({
-  tagName: 'pkt-helptext',
-  elementClass: PktElHelptext,
-  react: React,
-  displayName: 'PktHelptext',
-  events: {
-    onToggleHelpText: 'toggleHelpText' as EventName<CustomEvent>,
-  },
-}) as ForwardRefExoticComponent<IPktHelptextProps>
-
-export const PktHelptext: FC<IPktHelptextProps> = forwardRef(
-  ({ children, ...props }, ref: LegacyRef<HTMLDivElement>) => {
-    return (
-      <LitComponent {...props} ref={ref}>
-        <div className="pkt-contents">{children}</div>
-      </LitComponent>
-    )
+const renderContent = (content: string | ReactNode | undefined): ReactNode => {
+  if (content === undefined || content === null || content === '') return null
+  if (typeof content === 'string') {
+    return <span dangerouslySetInnerHTML={{ __html: content }} />
+  }
+  return content
+}
+
+export const PktHelptext = forwardRef<HTMLDivElement, IPktHelptextProps>(function PktHelptext(
+  {
+    helptext,
+    helptextDropdown,
+    helptextDropdownButton,
+    forId,
+    onToggleHelpText,
+    className,
+    children,
+    ...rest
   },
-)
+  ref,
+) {
+  const [isOpen, setIsOpen] = useState(false)
+
+  const toggle = () => {
+    const next = !isOpen
+    setIsOpen(next)
+    onToggleHelpText?.(next)
+  }
+
+  const hasContent = Boolean(helptext || helptextDropdown || children)
+
+  const containerClasses = classNames(
+    'pkt-inputwrapper__helptext-container',
+    hasContent && 'pkt-inputwrapper__has-helptext',
+    className,
+  )
+
+  return (
+    <div {...rest} ref={ref} className={containerClasses}>
+      <div className="pkt-inputwrapper__helptext" id={forId ? `${forId}-helptext` : undefined}>
+        {children && <div className="pkt-contents">{children}</div>}
+        {renderContent(helptext)}
+      </div>
+      {helptextDropdown && (
+        <div className="pkt-inputwrapper__helptext-expandable">
+          <button
+            type="button"
+            className="pkt-link pkt-link--icon-right pkt-btn pkt-btn--small pkt-btn--tertiary pkt-btn--icon-right"
+            onClick={toggle}
+          >
+            <PktIcon
+              className="pkt-btn__icon"
+              name={isOpen ? 'chevron-thin-up' : 'chevron-thin-down'}
+            />
+            <span
+              className="pkt-btn__text"
+              dangerouslySetInnerHTML={{
+                __html: helptextDropdownButton ?? defaultDropdownButton,
+              }}
+            />
+          </button>
+          <div
+            className={classNames(
+              'pkt-inputwrapper__helptext',
+              isOpen
+                ? 'pkt-inputwrapper__helptext-expandable-open'
+                : 'pkt-inputwrapper__helptext-expandable-closed',
+            )}
+          >
+            {renderContent(helptextDropdown)}
+          </div>
+        </div>
+      )}
+    </div>
+  )
+})
 
 PktHelptext.displayName = 'PktHelptext'

package/src/components/inputwrapper/InputWrapper.tsx

@@ -1,10 +1,10 @@
 'use client'
 
-import { ForwardedRef, forwardRef, type ReactNode, RefAttributes, useState } from 'react'
+import { ForwardedRef, forwardRef, type ReactNode, RefAttributes } from 'react'
 
 import { useFocusModality } from '../../hooks/useFocusModality'
 import { PktAlert } from '../alert/Alert'
-import { PktButton } from '../button/Button'
+import { PktHelptext } from '../helptext/Helptext'
 
 export interface IPktInputWrapper extends RefAttributes<HTMLElement> {
   forId: string
@@ -63,8 +63,6 @@ export const PktInputWrapper = forwardRef(
     }: IPktInputWrapper,
     ref: ForwardedRef<HTMLDivElement>,
   ) => {
-    const [isHelpTextOpen, setIsHelpTextOpen] = useState(false)
-
     const focusModality = useFocusModality<HTMLDivElement>(ref)
 
     const describedBy = ariaDescribedby || (helptext ? `${forId}-helptext` : undefined)
@@ -72,8 +70,6 @@ export const PktInputWrapper = forwardRef(
     const counterTop = showCounter && counterPosition === 'top'
     const counterBottom = showCounter && counterPosition === 'bottom'
 
-    const toggleHelpText = () => setIsHelpTextOpen((prev) => !prev)
-
     const wrapperClasses = [
       'pkt-inputwrapper',
       className,
@@ -134,43 +130,16 @@ export const PktInputWrapper = forwardRef(
     }
 
     const renderHelptext = () => {
-      if (!helptext && !helptextDropdown) return null
+      const visibleHelptext = useWrapper ? helptext : undefined
+      if (!visibleHelptext && !helptextDropdown) return null
 
       return (
-        <>
-          {helptext && useWrapper && (
-            <div className="pkt-inputwrapper__helptext" id={`${forId}-helptext`}>
-              {helptext}
-            </div>
-          )}
-          {helptextDropdown && (
-            <div className="pkt-inputwrapper__helptext-expandable">
-              <PktButton
-                skin="tertiary"
-                size="small"
-                variant="icon-right"
-                iconName={isHelpTextOpen ? 'chevron-thin-up' : 'chevron-thin-down'}
-                className="pkt-link pkt-link--icon-right"
-                onClick={toggleHelpText}
-              >
-                <span
-                  dangerouslySetInnerHTML={{
-                    __html: helptextDropdownButton ?? 'Les mer <span class="pkt-sr-only">om inputfeltet</span>',
-                  }}
-                />
-              </PktButton>
-              <div
-                className={`pkt-inputwrapper__helptext ${
-                  isHelpTextOpen
-                    ? 'pkt-inputwrapper__helptext-expandable-open'
-                    : 'pkt-inputwrapper__helptext-expandable-closed'
-                }`}
-              >
-                {helptextDropdown}
-              </div>
-            </div>
-          )}
-        </>
+        <PktHelptext
+          forId={forId}
+          helptext={visibleHelptext}
+          helptextDropdown={helptextDropdown}
+          helptextDropdownButton={helptextDropdownButton}
+        />
       )
     }