@stacksjs/stx 0.2.105 → 0.2.106

package/dist/client-script.d.ts

@@ -33,6 +33,11 @@ export declare function extractAndStripCssImports(code: string, options: { fileP
  * below un-layered rules, so vendor styles default to lowest precedence.
  */
 export declare function renderVendorStyleTags(styles: VendorCssImport[]): string;
+/**
+ * Generate destructuring statements for auto-imported symbols
+ * These access globals set up by the STX runtime and @stacksjs/browser
+ */
+export declare function generateAutoImportDestructuring(stxImports: string[], browserImports: string[]): string;
 /**
  * Build the server → client bridge payload from a template context: the
  * top-level, JSON-serializable values (excluding internal `__`/`$` keys and

package/dist/client-script.js

@@ -331,7 +331,7 @@ function transformAutoImports(code) {
     browserImports: Array.from(usedBrowserImports)
   };
 }
-function generateAutoImportDestructuring(stxImports, browserImports) {
+export function generateAutoImportDestructuring(stxImports, browserImports) {
   const lines = [];
   if (stxImports.length > 0)
     lines.push(`  var { ${stxImports.join(", ")} } = window.stx || window;`);
@@ -341,9 +341,27 @@ function generateAutoImportDestructuring(stxImports, browserImports) {
     return `  // STX: auto-imported from stx and @stacksjs/browser
 ${lines.join(`
 `)}
-`;
+${generateAutoImportGuard(stxImports, browserImports)}`;
   return "";
 }
+function generateAutoImportGuard(stxImports, browserImports) {
+  const entries = [
+    ...stxImports.map((name) => `['${name}', typeof ${name}, 'stx']`),
+    ...browserImports.map((name) => `['${name}', typeof ${name}, '@stacksjs/browser']`)
+  ];
+  if (entries.length === 0)
+    return "";
+  return `  // STX: report auto-imports the client runtime did not provide
+  [${entries.join(", ")}].forEach(function (e) {
+    if (e[1] !== 'undefined') return;
+    console.error(
+      '[stx] "' + e[0] + '" is used in this client script and auto-imported from ' + e[2] + ', '
+      + 'but the client runtime does not provide it. Either it is not exported to the browser, '
+      + 'or it should be imported from a relative path so the bundler includes it.'
+    );
+  });
+`;
+}
 export function extractBridgeData(context) {
   const out = {};
   for (const key in context) {