@bleedingdev/modern-js-create 3.5.0-ultramodern.9 → 3.5.0-ultramodern.90

package/dist/types/ultramodern-workspace/policy.d.ts

@@ -1,53 +1,8 @@
+import type { ResolvedUltramodernPackageSource } from '../ultramodern-package-source';
+import { type UltramodernReleaseCohort } from '../ultramodern-release-cohort';
 import type { JsonValue, WorkspaceApp } from './types';
-export declare function createCloudflareProofRoute(app: WorkspaceApp): JsonValue;
 export declare function createCloudflareSecurityContract(): JsonValue;
-export declare const PUBLIC_WEBSITE_POLICY: {
-    qualityGates: {
-        publicRoutes: {
-            requireSitemapWhenPresent: boolean;
-            requireRobotsSitemapConsistency: boolean;
-            requireWebManifestWhenPresent: boolean;
-        };
-        statusCodes: {
-            notFoundRoute: string;
-            unknownRouteStatus: number;
-        };
-        indexing: {
-            previewNoindex: boolean;
-            productionPublicRoutesIndexable: boolean;
-        };
-        assets: {
-            cssPreloadRequired: boolean;
-            cssResponseRequired: boolean;
-            cacheControlRequiredForCss: boolean;
-            sourcemapsPubliclyReferenced: boolean;
-        };
-        budgets: {
-            ssrHtmlMaxBytes: number;
-            mfManifestMaxBytes: number;
-            localeJsonMaxBytes: number;
-            sitemapXmlMaxBytes: number;
-            cssAssetMaxBytes: number;
-        };
-        csp: {
-            finalMode: string;
-            decision: string;
-        };
-    };
-    publicHead: {
-        indexableRobots: string;
-        privateRouteRobots: string;
-    };
-    publicSurface: {
-        defaultProviderFile: string;
-        draftPolicy: string;
-        indexablePolicy: string;
-    };
-};
 export declare function formatTsJsonValue(value: JsonValue, indent: number): string;
-export declare function formatIntegerCodeLiteral(value: number): string;
-export declare function createPublicWebsiteQualityGateContract(): JsonValue;
-export declare function createPublicWebsiteBudgetFallback(budgetName: keyof (typeof PUBLIC_WEBSITE_POLICY)['qualityGates']['budgets']): string;
 export declare function createPublicHeadRobotsPolicy(): {
     indexableRobots: string;
     privateRouteRobots: string;
@@ -58,3 +13,255 @@ export declare function createPublicSurfaceContentExpansionPolicy(): {
     indexablePolicy: string;
 };
 export declare function createCloudflareDeployContract(scope: string, app: WorkspaceApp): JsonValue;
+export type UltramodernReleaseAgeApproval = {
+    packageName: string;
+    version: string;
+    reason: string;
+    reviewer: string;
+    reviewedAt: string;
+    evidence: {
+        uri: string;
+        sha256: string;
+        sha256Subject: 'git-commit-payload';
+    };
+    registry: {
+        publishedAt: string;
+        dist: {
+            integrity: string;
+        };
+    };
+    expiresAt: string;
+};
+export type UltramodernReleaseAgeCandidate = {
+    packageName: string;
+    version: string;
+    registry: {
+        publishedAt?: string;
+        dist: {
+            integrity: string;
+        };
+    };
+};
+export type UltramodernPatchPolicy = {
+    packageName: string;
+    version: string;
+    path: string;
+};
+export type UltramodernStalePatchPolicy = UltramodernPatchPolicy & {
+    sha256: string;
+    acceptedLegacySha256?: readonly string[];
+};
+export declare const ULTRAMODERN_PACKAGE_PINS: {
+    readonly appDependencies: {
+        readonly '@module-federation/bridge-react': "2.8.0";
+        readonly '@module-federation/modern-js-v3': "2.8.0";
+        readonly '@module-federation/runtime': "2.8.0";
+        readonly '@tanstack/react-router': "1.170.17";
+        readonly i18next: "26.3.6";
+        readonly 'node-fetch': "^3.3.2";
+        readonly react: "19.2.7";
+        readonly 'react-dom': "19.2.7";
+        readonly 'react-router': "7.18.1";
+    };
+    readonly appDevDependencies: {
+        readonly '@effect/tsgo': "0.19.0";
+        readonly '@rsbuild/plugin-tailwindcss': "^2.0.3";
+        readonly '@typescript/native': "npm:typescript@7.0.2";
+        readonly '@types/node': '^20';
+        readonly '@types/react': "^19.2.17";
+        readonly '@types/react-dom': "^19.2.3";
+        readonly tailwindcss: "^4.3.2";
+        readonly typescript: "7.0.2";
+        readonly wrangler: "4.110.0";
+        readonly 'zephyr-rspack-plugin': "1.1.1";
+    };
+    readonly rootDevDependencies: {
+        readonly '@effect/tsgo': "0.19.0";
+        readonly '@typescript/native': "npm:typescript@7.0.2";
+        readonly lefthook: "^2.1.10";
+        readonly miniflare: "4.20260708.1";
+        readonly oxlint: "1.73.0";
+        readonly oxfmt: "0.58.0";
+        readonly ultracite: "7.9.3";
+        readonly wrangler: "4.110.0";
+        readonly 'zephyr-agent': "1.1.1";
+    };
+    readonly transitiveDependencies: {
+        readonly '@cloudflare/workers-types': "5.20260710.1";
+        readonly '@module-federation/node': "2.7.47";
+        readonly '@tanstack/router-core': "1.171.14";
+        readonly '@typescript/native-preview': "7.0.0-dev.20260707.2";
+        readonly miniflare: "4.20260708.1";
+        readonly workerd: "1.20260708.1";
+    };
+};
+export declare const ULTRAMODERN_WORKSPACE_POLICY: {
+    readonly schemaVersion: 1;
+    readonly dependencies: {
+        readonly appDependencies: {
+            readonly '@module-federation/bridge-react': "2.8.0";
+            readonly '@module-federation/modern-js-v3': "2.8.0";
+            readonly '@module-federation/runtime': "2.8.0";
+            readonly '@tanstack/react-router': "1.170.17";
+            readonly i18next: "26.3.6";
+            readonly 'node-fetch': "^3.3.2";
+            readonly react: "19.2.7";
+            readonly 'react-dom': "19.2.7";
+            readonly 'react-router': "7.18.1";
+        };
+        readonly appDevDependencies: {
+            readonly '@effect/tsgo': "0.19.0";
+            readonly '@rsbuild/plugin-tailwindcss': "^2.0.3";
+            readonly '@typescript/native': "npm:typescript@7.0.2";
+            readonly '@types/node': '^20';
+            readonly '@types/react': "^19.2.17";
+            readonly '@types/react-dom': "^19.2.3";
+            readonly tailwindcss: "^4.3.2";
+            readonly typescript: "7.0.2";
+            readonly wrangler: "4.110.0";
+            readonly 'zephyr-rspack-plugin': "1.1.1";
+        };
+        readonly rootDevDependencies: {
+            readonly '@effect/tsgo': "0.19.0";
+            readonly '@typescript/native': "npm:typescript@7.0.2";
+            readonly lefthook: "^2.1.10";
+            readonly miniflare: "4.20260708.1";
+            readonly oxlint: "1.73.0";
+            readonly oxfmt: "0.58.0";
+            readonly ultracite: "7.9.3";
+            readonly wrangler: "4.110.0";
+            readonly 'zephyr-agent': "1.1.1";
+        };
+        readonly transitiveDependencies: {
+            readonly '@cloudflare/workers-types': "5.20260710.1";
+            readonly '@module-federation/node': "2.7.47";
+            readonly '@tanstack/router-core': "1.171.14";
+            readonly '@typescript/native-preview': "7.0.0-dev.20260707.2";
+            readonly miniflare: "4.20260708.1";
+            readonly workerd: "1.20260708.1";
+        };
+    };
+    readonly toolchain: {
+        readonly node: {
+            readonly version: "26.5.0";
+            readonly engineRange: '>=26';
+        };
+        readonly packageManager: {
+            readonly name: 'pnpm';
+            readonly version: "11.17.0";
+            readonly engineRange: '>=11';
+        };
+    };
+    readonly pnpm: {
+        readonly minimumReleaseAge: 1440;
+        readonly minimumReleaseAgeStrict: true;
+        readonly minimumReleaseAgeIgnoreMissingTime: false;
+        readonly trustPolicy: 'no-downgrade';
+        readonly trustPolicyIgnoreAfter: 1440;
+        readonly trustPolicyExclude: readonly ["@effect/opentelemetry@4.0.0-beta.97", "effect@4.0.0-beta.97"];
+        readonly blockExoticSubdeps: true;
+        readonly engineStrict: true;
+        readonly pmOnFail: 'error';
+        readonly verifyDepsBeforeRun: 'error';
+        readonly strictDepBuilds: true;
+        readonly peerDependencyRules: {
+            readonly allowedVersions: {
+                readonly react: '>=19.0.0';
+                readonly '@effect/vitest>effect': "4.0.0-beta.97";
+            };
+        };
+        readonly overrides: {
+            readonly '@effect/opentelemetry': "4.0.0-beta.97";
+            readonly '@effect/vitest': "4.0.0-beta.97";
+            readonly '@tanstack/react-router': "1.170.17";
+            readonly '@tanstack/router-core': "1.171.14";
+            readonly effect: "4.0.0-beta.97";
+            readonly 'node-fetch': "^3.3.2";
+        };
+        readonly allowBuilds: {
+            readonly '@parcel/watcher': true;
+            readonly '@swc/core': true;
+            readonly 'core-js': true;
+            readonly esbuild: true;
+            readonly lefthook: true;
+            readonly 'msgpackr-extract': true;
+            readonly sharp: true;
+            readonly workerd: true;
+        };
+        readonly patchedDependencies: {
+            readonly required: readonly UltramodernPatchPolicy[];
+            readonly conditional: readonly UltramodernPatchPolicy[];
+            readonly stale: readonly UltramodernStalePatchPolicy[];
+        };
+        readonly releaseAge: {
+            readonly approvals: readonly UltramodernReleaseAgeApproval[];
+            readonly registryEvidence: {
+                readonly moduleFederation: {
+                    readonly version: "2.8.0";
+                    readonly nodeVersion: "2.7.47";
+                    readonly releases: {
+                        packageName: string;
+                        version: string;
+                        registry: {
+                            publishedAt: "2026-07-15T09:15:24.091Z" | "2026-07-15T09:15:28.114Z" | "2026-07-15T09:15:32.527Z" | "2026-07-15T09:15:40.748Z" | "2026-07-15T09:15:44.830Z" | "2026-07-15T09:15:49.410Z" | "2026-07-15T09:16:02.203Z" | "2026-07-15T09:16:06.334Z" | "2026-07-15T09:16:15.728Z" | "2026-07-15T09:16:28.628Z" | "2026-07-15T09:16:37.679Z" | "2026-07-15T09:16:46.336Z" | "2026-07-15T09:16:55.255Z" | "2026-07-15T09:17:12.157Z" | "2026-07-15T09:17:16.399Z" | "2026-07-15T09:17:21.630Z" | "2026-07-15T09:17:40.351Z" | "2026-07-15T09:17:49.953Z";
+                            dist: {
+                                integrity: "sha512-+MIaWVaXyrFfE2qq7ErZeflSTscJtDV6g4lZ+TQxjup1nC83Zw+Nw0fvfJnScDR5lP5SM9epSvZrrZHxpFeEgw==" | "sha512-3yOqjdSHXxX4HA3GhlXg3hghGAXW2RJUsnwXCcik2/lTxOHizKI8f3RM+GGCKPxDVqtw43IShe3tA12jNL5A/A==" | "sha512-7AaaiE4YOXFb+st6xlVDK65aNKZYR9S9ykH0q2mkHAHTgquXciAjypS8JuhmKn7Lob/2rkplMOc4YsGxG3Ng9Q==" | "sha512-82fDy9v+7qV5fiN8TKVhOdrxhmAZnUIX/IKivYX5ulCt8aoOzVFTiwm/P1GQUDD8z6dqR48xgJdZdf0548Mc9w==" | "sha512-Gaog9904EmxYOQV0hli3XQ7jXeFaADfh5bnBtTCtbZ37Qd/Sz9kQfd+gYQRyIj7RGmkv9DPiN/SsmrTMrTymKw==" | "sha512-SnVBCwmi962WGg6hLFElxZUCnrRJdR6glE2ZKPBY/iK07AHUN2ZxuaBCBsVzyws+xLZGHZxBHmVstijTh8dSUA==" | "sha512-TPcrkHpaZgL25Vx3c8oSNwyv7/KktC7uo6HTQdVWlFzbq5RSoMMGkWoir5pY5124isae2/p6v5xAuqICi4r0Zg==" | "sha512-Tf98+epGGiPSHqmQHuXa2uXZMMvjGf1IqJDR1/FpXfmobv5ECN0mGZCjUHGNSyxvoDyXKIkKwJu7IwEoh0ouQA==" | "sha512-cGtUBQ1/TVy7KrXy6xPgy3FEmOGyIYkBA2T4iGH3ZH5PNPPTmqN9jF2AfneTSOj0RtBr7Pxq3CUt81E/UCvK1A==" | "sha512-defjq4jOWMEfeejezPWLP5sc8kw0O6FqTT7/E5rbZPEVyjB1A0U3ynhW6GDE5/6hk9/TzdbWS+fBNi4MqUOY6Q==" | "sha512-fW3jD1ZVds6r/Ul8TtUA42RsB0LfT1yjo5KjqgirH9QrmEMH21x44e3e6BC6IN820XKawRDSmz2kFA5YHIQp7Q==" | "sha512-h8vkLdhK7tlcSPmyYNGfGyt0pSzfDB0tYVYdyUt2tXwQRfaJAi3bsIpujMXElw3MXtOfSHESa6M/hPKrtWTHBw==" | "sha512-nAMlr74OKIylkfRwlunOhytQbmsgb3gCqdXWnPQhG+ZtqWXGELLfMT4a1Q1ht3cS+sRpWj2SZRqK2M7GadI6tA==" | "sha512-rul5OPvLx599rWoAhCtKJ3UYqyM3Dxg0RWEfad3JdnJFqkcSLBojZXgHJE1vbF7DRdGQNmNscKw34iEyn89NwQ==" | "sha512-wfVeBXc4/C2F70nRFSPqJhkcwbDgo+wQyEn3jbjJTDoUqxxhYBfHFs1ACBYOk3Qm97L7hHclHGtUG0/nvDEfAA==" | "sha512-yBP+9+0Z8nlvKEXAZS3AsQVy7bFbZf8eMivGk4q4ZdwG3TsLMlsPjb1dQb2i7gcAG6ux9y2LWLkj/0LVk74cnQ==" | "sha512-yTxdWkCJPPo+IGASz+NqdW13cw3DhjSBEn9r85aYn1ahckDwB1WcZe0OjDWMqCcR6yi0BMLedk0SWrUeUj0fWw==" | "sha512-zmFs0I/E3dLa8Vsj35ep7Ms29SePXFOShjedfFs5VnJPooif6l7fgdIJdxThyI1Rdw5JnRXmJsp4qmGm+naziA==";
+                            };
+                        };
+                    }[];
+                    readonly node: {
+                        readonly packageName: '@module-federation/node';
+                        readonly version: "2.7.47";
+                        readonly registry: {
+                            readonly publishedAt: '2026-07-15T09:17:26.899Z';
+                            readonly dist: {
+                                readonly integrity: 'sha512-mifMvCjWmLl53GS+badQws0j2bsu1ICpdGzCbez4I6kSpaYA8v86L6dwcHtVHIZtkUC6cjAZBDcgpxs4fK3nFQ==';
+                            };
+                        };
+                    };
+                };
+            };
+            readonly firstParty: {
+                readonly source: 'authenticated-release-cohort-projection';
+                readonly exactVersionOnly: true;
+                readonly staticApprovals: false;
+            };
+        };
+    };
+    readonly metadata: {
+        readonly packageSource: {
+            readonly configPath: '.modernjs/ultramodern.json';
+            readonly rootManifestPath: 'modernjs.packageSource';
+            readonly ownedKeys: readonly ['strategy', 'modernPackageVersion', 'registry', 'aliasScope', 'aliasPackageNamePrefix'];
+        };
+        readonly moduleFederation: {
+            readonly version: "2.8.0";
+            readonly nodeVersion: "2.7.47";
+            readonly configPath: 'moduleFederation';
+            readonly appConfigPath: 'topology.apps[].moduleFederation';
+        };
+        readonly nativePreview: {
+            readonly packageName: '@typescript/native-preview';
+            readonly version: "7.0.0-dev.20260707.2";
+            readonly generatedDependencyPolicy: 'forbidden';
+            readonly releaseAgePolicy: 'exact-reviewed-closure-only';
+        };
+    };
+};
+export declare function validateReleaseAgeApprovals(approvals: readonly unknown[], options?: {
+    now?: Date;
+}): UltramodernReleaseAgeApproval[];
+export declare function renderMinimumReleaseAgeExclude(options?: {
+    approvals?: readonly unknown[];
+    now?: Date;
+    packageSource?: ResolvedUltramodernPackageSource;
+    releaseCohort?: UltramodernReleaseCohort;
+}): string[];
+export declare function resolveReleaseAgeApprovals(candidates: readonly UltramodernReleaseAgeCandidate[], options?: {
+    approvals?: readonly unknown[];
+    now?: Date;
+}): {
+    minimumReleaseAgeExclude: string[];
+    reviewCandidates: UltramodernReleaseAgeCandidate[];
+};
+export declare function discoverPnpmLockReleaseAgeCandidates(lockfile: unknown): UltramodernReleaseAgeCandidate[];

package/dist/types/ultramodern-workspace/public-api.d.ts

@@ -1,5 +1,5 @@
 export { addUltramodernVertical, planUltramodernVertical, } from './add-vertical';
 export type { UltramodernBridgeConfig, UltramodernBridgeConfigInput, UltramodernBridgeGate, UltramodernBridgeGateInput, UltramodernBridgeLockfilePolicy, UltramodernBridgeTestAlias, UltramodernBridgeWorkspacePackage, UltramodernBridgeWorkspacePackageInput, UltramodernEnabledBridgeConfigInput, } from './bridge-config';
 export { normalizeUltramodernBridgeConfig } from './bridge-config';
-export type { AddUltramodernVerticalOptions, UltramodernCodeSmithOverlay, UltramodernCodeSmithOverlayRuntimeConfig, UltramodernGeneratedAppDescriptor, UltramodernGeneratedContractChange, UltramodernGenerationOperation, UltramodernGenerationResult, UltramodernGenerationWarning, UltramodernJsonMutation, UltramodernShellDependencyChange, UltramodernVerticalPlan, UltramodernWorkspaceOptions, } from './types';
+export type { AddUltramodernVerticalOptions, UltramodernCodeSmithOverlay, UltramodernCodeSmithOverlayRuntimeConfig, UltramodernGeneratedAppDescriptor, UltramodernGeneratedContractChange, UltramodernGenerationOperation, UltramodernGenerationResult, UltramodernGenerationWarning, UltramodernJsonMutation, UltramodernShellDependencyChange, UltramodernVerticalPlan, UltramodernWorkspaceOptions, VerticalApiProtocol, VerticalPreset, } from './types';
 export { generateUltramodernWorkspace } from './write-workspace';

package/dist/types/ultramodern-workspace/public-surface.d.ts

@@ -1,17 +1,8 @@
-import type { JsonValue, PublicRouteMetadata, PublicSurfaceSitemapFields, SupportedWorkspaceLanguage, WorkspaceApp } from './types';
+import type { JsonValue, SupportedWorkspaceLanguage, WorkspaceApp } from './types';
 export declare const publicSurfaceManagedSourceAssetPaths: readonly ['config/public/robots.txt', 'config/public/sitemap.xml', 'config/public/site.webmanifest'];
-export declare const publicSurfaceBaseOutputFiles: readonly ['robots.txt'];
-export declare const publicSurfacePublicRouteOutputFiles: readonly ['sitemap.xml', 'site.webmanifest'];
-export type PublicSurfaceRouteEntry = PublicRouteMetadata & {
-    canonicalUrlPath: string;
-    localeUrlPaths: Record<SupportedWorkspaceLanguage, string>;
-} & PublicSurfaceSitemapFields;
 export declare function createLocalisedPublicPath(pathname: string, language: SupportedWorkspaceLanguage): string;
 export declare function uniqueSorted(values: string[]): string[];
-export declare function createPublicSurfaceRouteEntries(app: WorkspaceApp): PublicSurfaceRouteEntry[];
-export declare function createPublicSurfaceUrlPaths(app: WorkspaceApp): string[];
-export declare function createPublicSurfaceOutputFiles(app: WorkspaceApp): string[];
-export type PublicSurfaceGenerationTarget = 'dist' | 'cloudflare';
+type PublicSurfaceGenerationTarget = 'dist' | 'cloudflare-dist';
 export declare function createPublicSurfaceGenerationCommand(app: WorkspaceApp, target: PublicSurfaceGenerationTarget, requirePublicOrigin?: boolean): string;
 /**
  * Tombstone sweep: generated apps never ship hand-authored source assets under
@@ -19,13 +10,11 @@ export declare function createPublicSurfaceGenerationCommand(app: WorkspaceApp,
  * in. The same path list feeds the generated validate script's assertions.
  */
 export declare function rewriteWorkspaceAssetsForApp(workspaceRoot: string, app: WorkspaceApp): void;
-export declare function createPublicSurfaceContract(app: WorkspaceApp): JsonValue;
-export declare function createPublicHeadContract(): JsonValue;
-export type PublicWebGeneratedFile = {
+type PublicWebGeneratedFile = {
     path: string;
     content: string;
 };
-export type PublicWebAppArtifacts = {
+type PublicWebAppArtifacts = {
     jsonLdHelperFile: PublicWebGeneratedFile;
     routeMetadataFile: PublicWebGeneratedFile;
     routeHeadFile: PublicWebGeneratedFile;
@@ -35,3 +24,4 @@ export type PublicWebAppArtifacts = {
     publicSurface: JsonValue;
 };
 export declare function createPublicWebAppArtifacts(app: WorkspaceApp): PublicWebAppArtifacts;
+export {};

package/dist/types/ultramodern-workspace/routes.d.ts

@@ -1,12 +1,5 @@
 import type { JsonValue, PublicRouteMetadata, RouteOwnedI18nPath, WorkspaceApp } from './types';
-export declare const privateAppRoutePublicness: {
-    readonly indexable: false;
-    readonly public: false;
-    readonly publicSurface: 'private-app-screen';
-};
 export declare function createRouteOwnedI18nPaths(app: WorkspaceApp): RouteOwnedI18nPath[];
-export declare function isPublicIndexableRoute(route: RouteOwnedI18nPath): boolean;
-export declare function createLocalisedUrlsMapFromRoutes(routes: RouteOwnedI18nPath[]): Record<string, JsonValue>;
 export declare function createLocalisedUrlsMap(app: WorkspaceApp): Record<string, JsonValue>;
 export declare function createPublicRouteMetadataFromRoutes(routes: RouteOwnedI18nPath[]): PublicRouteMetadata[];
 export declare function createPublicRouteMetadata(app: WorkspaceApp): PublicRouteMetadata[];
@@ -16,10 +9,8 @@ export declare function createRouteMetaModule(route: RouteOwnedI18nPath): string
 export declare function normalisePublicPath(pathname: string): string;
 export declare function splitPublicPathSegments(pathname: string): string[];
 export declare function routePathParamName(segment: string): string | undefined;
-export declare function isDynamicPublicPathSegment(segment: string): boolean;
 export declare function isConcretePublicPath(pathname: string): boolean;
 export declare function routeSegmentToDirectory(segment: string): string;
-export declare function routePathDirectorySegments(routePath: string): string[];
 export declare function createRoutePageFilePath(app: WorkspaceApp, canonicalPath: string): string;
 export declare function createRouteMetaFilePath(app: WorkspaceApp, canonicalPath: string): string;
 export declare function createRouteAliasPage(canonicalPath: string): string;

package/dist/types/ultramodern-workspace/shared-patches.d.ts

@@ -0,0 +1 @@
+export declare const SHARED_ULTRAMODERN_WORKSPACE_PATCH_FILES: string[];

package/dist/types/ultramodern-workspace/shells.d.ts

@@ -0,0 +1,51 @@
+import type { JsonObject, JsonValue, WorkspaceApp } from './types';
+/**
+ * Multi-shell model (G28). A workspace models N Shells, each its own Delivery
+ * Unit with a distinct id / path / port / Module Federation host name. Default
+ * generation still emits exactly one shell — the primary shell — with today's
+ * id and path, so legacy output stays byte-identical; additional shells are
+ * added explicitly via the `add-shell` operation.
+ *
+ * A Shell (CONTEXT.md) is a thin composition host: it owns top-level routing,
+ * provisions the Platform Baseline, and composes MicroVertical surfaces. It is
+ * its own Delivery Unit but not a MicroVertical. Multiple shells (a super app,
+ * an admin app, an external customer's app) may compose overlapping subsets of
+ * the same verticals.
+ */
+export declare const PRIMARY_SHELL_ID: string;
+export declare const FIRST_ADDITIONAL_SHELL_PORT = 3120;
+export declare function isPrimaryShell(shell: {
+    id: string;
+}): boolean;
+/**
+ * Build the descriptor for an additional (non-primary) shell delivery unit
+ * (G28). Its id / directory / package suffix / Module Federation host name /
+ * port env are all shell-specific so multiple shells never collide.
+ */
+export declare function createShellDescriptor(name: string, port: number): WorkspaceApp;
+/**
+ * Validate an additional-shell name. Reuses the vertical-name grammar
+ * (lowercase kebab-case) and rejects the reserved primary-shell suffix so an
+ * additional shell can never shadow the primary `shell-super-app`.
+ */
+export declare function assertValidShellName(name: string): string;
+/**
+ * The per-shell delivery-unit identity block (G28 / G29 pattern). Every shell
+ * — primary or additional — carries a stamped delivery-unit descriptor, the
+ * same shape verticals stamp in contracts.ts, so a shell is a first-class
+ * Delivery Unit with its own build marker and unit id.
+ */
+export declare function shellDeliveryUnitBlock(scope: string, shell: WorkspaceApp): JsonValue;
+/**
+ * Serialize one additional shell into the additive compact-config collection.
+ * The primary shell remains projected through topology.apps; this record is
+ * the durable source for every non-primary shell's identity and composition.
+ */
+export declare function createAdditionalShellConfigEntry(scope: string, shell: WorkspaceApp, remotes?: WorkspaceApp[]): JsonObject;
+/**
+ * Resolve the configured shells collection from a compact UltraModern config
+ * (G28). Always includes the primary shell; additional shells are read from the
+ * additive `shells` array so a legacy single-shell config resolves to exactly
+ * `[primaryShell]`.
+ */
+export declare function resolveConfiguredAdditionalShells(config: Record<string, unknown> | undefined): WorkspaceApp[];

package/dist/types/ultramodern-workspace/tooling-command-catalog.d.ts

@@ -0,0 +1,18 @@
+export type GeneratedToolingCommandId = 'validate' | 'typecheck' | 'mfTypes' | 'publicSurface' | 'backendFederationGenerate' | 'backendFederationProof' | 'cloudflareProof' | 'cloudflareOutputVerify' | 'performanceReadiness' | 'migrateStrictEffect' | 'routesGenerate';
+export type GeneratedToolingCommandKey = GeneratedToolingCommandId;
+interface GeneratedToolingCommand {
+    id: GeneratedToolingCommandId;
+    command: string;
+    wrapperName: string;
+    wrapperPath: `scripts/${string}.mts`;
+    contractKey: string;
+    rootScript?: string;
+    templatePath?: `templates/workspace-scripts/${string}.mjs`;
+    cwd?: 'invocation';
+}
+export declare const generatedToolingCommands: readonly [GeneratedToolingCommand, GeneratedToolingCommand, GeneratedToolingCommand, GeneratedToolingCommand, GeneratedToolingCommand, GeneratedToolingCommand, GeneratedToolingCommand, GeneratedToolingCommand, GeneratedToolingCommand, GeneratedToolingCommand, GeneratedToolingCommand];
+export declare const GENERATED_TOOLING_COMMANDS: Record<GeneratedToolingCommandId, GeneratedToolingCommand>;
+export declare const generatedToolingCommandList: () => string[];
+declare const createToolingWrapperContract: () => Record<GeneratedToolingCommandKey, GeneratedToolingCommand['wrapperPath']>;
+export declare const createGeneratedToolingWrapperMap: typeof createToolingWrapperContract;
+export {};

package/dist/types/ultramodern-workspace/tsconfigs.d.ts

@@ -0,0 +1,13 @@
+import type { JsonValue, WorkspaceApp } from './types';
+export declare function createTsConfigBase(): JsonValue;
+type CreatePackageTsConfigOptions = {
+    include?: string[];
+    includeApi?: boolean;
+    references?: string[];
+};
+export declare function createPackageTsConfig(packageDir: string, options?: CreatePackageTsConfigOptions | boolean): JsonValue;
+export declare function createAppTsConfig(app: WorkspaceApp, remotes?: WorkspaceApp[]): JsonValue;
+export declare function createAppMfTypesTsConfig(app: WorkspaceApp): JsonValue;
+export declare function createSharedPackageTsConfig(packageDir: string): JsonValue;
+export declare function createRootTsConfig(apps?: WorkspaceApp[]): JsonValue;
+export {};