@typestyles/build-runner 0.0.0-unstable.5df620f04ca1 → 0.0.0-unstable.5e4858efecfc

package/dist/index.cjs

@@ -31,6 +31,7 @@ __export(index_exports, {
   extractNamespaces: () => extractNamespaces,
   getRouteCss: () => getRouteCss,
   isManifestV2: () => isManifestV2,
+  moduleNeedsOverrideHmr: () => moduleNeedsOverrideHmr,
   normalizeRoutePath: () => normalizeRoutePath,
   pageRelPathToRoutePath: () => pageRelPathToRoutePath,
   readCssFile: () => readCssFile,
@@ -80,7 +81,50 @@ var CREATE_THEME_RE = /(?:tokens\.)?createTheme\(\s*['"]([^'"]+)['"]/g;
 var KEYFRAMES_CREATE_RE = /keyframes\.create\(\s*['"]([^'"]+)['"]/g;
 var GLOBAL_STYLE_RE = /global\.style\(\s*['"]([^'"]+)['"]/g;
 var GLOBAL_FONT_FACE_RE = /global\.fontFace\(\s*['"]([^'"]+)['"]/g;
+var OVERRIDE_HMR_EXPORT_NAMES = /* @__PURE__ */ new Set(["createDesignTheme", "overrideComponent"]);
 var TYPESTYLES_IMPORT_RE = /(?:from\s+|import\s+|require\s*\(\s*)['"]typestyles['"]/;
+function stripCommentsForHmrScan(code) {
+  return code.replace(/\/\*[\s\S]*?\*\//g, "").replace(/(^|[^:])\/\/.*$/gm, "$1");
+}
+function collectOverrideHmrCallTargets(code) {
+  const locals = new Set(OVERRIDE_HMR_EXPORT_NAMES);
+  const namespaces = /* @__PURE__ */ new Set();
+  for (const match of code.matchAll(/import\s*{([^}]+)}\s*from\s*['"][^'"]+['"]/g)) {
+    for (const rawPart of match[1].split(",")) {
+      const part = rawPart.trim();
+      if (!part || part.startsWith("type ")) continue;
+      const asMatch = part.match(/^(\w+)\s+as\s+(\w+)$/);
+      if (asMatch) {
+        if (OVERRIDE_HMR_EXPORT_NAMES.has(asMatch[1])) {
+          locals.add(asMatch[2]);
+        }
+        continue;
+      }
+      const name = part.match(/^(\w+)$/)?.[1];
+      if (name && OVERRIDE_HMR_EXPORT_NAMES.has(name)) {
+        locals.add(name);
+      }
+    }
+  }
+  for (const match of code.matchAll(/import\s*\*\s*as\s+(\w+)\s*from\s*['"][^'"]+['"]/g)) {
+    namespaces.add(match[1]);
+  }
+  return { locals, namespaces };
+}
+function moduleNeedsOverrideHmr(code) {
+  const scan = stripCommentsForHmrScan(code);
+  if (/\bstyles\.override\s*\(/.test(scan)) return true;
+  const { locals, namespaces } = collectOverrideHmrCallTargets(scan);
+  for (const name of locals) {
+    if (new RegExp(`\\b${name}\\s*\\(`).test(scan)) return true;
+  }
+  for (const ns of namespaces) {
+    if (new RegExp(`\\b${ns}\\.(?:createDesignTheme|overrideComponent)\\s*\\(`).test(scan)) {
+      return true;
+    }
+  }
+  return false;
+}
 function extractNamespaces(code) {
   const keys = [];
   const prefixes = [];
@@ -540,6 +584,25 @@ async function runTypestylesBuild({
     format: "cjs",
     target: "node18",
     external: ["typestyles"],
+    // Style registration calls (styles.component/class, createTypeStyles) are
+    // side-effect-only: the CSS they register into the global registry is the
+    // point, regardless of whether the returned classname function is ever
+    // read. esbuild's default tree shaking doesn't know that, so any
+    // consumer module reached only through an unread namespace/barrel import
+    // (or a package marked "sideEffects": false) can have its registration
+    // calls silently dropped as "unused". Disable tree shaking here so every
+    // registration in the extraction graph survives.
+    treeShaking: false,
+    // `treeShaking: false` only stops esbuild from pruning declarations
+    // *within* an already-included module. It's a separate esbuild behavior
+    // by the treeShaking option — that drops a plain bare import entirely
+    // (`import './some-lib'` with no binding at all) when it resolves to a
+    // module/package marked "sideEffects": false, before that module is ever
+    // considered for inclusion. A real extraction entry is exactly this
+    // shape: several side-effect-only imports, any one of which may point at
+    // a (correctly) tree-shakeable component library. Ignore both kinds of
+    // annotation so every import in the extraction graph is included.
+    ignoreAnnotations: true,
     stdin: {
       contents: importLines,
       resolveDir: root,
@@ -594,6 +657,7 @@ ${result.stderr || result.stdout || "unknown error"}`
   extractNamespaces,
   getRouteCss,
   isManifestV2,
+  moduleNeedsOverrideHmr,
   normalizeRoutePath,
   pageRelPathToRoutePath,
   readCssFile,

package/dist/index.d.cts

@@ -10,6 +10,15 @@ declare const DEFAULT_EXTRACT_MODULE_CANDIDATES: readonly string[];
 declare function discoverDefaultExtractModules(root: string): string[];
 
 declare const TYPESTYLES_IMPORT_RE: RegExp;
+/**
+ * True when this module may register `styles.override` rules and needs Vite HMR
+ * dispose tracking — including Var UI sugar (`createDesignTheme` / `overrideComponent`)
+ * that never spells `styles.override` in source.
+ *
+ * Detects renamed imports (`createDesignTheme as cdt`) and namespace imports
+ * (`Core.createDesignTheme(`), not only the canonical identifier spelling.
+ */
+declare function moduleNeedsOverrideHmr(code: string): boolean;
 /**
  * Extract namespace information from source code for invalidation and duplicate checks.
  */
@@ -194,4 +203,4 @@ interface RunTypestylesBuildOptions {
  */
 declare function runTypestylesBuild({ root, modules, }: RunTypestylesBuildOptions): Promise<string>;
 
-export { type CollectRouteCssOptions, type CollectRouteCssResult, DEFAULT_EXTRACT_MODULE_CANDIDATES, type DuplicateNamespaceReporter, type GetRouteCssOptions, type NextAppRoute, type RunTypestylesBuildOptions, TYPESTYLES_IMPORT_RE, type TypestylesExtractManifest, type TypestylesExtractManifestV1, type TypestylesExtractManifestV2, type TypestylesExtractOptions, type TypestylesIntegrationMode, type TypestylesRouteCssEntry, VerifyTypestylesBuildError, type VerifyTypestylesBuildOptions, type VerifyTypestylesBuildResult, buildManifestV2, collectAndWriteRouteCss, createModuleLoader, discoverDefaultExtractModules, discoverNextAppRoutes, extractNamespaces, getRouteCss, isManifestV2, normalizeRoutePath, pageRelPathToRoutePath, readCssFile, readTypestylesManifest, reportDuplicateNamespaces, resolveExtractMode, resolveExtractModules, runTypestylesBuild, traceTypestylesModules, verifyTypestylesBuild };
+export { type CollectRouteCssOptions, type CollectRouteCssResult, DEFAULT_EXTRACT_MODULE_CANDIDATES, type DuplicateNamespaceReporter, type GetRouteCssOptions, type NextAppRoute, type RunTypestylesBuildOptions, TYPESTYLES_IMPORT_RE, type TypestylesExtractManifest, type TypestylesExtractManifestV1, type TypestylesExtractManifestV2, type TypestylesExtractOptions, type TypestylesIntegrationMode, type TypestylesRouteCssEntry, VerifyTypestylesBuildError, type VerifyTypestylesBuildOptions, type VerifyTypestylesBuildResult, buildManifestV2, collectAndWriteRouteCss, createModuleLoader, discoverDefaultExtractModules, discoverNextAppRoutes, extractNamespaces, getRouteCss, isManifestV2, moduleNeedsOverrideHmr, normalizeRoutePath, pageRelPathToRoutePath, readCssFile, readTypestylesManifest, reportDuplicateNamespaces, resolveExtractMode, resolveExtractModules, runTypestylesBuild, traceTypestylesModules, verifyTypestylesBuild };

package/dist/index.d.ts

@@ -10,6 +10,15 @@ declare const DEFAULT_EXTRACT_MODULE_CANDIDATES: readonly string[];
 declare function discoverDefaultExtractModules(root: string): string[];
 
 declare const TYPESTYLES_IMPORT_RE: RegExp;
+/**
+ * True when this module may register `styles.override` rules and needs Vite HMR
+ * dispose tracking — including Var UI sugar (`createDesignTheme` / `overrideComponent`)
+ * that never spells `styles.override` in source.
+ *
+ * Detects renamed imports (`createDesignTheme as cdt`) and namespace imports
+ * (`Core.createDesignTheme(`), not only the canonical identifier spelling.
+ */
+declare function moduleNeedsOverrideHmr(code: string): boolean;
 /**
  * Extract namespace information from source code for invalidation and duplicate checks.
  */
@@ -194,4 +203,4 @@ interface RunTypestylesBuildOptions {
  */
 declare function runTypestylesBuild({ root, modules, }: RunTypestylesBuildOptions): Promise<string>;
 
-export { type CollectRouteCssOptions, type CollectRouteCssResult, DEFAULT_EXTRACT_MODULE_CANDIDATES, type DuplicateNamespaceReporter, type GetRouteCssOptions, type NextAppRoute, type RunTypestylesBuildOptions, TYPESTYLES_IMPORT_RE, type TypestylesExtractManifest, type TypestylesExtractManifestV1, type TypestylesExtractManifestV2, type TypestylesExtractOptions, type TypestylesIntegrationMode, type TypestylesRouteCssEntry, VerifyTypestylesBuildError, type VerifyTypestylesBuildOptions, type VerifyTypestylesBuildResult, buildManifestV2, collectAndWriteRouteCss, createModuleLoader, discoverDefaultExtractModules, discoverNextAppRoutes, extractNamespaces, getRouteCss, isManifestV2, normalizeRoutePath, pageRelPathToRoutePath, readCssFile, readTypestylesManifest, reportDuplicateNamespaces, resolveExtractMode, resolveExtractModules, runTypestylesBuild, traceTypestylesModules, verifyTypestylesBuild };
+export { type CollectRouteCssOptions, type CollectRouteCssResult, DEFAULT_EXTRACT_MODULE_CANDIDATES, type DuplicateNamespaceReporter, type GetRouteCssOptions, type NextAppRoute, type RunTypestylesBuildOptions, TYPESTYLES_IMPORT_RE, type TypestylesExtractManifest, type TypestylesExtractManifestV1, type TypestylesExtractManifestV2, type TypestylesExtractOptions, type TypestylesIntegrationMode, type TypestylesRouteCssEntry, VerifyTypestylesBuildError, type VerifyTypestylesBuildOptions, type VerifyTypestylesBuildResult, buildManifestV2, collectAndWriteRouteCss, createModuleLoader, discoverDefaultExtractModules, discoverNextAppRoutes, extractNamespaces, getRouteCss, isManifestV2, moduleNeedsOverrideHmr, normalizeRoutePath, pageRelPathToRoutePath, readCssFile, readTypestylesManifest, reportDuplicateNamespaces, resolveExtractMode, resolveExtractModules, runTypestylesBuild, traceTypestylesModules, verifyTypestylesBuild };

package/dist/index.js

@@ -34,7 +34,50 @@ var CREATE_THEME_RE = /(?:tokens\.)?createTheme\(\s*['"]([^'"]+)['"]/g;
 var KEYFRAMES_CREATE_RE = /keyframes\.create\(\s*['"]([^'"]+)['"]/g;
 var GLOBAL_STYLE_RE = /global\.style\(\s*['"]([^'"]+)['"]/g;
 var GLOBAL_FONT_FACE_RE = /global\.fontFace\(\s*['"]([^'"]+)['"]/g;
+var OVERRIDE_HMR_EXPORT_NAMES = /* @__PURE__ */ new Set(["createDesignTheme", "overrideComponent"]);
 var TYPESTYLES_IMPORT_RE = /(?:from\s+|import\s+|require\s*\(\s*)['"]typestyles['"]/;
+function stripCommentsForHmrScan(code) {
+  return code.replace(/\/\*[\s\S]*?\*\//g, "").replace(/(^|[^:])\/\/.*$/gm, "$1");
+}
+function collectOverrideHmrCallTargets(code) {
+  const locals = new Set(OVERRIDE_HMR_EXPORT_NAMES);
+  const namespaces = /* @__PURE__ */ new Set();
+  for (const match of code.matchAll(/import\s*{([^}]+)}\s*from\s*['"][^'"]+['"]/g)) {
+    for (const rawPart of match[1].split(",")) {
+      const part = rawPart.trim();
+      if (!part || part.startsWith("type ")) continue;
+      const asMatch = part.match(/^(\w+)\s+as\s+(\w+)$/);
+      if (asMatch) {
+        if (OVERRIDE_HMR_EXPORT_NAMES.has(asMatch[1])) {
+          locals.add(asMatch[2]);
+        }
+        continue;
+      }
+      const name = part.match(/^(\w+)$/)?.[1];
+      if (name && OVERRIDE_HMR_EXPORT_NAMES.has(name)) {
+        locals.add(name);
+      }
+    }
+  }
+  for (const match of code.matchAll(/import\s*\*\s*as\s+(\w+)\s*from\s*['"][^'"]+['"]/g)) {
+    namespaces.add(match[1]);
+  }
+  return { locals, namespaces };
+}
+function moduleNeedsOverrideHmr(code) {
+  const scan = stripCommentsForHmrScan(code);
+  if (/\bstyles\.override\s*\(/.test(scan)) return true;
+  const { locals, namespaces } = collectOverrideHmrCallTargets(scan);
+  for (const name of locals) {
+    if (new RegExp(`\\b${name}\\s*\\(`).test(scan)) return true;
+  }
+  for (const ns of namespaces) {
+    if (new RegExp(`\\b${ns}\\.(?:createDesignTheme|overrideComponent)\\s*\\(`).test(scan)) {
+      return true;
+    }
+  }
+  return false;
+}
 function extractNamespaces(code) {
   const keys = [];
   const prefixes = [];
@@ -494,6 +537,25 @@ async function runTypestylesBuild({
     format: "cjs",
     target: "node18",
     external: ["typestyles"],
+    // Style registration calls (styles.component/class, createTypeStyles) are
+    // side-effect-only: the CSS they register into the global registry is the
+    // point, regardless of whether the returned classname function is ever
+    // read. esbuild's default tree shaking doesn't know that, so any
+    // consumer module reached only through an unread namespace/barrel import
+    // (or a package marked "sideEffects": false) can have its registration
+    // calls silently dropped as "unused". Disable tree shaking here so every
+    // registration in the extraction graph survives.
+    treeShaking: false,
+    // `treeShaking: false` only stops esbuild from pruning declarations
+    // *within* an already-included module. It's a separate esbuild behavior
+    // by the treeShaking option — that drops a plain bare import entirely
+    // (`import './some-lib'` with no binding at all) when it resolves to a
+    // module/package marked "sideEffects": false, before that module is ever
+    // considered for inclusion. A real extraction entry is exactly this
+    // shape: several side-effect-only imports, any one of which may point at
+    // a (correctly) tree-shakeable component library. Ignore both kinds of
+    // annotation so every import in the extraction graph is included.
+    ignoreAnnotations: true,
     stdin: {
       contents: importLines,
       resolveDir: root,
@@ -547,6 +609,7 @@ export {
   extractNamespaces,
   getRouteCss,
   isManifestV2,
+  moduleNeedsOverrideHmr,
   normalizeRoutePath,
   pageRelPathToRoutePath,
   readCssFile,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@typestyles/build-runner",
-  "version": "0.0.0-unstable.5df620f04ca1",
+  "version": "0.0.0-unstable.5e4858efecfc",
   "description": "Shared module execution utilities for typestyles build integrations",
   "type": "module",
   "main": "./dist/index.cjs",
@@ -29,6 +29,7 @@
     "eslint": "^9.39.2",
     "tsup": "^8.0.0",
     "typescript": "^5.4.0",
+    "typestyles": "0.0.0-unstable.5e4858efecfc",
     "vitest": "^3.0.0"
   },
   "license": "Apache-2.0",