@woodsportal/hubspot-kit 1.0.41-dev.4 → 1.0.41-dev.6

package/examples/greenfield/module-hybrid-cdn-auth-sso/src/features/starter/index.ts

@@ -0,0 +1,6 @@
+export { StarterHomePage } from './components/starter-home-page'
+export { StarterGuidePage } from './components/starter-guide-page'
+export { StarterSinglePage } from './components/starter-single-page'
+export { StarterHome } from './components/starter-home'
+export { useStarterPreview } from './hooks/use-starter-preview'
+export type { StarterPreviewValues } from './hooks/starter-preview-values'

package/examples/greenfield/module-hybrid-cdn-auth-sso/src/hubspot/bootstrap.ts

@@ -0,0 +1,16 @@
+/**
+ * Thin HubSpot module.js bootstrap — JS app loads from CDN via require_js in module.html.
+ *
+ * CSS imports are extracted to module.css by the HubSpot Vite build (same pattern as
+ * digitalwoods.io-woodsportal-client-frontend). HubSpot CMS editor does not reliably
+ * load external jsDelivr stylesheets from module.html.
+ */
+import '@/assets/css/main.prod.css'
+
+declare global {
+  interface Window {
+    WoodsPortalHubSpotBootstrap?: { ready: true }
+  }
+}
+
+window.WoodsPortalHubSpotBootstrap = { ready: true }

package/examples/greenfield/module-hybrid-cdn-auth-sso/src/hubspot/default-data.ts

@@ -0,0 +1,7 @@
+/** Local dev fixtures merged by the module-config runtime in `wp dev`. */
+export const devDefaultData = {
+  dataSourceSet: [],
+  hubId: 'dev',
+  userData: {},
+  objectList: [] as unknown[],
+}

package/examples/greenfield/module-hybrid-cdn-auth-sso/src/hubspot/is-cms-editor.ts

@@ -0,0 +1,78 @@
+declare global {
+  interface Window {
+    hsInEditor?: boolean
+    hsVars?: {
+      isEditor?: boolean
+      is_edit_mode?: boolean
+      [key: string]: unknown
+    }
+  }
+}
+
+function isInNestedIframe(): boolean {
+  if (typeof window === 'undefined') {
+    return false
+  }
+  return window.self !== window.top
+}
+
+function readHubSpotEditorFlag(): boolean {
+  if (typeof window === 'undefined') {
+    return false
+  }
+  if (window.hubSpotData?.isInEditor === true) {
+    return true
+  }
+  if (window.hsInEditor === true) {
+    return true
+  }
+  if (window.hsVars?.isEditor === true || window.hsVars?.is_edit_mode === true) {
+    return true
+  }
+  return false
+}
+
+function detectEditorFromUrlOrReferrer(): boolean {
+  if (typeof window === 'undefined') {
+    return false
+  }
+  try {
+    const href = window.location.href
+    if (/inpageeditor|page-editor|hs_editor|content-editor/i.test(href)) {
+      return true
+    }
+    if (isInNestedIframe() && /hs_preview|hsCacheBuster/i.test(href)) {
+      return true
+    }
+    const referrer = document.referrer ?? ''
+    if (
+      referrer &&
+      /hubspot\.(com|net)/i.test(referrer) &&
+      /editor|preview|content\/(page|site)/i.test(referrer)
+    ) {
+      return true
+    }
+  } catch {
+    // ignore
+  }
+  return false
+}
+
+export function isHubSpotCmsEditor(): boolean {
+  if (readHubSpotEditorFlag()) {
+    return true
+  }
+  if (detectEditorFromUrlOrReferrer()) {
+    return true
+  }
+  if (isInNestedIframe() && window.hubSpotData?.isInPreviewer === true) {
+    return true
+  }
+  return false
+}
+
+export function isEditorPreviewMode(): boolean {
+  return isHubSpotCmsEditor() && isInNestedIframe()
+}
+
+export {}

package/examples/greenfield/module-hybrid-cdn-auth-sso/src/hubspot/module-entry.tsx

@@ -0,0 +1,9 @@
+/**
+ * Monolith production entry — single IIFE `module.js` (wp build).
+ * Dev overlay uses `src/main.tsx` instead.
+ */
+import '@/assets/css/main.dev.css'
+
+import { mountPortal } from '@/portal/mount-portal'
+
+void mountPortal()

package/examples/greenfield/module-hybrid-cdn-auth-sso/src/hubspot/types.ts

@@ -0,0 +1,17 @@
+/** Runtime contract for window.hubSpotData (greenfield stub). */
+export type HubSpotPortalData = {
+  dataSourceSet?: unknown
+  hubId?: string | number
+  apiBaseUrlOption?: string
+  userData?: unknown
+  objectList?: unknown[]
+  isInEditor?: boolean
+}
+
+declare global {
+  interface Window {
+    hubSpotData?: HubSpotPortalData
+  }
+}
+
+export {}

package/examples/greenfield/module-hybrid-cdn-auth-sso/src/integrations/configure-woodsportal-sdk.ts

@@ -0,0 +1,94 @@
+import type { LogLevel } from 'woodsportal-client-sdk'
+import {
+  initializeHttpClient,
+  isServiceUnavailableError,
+  setSessionLifecycleListener,
+} from '@/integrations/woodsportal-sdk'
+import { AUTH_SCAFFOLD_TIER } from '@/config/auth-tier'
+import { Routes } from '@/config/routes'
+import { syncSdkHubContextFromRuntime } from '@/data/sync-sdk-hub-context'
+import { resolveHubId } from '@/data/hubSpotContext'
+import { env } from '@/env'
+import { clearClientAuthSession } from '@/features/auth/clear-client-auth-session'
+import { AUTH_SESSION_CHANGED } from '@/features/auth/auth-session-events'
+import { skipCurrentPublicPath } from '@/utils/ValidationSchema'
+import { resolveWoodsPortalApiBaseUrl } from '@/utils/resolve-api-base-url'
+import { isHubSpotCmsEditor } from '@/hubspot/is-cms-editor'
+
+function resolveSdkLogLevel(): LogLevel {
+  const configured = import.meta.env.VITE_SDK_LOG_LEVEL as LogLevel | undefined
+  if (
+    configured === 'debug' ||
+    configured === 'info' ||
+    configured === 'warn' ||
+    configured === 'error' ||
+    configured === 'silent'
+  ) {
+    return configured
+  }
+  return import.meta.env.DEV ? 'debug' : 'info'
+}
+
+/**
+ * Configure woodsportal-client-sdk HTTP before any api.* call.
+ * Tier: {@link AUTH_SCAFFOLD_TIER} (patched by init-auth-scaffold).
+ */
+export function configureWoodsPortalSdk(): void {
+  syncSdkHubContextFromRuntime()
+  const resolvedHubId = resolveHubId()
+  const devPortalId =
+    import.meta.env.DEV && env.VITE_DEV_PORTAL_ID != null && env.VITE_DEV_PORTAL_ID !== ''
+      ? String(env.VITE_DEV_PORTAL_ID)
+      : undefined
+
+  setSessionLifecycleListener(() => {
+    if (typeof window !== 'undefined') {
+      window.dispatchEvent(new CustomEvent(AUTH_SESSION_CHANGED))
+    }
+  })
+
+  initializeHttpClient({
+    baseURL: resolveWoodsPortalApiBaseUrl(),
+    timeout: 50_000,
+    hubId: resolvedHubId != null ? String(resolvedHubId) : undefined,
+    devPortalId,
+    storageMode: isHubSpotCmsEditor() ? 'iframe' : 'cookie',
+    skipCurrentPublicPath,
+    shouldHandleUnauthorized: () => {
+      if (isHubSpotCmsEditor()) {
+        return false
+      }
+            return true
+    },
+    routes: {
+      unauthorized: Routes.unauthorized,
+      login: Routes.login,
+      twoFa: Routes.twoFa,
+      resendEmail: '/resend-email',
+    },
+    onLogout: () => {
+      clearClientAuthSession()
+    },
+    logger: {
+      level: resolveSdkLogLevel(),
+      httpTracing: true,
+    },
+    storageKeys: {
+      loginDetails: env.VITE_LOGIN_DETAILS,
+      refreshToken: env.VITE_REFRESH_TOKEN,
+      portal: env.VITE_PORTAL,
+      subscriptionType: env.VITE_SUBSCRIPTION_TYPE,
+      authUser: env.VITE_AUTH_USER_KEY,
+      pagination: env.VITE_PAGINATION_DATA,
+      routeMenu: env.VITE_ROUTE_MENU_CONFIG_KEY,
+      associationView: env.VITE_ASSOCIATION_VIEW_URL_KEY,
+    },
+    onServiceUnavailable: (error) => {
+      if (isServiceUnavailableError(error)) {
+        console.warn('[WoodsPortal] API unavailable', error)
+      }
+    },
+  })
+
+  void AUTH_SCAFFOLD_TIER
+}

package/examples/greenfield/module-hybrid-cdn-auth-sso/src/integrations/tanstack-query/root-provider.tsx

@@ -0,0 +1,18 @@
+import { QueryClient, QueryClientProvider } from '@tanstack/react-query'
+
+const queryClient = new QueryClient({
+  defaultOptions: {
+    queries: {
+      refetchOnWindowFocus: false,
+      retry: false,
+    },
+  },
+})
+
+export function getContext() {
+  return { queryClient }
+}
+
+export function Provider({ children }: { children: React.ReactNode }) {
+  return <QueryClientProvider client={queryClient}>{children}</QueryClientProvider>
+}

package/examples/greenfield/module-hybrid-cdn-auth-sso/src/integrations/tanstack-router/router.tsx

@@ -0,0 +1,39 @@
+import {
+  createBrowserHistory,
+  createHashHistory,
+  createRouter,
+  type AnyRouter,
+} from '@tanstack/react-router'
+
+import { ROUTER_HISTORY } from '@/config/router'
+import * as TanStackQueryProvider from '@/integrations/tanstack-query/root-provider'
+import { routeTree } from '@/routeTree.gen'
+
+let routerInstance: AnyRouter | null = null
+
+export function getRouter(): AnyRouter {
+  if (!routerInstance) {
+    const history = ROUTER_HISTORY === 'hash' ? createHashHistory() : createBrowserHistory()
+    routerInstance = createRouter({
+      routeTree,
+      context: {
+        ...TanStackQueryProvider.getContext(),
+      },
+      history,
+      defaultPreload: 'intent',
+      scrollRestoration: true,
+      defaultStructuralSharing: true,
+      defaultPreloadStaleTime: 0,
+    })
+  }
+  return routerInstance
+}
+
+/** Eager router export for dev tooling. */
+export const router = getRouter()
+
+declare module '@tanstack/react-router' {
+  interface Register {
+    router: ReturnType<typeof getRouter>
+  }
+}

package/examples/greenfield/module-hybrid-cdn-auth-sso/src/integrations/woodsportal-sdk.ts

@@ -0,0 +1,37 @@
+/**
+ * SDK facade — single import surface for app code.
+ * Dependency: woodsportal-client-sdk ^4.0.7-dev.11 (added by template-auth-deps.ts)
+ */
+export {
+  getHttpErrorMessage,
+  isServiceUnavailableError,
+  initializeHttpClient,
+  setSessionLifecycleListener,
+  recoverMfaGateOnBoot,
+  resolveAuthRouteAction,
+  AuthErrorCode,
+  resolveAuthErrorAction,
+  storeMfaPendingAccessToken,
+  readMfaPendingAccessToken,
+  clearMfaPendingAccessToken,
+  hydrateMfaPendingAccessToken,
+} from 'woodsportal-client-sdk/auth'
+export type {
+  HttpClientConfig,
+  LoginBootstrapResponse,
+  MfaMethod,
+  MfaMethodOption,
+  AuthRouteAction,
+  MfaBootRecoveryResult,
+} from 'woodsportal-client-sdk/auth'
+
+import { api as authApi } from 'woodsportal-client-sdk/auth'
+import { api as crmApi, store } from 'woodsportal-client-sdk/crm'
+
+export const api = {
+  auth: authApi.auth,
+  crm: crmApi.crm,
+  navigation: crmApi.navigation,
+}
+
+export { store }

package/examples/greenfield/module-hybrid-cdn-auth-sso/src/main.tsx

@@ -0,0 +1,5 @@
+import '@/assets/css/main.dev.css'
+
+import { mountDevPreview } from '@/portal/mount-dev-preview'
+
+void mountDevPreview()

package/examples/greenfield/module-hybrid-cdn-auth-sso/src/portal/api-endpoint.ts

@@ -0,0 +1,11 @@
+/**
+ * WoodsPortal REST base URL — baked from .env.stg / .env.prod at CDN build time.
+ * Referenced from app-entry so verify-cdn-api-endpoint.mjs can refuse wrong-tier publishes.
+ */
+export function resolvePortalApiEndpoint(): string {
+  const raw = import.meta.env.VITE_PUBLIC_REST_API_ENDPOINT
+  if (typeof raw !== 'string' || !raw.trim()) {
+    return ''
+  }
+  return raw.replace(/\/$/, '')
+}

package/examples/greenfield/module-hybrid-cdn-auth-sso/src/portal/ensure-portal-cdn-stylesheet.ts

@@ -0,0 +1,115 @@
+declare global {
+  interface Window {
+    hubSpotData?: {
+      assetBaseUrl?: string
+      buildId?: string
+      isInEditor?: boolean
+    }
+    hsInEditor?: boolean
+  }
+}
+
+/** Resolve app.{buildId}.css on the CDN mirror (jsDelivr / custom base). */
+export function portalCdnStylesheetUrl(): string | null {
+  const base = window.hubSpotData?.assetBaseUrl?.replace(/\/$/, '')
+  const buildId = window.hubSpotData?.buildId?.trim()
+  if (!base || !buildId) {
+    return null
+  }
+  return `${base}/app.${buildId}.css`
+}
+
+function isHubSpotCmsEditor(): boolean {
+  if (typeof window === 'undefined') {
+    return false
+  }
+  return (
+    window.hubSpotData?.isInEditor === true ||
+    window.hsInEditor === true
+  )
+}
+
+/** True when HubSpot already loaded merged module.css with dw-prefixed portal utilities. */
+export function hasPrefixedPortalStylesLoaded(): boolean {
+  if (typeof document === 'undefined') {
+    return false
+  }
+
+  for (const link of document.querySelectorAll<HTMLLinkElement>('link[rel="stylesheet"]')) {
+    if (/module\.css/i.test(link.href)) {
+      return true
+    }
+  }
+
+  try {
+    for (const sheet of document.styleSheets) {
+      try {
+        const rules = sheet.cssRules
+        for (let i = 0; i < Math.min(rules.length, 100); i++) {
+          const text = rules[i]?.cssText ?? ''
+          if (text.includes('dw\\:') || text.includes('.dw:')) {
+            return true
+          }
+        }
+      } catch {
+        // Cross-origin stylesheets are not readable.
+      }
+    }
+  } catch {
+    // ignore
+  }
+
+  return false
+}
+
+/** Editor-only fallback when module.css did not load (external CDN CSS blocked in iframe). */
+export function needsPortalCdnStylesheetFallback(): boolean {
+  if (!isHubSpotCmsEditor()) {
+    return false
+  }
+  return !hasPrefixedPortalStylesLoaded()
+}
+
+function waitForStylesheet(link: HTMLLinkElement): Promise<void> {
+  if (link.sheet) {
+    return Promise.resolve()
+  }
+
+  return new Promise((resolve) => {
+    link.addEventListener('load', () => resolve(), { once: true })
+    link.addEventListener('error', () => resolve(), { once: true })
+  })
+}
+
+/** Inject CDN app.{buildId}.css when HubSpot editor preview skipped module.css. */
+export async function ensurePortalCdnStylesheet(): Promise<void> {
+  const href = portalCdnStylesheetUrl()
+  if (!href) {
+    return
+  }
+
+  const marker = 'data-portal-cdn-css'
+  const existing = document.querySelector<HTMLLinkElement>(`link[${marker}]`)
+  if (existing) {
+    if (existing.href === href) {
+      await waitForStylesheet(existing)
+      return
+    }
+    existing.remove()
+  }
+
+  const link = document.createElement('link')
+  link.rel = 'stylesheet'
+  link.href = href
+  link.crossOrigin = 'anonymous'
+  link.setAttribute(marker, 'true')
+  document.head.appendChild(link)
+  await waitForStylesheet(link)
+}
+
+export async function ensurePortalCdnStylesheetIfNeeded(): Promise<void> {
+  if (!needsPortalCdnStylesheetFallback()) {
+    return
+  }
+  await ensurePortalCdnStylesheet()
+}

package/examples/greenfield/module-hybrid-cdn-auth-sso/src/portal/mount-dev-preview.tsx

@@ -0,0 +1,12 @@
+import { mountGreenfieldDev } from '../../.wphs/.kit-bootstrap-greenfield.tsx'
+
+import { App } from '@/app'
+import { getPortalRouter, mountPortal } from '@/portal/mount-portal'
+
+/** Local dev: module-config overlay + auth-aware App shell. */
+export async function mountDevPreview() {
+  await mountGreenfieldDev({
+    beforePreview: () => mountPortal({ skipAppRender: true }),
+    preview: <App router={getPortalRouter()} />,
+  })
+}

package/examples/greenfield/module-hybrid-cdn-auth-sso/src/portal/mount-portal.tsx

@@ -0,0 +1,57 @@
+import { createRoot } from 'react-dom/client'
+import type { AnyRouter } from '@tanstack/react-router'
+
+import { configureWoodsPortalSdk } from '@/integrations/configure-woodsportal-sdk'
+import { syncSdkHubContextFromRuntime } from '@/data/sync-sdk-hub-context'
+import { App } from '@/app'
+import { getRouter } from '@/integrations/tanstack-router/router'
+
+export type MountPortalOptions = {
+  includeGlobalStyles?: boolean
+  skipRuntimeCss?: boolean
+  skipAppRender?: boolean
+}
+
+let portalRouter: AnyRouter | null = null
+
+/** Lazy router — created after optional SSO URL normalization. */
+export function getPortalRouter(): AnyRouter {
+  if (!portalRouter) {
+    portalRouter = getRouter()
+  }
+  return portalRouter
+}
+
+/** @deprecated Prefer getPortalRouter() after mount/bootstrap. */
+export const router = new Proxy({} as AnyRouter, {
+  get(_target, prop) {
+    return Reflect.get(getPortalRouter(), prop)
+  },
+})
+
+/** Mount the portal into `#app` with SDK bootstrap and router. */
+export async function mountPortal(options: MountPortalOptions = {}) {
+  const { skipAppRender = false } = options
+
+  syncSdkHubContextFromRuntime()
+  configureWoodsPortalSdk()
+
+    const { clearLegacySsoCallbackInFlight, ensureSsoCallbackRoute } = await import(
+    '@/features/auth/sso-callback'
+  )
+  clearLegacySsoCallbackInFlight()
+  ensureSsoCallbackRoute()
+  
+  const activeRouter = getPortalRouter()
+
+  if (skipAppRender) {
+    return
+  }
+
+  const rootElement = document.getElementById('app')
+  if (!rootElement) {
+    return
+  }
+
+  createRoot(rootElement).render(<App router={activeRouter} />)
+}

package/examples/greenfield/module-hybrid-cdn-auth-sso/src/routeTree.gen.ts

@@ -0,0 +1,155 @@
+/* eslint-disable */
+// @ts-nocheck
+// TanStack Router generated route tree (starter + SSO tier).
+
+import { Route as rootRouteImport } from './routes/__root'
+import { Route as UnauthorizedRouteImport } from './routes/unauthorized'
+import { Route as GuideRouteImport } from './routes/guide'
+import { Route as IndexRouteImport } from './routes/index'
+import { Route as AuthLoginRouteImport } from './routes/_auth/login'
+import { Route as AuthLoginSsoRouteImport } from './routes/_auth/login/sso'
+import { Route as AppPortalRouteImport } from './routes/_app/portal'
+
+const UnauthorizedRoute = UnauthorizedRouteImport.update({
+  id: '/unauthorized',
+  path: '/unauthorized',
+  getParentRoute: () => rootRouteImport,
+} as any)
+
+const GuideRoute = GuideRouteImport.update({
+  id: '/guide',
+  path: '/guide',
+  getParentRoute: () => rootRouteImport,
+} as any)
+
+const IndexRoute = IndexRouteImport.update({
+  id: '/',
+  path: '/',
+  getParentRoute: () => rootRouteImport,
+} as any)
+
+const AuthLoginRoute = AuthLoginRouteImport.update({
+  id: '/_auth/login',
+  path: '/login',
+  getParentRoute: () => rootRouteImport,
+} as any)
+
+const AuthLoginSsoRoute = AuthLoginSsoRouteImport.update({
+  id: '/_auth/login/sso',
+  path: '/sso',
+  getParentRoute: () => AuthLoginRoute,
+} as any)
+
+const AppPortalRoute = AppPortalRouteImport.update({
+  id: '/_app/portal',
+  path: '/portal',
+  getParentRoute: () => rootRouteImport,
+} as any)
+
+const AuthLoginRouteWithChildren = AuthLoginRoute._addFileChildren({
+  AuthLoginSsoRoute,
+})
+
+export interface FileRoutesByFullPath {
+  '/': typeof IndexRoute
+  '/guide': typeof GuideRoute
+  '/login': typeof AuthLoginRouteWithChildren
+  '/login/sso': typeof AuthLoginSsoRoute
+  '/portal': typeof AppPortalRoute
+  '/unauthorized': typeof UnauthorizedRoute
+}
+
+export interface FileRoutesByTo {
+  '/': typeof IndexRoute
+  '/guide': typeof GuideRoute
+  '/login': typeof AuthLoginRouteWithChildren
+  '/login/sso': typeof AuthLoginSsoRoute
+  '/portal': typeof AppPortalRoute
+  '/unauthorized': typeof UnauthorizedRoute
+}
+
+export interface FileRoutesById {
+  __root__: typeof rootRouteImport
+  '/': typeof IndexRoute
+  '/guide': typeof GuideRoute
+  '/_auth/login': typeof AuthLoginRouteWithChildren
+  '/_auth/login/sso': typeof AuthLoginSsoRoute
+  '/_app/portal': typeof AppPortalRoute
+  '/unauthorized': typeof UnauthorizedRoute
+}
+
+export interface FileRouteTypes {
+  fileRoutesByFullPath: FileRoutesByFullPath
+  fullPaths: '/' | '/guide' | '/login' | '/login/sso' | '/portal' | '/unauthorized'
+  fileRoutesByTo: FileRoutesByTo
+  to: '/' | '/guide' | '/login' | '/login/sso' | '/portal' | '/unauthorized'
+  id: '__root__' | '/' | '/guide' | '/_auth/login' | '/_auth/login/sso' | '/_app/portal' | '/unauthorized'
+  fileRoutesById: FileRoutesById
+}
+
+export interface RootRouteChildren {
+  IndexRoute: typeof IndexRoute
+  GuideRoute: typeof GuideRoute
+  AuthLoginRoute: typeof AuthLoginRouteWithChildren
+  AppPortalRoute: typeof AppPortalRoute
+  UnauthorizedRoute: typeof UnauthorizedRoute
+}
+
+declare module '@tanstack/react-router' {
+  interface FileRoutesByPath {
+    '/unauthorized': {
+      id: '/unauthorized'
+      path: '/unauthorized'
+      fullPath: '/unauthorized'
+      preLoaderRoute: typeof UnauthorizedRouteImport
+      parentRoute: typeof rootRouteImport
+    }
+    '/guide': {
+      id: '/guide'
+      path: '/guide'
+      fullPath: '/guide'
+      preLoaderRoute: typeof GuideRouteImport
+      parentRoute: typeof rootRouteImport
+    }
+    '/': {
+      id: '/'
+      path: '/'
+      fullPath: '/'
+      preLoaderRoute: typeof IndexRouteImport
+      parentRoute: typeof rootRouteImport
+    }
+    '/login': {
+      id: '/_auth/login'
+      path: '/login'
+      fullPath: '/login'
+      preLoaderRoute: typeof AuthLoginRouteImport
+      parentRoute: typeof rootRouteImport
+    }
+    '/login/sso': {
+      id: '/_auth/login/sso'
+      path: '/sso'
+      fullPath: '/login/sso'
+      preLoaderRoute: typeof AuthLoginSsoRouteImport
+      parentRoute: typeof AuthLoginRouteImport
+    }
+    '/portal': {
+      id: '/_app/portal'
+      path: '/portal'
+      fullPath: '/portal'
+      preLoaderRoute: typeof AppPortalRouteImport
+      parentRoute: typeof rootRouteImport
+    }
+  }
+}
+
+const rootRouteChildren: RootRouteChildren = {
+  IndexRoute,
+  GuideRoute,
+  AuthLoginRoute: AuthLoginRouteWithChildren,
+  AppPortalRoute,
+  UnauthorizedRoute,
+}
+
+export const routeTree = rootRouteImport
+  ._addFileChildren(rootRouteChildren)
+  ._addFileTypes<FileRouteTypes>()