@arbor-education/design-system.components 3.4.5 → 4.0.0-react19-alpha.0

package/dist/utils/PopupParentContext.stories.js

@@ -0,0 +1,266 @@
+import { jsx as _jsx, Fragment as _Fragment, jsxs as _jsxs } from "react/jsx-runtime";
+import { useRef } from 'react';
+import { Heading as DocHeading, Markdown, Stories, Subtitle, Title, } from '@storybook/addon-docs/blocks';
+import { PopupParentContext } from './PopupParentContext.js';
+import { Button } from '../components/button/Button.js';
+import { Dropdown } from '../components/dropdown/Dropdown.js';
+// ---------------------------------------------------------------------------
+// Docs page content
+// ---------------------------------------------------------------------------
+const DESCRIPTION_INTRO = [
+    '`PopupParentContext` is a React context that controls where portalled floating elements',
+    '— dropdowns, tooltips, date pickers, comboboxes — are rendered in the DOM.',
+    'In most applications you do **not** need to configure this: the default behaviour portals all floating',
+    'content to a shared `<div id="ds-popup-parent">` appended to `document.body`.',
+].join(' ');
+const USAGE_GUIDANCE = [
+    '### When you need PopupParentContext',
+    '',
+    '- **Custom virtualised panels** — when your layout clips content with `overflow: hidden` AND you need',
+    '  popups to appear inside that container (not body), provide a ref to a container element inside the',
+    '  clip boundary',
+    '- **Non-Arbor modals and drawers** — if you wrap Arbor components inside a third-party modal, floating',
+    '  elements may render beneath the modal overlay due to z-index stacking. Provide a container inside the',
+    '  modal to keep popups on top',
+    '- **Custom stacking contexts** — when `transform`, `isolation`, or `will-change` creates a stacking',
+    '  context above `z-index: 1` (the default popup parent z-index), popups may appear beneath fixed UI',
+    '  chrome. Move the container inside the stacking context',
+    '',
+    '---',
+    '',
+    '### When you do NOT need PopupParentContext',
+    '',
+    '| Situation | Why you are safe |',
+    '|---|---|',
+    '| `Dropdown`, `Tooltip`, `Combobox` in a standard page layout | Default context portals to `document.body` — no clipping |',
+    '| Floating elements inside Arbor `Modal` | Modal provides its overlay as the popup parent automatically |',
+    '| `Table` column filters | `BooleanFilter` and `TimeFilter` wrap their children in a provider automatically |',
+].join('\n');
+const DEVELOPER_NOTES = [
+    '### Components that consume PopupParentContext',
+    '',
+    '| Component | What gets portalled |',
+    '|---|---|',
+    '| `Dropdown` | `Dropdown.Content` panel |',
+    '| `Tooltip` | Tooltip bubble |',
+    '| `Combobox` | Options listbox |',
+    '| `DatePicker` | Calendar popup |',
+    '| `DateTimePicker` | Calendar + time popup |',
+    '| `Modal` | Modal overlay (also provides itself as parent for any floating elements inside) |',
+    '| `SlideoverManager` | Slideover panel |',
+    '| `Table` column filters | `BooleanFilter`, `TimeFilter` (wraps automatically) |',
+    '',
+    '---',
+    '',
+    '### Usage',
+    '',
+    '```tsx',
+    'import { useRef } from \'react\';',
+    'import { PopupParentContext, Dropdown } from \'@arbor-education/design-system.components\';',
+    '',
+    'function ClippedPanel() {',
+    '  // ref points to the container that should receive portalled content',
+    '  const popupContainerRef = useRef<HTMLDivElement>(null);',
+    '',
+    '  return (',
+    '    <div style={{ position: \'relative\', overflow: \'hidden\', maxHeight: 300 }}>',
+    '      {/*',
+    '        This div sits OUTSIDE the overflow:hidden clip boundary.',
+    '        Floating elements portal here instead of document.body.',
+    '      */}',
+    '      <div ref={popupContainerRef} style={{ position: \'fixed\', zIndex: 100 }} />',
+    '',
+    '      <PopupParentContext.Provider value={popupContainerRef}>',
+    '        <Dropdown>',
+    '          <Dropdown.Trigger>',
+    '            <Button variant="dropdown">Actions</Button>',
+    '          </Dropdown.Trigger>',
+    '          <Dropdown.Content>',
+    '            <Dropdown.Item>Edit record</Dropdown.Item>',
+    '            <Dropdown.Item>Delete record</Dropdown.Item>',
+    '          </Dropdown.Content>',
+    '        </Dropdown>',
+    '      </PopupParentContext.Provider>',
+    '    </div>',
+    '  );',
+    '}',
+    '```',
+    '',
+    '---',
+    '',
+    '### Default behaviour',
+    '',
+    'When no provider wraps your component tree, `PopupParentContext` falls back to a ref pointing to',
+    '`div#ds-popup-parent`. This element is created once and appended to `document.body` with',
+    '`position: fixed; z-index: 1`. All floating elements on the page share it.',
+    '',
+    'You can pre-create this element for SSR environments:',
+    '```html',
+    '<div id="ds-popup-parent" style="position: fixed; z-index: 1;"></div>',
+    '```',
+    '',
+    '---',
+    '',
+    '### Accessibility',
+    '',
+    '- Portalling to `document.body` or a fixed container does not break focus management — Radix UI',
+    '  and the DS components handle focus trapping and restoration internally',
+    '- Ensure the portal container has no `aria-hidden` ancestor — this would hide portalled content from',
+    '  assistive technology even if it is visible on screen',
+].join('\n');
+const RELATED_COMPONENTS = [
+    '## Related components',
+    '',
+    '[Dropdown](?path=/docs/components-dropdown--docs) · [Tooltip](?path=/docs/components-tooltip--docs) · [Combobox](?path=/docs/components-combobox--docs) · [DatePicker](?path=/docs/components-datepicker--docs) · [Modal](?path=/docs/components-modal--docs)',
+].join('\n');
+// ---------------------------------------------------------------------------
+// Docs page
+// ---------------------------------------------------------------------------
+function PopupParentContextDocsPage() {
+    return (_jsxs(_Fragment, { children: [_jsx(Title, {}), _jsx(Subtitle, {}), _jsx(Markdown, { children: DESCRIPTION_INTRO }), _jsx(DocHeading, { children: "Usage guidance" }), _jsx(Markdown, { children: USAGE_GUIDANCE }), _jsx(DocHeading, { children: "Developer notes" }), _jsx(Markdown, { children: DEVELOPER_NOTES }), _jsx(DocHeading, { children: "Examples" }), _jsx(Stories, { title: "" }), _jsx(Markdown, { children: RELATED_COMPONENTS })] }));
+}
+// ---------------------------------------------------------------------------
+// Meta
+// ---------------------------------------------------------------------------
+const meta = {
+    title: 'Utils/PopupParentContext',
+    parameters: {
+        layout: 'padded',
+        docs: {
+            page: PopupParentContextDocsPage,
+        },
+    },
+    tags: ['autodocs'],
+};
+export default meta;
+// ---------------------------------------------------------------------------
+// Helper
+// ---------------------------------------------------------------------------
+const withDescription = (story, description) => ({
+    ...story,
+    parameters: {
+        ...story.parameters,
+        docs: {
+            ...story.parameters?.docs,
+            description: {
+                story: description,
+            },
+        },
+    },
+});
+// ---------------------------------------------------------------------------
+// Templates
+// ---------------------------------------------------------------------------
+const DefaultTemplate = () => (_jsxs("div", { style: {
+        border: 'var(--border-weight) solid var(--color-grey-200)',
+        borderRadius: 'var(--border-radius-small)',
+        padding: 'var(--spacing-medium)',
+        overflow: 'hidden',
+        maxHeight: '120px',
+        display: 'flex',
+        flexDirection: 'column',
+        gap: 'var(--spacing-small)',
+    }, children: [_jsxs("p", { style: { margin: 0, fontSize: 'var(--font-size-2-13)', color: 'var(--color-grey-700)' }, children: ["This panel has", ' ', _jsx("code", { children: "overflow: hidden" }), ' ', "\u2014 yet the dropdown opens correctly."] }), _jsxs(Dropdown, { children: [_jsx(Dropdown.Trigger, { children: _jsx(Button, { variant: "dropdown", children: "Actions" }) }), _jsxs(Dropdown.Content, { children: [_jsx(Dropdown.Item, { children: "View pupil profile" }), _jsx(Dropdown.Item, { children: "Edit enrolment" }), _jsx(Dropdown.Separator, {}), _jsx(Dropdown.Item, { children: "Remove from group" })] })] })] }));
+const WithCustomContainerTemplate = () => {
+    const popupContainerRef = useRef(null);
+    return (_jsxs("div", { style: { position: 'relative', display: 'flex', flexDirection: 'column', gap: 'var(--spacing-small)' }, children: [_jsxs("p", { style: { margin: 0, fontSize: 'var(--font-size-2-13)', color: 'var(--color-grey-700)' }, children: ["The dropdown portals into", ' ', _jsx("code", { children: "popupContainerRef" }), ' ', "(the pink border below) instead of", ' ', _jsx("code", { children: "document.body" }), "."] }), _jsx("div", { ref: popupContainerRef, style: {
+                    position: 'relative',
+                    zIndex: 10,
+                    border: '2px dashed var(--color-semantic-destructive-300)',
+                    borderRadius: 'var(--border-radius-small)',
+                    padding: 'var(--spacing-xsmall)',
+                    minHeight: '2rem',
+                }, "aria-label": "Custom popup container" }), _jsx(PopupParentContext.Provider, { value: popupContainerRef, children: _jsxs(Dropdown, { children: [_jsx(Dropdown.Trigger, { children: _jsx(Button, { variant: "dropdown", children: "Actions" }) }), _jsxs(Dropdown.Content, { children: [_jsx(Dropdown.Item, { children: "View pupil profile" }), _jsx(Dropdown.Item, { children: "Edit enrolment" }), _jsx(Dropdown.Separator, {}), _jsx(Dropdown.Item, { children: "Remove from group" })] })] }) })] }));
+};
+// ---------------------------------------------------------------------------
+// Stories
+// ---------------------------------------------------------------------------
+export const Default = withDescription({
+    render: DefaultTemplate,
+    parameters: {
+        controls: { disable: true },
+        docs: {
+            source: {
+                language: 'tsx',
+                code: `
+import { Dropdown, Button } from '@arbor-education/design-system.components';
+
+// No PopupParentContext setup needed — the dropdown portals to document.body automatically.
+function PupilActionsDropdown() {
+  return (
+    <Dropdown>
+      <Dropdown.Trigger>
+        <Button variant="dropdown">Actions</Button>
+      </Dropdown.Trigger>
+      <Dropdown.Content>
+        <Dropdown.Item>View pupil profile</Dropdown.Item>
+        <Dropdown.Item>Edit enrolment</Dropdown.Item>
+        <Dropdown.Separator />
+        <Dropdown.Item>Remove from group</Dropdown.Item>
+      </Dropdown.Content>
+    </Dropdown>
+  );
+}
+export default PupilActionsDropdown;
+`.trim(),
+            },
+        },
+    },
+}, [
+    'The default behaviour — no `PopupParentContext` setup required.',
+    'The dropdown portals its content to `div#ds-popup-parent` in `document.body` via the context default.',
+    'Even inside an `overflow: hidden` container, the popup appears correctly because it exits the clip',
+    'boundary by rendering in the body.',
+].join(' '));
+export const WithCustomContainer = withDescription({
+    render: WithCustomContainerTemplate,
+    parameters: {
+        controls: { disable: true },
+        docs: {
+            source: {
+                language: 'tsx',
+                code: `
+import { useRef } from 'react';
+import { PopupParentContext, Dropdown, Button } from '@arbor-education/design-system.components';
+
+function ClippedPanel() {
+  const popupContainerRef = useRef<HTMLDivElement>(null);
+
+  return (
+    <div style={{ position: 'relative' }}>
+      {/*
+        This container receives portalled popups.
+        Place it outside any overflow:hidden ancestor,
+        with a z-index high enough to appear above surrounding content.
+      */}
+      <div ref={popupContainerRef} style={{ position: 'fixed', zIndex: 100 }} />
+
+      <PopupParentContext.Provider value={popupContainerRef}>
+        <Dropdown>
+          <Dropdown.Trigger>
+            <Button variant="dropdown">Actions</Button>
+          </Dropdown.Trigger>
+          <Dropdown.Content>
+            <Dropdown.Item>View pupil profile</Dropdown.Item>
+            <Dropdown.Item>Edit enrolment</Dropdown.Item>
+            <Dropdown.Separator />
+            <Dropdown.Item>Remove from group</Dropdown.Item>
+          </Dropdown.Content>
+        </Dropdown>
+      </PopupParentContext.Provider>
+    </div>
+  );
+}
+export default ClippedPanel;
+`.trim(),
+            },
+        },
+    },
+}, [
+    'Override the popup container with `PopupParentContext.Provider`. The `value` prop accepts a',
+    '`RefObject<HTMLElement | null>` pointing to the element that should receive portalled content.',
+    'Open the dropdown to see it appear inside the dashed container (highlighted in pink) instead of',
+    '`document.body`. In production you would omit the visual indicator and size/position the container',
+    'as needed for your layout.',
+].join(' '));
+//# sourceMappingURL=PopupParentContext.stories.js.map

package/dist/utils/PopupParentContext.stories.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"PopupParentContext.stories.js","sourceRoot":"","sources":["../../src/utils/PopupParentContext.stories.tsx"],"names":[],"mappings":"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"}

package/dist/utils/getDefaultPopupParent.d.ts

@@ -0,0 +1,2 @@
+export declare const getDefaultPopupParent: () => HTMLElement;
+//# sourceMappingURL=getDefaultPopupParent.d.ts.map

package/dist/utils/getDefaultPopupParent.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"getDefaultPopupParent.d.ts","sourceRoot":"","sources":["../../src/utils/getDefaultPopupParent.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,qBAAqB,mBAmBjC,CAAC"}

package/dist/utils/getDefaultPopupParent.js

@@ -0,0 +1,19 @@
+export const getDefaultPopupParent = () => {
+    const element = document.getElementById('ds-popup-parent');
+    if (element) {
+        return element;
+    }
+    const newContainer = document.createElement('div');
+    newContainer.id = 'ds-popup-parent';
+    newContainer.style.zIndex = '1';
+    newContainer.style.position = 'fixed';
+    // ag grid has clamping behaviour for floating elements - it clamps the area
+    // to whichever has the largest boundingRect between its own main container
+    // and whatever is passed to the popupParent prop. without this inset here
+    // the container ends up with a height and width of zero so they get clamped
+    // to the ag container instead of the viewport (most heinous).
+    newContainer.style.inset = '0';
+    document.body.appendChild(newContainer);
+    return newContainer;
+};
+//# sourceMappingURL=getDefaultPopupParent.js.map

package/dist/utils/getDefaultPopupParent.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"getDefaultPopupParent.js","sourceRoot":"","sources":["../../src/utils/getDefaultPopupParent.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,qBAAqB,GAAG,GAAG,EAAE;IACxC,MAAM,OAAO,GAAG,QAAQ,CAAC,cAAc,CAAC,iBAAiB,CAAC,CAAC;IAC3D,IAAI,OAAO,EAAE,CAAC;QACZ,OAAO,OAAO,CAAC;IACjB,CAAC;IAED,MAAM,YAAY,GAAG,QAAQ,CAAC,aAAa,CAAC,KAAK,CAAC,CAAC;IACnD,YAAY,CAAC,EAAE,GAAG,iBAAiB,CAAC;IACpC,YAAY,CAAC,KAAK,CAAC,MAAM,GAAG,GAAG,CAAC;IAChC,YAAY,CAAC,KAAK,CAAC,QAAQ,GAAG,OAAO,CAAC;IACtC,4EAA4E;IAC5E,2EAA2E;IAC3E,0EAA0E;IAC1E,4EAA4E;IAC5E,8DAA8D;IAC9D,YAAY,CAAC,KAAK,CAAC,KAAK,GAAG,GAAG,CAAC;IAC/B,QAAQ,CAAC,IAAI,CAAC,WAAW,CAAC,YAAY,CAAC,CAAC;IAExC,OAAO,YAA2B,CAAC;AACrC,CAAC,CAAC"}

package/dist/utils/hooks/useIsMounted.d.ts

@@ -1,2 +1,2 @@
-export declare const useIsMounted: () => import("react").MutableRefObject<boolean>;
+export declare const useIsMounted: () => import("react").RefObject<boolean>;
 //# sourceMappingURL=useIsMounted.d.ts.map

package/dist/utils/hooks/useIsMounted.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"useIsMounted.d.ts","sourceRoot":"","sources":["../../../src/utils/hooks/useIsMounted.ts"],"names":[],"mappings":"AAGA,eAAO,MAAM,YAAY,iDAQxB,CAAC"}
+{"version":3,"file":"useIsMounted.d.ts","sourceRoot":"","sources":["../../../src/utils/hooks/useIsMounted.ts"],"names":[],"mappings":"AAGA,eAAO,MAAM,YAAY,0CAQxB,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@arbor-education/design-system.components",
-  "version": "3.4.5",
+  "version": "4.0.0-react19-alpha.0",
   "description": "The component library for the design system (the baby)",
   "main": "dist/index.js",
   "type": "module",
@@ -12,8 +12,6 @@
   "license": "MIT",
   "dependencies": {
     "@react-hook/resize-observer": "^2.0.2",
-    "@types/react": "^18.2.0",
-    "@types/react-dom": "^18.2.0",
     "@uiw/react-color": "2.8.0",
     "ag-grid-community": "^34.3.1",
     "ag-grid-enterprise": "^34.3.1",
@@ -24,12 +22,24 @@
     "decimal.js": "^10.6.0",
     "lucide-react": "^0.544.0",
     "radix-ui": "1.4.3",
-    "react": "^18.2.0",
     "react-day-picker": "^9.14.0",
-    "react-dom": "^18.2.0",
     "react-dropzone": "^15.0.0",
     "typescript": "^5.9.2"
   },
+  "peerDependencies": {
+    "@types/react": "*",
+    "@types/react-dom": "*",
+    "react": "^18.0.0 || ^19.0.0",
+    "react-dom": "^18.0.0 || ^19.0.0"
+  },
+  "peerDependenciesMeta": {
+    "@types/react": {
+      "optional": true
+    },
+    "@types/react-dom": {
+      "optional": true
+    }
+  },
   "devDependencies": {
     "@changesets/changelog-github": "^0.5.2",
     "@changesets/cli": "^2.29.8",
@@ -45,6 +55,8 @@
     "@testing-library/react": "^16.3.0",
     "@testing-library/user-event": "^14.6.1",
     "@types/node": "^24.7.0",
+    "@types/react": "^19.0.0",
+    "@types/react-dom": "^19.0.0",
     "@vitejs/plugin-react": "^5.0.1",
     "@vitest/browser": "3.2.4",
     "@vitest/coverage-v8": "3.2.4",
@@ -60,6 +72,8 @@
     "jsdom": "^26.1.0",
     "lint-staged": "^16.2.3",
     "playwright": "^1.55.0",
+    "react": "^19.0.0",
+    "react-dom": "^19.0.0",
     "sass": "^1.104.1",
     "storybook": "^10.4.6",
     "storybook-addon-deep-controls": "^0.10.0",

package/src/components/arborLogo/__snapshots__/ArborLogo.test.tsx.snap

@@ -2,7 +2,7 @@
 
 exports[`ArborLogo > renders the icon-only variant 1`] = `
 <svg
-  aria-labelledby=":r1:"
+  aria-labelledby="_r_1_"
   fill="none"
   height="25"
   role="img"
@@ -11,12 +11,12 @@ exports[`ArborLogo > renders the icon-only variant 1`] = `
   xmlns="http://www.w3.org/2000/svg"
 >
   <title
-    id=":r1:"
+    id="_r_1_"
   >
     Arbor
   </title>
   <g
-    clip-path="url(#:r0:)"
+    clip-path="url(#_r_0_)"
   >
     <path
       d="M12.6821 12.448C12.6821 9.06699 15.4229 6.32623 18.8039 6.32623C18.8039 2.94571 16.0631 0.205391 12.6817 0.205391C9.30163 0.205391 6.56086 2.94571 6.56042 6.32623C9.94138 6.32623 12.6817 9.06699 12.6821 12.448Z"
@@ -53,7 +53,7 @@ exports[`ArborLogo > renders the icon-only variant 1`] = `
   </g>
   <defs>
     <clippath
-      id=":r0:"
+      id="_r_0_"
     >
       <rect
         fill="white"
@@ -67,7 +67,7 @@ exports[`ArborLogo > renders the icon-only variant 1`] = `
 
 exports[`ArborLogo > renders the icon-only variant with a custom aria-label 1`] = `
 <svg
-  aria-labelledby=":r5:"
+  aria-labelledby="_r_5_"
   fill="none"
   height="25"
   role="img"
@@ -76,12 +76,12 @@ exports[`ArborLogo > renders the icon-only variant with a custom aria-label 1`]
   xmlns="http://www.w3.org/2000/svg"
 >
   <title
-    id=":r5:"
+    id="_r_5_"
   >
     Arbor Education logo
   </title>
   <g
-    clip-path="url(#:r4:)"
+    clip-path="url(#_r_4_)"
   >
     <path
       d="M12.6821 12.448C12.6821 9.06699 15.4229 6.32623 18.8039 6.32623C18.8039 2.94571 16.0631 0.205391 12.6817 0.205391C9.30163 0.205391 6.56086 2.94571 6.56042 6.32623C9.94138 6.32623 12.6817 9.06699 12.6821 12.448Z"
@@ -118,7 +118,7 @@ exports[`ArborLogo > renders the icon-only variant with a custom aria-label 1`]
   </g>
   <defs>
     <clippath
-      id=":r4:"
+      id="_r_4_"
     >
       <rect
         fill="white"
@@ -140,7 +140,7 @@ exports[`ArborLogo > renders the icon-only variant with aria-hidden 1`] = `
   xmlns="http://www.w3.org/2000/svg"
 >
   <g
-    clip-path="url(#:r2:)"
+    clip-path="url(#_r_2_)"
   >
     <path
       d="M12.6821 12.448C12.6821 9.06699 15.4229 6.32623 18.8039 6.32623C18.8039 2.94571 16.0631 0.205391 12.6817 0.205391C9.30163 0.205391 6.56086 2.94571 6.56042 6.32623C9.94138 6.32623 12.6817 9.06699 12.6821 12.448Z"
@@ -177,7 +177,7 @@ exports[`ArborLogo > renders the icon-only variant with aria-hidden 1`] = `
   </g>
   <defs>
     <clippath
-      id=":r2:"
+      id="_r_2_"
     >
       <rect
         fill="white"
@@ -199,7 +199,7 @@ exports[`ArborLogo > renders the text variant with aria-hidden 1`] = `
   xmlns="http://www.w3.org/2000/svg"
 >
   <g
-    clip-path="url(#:ra:)"
+    clip-path="url(#_r_a_)"
   >
     <path
       d="M12.6822 12.4479C12.6822 9.06698 15.423 6.32622 18.8039 6.32622C18.8039 2.9457 16.0632 0.205383 12.6818 0.205383C9.30169 0.205383 6.56093 2.9457 6.56049 6.32622C9.94145 6.32622 12.6818 9.06698 12.6822 12.4479Z"
@@ -256,7 +256,7 @@ exports[`ArborLogo > renders the text variant with aria-hidden 1`] = `
   </g>
   <defs>
     <clippath
-      id=":ra:"
+      id="_r_a_"
     >
       <rect
         fill="white"
@@ -270,7 +270,7 @@ exports[`ArborLogo > renders the text variant with aria-hidden 1`] = `
 
 exports[`ArborLogo > renders the text variant with black text 1`] = `
 <svg
-  aria-labelledby=":r7:"
+  aria-labelledby="_r_7_"
   fill="none"
   height="26"
   role="img"
@@ -279,12 +279,12 @@ exports[`ArborLogo > renders the text variant with black text 1`] = `
   xmlns="http://www.w3.org/2000/svg"
 >
   <title
-    id=":r7:"
+    id="_r_7_"
   >
     Arbor
   </title>
   <g
-    clip-path="url(#:r6:)"
+    clip-path="url(#_r_6_)"
   >
     <path
       d="M12.6822 12.4479C12.6822 9.06698 15.423 6.32622 18.8039 6.32622C18.8039 2.9457 16.0632 0.205383 12.6818 0.205383C9.30169 0.205383 6.56093 2.9457 6.56049 6.32622C9.94145 6.32622 12.6818 9.06698 12.6822 12.4479Z"
@@ -341,7 +341,7 @@ exports[`ArborLogo > renders the text variant with black text 1`] = `
   </g>
   <defs>
     <clippath
-      id=":r6:"
+      id="_r_6_"
     >
       <rect
         fill="white"
@@ -355,7 +355,7 @@ exports[`ArborLogo > renders the text variant with black text 1`] = `
 
 exports[`ArborLogo > renders the text variant with white text 1`] = `
 <svg
-  aria-labelledby=":r9:"
+  aria-labelledby="_r_9_"
   fill="none"
   height="26"
   role="img"
@@ -364,7 +364,7 @@ exports[`ArborLogo > renders the text variant with white text 1`] = `
   xmlns="http://www.w3.org/2000/svg"
 >
   <title
-    id=":r9:"
+    id="_r_9_"
   >
     Arbor
   </title>

package/src/components/combobox/ComboboxButtonTrigger.tsx

@@ -11,7 +11,7 @@ import type { ComboboxAriaInvalid, ComboboxOption, ComboboxSelectedValueDisplay
 import { useVisibleTriggerTags } from './useVisibleTriggerTags.js';
 
 export type ComboboxButtonTriggerProps = {
-  triggerRef: React.RefObject<HTMLDivElement>;
+  triggerRef: React.RefObject<HTMLDivElement | null>;
   listboxId: string;
   isOpen: boolean;
   hasError: boolean;

package/src/components/combobox/ComboboxListbox.tsx

@@ -4,7 +4,7 @@ import { ComboboxOptionRow } from './ComboboxOptionRow.js';
 import type { ComboboxAriaInvalid, ComboboxOption, ComboboxSearchType } from './types.js';
 
 export type ComboboxListboxProps = {
-  listboxRef: React.RefObject<HTMLUListElement>;
+  listboxRef: React.RefObject<HTMLUListElement | null>;
   listboxId: string;
   multiple: boolean;
   ariaLabel: string | undefined;
@@ -27,7 +27,7 @@ export type ComboboxListboxProps = {
   filteredOptionsLength: number;
   preventMouseDefault: (e: React.MouseEvent) => void;
   renderSearchInputInListbox: boolean;
-  inputRef: React.RefObject<HTMLInputElement>;
+  inputRef: React.RefObject<HTMLInputElement | null>;
   comboboxId: string;
   shouldShowPopover: boolean;
   activeDescendant: string | undefined;

package/src/components/combobox/ComboboxTrigger.tsx

@@ -5,8 +5,8 @@ import { Popover } from 'radix-ui';
 import type { ComboboxAriaInvalid, ComboboxOption, ComboboxSelectedValueDisplay } from './types.js';
 
 export type ComboboxTriggerProps = {
-  'inputRef': React.RefObject<HTMLInputElement>;
-  'triggerRef': React.RefObject<HTMLDivElement>;
+  'inputRef': React.RefObject<HTMLInputElement | null>;
+  'triggerRef': React.RefObject<HTMLDivElement | null>;
   'comboboxId': string;
   'listboxId': string;
   'isOpen': boolean;

package/src/components/combobox/useComboboxListboxDom.ts

@@ -6,7 +6,7 @@ type UseComboboxListboxDomParams = {
 };
 
 export type UseComboboxListboxDomReturn = {
-  listboxRef: React.RefObject<HTMLUListElement>;
+  listboxRef: React.RefObject<HTMLUListElement | null>;
   getOptionId: (index: number) => string;
   scrollHighlightedIntoView: (index: number) => void;
 };