@fluixi/compiler 1.0.0-alpha.91 → 1.0.0-alpha.92

package/dist/integrations.cjs

@@ -1,4 +1,4 @@
-/*! @fluixi/compiler v1.0.0-alpha.91 | (c) 2026 Ibrahima Touré and Fluixi contributors | MIT */
+/*! @fluixi/compiler v1.0.0-alpha.92 | (c) 2026 Ibrahima Touré and Fluixi contributors | MIT */
 "use strict";
 var __create = Object.create;
 var __defProp = Object.defineProperty;
@@ -165,7 +165,9 @@ var init_intrinsics = __esm({
       // does. `untrack` suppresses dependency collection, which is exactly the kind of thing
       // dependency analysis must not guess at.
       $untrack: { export: "untrack", module: REACTIVE_MODULE, returns: "plain" },
-      $untrackStore: { export: "untrackStore", module: "@fluixi/reactive/store", returns: "plain" }
+      $untrackStore: { export: "untrackStore", module: "@fluixi/reactive/store", returns: "plain" },
+      // An environment variable, public or server-only; the browser build refuses a secret.
+      $env: { export: "env", module: "@fluixi/start/env", returns: "plain" }
     };
     RUNTIME_PRIMITIVES = {
       signal: "signal-handle",
@@ -3171,10 +3173,34 @@ function collectIntrinsicEdits(program) {
   });
   return { edits, diagnostics, imports };
 }
+function avoidBindingClashes(program, result, bound) {
+  const importedAsIs = /* @__PURE__ */ new Set();
+  for (const stmt of program.body ?? []) {
+    if (stmt.type !== "ImportDeclaration") continue;
+    const module2 = stmt.source.value;
+    for (const spec of stmt.specifiers ?? []) {
+      if (spec.type !== "ImportSpecifier") continue;
+      const imported = spec.imported.name ?? spec.imported.value;
+      if (imported === spec.local.name && result.imports.get(module2)?.has(imported)) {
+        importedAsIs.add(imported);
+      }
+    }
+  }
+  const aliases = /* @__PURE__ */ new Map();
+  for (const names of result.imports.values()) {
+    for (const name of names) if (bound.has(name) && !importedAsIs.has(name)) aliases.set(name, `__fx_${name}`);
+  }
+  if (!aliases.size) return;
+  for (const edit of result.edits) {
+    const alias = aliases.get(edit.code);
+    if (alias) edit.code = alias;
+  }
+  result.aliases = aliases;
+}
 function intrinsicImports(result, bound) {
   const lines = [];
   for (const [module2, names] of [...result.imports].sort(([a], [b]) => a.localeCompare(b))) {
-    const wanted = [...names].filter((name) => !bound.has(name)).sort();
+    const wanted = [...names].filter((name) => result.aliases?.has(name) || !bound.has(name)).sort().map((name) => result.aliases?.has(name) ? `${name} as ${result.aliases.get(name)}` : name);
     if (wanted.length) lines.push(`import { ${wanted.join(", ")} } from ${JSON.stringify(module2)};`);
   }
   return lines.length ? `${lines.join("\n")}
@@ -3367,6 +3393,7 @@ function transformTemplates(code, id, options = {}) {
   });
   const props = options.propsDestructure === false ? { edits: [], diagnostics: [], used: /* @__PURE__ */ new Set() } : collectPropsEdits(ast.program, code, { runtimeModule: options.runtimeModule });
   const intrinsics = options.intrinsics === false ? { edits: [], diagnostics: [], imports: /* @__PURE__ */ new Map() } : collectIntrinsicEdits(ast.program);
+  if (intrinsics.edits.length) avoidBindingClashes(ast.program, intrinsics, moduleBindings(ast.program));
   const sources = options.sourceLocations === true ? collectSourceEdits(ast.program, sourceName) : { edits: [], marked: 0 };
   const silent = found.length === 0 && props.edits.length === 0 && sources.edits.length === 0 && intrinsics.edits.length === 0 && intrinsics.diagnostics.length === 0 && props.diagnostics.length === 0;
   if (silent) return null;
@@ -3839,7 +3866,8 @@ function componentGlobals(rules, options = {}) {
     builtins = true,
     intrinsics = true,
     generator = "@fluixi/compiler",
-    specifier = (module2) => module2
+    specifier = (module2) => module2,
+    candidates = []
   } = options;
   const all = [...rules];
   if (builtins) {
@@ -3851,7 +3879,8 @@ function componentGlobals(rules, options = {}) {
   const shadowedByDom = [];
   const unavailable = [];
   const resolved = /* @__PURE__ */ new Map();
-  for (const name of [...resolver.names()].sort()) {
+  const names = /* @__PURE__ */ new Set([...resolver.names(), ...[...candidates].filter((n) => /^[A-Za-z_$][\w$]*$/.test(n))]);
+  for (const name of [...names].sort()) {
     const target = resolver.resolve(name);
     if (!target) continue;
     const pkg = packageOf(target.module);
@@ -3862,7 +3891,11 @@ function componentGlobals(rules, options = {}) {
       resolved.set(name, target);
     }
   }
-  const intrinsicModules = intrinsics ? [...new Set(Object.values(INTRINSICS).map((i) => i.module))] : [];
+  const usableIntrinsics = intrinsics ? Object.entries(INTRINSICS).filter(([, i]) => {
+    const pkg = packageOf(i.module);
+    return !available || !pkg || available.has(pkg);
+  }) : [];
+  const intrinsicModules = [...new Set(usableIntrinsics.map(([, i]) => i.module))];
   const modules = [
     .../* @__PURE__ */ new Set([...declared2.map((name) => resolved.get(name).module), ...intrinsicModules])
   ].sort();
@@ -3882,15 +3915,18 @@ function componentGlobals(rules, options = {}) {
     return `//   import { ${n} } from '${module2 ? specifier(module2) : ""}';
 `;
   }).join("") : "";
-  const intrinsicLines = intrinsics ? Object.entries(INTRINSICS).map(
+  const intrinsicLines = usableIntrinsics.map(
     ([name, intrinsic]) => `  const ${name}: typeof ${namespaceAlias(intrinsic.module)}.${intrinsic.export};`
-  ) : [];
+  );
   const patternRules = rules.filter((rule) => "match" in rule).length;
-  const patternNote = patternRules > 0 ? `//
+  const patternNote = patternRules === 0 ? "" : options.candidates ? `//
+// ${patternRules} pattern rule${patternRules === 1 ? "" : "s"}: declared for the files the module path
+// points at. A name with no such file still resolves at build time; declare it by hand.
+` : `//
 // ${patternRules} pattern rule${patternRules === 1 ? "" : "s"} cannot be declared:
 // a pattern matches unboundedly many names, so there is no list to emit. Those
 // tags still resolve at build time; declare them by hand if the editor needs them.
-` : "";
+`;
   const source = `// GENERATED by ${generator}, do not edit.
 //
 // The components \`resolve\` supplies without an import. This describes what the
@@ -3947,6 +3983,30 @@ function projectDependencies(root) {
     return void 0;
   }
 }
+function patternCandidates(rules, root) {
+  const out = [];
+  for (const rule of rules) {
+    if (!("match" in rule) || !rule.module.startsWith("/")) continue;
+    const dir = (0, import_node_path.dirname)(rule.module);
+    const file = (0, import_node_path.basename)(rule.module);
+    const group = file.match(/\$\d+/);
+    if (dir.includes("$") || !group || file.indexOf("$", group.index + 1) !== -1) continue;
+    const before = file.slice(0, group.index);
+    const after = file.slice(group.index + group[0].length);
+    let entries;
+    try {
+      entries = (0, import_node_fs.readdirSync)((0, import_node_path.resolve)(root, dir.slice(1)));
+    } catch {
+      continue;
+    }
+    for (const entry of entries) {
+      if (entry.length > before.length + after.length && entry.startsWith(before) && entry.endsWith(after)) {
+        out.push(entry.slice(before.length, entry.length - after.length));
+      }
+    }
+  }
+  return out;
+}
 function writeComponentGlobals(options, root) {
   if (options.globals === false) return { status: "skipped", reason: "disabled" };
   const rules = options.resolve ?? [];
@@ -3962,6 +4022,7 @@ function writeComponentGlobals(options, root) {
   }
   const { source, declared: declared2 } = componentGlobals(rules, {
     available: projectDependencies(root),
+    candidates: patternCandidates(rules, root),
     specifier: (module2) => forTypeScript(module2, (0, import_node_path.dirname)(target), root)
   });
   if (existing === source) {

package/dist/integrations.mjs

@@ -1,16 +1,16 @@
-/*! @fluixi/compiler v1.0.0-alpha.91 | (c) 2026 Ibrahima Touré and Fluixi contributors | MIT */
+/*! @fluixi/compiler v1.0.0-alpha.92 | (c) 2026 Ibrahima Touré and Fluixi contributors | MIT */
 import {
   INTRINSICS,
   builtinComponentMap,
   createComponentResolver
-} from "./chunk-S4J4OCWK.mjs";
+} from "./chunk-XJ5H2MXY.mjs";
 import {
   __require
-} from "./chunk-QX6Y3OAR.mjs";
+} from "./chunk-VOUI6XPV.mjs";
 
 // src/resolve/write-globals.ts
-import { mkdirSync, readFileSync, writeFileSync } from "node:fs";
-import { dirname, relative, sep, resolve as resolvePath } from "node:path";
+import { mkdirSync, readdirSync, readFileSync, writeFileSync } from "node:fs";
+import { basename, dirname, relative, sep, resolve as resolvePath } from "node:path";
 
 // src/resolve/component-globals.ts
 var DOM_GLOBALS = /* @__PURE__ */ new Set([
@@ -50,7 +50,8 @@ function componentGlobals(rules, options = {}) {
     builtins = true,
     intrinsics = true,
     generator = "@fluixi/compiler",
-    specifier = (module) => module
+    specifier = (module) => module,
+    candidates = []
   } = options;
   const all = [...rules];
   if (builtins) {
@@ -62,7 +63,8 @@ function componentGlobals(rules, options = {}) {
   const shadowedByDom = [];
   const unavailable = [];
   const resolved = /* @__PURE__ */ new Map();
-  for (const name of [...resolver.names()].sort()) {
+  const names = /* @__PURE__ */ new Set([...resolver.names(), ...[...candidates].filter((n) => /^[A-Za-z_$][\w$]*$/.test(n))]);
+  for (const name of [...names].sort()) {
     const target = resolver.resolve(name);
     if (!target) continue;
     const pkg = packageOf(target.module);
@@ -73,7 +75,11 @@ function componentGlobals(rules, options = {}) {
       resolved.set(name, target);
     }
   }
-  const intrinsicModules = intrinsics ? [...new Set(Object.values(INTRINSICS).map((i) => i.module))] : [];
+  const usableIntrinsics = intrinsics ? Object.entries(INTRINSICS).filter(([, i]) => {
+    const pkg = packageOf(i.module);
+    return !available || !pkg || available.has(pkg);
+  }) : [];
+  const intrinsicModules = [...new Set(usableIntrinsics.map(([, i]) => i.module))];
   const modules = [
     .../* @__PURE__ */ new Set([...declared.map((name) => resolved.get(name).module), ...intrinsicModules])
   ].sort();
@@ -93,15 +99,18 @@ function componentGlobals(rules, options = {}) {
     return `//   import { ${n} } from '${module ? specifier(module) : ""}';
 `;
   }).join("") : "";
-  const intrinsicLines = intrinsics ? Object.entries(INTRINSICS).map(
+  const intrinsicLines = usableIntrinsics.map(
     ([name, intrinsic]) => `  const ${name}: typeof ${namespaceAlias(intrinsic.module)}.${intrinsic.export};`
-  ) : [];
+  );
   const patternRules = rules.filter((rule) => "match" in rule).length;
-  const patternNote = patternRules > 0 ? `//
+  const patternNote = patternRules === 0 ? "" : options.candidates ? `//
+// ${patternRules} pattern rule${patternRules === 1 ? "" : "s"}: declared for the files the module path
+// points at. A name with no such file still resolves at build time; declare it by hand.
+` : `//
 // ${patternRules} pattern rule${patternRules === 1 ? "" : "s"} cannot be declared:
 // a pattern matches unboundedly many names, so there is no list to emit. Those
 // tags still resolve at build time; declare them by hand if the editor needs them.
-` : "";
+`;
   const source = `// GENERATED by ${generator}, do not edit.
 //
 // The components \`resolve\` supplies without an import. This describes what the
@@ -158,6 +167,30 @@ function projectDependencies(root) {
     return void 0;
   }
 }
+function patternCandidates(rules, root) {
+  const out = [];
+  for (const rule of rules) {
+    if (!("match" in rule) || !rule.module.startsWith("/")) continue;
+    const dir = dirname(rule.module);
+    const file = basename(rule.module);
+    const group = file.match(/\$\d+/);
+    if (dir.includes("$") || !group || file.indexOf("$", group.index + 1) !== -1) continue;
+    const before = file.slice(0, group.index);
+    const after = file.slice(group.index + group[0].length);
+    let entries;
+    try {
+      entries = readdirSync(resolvePath(root, dir.slice(1)));
+    } catch {
+      continue;
+    }
+    for (const entry of entries) {
+      if (entry.length > before.length + after.length && entry.startsWith(before) && entry.endsWith(after)) {
+        out.push(entry.slice(before.length, entry.length - after.length));
+      }
+    }
+  }
+  return out;
+}
 function writeComponentGlobals(options, root) {
   if (options.globals === false) return { status: "skipped", reason: "disabled" };
   const rules = options.resolve ?? [];
@@ -173,6 +206,7 @@ function writeComponentGlobals(options, root) {
   }
   const { source, declared } = componentGlobals(rules, {
     available: projectDependencies(root),
+    candidates: patternCandidates(rules, root),
     specifier: (module) => forTypeScript(module, dirname(target), root)
   });
   if (existing === source) {
@@ -199,12 +233,12 @@ function warnIfUnreachable(root, target) {
 }
 
 // src/integrations.ts
-import { readdirSync, readFileSync as readFileSync2 } from "node:fs";
+import { readdirSync as readdirSync2, readFileSync as readFileSync2 } from "node:fs";
 import { join as _join } from "node:path";
 async function createBabelPlugin(options = {}) {
   let pluginModule = null;
   try {
-    pluginModule = await import("./babel-VBLQRHQ2.mjs");
+    pluginModule = await import("./babel-GI375YZ2.mjs");
   } catch (e) {
     console.warn("Could not load the babel front-end:", e);
   }
@@ -375,7 +409,7 @@ function transformOptions(options, id) {
 }
 async function rewriteProps(code, id, options) {
   if (options.propsDestructure === false) return code;
-  const { transformProps } = await import("./transform-D536WXGM.mjs");
+  const { transformProps } = await import("./transform-UWZ7ZGJ2.mjs");
   const result = transformProps(code, id);
   reportDiagnostics({ propsDiagnostics: result.diagnostics }, id);
   return result.rewritten > 0 ? result.code : code;
@@ -398,7 +432,7 @@ function reportDiagnostics(result, id) {
 }
 async function compileModule(code, id, options) {
   if (!options.babel) {
-    const { transformTemplates } = await import("./transform-D536WXGM.mjs");
+    const { transformTemplates } = await import("./transform-UWZ7ZGJ2.mjs");
     const result2 = transformTemplates(code, id, transformOptions(options, id));
     reportDiagnostics(result2, id);
     return result2;
@@ -473,7 +507,7 @@ function hasServerDirective(source) {
 function findServerFnModules(dir, out = []) {
   let entries;
   try {
-    entries = readdirSync(dir, { withFileTypes: true });
+    entries = readdirSync2(dir, { withFileTypes: true });
   } catch {
     return out;
   }
@@ -517,10 +551,10 @@ export { isServerFnRequest, handleServerFn } from '@fluixi/start/server-fn';
       if (!code.includes("use server")) return null;
       const args = { ssr: !!opts?.ssr, filename: id, root };
       if (options.babel) {
-        const { transformServerFunctions } = await import("./server-functions-7PUFLRGF.mjs");
+        const { transformServerFunctions } = await import("./server-functions-VEGLIFCE.mjs");
         return transformServerFunctions(code, args);
       }
-      const { transformServerFns } = await import("./server-fns-J56G3PFP.mjs");
+      const { transformServerFns } = await import("./server-fns-BBZRZUPP.mjs");
       return transformServerFns(code, args);
     }
   };

package/dist/lower/compile-template.cjs

@@ -1,4 +1,4 @@
-/*! @fluixi/compiler v1.0.0-alpha.91 | (c) 2026 Ibrahima Touré and Fluixi contributors | MIT */
+/*! @fluixi/compiler v1.0.0-alpha.92 | (c) 2026 Ibrahima Touré and Fluixi contributors | MIT */
 "use strict";
 var __defProp = Object.defineProperty;
 var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
@@ -477,7 +477,9 @@ var INTRINSICS = {
   // does. `untrack` suppresses dependency collection, which is exactly the kind of thing
   // dependency analysis must not guess at.
   $untrack: { export: "untrack", module: REACTIVE_MODULE, returns: "plain" },
-  $untrackStore: { export: "untrackStore", module: "@fluixi/reactive/store", returns: "plain" }
+  $untrackStore: { export: "untrackStore", module: "@fluixi/reactive/store", returns: "plain" },
+  // An environment variable, public or server-only; the browser build refuses a secret.
+  $env: { export: "env", module: "@fluixi/start/env", returns: "plain" }
 };
 var INTRINSIC_CALL = new RegExp(`\\$(?:${Object.keys(INTRINSICS).map((n) => n.slice(1)).join("|")})\\s*\\(`);
 

package/dist/lower/compile-template.mjs

@@ -1,4 +1,4 @@
-/*! @fluixi/compiler v1.0.0-alpha.91 | (c) 2026 Ibrahima Touré and Fluixi contributors | MIT */
+/*! @fluixi/compiler v1.0.0-alpha.92 | (c) 2026 Ibrahima Touré and Fluixi contributors | MIT */
 
 // src/optimize/analyze-static.ts
 function propReason(prop) {
@@ -451,7 +451,9 @@ var INTRINSICS = {
   // does. `untrack` suppresses dependency collection, which is exactly the kind of thing
   // dependency analysis must not guess at.
   $untrack: { export: "untrack", module: REACTIVE_MODULE, returns: "plain" },
-  $untrackStore: { export: "untrackStore", module: "@fluixi/reactive/store", returns: "plain" }
+  $untrackStore: { export: "untrackStore", module: "@fluixi/reactive/store", returns: "plain" },
+  // An environment variable, public or server-only; the browser build refuses a secret.
+  $env: { export: "env", module: "@fluixi/start/env", returns: "plain" }
 };
 var INTRINSIC_CALL = new RegExp(`\\$(?:${Object.keys(INTRINSICS).map((n) => n.slice(1)).join("|")})\\s*\\(`);
 

package/dist/lower/template.cjs

@@ -292,7 +292,9 @@ var INTRINSICS = {
   // does. `untrack` suppresses dependency collection, which is exactly the kind of thing
   // dependency analysis must not guess at.
   $untrack: { export: "untrack", module: REACTIVE_MODULE, returns: "plain" },
-  $untrackStore: { export: "untrackStore", module: "@fluixi/reactive/store", returns: "plain" }
+  $untrackStore: { export: "untrackStore", module: "@fluixi/reactive/store", returns: "plain" },
+  // An environment variable, public or server-only; the browser build refuses a secret.
+  $env: { export: "env", module: "@fluixi/start/env", returns: "plain" }
 };
 var INTRINSIC_CALL = new RegExp(`\\$(?:${Object.keys(INTRINSICS).map((n) => n.slice(1)).join("|")})\\s*\\(`);
 

package/dist/lower/template.mjs

@@ -270,7 +270,9 @@ var INTRINSICS = {
   // does. `untrack` suppresses dependency collection, which is exactly the kind of thing
   // dependency analysis must not guess at.
   $untrack: { export: "untrack", module: REACTIVE_MODULE, returns: "plain" },
-  $untrackStore: { export: "untrackStore", module: "@fluixi/reactive/store", returns: "plain" }
+  $untrackStore: { export: "untrackStore", module: "@fluixi/reactive/store", returns: "plain" },
+  // An environment variable, public or server-only; the browser build refuses a secret.
+  $env: { export: "env", module: "@fluixi/start/env", returns: "plain" }
 };
 var INTRINSIC_CALL = new RegExp(`\\$(?:${Object.keys(INTRINSICS).map((n) => n.slice(1)).join("|")})\\s*\\(`);
 

package/dist/resolve/builtins.cjs

@@ -1,4 +1,4 @@
-/*! @fluixi/compiler v1.0.0-alpha.91 | (c) 2026 Ibrahima Touré and Fluixi contributors | MIT */
+/*! @fluixi/compiler v1.0.0-alpha.92 | (c) 2026 Ibrahima Touré and Fluixi contributors | MIT */
 "use strict";
 var __defProp = Object.defineProperty;
 var __getOwnPropDesc = Object.getOwnPropertyDescriptor;

package/dist/resolve/builtins.mjs

@@ -1,4 +1,4 @@
-/*! @fluixi/compiler v1.0.0-alpha.91 | (c) 2026 Ibrahima Touré and Fluixi contributors | MIT */
+/*! @fluixi/compiler v1.0.0-alpha.92 | (c) 2026 Ibrahima Touré and Fluixi contributors | MIT */
 
 // src/resolve/builtins.ts
 var DOM_CONTROL_FLOW = [

package/dist/resolve/component-globals.cjs

@@ -133,7 +133,9 @@ var INTRINSICS = {
   // does. `untrack` suppresses dependency collection, which is exactly the kind of thing
   // dependency analysis must not guess at.
   $untrack: { export: "untrack", module: REACTIVE_MODULE, returns: "plain" },
-  $untrackStore: { export: "untrackStore", module: "@fluixi/reactive/store", returns: "plain" }
+  $untrackStore: { export: "untrackStore", module: "@fluixi/reactive/store", returns: "plain" },
+  // An environment variable, public or server-only; the browser build refuses a secret.
+  $env: { export: "env", module: "@fluixi/start/env", returns: "plain" }
 };
 var INTRINSIC_CALL = new RegExp(`\\$(?:${Object.keys(INTRINSICS).map((n) => n.slice(1)).join("|")})\\s*\\(`);
 
@@ -175,7 +177,8 @@ function componentGlobals(rules, options = {}) {
     builtins = true,
     intrinsics = true,
     generator = "@fluixi/compiler",
-    specifier = (module2) => module2
+    specifier = (module2) => module2,
+    candidates = []
   } = options;
   const all = [...rules];
   if (builtins) {
@@ -187,7 +190,8 @@ function componentGlobals(rules, options = {}) {
   const shadowedByDom = [];
   const unavailable = [];
   const resolved = /* @__PURE__ */ new Map();
-  for (const name of [...resolver.names()].sort()) {
+  const names = /* @__PURE__ */ new Set([...resolver.names(), ...[...candidates].filter((n) => /^[A-Za-z_$][\w$]*$/.test(n))]);
+  for (const name of [...names].sort()) {
     const target = resolver.resolve(name);
     if (!target) continue;
     const pkg = packageOf(target.module);
@@ -198,7 +202,11 @@ function componentGlobals(rules, options = {}) {
       resolved.set(name, target);
     }
   }
-  const intrinsicModules = intrinsics ? [...new Set(Object.values(INTRINSICS).map((i) => i.module))] : [];
+  const usableIntrinsics = intrinsics ? Object.entries(INTRINSICS).filter(([, i]) => {
+    const pkg = packageOf(i.module);
+    return !available || !pkg || available.has(pkg);
+  }) : [];
+  const intrinsicModules = [...new Set(usableIntrinsics.map(([, i]) => i.module))];
   const modules = [
     .../* @__PURE__ */ new Set([...declared.map((name) => resolved.get(name).module), ...intrinsicModules])
   ].sort();
@@ -218,15 +226,18 @@ function componentGlobals(rules, options = {}) {
     return `//   import { ${n} } from '${module2 ? specifier(module2) : ""}';
 `;
   }).join("") : "";
-  const intrinsicLines = intrinsics ? Object.entries(INTRINSICS).map(
+  const intrinsicLines = usableIntrinsics.map(
     ([name, intrinsic]) => `  const ${name}: typeof ${namespaceAlias(intrinsic.module)}.${intrinsic.export};`
-  ) : [];
+  );
   const patternRules = rules.filter((rule) => "match" in rule).length;
-  const patternNote = patternRules > 0 ? `//
+  const patternNote = patternRules === 0 ? "" : options.candidates ? `//
+// ${patternRules} pattern rule${patternRules === 1 ? "" : "s"}: declared for the files the module path
+// points at. A name with no such file still resolves at build time; declare it by hand.
+` : `//
 // ${patternRules} pattern rule${patternRules === 1 ? "" : "s"} cannot be declared:
 // a pattern matches unboundedly many names, so there is no list to emit. Those
 // tags still resolve at build time; declare them by hand if the editor needs them.
-` : "";
+`;
   const source = `// GENERATED by ${generator}, do not edit.
 //
 // The components \`resolve\` supplies without an import. This describes what the

package/dist/resolve/component-globals.d.cts

@@ -46,6 +46,14 @@ export interface ComponentGlobalsOptions {
      * "Cannot find name '$signal'" for code that builds correctly.
      */
     intrinsics?: boolean;
+    /**
+     * Names to try against the pattern rules.
+     *
+     * A pattern has no name list of its own, but the files it points at do: the caller lists
+     * them (the generator stays off the filesystem) and each name the resolver answers is
+     * declared like any other.
+     */
+    candidates?: Iterable<string>;
     /** Attribution written into the header. */
     generator?: string;
     /**

package/dist/resolve/component-globals.d.ts

@@ -46,6 +46,14 @@ export interface ComponentGlobalsOptions {
      * "Cannot find name '$signal'" for code that builds correctly.
      */
     intrinsics?: boolean;
+    /**
+     * Names to try against the pattern rules.
+     *
+     * A pattern has no name list of its own, but the files it points at do: the caller lists
+     * them (the generator stays off the filesystem) and each name the resolver answers is
+     * declared like any other.
+     */
+    candidates?: Iterable<string>;
     /** Attribution written into the header. */
     generator?: string;
     /**

package/dist/resolve/component-globals.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"component-globals.d.ts","sourceRoot":"","sources":["../../src/resolve/component-globals.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AACH,OAAO,EAEL,KAAK,qBAAqB,EAE3B,MAAM,yBAAyB,CAAC;AAmCjC,MAAM,WAAW,uBAAuB;IACtC;;;;;;;;;;OAUG;IACH,SAAS,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,CAAC;IAC7B;;;;;;OAMG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB;;;;;;OAMG;IACH,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,2CAA2C;IAC3C,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;;;;;;;OAOG;IACH,SAAS,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,MAAM,CAAC;CACxC;AAED,MAAM,WAAW,sBAAsB;IACrC,mCAAmC;IACnC,MAAM,EAAE,MAAM,CAAC;IACf,2BAA2B;IAC3B,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,0DAA0D;IAC1D,aAAa,EAAE,MAAM,EAAE,CAAC;IACxB,qEAAqE;IACrE,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB;;;;;;OAMG;IACH,YAAY,EAAE,MAAM,CAAC;CACtB;AAgBD,0FAA0F;AAC1F,wBAAgB,gBAAgB,CAC9B,KAAK,EAAE,SAAS,qBAAqB,EAAE,EACvC,OAAO,GAAE,uBAA4B,GACpC,sBAAsB,CA2GxB"}
+{"version":3,"file":"component-globals.d.ts","sourceRoot":"","sources":["../../src/resolve/component-globals.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AACH,OAAO,EAEL,KAAK,qBAAqB,EAE3B,MAAM,yBAAyB,CAAC;AAmCjC,MAAM,WAAW,uBAAuB;IACtC;;;;;;;;;;OAUG;IACH,SAAS,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,CAAC;IAC7B;;;;;;OAMG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB;;;;;;OAMG;IACH,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB;;;;;;OAMG;IACH,UAAU,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,CAAC;IAC9B,2CAA2C;IAC3C,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;;;;;;;OAOG;IACH,SAAS,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,MAAM,CAAC;CACxC;AAED,MAAM,WAAW,sBAAsB;IACrC,mCAAmC;IACnC,MAAM,EAAE,MAAM,CAAC;IACf,2BAA2B;IAC3B,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,0DAA0D;IAC1D,aAAa,EAAE,MAAM,EAAE,CAAC;IACxB,qEAAqE;IACrE,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB;;;;;;OAMG;IACH,YAAY,EAAE,MAAM,CAAC;CACtB;AAgBD,0FAA0F;AAC1F,wBAAgB,gBAAgB,CAC9B,KAAK,EAAE,SAAS,qBAAqB,EAAE,EACvC,OAAO,GAAE,uBAA4B,GACpC,sBAAsB,CAoHxB"}

package/dist/resolve/component-globals.js

@@ -65,7 +65,7 @@ function namespaceAlias(module) {
 }
 /** Build the ambient `.d.ts` for the components a project's `resolve` config supplies. */
 export function componentGlobals(rules, options = {}) {
-    const { available: availableList, builtins = true, intrinsics = true, generator = '@fluixi/compiler', specifier = (module) => module, } = options;
+    const { available: availableList, builtins = true, intrinsics = true, generator = '@fluixi/compiler', specifier = (module) => module, candidates = [], } = options;
     const all = [...rules];
     if (builtins) {
         // Appended, so an explicit rule for the same name still wins, the resolver is
@@ -78,9 +78,9 @@ export function componentGlobals(rules, options = {}) {
     const shadowedByDom = [];
     const unavailable = [];
     const resolved = new Map();
-    for (const name of [...resolver.names()].sort()) {
+    const names = new Set([...resolver.names(), ...[...candidates].filter((n) => /^[A-Za-z_$][\w$]*$/.test(n))]);
+    for (const name of [...names].sort()) {
         const target = resolver.resolve(name);
-        /* c8 ignore next */
         if (!target)
             continue;
         const pkg = packageOf(target.module);
@@ -97,7 +97,15 @@ export function componentGlobals(rules, options = {}) {
     // '$signal'" for code that compiles. tsc doesn't load language-service plugins, so an
     // ambient declaration is the only thing that answers for both the editor and the
     // command line.
-    const intrinsicModules = intrinsics ? [...new Set(Object.values(INTRINSICS).map((i) => i.module))] : [];
+    // Only the intrinsics whose package the project has: `$env` comes from `@fluixi/start`, and
+    // an app without it would otherwise get a declaration that fails to resolve.
+    const usableIntrinsics = intrinsics
+        ? Object.entries(INTRINSICS).filter(([, i]) => {
+            const pkg = packageOf(i.module);
+            return !available || !pkg || available.has(pkg);
+        })
+        : [];
+    const intrinsicModules = [...new Set(usableIntrinsics.map(([, i]) => i.module))];
     const modules = [
         ...new Set([...declared.map((name) => resolved.get(name).module), ...intrinsicModules]),
     ].sort();
@@ -130,15 +138,16 @@ export function componentGlobals(rules, options = {}) {
     // `typeof ns.signal` rather than an alias: the intrinsic is a global that stands for
     // the runtime call, so it takes the runtime's signature without claiming to be that
     // symbol: go-to-definition on `$signal` should land on what it compiles to.
-    const intrinsicLines = intrinsics
-        ? Object.entries(INTRINSICS).map(([name, intrinsic]) => `  const ${name}: typeof ${namespaceAlias(intrinsic.module)}.${intrinsic.export};`)
-        : [];
+    const intrinsicLines = usableIntrinsics.map(([name, intrinsic]) => `  const ${name}: typeof ${namespaceAlias(intrinsic.module)}.${intrinsic.export};`);
     const patternRules = rules.filter((rule) => 'match' in rule).length;
-    const patternNote = patternRules > 0
-        ? `//\n// ${patternRules} pattern rule${patternRules === 1 ? '' : 's'} cannot be declared:\n` +
-            `// a pattern matches unboundedly many names, so there is no list to emit. Those\n` +
-            `// tags still resolve at build time; declare them by hand if the editor needs them.\n`
-        : '';
+    const patternNote = patternRules === 0
+        ? ''
+        : options.candidates
+            ? `//\n// ${patternRules} pattern rule${patternRules === 1 ? '' : 's'}: declared for the files the module path\n` +
+                `// points at. A name with no such file still resolves at build time; declare it by hand.\n`
+            : `//\n// ${patternRules} pattern rule${patternRules === 1 ? '' : 's'} cannot be declared:\n` +
+                `// a pattern matches unboundedly many names, so there is no list to emit. Those\n` +
+                `// tags still resolve at build time; declare them by hand if the editor needs them.\n`;
     const source = `// GENERATED by ${generator}, do not edit.\n` +
         `//\n` +
         `// The components \`resolve\` supplies without an import. This describes what the\n` +

package/dist/resolve/component-globals.mjs

@@ -107,7 +107,9 @@ var INTRINSICS = {
   // does. `untrack` suppresses dependency collection, which is exactly the kind of thing
   // dependency analysis must not guess at.
   $untrack: { export: "untrack", module: REACTIVE_MODULE, returns: "plain" },
-  $untrackStore: { export: "untrackStore", module: "@fluixi/reactive/store", returns: "plain" }
+  $untrackStore: { export: "untrackStore", module: "@fluixi/reactive/store", returns: "plain" },
+  // An environment variable, public or server-only; the browser build refuses a secret.
+  $env: { export: "env", module: "@fluixi/start/env", returns: "plain" }
 };
 var INTRINSIC_CALL = new RegExp(`\\$(?:${Object.keys(INTRINSICS).map((n) => n.slice(1)).join("|")})\\s*\\(`);
 
@@ -149,7 +151,8 @@ function componentGlobals(rules, options = {}) {
     builtins = true,
     intrinsics = true,
     generator = "@fluixi/compiler",
-    specifier = (module) => module
+    specifier = (module) => module,
+    candidates = []
   } = options;
   const all = [...rules];
   if (builtins) {
@@ -161,7 +164,8 @@ function componentGlobals(rules, options = {}) {
   const shadowedByDom = [];
   const unavailable = [];
   const resolved = /* @__PURE__ */ new Map();
-  for (const name of [...resolver.names()].sort()) {
+  const names = /* @__PURE__ */ new Set([...resolver.names(), ...[...candidates].filter((n) => /^[A-Za-z_$][\w$]*$/.test(n))]);
+  for (const name of [...names].sort()) {
     const target = resolver.resolve(name);
     if (!target) continue;
     const pkg = packageOf(target.module);
@@ -172,7 +176,11 @@ function componentGlobals(rules, options = {}) {
       resolved.set(name, target);
     }
   }
-  const intrinsicModules = intrinsics ? [...new Set(Object.values(INTRINSICS).map((i) => i.module))] : [];
+  const usableIntrinsics = intrinsics ? Object.entries(INTRINSICS).filter(([, i]) => {
+    const pkg = packageOf(i.module);
+    return !available || !pkg || available.has(pkg);
+  }) : [];
+  const intrinsicModules = [...new Set(usableIntrinsics.map(([, i]) => i.module))];
   const modules = [
     .../* @__PURE__ */ new Set([...declared.map((name) => resolved.get(name).module), ...intrinsicModules])
   ].sort();
@@ -192,15 +200,18 @@ function componentGlobals(rules, options = {}) {
     return `//   import { ${n} } from '${module ? specifier(module) : ""}';
 `;
   }).join("") : "";
-  const intrinsicLines = intrinsics ? Object.entries(INTRINSICS).map(
+  const intrinsicLines = usableIntrinsics.map(
     ([name, intrinsic]) => `  const ${name}: typeof ${namespaceAlias(intrinsic.module)}.${intrinsic.export};`
-  ) : [];
+  );
   const patternRules = rules.filter((rule) => "match" in rule).length;
-  const patternNote = patternRules > 0 ? `//
+  const patternNote = patternRules === 0 ? "" : options.candidates ? `//
+// ${patternRules} pattern rule${patternRules === 1 ? "" : "s"}: declared for the files the module path
+// points at. A name with no such file still resolves at build time; declare it by hand.
+` : `//
 // ${patternRules} pattern rule${patternRules === 1 ? "" : "s"} cannot be declared:
 // a pattern matches unboundedly many names, so there is no list to emit. Those
 // tags still resolve at build time; declare them by hand if the editor needs them.
-` : "";
+`;
   const source = `// GENERATED by ${generator}, do not edit.
 //
 // The components \`resolve\` supplies without an import. This describes what the