@arbor-education/design-system.components 0.15.0 → 0.16.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';
+import { Button } from '../components/button/Button';
+import { Dropdown } from '../components/dropdown/Dropdown';
+// ---------------------------------------------------------------------------
+// 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.map

@@ -1 +1 @@
-{"version":3,"file":"getDefaultPopupParent.d.ts","sourceRoot":"","sources":["../../src/utils/getDefaultPopupParent.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,qBAAqB,mBAajC,CAAC"}
+{"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

@@ -7,6 +7,12 @@ export const getDefaultPopupParent = () => {
     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;
 };

package/dist/utils/getDefaultPopupParent.js.map

@@ -1 +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,QAAQ,CAAC,IAAI,CAAC,WAAW,CAAC,YAAY,CAAC,CAAC;IAExC,OAAO,YAA2B,CAAC;AACrC,CAAC,CAAC"}
+{"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/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@arbor-education/design-system.components",
-  "version": "0.15.0",
+  "version": "0.16.0",
   "description": "The component library for the design system (the baby)",
   "main": "dist/index.js",
   "repository": {