npm - @treasuryspatial/surface-kit - Versions diffs - 0.1.9 → 0.1.16 - Mend

@treasuryspatial/surface-kit 0.1.9 → 0.1.16

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (8) hide show

package/dist/index.js CHANGED Viewed

@@ -1,4 +1,300 @@
-import { DEFAULT_COMPOSER_SURFACE_MODE_POLICY, mergeSurfaceModePolicy } from '@treasuryspatial/mode-policy';
+import { DEFAULT_COMPOSER_SURFACE_MODE_POLICY, mergeSurfaceModePolicy, resolveModeLaunchState, } from '@treasuryspatial/mode-policy';
+export const orderSurfaceModeTabs = (tabs) => {
+    const seen = new Set();
+    return tabs.filter((tab) => {
+        const key = `${tab.id}:${tabs.indexOf(tab)}`;
+        if (seen.has(key))
+            return false;
+        seen.add(key);
+        return true;
+    });
+};
+const hasDefinedKeys = (value) => Boolean(value && Object.values(value).some((entry) => entry !== undefined));
+const compactRecord = (value) => Object.fromEntries(Object.entries(value).filter(([, entry]) => entry !== undefined));
+const mergeSurfaceComposerTopbar = (base, override) => {
+    const contexts = base?.contexts || override?.contexts
+        ? ['landing', 'login', 'composer', 'admin'].reduce((acc, context) => {
+            const mergedContext = {
+                ...(base?.contexts?.[context] ?? {}),
+                ...(override?.contexts?.[context] ?? {}),
+            };
+            if (hasDefinedKeys(mergedContext)) {
+                acc[context] = mergedContext;
+            }
+            return acc;
+        }, {})
+        : undefined;
+    const merged = {
+        ...(base ?? {}),
+        ...(override ?? {}),
+        ...(contexts && hasDefinedKeys(contexts) ? { contexts } : {}),
+    };
+    return hasDefinedKeys(merged) ? merged : undefined;
+};
+const hasEntries = (value) => Boolean(value && Object.keys(value).length > 0);
+export const buildClientSkinControlPlaneWarnings = (surfaceLabel, runtimeSource, isClientSkinnedSurface) => {
+    if (!isClientSkinnedSurface)
+        return [];
+    const warnings = [];
+    if (runtimeSource?.modeTabs?.length) {
+        warnings.push(`${surfaceLabel}: modeTabs are control-plane policy and must live in composer_data.`);
+    }
+    if (runtimeSource?.routePolicy) {
+        warnings.push(`${surfaceLabel}: routePolicy is control-plane policy and must live in composer_data.`);
+    }
+    if (runtimeSource?.runtime) {
+        warnings.push(`${surfaceLabel}: runtime/toolset/prompt-pack policy is control-plane data and must live in composer_data.`);
+    }
+    if (runtimeSource?.featureFlags) {
+        warnings.push(`${surfaceLabel}: featureFlags are control-plane policy and must live in composer_data.`);
+    }
+    return warnings;
+};
+export const buildSurfaceTenantUiComposerSeed = (manifest) => {
+    if (!manifest)
+        return null;
+    const typographyCandidate = manifest.theme?.typography
+        ? {
+            fontFamily: manifest.theme.typography.fontFamily,
+            weights: manifest.theme.typography.weights,
+        }
+        : undefined;
+    const typography = typographyCandidate && hasDefinedKeys(typographyCandidate)
+        ? compactRecord(typographyCandidate)
+        : undefined;
+    const topbarCandidate = manifest.topbar
+        ? {
+            title: manifest.topbar.title,
+            subtitle: manifest.topbar.subtitle,
+            productLabel: manifest.topbar.productLabel,
+            productSuffixLabel: manifest.topbar.productSuffixLabel,
+            links: manifest.topbar.links,
+            contexts: manifest.topbar.contexts,
+        }
+        : undefined;
+    const topbar = topbarCandidate && hasDefinedKeys(topbarCandidate)
+        ? compactRecord(topbarCandidate)
+        : undefined;
+    const seed = {
+        ...(typography ? { theme: { typography } } : {}),
+        ...(topbar ? { topbar } : {}),
+    };
+    return hasDefinedKeys(seed) ? seed : null;
+};
+export const buildSurfaceShellNarrative = (spec, overrides = {}) => {
+    const surface = (spec.manifest.surface ?? {});
+    const topbar = (spec.manifest.topbar ?? {});
+    const productLabel = overrides.surfaceTitle ?? spec.navigation?.surfaceTitle ?? topbar.productLabel ?? surface.label ?? spec.id;
+    const summary = typeof surface.summary === 'string' ? surface.summary.trim() : '';
+    const description = typeof surface.description === 'string' ? surface.description.trim() : '';
+    const promptFamily = typeof surface.promptFamily === 'string' ? surface.promptFamily.trim() : '';
+    const scaffoldBadge = typeof surface.scaffoldShell?.badge === 'string' ? surface.scaffoldShell.badge.trim() : '';
+    const sharedSubtitle = overrides.subtitle ?? (summary || description || `Treasury ${productLabel}.`);
+    const loginHeading = overrides.loginHeading ?? topbar.productLabel ?? surface.label ?? productLabel;
+    const loginStrap = overrides.loginStrap ?? sharedSubtitle;
+    const loginBody = overrides.loginBody === null ? undefined : (overrides.loginBody ?? (description || undefined));
+    const loginDisclaimer = overrides.loginDisclaimer === null ? undefined : (overrides.loginDisclaimer ?? spec.content?.login?.disclaimer);
+    const landingHeader = overrides.landingHeader ?? topbar.productLabel ?? surface.label ?? productLabel;
+    const landingStrap = overrides.landingStrap ?? sharedSubtitle;
+    const landingBodyParagraphs = (overrides.landingBodyParagraphs ?? [
+        description || summary || `${productLabel} runs on the shared Treasury runtime.`,
+        promptFamily
+            ? `Prompt family: ${promptFamily}.`
+            : 'Modes, tools, and prompt packs are governed by shared surface policy.',
+        scaffoldBadge
+            ? `${scaffoldBadge} remains shell-level copy while the runtime stays shared.`
+            : 'Branding stays in the skin layer while the runtime remains shared.',
+    ]).filter((entry) => typeof entry === 'string' && entry.trim().length > 0);
+    return {
+        navigation: {
+            surfaceTitle: productLabel,
+            introHref: overrides.introHref ?? spec.navigation?.introHref ?? '/',
+            composeHref: overrides.composeHref ?? spec.navigation?.composeHref ?? '/composer/compose',
+            introTitle: overrides.introTitle ?? spec.navigation?.introTitle,
+            composeTitle: overrides.composeTitle ?? spec.navigation?.composeTitle,
+            searchEnabled: overrides.searchEnabled ?? spec.navigation?.searchEnabled ?? true,
+        },
+        content: {
+            subtitle: sharedSubtitle,
+            login: {
+                heading: loginHeading,
+                strap: loginStrap,
+                body: loginBody,
+                disclaimer: loginDisclaimer,
+            },
+            landing: {
+                header: landingHeader,
+                strap: landingStrap,
+                bodyParagraphs: landingBodyParagraphs,
+            },
+        },
+    };
+};
+const resolveSurfaceModePolicy = (spec) => mergeSurfaceModePolicy(DEFAULT_COMPOSER_SURFACE_MODE_POLICY, (spec.manifest.modes ?? {}));
+const resolveModeHref = (composeHref, modeId, defaultModeId) => {
+    if (modeId === 'images') {
+        if (composeHref.endsWith('/compose')) {
+            return `${composeHref.slice(0, -'/compose'.length)}/images`;
+        }
+        return '/composer/images';
+    }
+    if (!modeId || modeId === defaultModeId)
+        return composeHref;
+    const separator = composeHref.includes('?') ? '&' : '?';
+    return `${composeHref}${separator}mode=${encodeURIComponent(modeId)}`;
+};
+export const buildSurfaceModeTabs = (spec, options = {}) => {
+    const policy = resolveSurfaceModePolicy(spec);
+    if (Object.prototype.hasOwnProperty.call(policy.modes ?? {}, 'gallery')) {
+        throw new Error(`${spec.id}: gallery is a first-class route and must not be authored as a composer mode.`);
+    }
+    const composeHref = options.composeHref ?? spec.navigation?.composeHref ?? '/composer/compose';
+    const gatedModeIds = new Set([...(spec.routePolicy?.gatedModeIds ?? []), ...(options.gatedModeIds ?? [])]);
+    const visibleModeIds = Object.keys(policy.modes ?? {}).filter((modeId) => resolveModeLaunchState(modeId, policy) === 'live');
+    const defaultModeId = policy.defaultMode && visibleModeIds.includes(policy.defaultMode) ? policy.defaultMode : undefined;
+    const orderedModeIds = defaultModeId
+        ? [defaultModeId, ...visibleModeIds.filter((modeId) => modeId !== defaultModeId)]
+        : visibleModeIds;
+    const canonicalModeIds = (() => {
+        if (orderedModeIds.includes('images'))
+            return orderedModeIds;
+        const coreModeIds = new Set(['imagine', 'design', 'map']);
+        const lastCoreIndex = orderedModeIds.reduce((latestIndex, modeId, index) => (coreModeIds.has(modeId) ? index : latestIndex), -1);
+        if (lastCoreIndex === -1)
+            return [...orderedModeIds, 'images'];
+        return [
+            ...orderedModeIds.slice(0, lastCoreIndex + 1),
+            'images',
+            ...orderedModeIds.slice(lastCoreIndex + 1),
+        ];
+    })();
+    return orderSurfaceModeTabs(canonicalModeIds.map((modeId) => ({
+        id: modeId,
+        label: modeId === 'images' ? 'image stream' : policy.modes?.[modeId]?.label ?? modeId,
+        href: resolveModeHref(composeHref, modeId, defaultModeId),
+        requiresAdmin: gatedModeIds.has(modeId) || undefined,
+    })));
+};
+export const buildSurfaceRuntimeAvailability = (spec) => {
+    if (!spec.runtime) {
+        return undefined;
+    }
+    const surfaceId = spec.id.trim();
+    const promptFamily = spec.manifest.surface?.promptFamily?.trim() || surfaceId;
+    const toolCatalogSource = spec.runtime.toolCatalogSource;
+    if (toolCatalogSource !== 'registry-live' && toolCatalogSource !== 'toolset') {
+        throw new Error(`${surfaceId}: runtime.toolCatalogSource must be explicitly set to "registry-live" or "toolset". Legacy shell defaults are removed.`);
+    }
+    const toolsetId = toolCatalogSource === 'toolset'
+        ? spec.runtime.toolsetId?.trim() || spec.runtime.toolset?.id?.trim()
+        : undefined;
+    if (toolCatalogSource === 'toolset' && !toolsetId) {
+        throw new Error(`${surfaceId}: runtime.toolsetId or runtime.toolset.id is required when runtime.toolCatalogSource is "toolset".`);
+    }
+    const promptPolicyId = spec.runtime.promptPolicyId?.trim() || spec.runtime.promptPolicy?.id?.trim() || promptFamily;
+    const visibleToolIds = spec.runtime.visibleToolIds?.map((toolId) => toolId.trim()).filter(Boolean);
+    const hiddenToolIds = spec.runtime.hiddenToolIds?.map((toolId) => toolId.trim()).filter(Boolean);
+    const promptPackCatalogMode = spec.runtime.promptPackCatalogMode ?? (surfaceId === 'composer' ? 'all' : 'surface');
+    const moduleCatalogMode = spec.runtime.moduleCatalogMode ?? (surfaceId === 'composer' ? 'all' : 'surface');
+    return {
+        toolCatalogSource,
+        toolset: toolsetId ? { id: toolsetId } : undefined,
+        toolsetId: toolsetId || undefined,
+        promptPolicy: { id: promptPolicyId },
+        promptPolicyId,
+        visibleToolIds: visibleToolIds && visibleToolIds.length > 0 ? visibleToolIds : undefined,
+        hiddenToolIds: hiddenToolIds && hiddenToolIds.length > 0 ? hiddenToolIds : undefined,
+        promptPackCatalogMode,
+        moduleCatalogMode,
+    };
+};
+export const buildSurfaceComposerDataDocument = (target, spec, overrides = {}) => {
+    const isClientSkinnedSurface = spec.manifest.surface?.brandProfile === 'client-skinned';
+    const controlPlaneWarnings = buildClientSkinControlPlaneWarnings(spec.id, spec, isClientSkinnedSurface).concat(buildClientSkinControlPlaneWarnings(spec.id, overrides, isClientSkinnedSurface));
+    const mergedContent = spec.content || overrides.content
+        ? {
+            subtitle: overrides.content?.subtitle ?? spec.content?.subtitle,
+            login: overrides.content?.login ?? spec.content?.login,
+            landing: overrides.content?.landing ?? spec.content?.landing,
+        }
+        : undefined;
+    const mergedTopbar = mergeSurfaceComposerTopbar(spec.manifest.topbar
+        ? {
+            secondaryLogo: spec.manifest.topbar.secondaryLogo,
+            title: spec.manifest.topbar.title,
+            subtitle: spec.manifest.topbar.subtitle,
+            productLabel: spec.manifest.topbar.productLabel,
+            productSuffixLabel: spec.manifest.topbar.productSuffixLabel,
+            links: spec.manifest.topbar.links,
+            contexts: spec.manifest.topbar.contexts,
+        }
+        : undefined, overrides.topbar);
+    const mergedRuntime = overrides.runtime || (!isClientSkinnedSurface && spec.runtime)
+        ? {
+            ...(!isClientSkinnedSurface ? (spec.runtime ?? {}) : {}),
+            ...(overrides.runtime ?? {}),
+        }
+        : undefined;
+    const runtimeAvailability = !isClientSkinnedSurface && spec.runtime ? buildSurfaceRuntimeAvailability(spec) : undefined;
+    const runtimeToolCatalogSource = mergedRuntime?.toolCatalogSource ?? runtimeAvailability?.toolCatalogSource;
+    const runtimeToolset = mergedRuntime?.toolset ?? runtimeAvailability?.toolset;
+    const runtimeToolsetId = mergedRuntime?.toolsetId ?? runtimeAvailability?.toolsetId;
+    const runtimePromptPolicy = mergedRuntime?.promptPolicy ?? runtimeAvailability?.promptPolicy;
+    const runtimePromptPolicyId = mergedRuntime?.promptPolicyId ?? runtimeAvailability?.promptPolicyId;
+    const runtimePromptPackCatalogMode = mergedRuntime?.promptPackCatalogMode ?? runtimeAvailability?.promptPackCatalogMode;
+    const runtimeModuleCatalogMode = mergedRuntime?.moduleCatalogMode ?? runtimeAvailability?.moduleCatalogMode;
+    const mergedFeatureFlags = overrides.featureFlags || (!isClientSkinnedSurface && spec.featureFlags)
+        ? {
+            ...(!isClientSkinnedSurface ? (spec.featureFlags ?? {}) : {}),
+            ...(overrides.featureFlags ?? {}),
+        }
+        : undefined;
+    return {
+        tenantSlug: target.tenantSlug,
+        subtenantSlug: target.subtenantSlug ?? null,
+        surfaceId: target.surfaceId,
+        title: overrides.title ??
+            spec.navigation?.surfaceTitle ??
+            spec.manifest.surface?.label ??
+            spec.manifest.topbar?.productLabel ??
+            spec.id,
+        lockedLabel: overrides.lockedLabel,
+        topbar: mergedTopbar ? compactRecord(mergedTopbar) : undefined,
+        navigation: overrides.navigation ?? spec.navigation,
+        content: mergedContent,
+        modeTabs: overrides.modeTabs ||
+            (!isClientSkinnedSurface && (spec.modeTabs || buildSurfaceModeTabs(spec)))
+            ? orderSurfaceModeTabs((overrides.modeTabs ??
+                (!isClientSkinnedSurface ? spec.modeTabs ?? buildSurfaceModeTabs(spec) : undefined)))
+            : undefined,
+        routePolicy: overrides.routePolicy || (!isClientSkinnedSurface && spec.routePolicy)
+            ? {
+                ...(!isClientSkinnedSurface ? (spec.routePolicy ?? {}) : {}),
+                ...(overrides.routePolicy ?? {}),
+            }
+            : undefined,
+        runtime: mergedRuntime || runtimeAvailability
+            ? {
+                ...(mergedRuntime ?? {}),
+                ...(runtimeToolCatalogSource ? { toolCatalogSource: runtimeToolCatalogSource } : {}),
+                ...(runtimeToolset ? { toolset: runtimeToolset } : {}),
+                ...(runtimeToolsetId ? { toolsetId: runtimeToolsetId } : {}),
+                ...(runtimePromptPolicy ? { promptPolicy: runtimePromptPolicy } : {}),
+                ...(runtimePromptPolicyId ? { promptPolicyId: runtimePromptPolicyId } : {}),
+                ...(runtimePromptPackCatalogMode ? { promptPackCatalogMode: runtimePromptPackCatalogMode } : {}),
+                ...(runtimeModuleCatalogMode ? { moduleCatalogMode: runtimeModuleCatalogMode } : {}),
+            }
+            : undefined,
+        featureFlags: mergedFeatureFlags,
+        controlPlaneWarnings: controlPlaneWarnings.length > 0 ? controlPlaneWarnings : undefined,
+        assetAccess: overrides.assetAccess,
+    };
+};
+export const buildSurfaceCanonicalProvisioning = (target, spec, options = {}) => ({
+    tenantBranding: options.tenantBranding,
+    tenantUiComposer: buildSurfaceTenantUiComposerSeed(spec.manifest),
+    composerData: buildSurfaceComposerDataDocument(target, spec, options.composerData),
+});
 export const DEFAULT_MARKETING_SLUGS = [
     'localhost',
     'treasury',
@@ -19,7 +315,7 @@ export const TREASURY_BASE_UI_MANIFEST = {
         id: 'composer',
         family: 'composer',
         label: 'Composer',
-        promptFamily: 'composer',
+        promptFamily: 'spatial',
         brandProfile: 'treasury-native',
         summary: 'Treasury design and render surface.',
         standaloneCapable: true,
@@ -32,8 +328,8 @@ export const TREASURY_BASE_UI_MANIFEST = {
     },
     theme: {
         typography: {
-            fontFamily: "'Aeonik', system-ui, -apple-system, BlinkMacSystemFont, sans-serif",
-            weights: [300, 400, 500],
+            fontFamily: "'Aeonik', -apple-system, BlinkMacSystemFont, system-ui, sans-serif",
+            weights: [300, 500, 700],
         },
     },
     layout: {
@@ -47,7 +343,6 @@ export const TREASURY_BASE_UI_MANIFEST = {
         productLabel: 'Composer',
         links: [
             { label: 'Treasury', href: 'https://treasury.space', target: '_blank' },
-            { label: 'Science', href: 'https://science.treasury.space', target: '_blank' },
         ],
     },
     modules: {
@@ -55,24 +350,25 @@ export const TREASURY_BASE_UI_MANIFEST = {
         panelTabs: [
             { id: 'scene', label: 'scene' },
             { id: 'controls', label: 'controls' },
+            { id: 'map-controls', label: 'map controls' },
             { id: 'lighting', label: 'lighting' },
             { id: 'materials', label: 'materials' },
             { id: 'render', label: 'render' },
-            { id: 'presets', label: 'presets' },
+            { id: 'compositions', label: 'compositions' },
             { id: 'upload', label: 'upload' },
         ],
         rightRail: {
             enabled: true,
-            defaultOpen: false,
-            defaultTab: 'images',
+            defaultOpen: true,
+            defaultTab: 'feed',
             tabs: [
-                { id: 'images', label: 'images' },
+                { id: 'feed', label: 'feed' },
                 { id: 'metrics', label: 'metrics' },
                 { id: 'feedback', label: 'feedback' },
             ],
         },
-        metricsPanel: { enabled: true, defaultOpen: false },
-        inspector: { enabled: true, defaultOpen: true },
+        metricsPanel: { enabled: true, defaultOpen: true },
+        inspector: { enabled: true, defaultOpen: false },
         hud: { enabled: true },
         viewControls: { enabled: true },
         veils: { enabled: true, defaultOn: false },
@@ -86,6 +382,10 @@ export const TRANSITGUY_LOGO = {
     src: 'https://images.squarespace-cdn.com/content/v1/60074cff46d4c56a53f5b0f8/c9051ab0-28f7-4840-ae97-4d70737abffe/the%2Btransit%2Bgay%2Blogo%2B%281%29.png',
     alt: 'The Transit Guy',
 };
+export const COURTYARD_URBANIST_LOGO = {
+    src: '/postcard/courtyard-urbanist.png',
+    alt: 'Courtyard Urbanist',
+};
 const buildManifestImage = (src, alt) => {
     if (!src)
         return null;
@@ -188,9 +488,7 @@ export const resolveSurfaceBrandingImages = (target, payload) => {
         target.surfaceLabel ||
         'Subtenant';
     const topbarLogo = buildManifestImage(primaryLogoSrc, resolvedPrimaryAlt);
-    const subtenantLogo = subtenantLogoSrc && subtenantLogoSrc !== primaryLogoSrc
-        ? buildManifestImage(subtenantLogoSrc, resolvedSubtenantAlt)
-        : null;
+    const subtenantLogo = subtenantLogoSrc ? buildManifestImage(subtenantLogoSrc, resolvedSubtenantAlt) : null;
     return {
         topbarLogo,
         subtenantLogo,
@@ -275,32 +573,55 @@ export const mapSurfaceBrandingManifestImages = (manifest, mapSrc) => {
             : manifest.surface,
     };
 };
-const TRANSIT_MODE_POLICY = mergeSurfaceModePolicy(DEFAULT_COMPOSER_SURFACE_MODE_POLICY, {
-    defaultMode: 'streetmix',
+const COMPOSER_MODE_POLICY = mergeSurfaceModePolicy(DEFAULT_COMPOSER_SURFACE_MODE_POLICY, {
     modes: {
-        design: {
-            launchState: 'hidden',
-            shell: { leftPanelOpen: false },
+        streetmix: {
+            enabled: true,
+            label: 'streetmix',
         },
-        map: {
-            launchState: 'coming-soon',
-            panelTabs: ['render'],
-            defaultPanelTab: 'render',
-            kits: { upload: false, 'compute-target': false },
-            modules: { hud: false, inspector: false, viewControls: false },
-            actions: { 'generate-geometry': false, 'asset-download': false },
-            shell: { leftPanelOpen: false },
+        streetview: {
+            enabled: true,
+            label: 'streetview',
         },
+    },
+});
+const TRANSIT_MODE_POLICY = mergeSurfaceModePolicy(DEFAULT_COMPOSER_SURFACE_MODE_POLICY, {
+    defaultMode: 'imagine',
+    modes: {
         streetmix: {
             enabled: true,
             label: 'streetmix',
-            panelTabs: ['render'],
-            defaultPanelTab: 'render',
-            kits: { upload: false, 'compute-target': false },
-            actions: { 'generate-geometry': false, 'asset-download': false },
+        },
+        streetview: {
+            enabled: true,
+            label: 'streetview',
         },
     },
 });
+const SCIENCE_MODE_POLICY = {
+    defaultMode: 'design',
+    modes: {
+        imagine: DEFAULT_COMPOSER_SURFACE_MODE_POLICY.modes?.imagine ?? { label: 'imagine' },
+        design: {
+            ...(DEFAULT_COMPOSER_SURFACE_MODE_POLICY.modes?.design ?? { label: 'design' }),
+            shell: { leftPanelOpen: true, rightPanelOpen: true, metricsOpen: true, inspectorOpen: false },
+        },
+        map: {
+            ...(DEFAULT_COMPOSER_SURFACE_MODE_POLICY.modes?.map ?? { label: 'map' }),
+            shell: { leftPanelOpen: true, rightPanelOpen: true, metricsOpen: true, inspectorOpen: false },
+        },
+    },
+};
+const SCIENCE_BRAND_COLORS = {
+    primary: '#314390',
+    secondary: '#0b1320',
+    background: '#f9f9f9',
+    panel: '#ffffff',
+    panelBorder: '#e5e7eb',
+    textPrimary: '#0f172a',
+    textSecondary: '#64748b',
+    accent: '#263773',
+};
 export const SURFACE_KITS = {
     composer: {
         id: 'composer',
@@ -308,8 +629,8 @@ export const SURFACE_KITS = {
             surface: {
                 id: 'composer',
                 family: 'composer',
-                label: 'Composer',
-                promptFamily: 'composer',
+                label: 'Spatial Composer',
+                promptFamily: 'spatial',
                 brandProfile: 'treasury-native',
                 summary: 'Treasury design and render surface.',
                 standaloneCapable: true,
@@ -318,6 +639,10 @@ export const SURFACE_KITS = {
                 profile: 'treasury-native',
                 poweredBy: { enabled: false },
             },
+            modes: {
+                defaultMode: COMPOSER_MODE_POLICY.defaultMode,
+                modes: COMPOSER_MODE_POLICY.modes,
+            },
         },
     },
     transit: {
@@ -327,16 +652,12 @@ export const SURFACE_KITS = {
             surface: {
                 id: 'transit',
                 family: 'transit',
-                label: 'Transit',
+                label: 'Transit Composer',
                 promptFamily: 'transit',
                 brandProfile: 'treasury-native',
-                summary: 'Transit surface built on the Composer runtime.',
-                description: 'Transit is the packaged surface for corridor visuals, stop environments, and street-section scaffold workflows.',
+                summary: 'Spatial Assets for Transit System Visualization and Development',
+                description: 'Treasury Transit Composer is an asset development system for public transit design, communication, and development. It enables calibrated, replicable visual renders at any location, using Streetmix, Google Street View, and custom 3D modelling tools.',
                 standaloneCapable: true,
-                scaffoldShell: {
-                    badge: 'Streetmix',
-                    footerText: 'Surface logos, copy, and support content live in the Treasury shell. Embedded Streetmix runtime customization remains a separate adapter concern.',
-                },
             },
             branding: {
                 profile: 'treasury-native',
@@ -346,7 +667,7 @@ export const SURFACE_KITS = {
             },
             topbar: {
                 title: 'Treasury',
-                productLabel: 'Composer',
+                productLabel: 'Transit Composer',
                 links: [
                     { label: 'Treasury', href: 'https://treasury.space/', target: '_blank' },
                     { label: 'Composer', href: 'https://composer.treasury.space/', target: '_blank' },
@@ -365,7 +686,7 @@ export const SURFACE_KITS = {
             surface: {
                 id: 'courtyard',
                 family: 'courtyard',
-                label: 'Courtyard',
+                label: 'Courtyard Composer',
                 promptFamily: 'courtyard',
                 brandProfile: 'treasury-native',
                 summary: 'Treasury-native courtyard surface built on shared Composer kits.',
@@ -380,12 +701,83 @@ export const SURFACE_KITS = {
             },
             topbar: {
                 title: 'Treasury',
-                productLabel: 'Composer',
+                productLabel: 'Courtyard Composer',
                 links: [
                     { label: 'Treasury', href: 'https://treasury.space/', target: '_blank' },
                     { label: 'Composer', href: 'https://composer.treasury.space/', target: '_blank' },
                 ],
             },
+            modes: {
+                defaultMode: DEFAULT_COMPOSER_SURFACE_MODE_POLICY.defaultMode,
+                modes: DEFAULT_COMPOSER_SURFACE_MODE_POLICY.modes,
+            },
+        },
+    },
+    science: {
+        id: 'science',
+        manifest: {
+            tenantId: 'science',
+            surface: {
+                id: 'science',
+                family: 'science',
+                label: 'Science Composer',
+                promptFamily: 'spatial',
+                brandProfile: 'treasury-native',
+                summary: 'Calibrated Spatial Environments for Human Science',
+                description: 'Treasury Science Composer is a calibrated environment design and rendering surface for spatial cognition, perception, and research-facing scene development.',
+                standaloneCapable: true,
+            },
+            branding: {
+                profile: 'treasury-native',
+                poweredBy: {
+                    enabled: false,
+                },
+            },
+            topbar: {
+                title: 'Treasury',
+                productLabel: 'Science',
+                contexts: {
+                    composer: {
+                        productSuffixLabel: 'Spatial Composer',
+                    },
+                    admin: {
+                        productSuffixLabel: 'Spatial Composer',
+                    },
+                },
+                links: [
+                    { label: 'Treasury', href: 'https://treasury.space/', target: '_blank' },
+                    { label: 'Spatial Composer', href: 'https://composer.treasury.space/', target: '_blank' },
+                ],
+            },
+            modules: {
+                rightRail: {
+                    enabled: true,
+                    defaultOpen: true,
+                    defaultTab: 'data',
+                    tabs: [
+                        { id: 'metrics', label: 'metrics' },
+                        { id: 'data', label: 'data' },
+                        { id: 'feed', label: 'feed' },
+                        { id: 'feedback', label: 'feedback' },
+                    ],
+                },
+                metricsPanel: { enabled: true, defaultOpen: true },
+                inspector: { enabled: true, defaultOpen: false },
+                hud: { enabled: true },
+                viewControls: { enabled: true },
+                veils: { enabled: true, defaultOn: false },
+            },
+            modes: {
+                defaultMode: SCIENCE_MODE_POLICY.defaultMode,
+                modes: SCIENCE_MODE_POLICY.modes,
+            },
+            theme: {
+                typography: {
+                    fontFamily: "'Aeonik', -apple-system, BlinkMacSystemFont, system-ui, sans-serif",
+                    weights: [300, 500, 700],
+                },
+                colors: SCIENCE_BRAND_COLORS,
+            },
         },
     },
 };
@@ -397,11 +789,11 @@ export const SURFACE_SKINS = {
             surface: {
                 id: 'transitguy',
                 family: 'transit',
-                label: 'Transit',
+                label: 'Composer',
                 promptFamily: 'transit',
                 brandProfile: 'client-skinned',
                 summary: 'Client-skinned transit surface built on the Treasury Transit runtime.',
-                description: 'Transitguy runs as a branded skin of the Treasury Transit surface, keeping scaffold-first transit modes and Treasury runtime behavior while swapping client identity and content.',
+                description: 'Transitguy runs as a branded skin of the Treasury Transit surface, keeping street-structure transit modes and Treasury runtime behavior while swapping client identity and content.',
                 scaffoldShell: {
                     badge: 'Streetmix',
                     secondaryLogo: TRANSITGUY_LOGO,
@@ -438,6 +830,49 @@ export const SURFACE_SKINS = {
             },
         },
     },
+    courtyardurbanist: {
+        id: 'courtyardurbanist',
+        manifest: {
+            tenantId: 'courtyardurbanist',
+            surface: {
+                id: 'courtyardurbanist',
+                family: 'courtyard',
+                label: 'Composer',
+                promptFamily: 'courtyard',
+                brandProfile: 'client-skinned',
+                summary: 'Client-skinned courtyard surface built on the Treasury Courtyard runtime.',
+                description: 'Courtyard Urbanist runs as a branded skin of the Treasury Courtyard surface, keeping the courtyard prompt packs, gallery flows, and shared runtime behavior while swapping client identity and shell voice.',
+            },
+            branding: {
+                profile: 'client-skinned',
+                poweredBy: {
+                    enabled: true,
+                    href: 'https://treasury.space',
+                    logo: TREASURY_LOGO,
+                    kicker: 'Powered by',
+                    labelPrefix: 'Treasury',
+                    labelAccent: 'Courtyard Runtime',
+                },
+            },
+            theme: {
+                typography: {
+                    fontFamily: "'Epilogue', system-ui, -apple-system, BlinkMacSystemFont, sans-serif",
+                    weights: [400, 700],
+                },
+            },
+            topbar: {
+                logo: COURTYARD_URBANIST_LOGO,
+                secondaryLogo: TREASURY_LOGO,
+                title: 'Urbanist',
+                subtitle: 'Courtyard skin on Treasury Composer',
+                productLabel: 'Composer',
+                links: [
+                    { label: 'Treasury', href: 'https://treasury.space/', target: '_blank' },
+                    { label: 'Composer', href: 'https://composer.treasury.space/', target: '_blank' },
+                ],
+            },
+        },
+    },
 };
 export const SURFACE_HOST_PRESETS = {
     composer: {
@@ -454,7 +889,7 @@ export const SURFACE_HOST_PRESETS = {
         subtenantSlug: 'transit',
         surfaceId: 'transit',
         brandProfile: 'treasury-native',
-        compatibilityMode: 'tenant-subtenant-bridge',
+        compatibilityMode: 'direct-tenant',
     },
     transitguy: {
         tenantSlug: 'transitguy',
@@ -464,15 +899,80 @@ export const SURFACE_HOST_PRESETS = {
         brandProfile: 'client-skinned',
         compatibilityMode: 'direct-tenant',
     },
+    'transit-test': {
+        tenantSlug: 'treasury',
+        effectiveTenantSlug: 'transit',
+        subtenantSlug: 'transit',
+        surfaceId: 'transit',
+        brandProfile: 'treasury-native',
+        compatibilityMode: 'direct-tenant',
+    },
+    'neu-new': {
+        tenantSlug: 'neu',
+        effectiveTenantSlug: 'neu',
+        subtenantSlug: null,
+        surfaceId: 'composer',
+        brandProfile: 'client-skinned',
+        compatibilityMode: 'direct-tenant',
+    },
+    neu: {
+        tenantSlug: 'neu',
+        effectiveTenantSlug: 'neu',
+        subtenantSlug: null,
+        surfaceId: 'composer',
+        brandProfile: 'client-skinned',
+        compatibilityMode: 'direct-tenant',
+    },
+    'neu-test': {
+        tenantSlug: 'neu',
+        effectiveTenantSlug: 'neu',
+        subtenantSlug: null,
+        surfaceId: 'composer',
+        brandProfile: 'client-skinned',
+        compatibilityMode: 'direct-tenant',
+    },
+    courtyardurbanist: {
+        tenantSlug: 'courtyardurbanist',
+        effectiveTenantSlug: 'courtyardurbanist',
+        subtenantSlug: null,
+        surfaceId: 'courtyard',
+        brandProfile: 'client-skinned',
+        compatibilityMode: 'direct-tenant',
+    },
+    'courtyard-test': {
+        tenantSlug: 'treasury',
+        effectiveTenantSlug: 'courtyard',
+        subtenantSlug: 'courtyard',
+        surfaceId: 'courtyard',
+        brandProfile: 'treasury-native',
+        compatibilityMode: 'direct-tenant',
+    },
     courtyard: {
         tenantSlug: 'treasury',
         effectiveTenantSlug: 'courtyard',
         subtenantSlug: 'courtyard',
         surfaceId: 'courtyard',
         brandProfile: 'treasury-native',
-        compatibilityMode: 'tenant-subtenant-bridge',
+        compatibilityMode: 'direct-tenant',
+    },
+    science: {
+        tenantSlug: 'treasury',
+        effectiveTenantSlug: 'science',
+        subtenantSlug: 'science',
+        surfaceId: 'science',
+        brandProfile: 'treasury-native',
+        compatibilityMode: 'direct-tenant',
+    },
+    scienv: {
+        tenantSlug: 'treasury',
+        effectiveTenantSlug: 'science',
+        subtenantSlug: 'science',
+        surfaceId: 'science',
+        brandProfile: 'treasury-native',
+        compatibilityMode: 'direct-tenant',
     },
 };
+const EXPLICIT_HOST_PRESETS = new Set(Object.keys(SURFACE_HOST_PRESETS).filter((key) => key !== 'composer' && key !== 'transit'));
 export const resolveSurfaceKitProfile = (surfaceId) => {
     const normalized = String(surfaceId || '').trim().toLowerCase();
     return SURFACE_KITS[normalized] ?? null;
@@ -525,7 +1025,11 @@ export const createSurfaceHostResolver = (options) => {
         const candidate = hostname.split('.')[0] ?? '';
         const normalizedCandidate = candidate.toLowerCase();
         const marketingHost = !normalizedCandidate || marketingSlugs.has(normalizedCandidate);
-        const hostSlug = marketingHost ? fallbackHostSlug : normalizedCandidate;
+        const hostSlug = (normalizedCandidate && EXPLICIT_HOST_PRESETS.has(normalizedCandidate)
+            ? normalizedCandidate
+            : marketingHost
+                ? fallbackHostSlug
+                : normalizedCandidate) || fallbackHostSlug;
         const preset = hostPresets[hostSlug] ??
             buildDirectTenantContext(hostSlug, {
                 defaultTenantSlug: options.defaultTenantSlug,