@arcgis/lumina-compiler 4.34.0-next.85 → 4.34.0-next.86

package/dist/index.js

@@ -1,12 +1,12 @@
 import { externalizeDependencies as ls, path as u, toSystemPathSeparators as te, retrievePackageJson as R, fetchPackageLocation as Ue, asyncRetrievePackageJson as ze, existsAsync as _, findPath as ds, toPosixPathSeparators as Fe, isPosix as Ri, getCwd as Mi } from "@arcgis/components-build-utils";
 import ps from "vite-plugin-dts";
 import o from "typescript";
-import { f as S, l as T } from "./logger-KpGU2b3R.js";
+import { f as b, l as T } from "./logger-KpGU2b3R.js";
 import { getMemberName as Q, apiMemberToSynthesizedComments as X, globalPackageIdentifier as Oi, setApiDocFromJsDoc as fe, ApiExtractor as us, hasIgnoredModifier as ms, symbolToDocs as Wt, setDefaultFromInitializer as Bt, multipleJsDocTags as fs, findDecorator as _t, isApiMethod as gs, isApiProperty as ys } from "@arcgis/api-extractor";
 import { isNotUndefined as j } from "@arcgis/toolkit/predicate";
 import { readdir as qe, readFile as J, rm as hs, mkdir as Z, cp as vs, writeFile as D, copyFile as ws } from "node:fs/promises";
 import { mappedFind as he } from "@arcgis/toolkit/array";
-import { camelToKebab as Tt, kebabToPascal as Ss, uncapitalize as ft, getPreamble as bs, capitalize as Ts } from "@arcgis/toolkit/string";
+import { camelToKebab as Tt, kebabToPascal as bs, uncapitalize as ft, getPreamble as Ss, capitalize as Ts } from "@arcgis/toolkit/string";
 import { lazyMetaSubItemJoiner as Es, lazyMetaItemJoiner as tt, lazyMetaGroupJoiner as Cs, propertyFlagAttribute as Ht, propertyFlagReflect as $s, propertyFlagBoolean as xs, propertyFlagNumber as Ps, propertyFlagState as ks, propertyFlagReadOnly as Is, propertyFlagNoAccessor as As } from "@arcgis/lumina/config";
 import { build as Ls } from "esbuild";
 import { identity as Ji } from "@arcgis/toolkit/function";
@@ -207,7 +207,7 @@ ${e.content}`
   const t = e.content.match(tr)?.[1] ?? e.content.match(ir)?.[1];
   if (t !== void 0)
     throw Error(
-      S(
+      b(
         "@arcgis/lumina:failOnJsonImport",
         `Found a .json import (${t}). This can cause TypeScript errors for consumers of your package. See alternative options: https://devtopia.esri.com/WebGIS/arcgis-web-components/issues/2047
  File content:
@@ -397,7 +397,7 @@ function hr(e, t, i, n, s) {
         Qt(e.modifiers),
         e.name,
         void 0,
-        Sr(e.type, s),
+        br(e.type, s),
         e.initializer
       );
       return o.setSyntheticLeadingComments(d, X(l)), d;
@@ -537,7 +537,7 @@ function Ie(e) {
     )
   ];
 }
-function Sr(e, t) {
+function br(e, t) {
   if (e === void 0)
     return;
   const i = o.isImportTypeNode(e) && e.qualifier && o.isIdentifier(e.qualifier) && e.qualifier.escapedText === "EventEmitter" ? e.typeArguments ?? [] : o.isTypeReferenceNode(e) && o.isIdentifier(e.typeName) && e.typeName.escapedText === "EventEmitter" ? e.typeArguments ?? [] : void 0;
@@ -550,7 +550,7 @@ function Sr(e, t) {
     t.fileName
   ), e);
 }
-const br = [ar, fr], Zt = "@arcgis/lumina:componentDtsTransformer";
+const Sr = [ar, fr], Zt = "@arcgis/lumina:componentDtsTransformer";
 function Tr(e) {
   let t;
   const i = Er(e);
@@ -564,7 +564,7 @@ function Tr(e) {
         return [];
       const s = e.typeScriptProgram.getSourceFile(n);
       if (s === void 0)
-        throw Error(S(Zt, `Could not find source file: ${te(n)}`));
+        throw Error(b(Zt, `Could not find source file: ${te(n)}`));
       const r = [];
       return e.typeScriptProgram.emit(
         s,
@@ -582,7 +582,7 @@ function Tr(e) {
   };
 }
 const Er = (e) => (t) => (i) => zi(e, t, i, [
-  ...br,
+  ...Sr,
   ...e.options.types?.declarationAstTransformers ?? []
 ]), Cr = (e) => new Proxy(e, {
   get: $r,
@@ -2121,19 +2121,19 @@ const uo = /@prop\s+(?<name>--[\w-]+)\s*:(?<description>[^@/]+)/gu, mo = /\n\s+\
   repeat: ["lit/directives/repeat.js", "lit-html/directives/repeat.js"],
   ref: ["lit/directives/ref.js", "lit-html/directives/ref.js"],
   nothing: ["lit", "@arcgis/lumina", "lit/html.js", "lit-html", "lit-element/lit-element.js"]
-}, wo = ["css", "less", "sass", "scss", "styl", "stylus", "pcss", "postcss", "sss"], Ke = new RegExp(`\\.(${wo.join("|")})(\\?|$)`, "u"), So = /^import ["'](?<specifier>[^"']+)["'];$/gmu, bo = () => "throwError", V = "@arcgis/lumina:loadLitCss", ee = "?layered", Ne = "?global", To = (e) => ({
+}, wo = ["css", "less", "sass", "scss", "styl", "stylus", "pcss", "postcss", "sss"], Ke = new RegExp(`\\.(${wo.join("|")})(\\?|$)`, "u"), bo = /^import ["'](?<specifier>[^"']+)["'];$/gmu, So = () => "throwError", V = "@arcgis/lumina:loadLitCss", ee = "?layered", Ne = "?global", To = (e) => ({
   name: V,
   enforce: "pre",
   configResolved(t) {
     const i = t.plugins.find(({ name: s }) => s === "vite:css-post");
     if (i === void 0)
-      throw Error(S(V, "Unable to find the vite's built-in vite:css-post plugin"));
+      throw Error(b(V, "Unable to find the vite's built-in vite:css-post plugin"));
     const n = i.transform;
     if (typeof n != "object" || typeof n.handler != "function")
-      throw Error(S(V, "Expected vite:css-post to declare a transform:{handler()} property"));
+      throw Error(b(V, "Expected vite:css-post to declare a transform:{handler()} property"));
     if (Object.keys(n).length !== 1)
       throw Error(
-        S(V, "Expected vite:css-post's transform handler to have only a single property: handler")
+        b(V, "Expected vite:css-post's transform handler to have only a single property: handler")
       );
     i.transform = async function(r, a) {
       const c = a.endsWith(ee);
@@ -2188,14 +2188,14 @@ const uo = /@prop\s+(?<name>--[\w-]+)\s*:(?<description>[^@/]+)/gu, mo = /\n\s+\
     let s = 0;
     const r = co(i);
     let a = !1;
-    const c = t.replaceAll(So, (l, d) => {
+    const c = t.replaceAll(bo, (l, d) => {
       if (!Ke.test(d) || d.includes("?"))
         return l;
       if (r) {
-        if ((e.options.css?.sideEffectImportHandling ?? bo)(d, i) === "drop")
+        if ((e.options.css?.sideEffectImportHandling ?? So)(d, i) === "drop")
           return a = !0, or(l);
         throw Error(
-          S(
+          b(
             V,
             `Found a side-effect CSS import \`${l}\`. Such import is not allowed as it won't work with shadow DOM. This file appears to be external so such import may not be under your control. To ignore this import, please set the css.sideEffectImportHandling property in useLumina() plugin to a function that will return "drop" for this import to indicate that you wish to have this style import dropped. Then, you would have to import the dropped manually in your component like so: \`import { styles } from "example.css";\` and then add \`static override styles = styles;\` to your component`,
             i
@@ -2219,7 +2219,7 @@ const uo = /@prop\s+(?<name>--[\w-]+)\s*:(?<description>[^@/]+)/gu, mo = /\n\s+\
         if (d.endsWith(Ne))
           return l;
         throw Error(
-          S(
+          b(
             V,
             `Found a side-effect CSS import \`${l}\`. Such import is not allowed as it won't work with shadow DOM. Please use \`import { styles } from "example.css";\` instead and then add \`static override styles = styles;\` to your component`,
             i
@@ -2419,14 +2419,14 @@ function zo(e, t, i) {
   if (s !== void 0) {
     if (!o.isObjectLiteralExpression(s))
       throw Error(
-        S(
+        b(
           "@arcgis/lumina:extractEventMeta",
           `Expected object literal expression as first argument of ${Ae}(). Found ${t.name} = createEvent(${s.getText(i)})`
         )
       );
     if (s.properties.some((r) => o.isSpreadAssignment(r)))
       throw Error(
-        S(
+        b(
           "@arcgis/lumina:extractEventMeta",
           `Unexpected spread syntax in ${Ae}() argument. ${Ae}() arguments must be statically parsable at compile time`
         )
@@ -2441,7 +2441,7 @@ function re(e, t) {
   if (e.kind === o.SyntaxKind.FalseKeyword)
     return !1;
   throw Error(
-    S(
+    b(
       "@arcgis/lumina:extractBooleanInitializer",
       `Expected boolean literal. Instead found ${e?.getText(t)}`
     )
@@ -2507,7 +2507,7 @@ class We extends us {
        * prefix (Arcgis), where as tag name always does. This also matches
        * Stencil's behavior.
        */
-      pascalCaseName: Ss(n),
+      pascalCaseName: bs(n),
       privacy: void 0,
       importPath: "",
       members: [],
@@ -2520,7 +2520,7 @@ class We extends us {
     }, r = t.heritageClauses?.find((a) => a.token === o.SyntaxKind.ExtendsKeyword)?.types[0]?.expression;
     if (r === void 0)
       throw Error(
-        S(
+        b(
           "@arcgis/lumina:extractComponentDeclaration",
           `Lumina component must extend LitElement class. Found ${i} in ${this.apiModule.path} that does not extend any class.`
         )
@@ -2676,10 +2676,10 @@ console.log("${s.tagName} is ready to go!");
           x.docsTags = x.docsTags.filter(
             (C) => !c.has(C.name) || fs.has(C.name)
           );
-          const b = i.description;
+          const S = i.description;
           fe(t.name, s, i, x), x.docsTags.forEach((C) => {
             c.add(C.name);
-          }), i.description = b ?? i.description;
+          }), i.description = S ?? i.description;
         } else
           i.description ||= x.description;
       }
@@ -2687,8 +2687,8 @@ console.log("${s.tagName} is ready to go!");
       E.forEach((x) => {
         if ($ ??= o.isGetAccessor(x) ? x : void 0, A ??= o.isSetAccessor(x) ? x : void 0, !("initializer" in x))
           return;
-        const b = x;
-        l ||= b.modifiers?.some((C) => C.kind === o.SyntaxKind.ReadonlyKeyword) ?? !1, Bt(b, i, b.getSourceFile());
+        const S = x;
+        l ||= S.modifiers?.some((C) => C.kind === o.SyntaxKind.ReadonlyKeyword) ?? !1, Bt(S, i, S.getSourceFile());
       }), g && $ !== void 0 && A !== void 0 && $.type?.getText() !== A.parameters[0]?.type?.getText() && (i.getterType = { text: `typeof ${v.getText(this.file)}` });
     }
     if (l && (i.readonly = !0, n || (i.docsOnlyReadonly = !0)), i.type.values && i.type.values.length > 0 && i.type.values?.every((v) => v.type === "boolean") && (i.default ? m && this.context.viteCommand === "build" && i.deprecated === void 0 && (We.loggedBooleanWarning || this.context.logLintWarning(
@@ -2988,12 +2988,12 @@ async function na(e, t) {
     );
 }
 async function vn(e, t) {
-  return Se ??= ra(e, t), await Se;
+  return be ??= ra(e, t), await be;
 }
 function sa() {
   if (Be === void 0)
     throw Error(
-      S(
+      b(
         "@arcgis/lumina:retrieveComponentDependencies",
         "Component dependencies have not yet been initialized. Await componentDependenciesPromise promise first."
       )
@@ -3003,7 +3003,7 @@ function sa() {
 function wn() {
   if (vt === void 0)
     throw Error(
-      S(
+      b(
         "@arcgis/lumina:retrieveFlatComponentDependencies",
         "Component dependencies have not yet been initialized. Await componentDependenciesPromise promise first."
       )
@@ -3012,7 +3012,7 @@ function wn() {
 }
 async function ra(e, t) {
   const i = R(e), n = i.dependencies ?? {}, s = i.peerDependencies ?? {}, a = (await Promise.all(
-    [...Object.keys(n), ...Object.keys(s)].filter((d) => !oa.has(d)).flatMap(async (d) => await Sn(d, e))
+    [...Object.keys(n), ...Object.keys(s)].filter((d) => !oa.has(d)).flatMap(async (d) => await bn(d, e))
   )).filter(j);
   Be ??= a, vt = Object.fromEntries(a.flatMap((d) => Object.entries(d.components)));
   const c = t?.serve?.extraDependencies?.map(
@@ -3056,8 +3056,8 @@ const oa = /* @__PURE__ */ new Set([
   "vscode-languageserver-textdocument",
   "vscode-languageserver-types"
 ]);
-let Be, vt, Se;
-async function Sn(e, t) {
+let Be, vt, be;
+async function bn(e, t) {
   const i = await Ue(e, t), n = await ze(i), s = "exports" in n, r = ua.bind(void 0, s), a = "@stencil/core" in (n.dependencies ?? {}) || "@stencil/core" in (n.devDependencies ?? {}), c = u.join(i, "dist/esm/loader.js");
   if (a ? await _(c) : !1) {
     const g = await J(c, "utf8"), y = aa(g, "bootstrapLazy("), v = g.indexOf(", options", y), h = g.slice(y, v), w = h.startsWith('JSON.parse("') ? h.slice(12, -2).replaceAll('\\"', '"') : h;
@@ -3071,7 +3071,7 @@ Error: ${String(E)}`);
   }
   const d = ui(n.customElements);
   if (d != null) {
-    const g = u.join(i, d), y = JSON.parse(await J(g, "utf-8")), v = ca(y), h = bn(y, {
+    const g = u.join(i, d), y = JSON.parse(await J(g, "utf-8")), v = ca(y), h = Sn(y, {
       packageName: e,
       getImportPath: r
     });
@@ -3100,7 +3100,7 @@ function aa(e, t) {
   const i = e.indexOf(t);
   return i === -1 ? -1 : i + t.length;
 }
-function bn(e, t) {
+function Sn(e, t) {
   const i = {};
   for (const n of e.modules ?? [])
     if (n.declarations !== void 0)
@@ -3277,7 +3277,7 @@ const ya = /* @__PURE__ */ new Set([
         p,
         e,
         m ? "" : void 0
-      ), y = i === "value" && (n === "input" || n === "textarea" || n === Me) ? ba(f, e) : f;
+      ), y = i === "value" && (n === "input" || n === "textarea" || n === Me) ? Sa(f, e) : f;
       if (y !== p)
         return [m ? `.${i}` : s.name, d, y];
     }
@@ -3444,7 +3444,7 @@ function gi(e, t, i) {
       `${i} prop value must be an expression. Found ${String(t?.getText(e.sourceFile))}`
     );
   const n = t.expression;
-  if (Sa(n)) {
+  if (ba(n)) {
     const r = i === "class" ? "safeClassMap" : "safeStyleMap";
     e.neededImports.add(r);
     const a = e.importRenames[r], c = o.factory.createCallExpression(o.factory.createIdentifier(a), void 0, [
@@ -3454,8 +3454,8 @@ function gi(e, t, i) {
   } else
     return [i, ...De(e, t, !0)];
 }
-const Sa = (e) => o.isObjectLiteralExpression(e) || o.isPropertyAccessExpression(e) || o.isIdentifier(e) || o.isCallExpression(e) || o.isBinaryExpression(e) || o.isConditionalExpression(e);
-function ba(e, t) {
+const ba = (e) => o.isObjectLiteralExpression(e) || o.isPropertyAccessExpression(e) || o.isIdentifier(e) || o.isCallExpression(e) || o.isBinaryExpression(e) || o.isConditionalExpression(e);
+function Sa(e, t) {
   t.neededImports.add("live");
   const i = t.importRenames.live;
   return o.factory.createCallExpression(o.factory.createIdentifier(i), void 0, [
@@ -3602,7 +3602,7 @@ function La(e, t) {
   if (!(typeof r == "object" && // If .map() callback has 3rd argument, it's not supported
   n.parameters.length <= 2))
     return t;
-  const c = be(n.body);
+  const c = Se(n.body);
   let l = !0, d;
   if (hi(c))
     d = c;
@@ -3612,7 +3612,7 @@ function La(e, t) {
     const h = c.statements.at(-1);
     if (!(h && o.isReturnStatement(h) && h.expression))
       return t;
-    const E = be(h.expression);
+    const E = Se(h.expression);
     if (!hi(E))
       return t;
     const $ = c.statements.slice(0, -1);
@@ -3708,7 +3708,7 @@ function B(e) {
     if (Na.has(e.kind))
       return [];
     {
-      const t = be(e);
+      const t = Se(e);
       return t !== e ? B(t) : void 0;
     }
   }
@@ -3722,7 +3722,7 @@ const Na = /* @__PURE__ */ new Set([
   o.SyntaxKind.FalseKeyword,
   o.SyntaxKind.NullKeyword,
   o.SyntaxKind.TrueKeyword
-]), be = (e) => o.isAsExpression(e) || o.isNonNullExpression(e) || o.isSatisfiesExpression(e) || o.isParenthesizedExpression(e) ? be(e.expression) : e, xn = (e, t) => o.isObjectBindingPattern(e) ? Ma(e, t) : e;
+]), Se = (e) => o.isAsExpression(e) || o.isNonNullExpression(e) || o.isSatisfiesExpression(e) || o.isParenthesizedExpression(e) ? Se(e.expression) : e, xn = (e, t) => o.isObjectBindingPattern(e) ? Ma(e, t) : e;
 function Da(e, t, i) {
   if (e.every(_e, t))
     return t;
@@ -3787,7 +3787,7 @@ function q(e, t, i) {
     q.bind(null, e, t !== void 0 && o.isBinaryExpression(t) ? void 0 : i),
     e.transformationContext
   );
-  return t !== void 0 && o.isBinaryExpression(i) && (o.isJsxExpression(t) || Je(be(i.right))) ? Ba(s) : s;
+  return t !== void 0 && o.isBinaryExpression(i) && (o.isJsxExpression(t) || Je(Se(i.right))) ? Ba(s) : s;
 }
 function kn(e, t) {
   const i = In(e, t);
@@ -3823,12 +3823,12 @@ function In(e, t) {
         `JSX spread attribute syntax is not supported. See alternatives: https://qawebgis.esri.com/components/lumina/jsx#spread-attributes
 Found ${A.getText(e.sourceFile)}`
       );
-    const { name: x, initializer: b } = A;
+    const { name: x, initializer: S } = A;
     if (o.isJsxNamespacedName(x))
       throw Error(`JSX namespaced attributes are not supported. Found ${x.getText(e.sourceFile)}`);
-    const C = x.text, L = Ta(b), F = L?.propType ?? Ea(C, b, c);
+    const C = x.text, L = Ta(S), F = L?.propType ?? Ea(C, S, c);
     p?.delete(C);
-    const N = va[F](e, L?.initializer ?? b, C, c);
+    const N = va[F](e, L?.initializer ?? S, C, c);
     if (N.length === 0)
       return [];
     const M = e.compiler.shouldMinifyJsx ? [" "] : Ia(Tn(x, e));
@@ -4116,7 +4116,7 @@ function Qa(e, t, i) {
       return;
     const s = te(i);
     throw Error(
-      S(
+      b(
         "@arcgis/lumina:resolveTagName",
         `Unable to resolve the definition of the "${t}" custom element. Used in ${s}. If this is coming from an external package, make sure that package is installed as a peerDependency or a dependency. If in development-only you wish to use a component package that is defined as a devDependency, then provide serve.extraDependencies option to useLumina()`
       )
@@ -4128,7 +4128,7 @@ function Za(e, t) {
   return e.packageName === void 0 ? ce(t, e.moduleName) : u.join(e.packageName, e.moduleName);
 }
 function Rn(e) {
-  return e._localDefinedComponents ??= bn(e.privateApiJson, {
+  return e._localDefinedComponents ??= Sn(e.privateApiJson, {
     packageName: void 0,
     getImportPath() {
       throw new Error("Not supposed to be called for local components");
@@ -4325,12 +4325,12 @@ function cc(e, t, i, n, s) {
   }), r !== -1) {
     const c = lc(e, t, i, n), l = wi(t, r, n), d = sc(t, l, e, n, c);
     let p = !1;
-    return s.set(c.name, d ?? o.factory.createObjectLiteralExpression()), p = !0, l.options = d, Si(t, l, r, p);
+    return s.set(c.name, d ?? o.factory.createObjectLiteralExpression()), p = !0, l.options = d, bi(t, l, r, p);
   } else if (a !== -1) {
     const c = wi(t, a, n), l = o.factory.createPropertyAssignment("state", o.factory.createTrue()), d = c.options === void 0 ? o.factory.createObjectLiteralExpression([l]) : o.factory.updateObjectLiteralExpression(c.options, [...c.options.properties, l]), p = Q(t.name);
     if (p === void 0)
       throw new Error("Failed to statically determine the state property name");
-    return s.set(p, d), Si(t, c, a, !0);
+    return s.set(p, d), bi(t, c, a, !0);
   } else
     return t;
 }
@@ -4365,7 +4365,7 @@ function wi(e, t, i) {
     );
   return { decorator: n, callExpression: s, options: r };
 }
-function Si(e, t, i, n) {
+function bi(e, t, i, n) {
   const s = n ? void 0 : o.factory.updateDecorator(
     t.decorator,
     o.factory.updateCallExpression(
@@ -4513,12 +4513,12 @@ async function fc(e, t) {
         })
       },
       // <link rel="stylesheet" id="arcgisCoreStylesheet" href="https://jsdev.arcgis.com/VERSION/esri/themes/light/main.css" />
-      bi(s)
+      Si(s)
     ];
   } else
-    return [bi(Lt(e, `${i}/assets/`))];
+    return [Si(Lt(e, `${i}/assets/`))];
 }
-const bi = (e) => ({
+const Si = (e) => ({
   // Not using join() because it would turn https:// into https:/
   cssHref: `${e}esri/themes/light/main.css`,
   // This is used be the theme switcher in `@arcgis/storybook-utils`
@@ -4574,7 +4574,7 @@ const hc = [
         return;
       }
       const n = e.getSourceFile(i, t);
-      await Se;
+      await be;
       const r = o.transform(n, [
         (f) => () => zi(e, f, n, [
           ...e.options.types?.sourceFileTransformers ?? [],
@@ -4628,11 +4628,11 @@ function wc(e) {
     skipLibCheck: !0
   };
 }
-function Sc(e) {
+function bc(e) {
   const t = e.options.types?.tsconfigPath, i = t && u.isAbsolute(t) ? t : ds(t ?? "tsconfig.json");
   if (i === void 0)
     throw Error(
-      S(
+      b(
         "@arcgis/lumina:loadTypeScriptConfig",
         `Unable to find ${te(String(t))}. Please make sure the file exists, or provide types.tsconfigPath option to useLumina()`,
         process.cwd()
@@ -4659,7 +4659,7 @@ function On(e) {
   const t = e.target;
   if (t === void 0)
     throw Error(
-      S(
+      b(
         "@arcgis/lumina:resolveTargetVersion",
         'TypeScript config must have a "target" property specified (or any parent tsconfig.json file if this config is extending another tsconfig.json)'
       )
@@ -4667,7 +4667,7 @@ function On(e) {
   const i = o.ScriptTarget[t].toLowerCase();
   return i === "latest" ? "esnext" : i;
 }
-function bc(e, t) {
+function Sc(e, t) {
   if (e.isInStorybook && e.viteCommand === "serve") {
     const i = (a, c, l, ...d) => {
       const p = a.filter(
@@ -4711,7 +4711,7 @@ async function Tc(e, t, i) {
       if (typeof p == "string")
         return `<${d.tag} ${Object.entries(d.attrs ?? {}).map(([m, f]) => `${m}="${f}"`).join(" ")}>${p}</${d.tag}>`;
     }
-    throw Error(S("@arcgis/lumina:buildWebApp", `Unsupported loader type: ${JSON.stringify(d)}`));
+    throw Error(b("@arcgis/lumina:buildWebApp", `Unsupported loader type: ${JSON.stringify(d)}`));
   }).join(`
 `);
   await Promise.all(
@@ -4722,7 +4722,7 @@ async function Tc(e, t, i) {
 `;
       let E = v.indexOf("<style>");
       if (E === -1 && (E = v.indexOf("</head>")), E === -1)
-        throw Error(S("@arcgis/lumina:buildWebApp", `Failed to find <head> or <style> tag in ${g}`));
+        throw Error(b("@arcgis/lumina:buildWebApp", `Failed to find <head> or <style> tag in ${g}`));
       const $ = v.slice(0, E) + w + v.slice(E), A = e.options?.build?.webApp?.transformFile?.($, y, e) ?? $;
       await D(y, A, "utf-8");
     })
@@ -4785,14 +4785,14 @@ async function Cc(e, t, i, n, s) {
   const r = e.environment;
   if (i.minify && s)
     throw Error(
-      S(
+      b(
         U,
         "Unminified CDN build is not yet supported - open a feature request with Lumina maintainers if it is needed"
       )
     );
   if (i.sourcemap && s)
     throw Error(
-      S(
+      b(
         U,
         "Source maps in the CDN build are not yet supported - open a feature request with Lumina maintainers if it is needed"
       )
@@ -4910,7 +4910,7 @@ function Pc(e, t) {
         continue;
       }
       if (r.out.startsWith(".") || r.out.startsWith("/"))
-        throw Error(S(U, `CDN entrypoint path must not start with '.' or '/'. Found: ${r.out}`));
+        throw Error(b(U, `CDN entrypoint path must not start with '.' or '/'. Found: ${r.out}`));
       s.push(r.out);
     }
     i += `"${s.join(",")}".split(",").map(e=>i[p+e+j]=i[p+e]=import.meta.resolve("./"+e+j));`;
@@ -4939,14 +4939,14 @@ function Wn(e, t) {
   const i = [], n = [], s = [], r = /* @__PURE__ */ new Set(), a = [];
   let c = 0;
   const l = e.code.matchAll(kc);
-  for (const b of l) {
-    const [C, L, F, N, M] = b, z = M.startsWith(He);
-    if (c !== 0 && c !== b.index) {
-      const K = e.code.slice(c, b.index);
+  for (const S of l) {
+    const [C, L, F, N, M] = S, z = M.startsWith(He);
+    if (c !== 0 && c !== S.index) {
+      const K = e.code.slice(c, S.index);
       s.push(K), a.push([c, K.length, 0, ""]);
     }
-    if (c = b.index + C.length, z)
-      a.push([b.index, C.length, 0, ""]), n.push(`"${_n(M.slice(He.length))}"`), i.push(L?.replaceAll(" as ", ":") ?? F ?? N ?? "");
+    if (c = S.index + C.length, z)
+      a.push([S.index, C.length, 0, ""]), n.push(`"${_n(M.slice(He.length))}"`), i.push(L?.replaceAll(" as ", ":") ?? F ?? N ?? "");
     else {
       const K = Bn(M, t), G = K?.isAsync === !0;
       if (L !== void 0) {
@@ -4957,14 +4957,14 @@ function Wn(e, t) {
         }
         if (G) {
           const et = K.oldSingleExportName === void 0 ? `{${ke.join(",")}}` : ke[0].split(":")[1];
-          a.push([b.index + 6, 0, L.length, et]);
+          a.push([S.index + 6, 0, L.length, et]);
         }
       } else if (F === void 0 && N === void 0)
-        G && a.push([b.index + 6, 0, 0, ""]);
+        G && a.push([S.index + 6, 0, 0, ""]);
       else {
         if (G)
           throw Error(
-            S(
+            b(
               U,
               `Expected local import specifiers to use only named or side-effect import syntax. Found ${C} in a chunk:
 ${K.code}`
@@ -4980,8 +4980,8 @@ ${K.code}`
   }
   const d = Lc(r);
   let p = e.code.slice(0, c);
-  for (let b = a.length - 1; b >= 0; b--) {
-    const [C, L, F, N] = a[b];
+  for (let S = a.length - 1; S >= 0; S--) {
+    const [C, L, F, N] = a[S];
     let M = L, z = "";
     if (L === 0) {
       const G = d();
@@ -4992,18 +4992,18 @@ ${K.code}`
   const m = Ic.exec(e.code), f = m?.index ?? e.code.length;
   let g = "";
   if (m !== null) {
-    const b = m[1].split(",");
-    if (b.length > 1)
-      g = `return{${b.map((C) => {
+    const S = m[1].split(",");
+    if (S.length > 1)
+      g = `return{${S.map((C) => {
         const [L, F = L] = C.split(" as ");
         return `${F}:${L}`;
       }).join(",")}}`;
     else {
-      const [C, L = C] = b[0].split(" as ");
+      const [C, L = C] = S[0].split(" as ");
       e.oldSingleExportName = L, g = `return ${C}`;
     }
   }
-  const y = i.findLastIndex((b) => b.length > 0), v = i.slice(0, y + 1).join(","), w = `export default $arcgis.t(${i.length === 0 ? "_" : `([${v}])`}=>{`, E = n.join(","), $ = `${g}},${E})`;
+  const y = i.findLastIndex((S) => S.length > 0), v = i.slice(0, y + 1).join(","), w = `export default $arcgis.t(${i.length === 0 ? "_" : `([${v}])`}=>{`, E = n.join(","), $ = `${g}},${E})`;
   let A = e.code.slice(c, f);
   A = `${s.join("")}${A}`, A = Ci(A, t);
   const x = `${p}${w}${A}${$}`;
@@ -5015,9 +5015,9 @@ function Bn(e, t) {
     return;
   const i = e.slice(2), n = t.get(i);
   if (n === void 0)
-    throw Error(S(U, `Failed to find the ${e} module`));
+    throw Error(b(U, `Failed to find the ${e} module`));
   if (n.isAsync === void 0 && Wn(n, t), n.isAsync === void 0)
-    throw Error(S(U, `Failed to infer whether the ${e} module has top-level await`));
+    throw Error(b(U, `Failed to infer whether the ${e} module has top-level await`));
   return n;
 }
 function Ci(e, t) {
@@ -5179,7 +5179,7 @@ async function Jc(e) {
   )).filter(j).flat(), r = await Promise.all([
     // This may contain an import map so must be first
     fc(i, t),
-    Se.then(s),
+    be.then(s),
     qn(e).then(s)
   ]), a = u.join(e.dir.src, "loader.ts");
   return [
@@ -5203,10 +5203,10 @@ async function qn(e) {
   const t = e.options?.serve?.extraDependencies ?? [];
   return t.length === 0 ? [] : (e._serveOnlyDependencies ??= Promise.all(
     t.map(async (i) => {
-      const n = typeof i == "string" ? void 0 : i, s = typeof i == "string" ? i : i.name, r = await Sn(s);
+      const n = typeof i == "string" ? void 0 : i, s = typeof i == "string" ? i : i.name, r = await bn(s);
       if (r === void 0)
         throw Error(
-          S(
+          b(
             "@arcgis/lumina:computeServeOnlyDependencies",
             `Unable to resolve extra dependency "${s}". Make sure it is a valid Stencil or Lumina package.`
           )
@@ -5237,7 +5237,7 @@ async function Kc(e) {
       ].join(`
 `);
     throw Error(
-      S(
+      b(
         "@arcgis/lumina:buildTestSetupFile",
         `Unexpected loader type for the browser test environment: ${JSON.stringify(n)}`
       )
@@ -5362,10 +5362,10 @@ function _c(e) {
   });
   return d;
 }
-const St = "@arcgis/lumina:provideAssets";
+const bt = "@arcgis/lumina:provideAssets";
 function ye(e, t, i = Mt) {
   if (e.viteCommand !== "serve")
-    throw Error(S(St, "serveAssets() is only available when Vite is running in serve mode"));
+    throw Error(b(bt, "serveAssets() is only available when Vite is running in serve mode"));
   const n = e._serverConfigured, s = e.server.middlewares.stack.length;
   if (t.forEach((r) => {
     const a = Xn(r), c = Zn(e.dir, Qn(a)), l = Uc(e.viteConfig.base, c, e.dir.distCdn);
@@ -5376,7 +5376,7 @@ function ye(e, t, i = Mt) {
         p.setHeader("Cache-Control", "max-age=31536000, immutable"), p.setHeader("Content-Type", Ds.lookup(f) || "application/octet-stream"), p.write(w), p.end();
       }).catch((h) => {
         (a.type !== "directory" || process.env.DEBUG) && T.warn(
-          St,
+          bt,
           `Error occurred when trying to serve a file in response to request for "${d.originalUrl ?? f}":${String(h)}`
         ), m();
       }), !0;
@@ -5433,8 +5433,8 @@ function Qn(e) {
   if (e.source.endsWith(u.sep)) {
     if (e.type === "file")
       throw Error(
-        S(
-          St,
+        b(
+          bt,
           `Unexpectedly tried to provide an asset with type "file", whose source looks like a directory: ${te(e.source)}. If source is meant to be a directory, change to "type":"directory". If source is a file, make sure source path does not end with / or \\`
         )
       );
@@ -5517,7 +5517,7 @@ const ts = (e, t) => ({
     }
     const n = i.writeBundle;
     if (typeof n != "function")
-      throw Error(S(ut, "Expected vite:reporter to declare a writeBundle() function"));
+      throw Error(b(ut, "Expected vite:reporter to declare a writeBundle() function"));
     i.writeBundle = async function(r, a) {
       let c = 0, l = 0, d = 0, p = 0;
       const m = console.log;
@@ -5663,7 +5663,7 @@ const ts = (e, t) => ({
     if (typeof l.setupFiles == "string" ? l.setupFiles = [...pt, l.setupFiles] : Array.isArray(l.setupFiles) ? l.setupFiles = [...pt, ...l.setupFiles] : l.setupFiles = [...pt], e.isInPuppeteerTestBackEnd) {
       if (p?.enabled === !0)
         throw Error(
-          S(Li, "Can't enable both Vitest browser mode and Puppeteer testing at the same time")
+          b(Li, "Can't enable both Vitest browser mode and Puppeteer testing at the same time")
         );
       return {
         test: {
@@ -5740,13 +5740,13 @@ const ts = (e, t) => ({
 });
 function nl(e = R()) {
   const t = e.version ?? "0.0.1";
-  return bs(t);
+  return Ss(t);
 }
 const sl = (e) => `/*! ${e} */`, k = (e) => (t, i) => {
   Object.defineProperty(t, i, {
     get() {
       throw Error(
-        S(
+        b(
           "@arcgis/lumina:context",
           `Tried to access '${String(i)}' before it was set. You can't access this property in global scope. However, it will be accessible by the time the following Vite plugin hook is called: ${e}`
         )
@@ -5767,7 +5767,7 @@ const sl = (e) => `/*! ${e} */`, k = (e) => (t, i) => {
 function ue(e) {
   if (u.isAbsolute(e))
     throw Error(
-      S(
+      b(
         "@arcgis/lumina:context",
         `Documentation file name was expected to be a relative path (relative to dist). Instead, received an absolute path: ${e}`
       )
@@ -5789,7 +5789,7 @@ async function ns(e, t, i, n, s = R()) {
     return !1;
   if (process.env.CI)
     throw Error(
-      S(
+      b(
         "@arcgis/lumina:updateLuminaTs",
         `lumina.ts is out of date. Start the vite dev server or build locally at least once to update lumina.ts and commit the updated file. Tried to write the following content:
 
@@ -5898,7 +5898,7 @@ e.isInStorybook && (t === void 0 || t.path === "/iframe.html") || e.viteCommand
         return n.optimizableImports;
       if ("cssHref" in n)
         return [];
-      throw Error(S(Re, `Unexpected loader type: ${JSON.stringify(n)}`));
+      throw Error(b(Re, `Unexpected loader type: ${JSON.stringify(n)}`));
     });
     e.viteConfig.optimizeDeps.include ??= [], e.viteConfig.optimizeDeps.include.push(...i);
   },
@@ -5907,7 +5907,7 @@ e.isInStorybook && (t === void 0 || t.path === "/iframe.html") || e.viteCommand
   }
 });
 async function ll(e) {
-  const i = (await Promise.all([Se, qn(e)])).flat();
+  const i = (await Promise.all([be, qn(e)])).flat();
   if (!await ns(
     i,
     e.dir.src,
@@ -6008,7 +6008,7 @@ class P {
             distCdnAssets: v
           }, T.initialize(a.logger, l), a.root !== Mi())
             throw Error(
-              S(
+              b(
                 W,
                 "Vite's config.root is not equal process.cwd(). This is not officially supported by Lumina and may lead to unexpected behavior. If you need this to be supported, comment on https://devtopia.esri.com/WebGIS/arcgis-web-components/issues/2126 or contact Lumina maintainers."
               )
@@ -6023,7 +6023,7 @@ class P {
           const h = this.options.documentation?.publicStoryUrlPrefix;
           this.isFullApiExtraction && typeof h == "string" ? this.componentStoriesPromise = this.componentFilesPromise.then(async () => await pl(this.componentStoryFiles, h)).then((w) => {
             this.componentStories = w;
-          }) : (this.componentStoriesPromise = void 0, this.componentStories = void 0), bc(this, a.build.sourcemap !== !1), ss(this) && Ee(this);
+          }) : (this.componentStoriesPromise = void 0, this.componentStories = void 0), Sc(this, a.build.sourcemap !== !1), ss(this) && Ee(this);
         }
       },
       configureServer: {
@@ -6062,7 +6062,7 @@ class P {
       webTypes: s.jetBrains === !1 ? void 0 : s.jetBrains?.webTypesFileName ? ue(s.jetBrains.webTypesFileName) : me.webTypes,
       vsCodeHtml: s.vsCode === !1 ? void 0 : s.vsCode?.htmlFileName ? ue(s.vsCode.htmlFileName) : me.vsCodeHtml,
       vsCodeCss: s.vsCode === !1 ? void 0 : s.vsCode?.cssFileName ? ue(s.vsCode.cssFileName) : me.vsCodeCss
-    }, vn(void 0, t), this.componentFilesPromise = kt(this, u.resolve("src/components")), Sc(this);
+    }, vn(void 0, t), this.componentFilesPromise = kt(this, u.resolve("src/components")), bc(this);
     const r = t.build?.preamble ?? nl();
     this.banner = sl(r);
   }
@@ -6086,7 +6086,7 @@ class P {
         return n;
     } else {
       if (this.viteCommand === "build" || this.isInStorybook)
-        throw Error(S(W, t, "Unable to find the TypeScript source file"));
+        throw Error(b(W, t, "Unable to find the TypeScript source file"));
       {
         const r = this._typeScriptSourceFiles.get(t);
         r !== void 0 && r.text === i && (n = r);
@@ -6134,7 +6134,7 @@ class P {
       n === "serve" && ye(this, t, i);
     else
       throw Error(
-        S(
+        b(
           W,
           "It is too late to call provideAssets() as Vite already wrote the bundle to disk. Please call provideAssets() before Vite's writeBundle()"
         )
@@ -6249,9 +6249,14 @@ const mt = "@arcgis/lumina:addNonLazyImports", wl = (e) => ({
       }), (a.length > 0 || c.length > 0) && d.length === 0) {
         const p = te(r);
         throw Error(
-          S(
+          b(
             mt,
-            `Unable to determine what files imported ${p}. This is necessary because this file referenced other web components (${[...a, ...c].join(", ")}), and so the compiler needs to know what component entrypoints these imports should be added to. Please double check if you are referencing ${p} in the code dynamically in the way that Lumina cannot detect, and report this issue to the Lumina maintainers.`
+            `Unable to determine what files imported ${p}. This is necessary because this file referenced other web components (${[...a, ...c].join(", ")}), and so the compiler needs to know what component entrypoints these imports should be added to. Please double check if you are referencing ${p} in the code dynamically in the way that Lumina cannot detect, and report this issue to the Lumina maintainers.
+      
+Possible causes:
+- You are re-exporting a functional component from a barrel file. Refactor such cases to import the functional component directly from the file that declares it.
+- Your web component file is not named correctly and is not recognized as a web component. Lumina web component must be written in an \`.tsx\` file inside the \`src/components/\` folder, and the component file name must match the immediate parent folder name (\`src/components/hello-world/hello-world.tsx\`).
+`
           )
         );
       }
@@ -6260,26 +6265,26 @@ const mt = "@arcgis/lumina:addNonLazyImports", wl = (e) => ({
       if (!n.has(r))
         return [];
       const l = u.dirname(r), d = ve(l, e.dir.srcComponents, e), p = u.relative(e.dir.src, d);
-      function m(b) {
-        const C = Qa(e, b, r);
+      function m(S) {
+        const C = Qa(e, S, r);
         if (C === void 0)
           return;
         const L = Za(C, p);
         if (L !== `./${p}`)
           return L.startsWith(".") ? `${L}/${Fi}` : L;
       }
-      const f = new Set(a), g = new Set(c), y = Array.from(f, m).filter(j), v = (b) => `import "${b}";
-`, h = y.map(v).join(""), w = /* @__PURE__ */ new Set(), E = Array.from(g, (b) => {
-        const C = m(b);
+      const f = new Set(a), g = new Set(c), y = Array.from(f, m).filter(j), v = (S) => `import "${S}";
+`, h = y.map(v).join(""), w = /* @__PURE__ */ new Set(), E = Array.from(g, (S) => {
+        const C = m(S);
         if (C !== void 0) {
-          if (f.has(b)) {
+          if (f.has(S)) {
             T.warn(
               mt,
-              `"${b}" is used both with and without deferLoad in ${r} (either directly in ${r} or via a functional component). deferLoad will be ignored in this case.`
+              `"${S}" is used both with and without deferLoad in ${r} (either directly in ${r} or via a functional component). deferLoad will be ignored in this case.`
             );
             return;
           }
-          return w.add(v(C)), `.set("${b}", () => import("${C}"))
+          return w.add(v(C)), `.set("${S}", () => import("${C}"))
 `;
         }
       }).filter(j), $ = `${h}export * from "./${Et}";`, A = Array.from(w).join("") + $, x = E.length > 0 ? `import { deferredLoaders } from "@arcgis/lumina";
@@ -6287,12 +6292,12 @@ ${$}
 deferredLoaders${E.join("")};` : $;
       return [
         D(u.join(e.dir.dist, p, Fi), x),
-        D(u.join(e.dir.dist, p, Sl), A)
+        D(u.join(e.dir.dist, p, bl), A)
       ];
     });
     await Promise.all(s);
   }
-}), Fi = "index.js", Sl = "index.d.ts", rs = (e, t, i, n = /* @__PURE__ */ new Set()) => t.flatMap((s) => i.has(s) ? [s] : n.has(s) ? [] : (n.add(s), rs(e, e[s].referencedBy, i, n))), bl = (e) => ({
+}), Fi = "index.js", bl = "index.d.ts", rs = (e, t, i, n = /* @__PURE__ */ new Set()) => t.flatMap((s) => i.has(s) ? [s] : n.has(s) ? [] : (n.add(s), rs(e, e[s].referencedBy, i, n))), Sl = (e) => ({
   name: "@arcgis/lumina:handleDynamicAssets",
   configureServer(t) {
     e.server = t, !e.isInPuppeteerTestBackEnd && Ni(e).forEach(({ assets: i, transformers: n }) => ye(e, i, n));
@@ -6311,12 +6316,12 @@ function Ni(e) {
     "type" in n ? t.push(n) : "assets" in n && t.push(...n.assets);
   }), t.length > 0 && i.push({ assets: t }), e.assetsToProvide = void 0, i;
 }
-const bt = "@arcgis/lumina:updatePackageJson", Tl = (e) => ({
-  name: bt,
+const St = "@arcgis/lumina:updatePackageJson", Tl = (e) => ({
+  name: St,
   apply: () => e.viteCommand === "serve" && e.environment === "development" && !e.isInTest && !e.isInCi,
   configResolved() {
     El(e).catch(
-      (t) => T.error(bt, `Failed to update package's package.json:${String(t)}`)
+      (t) => T.error(St, `Failed to update package's package.json:${String(t)}`)
     );
   }
 });
@@ -6328,7 +6333,7 @@ function Cl(e, t) {
   const i = e?.devDependencies ?? {};
   Object.keys(e?.peerDependencies ?? {}).forEach((d) => {
     d in i || T.warn(
-      bt,
+      St,
       `Every peerDependency should also be a devDependency, or else some tools will get confused (like Turbo Build). Found "${d}" that is not a devDependency. Please edit your package.json`
     );
   });
@@ -6920,7 +6925,7 @@ function Id(e = {}) {
     vc(t),
     To(t),
     Gc(t),
-    bl(t),
+    Sl(t),
     wl(t),
     cl(t),
     Rs(t),

package/dist/publicTypes.d.ts

@@ -65,6 +65,7 @@ export type LuminaOptions = {
     readonly assets?: AssetHandlingOptions;
     readonly linting?: LintingOptions;
     readonly experimental?: {
+        /** @deprecated See https://discord.com/channels/1012791295170859069/1047015641225371718 */
         readonly stabilizeRef?: boolean;
     };
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@arcgis/lumina-compiler",
-  "version": "4.34.0-next.85",
+  "version": "4.34.0-next.86",
   "type": "module",
   "main": "dist/index.js",
   "module": "dist/index.js",
@@ -18,9 +18,9 @@
   ],
   "license": "SEE LICENSE IN LICENSE.md",
   "dependencies": {
-    "@arcgis/api-extractor": "4.34.0-next.85",
-    "@arcgis/components-build-utils": "4.34.0-next.85",
-    "@arcgis/toolkit": "4.34.0-next.85",
+    "@arcgis/api-extractor": "4.34.0-next.86",
+    "@arcgis/components-build-utils": "4.34.0-next.86",
+    "@arcgis/toolkit": "4.34.0-next.86",
     "chalk": "^5.4.1",
     "esbuild": "^0.25.5",
     "glob": "^11.0.3",
@@ -31,7 +31,7 @@
     "vitest-fail-on-console": "^0.7.1"
   },
   "peerDependencies": {
-    "@arcgis/lumina": "~4.34.0-next.85",
+    "@arcgis/lumina": "~4.34.0-next.86",
     "lit": "^3.3.0",
     "typescript": "~5.8.3",
     "vite": "^7.0.0",