docs(organisation unit tree): add story for custom request data

components/organisation-unit-tree/src/__stories__/collapsed.js

@@ -0,0 +1,9 @@
+import React from 'react'
+import { OrganisationUnitTree } from '../index.js'
+
+export const Collapsed = () => (
+    <OrganisationUnitTree
+        name="Root org unit"
+        roots={['A0000000000']}
+    />
+)

components/organisation-unit-tree/src/__stories__/custom-node-label.js

@@ -0,0 +1,23 @@
+import React from 'react'
+import { OrganisationUnitTree } from '../index.js'
+
+export const CustomNodeLabel = () => (
+    <OrganisationUnitTree
+        name="Root org unit"
+        roots="A0000000000"
+        initiallyExpanded={['/A0000000000/A0000000001']}
+        renderNodeLabel={data => {
+            if (data.node.path !== '/A0000000000/A0000000001') {
+                return OrganisationUnitTree.defaultProps.renderNodeLabel(data)
+            }
+
+            return OrganisationUnitTree.defaultProps.renderNodeLabel({
+                ...data,
+                node: {
+                    ...data.node,
+                    displayName: <span>--- {data.node.displayName}</span>,
+                },
+            })
+        }}
+    />
+)

components/organisation-unit-tree/src/__stories__/custom-requests.js

@@ -0,0 +1,107 @@
+/* eslint-disable react/no-unescaped-entities */
+import { CustomDataProvider, useDataEngine } from '@dhis2/app-runtime'
+import React from 'react'
+import {
+    OrganisationUnitTreeControllable,
+    useFetchOrgData,
+    useFetchRootOrgData,
+} from '../index.js'
+import { customData } from './customData.js'
+
+const customDataWithApprovals = {
+    ...customData,
+    'dataApprovals/approvals': (type, { params }) => {
+        return [
+            {
+                wf: params.wf,
+                pe: params.pe,
+                ou: params.ou,
+                aoc: "aocUID",
+                state: "ACCEPTED_HERE",
+                level: "KaTJLhGmU95",
+                permissions: {
+                    mayApprove: true,
+                    mayUnapprove: true,
+                    mayAccept: false,
+                    mayUnaccept: true,
+                    mayReadData: true
+                }
+            }
+        ]
+    },
+}
+
+export const CustomRequests = () => {
+    const engine = useDataEngine()
+    const fetchOrgData = useFetchOrgData()
+    const fetchRootOrgData = useFetchRootOrgData()
+
+    const fetchOrgDataWithApprovalStatus = async args => {
+        const { id } = args
+
+        const [approvalStatusResponse, origResponse] = await Promise.all([
+            await engine.query({
+                approvalStatuses: {
+                    resource: 'dataApprovals/approvals',
+                    params: {
+                        wf: 'rIUL4hYOjJc',
+                        pe: '202101',
+                        ou: id,
+                    }
+                }
+            }),
+            await fetchOrgData(args),
+        ])
+
+        const nextData = { ...approvalStatusResponse, ...origResponse }
+        return nextData
+    }
+
+    return (
+        <OrganisationUnitTreeControllable
+            fetchOrgData={fetchOrgDataWithApprovalStatus}
+            fetchRootOrgData={fetchRootOrgData}
+            name="Root org unit"
+            roots={['A0000000000']}
+            initiallyExpanded={['/A0000000000/A0000000001']}
+            renderNodeLabel={data => {
+                if (data.loading) {
+                    return OrganisationUnitTreeControllable
+                        .defaultProps
+                        .renderNodeLabel(data)
+                }
+
+                const { approvalStatuses } = data.additional
+                const [approvalStatus] = approvalStatuses
+                const { permissions } = approvalStatus
+                const { mayApprove } = permissions
+
+                const formatted = {
+                    ...data,
+                    node: {
+                        ...data.node,
+                        displayName: (
+                            <span>
+                                {data.node.displayName}
+                                {' '}
+                                (mayApprove: {' '}{mayApprove.toString()})
+                            </span>
+                        )
+                    }
+                }
+
+                return OrganisationUnitTreeControllable
+                    .defaultProps
+                    .renderNodeLabel(formatted)
+            }}
+        />
+    )
+}
+
+CustomRequests.decorators = [
+    Story => (
+        <CustomDataProvider data={customDataWithApprovals}>
+            <Story />
+        </CustomDataProvider>
+    ),
+]

components/organisation-unit-tree/src/__stories__/customData.js

@@ -0,0 +1,107 @@
+export const customData = {
+    organisationUnits: (...args) => {
+        const [, { id }] = args
+
+        let data,
+            delay = 0
+
+        if (id === 'A0000000000') {
+            delay = 1000
+            data = {
+                id: 'A0000000000',
+                path: '/A0000000000',
+                displayName: 'Org Unit 1',
+                children: [
+                    {
+                        id: 'A0000000001',
+                        path: '/A0000000000/A0000000001',
+                        children: [
+                            { id: 'A0000000003' },
+                            { id: 'A0000000004' },
+                        ],
+                        displayName: 'Org Unit 2',
+                    },
+                    {
+                        id: 'A0000000002',
+                        path: '/A0000000000/A0000000002',
+                        children: [],
+                        displayName: 'Org Unit 3',
+                    },
+                    {
+                        id: 'A0000000006',
+                        path: '/A0000000000/A0000000006',
+                        children: [],
+                        displayName: 'Org Unit 7',
+                    },
+                ],
+            }
+        }
+
+        if (id === 'A0000000001') {
+            data = {
+                id: 'A0000000001',
+                path: '/A0000000000/A0000000001',
+                displayName: 'Org Unit 2',
+                children: [
+                    {
+                        id: 'A0000000003',
+                        path: '/A0000000000/A0000000001/A0000000003',
+                        children: [],
+                        displayName: 'Org Unit 4',
+                    },
+                    {
+                        id: 'A0000000004',
+                        path: '/A0000000000/A0000000001/A0000000004',
+                        children: [],
+                        displayName: 'Org Unit 5',
+                    },
+                ],
+            }
+        }
+
+        if (id === 'A0000000002') {
+            delay = 1000
+            data = {
+                displayName: 'Org Unit 3',
+                id: 'A0000000002',
+                path: '/A0000000000/A0000000002',
+                children: [],
+            }
+        }
+
+        if (id === 'A0000000003') {
+            data = {
+                displayName: 'Org Unit 4',
+                id: 'A0000000003',
+                path: '/A0000000000/A0000000001/A0000000003',
+                children: [],
+            }
+        }
+
+        if (id === 'A0000000004') {
+            data = {
+                displayName: 'Org Unit 5',
+                id: 'A0000000004',
+                path: '/A0000000000/A0000000001/A0000000004',
+                children: [],
+            }
+        }
+
+        if (id === 'A0000000006') {
+            data = {
+                displayName: 'Org Unit 7',
+                id: 'A0000000006',
+                path: '/A0000000000/A0000000006',
+                children: [],
+            }
+        }
+
+        if (!data) {
+            return Promise.reject(new Error('404 - Org unit not found'))
+        }
+
+        return new Promise(resolve => {
+            setTimeout(() => resolve(data), delay)
+        })
+    },
+}

components/organisation-unit-tree/src/__stories__/dx-multi-selection.js

@@ -0,0 +1,5 @@
+import React from 'react'
+import { Wrapper } from './dx-wrapper.js'
+
+export const DxMultiSelection = () => <Wrapper />
+DxMultiSelection.storyName = 'DX: Multi selection'

components/organisation-unit-tree/src/__stories__/dx-no-selection.js

@@ -0,0 +1,5 @@
+import React from 'react'
+import { Wrapper } from './dx-wrapper.js'
+
+export const DxNoSelection = () => <Wrapper disableSelection />
+DxNoSelection.storyName = 'DX: No selection'

components/organisation-unit-tree/src/__stories__/dx-single-selection.js

@@ -0,0 +1,5 @@
+import React from 'react'
+import { Wrapper } from './dx-wrapper.js'
+
+export const DxSingleSelection = () => <Wrapper singleSelection />
+DxSingleSelection.storyName = 'DX: Single selection'

components/organisation-unit-tree/src/__stories__/dx-with-real-backend.js

@@ -0,0 +1,42 @@
+import { DataProvider } from '@dhis2/app-runtime'
+import React from 'react'
+import { Wrapper } from './dx-wrapper.js'
+
+export const DxWithRealBackend = () => (
+    <div>
+        <div style={{ marginBottom: 20, lineHeight: '28px' }}>
+            <b>
+                This story doesn&apos;t work on netlify for some reason, just
+                run it locally.
+            </b>
+            <br />
+            You need to log in to{' '}
+            <a
+                href="https://debug.dhis2.org/dev"
+                target="_blank"
+                rel="noopener noreferrer"
+            >
+                https://debug.dhis2.org/dev
+            </a>
+            <br />
+            Make sure the{' '}
+            <code style={{ background: '#ccc' }}>localhost:[PORT]</code> is part
+            of the accepted list:{' '}
+            <a
+                href="https://debug.dhis2.org/dev/dhis-web-settings/#/access"
+                target="_blank"
+                rel="noopener noreferrer"
+            >
+                Settings app / Access
+            </a>
+        </div>
+        <DataProvider baseUrl="https://debug.dhis2.org/dev" apiVersion="">
+            <Wrapper
+                //initiallyExpanded={['/ImspTQPwCqd/eIQbndfxQMb']}
+                suppressAlphabeticalSorting
+                roots="ImspTQPwCqd"
+            />
+        </DataProvider>
+    </div>
+)
+DxWithRealBackend.storyName = 'DX: With real backend'

components/organisation-unit-tree/src/__stories__/dx-wrapper.js

@@ -0,0 +1,40 @@
+/* eslint-disable react/no-unescaped-entities,react/prop-types */
+import React, { useState } from 'react'
+import { OrganisationUnitTree } from '../index.js'
+
+const DX_onChange = (selected, setSelected, singleSelection) => ({
+    id,
+    path,
+    checked,
+}) => {
+    console.log('onChange', { path, id, checked })
+    const pathIndex = selected.indexOf(path)
+
+    if (checked) {
+        setSelected(singleSelection ? [path] : [...selected, path])
+    } else {
+        setSelected(
+            singleSelection
+                ? []
+                : [
+                      ...selected.slice(0, pathIndex),
+                      ...selected.slice(pathIndex + 1),
+                  ]
+        )
+    }
+}
+
+export const Wrapper = props => {
+    const [selected, setSelected] = useState([])
+
+    return (
+        <OrganisationUnitTree
+            name="Root org unit"
+            roots={['A0000000000']}
+            selected={selected}
+            onChange={DX_onChange(selected, setSelected, props.singleSelection)}
+            initiallyExpanded={['A0000000001/A0000000002']}
+            {...props}
+        />
+    )
+}

components/organisation-unit-tree/src/__stories__/expanded.js

@@ -0,0 +1,10 @@
+import React from 'react'
+import { OrganisationUnitTree } from '../index.js'
+
+export const Expanded = () => (
+    <OrganisationUnitTree
+        name="Root org unit"
+        roots={['A0000000000']}
+        initiallyExpanded={['/A0000000000/A0000000001']}
+    />
+)

components/organisation-unit-tree/src/__stories__/filtered-root.js

@@ -0,0 +1,13 @@
+import React from 'react'
+import { OrganisationUnitTree } from '../index.js'
+
+export const FilteredRoot = () => (
+    <OrganisationUnitTree
+        name="Root org unit"
+        roots={['A0000000000', 'A0000000001']}
+        initiallyExpanded={['/A0000000000/A0000000001']}
+        filter={['/A0000000000']}
+    />
+)
+
+FilteredRoot.storyName = 'Filtered (root)'

components/organisation-unit-tree/src/__stories__/filtered.js

@@ -0,0 +1,11 @@
+import React from 'react'
+import { OrganisationUnitTree } from '../index.js'
+
+export const Filtered = () => (
+    <OrganisationUnitTree
+        name="Root org unit"
+        roots={['A0000000000']}
+        initiallyExpanded={['/A0000000000/A0000000001']}
+        filter={['/A0000000000/A0000000001']}
+    />
+)