@cratis/scene.blueprint.default 4.36.0 → 4.37.0

package/dist/cjs/foundation/PermissionMatrix.js

@@ -0,0 +1,136 @@
+'use strict';
+
+var jsxRuntime = require('react/jsx-runtime');
+var react = require('react');
+var scene_react = require('@cratis/scene.react');
+var ComponentState = require('./ComponentState.js');
+var FoundationIcon = require('./FoundationIcon.js');
+var foundationStrings = require('./foundationStrings.js');
+var permissionModel = require('./permissionModel.js');
+var PermissionRule = require('./PermissionRule.js');
+var StateFrame = require('./StateFrame.js');
+
+/**
+ * The `permissionMatrix` component: roles across, permissions down, a checkbox where they meet.
+ *
+ * `roles` and `permissions` (optionally grouped) give the axes and `grants` - rows of `role` and `permission` - what is held; a grant of a role
+ * or permission that does not exist is ignored. Each box is named in words ("Grant Edit deals to Sales") and every header is a real header
+ * cell, so a screen reader announces the row and column of the box it is on. Changes are published as the `value` output - the grants,
+ * in the same shape - for the screen to save. With `editPermission` not enabled the matrix is read-only and each cell says "Allowed" or
+ * "Not allowed" in words and by icon. Wide matrices scroll sideways inside a keyboard-focusable region, keeping the permission column in view.
+ */ function PermissionMatrix({ element, interactions, bindingOutputs }) {
+    const roles = react.useMemo(()=>permissionModel.readRoles(element.properties.roles), [
+        element.properties.roles
+    ]);
+    const permissions = react.useMemo(()=>permissionModel.readPermissions(element.properties.permissions), [
+        element.properties.permissions
+    ]);
+    const supplied = react.useMemo(()=>permissionModel.readGrants(element.properties.grants, roles, permissions), [
+        element.properties.grants,
+        roles,
+        permissions
+    ]);
+    const suppliedKey = JSON.stringify(supplied);
+    const [grants, setGrants] = react.useState(supplied);
+    const strings = foundationStrings.readFoundationStrings(element);
+    const state = ComponentState.readComponentState(element, roles.length > 0 && permissions.length > 0);
+    const readOnly = PermissionRule.readPermissionRule(element, 'editPermission') !== 'enabled';
+    const sections = react.useMemo(()=>permissionModel.sectionsOf(permissions), [
+        permissions
+    ]);
+    react.useEffect(()=>setGrants(supplied), [
+        suppliedKey
+    ]);
+    scene_react.useValueOutput(bindingOutputs, grants);
+    return /*#__PURE__*/ jsxRuntime.jsx(StateFrame.FoundationFrame, {
+        element: element,
+        interactions: interactions,
+        name: "permission-matrix",
+        state: state,
+        skeleton: [
+            100,
+            100,
+            100,
+            100
+        ],
+        children: (state === ComponentState.ComponentState.Ready || state === ComponentState.ComponentState.Partial) && /*#__PURE__*/ jsxRuntime.jsx("div", {
+            className: "foundation-matrix-scroll",
+            role: "region",
+            tabIndex: 0,
+            "aria-label": strings.matrixScroll,
+            children: /*#__PURE__*/ jsxRuntime.jsxs("table", {
+                className: "foundation-matrix",
+                children: [
+                    /*#__PURE__*/ jsxRuntime.jsx("thead", {
+                        children: /*#__PURE__*/ jsxRuntime.jsxs("tr", {
+                            children: [
+                                /*#__PURE__*/ jsxRuntime.jsx("th", {
+                                    scope: "col",
+                                    children: strings.matrixPermission
+                                }),
+                                roles.map((role)=>/*#__PURE__*/ jsxRuntime.jsx("th", {
+                                        scope: "col",
+                                        children: role.label
+                                    }, role.id))
+                            ]
+                        })
+                    }),
+                    /*#__PURE__*/ jsxRuntime.jsx("tbody", {
+                        children: sections.map((section, index)=>/*#__PURE__*/ jsxRuntime.jsxs(react.Fragment, {
+                                children: [
+                                    section.group && /*#__PURE__*/ jsxRuntime.jsx("tr", {
+                                        className: "foundation-matrix-group",
+                                        children: /*#__PURE__*/ jsxRuntime.jsx("th", {
+                                            scope: "colgroup",
+                                            colSpan: roles.length + 1,
+                                            children: section.group
+                                        })
+                                    }),
+                                    section.permissions.map((permission)=>/*#__PURE__*/ jsxRuntime.jsxs("tr", {
+                                            children: [
+                                                /*#__PURE__*/ jsxRuntime.jsx("th", {
+                                                    scope: "row",
+                                                    children: permission.label
+                                                }),
+                                                roles.map((role)=>{
+                                                    const granted = permissionModel.isGranted(grants, role.id, permission.id);
+                                                    return /*#__PURE__*/ jsxRuntime.jsx("td", {
+                                                        "data-granted": granted,
+                                                        children: readOnly ? /*#__PURE__*/ jsxRuntime.jsxs("span", {
+                                                            className: "foundation-matrix-state",
+                                                            children: [
+                                                                /*#__PURE__*/ jsxRuntime.jsx(FoundationIcon.FoundationIcon, {
+                                                                    name: granted ? 'check' : 'minus'
+                                                                }),
+                                                                /*#__PURE__*/ jsxRuntime.jsx("span", {
+                                                                    className: "foundation-visually-hidden",
+                                                                    children: granted ? strings.matrixAllowed : strings.matrixDenied
+                                                                })
+                                                            ]
+                                                        }) : /*#__PURE__*/ jsxRuntime.jsx("input", {
+                                                            type: "checkbox",
+                                                            checked: granted,
+                                                            "aria-label": foundationStrings.formatText(strings.matrixGrant, {
+                                                                permission: permission.label,
+                                                                role: role.label
+                                                            }),
+                                                            onChange: (event)=>{
+                                                                setGrants(permissionModel.setGrant(grants, role.id, permission.id, event.target.checked));
+                                                                interactions?.onChange?.();
+                                                            }
+                                                        })
+                                                    }, role.id);
+                                                })
+                                            ]
+                                        }, permission.id))
+                                ]
+                            }, section.group ?? `ungrouped-${index}`))
+                    })
+                ]
+            })
+        })
+    });
+}
+
+exports.PermissionMatrix = PermissionMatrix;
+//# sourceMappingURL=PermissionMatrix.js.map

package/dist/cjs/foundation/PermissionMatrix.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"PermissionMatrix.js","sources":["../../../foundation/PermissionMatrix.tsx"],"sourcesContent":["// Copyright (c) Cratis. All rights reserved.\n// Licensed under the MIT license. See LICENSE file in the project root for full license information.\n\nimport { Fragment, useEffect, useMemo, useState } from 'react';\nimport { RegisteredComponentProps, useValueOutput } from '@cratis/scene.react';\nimport { ComponentState, readComponentState } from './ComponentState';\nimport { FoundationIcon } from './FoundationIcon';\nimport { formatText, readFoundationStrings } from './foundationStrings';\nimport { isGranted, MatrixGrant, readGrants, readPermissions, readRoles, sectionsOf, setGrant } from './permissionModel';\nimport { readPermissionRule } from './PermissionRule';\nimport { FoundationFrame } from './StateFrame';\n\n/**\n * The `permissionMatrix` component: roles across, permissions down, a checkbox where they meet.\n *\n * `roles` and `permissions` (optionally grouped) give the axes and `grants` - rows of `role` and `permission` - what is held; a grant of a role\n * or permission that does not exist is ignored. Each box is named in words (\"Grant Edit deals to Sales\") and every header is a real header\n * cell, so a screen reader announces the row and column of the box it is on. Changes are published as the `value` output - the grants,\n * in the same shape - for the screen to save. With `editPermission` not enabled the matrix is read-only and each cell says \"Allowed\" or\n * \"Not allowed\" in words and by icon. Wide matrices scroll sideways inside a keyboard-focusable region, keeping the permission column in view.\n */\nexport function PermissionMatrix({ element, interactions, bindingOutputs }: RegisteredComponentProps) {\n    const roles = useMemo(() => readRoles(element.properties.roles), [element.properties.roles]);\n    const permissions = useMemo(() => readPermissions(element.properties.permissions), [element.properties.permissions]);\n    const supplied = useMemo(() => readGrants(element.properties.grants, roles, permissions), [element.properties.grants, roles, permissions]);\n    const suppliedKey = JSON.stringify(supplied);\n    const [grants, setGrants] = useState<MatrixGrant[]>(supplied);\n    const strings = readFoundationStrings(element);\n    const state = readComponentState(element, roles.length > 0 && permissions.length > 0);\n    const readOnly = readPermissionRule(element, 'editPermission') !== 'enabled';\n    const sections = useMemo(() => sectionsOf(permissions), [permissions]);\n\n    useEffect(() => setGrants(supplied), [suppliedKey]);\n    useValueOutput(bindingOutputs, grants);\n\n    return (\n        <FoundationFrame element={element} interactions={interactions} name='permission-matrix' state={state} skeleton={[100, 100, 100, 100]}>\n            {(state === ComponentState.Ready || state === ComponentState.Partial) && (\n                <div className='foundation-matrix-scroll' role='region' tabIndex={0} aria-label={strings.matrixScroll}>\n                    <table className='foundation-matrix'>\n                        <thead>\n                            <tr>\n                                <th scope='col'>{strings.matrixPermission}</th>\n                                {roles.map(role => <th key={role.id} scope='col'>{role.label}</th>)}\n                            </tr>\n                        </thead>\n                        <tbody>\n                            {sections.map((section, index) => (\n                                <Fragment key={section.group ?? `ungrouped-${index}`}>\n                                    {section.group && (\n                                        <tr className='foundation-matrix-group'><th scope='colgroup' colSpan={roles.length + 1}>{section.group}</th></tr>\n                                    )}\n                                    {section.permissions.map(permission => (\n                                        <tr key={permission.id}>\n                                            <th scope='row'>{permission.label}</th>\n                                            {roles.map(role => {\n                                                const granted = isGranted(grants, role.id, permission.id);\n                                                return (\n                                                    <td key={role.id} data-granted={granted}>\n                                                        {readOnly ? (\n                                                            <span className='foundation-matrix-state'>\n                                                                <FoundationIcon name={granted ? 'check' : 'minus'} />\n                                                                <span className='foundation-visually-hidden'>{granted ? strings.matrixAllowed : strings.matrixDenied}</span>\n                                                            </span>\n                                                        ) : (\n                                                            <input type='checkbox' checked={granted} aria-label={formatText(strings.matrixGrant, { permission: permission.label, role: role.label })}\n                                                                onChange={event => { setGrants(setGrant(grants, role.id, permission.id, event.target.checked)); interactions?.onChange?.(); }} />\n                                                        )}\n                                                    </td>\n                                                );\n                                            })}\n                                        </tr>\n                                    ))}\n                                </Fragment>\n                            ))}\n                        </tbody>\n                    </table>\n                </div>\n            )}\n        </FoundationFrame>\n    );\n}\n"],"names":["PermissionMatrix","element","interactions","bindingOutputs","roles","useMemo","readRoles","properties","permissions","readPermissions","supplied","readGrants","grants","suppliedKey","JSON","stringify","setGrants","useState","strings","readFoundationStrings","state","readComponentState","length","readOnly","readPermissionRule","sections","sectionsOf","useEffect","useValueOutput","_jsx","FoundationFrame","name","skeleton","ComponentState","Ready","Partial","div","className","role","tabIndex","aria-label","matrixScroll","_jsxs","table","thead","tr","th","scope","matrixPermission","map","label","id","tbody","section","index","Fragment","group","colSpan","permission","granted","isGranted","td","data-granted","span","FoundationIcon","matrixAllowed","matrixDenied","input","type","checked","formatText","matrixGrant","onChange","event","setGrant","target"],"mappings":"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"}

package/dist/cjs/foundation/approvalModel.js

@@ -0,0 +1,87 @@
+'use strict';
+
+// Copyright (c) Cratis. All rights reserved.
+// Licensed under the MIT license. See LICENSE file in the project root for full license information.
+/** Where one step of an approval chain stands. */ var ApprovalState = /*#__PURE__*/ function(ApprovalState) {
+    ApprovalState["Pending"] = "pending";
+    ApprovalState["Current"] = "current";
+    ApprovalState["Approved"] = "approved";
+    ApprovalState["Rejected"] = "rejected";
+    ApprovalState["Skipped"] = "skipped";
+    return ApprovalState;
+}({});
+/** How the chain as a whole stands. */ var ChainOutcome = /*#__PURE__*/ function(ChainOutcome) {
+    /** Every step approved. */ ChainOutcome["Approved"] = "approved";
+    /** A step rejected: the chain stops there. */ ChainOutcome["Rejected"] = "rejected";
+    /** At least one step is decided and the rest are waiting. */ ChainOutcome["InProgress"] = "inProgress";
+    /** Nothing decided yet. */ ChainOutcome["Pending"] = "pending";
+    return ChainOutcome;
+}({});
+/** Reads steps out of a property value, dropping entries without a label; an unknown state is pending. */ function readSteps(value) {
+    if (!Array.isArray(value)) return [];
+    return value.flatMap((entry)=>{
+        if (typeof entry !== 'object' || entry === null || Array.isArray(entry)) return [];
+        const { label, approver, state, at, comment } = entry;
+        if (typeof label !== 'string' || label.length === 0) return [];
+        return [
+            {
+                label,
+                state: Object.values(ApprovalState).includes(state) ? state : "pending",
+                ...typeof approver === 'string' ? {
+                    approver
+                } : {},
+                ...typeof at === 'string' ? {
+                    at
+                } : {},
+                ...typeof comment === 'string' && comment.length > 0 ? {
+                    comment
+                } : {}
+            }
+        ];
+    });
+}
+/**
+ * Applies the chain's rules to the steps as written.
+ *
+ * A rejection stops the chain: every step after the first rejected one has not been reached, so it is drawn skipped however it was written.
+ * With no step marked current and no rejection, the first step that is not yet decided is the current one - the person the chain is waiting
+ * for - so a chain written only as approved and pending steps still says whose turn it is. Only one step is ever current.
+ */ function effectiveSteps(steps) {
+    const rejected = steps.findIndex((step)=>step.state === "rejected");
+    const explicitCurrent = steps.findIndex((step)=>step.state === "current");
+    const waiting = rejected >= 0 ? -1 : explicitCurrent >= 0 ? explicitCurrent : steps.findIndex((step)=>step.state === "pending");
+    return steps.map((step, index)=>{
+        if (rejected >= 0 && index > rejected) return {
+            ...step,
+            state: "skipped",
+            notReached: true
+        };
+        if (step.state === "current" && index !== waiting) return {
+            ...step,
+            state: "pending",
+            notReached: false
+        };
+        if (index === waiting && step.state === "pending") return {
+            ...step,
+            state: "current",
+            notReached: false
+        };
+        return {
+            ...step,
+            notReached: false
+        };
+    });
+}
+/** The state of the chain as a whole. A skipped step counts as decided, because it was never going to be asked. */ function chainOutcome(steps) {
+    const effective = effectiveSteps(steps);
+    if (effective.some((step)=>step.state === "rejected")) return "rejected";
+    if (effective.length > 0 && effective.every((step)=>step.state === "approved" || step.state === "skipped")) return "approved";
+    return effective.some((step)=>step.state === "approved") ? "inProgress" : "pending";
+}
+
+exports.ApprovalState = ApprovalState;
+exports.ChainOutcome = ChainOutcome;
+exports.chainOutcome = chainOutcome;
+exports.effectiveSteps = effectiveSteps;
+exports.readSteps = readSteps;
+//# sourceMappingURL=approvalModel.js.map

package/dist/cjs/foundation/approvalModel.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"approvalModel.js","sources":["../../../foundation/approvalModel.ts"],"sourcesContent":["// Copyright (c) Cratis. All rights reserved.\n// Licensed under the MIT license. See LICENSE file in the project root for full license information.\n\n/** Where one step of an approval chain stands. */\nexport enum ApprovalState {\n    Pending = 'pending',\n    Current = 'current',\n    Approved = 'approved',\n    Rejected = 'rejected',\n    Skipped = 'skipped',\n}\n\n/** One step of an approval chain: who decides, and what they decided. */\nexport interface ApprovalStep {\n    label: string;\n    approver?: string;\n    state: ApprovalState;\n    at?: string;\n    comment?: string;\n}\n\n/** A step as it is drawn, after the chain's own rules are applied. */\nexport interface EffectiveStep extends ApprovalStep {\n    /** True when an earlier rejection stopped the chain before this step was reached. */\n    notReached: boolean;\n}\n\n/** How the chain as a whole stands. */\nexport enum ChainOutcome {\n    /** Every step approved. */\n    Approved = 'approved',\n\n    /** A step rejected: the chain stops there. */\n    Rejected = 'rejected',\n\n    /** At least one step is decided and the rest are waiting. */\n    InProgress = 'inProgress',\n\n    /** Nothing decided yet. */\n    Pending = 'pending',\n}\n\n/** Reads steps out of a property value, dropping entries without a label; an unknown state is pending. */\nexport function readSteps(value: unknown): ApprovalStep[] {\n    if (!Array.isArray(value)) return [];\n\n    return value.flatMap((entry): ApprovalStep[] => {\n        if (typeof entry !== 'object' || entry === null || Array.isArray(entry)) return [];\n        const { label, approver, state, at, comment } = entry as Record<string, unknown>;\n        if (typeof label !== 'string' || label.length === 0) return [];\n\n        return [{\n            label,\n            state: (Object.values(ApprovalState) as string[]).includes(state as string) ? (state as ApprovalState) : ApprovalState.Pending,\n            ...(typeof approver === 'string' ? { approver } : {}),\n            ...(typeof at === 'string' ? { at } : {}),\n            ...(typeof comment === 'string' && comment.length > 0 ? { comment } : {}),\n        }];\n    });\n}\n\n/**\n * Applies the chain's rules to the steps as written.\n *\n * A rejection stops the chain: every step after the first rejected one has not been reached, so it is drawn skipped however it was written.\n * With no step marked current and no rejection, the first step that is not yet decided is the current one - the person the chain is waiting\n * for - so a chain written only as approved and pending steps still says whose turn it is. Only one step is ever current.\n */\nexport function effectiveSteps(steps: ApprovalStep[]): EffectiveStep[] {\n    const rejected = steps.findIndex(step => step.state === ApprovalState.Rejected);\n    const explicitCurrent = steps.findIndex(step => step.state === ApprovalState.Current);\n    const waiting = rejected >= 0 ? -1 : explicitCurrent >= 0 ? explicitCurrent : steps.findIndex(step => step.state === ApprovalState.Pending);\n\n    return steps.map((step, index) => {\n        if (rejected >= 0 && index > rejected) return { ...step, state: ApprovalState.Skipped, notReached: true };\n        if (step.state === ApprovalState.Current && index !== waiting) return { ...step, state: ApprovalState.Pending, notReached: false };\n        if (index === waiting && step.state === ApprovalState.Pending) return { ...step, state: ApprovalState.Current, notReached: false };\n        return { ...step, notReached: false };\n    });\n}\n\n/** The state of the chain as a whole. A skipped step counts as decided, because it was never going to be asked. */\nexport function chainOutcome(steps: ApprovalStep[]): ChainOutcome {\n    const effective = effectiveSteps(steps);\n    if (effective.some(step => step.state === ApprovalState.Rejected)) return ChainOutcome.Rejected;\n    if (effective.length > 0 && effective.every(step => step.state === ApprovalState.Approved || step.state === ApprovalState.Skipped)) return ChainOutcome.Approved;\n    return effective.some(step => step.state === ApprovalState.Approved) ? ChainOutcome.InProgress : ChainOutcome.Pending;\n}\n"],"names":["ApprovalState","ChainOutcome","readSteps","value","Array","isArray","flatMap","entry","label","approver","state","at","comment","length","Object","values","includes","effectiveSteps","steps","rejected","findIndex","step","explicitCurrent","waiting","map","index","notReached","chainOutcome","effective","some","every"],"mappings":"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"}

package/dist/cjs/foundation/foundationComponentMetadata.js

@@ -88,6 +88,27 @@ var ComponentName = require('../ComponentName.js');
         'files',
         'drop zone',
         'documents'
+    ]),
+    [ComponentName.ComponentName.ApprovalChainStepper]: scene_react.componentMetadata('Approval chain', scene_model.ComponentCategory.Navigation, 'workflow', [
+        'approvals',
+        'steps',
+        'workflow',
+        'sign off',
+        'stepper'
+    ]),
+    [ComponentName.ComponentName.OrgTree]: scene_react.componentMetadata('Org tree', scene_model.ComponentCategory.DataDisplay, 'network', [
+        'organization',
+        'hierarchy',
+        'org chart',
+        'reports to',
+        'tree'
+    ]),
+    [ComponentName.ComponentName.PermissionMatrix]: scene_react.componentMetadata('Permission matrix', scene_model.ComponentCategory.Input, 'shield-check', [
+        'roles',
+        'permissions',
+        'access',
+        'grants',
+        'rbac'
     ])
 };
 

package/dist/cjs/foundation/foundationComponentMetadata.js.map

@@ -1 +1 @@
-{"version":3,"file":"foundationComponentMetadata.js","sources":["../../../foundation/foundationComponentMetadata.ts"],"sourcesContent":["// Copyright (c) Cratis. All rights reserved.\n// Licensed under the MIT license. See LICENSE file in the project root for full license information.\n\nimport { ComponentCategory } from '@cratis/scene.model';\nimport { ComponentMetadata, componentMetadata as m } from '@cratis/scene.react';\nimport { ComponentName } from '../ComponentName';\n\n/**\n * The category, icon, keywords and picker badge of every foundation component (CMP1), keyed by bare component name.\n * The names are those of `ComponentName`; the metadata of the rest of the package lives in `defaultBlueprintComponentMetadata`.\n */\nexport const foundationComponentMetadata: Record<string, ComponentMetadata> = {\n    [ComponentName.EmptyState]: m('Empty state', ComponentCategory.Feedback, 'inbox', ['no data', 'nothing', 'blank slate', 'zero state']),\n    [ComponentName.StatCard]: m('Stat card', ComponentCategory.DataDisplay, 'gauge', ['kpi', 'metric', 'figure', 'number', 'dashboard']),\n    [ComponentName.TrendChip]: m('Trend chip', ComponentCategory.DataDisplay, 'trending-up', ['delta', 'change', 'arrow', 'comparison']),\n    [ComponentName.StatusChip]: m('Status chip', ComponentCategory.DataDisplay, 'badge-check', ['badge', 'state', 'tag', 'label']),\n    [ComponentName.ChartWrapper]: m('Chart', ComponentCategory.DataDisplay, 'chart-line', ['graph', 'line', 'bar', 'stacked', 'donut', 'pie', 'funnel', 'plot']),\n    [ComponentName.FilterBuilder]: m('Filter builder', ComponentCategory.Input, 'list-filter', ['filter', 'query', 'conditions', 'and or', 'search']),\n    [ComponentName.ColumnChooser]: m('Column chooser', ComponentCategory.Actions, 'columns-3', ['columns', 'fields', 'show hide', 'table']),\n    [ComponentName.SavedViewsMenu]: m('Saved views menu', ComponentCategory.Actions, 'bookmark', ['views', 'presets', 'saved filters']),\n    [ComponentName.ChecklistSection]: m('Checklist', ComponentCategory.DataDisplay, 'list-checks', ['tasks', 'todo', 'onboarding', 'progress', 'steps']),\n    [ComponentName.ActivityFeed]: m('Activity feed', ComponentCategory.DataDisplay, 'activity', ['timeline', 'history', 'comments', 'audit', 'log']),\n    [ComponentName.AvatarStack]: m('Avatar stack', ComponentCategory.DataDisplay, 'users', ['people', 'members', 'assignees', 'team']),\n    [ComponentName.FileUploader]: m('File uploader', ComponentCategory.Input, 'upload', ['attachments', 'files', 'drop zone', 'documents']),\n};\n"],"names":["foundationComponentMetadata","ComponentName","EmptyState","m","ComponentCategory","Feedback","StatCard","DataDisplay","TrendChip","StatusChip","ChartWrapper","FilterBuilder","Input","ColumnChooser","Actions","SavedViewsMenu","ChecklistSection","ActivityFeed","AvatarStack","FileUploader"],"mappings":"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"}
+{"version":3,"file":"foundationComponentMetadata.js","sources":["../../../foundation/foundationComponentMetadata.ts"],"sourcesContent":["// Copyright (c) Cratis. All rights reserved.\n// Licensed under the MIT license. See LICENSE file in the project root for full license information.\n\nimport { ComponentCategory } from '@cratis/scene.model';\nimport { ComponentMetadata, componentMetadata as m } from '@cratis/scene.react';\nimport { ComponentName } from '../ComponentName';\n\n/**\n * The category, icon, keywords and picker badge of every foundation component (CMP1), keyed by bare component name.\n * The names are those of `ComponentName`; the metadata of the rest of the package lives in `defaultBlueprintComponentMetadata`.\n */\nexport const foundationComponentMetadata: Record<string, ComponentMetadata> = {\n    [ComponentName.EmptyState]: m('Empty state', ComponentCategory.Feedback, 'inbox', ['no data', 'nothing', 'blank slate', 'zero state']),\n    [ComponentName.StatCard]: m('Stat card', ComponentCategory.DataDisplay, 'gauge', ['kpi', 'metric', 'figure', 'number', 'dashboard']),\n    [ComponentName.TrendChip]: m('Trend chip', ComponentCategory.DataDisplay, 'trending-up', ['delta', 'change', 'arrow', 'comparison']),\n    [ComponentName.StatusChip]: m('Status chip', ComponentCategory.DataDisplay, 'badge-check', ['badge', 'state', 'tag', 'label']),\n    [ComponentName.ChartWrapper]: m('Chart', ComponentCategory.DataDisplay, 'chart-line', ['graph', 'line', 'bar', 'stacked', 'donut', 'pie', 'funnel', 'plot']),\n    [ComponentName.FilterBuilder]: m('Filter builder', ComponentCategory.Input, 'list-filter', ['filter', 'query', 'conditions', 'and or', 'search']),\n    [ComponentName.ColumnChooser]: m('Column chooser', ComponentCategory.Actions, 'columns-3', ['columns', 'fields', 'show hide', 'table']),\n    [ComponentName.SavedViewsMenu]: m('Saved views menu', ComponentCategory.Actions, 'bookmark', ['views', 'presets', 'saved filters']),\n    [ComponentName.ChecklistSection]: m('Checklist', ComponentCategory.DataDisplay, 'list-checks', ['tasks', 'todo', 'onboarding', 'progress', 'steps']),\n    [ComponentName.ActivityFeed]: m('Activity feed', ComponentCategory.DataDisplay, 'activity', ['timeline', 'history', 'comments', 'audit', 'log']),\n    [ComponentName.AvatarStack]: m('Avatar stack', ComponentCategory.DataDisplay, 'users', ['people', 'members', 'assignees', 'team']),\n    [ComponentName.FileUploader]: m('File uploader', ComponentCategory.Input, 'upload', ['attachments', 'files', 'drop zone', 'documents']),\n    [ComponentName.ApprovalChainStepper]: m('Approval chain', ComponentCategory.Navigation, 'workflow', ['approvals', 'steps', 'workflow', 'sign off', 'stepper']),\n    [ComponentName.OrgTree]: m('Org tree', ComponentCategory.DataDisplay, 'network', ['organization', 'hierarchy', 'org chart', 'reports to', 'tree']),\n    [ComponentName.PermissionMatrix]: m('Permission matrix', ComponentCategory.Input, 'shield-check', ['roles', 'permissions', 'access', 'grants', 'rbac']),\n};\n"],"names":["foundationComponentMetadata","ComponentName","EmptyState","m","ComponentCategory","Feedback","StatCard","DataDisplay","TrendChip","StatusChip","ChartWrapper","FilterBuilder","Input","ColumnChooser","Actions","SavedViewsMenu","ChecklistSection","ActivityFeed","AvatarStack","FileUploader","ApprovalChainStepper","Navigation","OrgTree","PermissionMatrix"],"mappings":"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"}

package/dist/cjs/foundation/foundationDescriptors.js

@@ -5,6 +5,7 @@ var scene_react = require('@cratis/scene.react');
 var ComponentName = require('../ComponentName.js');
 var packageName = require('../packageName.js');
 var activityModel = require('./activityModel.js');
+var approvalModel = require('./approvalModel.js');
 var chartGeometry = require('./chartGeometry.js');
 var ComponentState = require('./ComponentState.js');
 var filterModel = require('./filterModel.js');
@@ -503,6 +504,123 @@ const formats = {
             scene_react.valueOutputProperty(scene_model.PropertyValueType.Json, 'The files chosen - name, size, type and status - published as they change.'),
             ...standardStateProperties.filter((property)=>property.path !== 'actionPermission')
         ]
+    },
+    {
+        component: key(ComponentName.ComponentName.ApprovalChainStepper),
+        displayName: 'Approval chain',
+        description: 'The steps a request goes through, who decides each and where it stands. A rejection stops the chain; the first undecided step is the current one.',
+        properties: [
+            {
+                ...list('steps', 'Steps', 'Data', 'Step', [
+                    text('label', 'Step', 'Content', undefined, {
+                        constraints: {
+                            required: true
+                        }
+                    }),
+                    text('approver', 'Approver', 'Data'),
+                    choice('state', 'State', 'Data', {
+                        [approvalModel.ApprovalState.Pending]: 'Pending',
+                        [approvalModel.ApprovalState.Current]: 'Awaiting decision',
+                        [approvalModel.ApprovalState.Approved]: 'Approved',
+                        [approvalModel.ApprovalState.Rejected]: 'Rejected',
+                        [approvalModel.ApprovalState.Skipped]: 'Skipped'
+                    }, approvalModel.ApprovalState.Pending),
+                    text('at', 'Decided at', 'Data', 'An ISO 8601 date and time.'),
+                    text('comment', 'Comment', 'Data')
+                ], 'The approvers in order.'),
+                acceptedBindingKinds: bindable
+            },
+            choice('orientation', 'Orientation', 'Appearance', {
+                horizontal: 'Horizontal',
+                vertical: 'Vertical'
+            }, 'horizontal', 'A phone always reads vertically.'),
+            ...standardStateProperties
+        ]
+    },
+    {
+        component: key(ComponentName.ComponentName.OrgTree),
+        displayName: 'Org tree',
+        description: 'An organization as an expandable tree built from rows of who reports to whom. Publishes the selected id as the value output.',
+        properties: [
+            {
+                ...list('nodes', 'People', 'Data', 'Person', [
+                    text('id', 'Id', 'Data', undefined, {
+                        constraints: {
+                            required: true
+                        },
+                        editorKind: scene_model.PropertyEditorKind.Field
+                    }),
+                    text('label', 'Name', 'Data', undefined, {
+                        editorKind: scene_model.PropertyEditorKind.Field
+                    }),
+                    text('title', 'Title', 'Data', undefined, {
+                        editorKind: scene_model.PropertyEditorKind.Field
+                    }),
+                    text('parentId', 'Reports to', 'Data', 'The id of the person above; empty for the top.', {
+                        editorKind: scene_model.PropertyEditorKind.Field
+                    })
+                ], 'One row per person or unit.'),
+                acceptedBindingKinds: bindable
+            },
+            number('expandedDepth', 'Levels open at first', 'Appearance', undefined, {
+                default: 2,
+                constraints: {
+                    minimum: 1,
+                    integer: true
+                }
+            }),
+            text('selected', 'Selected', 'Data', 'The id of the selected node; bind it to start from one.'),
+            scene_react.valueOutputProperty(scene_model.PropertyValueType.String, 'The id of the selected node, published as the user selects.'),
+            ...standardStateProperties
+        ]
+    },
+    {
+        component: key(ComponentName.ComponentName.PermissionMatrix),
+        displayName: 'Permission matrix',
+        description: 'Roles across, permissions down, a checkbox where they meet. Publishes the grants as the value output.',
+        properties: [
+            {
+                ...list('roles', 'Roles', 'Data', 'Role', [
+                    text('id', 'Id', 'Data', undefined, {
+                        constraints: {
+                            required: true
+                        }
+                    }),
+                    text('label', 'Name', 'Data')
+                ], 'The columns.'),
+                acceptedBindingKinds: bindable
+            },
+            {
+                ...list('permissions', 'Permissions', 'Data', 'Permission', [
+                    text('id', 'Id', 'Data', undefined, {
+                        constraints: {
+                            required: true
+                        }
+                    }),
+                    text('label', 'Name', 'Data'),
+                    text('group', 'Group', 'Data', 'A heading the permission is listed under.')
+                ], 'The rows.'),
+                acceptedBindingKinds: bindable
+            },
+            {
+                ...list('grants', 'Grants', 'Data', 'Grant', [
+                    text('role', 'Role', 'Data', 'The id of a role.', {
+                        constraints: {
+                            required: true
+                        }
+                    }),
+                    text('permission', 'Permission', 'Data', 'The id of a permission.', {
+                        constraints: {
+                            required: true
+                        }
+                    })
+                ], 'What each role holds.'),
+                acceptedBindingKinds: bindable
+            },
+            rule('editPermission', 'Edit permission', 'Enabled lets the user change grants; otherwise the matrix is read-only.'),
+            scene_react.valueOutputProperty(scene_model.PropertyValueType.Json, 'The grants as the user has changed them: rows of role and permission, published as they change.'),
+            ...standardStateProperties
+        ]
     }
 ];