@servicetitan/startup 37.0.1 → 38.0.0

package/dist/vite/plugins/istanbul-plugin.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../../src/vite/plugins/istanbul-plugin.ts"],"sourcesContent":["import type { Plugin } from 'vite';\nimport { ViteBuildContext } from '../types';\nimport { importEsm } from './utils';\n\nexport function istanbulPlugin(context: ViteBuildContext): Promise<Plugin> | undefined {\n    if (!context.options.codeCoverage) {\n        return;\n    }\n\n    // vite-plugin-istanbul is ESM-only; load it natively so SWC doesn't rewrite to require.\n    return importEsm<typeof import('vite-plugin-istanbul')>('vite-plugin-istanbul').then(\n        ({ default: istanbul }) =>\n            istanbul({\n                exclude: ['**/node_modules/**', '**/.yalc/**'],\n                requireEnv: false,\n                forceBuildInstrument: true,\n            })\n    );\n}\n"],"names":["istanbulPlugin","context","options","codeCoverage","importEsm","then","default","istanbul","exclude","requireEnv","forceBuildInstrument"],"mappings":";;;;+BAIgBA;;;eAAAA;;;uBAFU;AAEnB,SAASA,eAAeC,OAAyB;IACpD,IAAI,CAACA,QAAQC,OAAO,CAACC,YAAY,EAAE;QAC/B;IACJ;IAEA,wFAAwF;IACxF,OAAOC,IAAAA,gBAAS,EAAwC,wBAAwBC,IAAI,CAChF,CAAC,EAAEC,SAASC,QAAQ,EAAE,GAClBA,SAAS;YACLC,SAAS;gBAAC;gBAAsB;aAAc;YAC9CC,YAAY;YACZC,sBAAsB;QAC1B;AAEZ"}
+{"version":3,"sources":["../../../src/vite/plugins/istanbul-plugin.ts"],"sourcesContent":["import path from 'path';\nimport type { Plugin } from 'vite';\nimport { resolveOutputPath } from '../../core';\nimport { ViteBuildContext } from '../types';\nimport { importEsm } from './utils';\n\nexport function istanbulPlugin(context: ViteBuildContext): Promise<Plugin> | undefined {\n    if (!context.options.codeCoverage) {\n        return;\n    }\n\n    // vite-plugin-istanbul is ESM-only; load it natively so SWC doesn't rewrite to require.\n    return importEsm<typeof import('vite-plugin-istanbul')>('vite-plugin-istanbul').then(\n        ({ default: istanbul }) =>\n            istanbul({\n                exclude: [\n                    '**/node_modules/**',\n                    '**/.yalc/**',\n                    ...sharedDependenciesExclude(context),\n                ],\n                requireEnv: false,\n                forceBuildInstrument: true,\n            })\n    );\n}\n\n/*\n * devServerRoutingPlugin serves the prebuilt shared-dependencies bundle (react, mobx, the\n * design system, etc.) straight from disk at dev time. Instrumenting that vendor code breaks\n * Vite's import analysis on the huge instrumented output and provides no useful coverage.\n *\n * vite-plugin-istanbul matches exclude patterns against paths relative to process.cwd()\n * (via test-exclude's default `relativePath` behavior), so the pattern must be cwd-relative\n * rather than absolute.\n */\nfunction sharedDependenciesExclude(context: ViteBuildContext): string[] {\n    if (!context.package.isExposeSharedDependencies) {\n        return [];\n    }\n    const sharedContext = {\n        ...context,\n        build: { ...context.build, emitExposedDependencies: true },\n    };\n    const outputPath = resolveOutputPath(sharedContext, context.bundlerConfig.outDir);\n    return [path.join(path.relative(process.cwd(), outputPath), '**').replace(/\\\\/g, '/')];\n}\n"],"names":["istanbulPlugin","context","options","codeCoverage","importEsm","then","default","istanbul","exclude","sharedDependenciesExclude","requireEnv","forceBuildInstrument","package","isExposeSharedDependencies","sharedContext","build","emitExposedDependencies","outputPath","resolveOutputPath","bundlerConfig","outDir","path","join","relative","process","cwd","replace"],"mappings":";;;;+BAMgBA;;;eAAAA;;;6DANC;sBAEiB;uBAER;;;;;;AAEnB,SAASA,eAAeC,OAAyB;IACpD,IAAI,CAACA,QAAQC,OAAO,CAACC,YAAY,EAAE;QAC/B;IACJ;IAEA,wFAAwF;IACxF,OAAOC,IAAAA,gBAAS,EAAwC,wBAAwBC,IAAI,CAChF,CAAC,EAAEC,SAASC,QAAQ,EAAE,GAClBA,SAAS;YACLC,SAAS;gBACL;gBACA;mBACGC,0BAA0BR;aAChC;YACDS,YAAY;YACZC,sBAAsB;QAC1B;AAEZ;AAEA;;;;;;;;CAQC,GACD,SAASF,0BAA0BR,OAAyB;IACxD,IAAI,CAACA,QAAQW,OAAO,CAACC,0BAA0B,EAAE;QAC7C,OAAO,EAAE;IACb;IACA,MAAMC,gBAAgB;QAClB,GAAGb,OAAO;QACVc,OAAO;YAAE,GAAGd,QAAQc,KAAK;YAAEC,yBAAyB;QAAK;IAC7D;IACA,MAAMC,aAAaC,IAAAA,uBAAiB,EAACJ,eAAeb,QAAQkB,aAAa,CAACC,MAAM;IAChF,OAAO;QAACC,aAAI,CAACC,IAAI,CAACD,aAAI,CAACE,QAAQ,CAACC,QAAQC,GAAG,IAAIR,aAAa,MAAMS,OAAO,CAAC,OAAO;KAAK;AAC1F"}

package/dist/vite/types.d.ts

@@ -1,4 +1,7 @@
 import { BuildContext } from '../core';
 import { ViteBundlerConfig } from '../utils';
-export type ViteBuildContext = BuildContext<Required<Omit<ViteBundlerConfig, 'port'>> & Pick<ViteBundlerConfig, 'port'>>;
+export type ViteBuildContext = BuildContext<(Required<Omit<ViteBundlerConfig, 'port'>> & Pick<ViteBundlerConfig, 'port'>) & {
+    /** The resolved `build.outDir` override, if the package configures one. */
+    outDir?: string;
+}>;
 //# sourceMappingURL=types.d.ts.map

package/dist/vite/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/vite/types.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACvC,OAAO,EAAE,iBAAiB,EAAE,MAAM,UAAU,CAAC;AAE7C,MAAM,MAAM,gBAAgB,GAAG,YAAY,CACvC,QAAQ,CAAC,IAAI,CAAC,iBAAiB,EAAE,MAAM,CAAC,CAAC,GAAG,IAAI,CAAC,iBAAiB,EAAE,MAAM,CAAC,CAC9E,CAAC"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/vite/types.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACvC,OAAO,EAAE,iBAAiB,EAAE,MAAM,UAAU,CAAC;AAE7C,MAAM,MAAM,gBAAgB,GAAG,YAAY,CACvC,CAAC,QAAQ,CAAC,IAAI,CAAC,iBAAiB,EAAE,MAAM,CAAC,CAAC,GAAG,IAAI,CAAC,iBAAiB,EAAE,MAAM,CAAC,CAAC,GAAG;IAC5E,2EAA2E;IAC3E,MAAM,CAAC,EAAE,MAAM,CAAC;CACnB,CACJ,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@servicetitan/startup",
-    "version": "37.0.1",
+    "version": "38.0.0",
     "description": "CLI to create multi-package Lerna projects with TypeScript and React",
     "homepage": "https://docs.st.dev/docs/frontend/uikit/startup",
     "repository": {
@@ -103,10 +103,10 @@
         "@jest/core": "~30.4.2",
         "@jest/types": "~30.4.1",
         "@jsdevtools/coverage-istanbul-loader": "^3.0.5",
-        "@servicetitan/eslint-config": "37.0.1",
-        "@servicetitan/install": "37.0.1",
-        "@servicetitan/startup-utils": "37.0.1",
-        "@servicetitan/stylelint-config": "37.0.1",
+        "@servicetitan/eslint-config": "38.0.0",
+        "@servicetitan/install": "38.0.0",
+        "@servicetitan/startup-utils": "38.0.0",
+        "@servicetitan/stylelint-config": "38.0.0",
         "@svgr/webpack": "^8.1.0",
         "@swc/cli": "^0.8.1",
         "@swc/core": "1.15.43",
@@ -120,7 +120,7 @@
         "css-minimizer-webpack-plugin": "^8.0.0",
         "debug": "^4.4.3",
         "deepmerge": "~4.3.1",
-        "es-module-lexer": "^2.1.0",
+        "es-module-lexer": "^2.3.0",
         "eslint": "~9.39.2",
         "eta": "^4.6.0",
         "execa": "~5.1.1",
@@ -135,7 +135,7 @@
         "js-yaml": "~4.2.0",
         "json5": "^2.2.3",
         "lerna": "~9.0.7",
-        "less": "~4.6.6",
+        "less": "~4.6.7",
         "less-loader": "~13.0.0",
         "less-plugin-npm-import": "~2.1.0",
         "lodash.kebabcase": "^4.1.1",
@@ -146,14 +146,14 @@
         "multimatch": "~8.0.0",
         "patch-package": "^8.0.1",
         "portfinder": "~1.0.38",
-        "postcss": "~8.5.15",
-        "prettier": "~3.8.4",
+        "postcss": "~8.5.16",
+        "prettier": "~3.9.4",
         "sass": "~1.101.0",
         "sass-loader": "~17.0.0",
         "semver": "~7.8.5",
         "source-map-loader": "~5.0.0",
         "style-loader": "~4.0.0",
-        "stylelint": "~17.13.0",
+        "stylelint": "~17.14.0",
         "swc-loader": "^0.2.7",
         "terminal-link": "^5.0.0",
         "terser-webpack-plugin": "^5.6.1",
@@ -161,7 +161,7 @@
         "ts-node": "~10.9.2",
         "typed-css-modules": "~0.9.1",
         "typescript": "6.0.3",
-        "vite": "^8.0.16",
+        "vite": "^8.1.4",
         "vite-bundle-analyzer": "^1.3.8",
         "vite-plugin-istanbul": "^9.0.1",
         "vite-plugin-svgr": "^5.2.0",
@@ -197,5 +197,5 @@
     "cli": {
         "webpack": false
     },
-    "gitHead": "9a2e5579f88cf9895fd2948ce5d5810e976d20b0"
+    "gitHead": "a96a725030a0c422257567b1f06025bca8ca53b9"
 }

package/src/cli/commands/__tests__/bundle-vite.test.ts

@@ -136,6 +136,7 @@ describe(BundleVite.name, () => {
             beforeEach(() => (args.watch = true));
 
             test('throws error', async () => {
+                jest.spyOn(process.stdout, 'write').mockImplementationOnce(jest.fn()); // suppress error output
                 await expect(subject()).rejects.toThrow(
                     'cannot bundle exposed dependencies in watch mode'
                 );

package/src/cli/commands/review/types.ts

@@ -71,8 +71,6 @@ export interface ReviewConfiguration {
 }
 
 export type RuleConfiguration =
-    | Level
-    | [Level]
-    | [Level, { exclude?: string[] | Record<string, string[]> }];
+    Level | [Level] | [Level, { exclude?: string[] | Record<string, string[]> }];
 
 export type Level = 'warn' | 'error' | 'off';

package/src/cypress/config/__tests__/vite-config.test.ts

@@ -1,6 +1,6 @@
 import type { InlineConfig } from 'vite';
 import { createCssConfig } from '../../../vite/config/create-css-config';
-import { istanbulPlugin, svgrPlugin } from '../../../vite/plugins';
+import { ignoreModulesPlugin, istanbulPlugin, svgrPlugin } from '../../../vite/plugins';
 import { viteConfig } from '../vite-config';
 
 jest.mock('vite', () => ({
@@ -11,8 +11,9 @@ jest.mock('../../../vite/plugins');
 
 describe(`[startup/cypress-config] ${viteConfig.name}`, () => {
     const cssConfig: any = { modules: { localsConvention: 'camelCaseOnly' } };
-    const svgr: any = { name: 'svgr' };
-    const istanbul: any = { name: 'istanbul' };
+    const mockSvgrPlugin: any = { name: 'vite-plugin-svgr' };
+    const mockIstanbulPlugin: any = { name: 'istanbul' };
+    const mockIgnoreModulesPlugin: any = { name: 'ignore-modules' };
 
     let overrides: InlineConfig | undefined;
 
@@ -21,8 +22,9 @@ describe(`[startup/cypress-config] ${viteConfig.name}`, () => {
     beforeEach(() => {
         jest.clearAllMocks();
         jest.mocked(createCssConfig).mockReturnValue(cssConfig);
-        jest.mocked(svgrPlugin).mockReturnValue(svgr);
-        jest.mocked(istanbulPlugin).mockReturnValue(istanbul);
+        jest.mocked(svgrPlugin).mockReturnValue(mockSvgrPlugin);
+        jest.mocked(istanbulPlugin).mockReturnValue(mockIstanbulPlugin);
+        jest.mocked(ignoreModulesPlugin).mockReturnValue(mockIgnoreModulesPlugin);
         overrides = undefined;
     });
 
@@ -36,8 +38,20 @@ describe(`[startup/cypress-config] ${viteConfig.name}`, () => {
         expect(subject().css).toBe(cssConfig);
     });
 
-    test('includes the SVG plugin', () => {
-        expect(subject().plugins).toContain(svgr);
+    test('adds the svgr plugin', () => {
+        expect(subject().plugins).toContain(mockSvgrPlugin);
+    });
+
+    test('adds the istanbul plugin', () => {
+        expect(subject().plugins).toContain(mockIstanbulPlugin);
+    });
+
+    test('adds the ignore-modules plugin', () => {
+        expect(subject().plugins).toContain(mockIgnoreModulesPlugin);
+    });
+
+    test('registers the ignore modules plugin for the dependency pre-bundler', () => {
+        expect(subject().optimizeDeps?.rolldownOptions?.plugins).toEqual([mockIgnoreModulesPlugin]);
     });
 
     test('enables code coverage', () => {
@@ -48,10 +62,6 @@ describe(`[startup/cypress-config] ${viteConfig.name}`, () => {
         );
     });
 
-    test('includes the coverage plugin', () => {
-        expect(subject().plugins).toContain(istanbul);
-    });
-
     test('dedupes React', () => {
         expect(subject().resolve?.dedupe).toEqual(['react', 'react-dom']);
     });

package/src/cypress/config/__tests__/webpack-config.test.ts

@@ -3,12 +3,17 @@ import { getSwcOptions } from '../../../cli/tasks';
 import { TSConfig } from '../../../cli/utils';
 import { getBaseTsConfig } from '../../../utils';
 import { JS_RULE_EXCLUDE, rulesConfig } from '../../../webpack/configs';
+import { filterWarningsPlugin, ignorePlugin } from '../../../webpack/configs/plugins';
 import { Overrides } from '../../../webpack/types';
 import { webpackConfig } from '../webpack-config';
 
 jest.mock('@servicetitan/install');
 jest.mock('fs', () => fs);
 jest.mock('../../../webpack/configs');
+jest.mock('../../../webpack/configs/plugins', () => ({
+    filterWarningsPlugin: jest.fn(),
+    ignorePlugin: jest.fn(),
+}));
 jest.mock('../../../cli/tasks');
 
 describe(`[startup/cypress-config] ${webpackConfig.name}`, () => {
@@ -19,12 +24,16 @@ describe(`[startup/cypress-config] ${webpackConfig.name}`, () => {
     const mockSwcOptions: any = { jsc: 'foobar' };
     const mockTsConfig = { compilerOptions: { target: 'es2020' } };
     const mockFallbackTsConfig = { compilerOptions: { target: 'es2018' } };
+    const mockIgnorePlugin: any = { name: 'IgnorePlugin' };
+    const mockFilterWarningsPlugin = { name: 'FilterWarningsPlugin' };
     const fallbackConfig = getBaseTsConfig();
 
     let overrides: Overrides | undefined;
 
     beforeEach(() => {
         jest.clearAllMocks();
+        jest.mocked(ignorePlugin).mockReturnValue(mockIgnorePlugin);
+        jest.mocked(filterWarningsPlugin).mockReturnValue(mockFilterWarningsPlugin);
         jest.mocked(rulesConfig).mockReturnValue({ rules: mockRules });
         jest.mocked(getSwcOptions).mockReturnValue(mockSwcOptions);
         vol.fromJSON({
@@ -56,6 +65,14 @@ describe(`[startup/cypress-config] ${webpackConfig.name}`, () => {
         );
     });
 
+    test('adds the ignore plugin', () => {
+        expect(subject().plugins).toContain(mockIgnorePlugin);
+    });
+
+    test('adds the filter warnings plugin', () => {
+        expect(subject().plugins).toContain(mockFilterWarningsPlugin);
+    });
+
     test('includes all rules from rulesConfig', () => {
         const result = subject();
 

package/src/cypress/config/vite-config.ts

@@ -1,6 +1,6 @@
 import { type InlineConfig, mergeConfig } from 'vite';
 import { createCssConfig } from '../../vite/config/create-css-config';
-import { istanbulPlugin, svgrPlugin } from '../../vite/plugins';
+import { ignoreModulesPlugin, istanbulPlugin, svgrPlugin } from '../../vite/plugins';
 import type { ViteBuildContext } from '../../vite/types';
 
 /*
@@ -17,8 +17,22 @@ export function viteConfig(overrides?: InlineConfig): InlineConfig {
     const config: InlineConfig = {
         css: createCssConfig(false),
         resolve: { dedupe: REACT_DEDUPE },
-        optimizeDeps: { include: REACT_OPTIMIZE },
-        plugins: [svgrPlugin(context), istanbulPlugin(context)],
+        optimizeDeps: {
+            include: REACT_OPTIMIZE /*
+             * Top-level plugins don't run during dependency pre-bundling, so
+             * register ignoreModulesPlugin again here. Without this, missing
+             * optional peer dependencies inside pre-bundled packages throw at
+             * runtime instead of resolving to an empty module.
+             */,
+            rolldownOptions: {
+                plugins: [ignoreModulesPlugin({ package: { dependencies: {} } })],
+            },
+        },
+        plugins: [
+            svgrPlugin(context),
+            istanbulPlugin(context),
+            ignoreModulesPlugin({ package: { dependencies: {} } }),
+        ],
     };
 
     return mergeConfig(config, overrides ?? {});
@@ -33,5 +47,6 @@ function getContext(): ViteBuildContext {
     return {
         options: { codeCoverage: true },
         bundlerConfig: { pluginOverrides: {} },
+        package: {},
     } as ViteBuildContext;
 }

package/src/cypress/config/webpack-config.ts

@@ -6,6 +6,7 @@ import { getSwcOptions } from '../../cli/tasks';
 import { TSConfig } from '../../cli/utils';
 import { getTsConfigWithFallback, log } from '../../utils';
 import { JS_RULE_EXCLUDE, rulesConfig } from '../../webpack/configs';
+import { filterWarningsPlugin, ignorePlugin } from '../../webpack/configs/plugins';
 import { Overrides, WebpackBuildContext } from '../../webpack/types';
 
 export function webpackConfig(overrides?: Overrides): Configuration {
@@ -19,6 +20,7 @@ export function webpackConfig(overrides?: Overrides): Configuration {
         module: {
             rules,
         },
+        plugins: [ignorePlugin(context, {}), filterWarningsPlugin(context, {})],
         resolve: {
             extensions: ['.ts', '.tsx', '.js', '.jsx'],
         },

package/src/storybook-config/__tests__/vite-final.test.ts

@@ -1,26 +1,46 @@
 import type { InlineConfig } from 'vite';
 import { createCssConfig } from '../../vite/config/create-css-config';
-import { svgrPlugin } from '../../vite/plugins/svgr-plugin';
+import { createFilteringLogger } from '../../vite/config/create-filtering-logger';
+import { ignoreModulesPlugin, svgrPlugin } from '../../vite/plugins';
 import { viteFinal } from '../vite-final';
 
-jest.mock('../../vite/plugins/svgr-plugin', () => ({ svgrPlugin: jest.fn() }));
+jest.mock('../../vite/plugins');
+jest.mock('../../vite/config/create-filtering-logger');
 
 describe(`[startup/storybook-config] ${viteFinal.name}`, () => {
-    const mockSvgrPlugin = { name: 'vite-plugin-svgr' } as any;
+    const mockSvgrPlugin: any = { name: 'vite-plugin-svgr' };
+    const mockIgnoreModulesPlugin: any = { name: 'ignore-modules' };
+    const mockFilteringLogger: any = { name: 'filteringLoggeer' };
     let config: InlineConfig;
     let configType: 'DEVELOPMENT' | 'PRODUCTION' | undefined;
 
     beforeEach(() => {
         jest.clearAllMocks();
         jest.mocked(svgrPlugin).mockReturnValue(mockSvgrPlugin);
+        jest.mocked(ignoreModulesPlugin).mockReturnValue(mockIgnoreModulesPlugin);
+        jest.mocked(createFilteringLogger).mockReturnValue(mockFilteringLogger);
         config = {};
         configType = undefined;
     });
 
     const subject = () => viteFinal(config, { configType });
 
-    test('adds svgr plugin', () => {
-        expect(subject()).toEqual(expect.objectContaining({ plugins: [mockSvgrPlugin] }));
+    test('adds the svgr plugin', () => {
+        expect(subject().plugins).toContain(mockSvgrPlugin);
+    });
+
+    test('adds the ignore-modules plugin', () => {
+        expect(subject().plugins).toContain(mockIgnoreModulesPlugin);
+    });
+
+    test('adds the filtering logger', () => {
+        expect(subject().customLogger).toBe(mockFilteringLogger);
+    });
+
+    test('registers the ignore-modules plugin for the dependency pre-bundler', () => {
+        expect(subject().optimizeDeps!.rolldownOptions).toEqual({
+            plugins: [mockIgnoreModulesPlugin],
+        });
     });
 
     test('dedupes react', () => {
@@ -30,11 +50,11 @@ describe(`[startup/storybook-config] ${viteFinal.name}`, () => {
     });
 
     test('pre-bundles react', () => {
-        expect(subject()).toEqual(
-            expect.objectContaining({
-                optimizeDeps: { include: ['react', 'react-dom', 'react/jsx-runtime'] },
-            })
-        );
+        expect(subject().optimizeDeps!.include).toEqual([
+            'react',
+            'react-dom',
+            'react/jsx-runtime',
+        ]);
     });
 
     describe.each([
@@ -90,7 +110,9 @@ describe(`[startup/storybook-config] ${viteFinal.name}`, () => {
 
         test('preserves existing plugins', () => {
             expect(subject()).toEqual(
-                expect.objectContaining({ plugins: [existingPlugin, mockSvgrPlugin] })
+                expect.objectContaining({
+                    plugins: [existingPlugin, mockSvgrPlugin, mockIgnoreModulesPlugin],
+                })
             );
         });
     });
@@ -119,4 +141,36 @@ describe(`[startup/storybook-config] ${viteFinal.name}`, () => {
             ]);
         });
     });
+
+    describe('when config already contains optimizeDeps.rolldownOptions', () => {
+        const existingPlugin = { name: 'existing' };
+
+        beforeEach(() => {
+            config = {
+                optimizeDeps: { rolldownOptions: { plugins: [existingPlugin] } },
+            };
+        });
+
+        test('preserves existing rolldownOptions plugins', () => {
+            expect(subject().optimizeDeps!.rolldownOptions).toEqual({
+                plugins: [existingPlugin, mockIgnoreModulesPlugin],
+            });
+        });
+    });
+
+    describe('when config already contains a single (non-array) rolldownOptions plugin', () => {
+        const existingPlugin = { name: 'existing' };
+
+        beforeEach(() => {
+            config = {
+                optimizeDeps: { rolldownOptions: { plugins: existingPlugin } },
+            };
+        });
+
+        test('preserves the existing rolldownOptions plugin', () => {
+            expect(subject().optimizeDeps!.rolldownOptions).toEqual({
+                plugins: [existingPlugin, mockIgnoreModulesPlugin],
+            });
+        });
+    });
 });

package/src/storybook-config/__tests__/webpack-final.test.ts

@@ -1,6 +1,6 @@
 import type { Configuration } from 'webpack';
 import { rulesConfig } from '../../webpack/configs';
-import { miniCssExtractPlugin } from '../../webpack/configs/plugins';
+import { ignorePlugin, miniCssExtractPlugin } from '../../webpack/configs/plugins';
 import { Overrides } from '../../webpack/types';
 import { webpackFinal } from '../webpack-final';
 
@@ -19,6 +19,7 @@ describe(`[startup/storybook-config] ${webpackFinal.name}`, () => {
         { test: /\.css$/, use: ['css-loader'] },
     ];
     const mockMiniCssExtractPlugin: any = { name: 'MiniCssExtractPlugin' };
+    const mockIgnorePlugin: any = { name: 'IgnorePlugin' };
     let config: Configuration;
     let overrides: Overrides | undefined;
 
@@ -26,6 +27,7 @@ describe(`[startup/storybook-config] ${webpackFinal.name}`, () => {
         jest.clearAllMocks();
         jest.mocked(rulesConfig).mockReturnValue({ rules: mockRules });
         jest.mocked(miniCssExtractPlugin).mockReturnValue(mockMiniCssExtractPlugin);
+        jest.mocked(ignorePlugin).mockReturnValue(mockIgnorePlugin);
         config = {};
         overrides = undefined;
     });
@@ -52,7 +54,11 @@ describe(`[startup/storybook-config] ${webpackFinal.name}`, () => {
     });
 
     test('adds MiniCssExtractPlugin to config', () => {
-        expect(subject().plugins).toEqual([mockMiniCssExtractPlugin]);
+        expect(subject().plugins).toEqual(expect.arrayContaining([mockMiniCssExtractPlugin]));
+    });
+
+    test('adds IgnorePlugin to config', () => {
+        expect(subject().plugins).toEqual(expect.arrayContaining([mockIgnorePlugin]));
     });
 
     describe('when config contains rules', () => {
@@ -73,15 +79,19 @@ describe(`[startup/storybook-config] ${webpackFinal.name}`, () => {
 
         beforeEach(() => (config.plugins = [configPlugin]));
 
-        test('appends MiniCssExtractPlugin to config', () => {
-            expect(subject().plugins).toEqual([configPlugin, mockMiniCssExtractPlugin]);
+        test('appends default plugins to config', () => {
+            expect(subject().plugins).toEqual([
+                configPlugin,
+                mockMiniCssExtractPlugin,
+                mockIgnorePlugin,
+            ]);
         });
 
         describe('when MiniCssExtractPlugin is disabled', () => {
             beforeEach(() => jest.mocked(miniCssExtractPlugin).mockReturnValue(undefined));
 
-            test('returns only configured plugins', () => {
-                expect(subject().plugins).toEqual(config.plugins);
+            test('omits plugin', () => {
+                expect(subject().plugins).toEqual([configPlugin, mockIgnorePlugin]);
             });
         });
     });

package/src/storybook-config/vite-final.ts

@@ -2,7 +2,8 @@ import { inspect } from 'node:util';
 import type { InlineConfig } from 'vite';
 import { log } from '../utils';
 import { createCssConfig } from '../vite/config/create-css-config';
-import { svgrPlugin } from '../vite/plugins/svgr-plugin';
+import { createFilteringLogger } from '../vite/config/create-filtering-logger';
+import { ignoreModulesPlugin, svgrPlugin } from '../vite/plugins';
 import type { ViteBuildContext } from '../vite/types';
 
 interface ViteFinalOptions {
@@ -27,7 +28,11 @@ export function viteFinal(
 ): InlineConfig {
     const isProduction = configType === 'PRODUCTION';
     const css = createCssConfig(isProduction);
-    const plugins = [svgrPlugin(getContext())];
+    const plugins = [
+        svgrPlugin(getContext()),
+        ignoreModulesPlugin({ package: { dependencies: {} } }),
+    ];
+    const existingRolldownPlugins = config.optimizeDeps?.rolldownOptions?.plugins;
 
     const merged: InlineConfig = {
         ...config,
@@ -46,8 +51,24 @@ export function viteFinal(
         optimizeDeps: {
             ...config.optimizeDeps,
             include: [...new Set([...(config.optimizeDeps?.include ?? []), ...REACT_OPTIMIZE])],
+            /*
+             * Top-level plugins don't run during dependency pre-bundling, so
+             * register ignoreModulesPlugin again here. Without this, missing
+             * optional peer dependencies inside pre-bundled packages throw at
+             * runtime instead of resolving to an empty module.
+             */
+            rolldownOptions: {
+                ...config.optimizeDeps?.rolldownOptions,
+                plugins: [
+                    ...(Array.isArray(existingRolldownPlugins)
+                        ? existingRolldownPlugins
+                        : [existingRolldownPlugins].filter(Boolean)),
+                    ignoreModulesPlugin({ package: { dependencies: {} } }),
+                ],
+            },
         },
         plugins: [...(config.plugins ?? []), ...plugins],
+        customLogger: createFilteringLogger(),
     };
 
     /* istanbul ignore next: debug only */

package/src/storybook-config/webpack-final.ts

@@ -3,7 +3,7 @@ import { inspect } from 'node:util';
 import type { Configuration } from 'webpack';
 import { log } from '../utils';
 import { rulesConfig } from '../webpack/configs';
-import { miniCssExtractPlugin } from '../webpack/configs/plugins';
+import { ignorePlugin, miniCssExtractPlugin } from '../webpack/configs/plugins';
 import { Overrides, WebpackBuildContext } from '../webpack/types';
 
 export function webpackFinal(config: Configuration, overrides: Overrides = {}): Configuration {
@@ -48,7 +48,9 @@ function getContext(config: Configuration): WebpackBuildContext {
 }
 
 function getPlugins(context: WebpackBuildContext, overrides: Overrides) {
-    return [miniCssExtractPlugin(context, overrides)].filter(plugin => !!plugin);
+    return [miniCssExtractPlugin(context, overrides), ignorePlugin(context, {})].filter(
+        plugin => !!plugin
+    );
 }
 
 function getRules(context: WebpackBuildContext, overrides: Overrides) {

package/src/vite/config/__tests__/base-config.test.ts

@@ -119,6 +119,10 @@ describe(createBaseConfig.name, () => {
         expect(subject().server!.port).toBe(8080);
     });
 
+    test('binds dev server to 127.0.0.1', () => {
+        expect(subject().server!.host).toBe('127.0.0.1');
+    });
+
     test('sets development mode', () => {
         expect(subject().mode).toBe(bundleConstants.mode.development);
     });

package/src/vite/config/__tests__/create-filtering-logger.test.ts

@@ -47,5 +47,14 @@ describe(createFilteringLogger.name, () => {
 
             itSuppressesMessage();
         });
+
+        describe('when message is an ignored-module import warning', () => {
+            beforeEach(() => {
+                message =
+                    "[IMPORT_IS_UNDEFINED] Import `DefaultPortalContext` will always be undefined because there is no matching export in '\\0IGNORE_EMPTY:@servicetitan/design-system'";
+            });
+
+            itSuppressesMessage();
+        });
     });
 });

package/src/vite/config/__tests__/create-vite-build-context.test.ts

@@ -29,6 +29,7 @@ describe(createViteBuildContext.name, () => {
             omitDefault: [],
             pluginOverrides: { html: {}, svgr: {} },
             minify: {},
+            outDir: undefined,
         });
     });
 
@@ -86,4 +87,28 @@ describe(createViteBuildContext.name, () => {
             });
         });
     });
+
+    describe('when package.json contains build.outDir', () => {
+        const pkgJsonOutDir = 'pkg-dist';
+
+        beforeEach(() => {
+            pkgJsonConfig = { config: { build: { outDir: pkgJsonOutDir } } };
+        });
+
+        test('configures outDir', () => {
+            expect(subject().bundlerConfig.outDir).toBe(pkgJsonConfig.config?.build?.outDir);
+        });
+
+        describe('when file config also contains build.outDir', () => {
+            const fileOutDir = 'file-dist';
+
+            beforeEach(() => {
+                fileConfig = { config: { build: { outDir: fileOutDir } } };
+            });
+
+            test('file config takes precedence', () => {
+                expect(subject().bundlerConfig.outDir).toBe(fileOutDir);
+            });
+        });
+    });
 });

package/src/vite/config/base-config.ts

@@ -83,7 +83,11 @@ export function createBaseConfig(context: ViteBuildContext): InlineConfig {
     let config: InlineConfig = {
         cacheDir: `node_modules/.vite/${getBundleType(context) ?? 'host'}`,
         customLogger: createFilteringLogger(),
-        server: { port: context.bundlerConfig.port ?? (isWebComponent ? 8888 : 8080) },
+        server: {
+            // Windows machines can fail to connect to "localhost"; bind to a fixed address instead.
+            host: '127.0.0.1',
+            port: context.bundlerConfig.port ?? (isWebComponent ? 8888 : 8080),
+        },
         mode: isProduction ? bundleConstants.mode.production : bundleConstants.mode.development,
         configFile: false,
         oxc: { legalComments: 'none' },

package/src/vite/config/create-filtering-logger.ts

@@ -11,13 +11,24 @@ const SHARED_ASSET_WARNINGS = [
 ];
 
 /*
- * Wraps Vite's logger to drop the shared-asset HTML warnings. Everything else passes through.
+ * Expected when code feature-detects an optional peer dependency (e.g. `Package.Export
+ * === undefined`) and ignoreModulesPlugin has substituted an empty module for it. Matched
+ * on the plugin's IGNORE_EMPTY marker so a genuinely undefined export elsewhere still warns.
+ */
+const IGNORED_MODULE_WARNINGS = [
+    /Import `\w+` will always be undefined because there is no matching export in '\\0IGNORE_EMPTY:[^']+'/,
+];
+
+const SUPPRESSED_WARNINGS = [...SHARED_ASSET_WARNINGS, ...IGNORED_MODULE_WARNINGS];
+
+/*
+ * Wraps Vite's logger to drop expected warnings. Everything else passes through.
  */
 export function createFilteringLogger(): Logger {
     const logger = createLogger();
     const { warn, warnOnce } = logger;
     const isSuppressed = (message: string) =>
-        SHARED_ASSET_WARNINGS.some(pattern => pattern.test(message));
+        SUPPRESSED_WARNINGS.some(pattern => pattern.test(message));
 
     logger.warn = (message, options) => {
         if (!isSuppressed(message)) {

package/src/vite/config/create-vite-build-context.ts

@@ -31,6 +31,7 @@ function createBundlerConfig(
             svgr: { ...pkgPluginOverrides.svgr, ...filePluginOverrides.svgr },
         },
         minify: { ...pkgMinify, ...fileMinify },
+        outDir: fileConfig.config?.build?.outDir ?? packageJsonConfig.config?.build?.outDir,
     };
 }