@aglyn/aglyn 1.0.0-beta.143

package/src/lib/app-utils/console-routes.d.ts

@@ -0,0 +1,658 @@
+/**
+ * @license
+ * Copyright 2022 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.
+ */
+export declare enum Route {
+    ADMIN_ORGS = "/admin/orgs",
+    ADMIN_ORG_DETAIL = "/admin/orgs/[orgId]",
+    ADMIN_ORG_HOST_DETAIL = "/admin/orgs/[orgId]/host/[hostId]",
+    ADMIN_OVERVIEW = "/admin/overview",
+    ADMIN_COUPONS = "/admin/coupons",
+    ADMIN_LOCKDOWN = "/admin/lockdown",
+    ADMIN_MEDIA_QUARANTINE = "/admin/media-quarantine",
+    ADMIN_ABUSE_REPORTS = "/admin/abuse-reports",
+    ADMIN_MARKETPLACE_REPORTS = "/admin/marketplace-reports",
+    ADMIN_HEALTH = "/admin/health",
+    ADMIN_MAINTENANCE = "/admin/maintenance",
+    ADMIN_REVENUE = "/admin/revenue",
+    ADMIN_MARGIN_UTILIZATION = "/admin/margin-utilization",
+    ADMIN_TAX_RETURN = "/admin/tax-return",
+    ADMIN_AUDIT = "/admin/audit",
+    ADMIN_USERS = "/admin/users",
+    ADMIN_USER_DETAIL = "/admin/users/[uid]",
+    ADMIN_FLAGS = "/admin/flags",
+    ADMIN_SETTINGS = "/admin/settings",
+    ADMIN_PLUGIN_REVIEWS = "/admin/plugin-reviews",
+    ADMIN_PLUGIN_REVIEW = "/admin/plugin-reviews/[listingId]",
+    ADMIN_STAFF_PAGE = "/admin/[staffPage]",
+    ADMIN_SUPPORT = "/admin/support",
+    ADMIN_CONTACT_SUPPRESSIONS = "/admin/contact-suppressions",
+    ADMIN_EMAILS = "/admin/emails",
+    ADMIN_EMAIL_BESIGNER = "/admin/emails/[templateKey]/versions/[versionId]/besigner",
+    ORG_HOME = "/[orgSlug]",
+    ORG_MEDIA = "/[orgSlug]/media",
+    ORG_DATA = "/[orgSlug]/data",
+    ORG_CONTACTS = "/[orgSlug]/contacts",
+    ORG_CRM = "/[orgSlug]/crm",
+    ORG_PLUGIN = "/[orgSlug]/[pluginSlug]",
+    ORG_PLUGINS = "/[orgSlug]/plugins",
+    ORG_PLUGIN_INSTALLATION = "/[orgSlug]/plugins/[pluginRef]",
+    ORG_MARKETPLACE = "/[orgSlug]/marketplace",
+    ORG_MARKETPLACE_BROWSE = "/[orgSlug]/marketplace/browse",
+    ORG_MARKETPLACE_INSTALLED = "/[orgSlug]/marketplace/installed",
+    ORG_MARKETPLACE_LICENCES = "/[orgSlug]/marketplace/licences",
+    ORG_MARKETPLACE_UPLOAD = "/[orgSlug]/marketplace/upload",
+    ORG_MARKETPLACE_SELLER_PROFILE = "/[orgSlug]/marketplace/profile",
+    ORG_MARKETPLACE_SELLER_LISTINGS = "/[orgSlug]/marketplace/listings",
+    ORG_MARKETPLACE_SELLER_PAYOUTS = "/[orgSlug]/marketplace/payouts",
+    ORG_MARKETPLACE_SELLER_SALES = "/[orgSlug]/marketplace/sales",
+    ORG_MARKETPLACE_LISTING = "/[orgSlug]/marketplace/[listingId]",
+    ORG_MARKETPLACE_PUBLISHER = "/[orgSlug]/marketplace/publisher/[handle]",
+    ORG_MARKETPLACE_PUBLISH_PLUGIN = "/[orgSlug]/marketplace/publish/plugin",
+    ORG_SETTINGS = "/[orgSlug]/settings",
+    ORG_SETTINGS_GENERAL = "/[orgSlug]/settings/general",
+    ORG_SETTINGS_PROFILE = "/[orgSlug]/settings/profile",
+    ORG_SETTINGS_PLUGINS = "/[orgSlug]/settings/plugins",
+    ORG_SETTINGS_API_KEYS = "/[orgSlug]/settings/api-keys",
+    ORG_SETTINGS_BRANDING = "/[orgSlug]/settings/branding",
+    ORG_SETTINGS_SSO = "/[orgSlug]/settings/sso",
+    ORG_SETTINGS_OWNERSHIP = "/[orgSlug]/settings/ownership",
+    /**
+     * Export the people a workspace holds and file a person's erasure
+     * (AGL-2839) — outside the CRM, so it is there on every plan.
+     */
+    ORG_SETTINGS_PRIVACY = "/[orgSlug]/settings/privacy",
+    ORG_SETTINGS_DELETE = "/[orgSlug]/settings/delete",
+    /**
+     * Billing, section by section (AGL-2501).
+     *
+     * `MANAGE_BILLING` is unchanged and is the PLAN section — it resolves to a
+     * page inside a route group, which adds no path segment. That is what makes
+     * this split free: every link in the console, every hash anchor
+     * (`#addons`, `#collaborator-seats`) and Stripe's own dunning mail all point
+     * here already and none of them moves. No redirect, and no `?tab=` shim to
+     * carry forever.
+     */
+    MANAGE_BILLING = "/[orgSlug]/billing",
+    MANAGE_BILLING_USAGE = "/[orgSlug]/billing/usage",
+    MANAGE_BILLING_INVOICES = "/[orgSlug]/billing/invoices",
+    MANAGE_BILLING_SETTINGS = "/[orgSlug]/billing/settings",
+    BILLING_ENTRY = "/billing",
+    MANAGE_USER_SETTINGS = "/manage/user",
+    MANAGE_USER_ACCOUNT = "/manage/user/account",
+    MANAGE_USER_EMAILS = "/manage/user/emails",
+    MANAGE_USER_PROFILE = "/manage/user/profile",
+    MANAGE_USER_BASIC = "/manage/user/basic",
+    MANAGE_USER_SECURITY = "/manage/user/security",
+    MANAGE_USER_CLOSE = "/manage/user/close",
+    MANAGE_NOTIFICATIONS = "/manage/notifications",
+    MANAGE_REPORT_ISSUE = "/manage/report-issue",
+    AUTH_SIGN_IN = "/signin",
+    AUTH_SIGN_OUT = "/signout",
+    AUTH_SIGN_UP = "/signup",
+    AUTH_VERIFY_EMAIL = "/verify-email",
+    HOST_LIST = "/[orgSlug]/hosts",
+    HOST_CONTENT = "/[orgSlug]/hosts/[host]/content",
+    HOST_CONTENT_COLLECTION = "/[orgSlug]/hosts/[host]/content/[collectionSlug]",
+    CONTENT_ENTRY_DETAILS = "/[orgSlug]/hosts/[host]/content/[collectionSlug]/entries/[entryId]",
+    MANAGE_TEAM = "/[orgSlug]/team",
+    MANAGE_TEAM_MEMBERS = "/[orgSlug]/team/members",
+    MANAGE_TEAM_ROLES = "/[orgSlug]/team/roles",
+    MANAGE_TEAM_ACTIVITY = "/[orgSlug]/team/activity",
+    MANAGE_TEAM_MEMBER = "/[orgSlug]/team/[uid]",
+    MANAGE_SUPPORT = "/[orgSlug]/support",
+    MANAGE_SUPPORT_TICKETS = "/[orgSlug]/support/tickets",
+    MANAGE_SUPPORT_FORUM = "/[orgSlug]/support/forum",
+    HOST_DASHBOARD = "/[orgSlug]/hosts/[host]",
+    HOST_PLUGIN = "/[orgSlug]/hosts/[host]/[pluginSlug]",
+    HOST_INBOX = "/[orgSlug]/hosts/[host]/inbox",
+    HOST_CONTACTS = "/[orgSlug]/hosts/[host]/contacts",
+    HOST_MEDIA = "/[orgSlug]/hosts/[host]/media",
+    HOST_SETUP = "/[orgSlug]/hosts/[host]/setup",
+    HOST_SETUP_DETAILS = "/[orgSlug]/hosts/[host]/setup/details",
+    HOST_SETUP_SEO = "/[orgSlug]/hosts/[host]/setup/seo",
+    HOST_SETUP_TRACKING = "/[orgSlug]/hosts/[host]/setup/tracking",
+    HOST_SETUP_THEME = "/[orgSlug]/hosts/[host]/setup/theme",
+    HOST_SETUP_EMAILS = "/[orgSlug]/hosts/[host]/setup/emails",
+    HOST_ADMIN = "/[orgSlug]/hosts/[host]/admin",
+    HOST_ADMIN_GENERAL = "/[orgSlug]/hosts/[host]/admin/general",
+    HOST_ADMIN_PLUGINS = "/[orgSlug]/hosts/[host]/admin/plugins",
+    HOST_ADMIN_PLUGIN = "/[orgSlug]/hosts/[host]/admin/plugins/[pluginRef]",
+    HOST_ADMIN_DOMAIN = "/[orgSlug]/hosts/[host]/admin/domain",
+    HOST_ADMIN_SECURITY = "/[orgSlug]/hosts/[host]/admin/security",
+    HOST_ADMIN_ERROR_PAGES = "/[orgSlug]/hosts/[host]/admin/error-pages",
+    HOST_ADMIN_ACTIVITY = "/[orgSlug]/hosts/[host]/admin/activity",
+    HOST_ADMIN_BACKUP = "/[orgSlug]/hosts/[host]/admin/backup",
+    HOST_ADMIN_DANGER = "/[orgSlug]/hosts/[host]/admin/danger",
+    HOST_THEME = "/[orgSlug]/hosts/[host]/theme",
+    HOST_AUTOMATION = "/[orgSlug]/hosts/[host]/automation",
+    /**
+     * The address the automation section answered to before it had a name of
+     * its own. Nothing links here — `HOST_AUTOMATION` is what the nav, the
+     * search results and the activity feed build — but the console redirects it
+     * permanently, so a held bookmark still lands on the section (and keeps its
+     * `?tab=`, which never changed).
+     *
+     * Kept on the table rather than as a bare literal in `next.config.js`
+     * because the redirect and the address it serves are one fact:
+     * `automation-section.spec.ts` reads this entry and fails if the rule for
+     * it goes missing.
+     */
+    HOST_WORKFLOWS = "/[orgSlug]/hosts/[host]/workflows",
+    HOST_DATA = "/[orgSlug]/hosts/[host]/data",
+    HOST_LOGIC = "/[orgSlug]/hosts/[host]/logic",
+    HOST_PRODUCTS = "/[orgSlug]/hosts/[host]/products",
+    HOST_COMPONENTS = "/[orgSlug]/hosts/[host]/components",
+    COMPONENT_DETAILS = "/[orgSlug]/hosts/[host]/components/[componentId]",
+    HOST_FORMS = "/[orgSlug]/hosts/[host]/forms",
+    FORM_DETAILS = "/[orgSlug]/hosts/[host]/forms/[formId]",
+    HOST_TEMPLATES = "/[orgSlug]/hosts/[host]/templates",
+    TEMPLATE_DETAILS = "/[orgSlug]/hosts/[host]/templates/[templateId]",
+    HOST_MARKETING = "/[orgSlug]/hosts/[host]/marketing",
+    HOST_BOOKINGS = "/[orgSlug]/hosts/[host]/bookings",
+    HOST_REDIRECTS = "/[orgSlug]/hosts/[host]/redirects",
+    HOST_USERS = "/[orgSlug]/hosts/[host]/users",
+    HOST_ANALYTICS = "/[orgSlug]/hosts/[host]/analytics",
+    COMPONENT_BESIGNER = "/[orgSlug]/hosts/[host]/components/[componentId]/versions/[versionId]/besigner",
+    FORM_BESIGNER = "/[orgSlug]/hosts/[host]/forms/[formId]/versions/[versionId]/besigner",
+    TEMPLATE_BESIGNER = "/[orgSlug]/hosts/[host]/templates/[templateId]/besigner",
+    LAYOUT_BESIGNER = "/[orgSlug]/hosts/[host]/layouts/[layoutId]/versions/[versionId]/besigner",
+    COMPONENT_PREVIEW = "/[orgSlug]/hosts/[host]/components/[componentId]/versions/[versionId]/preview",
+    FORM_PREVIEW = "/[orgSlug]/hosts/[host]/forms/[formId]/versions/[versionId]/preview",
+    TEMPLATE_PREVIEW = "/[orgSlug]/hosts/[host]/templates/[templateId]/preview",
+    LAYOUT_PREVIEW = "/[orgSlug]/hosts/[host]/layouts/[layoutId]/versions/[versionId]/preview",
+    HOST_LAYOUTS = "/[orgSlug]/hosts/[host]/layouts",
+    LAYOUT_DETAILS = "/[orgSlug]/hosts/[host]/layouts/[layoutId]",
+    SCREEN_BESIGNER = "/[orgSlug]/hosts/[host]/screens/[screenId]/versions/[versionId]/besigner",
+    HOST_EMAIL_BESIGNER = "/[orgSlug]/hosts/[host]/emails/[templateKey]/versions/[versionId]/besigner",
+    SCREEN_DETAILS = "/[orgSlug]/hosts/[host]/screens/[screenId]/versions/[versionId]/view",
+    SCREEN_PREVIEW = "/[orgSlug]/hosts/[host]/screens/[screenId]/versions/[versionId]/preview",
+    HOST_SCREENS = "/[orgSlug]/hosts/[host]/screens"
+}
+/**
+ * Params required to build each {@link Route}.
+ *
+ * Deliberately NOT extended from an index signature (AGL-685). It used to be
+ * `extends Record<keyof any, any>`, which meant any `Route` missing an entry
+ * here silently typed its payload as `any` — `Route.HOST_SETUP` was one of
+ * them, and `buildRoute(Route.HOST_SETUP, { hostId })` compiled cleanly while
+ * emitting `/<orgSlug?>/hosts/<host?>/setup`. Without the index signature a
+ * new `Route` with no entry is a compile error, which is the whole point of
+ * the payload being required in the first place.
+ */
+export interface RoutePayload {
+    [Route.AUTH_SIGN_UP]: undefined;
+    [Route.AUTH_SIGN_IN]: undefined;
+    [Route.AUTH_SIGN_OUT]: undefined;
+    [Route.AUTH_VERIFY_EMAIL]: undefined;
+    [Route.SCREEN_BESIGNER]: {
+        orgSlug: string;
+        host: string;
+        screenId: string;
+        versionId: string;
+    };
+    [Route.ORG_HOME]: {
+        orgSlug: string;
+    };
+    [Route.HOST_DASHBOARD]: {
+        orgSlug: string;
+        host: string;
+    };
+    [Route.ADMIN_ORGS]: undefined;
+    [Route.ADMIN_ORG_DETAIL]: {
+        orgId: string;
+    };
+    [Route.ADMIN_ORG_HOST_DETAIL]: {
+        orgId: string;
+        hostId: string;
+    };
+    [Route.ADMIN_OVERVIEW]: undefined;
+    [Route.ADMIN_COUPONS]: undefined;
+    [Route.ADMIN_LOCKDOWN]: undefined;
+    [Route.ADMIN_MEDIA_QUARANTINE]: undefined;
+    [Route.ADMIN_ABUSE_REPORTS]: undefined;
+    [Route.ADMIN_MARKETPLACE_REPORTS]: undefined;
+    [Route.ADMIN_HEALTH]: undefined;
+    [Route.ADMIN_MAINTENANCE]: undefined;
+    [Route.ADMIN_REVENUE]: undefined;
+    [Route.ADMIN_MARGIN_UTILIZATION]: undefined;
+    [Route.ADMIN_TAX_RETURN]: undefined;
+    [Route.ADMIN_AUDIT]: undefined;
+    [Route.ADMIN_USERS]: undefined;
+    [Route.ADMIN_USER_DETAIL]: {
+        uid: string;
+    };
+    [Route.ADMIN_FLAGS]: undefined;
+    [Route.ADMIN_SETTINGS]: undefined;
+    [Route.ADMIN_PLUGIN_REVIEWS]: undefined;
+    [Route.ADMIN_PLUGIN_REVIEW]: {
+        listingId: string;
+    };
+    [Route.ADMIN_STAFF_PAGE]: {
+        staffPage: string;
+    };
+    [Route.ADMIN_SUPPORT]: undefined;
+    [Route.ADMIN_CONTACT_SUPPRESSIONS]: undefined;
+    [Route.ADMIN_EMAILS]: undefined;
+    [Route.ADMIN_EMAIL_BESIGNER]: {
+        templateKey: string;
+        versionId: string;
+    };
+    [Route.HOST_EMAIL_BESIGNER]: {
+        orgSlug: string;
+        host: string;
+        templateKey: string;
+        versionId: string;
+    };
+    [Route.ORG_MEDIA]: {
+        orgSlug: string;
+    };
+    [Route.ORG_DATA]: {
+        orgSlug: string;
+    };
+    [Route.ORG_CONTACTS]: {
+        orgSlug: string;
+    };
+    [Route.ORG_CRM]: {
+        orgSlug: string;
+    };
+    [Route.ORG_PLUGIN]: {
+        orgSlug: string;
+        pluginSlug: string;
+    };
+    [Route.ORG_PLUGINS]: {
+        orgSlug: string;
+    };
+    [Route.ORG_PLUGIN_INSTALLATION]: {
+        orgSlug: string;
+        pluginRef: string;
+    };
+    [Route.ORG_MARKETPLACE]: {
+        orgSlug: string;
+    };
+    [Route.ORG_MARKETPLACE_BROWSE]: {
+        orgSlug: string;
+    };
+    [Route.ORG_MARKETPLACE_INSTALLED]: {
+        orgSlug: string;
+    };
+    [Route.ORG_MARKETPLACE_LICENCES]: {
+        orgSlug: string;
+    };
+    [Route.ORG_MARKETPLACE_UPLOAD]: {
+        orgSlug: string;
+    };
+    [Route.ORG_MARKETPLACE_SELLER_PROFILE]: {
+        orgSlug: string;
+    };
+    [Route.ORG_MARKETPLACE_SELLER_LISTINGS]: {
+        orgSlug: string;
+    };
+    [Route.ORG_MARKETPLACE_SELLER_PAYOUTS]: {
+        orgSlug: string;
+    };
+    [Route.ORG_MARKETPLACE_SELLER_SALES]: {
+        orgSlug: string;
+    };
+    [Route.ORG_MARKETPLACE_LISTING]: {
+        orgSlug: string;
+        listingId: string;
+    };
+    [Route.ORG_MARKETPLACE_PUBLISHER]: {
+        orgSlug: string;
+        handle: string;
+    };
+    [Route.ORG_MARKETPLACE_PUBLISH_PLUGIN]: {
+        orgSlug: string;
+    };
+    [Route.MANAGE_USER_SETTINGS]: undefined;
+    [Route.MANAGE_USER_ACCOUNT]: undefined;
+    [Route.MANAGE_USER_EMAILS]: undefined;
+    [Route.MANAGE_USER_PROFILE]: undefined;
+    [Route.MANAGE_USER_BASIC]: undefined;
+    [Route.MANAGE_USER_SECURITY]: undefined;
+    [Route.MANAGE_USER_CLOSE]: undefined;
+    [Route.MANAGE_NOTIFICATIONS]: undefined;
+    [Route.MANAGE_REPORT_ISSUE]: undefined;
+    [Route.ORG_SETTINGS]: {
+        orgSlug: string;
+    };
+    [Route.ORG_SETTINGS_GENERAL]: {
+        orgSlug: string;
+    };
+    [Route.ORG_SETTINGS_PROFILE]: {
+        orgSlug: string;
+    };
+    [Route.ORG_SETTINGS_PLUGINS]: {
+        orgSlug: string;
+    };
+    [Route.ORG_SETTINGS_API_KEYS]: {
+        orgSlug: string;
+    };
+    [Route.ORG_SETTINGS_BRANDING]: {
+        orgSlug: string;
+    };
+    [Route.ORG_SETTINGS_SSO]: {
+        orgSlug: string;
+    };
+    [Route.ORG_SETTINGS_OWNERSHIP]: {
+        orgSlug: string;
+    };
+    [Route.ORG_SETTINGS_PRIVACY]: {
+        orgSlug: string;
+    };
+    [Route.ORG_SETTINGS_DELETE]: {
+        orgSlug: string;
+    };
+    [Route.HOST_LIST]: {
+        orgSlug: string;
+    };
+    [Route.HOST_CONTENT]: {
+        orgSlug: string;
+        host: string;
+    };
+    [Route.HOST_CONTENT_COLLECTION]: {
+        orgSlug: string;
+        host: string;
+        /** The collection's slug — see the route. A document id also resolves. */
+        collectionSlug: string;
+    };
+    [Route.CONTENT_ENTRY_DETAILS]: {
+        orgSlug: string;
+        host: string;
+        collectionSlug: string;
+        /**
+         * An entry id, or the literal `new` for a draft with no document yet.
+         *
+         * An ID here while the collection above is a SLUG, deliberately. An entry
+         * slug is unique only WITHIN its collection and it is editable on the
+         * detail page — so routing by it would move the console address out from
+         * under someone in the middle of typing in the slug field, and a draft has
+         * no slug at all to route by. The entry id is also what every activity
+         * record and the DAM's "Used on" list already carry.
+         */
+        entryId: string;
+    };
+    [Route.MANAGE_TEAM]: {
+        orgSlug: string;
+    };
+    [Route.MANAGE_TEAM_MEMBERS]: {
+        orgSlug: string;
+    };
+    [Route.MANAGE_TEAM_ROLES]: {
+        orgSlug: string;
+    };
+    [Route.MANAGE_TEAM_ACTIVITY]: {
+        orgSlug: string;
+    };
+    [Route.MANAGE_TEAM_MEMBER]: {
+        orgSlug: string;
+        uid: string;
+    };
+    [Route.MANAGE_SUPPORT]: {
+        orgSlug: string;
+    };
+    [Route.MANAGE_SUPPORT_TICKETS]: {
+        orgSlug: string;
+    };
+    [Route.MANAGE_SUPPORT_FORUM]: {
+        orgSlug: string;
+    };
+    [Route.MANAGE_BILLING]: {
+        orgSlug: string;
+    };
+    [Route.MANAGE_BILLING_USAGE]: {
+        orgSlug: string;
+    };
+    [Route.MANAGE_BILLING_INVOICES]: {
+        orgSlug: string;
+    };
+    [Route.MANAGE_BILLING_SETTINGS]: {
+        orgSlug: string;
+    };
+    [Route.BILLING_ENTRY]: undefined;
+    [Route.HOST_INBOX]: {
+        orgSlug: string;
+        host: string;
+    };
+    [Route.HOST_CONTACTS]: {
+        orgSlug: string;
+        host: string;
+    };
+    [Route.HOST_SETUP]: {
+        orgSlug: string;
+        host: string;
+    };
+    [Route.HOST_SETUP_DETAILS]: {
+        orgSlug: string;
+        host: string;
+    };
+    [Route.HOST_SETUP_SEO]: {
+        orgSlug: string;
+        host: string;
+    };
+    [Route.HOST_SETUP_TRACKING]: {
+        orgSlug: string;
+        host: string;
+    };
+    [Route.HOST_SETUP_THEME]: {
+        orgSlug: string;
+        host: string;
+    };
+    [Route.HOST_SETUP_EMAILS]: {
+        orgSlug: string;
+        host: string;
+    };
+    [Route.HOST_ADMIN]: {
+        orgSlug: string;
+        host: string;
+    };
+    [Route.HOST_ADMIN_GENERAL]: {
+        orgSlug: string;
+        host: string;
+    };
+    [Route.HOST_ADMIN_PLUGINS]: {
+        orgSlug: string;
+        host: string;
+    };
+    [Route.HOST_ADMIN_PLUGIN]: {
+        orgSlug: string;
+        host: string;
+        pluginRef: string;
+    };
+    [Route.HOST_ADMIN_DOMAIN]: {
+        orgSlug: string;
+        host: string;
+    };
+    [Route.HOST_ADMIN_SECURITY]: {
+        orgSlug: string;
+        host: string;
+    };
+    [Route.HOST_ADMIN_ERROR_PAGES]: {
+        orgSlug: string;
+        host: string;
+    };
+    [Route.HOST_ADMIN_ACTIVITY]: {
+        orgSlug: string;
+        host: string;
+    };
+    [Route.HOST_ADMIN_BACKUP]: {
+        orgSlug: string;
+        host: string;
+    };
+    [Route.HOST_ADMIN_DANGER]: {
+        orgSlug: string;
+        host: string;
+    };
+    [Route.HOST_PLUGIN]: {
+        orgSlug: string;
+        host: string;
+        pluginSlug: string;
+    };
+    [Route.HOST_MEDIA]: {
+        orgSlug: string;
+        host: string;
+    };
+    [Route.HOST_THEME]: {
+        orgSlug: string;
+        host: string;
+    };
+    [Route.HOST_AUTOMATION]: {
+        orgSlug: string;
+        host: string;
+    };
+    [Route.HOST_WORKFLOWS]: {
+        orgSlug: string;
+        host: string;
+    };
+    [Route.HOST_DATA]: {
+        orgSlug: string;
+        host: string;
+    };
+    [Route.HOST_LOGIC]: {
+        orgSlug: string;
+        host: string;
+    };
+    [Route.HOST_PRODUCTS]: {
+        orgSlug: string;
+        host: string;
+    };
+    [Route.HOST_COMPONENTS]: {
+        orgSlug: string;
+        host: string;
+    };
+    [Route.COMPONENT_DETAILS]: {
+        orgSlug: string;
+        host: string;
+        componentId: string;
+    };
+    [Route.HOST_FORMS]: {
+        orgSlug: string;
+        host: string;
+    };
+    [Route.FORM_DETAILS]: {
+        orgSlug: string;
+        host: string;
+        formId: string;
+    };
+    [Route.HOST_TEMPLATES]: {
+        orgSlug: string;
+        host: string;
+    };
+    [Route.TEMPLATE_DETAILS]: {
+        orgSlug: string;
+        host: string;
+        templateId: string;
+    };
+    [Route.HOST_MARKETING]: {
+        orgSlug: string;
+        host: string;
+    };
+    [Route.HOST_BOOKINGS]: {
+        orgSlug: string;
+        host: string;
+    };
+    [Route.HOST_REDIRECTS]: {
+        orgSlug: string;
+        host: string;
+    };
+    [Route.HOST_USERS]: {
+        orgSlug: string;
+        host: string;
+    };
+    [Route.HOST_ANALYTICS]: {
+        orgSlug: string;
+        host: string;
+    };
+    [Route.COMPONENT_BESIGNER]: {
+        orgSlug: string;
+        host: string;
+        componentId: string;
+        versionId: string;
+    };
+    [Route.FORM_BESIGNER]: {
+        orgSlug: string;
+        host: string;
+        formId: string;
+        versionId: string;
+    };
+    [Route.TEMPLATE_BESIGNER]: {
+        orgSlug: string;
+        host: string;
+        templateId: string;
+    };
+    [Route.LAYOUT_BESIGNER]: {
+        orgSlug: string;
+        host: string;
+        layoutId: string;
+        versionId: string;
+    };
+    [Route.COMPONENT_PREVIEW]: {
+        orgSlug: string;
+        host: string;
+        componentId: string;
+        versionId: string;
+    };
+    [Route.FORM_PREVIEW]: {
+        orgSlug: string;
+        host: string;
+        formId: string;
+        versionId: string;
+    };
+    [Route.TEMPLATE_PREVIEW]: {
+        orgSlug: string;
+        host: string;
+        templateId: string;
+    };
+    [Route.LAYOUT_PREVIEW]: {
+        orgSlug: string;
+        host: string;
+        layoutId: string;
+        versionId: string;
+    };
+    [Route.HOST_LAYOUTS]: {
+        orgSlug: string;
+        host: string;
+    };
+    [Route.LAYOUT_DETAILS]: {
+        orgSlug: string;
+        host: string;
+        layoutId: string;
+    };
+    [Route.SCREEN_DETAILS]: {
+        orgSlug: string;
+        host: string;
+        screenId: string;
+        versionId: string;
+    };
+    [Route.SCREEN_PREVIEW]: {
+        orgSlug: string;
+        host: string;
+        screenId: string;
+        versionId: string;
+    };
+    [Route.HOST_SCREENS]: {
+        orgSlug: string;
+        host: string;
+    };
+}
+export declare const routeReplacePattern: RegExp;
+/**
+ * Builds a concrete path from a {@link Route} template. The payload is
+ * REQUIRED whenever the route declares params (e.g. `orgSlug`, `hostId`) and
+ * omitted only for param-less routes — so a forgotten `orgSlug` is a compile
+ * error, not a `/<orgSlug?>/…` link that breaks at runtime (AGL-621).
+ */
+export declare function buildRoute<Tmpl extends Route>(template: Tmpl, ...[payload]: RoutePayload[Tmpl] extends undefined ? [payload?: undefined] : [payload: RoutePayload[Tmpl]]): string;