@aglyn/aglyn 1.0.0-beta.269 → 1.0.0-beta.270

package/src/lib/app-utils/native-nav.js

@@ -0,0 +1,741 @@
+/**
+ * @license
+ * Copyright 2026 Aglyn LLC
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *   http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */ /**
+ * THE NATIVE APPS' NAVIGATION, AS DATA (AGL-3943).
+ *
+ * One manifest both shells draw (docs/mobile/native-navigation.md): the
+ * sidebar for the whole workspace, the sidebar inside one site, and the two
+ * settings modes (the workspace's, and the site's, which merges the
+ * console's Setup and Admin). Zach chose the site's groups on 2026-10-18:
+ * an Overview row, Starred, Website, Sell, Customers, More, Site settings.
+ *
+ * Every row names:
+ * - the console's word for it (`label`), held to the console by
+ *   `apps/console/specs/native-nav-manifest.spec.ts`, which reads the
+ *   console's own tabs, sections and plugin declarations;
+ * - one icon per idea, an SF Symbol and a Material Symbol;
+ * - the native screen it opens (a plugin's declared screen, a core screen
+ *   spec, a site platform screen or a `shell.*` destination);
+ * - the plugin it belongs to, so it hides when that plugin is off for the
+ *   workspace or the site.
+ *
+ * The core's own rows (Home, Overview, Sites, Pages, Media, the settings
+ * modes) are here; a plugin's rows are its own, in
+ * `libs/plugins/<plugin>/src/lib/native-nav.ts` (`NATIVE_NAV_ROWS`), placed
+ * into a list's group by `order` (docs/PACKAGES.md rule 3: the core never
+ * names a plugin). `generate:native-contracts` assembles the two
+ * (`assembleNativeNav`) into the manifest the apps read,
+ * `ContractValues.nativeNavManifest`.
+ *
+ * NO IMPORTS, on purpose: the native apps read this through the generated
+ * contracts, so it must stay a plain module.
+ */ /** A list the shells draw. */ import { _ as _extends } from "@swc/helpers/_/_extends";
+/** The shells' own destinations. */ export const NATIVE_NAV_SHELL_SCREENS = [
+    'shell.home',
+    'shell.analytics',
+    'shell.workspaceSettings',
+    'shell.siteSettings'
+];
+/** An icon pair, for the rows here and in the plugins. */ export const nativeNavIcon = (apple, android)=>({
+        apple,
+        android
+    });
+/** A console reference, for the rows here and in the plugins. */ export const nativeNavRef = (surface, id)=>({
+        surface,
+        id
+    });
+/** A section of a plugin hub, at the scope its row stands in. */ export function nativeNavHubSection(scope, href, id, label, screen, extra = {}) {
+    return _extends({
+        id,
+        label,
+        screen
+    }, extra, {
+        console: nativeNavRef(scope === 'org' ? 'orgPluginSection' : 'hostPluginSection', `${href}/${id}`)
+    });
+}
+const icon = nativeNavIcon;
+const ref = nativeNavRef;
+const ICONS = {
+    home: icon('house', 'home'),
+    overview: icon('chart.bar', 'bar_chart'),
+    sites: icon('globe', 'public'),
+    pages: icon('doc.text', 'description'),
+    media: icon('photo.on.rectangle', 'photo_library'),
+    settings: icon('gearshape', 'settings'),
+    emails: icon('envelope', 'mail'),
+    members: icon('person.2', 'group'),
+    roles: icon('person.badge.key', 'admin_panel_settings'),
+    activity: icon('clock.arrow.circlepath', 'history'),
+    plan: icon('creditcard', 'credit_card'),
+    usage: icon('gauge.with.dots.needle.33percent', 'data_usage'),
+    invoices: icon('doc.plaintext', 'receipt_long'),
+    billingSettings: icon('slider.horizontal.3', 'tune'),
+    plugins: icon('puzzlepiece.extension', 'extension'),
+    branding: icon('paintbrush', 'brush'),
+    sso: icon('key.viewfinder', 'vpn_key'),
+    profile: icon('building.2', 'apartment'),
+    apiKeys: icon('key', 'key'),
+    integrations: icon('point.3.connected.trianglepath.dotted', 'hub'),
+    privacy: icon('hand.raised', 'privacy_tip'),
+    holds: icon('exclamationmark.triangle', 'warning'),
+    importExport: icon('arrow.up.arrow.down', 'sync'),
+    ownership: icon('person.crop.circle.badge.checkmark', 'manage_accounts'),
+    delete: icon('trash', 'delete_forever'),
+    details: icon('info.circle', 'info'),
+    business: icon('briefcase', 'business'),
+    seo: icon('magnifyingglass', 'travel_explore'),
+    tracking: icon('chart.line.uptrend.xyaxis', 'query_stats'),
+    theme: icon('paintpalette', 'palette'),
+    domain: icon('link', 'domain'),
+    security: icon('lock', 'security'),
+    errorPages: icon('exclamationmark.circle', 'error_outline'),
+    backup: icon('square.and.arrow.down', 'backup')
+};
+const HOME_ROW = {
+    id: 'home',
+    label: 'Home',
+    icon: ICONS.home,
+    screen: 'shell.home',
+    order: 10,
+    console: ref('shell', 'home')
+};
+const WORKSPACE = {
+    id: 'workspace',
+    groups: [
+        {
+            id: 'top',
+            foldable: false,
+            rows: [
+                HOME_ROW
+            ]
+        },
+        {
+            id: 'starred',
+            label: 'Starred',
+            foldable: true,
+            dynamic: 'starred',
+            rows: []
+        },
+        {
+            id: 'workspace',
+            foldable: false,
+            rows: [
+                {
+                    id: 'sites',
+                    label: 'Sites',
+                    icon: ICONS.sites,
+                    screen: 'site.sites',
+                    order: 10,
+                    docs: '/getting-started/console-tour#the-sites-list',
+                    console: ref('orgTab', 'nav-tab-org-sites')
+                },
+                {
+                    id: 'media',
+                    label: 'Media',
+                    icon: ICONS.media,
+                    screen: 'site.media',
+                    order: 90,
+                    console: ref('orgTab', 'nav-tab-org-media')
+                }
+            ]
+        }
+    ]
+};
+const SITE = {
+    id: 'site',
+    groups: [
+        {
+            id: 'top',
+            foldable: false,
+            rows: [
+                HOME_ROW,
+                {
+                    id: 'overview',
+                    label: 'Overview',
+                    consoleLabel: 'Analytics',
+                    icon: ICONS.overview,
+                    screen: 'shell.analytics',
+                    order: 20,
+                    keywords: [
+                        'analytics',
+                        'traffic',
+                        'visitors'
+                    ],
+                    console: ref('hostTab', 'nav-tab-analytics')
+                }
+            ]
+        },
+        {
+            id: 'starred',
+            label: 'Starred',
+            foldable: true,
+            dynamic: 'starred',
+            rows: []
+        },
+        {
+            id: 'website',
+            label: 'Website',
+            foldable: true,
+            rows: [
+                {
+                    id: 'pages',
+                    label: 'Pages',
+                    icon: ICONS.pages,
+                    screen: 'site.pages',
+                    order: 10,
+                    sections: [
+                        {
+                            id: 'pages',
+                            label: 'Pages',
+                            screen: 'site.pages',
+                            console: ref('hostTab', 'nav-tab-screens')
+                        },
+                        {
+                            id: 'components',
+                            label: 'Components',
+                            screen: 'site.components',
+                            console: ref('hostTab', 'nav-tab-components')
+                        },
+                        {
+                            id: 'layouts',
+                            label: 'Layouts',
+                            screen: 'site.layouts',
+                            console: ref('hostTab', 'nav-tab-layouts')
+                        },
+                        {
+                            id: 'templates',
+                            label: 'Templates',
+                            screen: 'site.templates',
+                            console: ref('hostTab', 'nav-tab-templates')
+                        },
+                        {
+                            id: 'content',
+                            label: 'Content',
+                            screen: 'site.content',
+                            console: ref('hostTab', 'nav-tab-content')
+                        }
+                    ],
+                    console: ref('hostTab', 'nav-tab-screens')
+                },
+                {
+                    id: 'media',
+                    label: 'Media',
+                    icon: ICONS.media,
+                    screen: 'site.media',
+                    order: 20,
+                    console: ref('hostTab', 'nav-tab-media')
+                }
+            ]
+        },
+        {
+            id: 'sell',
+            label: 'Sell',
+            foldable: true,
+            rows: []
+        },
+        {
+            id: 'customers',
+            label: 'Customers',
+            foldable: true,
+            rows: []
+        },
+        {
+            id: 'more',
+            label: 'More',
+            foldable: true,
+            rows: []
+        },
+        {
+            id: 'settings',
+            foldable: false,
+            rows: [
+                {
+                    id: 'siteSettings',
+                    label: 'Site settings',
+                    icon: ICONS.settings,
+                    screen: 'shell.siteSettings',
+                    order: 10,
+                    console: ref('shell', 'siteSettings')
+                }
+            ]
+        }
+    ]
+};
+/** Each row's place, in the order written. */ const ordered = (rows)=>rows.map((row, index)=>{
+        var _row_order;
+        return _extends({}, row, {
+            order: (_row_order = row.order) != null ? _row_order : (index + 1) * 10
+        });
+    });
+/** The help page each settings hub's `help` prop names, the rows' docs. */ const HUB_DOCS = {
+    teamSection: '/workspace-and-billing/teams-and-roles/overview#team-page',
+    billingSection: '/workspace-and-billing/billing-and-plans/overview#billing-page',
+    orgSettingsSection: '/getting-started/console-tour#organization-settings',
+    hostAdminSection: '/getting-started/create-a-site#site-admin'
+};
+const setupRow = (id, label, rowIcon, description, keywords)=>_extends({
+        id,
+        label,
+        icon: rowIcon,
+        screen: id === 'theme' ? 'site.theme' : 'site.setup'
+    }, id === 'theme' ? {} : {
+        params: {
+            section: id
+        }
+    }, {
+        description
+    }, keywords ? {
+        keywords
+    } : {}, {
+        console: ref('setupSection', id)
+    });
+const adminRow = (id, label, rowIcon, screen, route)=>({
+        id,
+        label,
+        icon: rowIcon,
+        screen,
+        requiresHostAdmin: true,
+        docs: HUB_DOCS.hostAdminSection,
+        console: ref('hostAdminSection', route)
+    });
+const settingsRow = (surface, id, label, rowIcon, screen, route, extra = {})=>_extends({
+        id,
+        label,
+        icon: rowIcon,
+        screen
+    }, extra, HUB_DOCS[surface] ? {
+        docs: HUB_DOCS[surface]
+    } : {}, {
+        console: ref(surface, route)
+    });
+const WORKSPACE_SETTINGS = {
+    id: 'workspaceSettings',
+    title: 'settings',
+    groups: [
+        {
+            id: 'team',
+            label: 'Team',
+            foldable: false,
+            rows: ordered([
+                settingsRow('teamSection', 'members', 'Members', ICONS.members, 'core.team', 'MANAGE_TEAM_MEMBERS', {
+                    keywords: [
+                        'team',
+                        'invite',
+                        'people'
+                    ]
+                }),
+                settingsRow('teamSection', 'roles', 'Custom roles', ICONS.roles, 'core.team.roles', 'MANAGE_TEAM_ROLES', {
+                    keywords: [
+                        'permissions'
+                    ]
+                }),
+                settingsRow('teamSection', 'activity', 'Recent activity', ICONS.activity, 'core.team.activity', 'MANAGE_TEAM_ACTIVITY', {
+                    keywords: [
+                        'audit log'
+                    ]
+                })
+            ])
+        },
+        {
+            id: 'billing',
+            label: 'Billing',
+            foldable: false,
+            rows: [
+                settingsRow('billingSection', 'plan', 'Plan', ICONS.plan, 'core.billing', 'MANAGE_BILLING', {
+                    order: 10,
+                    keywords: [
+                        'billing',
+                        'upgrade',
+                        'subscription'
+                    ]
+                }),
+                settingsRow('billingSection', 'usage', 'Usage', ICONS.usage, 'core.billing.usage', 'MANAGE_BILLING_USAGE', {
+                    order: 20,
+                    keywords: [
+                        'billing',
+                        'limits'
+                    ]
+                }),
+                settingsRow('billingSection', 'invoices', 'Invoices', ICONS.invoices, 'core.billing.invoices', 'MANAGE_BILLING_INVOICES', {
+                    order: 40,
+                    keywords: [
+                        'billing',
+                        'receipts'
+                    ]
+                }),
+                settingsRow('billingSection', 'billingSettings', 'Settings', ICONS.billingSettings, 'core.billing.settings', 'MANAGE_BILLING_SETTINGS', {
+                    order: 50,
+                    keywords: [
+                        'billing',
+                        'payment method',
+                        'tax'
+                    ]
+                })
+            ]
+        },
+        {
+            id: 'workspace',
+            label: 'Workspace',
+            foldable: false,
+            rows: ordered([
+                settingsRow('orgTab', 'plugins', 'Plugins', ICONS.plugins, 'core.plugins', 'nav-tab-org-plugins'),
+                settingsRow('orgSettingsSection', 'branding', 'Branding', ICONS.branding, 'core.settings.branding', 'ORG_SETTINGS_BRANDING', {
+                    keywords: [
+                        'white label',
+                        'logo',
+                        'colors'
+                    ]
+                }),
+                settingsRow('orgSettingsSection', 'sso', 'Single sign-on', ICONS.sso, 'core.settings.sso', 'ORG_SETTINGS_SSO', {
+                    keywords: [
+                        'sso',
+                        'saml'
+                    ]
+                }),
+                settingsRow('orgSettingsSection', 'profile', 'Profile', ICONS.profile, 'core.settings.profile', 'ORG_SETTINGS_PROFILE'),
+                settingsRow('orgSettingsSection', 'apiKeys', 'API keys', ICONS.apiKeys, 'core.settings.apiKeys', 'ORG_SETTINGS_API_KEYS'),
+                settingsRow('orgSettingsSection', 'integrations', 'Integrations', ICONS.integrations, 'core.settings.integrations', 'ORG_SETTINGS_INTEGRATIONS'),
+                settingsRow('orgSettingsSection', 'general', 'General', ICONS.settings, 'core.settings.general', 'ORG_SETTINGS_GENERAL', {
+                    keywords: [
+                        'name',
+                        'address'
+                    ]
+                })
+            ])
+        },
+        {
+            id: 'data',
+            label: 'Data & compliance',
+            foldable: false,
+            rows: ordered([
+                settingsRow('orgSettingsSection', 'privacy', 'Privacy', ICONS.privacy, 'core.settings.privacy', 'ORG_SETTINGS_PRIVACY', {
+                    keywords: [
+                        'gdpr',
+                        'erase'
+                    ]
+                }),
+                settingsRow('orgSettingsSection', 'holds', 'Holds & reviews', ICONS.holds, 'core.settings.holds', 'ORG_SETTINGS_HOLDS'),
+                settingsRow('orgSettingsSection', 'importExport', 'Import & export', ICONS.importExport, 'core.settings.data', 'ORG_SETTINGS_DATA', {
+                    keywords: [
+                        'csv',
+                        'export'
+                    ]
+                })
+            ])
+        },
+        {
+            id: 'danger',
+            label: 'Danger zone',
+            foldable: false,
+            rows: ordered([
+                settingsRow('orgSettingsSection', 'ownership', 'Ownership', ICONS.ownership, 'core.settings.ownership', 'ORG_SETTINGS_OWNERSHIP', {
+                    keywords: [
+                        'transfer'
+                    ]
+                }),
+                settingsRow('orgSettingsSection', 'delete', 'Delete', ICONS.delete, 'core.settings.delete', 'ORG_SETTINGS_DELETE')
+            ])
+        }
+    ]
+};
+const SITE_SETTINGS = {
+    id: 'siteSettings',
+    title: 'settings',
+    groups: [
+        {
+            id: 'people',
+            foldable: false,
+            rows: ordered([
+                {
+                    id: 'users',
+                    label: 'Users',
+                    icon: ICONS.members,
+                    screen: 'core.site.users',
+                    keywords: [
+                        'team',
+                        'collaborators'
+                    ],
+                    console: ref('hostTab', 'nav-tab-users')
+                }
+            ])
+        },
+        {
+            id: 'setup',
+            label: 'Setup',
+            foldable: false,
+            rows: ordered([
+                setupRow('details', 'Basic details', ICONS.details, 'Logo, business details, layout and languages'),
+                setupRow('business', 'Business profile', ICONS.business, 'What the business is, for everything that writes about it'),
+                setupRow('seo', 'SEO', ICONS.seo, 'Search title, social image, business profile and verification', [
+                    'search'
+                ]),
+                setupRow('tracking', 'Tracking', ICONS.tracking, 'Analytics, ad tags and the consent banner', [
+                    'cookies',
+                    'pixels'
+                ]),
+                setupRow('theme', 'Theme', ICONS.theme, 'Colors, font, shape and your saved themes', [
+                    'colors',
+                    'fonts'
+                ]),
+                setupRow('emails', 'Emails', ICONS.emails, 'The emails your site sends to customers'),
+                setupRow('integrations', 'Integrations', ICONS.integrations, 'Email platforms, Zapier, live chat and the other tools your site connects to')
+            ])
+        },
+        {
+            id: 'admin',
+            label: 'Admin',
+            foldable: false,
+            rows: ordered([
+                adminRow('general', 'General', ICONS.settings, 'core.site.general', 'HOST_ADMIN_GENERAL'),
+                adminRow('plugins', 'Plugins', ICONS.plugins, 'core.site.plugins', 'HOST_ADMIN_PLUGINS'),
+                adminRow('domain', 'Custom Domain', ICONS.domain, 'core.site.domain', 'HOST_ADMIN_DOMAIN'),
+                adminRow('security', 'Security', ICONS.security, 'core.site.security', 'HOST_ADMIN_SECURITY'),
+                adminRow('errorPages', 'Error pages', ICONS.errorPages, 'core.site.errorPages', 'HOST_ADMIN_ERROR_PAGES'),
+                adminRow('activity', 'Activity', ICONS.activity, 'core.site.activity', 'HOST_ADMIN_ACTIVITY'),
+                adminRow('backup', 'Backup & template', ICONS.backup, 'core.site.backup', 'HOST_ADMIN_BACKUP'),
+                adminRow('danger', 'Danger zone', ICONS.delete, 'core.site.delete', 'HOST_ADMIN_DANGER')
+            ])
+        }
+    ]
+};
+const CREATE = [
+    {
+        scope: 'workspace',
+        items: [
+            {
+                id: 'site',
+                label: 'Site',
+                icon: ICONS.sites,
+                screen: 'site.sites',
+                params: {
+                    new: '1'
+                },
+                permission: 'hosts.create',
+                order: 10,
+                console: ref('orgTab', 'nav-tab-org-sites')
+            }
+        ]
+    },
+    {
+        scope: 'site',
+        items: [
+            {
+                id: 'page',
+                label: 'Page',
+                icon: ICONS.pages,
+                screen: 'site.pages',
+                params: {
+                    new: '1'
+                },
+                hostRoles: [
+                    'admin',
+                    'editor',
+                    'author'
+                ],
+                order: 10,
+                console: ref('hostTab', 'nav-tab-screens')
+            }
+        ]
+    }
+];
+/**
+ * The core's half of the manifest: every list and group, and the core's own
+ * rows. The manifest the apps read (`ContractValues.nativeNavManifest`) is
+ * this with each plugin's `NATIVE_NAV_ROWS` placed by `assembleNativeNav`.
+ */ export const NATIVE_NAV_MANIFEST = {
+    lists: [
+        WORKSPACE,
+        SITE,
+        WORKSPACE_SETTINGS,
+        SITE_SETTINGS
+    ],
+    create: CREATE,
+    shellScreens: [
+        ...NATIVE_NAV_SHELL_SCREENS
+    ],
+    elsewhere: [
+        {
+            console: ref('hostTab', 'nav-tab-dashboard'),
+            where: 'Home, inside the site (shell.home)'
+        },
+        {
+            console: ref('hostTab', 'nav-tab-setup'),
+            where: 'Site settings → Setup'
+        },
+        {
+            console: ref('hostTab', 'nav-tab-admin'),
+            where: 'Site settings → Admin'
+        },
+        {
+            console: ref('orgTab', 'nav-tab-org-team'),
+            where: 'Workspace settings → Team'
+        },
+        {
+            console: ref('orgTab', 'nav-tab-org-billing'),
+            where: 'Workspace settings → Billing'
+        },
+        {
+            console: ref('orgTab', 'nav-tab-org-settings'),
+            where: 'Workspace settings'
+        },
+        {
+            console: ref('orgTab', 'nav-tab-org-support'),
+            where: 'Help menu → Contact support (core.support)'
+        }
+    ]
+};
+/**
+ * The manifest with the plugins' rows placed: each into its list's group by
+ * `order` (a tie keeps the core's row first, then registration order). A row
+ * naming a list or group the core does not have is refused by name, so a
+ * plugin cannot quietly invent a group.
+ */ export function assembleNativeNav(core, contributions, elsewhere = [], creates = []) {
+    var _core_create;
+    const byOrder = (entries)=>entries.map((entry, index)=>({
+                entry,
+                index
+            })).sort((a, b)=>{
+            var _a_entry_order, _b_entry_order;
+            return ((_a_entry_order = a.entry.order) != null ? _a_entry_order : 0) - ((_b_entry_order = b.entry.order) != null ? _b_entry_order : 0) || a.index - b.index;
+        }).map(({ entry })=>entry);
+    const lists = core.lists.map((list)=>_extends({}, list, {
+            groups: list.groups.map((group)=>_extends({}, group, {
+                    rows: [
+                        ...group.rows
+                    ]
+                }))
+        }));
+    for (const { list: listId, group: groupId, row } of contributions){
+        var _lists_find;
+        const group = (_lists_find = lists.find((list)=>list.id === listId)) == null ? void 0 : _lists_find.groups.find((entry)=>entry.id === groupId);
+        if (!group || group.dynamic) {
+            throw new Error(`native nav: ${row.id} names ${listId}/${groupId}, which is not a group of rows`);
+        }
+        if (group.rows.some((entry)=>entry.id === row.id)) {
+            throw new Error(`native nav: ${listId}/${groupId} holds ${row.id} twice`);
+        }
+        group.rows.push(row);
+    }
+    for (const list of lists){
+        for (const group of list.groups){
+            // A section is helped by its row's page unless the console names its own.
+            group.rows = byOrder(group.rows).map((row)=>row.docs && row.sections ? _extends({}, row, {
+                    sections: row.sections.map((section)=>section.docs ? section : _extends({}, section, {
+                            docs: row.docs
+                        }))
+                }) : row);
+        }
+    }
+    const create = ((_core_create = core.create) != null ? _core_create : []).map((entry)=>_extends({}, entry, {
+            items: [
+                ...entry.items
+            ]
+        }));
+    for (const { scope, item } of creates){
+        const target = create.find((entry)=>entry.scope === scope);
+        if (!target) throw new Error(`native nav: create item ${item.id} names ${scope}, which has no menu`);
+        if (target.items.some((entry)=>entry.id === item.id)) {
+            throw new Error(`native nav: the ${scope} create menu holds ${item.id} twice`);
+        }
+        target.items.push(item);
+    }
+    return _extends({}, core, {
+        lists,
+        create: create.map((entry)=>_extends({}, entry, {
+                items: byOrder(entry.items)
+            })),
+        elsewhere: [
+            ...core.elsewhere,
+            ...elsewhere
+        ]
+    });
+}
+/** What a Create new item that cannot be used says, when its own reason does not apply. */ export const NATIVE_CREATE_PERMISSION_REASON = "Your role can't create this here. Ask an owner or admin of the workspace.";
+export const NATIVE_CREATE_SITE_ROLE_REASON = "Your role on this site can't create this. Ask a site admin.";
+export const NATIVE_CREATE_PLAN_REASON = "Your plan doesn't include this. See the plans in Billing.";
+/**
+ * The Create new menu for the workspace or site in hand. An item of a plugin
+ * that is off is not offered, nor an admin-only item to a non-admin. One the
+ * person may not use is SHOWN, disabled with its reason (prerequisites are
+ * shown, never hidden): a permission or site role they lack, then a plan
+ * feature the workspace lacks. `permissions` and `features` are the
+ * workspace's resolved answers (an absent key is not held); `hostRole` is
+ * the person's role on the site, null at the workspace.
+ */ export function resolveCreateList(manifest, scope, enabledPluginIds, permissions, features, hostRole) {
+    var _ref;
+    var _manifest_create_find, _manifest_create;
+    const on = new Set(enabledPluginIds);
+    const items = (_ref = (_manifest_create = manifest.create) == null ? void 0 : (_manifest_create_find = _manifest_create.find((entry)=>entry.scope === scope)) == null ? void 0 : _manifest_create_find.items) != null ? _ref : [];
+    return items.filter((item)=>(!item.pluginId || on.has(item.pluginId)) && (!item.requiresHostAdmin || hostRole === 'admin')).map((item)=>{
+        if (item.permission && permissions[item.permission] !== true) {
+            return _extends({}, item, {
+                blocked: true,
+                reason: NATIVE_CREATE_PERMISSION_REASON
+            });
+        }
+        if (item.hostRoles && !item.hostRoles.includes(hostRole != null ? hostRole : '')) {
+            return _extends({}, item, {
+                blocked: true,
+                reason: NATIVE_CREATE_SITE_ROLE_REASON
+            });
+        }
+        if (item.planFeature && features[item.planFeature] !== true) {
+            var _item_blockedReason;
+            return _extends({}, item, {
+                blocked: true,
+                reason: (_item_blockedReason = item.blockedReason) != null ? _item_blockedReason : NATIVE_CREATE_PLAN_REASON
+            });
+        }
+        return _extends({}, item, {
+            blocked: false
+        });
+    });
+}
+/**
+ * One list for the workspace or site in hand, from the assembled manifest
+ * (`ContractValues.nativeNavManifest`). `enabledPluginIds` is the site's
+ * effective set (`resolveHostEnabledPlugins`) in site scope and the
+ * workspace's (`resolveEnabledPlugins`) otherwise. A section of another
+ * plugin than its row's hides with that plugin. A group left with no rows is
+ * dropped, except the starred group, which the shell fills.
+ */ export function resolveNavList(manifest, listId, enabledPluginIds, hostAdmin) {
+    const list = manifest.lists.find((entry)=>entry.id === listId);
+    if (!list) return {
+        id: listId,
+        groups: []
+    };
+    const on = new Set(enabledPluginIds);
+    const shows = (pluginId)=>!pluginId || on.has(pluginId);
+    const groups = [];
+    for (const group of list.groups){
+        const rows = group.rows.filter((row)=>shows(row.pluginId) && (hostAdmin || !row.requiresHostAdmin)).map((row)=>row.sections ? _extends({}, row, {
+                sections: row.sections.filter((section)=>shows(section.pluginId))
+            }) : row);
+        if (!rows.length && !group.dynamic) continue;
+        groups.push(_extends({}, group, {
+            rows
+        }));
+    }
+    return _extends({
+        id: list.id
+    }, list.title ? {
+        title: list.title
+    } : {}, {
+        groups
+    });
+}
+
+//# sourceMappingURL=native-nav.js.map