@riboseinc/paneron-registry-kit 2.0.0-dev9 → 2.0.1

package/compiled/views/change-request/Proposals.js

@@ -0,0 +1,185 @@
+/** @jsx jsx */
+/** @jsxFrag React.Fragment */
+import React, { useContext, useEffect, useState } from 'react';
+import { jsx, css } from '@emotion/react';
+import styled from '@emotion/styled';
+import { ControlGroup, ButtonGroup, Switch, Button, Classes, MenuItem, NonIdealState, } from '@blueprintjs/core';
+import { Select2 as Select } from '@blueprintjs/select';
+import HelpTooltip from '@riboseinc/paneron-extension-kit/widgets/HelpTooltip';
+import { Protocols } from '../protocolRegistry';
+import { BrowserCtx } from '../BrowserCtx';
+import { itemPathToItemRef, itemRefToItemPath } from '../itemPathUtils';
+import StructuredDiff from '../diffing/StructuredDiff';
+import registerItemDetailView from '../detail/RegisterItem';
+const Proposals = function ({ proposals, className }) {
+    const [_selectedProposal, selectProposal] = useState(null);
+    const [showDiff, setShowDiff] = useState(false);
+    const [showOnlyChanged, setShowOnlyChanged] = useState(true);
+    const outerBrowserCtx = useContext(BrowserCtx);
+    const { jumpTo, subregisters, useRegisterItemData } = outerBrowserCtx;
+    const proposalBrowserCtx = {
+        ...outerBrowserCtx,
+        jumpTo: handleCRJump,
+    };
+    /**
+     * When jumping to an item affected by current CR,
+     * jump in-CR instead of spawning tab.
+     */
+    function handleCRJump(uri) {
+        if (uri.startsWith(Protocols.ITEM_DETAILS)) {
+            const itemPath = uri.split(':')[1];
+            if (proposals[itemPath]) {
+                selectProposal(itemPath);
+            }
+            else {
+                jumpTo?.(uri);
+            }
+        }
+    }
+    const firstProposal = Object.keys(proposals)[0];
+    // Effective selected proposal
+    const selectedProposal = ((_selectedProposal && proposals[_selectedProposal]) ? _selectedProposal : null)
+        ?? firstProposal
+        ?? undefined;
+    // Force select available proposal
+    useEffect(() => {
+        if (firstProposal && (_selectedProposal === null || !proposals[_selectedProposal])) {
+            selectProposal(firstProposal);
+        }
+    }, [firstProposal, _selectedProposal, JSON.stringify(proposals)]);
+    const selectedItemRef = selectedProposal
+        ? itemPathToItemRef(subregisters !== undefined, selectedProposal)
+        : null;
+    // Data for proposed items
+    const proposedItemPaths = Object.entries(proposals).map(([itemPath, proposal]) => {
+        if (proposal.type === 'clarification' || proposal.type === 'addition') {
+            return itemPath;
+        }
+        else {
+            return undefined;
+        }
+    }).filter(s => s !== undefined);
+    const proposedItemDataReq = useRegisterItemData({
+        itemPaths: proposedItemPaths,
+    });
+    // Data for pre-existing items
+    const currentItemDataReq = useRegisterItemData({
+        itemPaths: Object.keys(proposals),
+        ignoreActiveCR: true,
+    });
+    const getCurrentItemData = (itemPath) => currentItemDataReq.value[itemPath]?.data ?? null;
+    const getProposedItemData = (itemPath) => proposedItemDataReq.value[itemPath]?.data ?? null;
+    const selectedItemCurrentData = getCurrentItemData(selectedProposal);
+    const selectedItemProposedData = getProposedItemData(selectedProposal);
+    if (selectedProposal
+        && selectedItemRef
+        && proposals[selectedProposal]
+        && !currentItemDataReq.isUpdating
+        && !proposedItemDataReq.isUpdating) {
+        if (selectedItemCurrentData || selectedItemProposedData) {
+            const selectedItemSummary = jsx(ProposalSummary, { itemRef: selectedItemRef, itemData: (selectedItemProposedData ?? selectedItemCurrentData), itemDataBefore: selectedItemCurrentData ?? undefined, proposal: proposals[selectedProposal] });
+            return (jsx("div", { css: css `display: flex; flex-flow: column nowrap;`, className: className },
+                jsx("div", null,
+                    jsx(ControlGroup, null,
+                        jsx(Switch, { checked: showDiff, onChange: evt => setShowDiff(evt.currentTarget.checked), label: "View source", css: css `margin-right: 1em !important` }),
+                        jsx(Switch, { checked: showDiff && showOnlyChanged, disabled: !showDiff, onChange: evt => setShowOnlyChanged(evt.currentTarget.checked), label: "Show clarified properties only" })),
+                    jsx(ButtonGroup, null,
+                        jsx(Button, { disabled: !jumpTo || proposals[selectedProposal]?.type === 'addition', icon: 'locate', onClick: () => jumpTo?.(`${Protocols.ITEM_DETAILS}:${selectedProposal}`), title: "Open selected item in a new tab (not applicable to proposed additions)" }, "Reveal in registry"),
+                        Object.keys(proposals).length > 1
+                            ? jsx(Select, { filterable: false, itemsEqual: (i1, i2) => JSON.stringify(i1) === JSON.stringify(i2), activeItem: {
+                                    itemPath: selectedProposal,
+                                    proposal: proposals[selectedProposal],
+                                    itemData: (selectedItemProposedData ?? selectedItemCurrentData),
+                                    itemDataBefore: selectedItemCurrentData ?? undefined,
+                                    itemRef: itemPathToItemRef(subregisters !== undefined, selectedProposal),
+                                }, items: Object.entries(proposals).map(([itemPath, proposal]) => ({
+                                    itemPath,
+                                    proposal,
+                                    itemData: (getProposedItemData(itemPath) ?? getCurrentItemData(itemPath)) ?? null,
+                                    itemDataBefore: undefined,
+                                    itemRef: itemPathToItemRef(subregisters !== undefined, itemPath),
+                                })).filter(item => item.itemData !== null), popoverProps: { minimal: true }, fill: true, itemRenderer: ChangeProposalItemView, onItemSelect: (item) => selectProposal(item.itemPath) },
+                                jsx(Button, { rightIcon: "chevron-down", icon: getProposalIcon(proposals[selectedProposal]) }, selectedItemSummary))
+                            : jsx(Button, { fill: true, alignText: "left", icon: getProposalIcon(proposals[selectedProposal]), rightIcon: "chevron-down" }, selectedItemSummary))),
+                jsx("div", { css: css `position: relative; flex: 1;` },
+                    jsx(BrowserCtx.Provider, { value: proposalBrowserCtx },
+                        jsx(ProposalDetail, { itemRef: selectedItemRef, showDiff: showDiff, showOnlyChanged: showOnlyChanged, itemData: (selectedItemProposedData ?? selectedItemCurrentData), itemDataBefore: selectedItemCurrentData ?? undefined, proposal: proposals[selectedProposal] })))));
+        }
+        else {
+            return jsx(NonIdealState, { icon: 'warning-sign', className: className, title: "Unable to retrieve proposed item data", description: jsx("div", { css: css `text-align: left;` },
+                    "There appears to be a data integrity issue.",
+                    jsx("br", null),
+                    "This might be caused by a problem in the application, or repository contents having been edited outside of the application.",
+                    jsx("br", null),
+                    "The data should be recoverable by inspecting version control system commit history.") });
+        }
+    }
+    else {
+        return jsx(NonIdealState, { icon: 'clean', className: className, title: "Nothing is proposed here yet." });
+    }
+};
+const ChangeProposalItemView = (item, { handleClick, modifiers, query }) => {
+    const proposalConfig = item.proposal.type === 'amendment'
+        ? PROPOSAL_VIEWS[item.proposal.amendmentType]
+        : PROPOSAL_VIEWS[item.proposal.type];
+    const ProposalTypeLabel = proposalConfig.summary;
+    return (jsx(MenuItem, { active: modifiers.active, disabled: modifiers.disabled, labelElement: jsx(React.Fragment, null,
+            jsx(ProposalTypeLabel, { ...item }),
+            " ",
+            jsx(HelpTooltip, { content: jsx(React.Fragment, null,
+                    "Proposed to be ",
+                    proposalConfig.hint) })), key: item.itemPath, onClick: handleClick, icon: getProposalIcon(item.proposal), text: jsx(ProposalSummary, { ...item }) }));
+};
+export const ProposalDetail = function ({ proposal, showDiff, showOnlyChanged, itemRef, itemData, itemDataBefore, onChange }) {
+    const ItemView = registerItemDetailView.main;
+    const view = showDiff
+        ? jsx(MaximizedStructuredDiff, { item1: itemDataBefore ?? {}, item2: itemData, showUnchanged: !showOnlyChanged, css: css `background: white; border-radius: 2.5px; padding: 10px 0; margin: 10px 0;`, className: Classes.ELEVATION_2 })
+        : jsx(ItemView, { uri: itemRefToItemPath(itemRef), key: JSON.stringify(itemRef) });
+    return jsx("div", { css: css `position: absolute; inset: 0; display: flex; flex-flow: column;` }, view);
+};
+export const ProposalSummary = function ({ proposal, itemRef, itemData, itemDataBefore, onChange }) {
+    const { itemClasses } = useContext(BrowserCtx);
+    const { classID } = itemRef;
+    const ListItemView = itemClasses[classID].views.listItemView;
+    return jsx(ListItemView, { itemRef: itemRef, itemData: itemData });
+};
+const clarification = {
+    hint: jsx(React.Fragment, null, "altered to represent the same concept more clearly."),
+    summary: ({ proposal, itemData, itemRef }) => jsx(React.Fragment, null, "Clarification"),
+};
+const addition = {
+    hint: jsx(React.Fragment, null, "added to this register."),
+    summary: ({ proposal, itemData, itemRef }) => jsx(React.Fragment, null, "Addition"),
+};
+const retirement = {
+    hint: jsx(React.Fragment, null, "marked as no longer current. (Note that this register is append-only, so the item cannot be removed altogether.)"),
+    summary: ({ proposal, itemRef, itemData }) => jsx(React.Fragment, null, "Retirement"),
+};
+const supersession = {
+    hint: jsx(React.Fragment, null, "removed from the register with another item recommended for use in its place. A relation between the superseding and superseded item will be created, though the exact semantics of that relation depend on the register."),
+    summary: ({ proposal, itemRef, itemData }) => jsx(React.Fragment, null, "Supersession"),
+};
+const invalidation = {
+    hint: jsx(React.Fragment, null, "marked as invalid. The exact semantics of invalidation depend on the register."),
+    summary: ({ proposal, itemRef, itemData }) => jsx(React.Fragment, null, "Invalidation"),
+};
+const MaximizedStructuredDiff = styled(StructuredDiff) `
+  position: absolute;
+  inset: 0;
+`;
+const PROPOSAL_VIEWS = {
+    clarification,
+    addition,
+    retirement,
+    supersession,
+    invalidation,
+};
+function getProposalIcon(proposal) {
+    return proposal.type === 'addition'
+        ? 'add'
+        : proposal.type === 'clarification'
+            ? 'edit'
+            : 'ban-circle';
+}
+export default Proposals;
+//# sourceMappingURL=Proposals.js.map

package/compiled/views/change-request/Proposals.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Proposals.js","sourceRoot":"","sources":["../../../src/views/change-request/Proposals.tsx"],"names":[],"mappings":"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","sourcesContent":["/** @jsx jsx */\n/** @jsxFrag React.Fragment */\n\nimport React, { useContext, useEffect, useState } from 'react';\nimport { jsx, css } from '@emotion/react';\nimport styled from '@emotion/styled';\nimport {\n  ControlGroup,\n  ButtonGroup,\n  Switch,\n  Button,\n  Classes,\n  MenuItem,\n  NonIdealState,\n  IconName,\n} from '@blueprintjs/core';\nimport { ItemRenderer, Select2 as Select } from '@blueprintjs/select';\nimport HelpTooltip from '@riboseinc/paneron-extension-kit/widgets/HelpTooltip';\nimport type {\n  Addition,\n  ChangeProposal,\n  Clarification,\n  InternalItemReference,\n  Retirement,\n  Supersession,\n  Invalidation,\n  Payload,\n} from '../../types';\nimport type { Drafted } from '../../types/cr';\nimport { Protocols, type Protocol } from '../protocolRegistry';\nimport { PROPOSAL_TYPES, AMENDMENT_TYPES } from '../../types/proposal';\nimport { BrowserCtx, type BrowserCtx as BrowserCtxType } from '../BrowserCtx';\nimport { itemPathToItemRef, itemRefToItemPath } from '../itemPathUtils';\nimport StructuredDiff from '../diffing/StructuredDiff';\nimport registerItemDetailView from '../detail/RegisterItem';\n\n\ninterface ChangeProposalItem {\n  itemPath: string\n  itemRef: InternalItemReference\n  proposal: ChangeProposal\n  itemData: Payload\n  itemDataBefore: Payload | undefined\n}\n\n\nconst Proposals: React.FC<{\n  proposals: Drafted['items']\n  className?: string\n}> = function ({ proposals, className }) {\n  const [ _selectedProposal, selectProposal ] = useState<string | null>(null);\n  const [ showDiff, setShowDiff ] = useState(false);\n  const [ showOnlyChanged, setShowOnlyChanged ] = useState(true);\n\n  const outerBrowserCtx = useContext(BrowserCtx);\n  const { jumpTo, subregisters, useRegisterItemData } = outerBrowserCtx;\n  const proposalBrowserCtx: BrowserCtxType = {\n    ...outerBrowserCtx,\n    jumpTo: handleCRJump,\n  };\n\n  /**\n   * When jumping to an item affected by current CR,\n   * jump in-CR instead of spawning tab.\n   */\n  function handleCRJump(uri: `${Protocol}:${string}`): void {\n    if (uri.startsWith(Protocols.ITEM_DETAILS)) {\n      const itemPath = uri.split(':')[1];\n      if (proposals[itemPath]) {\n        selectProposal(itemPath);\n      } else {\n        jumpTo?.(uri);\n      }\n    }\n  }\n\n  const firstProposal: string | undefined = Object.keys(proposals)[0];\n\n  // Effective selected proposal\n  const selectedProposal: string | undefined =\n    ((_selectedProposal && proposals[_selectedProposal]) ? _selectedProposal : null)\n    ?? firstProposal\n    ?? undefined;\n\n  // Force select available proposal\n  useEffect(() => {\n    if (firstProposal && (_selectedProposal === null || !proposals[_selectedProposal])) {\n      selectProposal(firstProposal);\n    }\n  }, [firstProposal, _selectedProposal, JSON.stringify(proposals)]);\n\n  const selectedItemRef = selectedProposal\n    ? itemPathToItemRef(subregisters !== undefined, selectedProposal)\n    : null;\n\n\n  // Data for proposed items\n  const proposedItemPaths = Object.entries(proposals).map(([itemPath, proposal]) => {\n    if (proposal.type === 'clarification' || proposal.type === 'addition') {\n      return itemPath;\n    } else {\n      return undefined;\n    }\n  }).filter(s => s !== undefined) as string[];\n  const proposedItemDataReq = useRegisterItemData({\n    itemPaths: proposedItemPaths,\n  });\n\n  // Data for pre-existing items\n  const currentItemDataReq = useRegisterItemData({\n    itemPaths: Object.keys(proposals),\n    ignoreActiveCR: true,\n  });\n\n  const getCurrentItemData = (itemPath: string) => currentItemDataReq.value[itemPath]?.data ?? null;\n  const getProposedItemData = (itemPath: string) => proposedItemDataReq.value[itemPath]?.data ?? null;\n\n  const selectedItemCurrentData = getCurrentItemData(selectedProposal);\n  const selectedItemProposedData = getProposedItemData(selectedProposal);\n\n  if (\n    selectedProposal\n    && selectedItemRef\n    && proposals[selectedProposal]\n    && !currentItemDataReq.isUpdating\n    && !proposedItemDataReq.isUpdating\n  ) {\n    if (selectedItemCurrentData || selectedItemProposedData) {\n      const selectedItemSummary = <ProposalSummary\n        itemRef={selectedItemRef}\n        itemData={(selectedItemProposedData ?? selectedItemCurrentData)!}\n        itemDataBefore={selectedItemCurrentData ?? undefined}\n        proposal={proposals[selectedProposal]}\n      />\n\n      return (\n        <div css={css`display: flex; flex-flow: column nowrap;`} className={className}>\n          <div>\n            <ControlGroup>\n              <Switch\n                checked={showDiff}\n                onChange={evt => setShowDiff(evt.currentTarget.checked)}\n                label=\"View source\"\n                css={css`margin-right: 1em !important`}\n              />\n              <Switch\n                checked={showDiff && showOnlyChanged}\n                disabled={!showDiff}\n                onChange={evt => setShowOnlyChanged(evt.currentTarget.checked)}\n                label=\"Show clarified properties only\"\n              />\n            </ControlGroup>\n            <ButtonGroup>\n              <Button\n                  disabled={!jumpTo || proposals[selectedProposal]?.type === 'addition'}\n                  icon='locate'\n                  onClick={() => jumpTo?.(`${Protocols.ITEM_DETAILS}:${selectedProposal}`)}\n                  title=\"Open selected item in a new tab (not applicable to proposed additions)\">\n                Reveal in registry\n              </Button>\n              {Object.keys(proposals).length > 1\n                ? <Select<ChangeProposalItem>\n                      filterable={false}\n                      itemsEqual={(i1, i2) => JSON.stringify(i1) === JSON.stringify(i2)}\n                      activeItem={{\n                          itemPath: selectedProposal,\n                          proposal: proposals[selectedProposal],\n                          itemData: (selectedItemProposedData ?? selectedItemCurrentData)!,\n                          itemDataBefore: selectedItemCurrentData ?? undefined,\n                          itemRef: itemPathToItemRef(subregisters !== undefined, selectedProposal),\n                        }} // TODO: First time selection is broken\n                      items={\n                        Object.entries(proposals).map(([itemPath, proposal]) => ({\n                          itemPath,\n                          proposal,\n                          itemData: (getProposedItemData(itemPath) ?? getCurrentItemData(itemPath))! ?? null,\n                          itemDataBefore: undefined,\n                          itemRef: itemPathToItemRef(subregisters !== undefined, itemPath),\n                        })).filter(item => item.itemData !== null)}\n                      popoverProps={{ minimal: true }}\n                      fill\n                      itemRenderer={ChangeProposalItemView}\n                      onItemSelect={(item) => selectProposal(item.itemPath)}>\n                    <Button rightIcon=\"chevron-down\" icon={getProposalIcon(proposals[selectedProposal])}>\n                      {selectedItemSummary}\n                    </Button>\n                  </Select>\n                : <Button\n                      fill\n                      alignText=\"left\"\n                      icon={getProposalIcon(proposals[selectedProposal])}\n                      rightIcon=\"chevron-down\">\n                    {selectedItemSummary}\n                  </Button>}\n            </ButtonGroup>\n          </div>\n          <div css={css`position: relative; flex: 1;`}>\n            <BrowserCtx.Provider value={proposalBrowserCtx}>\n              <ProposalDetail\n                itemRef={selectedItemRef}\n                showDiff={showDiff}\n                showOnlyChanged={showOnlyChanged}\n                itemData={(selectedItemProposedData ?? selectedItemCurrentData)!}\n                itemDataBefore={selectedItemCurrentData ?? undefined}\n                proposal={proposals[selectedProposal]}\n              />\n            </BrowserCtx.Provider>\n          </div>\n        </div>\n      );\n    } else {\n      return <NonIdealState\n        icon='warning-sign'\n        className={className}\n        title=\"Unable to retrieve proposed item data\"\n        description={<div css={css`text-align: left;`}>\n          There appears to be a data integrity issue.\n          <br />\n          This might be caused by a problem in the application, or repository contents having been edited outside of the application.\n          <br />\n          The data should be recoverable by inspecting version control system commit history.\n        </div>}\n      />;\n    }\n  } else {\n    return <NonIdealState\n      icon='clean'\n      className={className}\n      title=\"Nothing is proposed here yet.\"\n    />;\n  }\n};\n\n\nconst ChangeProposalItemView: ItemRenderer<ChangeProposalItem> =\n(item, { handleClick, modifiers, query }) => {\n  const proposalConfig = \n    item.proposal.type === 'amendment'\n      ? PROPOSAL_VIEWS[item.proposal.amendmentType]\n      : PROPOSAL_VIEWS[item.proposal.type];\n  const ProposalTypeLabel: React.FC<ProposalProps<any>> = proposalConfig.summary;\n  return (\n    <MenuItem\n      active={modifiers.active}\n      disabled={modifiers.disabled}\n      labelElement={<>\n        <ProposalTypeLabel {...item} />\n        {\" \"}\n        <HelpTooltip content={<>Proposed to be {proposalConfig.hint}</>} />\n      </>}\n      key={item.itemPath}\n      onClick={handleClick}\n      icon={getProposalIcon(item.proposal)}\n      text={<ProposalSummary {...item} />} />\n  );\n}\n\n\ninterface ProposalProps<P extends ChangeProposal> {\n  proposal: P\n  showDiff?: boolean\n  showOnlyChanged?: boolean\n  itemRef: InternalItemReference\n  itemData: Payload\n  itemDataBefore: P extends Clarification ? Payload : undefined\n  onChange?: (newProposal: P) => void\n}\nexport const ProposalDetail: React.FC<ProposalProps<ChangeProposal>> =\nfunction ({ proposal, showDiff, showOnlyChanged, itemRef, itemData, itemDataBefore, onChange }) {\n  const ItemView = registerItemDetailView.main;\n\n  const view: JSX.Element = showDiff\n    ? <MaximizedStructuredDiff\n        item1={itemDataBefore ?? {}}\n        item2={itemData}\n        showUnchanged={!showOnlyChanged}\n        css={css`background: white; border-radius: 2.5px; padding: 10px 0; margin: 10px 0;`}\n        className={Classes.ELEVATION_2}\n      />\n    : <ItemView uri={itemRefToItemPath(itemRef)} key={JSON.stringify(itemRef)} />\n\n  return <div css={css`position: absolute; inset: 0; display: flex; flex-flow: column;`}>\n    {view}\n  </div>;\n};\nexport const ProposalSummary: React.FC<ProposalProps<ChangeProposal>> =\nfunction ({ proposal, itemRef, itemData, itemDataBefore, onChange }) {\n  const { itemClasses } = useContext(BrowserCtx);\n  const { classID } = itemRef;\n  const ListItemView = itemClasses[classID].views.listItemView;\n\n  return <ListItemView\n    itemRef={itemRef}\n    itemData={itemData}\n  />;\n};\n\n\ninterface ProposalViewConfig<P extends ChangeProposal> {\n  summary: React.FC<ProposalProps<P>>\n  hint: JSX.Element | string\n}\n\n\nconst clarification: ProposalViewConfig<Clarification> = {\n  hint: <>\n    altered to represent the same concept more clearly.\n  </>,\n  summary: ({ proposal, itemData, itemRef }) => <>Clarification</>,\n};\n\n\nconst addition: ProposalViewConfig<Addition> = {\n  hint: <>added to this register.</>,\n  summary: ({ proposal, itemData, itemRef }) => <>Addition</>,\n};\n\n\nconst retirement: ProposalViewConfig<Retirement> = {\n  hint: <>\n    marked as no longer current.\n    (Note that this register is append-only, so the item cannot be removed altogether.)\n  </>,\n  summary: ({ proposal, itemRef, itemData }) => <>Retirement</>,\n};\n\n\nconst supersession: ProposalViewConfig<Supersession> = {\n  hint: <>\n    removed from the register with another item recommended for use in its place.\n    A relation between the superseding and superseded item will be created,\n    though the exact semantics of that relation depend on the register.\n  </>,\n  summary: ({ proposal, itemRef, itemData }) => <>Supersession</>,\n};\n\n\nconst invalidation: ProposalViewConfig<Invalidation> = {\n  hint: <>\n    marked as invalid. The exact semantics of invalidation depend on the register.\n  </>,\n  summary: ({ proposal, itemRef, itemData }) => <>Invalidation</>,\n}\n\n\nconst MaximizedStructuredDiff = styled(StructuredDiff)`\n  position: absolute;\n  inset: 0;\n`;\n\n\ntype ProposalOrAmendmentType =\n  | Exclude<typeof PROPOSAL_TYPES[number], 'amendment'>\n  | typeof AMENDMENT_TYPES[number];\n\n\nconst PROPOSAL_VIEWS: { [type in ProposalOrAmendmentType]: ProposalViewConfig<any> } = {\n  clarification,\n  addition,\n  retirement,\n  supersession,\n  invalidation,\n};\n\n\nfunction getProposalIcon(proposal: ChangeProposal): IconName {\n  return proposal.type === 'addition'\n      ? 'add'\n      : proposal.type === 'clarification'\n        ? 'edit'\n        : 'ban-circle'\n}\n\n\nexport default Proposals;\n"]}

package/compiled/views/change-request/objectChangeset.d.ts

@@ -0,0 +1,31 @@
+import type { ObjectChangeset } from '@riboseinc/paneron-extension-kit/types/objects';
+import type { RegisterItem, ChangeRequest, ChangeProposal } from '../../types';
+import type { Version as RegisterVersion } from '../../types/register';
+import { type Drafted, type ReturnedForClarificationByManager, type ReturnedForClarificationByControlBody } from '../../types/cr';
+/** Takes a justification and ID, returns an object changeset. */
+export declare function newCRObjectChangeset(id: string, justification: string, registerVersion: RegisterVersion, stakeholderGitServerUsername: string): ObjectChangeset;
+/**
+ * Returns an object changeset to update CR with new given proposal items.
+ * Only applicable to CR at draft edit stage.
+ */
+export declare function updateCRObjectChangeset(
+/**
+ * Change request data.
+ */
+cr: Drafted | ReturnedForClarificationByManager | ReturnedForClarificationByControlBody, 
+/**
+ * Proposals by item path.
+ * Will be merged with those already existing in `cr`.
+ * If a proposal is undefined, it will be removed.
+ */
+proposalItems: Record<string, ChangeProposal | null>, 
+/**
+ * New item data must be provided for additions and clarifications,
+ * keyed by item path.
+ */
+itemData?: Record<string, RegisterItem<any>>): ObjectChangeset;
+/**
+ * Given change proposals, returns applicable changes
+ * to objects in the dataset.
+ */
+export declare function proposalsToObjectChangeset(crID: string, hasSubregisters: boolean, proposals: ChangeRequest["proposals"], itemData: Record<string, RegisterItem<any> | null>, newItemData: Record<string, RegisterItem<any> | null>): Promise<ObjectChangeset>;

package/compiled/views/change-request/objectChangeset.js

@@ -0,0 +1,189 @@
+import { isRegisterItem } from '../../types';
+import { State, } from '../../types/cr';
+import { crIDToCRPath, itemPathInCR, itemPathToItemRef, itemRefToItemPath } from '../itemPathUtils';
+/** Takes a justification and ID, returns an object changeset. */
+export function newCRObjectChangeset(id, justification, registerVersion, stakeholderGitServerUsername) {
+    const timeStarted = new Date();
+    const cr = {
+        id,
+        timeStarted,
+        timeEdited: timeStarted,
+        justification,
+        submittingStakeholderGitServerUsername: stakeholderGitServerUsername,
+        items: {},
+        state: State.DRAFT,
+        registerVersion: registerVersion.id,
+    };
+    const crObjectPath = crIDToCRPath(id);
+    return {
+        [crObjectPath]: {
+            oldValue: null,
+            newValue: cr,
+        },
+    };
+}
+/**
+ * Returns an object changeset to update CR with new given proposal items.
+ * Only applicable to CR at draft edit stage.
+ */
+export function updateCRObjectChangeset(
+/**
+ * Change request data.
+ */
+cr, 
+/**
+ * Proposals by item path.
+ * Will be merged with those already existing in `cr`.
+ * If a proposal is undefined, it will be removed.
+ */
+proposalItems, 
+/**
+ * New item data must be provided for additions and clarifications,
+ * keyed by item path.
+ */
+itemData = {}) {
+    const changeset = {};
+    const newItems = { ...cr.items };
+    for (const [itemPath, proposal] of Object.entries(proposalItems)) {
+        // Update proposals on CR
+        if (proposal !== null) {
+            newItems[itemPath] = proposal;
+        }
+        else if (newItems[itemPath]) {
+            delete newItems[itemPath];
+        }
+        // Add/remove item data
+        if (proposal?.type === 'addition' || proposal?.type === 'clarification') {
+            const proposedItemData = itemData[itemPath];
+            if (proposedItemData === null || !isRegisterItem(proposedItemData)) {
+                console.error("Unable to convert proposals to object changeset: original item data is missing", itemPath);
+                throw new Error("Unable to convert proposals to object changeset: original item data is missing");
+            }
+            changeset[itemPathInCR(itemPath, cr.id)] = {
+                // When editing a draft, we don’t care
+                // about overwriting proposed item data so we omit oldValue.
+                newValue: proposedItemData,
+            };
+        }
+        else {
+            changeset[itemPathInCR(itemPath, cr.id)] = {
+                // When editing a draft, we don’t care
+                // about overwriting proposed item data so we omit oldValue.
+                newValue: null,
+            };
+        }
+    }
+    // Update main CR data
+    const crPath = crIDToCRPath(cr.id);
+    changeset[crPath] = {
+        oldValue: cr,
+        newValue: { ...cr, items: newItems, timeEdited: new Date() },
+    };
+    return changeset;
+}
+/**
+ * Given change proposals, returns applicable changes
+ * to objects in the dataset.
+ */
+export async function proposalsToObjectChangeset(crID, hasSubregisters, proposals, itemData, newItemData) {
+    const cs = {};
+    for (const [itemPath, proposal] of Object.entries(proposals)) {
+        //const originalItem: RegisterItem<any> | undefined = (itemData[itemPath] ?? undefined);
+        const itemRef = itemPathToItemRef(hasSubregisters, itemPath);
+        if (proposal.type !== 'addition') {
+            if (itemData[itemPath] === undefined) {
+                console.error("Unable to convert proposals to object changeset: original item data is missing", itemPath);
+                throw new Error("Unable to convert proposals to object changeset: original item data is missing");
+            }
+            if (proposal.type === 'amendment' && proposal.amendmentType === 'supersession') {
+                Object.assign(cs, await proposalToObjectChangeset(crID, proposal, itemRef, itemPath, itemData, newItemData));
+            }
+            else {
+                Object.assign(cs, await proposalToObjectChangeset(crID, proposal, itemRef, itemPath, itemData, newItemData));
+            }
+        }
+        else {
+            Object.assign(cs, await proposalToObjectChangeset(crID, proposal, itemRef, itemPath, itemData, newItemData));
+        }
+    }
+    return cs;
+}
+// TODO: Refactor out the business logic of proposal approval.
+/**
+ * Given a change proposal, returns applicable changes
+ * to objects in the dataset.
+ * Core logic of approving a proposal.
+ * Takes a proposal and extra options (depending on proposal type).
+ * Returns a Changeset containing register items at appropriate paths.
+ */
+async function proposalToObjectChangeset(crID, proposal, itemRef, itemPath, itemData, newItemData) {
+    let updatedItem;
+    const changeset = {};
+    const origItem = itemData[itemPath] ?? null;
+    const newItem = newItemData[itemPathInCR(itemPath, crID)] ?? null;
+    if (proposal.type !== 'addition') {
+        if (origItem === null) {
+            throw new Error("proposalToObjectChangeset() requires original item data for non-additions");
+        }
+        updatedItem = { ...origItem };
+        switch (proposal.type) {
+            case 'clarification':
+                if (newItem === null) {
+                    throw new Error("proposalToObjectChangeset() requires new item data for clarifications");
+                }
+                //const clarification = proposal as Clarification;
+                updatedItem.data = newItem.data; //clarification.payload;
+                break;
+            case 'amendment':
+                const amendment = proposal;
+                updatedItem.amendedInCR = crID;
+                switch (amendment.amendmentType) {
+                    case 'retirement':
+                        updatedItem.status = 'retired';
+                        break;
+                    case 'invalidation':
+                        updatedItem.status = 'invalid';
+                        break;
+                    case 'supersession':
+                        const supersession = proposal;
+                        updatedItem.status = 'superseded';
+                        updatedItem.supersededBy = supersession.supersedingItemIDs.map(itemID => ({
+                            itemID,
+                            classID: itemRef.classID,
+                            subregisterID: itemRef.subregisterID,
+                        }));
+                        for (const supersedingItemPath of updatedItem.supersededBy.map(ip => itemRefToItemPath(ip))) {
+                            const supersedingItemData = itemData[supersedingItemPath];
+                            if (supersedingItemData) {
+                                changeset[supersedingItemPath] = {
+                                    oldValue: supersedingItemData,
+                                    newValue: {
+                                        ...supersedingItemData,
+                                        supersedes: [...(supersedingItemData.supersedes ?? []), itemRef],
+                                    },
+                                };
+                            }
+                        }
+                        break;
+                }
+                break;
+        }
+    }
+    else {
+        if (newItem === null) {
+            throw new Error("proposalToObjectChangeset() requires new item data for additions");
+        }
+        updatedItem = {
+            id: itemRef.itemID,
+            data: newItem.data,
+            status: 'valid',
+            dateAccepted: new Date(),
+        };
+    }
+    changeset[itemPath] = {
+        oldValue: origItem,
+        newValue: updatedItem,
+    };
+    return changeset;
+}
+//# sourceMappingURL=objectChangeset.js.map

package/compiled/views/change-request/objectChangeset.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"objectChangeset.js","sourceRoot":"","sources":["../../../src/views/change-request/objectChangeset.ts"],"names":[],"mappings":"AAUA,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAE7C,OAAO,EACL,KAAK,GAIN,MAAM,gBAAgB,CAAC;AACxB,OAAO,EAAE,YAAY,EAAE,YAAY,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAGpG,iEAAiE;AACjE,MAAM,UAAU,oBAAoB,CAClC,EAAU,EACV,aAAqB,EACrB,eAAgC,EAChC,4BAAoC;IAGpC,MAAM,WAAW,GAAG,IAAI,IAAI,EAAE,CAAC;IAC/B,MAAM,EAAE,GAAY;QAClB,EAAE;QACF,WAAW;QACX,UAAU,EAAE,WAAW;QACvB,aAAa;QACb,sCAAsC,EAAE,4BAA4B;QACpE,KAAK,EAAE,EAAE;QACT,KAAK,EAAE,KAAK,CAAC,KAAK;QAClB,eAAe,EAAE,eAAgB,CAAC,EAAE;KACrC,CAAC;IACF,MAAM,YAAY,GAAG,YAAY,CAAC,EAAE,CAAC,CAAC;IACtC,OAAO;QACL,CAAC,YAAY,CAAC,EAAE;YACd,QAAQ,EAAE,IAAI;YACd,QAAQ,EAAE,EAAE;SACb;KACF,CAAA;AACH,CAAC;AAGD;;;GAGG;AACH,MAAM,UAAU,uBAAuB;AACrC;;GAEG;AACH,EAAuF;AAEvF;;;;GAIG;AACH,aAAoD;AAEpD;;;GAGG;AACH,WAA8C,EAAE;IAEhD,MAAM,SAAS,GAAoB,EAAE,CAAC;IACtC,MAAM,QAAQ,GAAG,EAAE,GAAG,EAAE,CAAC,KAAK,EAAE,CAAC;IACjC,KAAK,MAAM,CAAC,QAAQ,EAAE,QAAQ,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,aAAa,CAAC,EAAE;QAChE,yBAAyB;QACzB,IAAI,QAAQ,KAAK,IAAI,EAAE;YACrB,QAAQ,CAAC,QAAQ,CAAC,GAAG,QAAQ,CAAC;SAC/B;aAAM,IAAI,QAAQ,CAAC,QAAQ,CAAC,EAAE;YAC7B,OAAO,QAAQ,CAAC,QAAQ,CAAC,CAAC;SAC3B;QACD,uBAAuB;QACvB,IAAI,QAAQ,EAAE,IAAI,KAAK,UAAU,IAAI,QAAQ,EAAE,IAAI,KAAK,eAAe,EAAE;YACvE,MAAM,gBAAgB,GAAG,QAAQ,CAAC,QAAQ,CAAC,CAAC;YAC5C,IAAI,gBAAgB,KAAK,IAAI,IAAI,CAAC,cAAc,CAAC,gBAAgB,CAAC,EAAE;gBAClE,OAAO,CAAC,KAAK,CAAC,gFAAgF,EAAE,QAAQ,CAAC,CAAC;gBAC1G,MAAM,IAAI,KAAK,CAAC,gFAAgF,CAAC,CAAC;aACnG;YACD,SAAS,CAAC,YAAY,CAAC,QAAQ,EAAE,EAAE,CAAC,EAAE,CAAC,CAAC,GAAG;gBACzC,sCAAsC;gBACtC,4DAA4D;gBAC5D,QAAQ,EAAE,gBAAgB;aAC3B,CAAC;SACH;aAAM;YACL,SAAS,CAAC,YAAY,CAAC,QAAQ,EAAE,EAAE,CAAC,EAAE,CAAC,CAAC,GAAG;gBACzC,sCAAsC;gBACtC,4DAA4D;gBAC5D,QAAQ,EAAE,IAAI;aACf,CAAC;SACH;KACF;IACD,sBAAsB;IACtB,MAAM,MAAM,GAAG,YAAY,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC;IACnC,SAAS,CAAC,MAAM,CAAC,GAAG;QAClB,QAAQ,EAAE,EAAE;QACZ,QAAQ,EAAE,EAAE,GAAG,EAAE,EAAE,KAAK,EAAE,QAAQ,EAAE,UAAU,EAAE,IAAI,IAAI,EAAE,EAAE;KAC7D,CAAC;IACF,OAAO,SAAS,CAAC;AACnB,CAAC;AAGD;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,0BAA0B,CAC9C,IAAY,EACZ,eAAwB,EACxB,SAAqC,EACrC,QAAkD,EAClD,WAAqD;IAErD,MAAM,EAAE,GAAoB,EAAE,CAAC;IAE/B,KAAK,MAAM,CAAC,QAAQ,EAAE,QAAQ,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,EAAE;QAC5D,wFAAwF;QACxF,MAAM,OAAO,GAAG,iBAAiB,CAAC,eAAe,EAAE,QAAQ,CAAC,CAAC;QAE7D,IAAI,QAAQ,CAAC,IAAI,KAAK,UAAU,EAAE;YAChC,IAAI,QAAQ,CAAC,QAAQ,CAAC,KAAK,SAAS,EAAE;gBACpC,OAAO,CAAC,KAAK,CAAC,gFAAgF,EAAE,QAAQ,CAAC,CAAC;gBAC1G,MAAM,IAAI,KAAK,CAAC,gFAAgF,CAAC,CAAC;aACnG;YACD,IAAI,QAAQ,CAAC,IAAI,KAAK,WAAW,IAAI,QAAQ,CAAC,aAAa,KAAK,cAAc,EAAE;gBAC9E,MAAM,CAAC,MAAM,CAAC,EAAE,EAAE,MAAM,yBAAyB,CAAC,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAE,WAAW,CAAC,CAAC,CAAC;aAC9G;iBAAM;gBACL,MAAM,CAAC,MAAM,CAAC,EAAE,EAAE,MAAM,yBAAyB,CAAC,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAE,WAAW,CAAC,CAAC,CAAC;aAC9G;SACF;aAAM;YACL,MAAM,CAAC,MAAM,CAAC,EAAE,EAAE,MAAM,yBAAyB,CAAC,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAE,WAAW,CAAC,CAAC,CAAC;SAC9G;KACF;IAED,OAAO,EAAE,CAAC;AACZ,CAAC;AAED,8DAA8D;AAC9D;;;;;;GAMG;AACH,KAAK,UAAU,yBAAyB,CACtC,IAAY,EACZ,QAAwB,EACxB,OAA8B,EAC9B,QAAgB,EAChB,QAAkD,EAClD,WAAqD;IAErD,IAAI,WAA8B,CAAC;IACnC,MAAM,SAAS,GAAyC,EAAE,CAAC;IAE3D,MAAM,QAAQ,GAAG,QAAQ,CAAC,QAAQ,CAAC,IAAI,IAAI,CAAC;IAC5C,MAAM,OAAO,GAAG,WAAW,CAAC,YAAY,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC,IAAI,IAAI,CAAC;IAElE,IAAI,QAAQ,CAAC,IAAI,KAAK,UAAU,EAAE;QAChC,IAAI,QAAQ,KAAK,IAAI,EAAE;YACrB,MAAM,IAAI,KAAK,CAAC,2EAA2E,CAAC,CAAC;SAC9F;QAED,WAAW,GAAG,EAAE,GAAG,QAAQ,EAAE,CAAC;QAE9B,QAAQ,QAAQ,CAAC,IAAI,EAAE;YACrB,KAAK,eAAe;gBAClB,IAAI,OAAO,KAAK,IAAI,EAAE;oBACpB,MAAM,IAAI,KAAK,CAAC,uEAAuE,CAAC,CAAC;iBAC1F;gBACD,kDAAkD;gBAClD,WAAW,CAAC,IAAI,GAAG,OAAO,CAAC,IAAI,CAAA,CAAC,wBAAwB;gBACxD,MAAM;YACR,KAAK,WAAW;gBACd,MAAM,SAAS,GAAG,QAAqB,CAAC;gBACxC,WAAW,CAAC,WAAW,GAAG,IAAI,CAAC;gBAE/B,QAAQ,SAAS,CAAC,aAAa,EAAE;oBAC/B,KAAK,YAAY;wBACf,WAAW,CAAC,MAAM,GAAG,SAAS,CAAC;wBAC/B,MAAM;oBACR,KAAK,cAAc;wBACjB,WAAW,CAAC,MAAM,GAAG,SAAS,CAAC;wBAC/B,MAAM;oBACR,KAAK,cAAc;wBACjB,MAAM,YAAY,GAAG,QAAwB,CAAC;wBAC9C,WAAW,CAAC,MAAM,GAAG,YAAY,CAAC;wBAClC,WAAW,CAAC,YAAY,GAAG,YAAY,CAAC,kBAAkB,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;4BACxE,MAAM;4BACN,OAAO,EAAE,OAAO,CAAC,OAAO;4BACxB,aAAa,EAAE,OAAO,CAAC,aAAa;yBACrC,CAAC,CAAC,CAAC;wBACJ,KAAK,MAAM,mBAAmB,IAAI,WAAW,CAAC,YAAY,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,CAAC,iBAAiB,CAAC,EAAE,CAAC,CAAC,EAAE;4BAC3F,MAAM,mBAAmB,GAAG,QAAQ,CAAC,mBAAmB,CAAC,CAAC;4BAC1D,IAAI,mBAAmB,EAAE;gCACvB,SAAS,CAAC,mBAAmB,CAAC,GAAG;oCAC/B,QAAQ,EAAE,mBAAmB;oCAC7B,QAAQ,EAAE;wCACR,GAAG,mBAAmB;wCACtB,UAAU,EAAE,CAAE,GAAG,CAAC,mBAAmB,CAAC,UAAU,IAAI,EAAE,CAAC,EAAE,OAAO,CAAE;qCACnE;iCACF,CAAC;6BACH;yBACF;wBACD,MAAM;iBACT;gBACD,MAAM;SACT;KACF;SAAM;QACL,IAAI,OAAO,KAAK,IAAI,EAAE;YACpB,MAAM,IAAI,KAAK,CAAC,kEAAkE,CAAC,CAAC;SACrF;QACD,WAAW,GAAG;YACZ,EAAE,EAAE,OAAO,CAAC,MAAM;YAClB,IAAI,EAAE,OAAO,CAAC,IAAI;YAClB,MAAM,EAAE,OAAO;YACf,YAAY,EAAE,IAAI,IAAI,EAAE;SACzB,CAAC;KACH;IAED,SAAS,CAAC,QAAQ,CAAC,GAAG;QACpB,QAAQ,EAAE,QAAQ;QAClB,QAAQ,EAAE,WAAW;KACtB,CAAC;IAEF,OAAO,SAAS,CAAC;AACnB,CAAC","sourcesContent":["import type { Change, Changeset } from '@riboseinc/paneron-extension-kit/types/changes';\nimport type { ObjectChangeset } from '@riboseinc/paneron-extension-kit/types/objects';\nimport type {\n  InternalItemReference,\n  RegisterItem,\n  ChangeRequest,\n  ChangeProposal,\n  Amendment,\n  Supersession,\n} from '../../types';\nimport { isRegisterItem } from '../../types';\nimport type { Version as RegisterVersion } from '../../types/register';\nimport {\n  State,\n  type Drafted,\n  type ReturnedForClarificationByManager,\n  type ReturnedForClarificationByControlBody,\n} from '../../types/cr';\nimport { crIDToCRPath, itemPathInCR, itemPathToItemRef, itemRefToItemPath } from '../itemPathUtils';\n\n\n/** Takes a justification and ID, returns an object changeset. */\nexport function newCRObjectChangeset(\n  id: string,\n  justification: string,\n  registerVersion: RegisterVersion,\n  stakeholderGitServerUsername: string,\n): ObjectChangeset {\n\n  const timeStarted = new Date();\n  const cr: Drafted = {\n    id,\n    timeStarted,\n    timeEdited: timeStarted,\n    justification,\n    submittingStakeholderGitServerUsername: stakeholderGitServerUsername,\n    items: {},\n    state: State.DRAFT,\n    registerVersion: registerVersion!.id,\n  };\n  const crObjectPath = crIDToCRPath(id);\n  return {\n    [crObjectPath]: {\n      oldValue: null,\n      newValue: cr,\n    },\n  }\n}\n\n\n/**\n * Returns an object changeset to update CR with new given proposal items.\n * Only applicable to CR at draft edit stage.\n */\nexport function updateCRObjectChangeset(\n  /**\n   * Change request data.\n   */\n  cr: Drafted | ReturnedForClarificationByManager | ReturnedForClarificationByControlBody,\n\n  /**\n   * Proposals by item path.\n   * Will be merged with those already existing in `cr`.\n   * If a proposal is undefined, it will be removed.\n   */\n  proposalItems: Record<string, ChangeProposal | null>,\n\n  /**\n   * New item data must be provided for additions and clarifications,\n   * keyed by item path.\n   */\n  itemData: Record<string, RegisterItem<any>> = {},\n): ObjectChangeset {\n  const changeset: ObjectChangeset = {};\n  const newItems = { ...cr.items };\n  for (const [itemPath, proposal] of Object.entries(proposalItems)) {\n    // Update proposals on CR\n    if (proposal !== null) {\n      newItems[itemPath] = proposal;\n    } else if (newItems[itemPath]) {\n      delete newItems[itemPath];\n    }\n    // Add/remove item data\n    if (proposal?.type === 'addition' || proposal?.type === 'clarification') {\n      const proposedItemData = itemData[itemPath];\n      if (proposedItemData === null || !isRegisterItem(proposedItemData)) {\n        console.error(\"Unable to convert proposals to object changeset: original item data is missing\", itemPath);\n        throw new Error(\"Unable to convert proposals to object changeset: original item data is missing\");\n      }\n      changeset[itemPathInCR(itemPath, cr.id)] = {\n        // When editing a draft, we don’t care\n        // about overwriting proposed item data so we omit oldValue.\n        newValue: proposedItemData,\n      };\n    } else {\n      changeset[itemPathInCR(itemPath, cr.id)] = {\n        // When editing a draft, we don’t care\n        // about overwriting proposed item data so we omit oldValue.\n        newValue: null,\n      };\n    }\n  }\n  // Update main CR data\n  const crPath = crIDToCRPath(cr.id);\n  changeset[crPath] = {\n    oldValue: cr,\n    newValue: { ...cr, items: newItems, timeEdited: new Date() },\n  };\n  return changeset;\n}\n\n\n/**\n * Given change proposals, returns applicable changes\n * to objects in the dataset.\n */\nexport async function proposalsToObjectChangeset(\n  crID: string,\n  hasSubregisters: boolean,\n  proposals: ChangeRequest[\"proposals\"],\n  itemData: Record<string, RegisterItem<any> | null>,\n  newItemData: Record<string, RegisterItem<any> | null>,\n): Promise<ObjectChangeset> {\n  const cs: ObjectChangeset = {};\n\n  for (const [itemPath, proposal] of Object.entries(proposals)) {\n    //const originalItem: RegisterItem<any> | undefined = (itemData[itemPath] ?? undefined);\n    const itemRef = itemPathToItemRef(hasSubregisters, itemPath);\n\n    if (proposal.type !== 'addition') {\n      if (itemData[itemPath] === undefined) {\n        console.error(\"Unable to convert proposals to object changeset: original item data is missing\", itemPath);\n        throw new Error(\"Unable to convert proposals to object changeset: original item data is missing\");\n      }\n      if (proposal.type === 'amendment' && proposal.amendmentType === 'supersession') {\n        Object.assign(cs, await proposalToObjectChangeset(crID, proposal, itemRef, itemPath, itemData, newItemData));\n      } else {\n        Object.assign(cs, await proposalToObjectChangeset(crID, proposal, itemRef, itemPath, itemData, newItemData));\n      }\n    } else {\n      Object.assign(cs, await proposalToObjectChangeset(crID, proposal, itemRef, itemPath, itemData, newItemData));\n    }\n  }\n\n  return cs;\n}\n\n// TODO: Refactor out the business logic of proposal approval.\n/**\n * Given a change proposal, returns applicable changes\n * to objects in the dataset.\n * Core logic of approving a proposal.\n * Takes a proposal and extra options (depending on proposal type).\n * Returns a Changeset containing register items at appropriate paths.\n */\nasync function proposalToObjectChangeset(\n  crID: string,\n  proposal: ChangeProposal,\n  itemRef: InternalItemReference,\n  itemPath: string,\n  itemData: Record<string, RegisterItem<any> | null>,\n  newItemData: Record<string, RegisterItem<any> | null>,\n): Promise<Changeset<Change<RegisterItem<any>>>> {\n  let updatedItem: RegisterItem<any>;\n  const changeset: Changeset<Change<RegisterItem<any>>> = {};\n\n  const origItem = itemData[itemPath] ?? null;\n  const newItem = newItemData[itemPathInCR(itemPath, crID)] ?? null;\n\n  if (proposal.type !== 'addition') {\n    if (origItem === null) {\n      throw new Error(\"proposalToObjectChangeset() requires original item data for non-additions\");\n    }\n\n    updatedItem = { ...origItem };\n\n    switch (proposal.type) {\n      case 'clarification':\n        if (newItem === null) {\n          throw new Error(\"proposalToObjectChangeset() requires new item data for clarifications\");\n        }\n        //const clarification = proposal as Clarification;\n        updatedItem.data = newItem.data //clarification.payload;\n        break;\n      case 'amendment':\n        const amendment = proposal as Amendment;\n        updatedItem.amendedInCR = crID;\n\n        switch (amendment.amendmentType) {\n          case 'retirement':\n            updatedItem.status = 'retired';\n            break;\n          case 'invalidation':\n            updatedItem.status = 'invalid';\n            break;\n          case 'supersession':\n            const supersession = proposal as Supersession;\n            updatedItem.status = 'superseded';\n            updatedItem.supersededBy = supersession.supersedingItemIDs.map(itemID => ({\n              itemID,\n              classID: itemRef.classID,\n              subregisterID: itemRef.subregisterID,\n            }));\n            for (const supersedingItemPath of updatedItem.supersededBy.map(ip => itemRefToItemPath(ip))) {\n              const supersedingItemData = itemData[supersedingItemPath];\n              if (supersedingItemData) {\n                changeset[supersedingItemPath] = {\n                  oldValue: supersedingItemData,\n                  newValue: {\n                    ...supersedingItemData,\n                    supersedes: [ ...(supersedingItemData.supersedes ?? []), itemRef ],\n                  },\n                };\n              }\n            }\n            break;\n        }\n        break;\n    }\n  } else {\n    if (newItem === null) {\n      throw new Error(\"proposalToObjectChangeset() requires new item data for additions\");\n    }\n    updatedItem = {\n      id: itemRef.itemID,\n      data: newItem.data,\n      status: 'valid',\n      dateAccepted: new Date(),\n    };\n  }\n\n  changeset[itemPath] = {\n    oldValue: origItem,\n    newValue: updatedItem,\n  };\n\n  return changeset;\n}\n"]}

package/compiled/views/detail/ChangeRequest/Proposal.js

@@ -0,0 +1,144 @@
+"use strict";
+// /** @jsx jsx */
+// /** @jsxFrag React.Fragment */
+// 
+// 
+// import React from 'react';
+// 
+// import { jsx, css } from '@emotion/react';
+// 
+// import {
+//   FormGroup,
+//   InputGroup,
+//   NonIdealState,
+//   HTMLSelect,
+//   H4,
+// } from '@blueprintjs/core';
+// 
+// import useItemClassConfig from '../../hooks/useItemClassConfig';
+// 
+// import type {
+//   ChangeProposal,
+//   Payload,
+//   InternalItemReference,
+// } from '../../../types';
+// 
+// import { PROPOSAL_TYPES } from '../../../types';
+// 
+// 
+// const ProposalDetails: React.FC<{
+//   itemRef: InternalItemReference
+//   proposal: ChangeProposal
+// 
+//   existingItemData?: Payload
+// 
+//   onAccept?: (itemID: string, clsID: string) => void
+//   onChange?: (val: ChangeProposal) => void
+//   onDelete?: () => void
+// }> = function ({
+//   itemRef,
+//   proposal,
+//   onChange,
+//   existingItemData,
+// }) {
+//   const { value: classConfig } = useItemClassConfig(itemRef.classID ?? 'NONEXISTENT_CLASS_ID');
+//   const itemClass = classConfig;
+// 
+//   let itemView: JSX.Element;
+//   let proposalProperties: JSX.Element | null;
+// 
+//   if (proposal.type === 'amendment') {
+//     proposalProperties = (
+//       <FormGroup inline label="Supersede with:">
+//         <InputGroup
+//           value={proposal.amendmentType === 'supersession' ? proposal.supersedingItemID : ''}
+//           disabled={!onChange}
+//           placeholder="Item ID"
+//           onChange={onChange
+//             ? (evt: React.FormEvent<HTMLInputElement>) => {
+//                 if (!onChange) { return; }
+//                 const itemID = evt.currentTarget.value;
+//                 if (itemID.trim() === '') {
+//                   const newVal = update(proposal, { $unset: ['supersedingItemID'] });
+//                   onChange({ ...newVal, amendmentType: 'retirement' });
+//                 } else {
+//                   onChange({ ...proposal, amendmentType: 'supersession', supersedingItemID: itemID });
+//                 }
+//               }
+//             : undefined}/>
+//       </FormGroup>
+//     );
+//   } else {
+//     proposalProperties = null;
+//   }
+// 
+//   const itemData: Payload | undefined = proposal.type === 'addition'
+//     ? proposal.payload
+//     : existingItemData;
+// 
+//   if (itemData === undefined || !itemClass) {
+//     itemView = <NonIdealState icon="heart-broken" title="Unable to display this item" />;
+//   } else if (onChange && proposal.type !== 'amendment') {
+//     const EditView = itemClass.views.editView;// as ItemEditView<any>;
+//     itemView = <EditView
+//       itemRef={itemRef}
+//       itemData={itemData}
+//       onChange={onChange
+//         ? (payload) => onChange ? onChange({ ...proposal, payload }) : void 0
+//         : undefined} />;
+//   } else {
+//     const DetailView = itemClass.views.detailView ?? itemClass!.views.editView;// as ItemDetailView<any>;
+//     itemView = <DetailView
+//       itemRef={itemRef}
+//       itemData={itemData} />;
+//   }
+// 
+//   const canChangeProposalType = proposal.type !== 'addition';
+// 
+//   function handleTypeChange(type: string) {
+//     const pt = type as typeof PROPOSAL_TYPES[number];
+// 
+//     if (PROPOSAL_TYPES.indexOf(pt) < 0) { return; }
+//     if (!onChange || !canChangeProposalType || pt === 'addition' || existingItemData === undefined) { return; }
+// 
+//     if (pt === 'amendment') {
+//       onChange(update(proposal, {
+//         type: { $set: pt },
+//         amendmentType: { $set: 'retirement' },
+//         $unset: ['payload'],
+//       }));
+//     } else {
+//       onChange(update(proposal, {
+//         type: { $set: pt },
+//         payload: existingItemData,
+//       }));
+//     }
+//   }
+// 
+//   return (
+//     <div css={css`flex: 1; display: flex; flex-flow: column nowrap;`}>
+//       <div css={css`flex-shrink: 0; display: flex; flex-flow: row nowrap; align-items: center; margin-bottom: 1rem;`}>
+//         <HTMLSelect
+//           options={PROPOSAL_TYPES.map(pt => ({ value: pt, label: pt }))}
+//           //iconProps={{ icon: PROPOSAL_ICON[proposal.type] }}
+//           value={proposal.type}
+//           disabled={!onChange || !canChangeProposalType || existingItemData === undefined}
+//           onChange={(onChange && canChangeProposalType && existingItemData !== undefined)
+//             ? (evt) => handleTypeChange(evt.currentTarget.value)
+//             : undefined} />
+//         &ensp;
+//         of a
+//         &ensp;
+//         <H4 css={css`margin: 0;`}>{classConfig?.meta.title ?? 'unknown class'}</H4>
+//         {proposalProperties}
+//       </div>
+// 
+//       <div css={css`flex: 1; overflow-y: auto;`}>
+//         {itemView}
+//       </div>
+//     </div>
+//   );
+// };
+// 
+// export default ProposalDetails;
+//# sourceMappingURL=Proposal.js.map