@hanzogui/static 8.1.0 → 8.2.0

package/dist/exports.cjs

@@ -35,6 +35,7 @@ __reExport(exports_exports, require("./types.cjs"), module.exports);
 var import_createExtractor = require("./extractor/createExtractor.cjs");
 var import_literalToAst = require("./extractor/literalToAst.cjs");
 __reExport(exports_exports, require("./constants.cjs"), module.exports);
+__reExport(exports_exports, require("./extractor/extractablePath.cjs"), module.exports);
 __reExport(exports_exports, require("./extractor/extractToClassNames.cjs"), module.exports);
 __reExport(exports_exports, require("./extractor/concatClassName.cjs"), module.exports);
 __reExport(exports_exports, require("./extractor/extractToNative.cjs"), module.exports);

package/dist/extractor/createExtractor.cjs

@@ -47,6 +47,7 @@ var import_typescript = require("typescript");
 var import_constants = require("../constants.cjs");
 var import_requireGuiCore = require("../helpers/requireGuiCore.cjs");
 var import_createEvaluator = require("./createEvaluator.cjs");
+var import_extractablePath = require("./extractablePath.cjs");
 var import_evaluateAstNode = require("./evaluateAstNode.cjs");
 var import_extractHelpers = require("./extractHelpers.cjs");
 var import_findTopmostFunction = require("./findTopmostFunction.cjs");
@@ -294,7 +295,7 @@ function createExtractor({
         throw new Error(`Must provide components`);
       }
     }
-    if (sourcePath && includeExtensions && !includeExtensions.some(ext => sourcePath.endsWith(ext))) {
+    if (sourcePath && includeExtensions && !(0, import_extractablePath.installedPackageOf)(sourcePath) && !includeExtensions.some(ext => sourcePath.endsWith(ext))) {
       if (shouldPrintDebug) {
         logger.info(`Ignoring file due to includeExtensions: ${sourcePath}, includeExtensions: ${includeExtensions.join(", ")}`);
       }

package/dist/extractor/extractToClassNames.cjs

@@ -43,6 +43,7 @@ var path = __toESM(require("node:path"));
 var util = __toESM(require("node:util"));
 var import_requireGuiCore = require("../helpers/requireGuiCore.cjs");
 var import_babelParse = require("./babelParse.cjs");
+var import_extractablePath = require("./extractablePath.cjs");
 var import_createLogger = require("./createLogger.cjs");
 var import_extractMediaStyle = require("./extractMediaStyle.cjs");
 var import_normalizeTernaries = require("./normalizeTernaries.cjs");
@@ -64,7 +65,7 @@ async function extractToClassNames({
     getCSSStylesAtomic,
     createMediaStyle
   } = (0, import_requireGuiCore.requireGuiCore)("web");
-  if (sourcePath.includes("node_modules")) {
+  if (!(0, import_extractablePath.isExtractable)(sourcePath, options.extractPackages)) {
     return null;
   }
   if (shouldPrintDebug) {

package/dist/extractor/extractablePath.cjs

@@ -0,0 +1,51 @@
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all) __defProp(target, name, {
+    get: all[name],
+    enumerable: true
+  });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from)) if (!__hasOwnProp.call(to, key) && key !== except) __defProp(to, key, {
+      get: () => from[key],
+      enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable
+    });
+  }
+  return to;
+};
+var __toCommonJS = mod => __copyProps(__defProp({}, "__esModule", {
+  value: true
+}), mod);
+var extractablePath_exports = {};
+__export(extractablePath_exports, {
+  DEFAULT_EXTRACT_PACKAGES: () => DEFAULT_EXTRACT_PACKAGES,
+  installedPackageOf: () => installedPackageOf,
+  isExtractable: () => isExtractable
+});
+module.exports = __toCommonJS(extractablePath_exports);
+const DEFAULT_EXTRACT_PACKAGES = ["@hanzo/ui", "@hanzo/gui", "@hanzogui/*"];
+const NEVER_EXTRACT = ["lucide-icons"];
+const NODE_MODULES = "node_modules/";
+function installedPackageOf(sourcePath) {
+  const normalized = sourcePath.replace(/\\/g, "/");
+  const at = normalized.lastIndexOf(NODE_MODULES);
+  if (at === -1) return "";
+  const rest = normalized.slice(at + NODE_MODULES.length);
+  const parts = rest.split("/");
+  if (!parts[0]) return "";
+  return parts[0].startsWith("@") ? parts.slice(0, 2).join("/") : parts[0];
+}
+function matches(entry, pkg) {
+  const prefix = entry.endsWith("/*") ? entry.slice(0, -1) : entry.endsWith("/") ? entry : "";
+  return prefix ? pkg.startsWith(prefix) : pkg === entry;
+}
+function isExtractable(sourcePath, extractPackages = []) {
+  if (NEVER_EXTRACT.some(name => sourcePath.includes(name))) return false;
+  const pkg = installedPackageOf(sourcePath);
+  if (!pkg) return true;
+  return extractPackages.some(entry => matches(entry, pkg));
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hanzogui/static",
-  "version": "8.1.0",
+  "version": "8.2.0",
   "gitHead": "a49cc7ea6b93ba384e77a4880ae48ac4a5635c14",
   "license": "MIT",
   "source": "src/index.ts",
@@ -22,6 +22,10 @@
       "types": "./types/worker.d.ts",
       "default": "./dist/worker.cjs"
     },
+    "./extractablePath": {
+      "types": "./types/extractor/extractablePath.d.ts",
+      "default": "./dist/extractor/extractablePath.cjs"
+    },
     "./checkDeps": {
       "types": "./types/checkDeps.d.ts",
       "default": "./dist/checkDeps.cjs"
@@ -50,19 +54,19 @@
     "@babel/template": "^7.25.0",
     "@babel/traverse": "^7.25.4",
     "@babel/types": "^7.25.4",
-    "@hanzogui/cli-color": "8.1.0",
-    "@hanzogui/config-default": "8.1.0",
-    "@hanzogui/core": "8.1.0",
-    "@hanzogui/fake-react-native": "8.1.0",
-    "@hanzogui/generate-themes": "8.1.0",
-    "@hanzogui/helpers": "8.1.0",
-    "@hanzogui/helpers-node": "8.1.0",
-    "@hanzogui/proxy-worm": "8.1.0",
-    "@hanzogui/react-native-web-internals": "8.1.0",
-    "@hanzogui/react-native-web-lite": "8.1.0",
-    "@hanzogui/shorthands": "8.1.0",
-    "@hanzogui/types": "8.1.0",
-    "@hanzogui/web": "8.1.0",
+    "@hanzogui/cli-color": "8.2.0",
+    "@hanzogui/config-default": "8.2.0",
+    "@hanzogui/core": "8.2.0",
+    "@hanzogui/fake-react-native": "8.2.0",
+    "@hanzogui/generate-themes": "8.2.0",
+    "@hanzogui/helpers": "8.2.0",
+    "@hanzogui/helpers-node": "8.2.0",
+    "@hanzogui/proxy-worm": "8.2.0",
+    "@hanzogui/react-native-web-internals": "8.2.0",
+    "@hanzogui/react-native-web-lite": "8.2.0",
+    "@hanzogui/shorthands": "8.2.0",
+    "@hanzogui/types": "8.2.0",
+    "@hanzogui/web": "8.2.0",
     "babel-literal-to-ast": "^2.1.0",
     "browserslist": "^4.28.1",
     "check-dependency-version-consistency": "^4.1.0",
@@ -79,7 +83,7 @@
   },
   "devDependencies": {
     "@babel/plugin-syntax-typescript": "^7.25.4",
-    "@hanzogui/build": "8.1.0",
+    "@hanzogui/build": "8.2.0",
     "@types/babel__core": "^7.20.5",
     "@types/find-root": "^1.1.2",
     "@types/node": "^22.1.0",

package/src/exports.ts

@@ -3,6 +3,7 @@ export * from './types'
 export { createExtractor } from './extractor/createExtractor'
 export { literalToAst } from './extractor/literalToAst'
 export * from './constants'
+export * from './extractor/extractablePath'
 export * from './extractor/extractToClassNames'
 export * from './extractor/concatClassName'
 export * from './extractor/extractToNative'

package/src/extractor/createExtractor.ts

@@ -30,6 +30,7 @@ import type {
 } from '../types'
 import type { LoadedComponents, GuiProjectInfo } from './bundleConfig'
 import { createEvaluator, createSafeEvaluator } from './createEvaluator'
+import { installedPackageOf } from './extractablePath'
 import { evaluateAstNode } from './evaluateAstNode'
 import {
   attrStr,
@@ -351,9 +352,15 @@ export function createExtractor(
       }
     }
 
+    // includeExtensions describes the app's OWN source, where the author picks
+    // the extension. An installed package ships whatever its build emits —
+    // .mjs, .js — and it already passed the package allowlist to get here, so
+    // holding it to ['.ts', '.tsx', '.jsx'] rejected every design-system file
+    // the allowlist had just admitted.
     if (
       sourcePath &&
       includeExtensions &&
+      !installedPackageOf(sourcePath) &&
       !includeExtensions.some((ext) => sourcePath.endsWith(ext))
     ) {
       if (shouldPrintDebug) {

package/src/extractor/extractToClassNames.ts

@@ -7,6 +7,7 @@ import * as util from 'node:util'
 import { requireGuiCore } from '../helpers/requireGuiCore'
 import type { StyleObject, GuiOptions, Ternary } from '../types'
 import { babelParse } from './babelParse'
+import { isExtractable } from './extractablePath'
 import type { Extractor } from './createExtractor'
 import { createLogger } from './createLogger'
 import { extractMediaStyle } from './extractMediaStyle'
@@ -57,7 +58,7 @@ export async function extractToClassNames({
   const tm = timer()
   const { getCSSStylesAtomic, createMediaStyle } = requireGuiCore('web')
 
-  if (sourcePath.includes('node_modules')) {
+  if (!isExtractable(sourcePath, options.extractPackages)) {
     return null
   }
 

package/src/extractor/extractablePath.ts

@@ -0,0 +1,88 @@
+/**
+ * One place decides which files the compiler may read styles out of.
+ *
+ * The compiler used to answer this with `sourcePath.includes('node_modules')`,
+ * in two places that had to agree by hand — the webpack loader and
+ * extractToClassNames. That answer was right about the cost and wrong about
+ * the design system: for a *consumer*, `@hanzo/ui` and every `@hanzogui/*`
+ * package IS node_modules, so no app could ask the compiler to look at them
+ * even if it wanted to.
+ *
+ * So this is a policy with a knob, not a hardcoded skip. The knob is
+ * `extractPackages`, and it is EMPTY by default, which is exactly the old
+ * behavior. What turning it on buys, measured on hanzo.one (Vite 5, @hanzo/ui
+ * 8.0.63 on @hanzo/gui 8.1, 5026 modules):
+ *
+ *   extracted files            4 -> 54
+ *   cached sheet         150,172 -> 151,151 B   (+979)
+ *   CSS injected at runtime  27,376 -> 27,376 B (unchanged, 356 rules both)
+ *
+ * Every one of those 979 bytes is a `styled()` DEFINITION rule, and the
+ * compiler deliberately leaves the definition in place ("the runtime needs
+ * real values for animations, context, and group styles"), so the runtime
+ * mints the same class again. 10 of the 20 new rules are delivered twice on
+ * the home route; the rest are for components that route never renders. The
+ * saving that would justify the cost — flattening a `<YStack p={10}>` usage
+ * site down to a className — cannot happen inside an installed package at all,
+ * because `module:jsx` currently emits the same JSX-lowered output as the ESM
+ * build (byte-identical, hardlinked), so there is no JSX left to flatten.
+ *
+ * Fix that, and turning this on becomes a real win. Until then, an app can opt
+ * in with `extractPackages: DEFAULT_EXTRACT_PACKAGES` and get a slightly
+ * bigger sheet for its trouble.
+ */
+
+/** The design-system allowlist an app can opt into. Not the default. */
+export const DEFAULT_EXTRACT_PACKAGES = ['@hanzo/ui', '@hanzo/gui', '@hanzogui/*']
+
+/**
+ * Generated icon sets: 1760 modules of react-native-svg elements wrapped in
+ * `themed()`, holding no `styled()` between them. Parsing them costs a full
+ * babel pass each and yields no CSS, installed or in a workspace — which is
+ * why the path is skipped rather than the package name. Measured on the same
+ * build: 1761 files that the allowlist would otherwise have to reject one at
+ * a time.
+ */
+const NEVER_EXTRACT = ['lucide-icons']
+
+const NODE_MODULES = 'node_modules/'
+
+/**
+ * The installed package a file belongs to, or '' when the file is app or
+ * workspace source. Reads the LAST `node_modules/` segment, so a nested
+ * install and pnpm's `.pnpm/<pkg>@<ver>/node_modules/<pkg>` both name the
+ * package that actually owns the file.
+ */
+export function installedPackageOf(sourcePath: string): string {
+  const normalized = sourcePath.replace(/\\/g, '/')
+  const at = normalized.lastIndexOf(NODE_MODULES)
+  if (at === -1) return ''
+  const rest = normalized.slice(at + NODE_MODULES.length)
+  const parts = rest.split('/')
+  if (!parts[0]) return ''
+  return parts[0].startsWith('@') ? parts.slice(0, 2).join('/') : parts[0]
+}
+
+/**
+ * An entry names one package (`@hanzo/ui`) or a whole scope (`@hanzogui/*`,
+ * or the equivalent `@hanzogui/`).
+ */
+function matches(entry: string, pkg: string): boolean {
+  const prefix = entry.endsWith('/*')
+    ? entry.slice(0, -1)
+    : entry.endsWith('/')
+      ? entry
+      : ''
+  return prefix ? pkg.startsWith(prefix) : pkg === entry
+}
+
+/** May the compiler read styles out of this file? */
+export function isExtractable(
+  sourcePath: string,
+  extractPackages: string[] = []
+): boolean {
+  if (NEVER_EXTRACT.some((name) => sourcePath.includes(name))) return false
+  const pkg = installedPackageOf(sourcePath)
+  if (!pkg) return true
+  return extractPackages.some((entry) => matches(entry, pkg))
+}

package/types/exports.d.ts

@@ -3,6 +3,7 @@ export * from './types';
 export { createExtractor } from './extractor/createExtractor';
 export { literalToAst } from './extractor/literalToAst';
 export * from './constants';
+export * from './extractor/extractablePath';
 export * from './extractor/extractToClassNames';
 export * from './extractor/concatClassName';
 export * from './extractor/extractToNative';

package/types/exports.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"exports.d.ts","sourceRoot":"","sources":["../src/exports.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAA;AAC3B,cAAc,SAAS,CAAA;AACvB,OAAO,EAAE,eAAe,EAAE,MAAM,6BAA6B,CAAA;AAC7D,OAAO,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAA;AACvD,cAAc,aAAa,CAAA;AAC3B,cAAc,iCAAiC,CAAA;AAC/C,cAAc,6BAA6B,CAAA;AAC3C,cAAc,6BAA6B,CAAA;AAC3C,cAAc,4BAA4B,CAAA;AAC1C,cAAc,qBAAqB,CAAA;AACnC,cAAc,4BAA4B,CAAA;AAC1C,cAAc,0BAA0B,CAAA;AACxC,cAAc,mBAAmB,CAAA;AACjC,OAAO,EAAE,kBAAkB,EAAE,gBAAgB,EAAE,MAAM,gCAAgC,CAAA;AACrF,OAAO,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAA;AACtD,cAAc,oBAAoB,CAAA"}
+{"version":3,"file":"exports.d.ts","sourceRoot":"","sources":["../src/exports.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAA;AAC3B,cAAc,SAAS,CAAA;AACvB,OAAO,EAAE,eAAe,EAAE,MAAM,6BAA6B,CAAA;AAC7D,OAAO,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAA;AACvD,cAAc,aAAa,CAAA;AAC3B,cAAc,6BAA6B,CAAA;AAC3C,cAAc,iCAAiC,CAAA;AAC/C,cAAc,6BAA6B,CAAA;AAC3C,cAAc,6BAA6B,CAAA;AAC3C,cAAc,4BAA4B,CAAA;AAC1C,cAAc,qBAAqB,CAAA;AACnC,cAAc,4BAA4B,CAAA;AAC1C,cAAc,0BAA0B,CAAA;AACxC,cAAc,mBAAmB,CAAA;AACjC,OAAO,EAAE,kBAAkB,EAAE,gBAAgB,EAAE,MAAM,gCAAgC,CAAA;AACrF,OAAO,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAA;AACtD,cAAc,oBAAoB,CAAA"}

package/types/extractor/createExtractor.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"createExtractor.d.ts","sourceRoot":"","sources":["../../src/extractor/createExtractor.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAmB,MAAM,iBAAiB,CAAA;AAEhE,OAAO,KAAK,CAAC,MAAM,cAAc,CAAA;AAmBjC,OAAO,KAAK,EAGV,gBAAgB,EAChB,mBAAmB,EACnB,UAAU,EAGX,MAAM,UAAU,CAAA;AACjB,OAAO,KAAK,EAAoB,cAAc,EAAE,MAAM,gBAAgB,CAAA;AActE,OAAO,EAAE,iBAAiB,EAA6B,MAAM,6BAA6B,CAAA;AAwB1F,MAAM,MAAM,SAAS,GAAG,UAAU,CAAC,OAAO,eAAe,CAAC,CAAA;AAE1D,KAAK,UAAU,GAAG,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,IAAI,CAAA;AA6C9C,wBAAgB,eAAe,CAC7B,EAAE,MAAgB,EAAE,QAAgB,EAAE,GAAE,gBAAsC;;;;;qBAsJnD,UAAU;yBAPZ,UAAU;;mBAwBlB,UAAU,SAAS,mBAAmB;;;;;;;eAKpC,UAAU,SAAS,mBAAmB;;;;;;;EA8iF1D"}
+{"version":3,"file":"createExtractor.d.ts","sourceRoot":"","sources":["../../src/extractor/createExtractor.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAmB,MAAM,iBAAiB,CAAA;AAEhE,OAAO,KAAK,CAAC,MAAM,cAAc,CAAA;AAmBjC,OAAO,KAAK,EAGV,gBAAgB,EAChB,mBAAmB,EACnB,UAAU,EAGX,MAAM,UAAU,CAAA;AACjB,OAAO,KAAK,EAAoB,cAAc,EAAE,MAAM,gBAAgB,CAAA;AAetE,OAAO,EAAE,iBAAiB,EAA6B,MAAM,6BAA6B,CAAA;AAwB1F,MAAM,MAAM,SAAS,GAAG,UAAU,CAAC,OAAO,eAAe,CAAC,CAAA;AAE1D,KAAK,UAAU,GAAG,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,IAAI,CAAA;AA6C9C,wBAAgB,eAAe,CAC7B,EAAE,MAAgB,EAAE,QAAgB,EAAE,GAAE,gBAAsC;;;;;qBAsJnD,UAAU;yBAPZ,UAAU;;mBAwBlB,UAAU,SAAS,mBAAmB;;;;;;;eAKpC,UAAU,SAAS,mBAAmB;;;;;;;EAojF1D"}

package/types/extractor/extractToClassNames.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"extractToClassNames.d.ts","sourceRoot":"","sources":["../../src/extractor/extractToClassNames.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,CAAC,MAAM,cAAc,CAAA;AAKjC,OAAO,KAAK,EAAe,UAAU,EAAW,MAAM,UAAU,CAAA;AAEhE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAA;AAYlD,MAAM,MAAM,iBAAiB,GAAG;IAC9B,EAAE,EAAE,MAAM,GAAG,MAAM,CAAA;IACnB,MAAM,EAAE,MAAM,CAAA;IACd,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,GAAG,EAAE,CAAC,CAAC,IAAI,CAAA;IACX,GAAG,EAAE,GAAG,CAAA;IACR,KAAK,EAAE;QACL,MAAM,EAAE,MAAM,CAAA;QACd,SAAS,EAAE,MAAM,CAAA;QACjB,SAAS,EAAE,MAAM,CAAA;QACjB,KAAK,EAAE,MAAM,CAAA;KACd,CAAA;CACF,CAAA;AAED,MAAM,MAAM,wBAAwB,GAAG;IACrC,SAAS,EAAE,SAAS,CAAA;IACpB,MAAM,EAAE,MAAM,GAAG,MAAM,CAAA;IACvB,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,OAAO,EAAE,UAAU,CAAA;IACnB,gBAAgB,EAAE,OAAO,GAAG,SAAS,CAAA;CACtC,CAAA;AAQD,wBAAsB,mBAAmB,CAAC,EACxC,SAAS,EACT,MAAM,EACN,UAAe,EACf,OAAO,EACP,gBAAgB,GACjB,EAAE,wBAAwB,GAAG,OAAO,CAAC,iBAAiB,GAAG,IAAI,CAAC,CAknB9D"}
+{"version":3,"file":"extractToClassNames.d.ts","sourceRoot":"","sources":["../../src/extractor/extractToClassNames.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,CAAC,MAAM,cAAc,CAAA;AAKjC,OAAO,KAAK,EAAe,UAAU,EAAW,MAAM,UAAU,CAAA;AAGhE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAA;AAYlD,MAAM,MAAM,iBAAiB,GAAG;IAC9B,EAAE,EAAE,MAAM,GAAG,MAAM,CAAA;IACnB,MAAM,EAAE,MAAM,CAAA;IACd,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,GAAG,EAAE,CAAC,CAAC,IAAI,CAAA;IACX,GAAG,EAAE,GAAG,CAAA;IACR,KAAK,EAAE;QACL,MAAM,EAAE,MAAM,CAAA;QACd,SAAS,EAAE,MAAM,CAAA;QACjB,SAAS,EAAE,MAAM,CAAA;QACjB,KAAK,EAAE,MAAM,CAAA;KACd,CAAA;CACF,CAAA;AAED,MAAM,MAAM,wBAAwB,GAAG;IACrC,SAAS,EAAE,SAAS,CAAA;IACpB,MAAM,EAAE,MAAM,GAAG,MAAM,CAAA;IACvB,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,OAAO,EAAE,UAAU,CAAA;IACnB,gBAAgB,EAAE,OAAO,GAAG,SAAS,CAAA;CACtC,CAAA;AAQD,wBAAsB,mBAAmB,CAAC,EACxC,SAAS,EACT,MAAM,EACN,UAAe,EACf,OAAO,EACP,gBAAgB,GACjB,EAAE,wBAAwB,GAAG,OAAO,CAAC,iBAAiB,GAAG,IAAI,CAAC,CAknB9D"}

package/types/extractor/extractablePath.d.ts

@@ -0,0 +1,45 @@
+/**
+ * One place decides which files the compiler may read styles out of.
+ *
+ * The compiler used to answer this with `sourcePath.includes('node_modules')`,
+ * in two places that had to agree by hand — the webpack loader and
+ * extractToClassNames. That answer was right about the cost and wrong about
+ * the design system: for a *consumer*, `@hanzo/ui` and every `@hanzogui/*`
+ * package IS node_modules, so no app could ask the compiler to look at them
+ * even if it wanted to.
+ *
+ * So this is a policy with a knob, not a hardcoded skip. The knob is
+ * `extractPackages`, and it is EMPTY by default, which is exactly the old
+ * behavior. What turning it on buys, measured on hanzo.one (Vite 5, @hanzo/ui
+ * 8.0.63 on @hanzo/gui 8.1, 5026 modules):
+ *
+ *   extracted files            4 -> 54
+ *   cached sheet         150,172 -> 151,151 B   (+979)
+ *   CSS injected at runtime  27,376 -> 27,376 B (unchanged, 356 rules both)
+ *
+ * Every one of those 979 bytes is a `styled()` DEFINITION rule, and the
+ * compiler deliberately leaves the definition in place ("the runtime needs
+ * real values for animations, context, and group styles"), so the runtime
+ * mints the same class again. 10 of the 20 new rules are delivered twice on
+ * the home route; the rest are for components that route never renders. The
+ * saving that would justify the cost — flattening a `<YStack p={10}>` usage
+ * site down to a className — cannot happen inside an installed package at all,
+ * because `module:jsx` currently emits the same JSX-lowered output as the ESM
+ * build (byte-identical, hardlinked), so there is no JSX left to flatten.
+ *
+ * Fix that, and turning this on becomes a real win. Until then, an app can opt
+ * in with `extractPackages: DEFAULT_EXTRACT_PACKAGES` and get a slightly
+ * bigger sheet for its trouble.
+ */
+/** The design-system allowlist an app can opt into. Not the default. */
+export declare const DEFAULT_EXTRACT_PACKAGES: string[];
+/**
+ * The installed package a file belongs to, or '' when the file is app or
+ * workspace source. Reads the LAST `node_modules/` segment, so a nested
+ * install and pnpm's `.pnpm/<pkg>@<ver>/node_modules/<pkg>` both name the
+ * package that actually owns the file.
+ */
+export declare function installedPackageOf(sourcePath: string): string;
+/** May the compiler read styles out of this file? */
+export declare function isExtractable(sourcePath: string, extractPackages?: string[]): boolean;
+//# sourceMappingURL=extractablePath.d.ts.map

package/types/extractor/extractablePath.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"extractablePath.d.ts","sourceRoot":"","sources":["../../src/extractor/extractablePath.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AAEH,wEAAwE;AACxE,eAAO,MAAM,wBAAwB,UAA6C,CAAA;AAclF;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,CAQ7D;AAeD,qDAAqD;AACrD,wBAAgB,aAAa,CAC3B,UAAU,EAAE,MAAM,EAClB,eAAe,GAAE,MAAM,EAAO,GAC7B,OAAO,CAKT"}