@superblocksteam/sdk 2.0.141-next.2 → 2.0.142-next.0

package/dist/telemetry/startup-context.test.js

@@ -0,0 +1,70 @@
+import { ROOT_CONTEXT, trace } from "@opentelemetry/api";
+import { afterAll, beforeAll, describe, expect, it } from "vitest";
+import { getTestTelemetryInstance, getTestTracer, initTestTelemetry, resetTestTelemetry, } from "@superblocksteam/telemetry/testing";
+import { applyStartupTraceCarrier, extractStartupTraceContext, startupTraceCarrierFromHeaders, withStartupTraceContext, } from "./startup-context.js";
+const TRACE_ID = "4bf92f3577b34da6a3ce929d0e0e4736";
+const TRACEPARENT = `00-${TRACE_ID}-00f067aa0ba902b7-01`;
+describe("sdk-dev-server startup trace context", () => {
+    beforeAll(() => {
+        initTestTelemetry();
+    });
+    afterAll(async () => {
+        await resetTestTelemetry();
+    });
+    it("extracts the SABS parent from cold-start environment values", () => {
+        const parentContext = extractStartupTraceContext({
+            TRACEPARENT,
+            TRACESTATE: "vendor=value",
+        });
+        expect(trace.getSpanContext(parentContext)).toMatchObject({
+            isRemote: true,
+            traceId: TRACE_ID,
+            traceFlags: 1,
+            traceState: expect.objectContaining({
+                serialize: expect.any(Function),
+            }),
+        });
+        expect(trace.getSpanContext(parentContext)?.traceState?.serialize()).toBe("vendor=value");
+    });
+    it("uses the root context when startup propagation is absent", () => {
+        expect(extractStartupTraceContext({})).toBe(ROOT_CONTEXT);
+    });
+    it("stores warm activation headers for the startup path without stale tracestate", () => {
+        const env = {
+            TRACEPARENT: "stale",
+            TRACESTATE: "stale=value",
+        };
+        const carrier = { traceparent: TRACEPARENT };
+        applyStartupTraceCarrier(carrier, env);
+        expect(env.TRACEPARENT).toBe(TRACEPARENT);
+        expect(env.TRACESTATE).toBeUndefined();
+    });
+    it("captures inbound warm activation trace headers", () => {
+        expect(startupTraceCarrierFromHeaders({
+            traceparent: TRACEPARENT,
+            tracestate: "vendor=value",
+        })).toEqual({
+            traceparent: TRACEPARENT,
+            tracestate: "vendor=value",
+        });
+    });
+    it("parents the dev-server startup span to the propagated SABS context", async () => {
+        const environment = {
+            TRACEPARENT,
+            TRACESTATE: "vendor=value",
+        };
+        await withStartupTraceContext(environment, async () => {
+            await getTestTracer().startActiveSpan("devServerStartup", async (span) => {
+                span.end();
+            });
+        });
+        const [startupSpan] = getTestTelemetryInstance()
+            .spanExporter.getSpans()
+            .filter((span) => span.name === "devServerStartup");
+        expect(startupSpan.spanContext().traceId).toBe(TRACE_ID);
+        expect(startupSpan.parentSpanContext?.spanId).toBe("00f067aa0ba902b7");
+        expect(environment.TRACEPARENT).toBeUndefined();
+        expect(environment.TRACESTATE).toBeUndefined();
+    });
+});
+//# sourceMappingURL=startup-context.test.js.map

package/dist/telemetry/startup-context.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"startup-context.test.js","sourceRoot":"","sources":["../../src/telemetry/startup-context.test.ts"],"names":[],"mappings":"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"}

package/dist/vite-plugin-optimize-lucide-imports.d.ts

@@ -4,5 +4,25 @@ import type { Plugin } from "vite";
  * destructured imports to direct imports for better tree-shaking
  */
 declare function createLucideReactImportOptimizer(): Plugin;
+/**
+ * Transforms lucide-react imports from destructured to individual imports.
+ * Exported so tests can pin the emitted import specifiers against the ids the
+ * dep optimizer registers.
+ */
+export declare function transformLucideImports(sourceCode: string): {
+    transformedCode: string;
+    hasChanges: boolean;
+};
+/**
+ * The module id this plugin emits for a named lucide-react import. The `.js`
+ * extension is load-bearing: the dep optimizer's include glob registers each
+ * icon under its on-disk id (`…/icons/check.js`), and Vite's
+ * `tryOptimizedResolve` matches optimized deps by EXACT id — an extensionless
+ * import misses the optimized entry and is re-registered as a newly discovered
+ * dependency, re-running the optimizer (the reload this plugin + config
+ * combination exists to prevent). Exported so tests can assert the emitted ids
+ * and the optimized ids stay identical.
+ */
+export declare function lucideIconModuleId(importName: string): string;
 export default createLucideReactImportOptimizer;
 //# sourceMappingURL=vite-plugin-optimize-lucide-imports.d.ts.map

package/dist/vite-plugin-optimize-lucide-imports.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"vite-plugin-optimize-lucide-imports.d.ts","sourceRoot":"","sources":["../src/vite-plugin-optimize-lucide-imports.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAmB,MAAM,EAAE,MAAM,MAAM,CAAC;AAMpD;;;GAGG;AACH,iBAAS,gCAAgC,IAAI,MAAM,CA8BlD;AAyFD,eAAe,gCAAgC,CAAC"}
+{"version":3,"file":"vite-plugin-optimize-lucide-imports.d.ts","sourceRoot":"","sources":["../src/vite-plugin-optimize-lucide-imports.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAmB,MAAM,EAAE,MAAM,MAAM,CAAC;AAQpD;;;GAGG;AACH,iBAAS,gCAAgC,IAAI,MAAM,CA8BlD;AASD;;;;GAIG;AACH,wBAAgB,sBAAsB,CAAC,UAAU,EAAE,MAAM,GAAG;IAC1D,eAAe,EAAE,MAAM,CAAC;IACxB,UAAU,EAAE,OAAO,CAAC;CACrB,CAyBA;AAED;;;;;;;;;GASG;AACH,wBAAgB,kBAAkB,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,CAE7D;AAgDD,eAAe,gCAAgC,CAAC"}

package/dist/vite-plugin-optimize-lucide-imports.js

@@ -1,3 +1,4 @@
+import { LUCIDE_ICON_DEEP_PATH_PREFIX } from "./dev-utils/optimize-deps-config.mjs";
 // Pre-compile regex for better performance
 const LUCIDE_IMPORT_PATTERN = /([ \t]*)import\s+\{\s*([^}]+)\s*\}\s+from\s+['"]lucide-react['"]/g;
 /**
@@ -37,9 +38,11 @@ function isValidInput(code, id) {
     return Boolean(code && id);
 }
 /**
- * Transforms lucide-react imports from destructured to individual imports
+ * Transforms lucide-react imports from destructured to individual imports.
+ * Exported so tests can pin the emitted import specifiers against the ids the
+ * dep optimizer registers.
  */
-function transformLucideImports(sourceCode) {
+export function transformLucideImports(sourceCode) {
     let hasChanges = false;
     const transformedCode = sourceCode.replace(LUCIDE_IMPORT_PATTERN, (match, indentation, importNames) => {
         if (!importNames.trim())
@@ -54,6 +57,19 @@ function transformLucideImports(sourceCode) {
     });
     return { transformedCode, hasChanges };
 }
+/**
+ * The module id this plugin emits for a named lucide-react import. The `.js`
+ * extension is load-bearing: the dep optimizer's include glob registers each
+ * icon under its on-disk id (`…/icons/check.js`), and Vite's
+ * `tryOptimizedResolve` matches optimized deps by EXACT id — an extensionless
+ * import misses the optimized entry and is re-registered as a newly discovered
+ * dependency, re-running the optimizer (the reload this plugin + config
+ * combination exists to prevent). Exported so tests can assert the emitted ids
+ * and the optimized ids stay identical.
+ */
+export function lucideIconModuleId(importName) {
+    return `${LUCIDE_ICON_DEEP_PATH_PREFIX}${convertToKebabCase(importName)}.js`;
+}
 /**
  * Converts a comma-separated list of imports to individual import statements
  */
@@ -63,9 +79,8 @@ function convertToIndividualImports(importNames, indentation, withSemicolon) {
         .map((name) => name.trim())
         .filter(Boolean)
         .map((name) => {
-        const kebabCasePath = convertToKebabCase(name);
         const semicolon = withSemicolon ? ";" : "";
-        return `${indentation}import ${name} from "lucide-react/dist/esm/icons/${kebabCasePath}"${semicolon}`;
+        return `${indentation}import ${name} from "${lucideIconModuleId(name)}"${semicolon}`;
     })
         .join("\n");
 }

package/dist/vite-plugin-optimize-lucide-imports.js.map

@@ -1 +1 @@
-{"version":3,"file":"vite-plugin-optimize-lucide-imports.js","sourceRoot":"","sources":["../src/vite-plugin-optimize-lucide-imports.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"vite-plugin-optimize-lucide-imports.js","sourceRoot":"","sources":["../src/vite-plugin-optimize-lucide-imports.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@superblocksteam/sdk",
-  "version": "2.0.141-next.2",
+  "version": "2.0.142-next.0",
   "description": "Superblocks JS SDK",
   "homepage": "https://www.superblocks.com",
   "license": "Superblocks Community Software License",
@@ -57,11 +57,11 @@
     "vite-tsconfig-paths": "^6.0.4",
     "winston": "^3.17.0",
     "yaml": "^2.7.1",
-    "@superblocksteam/library-shared": "2.0.141-next.2",
-    "@superblocksteam/shared": "0.9598.2",
-    "@superblocksteam/util": "2.0.141-next.2",
-    "@superblocksteam/telemetry": "2.0.141-next.2",
-    "@superblocksteam/vite-plugin-file-sync": "2.0.141-next.2"
+    "@superblocksteam/library-shared": "2.0.142-next.0",
+    "@superblocksteam/telemetry": "2.0.142-next.0",
+    "@superblocksteam/util": "2.0.142-next.0",
+    "@superblocksteam/vite-plugin-file-sync": "2.0.142-next.0",
+    "@superblocksteam/shared": "0.9599.0"
   },
   "devDependencies": {
     "@eslint/js": "^9.39.2",

package/src/dev-utils/dev-server.optimize-deps.test.mts

@@ -1,6 +1,8 @@
+import { readFileSync } from "node:fs";
 import { mkdtemp, mkdir, rm, writeFile } from "node:fs/promises";
 import { tmpdir } from "node:os";
-import { join } from "node:path";
+import { dirname, join } from "node:path";
+import { fileURLToPath } from "node:url";
 
 import { optimizeDeps, resolveConfig } from "vite";
 import { afterAll, beforeAll, describe, expect, it } from "vitest";
@@ -11,7 +13,14 @@ import { afterAll, beforeAll, describe, expect, it } from "vitest";
 // drag in the heavy `dev-server.mjs` graph (vite + express + file-sync), which
 // would make a transitive load failure surface as an opaque import error rather
 // than a meaningful assertion.
-import { OPTIMIZE_DEPS_CONFIG } from "./optimize-deps-config.mjs";
+import {
+  lucideIconModuleId,
+  transformLucideImports,
+} from "../vite-plugin-optimize-lucide-imports.js";
+import {
+  NOT_PRE_OPTIMIZED_TEMPLATE_DEPS,
+  OPTIMIZE_DEPS_CONFIG,
+} from "./optimize-deps-config.mjs";
 
 /**
  * Behavioral regression repro for APPS-4576.
@@ -669,3 +678,326 @@ describe("dev server optimizeDeps includes the JSX runtime and excludes the virt
     ).not.toContain(SDK_API);
   }, 30_000);
 });
+
+/**
+ * Static pre-optimize contract for common live-edit template deps.
+ *
+ * The `entries` scan above pre-bundles deps that *existing* app source imports
+ * at pre-warm time. But a warm-pool box pre-warms against the seeded template,
+ * and Clark's generated code routinely imports template-declared deps the seed
+ * never touches (an unused Radix primitive, `recharts` for the first dashboard).
+ * Those first-time imports are runtime discoveries — a re-optimize, and in the
+ * worst case the "optimized dependencies changed. reloading" reload that drops
+ * the editor websocket. Force-including every dep the templates declare closes
+ * that gap.
+ *
+ * The list is a deliberate *static* duplicate of the template dependencies
+ * (not read from package.json at runtime): `include` IS part of Vite's dep
+ * cache config hash, so the pre-warm and activation servers must see the exact
+ * same value or activation discards the pre-warmed cache. The template-contract
+ * tests below keep the copy honest against both live-edit templates, in BOTH
+ * directions: everything included must be declared by both templates, and
+ * every dep both templates share must be included or explicitly excluded with
+ * a documented reason (NOT_PRE_OPTIMIZED_TEMPLATE_DEPS).
+ */
+describe("dev server optimizeDeps pre-optimizes common live-edit template deps", () => {
+  // Change-detector copy: intentionally duplicated from OPTIMIZE_DEPS_CONFIG so
+  // an include-list edit must be made consciously in both places.
+  const EXPECTED_INCLUDE = [
+    "@radix-ui/react-accordion",
+    "@radix-ui/react-aspect-ratio",
+    "@radix-ui/react-avatar",
+    "@radix-ui/react-checkbox",
+    "@radix-ui/react-dialog",
+    "@radix-ui/react-dropdown-menu",
+    "@radix-ui/react-hover-card",
+    "@radix-ui/react-label",
+    "@radix-ui/react-navigation-menu",
+    "@radix-ui/react-popover",
+    "@radix-ui/react-progress",
+    "@radix-ui/react-scroll-area",
+    "@radix-ui/react-select",
+    "@radix-ui/react-separator",
+    "@radix-ui/react-slider",
+    "@radix-ui/react-slot",
+    "@radix-ui/react-switch",
+    "@radix-ui/react-tabs",
+    "@radix-ui/react-toggle",
+    "@radix-ui/react-toggle-group",
+    "@radix-ui/react-tooltip",
+    "@superblocksteam/library/jsx-dev-runtime",
+    "class-variance-authority",
+    "clsx",
+    "date-fns",
+    "lucide-react",
+    "lucide-react/dist/esm/icons/*",
+    "react",
+    "react-day-picker",
+    "react-dom",
+    "react-dom/client",
+    "react-dropzone",
+    "react-router",
+    "react-syntax-highlighter",
+    "react/jsx-runtime",
+    "recharts",
+    "sonner",
+    "tailwind-merge",
+  ];
+
+  it("force-includes the common template deps shared by pre-warm and activation", () => {
+    expect(OPTIMIZE_DEPS_CONFIG?.include).toEqual(EXPECTED_INCLUDE);
+  });
+
+  it("does not pre-bundle the bare Superblocks library runtime", () => {
+    // Pre-bundling `@superblocksteam/library` itself creates a second copy of
+    // the library runtime: generated apps also receive it through the SDK's
+    // plugin pipeline, and a prebundled duplicate splits React context/hook
+    // state between the two copies. Only the `/jsx-dev-runtime` subpath (which
+    // the scan structurally cannot discover — see the include/exclude suite
+    // above) is force-included.
+    expect(OPTIMIZE_DEPS_CONFIG?.include).not.toContain(
+      "@superblocksteam/library",
+    );
+  });
+
+  it("keeps the include list sorted for maintainability", () => {
+    expect(OPTIMIZE_DEPS_CONFIG?.include).toEqual(
+      [...(OPTIMIZE_DEPS_CONFIG?.include ?? [])].sort(),
+    );
+  });
+
+  it("retains the esbuild destructuring transform for optimized deps", () => {
+    expect(OPTIMIZE_DEPS_CONFIG?.esbuildOptions?.supported).toEqual({
+      destructuring: true,
+    });
+  });
+
+  const LIVE_EDIT_TEMPLATES = ["app-fullstack", "shadcn-demo-app"];
+
+  const packageNameForInclude = (dep: string) => {
+    const parts = dep.split("/");
+    return dep.startsWith("@") ? parts.slice(0, 2).join("/") : parts[0];
+  };
+
+  const templatesRoot = join(
+    dirname(fileURLToPath(import.meta.url)),
+    "..",
+    "..",
+    "..",
+    "..",
+    "..",
+    "demo-apps",
+  );
+
+  // Validated read of a template's declared dependencies — no type assertion:
+  // a malformed package.json fails with a descriptive error, not a silent
+  // empty set.
+  function readTemplateDependencies(templateName: string): Set<string> {
+    const raw: unknown = JSON.parse(
+      readFileSync(join(templatesRoot, templateName, "package.json"), "utf8"),
+    );
+    if (raw === null || typeof raw !== "object" || !("dependencies" in raw)) {
+      throw new Error(
+        `"${templateName}" package.json has no dependencies object`,
+      );
+    }
+    const dependencies: unknown = raw.dependencies;
+    if (
+      dependencies === null ||
+      typeof dependencies !== "object" ||
+      Array.isArray(dependencies)
+    ) {
+      throw new Error(
+        `"${templateName}" package.json dependencies is not an object`,
+      );
+    }
+    return new Set(Object.keys(dependencies));
+  }
+
+  it("only includes deps that both live-edit templates declare", () => {
+    // Every force-included package must be installed in every app the config
+    // serves, or the include is a no-op for that app (Vite warns and skips an
+    // unresolvable entry). Both live-edit templates are the install contract:
+    // if a package leaves the templates, it must leave this list; if it is in
+    // this list, both templates must declare it.
+    const includePackages = new Set(
+      (OPTIMIZE_DEPS_CONFIG?.include ?? []).map(packageNameForInclude),
+    );
+
+    for (const templateName of LIVE_EDIT_TEMPLATES) {
+      const templateDependencies = readTemplateDependencies(templateName);
+
+      expect(
+        [...includePackages].filter((dep) => !templateDependencies.has(dep)),
+        `packages force-included by OPTIMIZE_DEPS_CONFIG but not declared as ` +
+          `dependencies of the "${templateName}" template`,
+      ).toEqual([]);
+    }
+  });
+
+  it("includes or explicitly excludes every dep the templates share", () => {
+    // Reverse direction of the contract above: the include list claims to be
+    // "every dep both templates declare", so a dep present in BOTH templates
+    // must either be force-included or appear in NOT_PRE_OPTIMIZED_TEMPLATE_DEPS
+    // with a documented reason. Without this, a newly-seeded template dep
+    // silently regresses to a runtime discovery on its first generated import.
+    const includePackages = new Set(
+      (OPTIMIZE_DEPS_CONFIG?.include ?? []).map(packageNameForInclude),
+    );
+    const excluded = new Set(NOT_PRE_OPTIMIZED_TEMPLATE_DEPS);
+
+    const [first, ...rest] = LIVE_EDIT_TEMPLATES.map(readTemplateDependencies);
+    const shared = [...first].filter((dep) =>
+      rest.every((deps) => deps.has(dep)),
+    );
+
+    expect(
+      shared.filter((dep) => !includePackages.has(dep) && !excluded.has(dep)),
+      `deps declared by ALL live-edit templates that are neither force-` +
+        `included nor documented in NOT_PRE_OPTIMIZED_TEMPLATE_DEPS`,
+    ).toEqual([]);
+
+    // Keep the exclusion list honest too: an entry that no longer exists in
+    // the shared template deps is stale and should be removed.
+    expect(
+      [...excluded].filter((dep) => !shared.includes(dep)),
+      `NOT_PRE_OPTIMIZED_TEMPLATE_DEPS entries no longer declared by all ` +
+        `live-edit templates`,
+    ).toEqual([]);
+  });
+});
+
+/**
+ * Regression repro for the lucide-react per-icon deep-path gap.
+ *
+ * `vite-plugin-optimize-lucide-imports` unconditionally rewrites
+ * `import { Check } from "lucide-react"` into
+ * `import Check from "lucide-react/dist/esm/icons/check.js"` at serve time.
+ * The dep optimizer therefore sees the per-icon DEEP paths, never the bare
+ * specifier — so `include: ["lucide-react"]` pre-bundles the package entry
+ * while every first-time icon import is still a runtime discovery. The config
+ * must include the icon glob (`lucide-react/dist/esm/icons/*`, expanded by
+ * Vite's `expandGlobIds`) so newly-generated code can use any icon without
+ * triggering a re-optimize. Measured against the real template's lucide-react
+ * (1,851 icons): the glob adds ~1.4s to cold-start optimize — inside the
+ * warm-standby budget, and it covers the whole icon set instead of a top-N
+ * guess.
+ *
+ * The exact id form matters: Vite's `tryOptimizedResolve` matches optimized
+ * deps by EXACT id (its only fallback loop handles nested `"parent > dep"`
+ * ids, not resolved files — verified against Vite 6.4.3). Glob expansion
+ * registers each icon under its on-disk id (`…/icons/check.js`), so the
+ * rewrite plugin must emit the same `.js`-suffixed ids or an extensionless
+ * import misses the optimized entry and re-registers the icon as a newly
+ * discovered dependency, re-running the optimizer anyway. The tests below pin
+ * both halves: the plugin's emitted ids and the glob's optimized ids are the
+ * same strings.
+ */
+describe("dev server optimizeDeps pre-bundles lucide-react per-icon deep paths", () => {
+  let fixtureRoot: string;
+
+  beforeAll(async () => {
+    fixtureRoot = await mkdtemp(join(tmpdir(), "lucide-icon-glob-"));
+    await writeFile(
+      join(fixtureRoot, "package.json"),
+      JSON.stringify({
+        name: "lucide-icon-glob-fixture",
+        private: true,
+        version: "0.0.0",
+        type: "module",
+      }),
+    );
+    await writeFile(
+      join(fixtureRoot, "index.html"),
+      `<!doctype html><html><head></head><body><div id="root"></div>` +
+        `<script type="module" src="/src/main.tsx"></script></body></html>`,
+    );
+    const srcDir = join(fixtureRoot, "src");
+    await mkdir(srcDir, { recursive: true });
+    // Source imports NO icons: the glob include alone must pre-bundle them,
+    // exactly like a seeded template whose source hasn't used an icon yet.
+    await writeFile(join(srcDir, "main.tsx"), `export const root = "app";\n`);
+
+    // Minimal lucide-react mirroring the real layout: a package entry plus
+    // per-icon modules under dist/esm/icons/ (the paths the rewrite plugin
+    // emits).
+    const lucideDir = join(fixtureRoot, "node_modules", "lucide-react");
+    const iconsDir = join(lucideDir, "dist", "esm", "icons");
+    await mkdir(iconsDir, { recursive: true });
+    await writeFile(
+      join(lucideDir, "package.json"),
+      JSON.stringify({
+        name: "lucide-react",
+        version: "1.0.0",
+        type: "module",
+        main: "dist/esm/index.js",
+        module: "dist/esm/index.js",
+      }),
+    );
+    await writeFile(
+      join(lucideDir, "dist", "esm", "index.js"),
+      `export const icons = {};\n`,
+    );
+    for (const icon of ["check", "chevron-down"]) {
+      await writeFile(
+        join(iconsDir, `${icon}.js`),
+        `export default function ${icon.replace("-", "_")}() { return null; }\n`,
+      );
+    }
+  });
+
+  afterAll(async () => {
+    if (fixtureRoot) {
+      await rm(fixtureRoot, { recursive: true, force: true });
+    }
+  });
+
+  it("pre-bundles every icon deep path via the include glob", async () => {
+    const config = await resolveConfig(
+      {
+        root: fixtureRoot,
+        configFile: false,
+        logLevel: "silent",
+        optimizeDeps: OPTIMIZE_DEPS_CONFIG,
+      },
+      "serve",
+    );
+    const metadata = await optimizeDeps(config, true, false);
+    const optimized = Object.keys(metadata.optimized);
+
+    // The load-bearing serve-path contract: the id the rewrite plugin emits
+    // for an icon import must be EXACTLY an optimized-dep key, because
+    // `tryOptimizedResolve` matches by exact id. Asserting membership with the
+    // plugin's own `lucideIconModuleId` (instead of a hand-written string)
+    // means a drift on either side — plugin output shape or glob-registered
+    // ids — turns this red.
+    for (const importName of ["Check", "ChevronDown"]) {
+      expect(
+        optimized,
+        `"${lucideIconModuleId(importName)}" (the id the rewrite plugin emits ` +
+          `for "${importName}") is not an optimized-dep key (optimized: ` +
+          `[${optimized.join(", ")}]). Vite matches optimized deps by exact ` +
+          `id, so this icon's first import would be re-registered as a newly ` +
+          `discovered dependency and re-run the optimizer — the reload this ` +
+          `config exists to prevent.`,
+      ).toContain(lucideIconModuleId(importName));
+    }
+  }, 30_000);
+
+  it("rewrites named lucide imports to the .js-suffixed ids the optimizer registers", () => {
+    const { transformedCode, hasChanges } = transformLucideImports(
+      `import { Check, ChevronDown } from "lucide-react";\n`,
+    );
+
+    expect(hasChanges).toBe(true);
+    expect(transformedCode).toContain(
+      `import Check from "${lucideIconModuleId("Check")}"`,
+    );
+    expect(transformedCode).toContain(
+      `import ChevronDown from "${lucideIconModuleId("ChevronDown")}"`,
+    );
+    // Extensionless emissions would bypass the glob-registered `.js` ids and
+    // re-run the optimizer on first use of a new icon.
+    expect(transformedCode).not.toContain(`/icons/check"`);
+  });
+});