@arcgis/lumina-compiler 4.34.0-next.23 → 4.34.0-next.25

package/dist/entrypoints/resolveTagName.d.ts

@@ -5,7 +5,7 @@ import { CompilerContext } from '../context';
  * Automatically add imports as appropriate for all referenced internally defined
  * and externally defined custom elements
  */
-export declare function resolveTagName(context: CompilerContext, tagName: string, fileName: string): ModulePath;
+export declare function resolveTagName(context: CompilerContext, tagName: string, fileName: string): ModulePath | undefined;
 export declare function modulePathToString(resolvedPath: ModulePath, distRelativeCwd: string): string;
 export declare function getLocalDefinedComponentsFromApiJson(context: Pick<CompilerContext, "_localDefinedComponents" | "privateApiJson">): Readonly<Record<string, ResolvedDependencyComponent>>;
 export declare const exportsForTests: {

package/dist/index.js

@@ -2685,27 +2685,27 @@ ${c}.componentOnReady().then(() => {
     } : lo(this.context, d, f, this.file);
     const y = o.isPropertyDeclaration(t) && t.type !== void 0 && t.initializer !== void 0 && o.isPropertyAccessExpression(t.initializer) && o.isPropertyAccessExpression(t.initializer.expression) && t.initializer.expression.expression.kind === o.SyntaxKind.ThisKeyword && o.isIdentifier(t.initializer.expression.name) && o.isIdentifier(t.initializer.name);
     if ("initializer" in t && t.initializer !== void 0 && (!i.default || !i.description) || y) {
-      const h = t.initializer, v = s.getSymbolAtLocation(h), S = v !== void 0 && ((v.flags ?? 0) & o.SymbolFlags.Alias) !== 0 ? s.getAliasedSymbol(v) : v, E = S?.getDeclarations() ?? [];
+      const h = t.initializer, v = s.getSymbolAtLocation(h), S = v !== void 0 && ((v.flags ?? 0) & o.SymbolFlags.Alias) !== 0 ? s.getAliasedSymbol(v) : v, T = S?.getDeclarations() ?? [];
       if (S !== void 0) {
         const $ = Bt(s, S);
         if ($.docsTags.length > 0) {
           $.docsTags = $.docsTags.filter(
-            (T) => !c.has(T.name) || vs.has(T.name)
+            (E) => !c.has(E.name) || vs.has(E.name)
           );
           const b = i.description;
-          ue(t.name, s, i, $), $.docsTags.forEach((T) => {
-            c.add(T.name);
+          ue(t.name, s, i, $), $.docsTags.forEach((E) => {
+            c.add(E.name);
           }), i.description = b ?? i.description;
         } else
           i.description ||= $.description;
       }
-      let x, I;
-      E.forEach(($) => {
-        if (x ??= o.isGetAccessor($) ? $ : void 0, I ??= o.isSetAccessor($) ? $ : void 0, !("initializer" in $))
+      let x, L;
+      T.forEach(($) => {
+        if (x ??= o.isGetAccessor($) ? $ : void 0, L ??= o.isSetAccessor($) ? $ : void 0, !("initializer" in $))
           return;
         const b = $;
-        l ||= b.modifiers?.some((T) => T.kind === o.SyntaxKind.ReadonlyKeyword) ?? !1, Wt(b, i, b.getSourceFile());
-      }), y && x !== void 0 && I !== void 0 && x.type?.getText() !== I.parameters[0]?.type?.getText() && (i.getterType = { text: `typeof ${h.getText(this.file)}` });
+        l ||= b.modifiers?.some((E) => E.kind === o.SyntaxKind.ReadonlyKeyword) ?? !1, Wt(b, i, b.getSourceFile());
+      }), y && x !== void 0 && L !== void 0 && x.type?.getText() !== L.parameters[0]?.type?.getText() && (i.getterType = { text: `typeof ${h.getText(this.file)}` });
     }
     if (l && (i.readonly = !0, n || (i.docsOnlyReadonly = !0)), i.type.values && i.type.values.length > 0 && i.type.values?.every((h) => h.type === "boolean") && (i.default ? m && this.context.viteCommand === "build" && i.deprecated === void 0 && (Je.loggedBooleanWarning || this.context.logLintWarning(
       `Boolean properties should default to "false". Found default value "true" in ${this.apiComponent.name}.${i.name}. See https://qawebgis.esri.com/components/lumina/properties#boolean-properties`
@@ -3077,11 +3077,11 @@ async function bn(e, t) {
   if (a ? await U(c) : !1) {
     const y = await J(c, "utf8"), g = ya(y, "bootstrapLazy("), h = y.indexOf(", options", g), v = y.slice(g, h), S = v.startsWith('JSON.parse("') ? v.slice(12, -2).replaceAll('\\"', '"') : v;
     try {
-      const E = JSON.parse(S), x = va(E, { packageName: e, getImportPath: r });
+      const T = JSON.parse(S), x = va(T, { packageName: e, getImportPath: r });
       return { packageName: e, type: "stencil", components: x };
-    } catch (E) {
+    } catch (T) {
       C.warn("@arcgis/lumina", `Failed to parse dist/esm/loader.js for ${e}.
-Error: ${String(E)}`);
+Error: ${String(T)}`);
     }
   }
   const d = fi(n.customElements);
@@ -3635,13 +3635,13 @@ function Ha(e, t) {
     const v = c.statements.at(-1);
     if (!(v && o.isReturnStatement(v) && v.expression))
       return t;
-    const E = Se(v.expression);
-    if (!Si(E))
+    const T = Se(v.expression);
+    if (!Si(T))
       return t;
     const x = c.statements.slice(0, -1);
     if (x.some(An))
       return t;
-    l = x.length === 0, d = E;
+    l = x.length === 0, d = T;
   }
   const p = o.isJsxElement(d) ? d.openingElement : d, m = Dn(p);
   if (m === -1)
@@ -3840,22 +3840,22 @@ function Nn(e, t) {
   let m;
   const f = [];
   let y = !1;
-  const g = s.attributes.properties.flatMap((I) => {
-    if (o.isJsxSpreadAttribute(I))
+  const g = s.attributes.properties.flatMap((L) => {
+    if (o.isJsxSpreadAttribute(L))
       throw Error(
         `JSX spread attribute syntax is not supported. See alternatives: https://qawebgis.esri.com/components/lumina/jsx#spread-attributes
-Found ${I.getText(e.sourceFile)}`
+Found ${L.getText(e.sourceFile)}`
       );
-    const { name: $, initializer: b } = I;
+    const { name: $, initializer: b } = L;
     if (o.isJsxNamespacedName($))
       throw Error(`JSX namespaced attributes are not supported. Found ${$.getText(e.sourceFile)}`);
-    const T = $.text, L = ja(b), N = L?.propType ?? Ra(T, b, c);
-    p?.delete(T);
-    const D = La[N](e, L?.initializer ?? b, T, c);
+    const E = $.text, I = ja(b), N = I?.propType ?? Ra(E, b, c);
+    p?.delete(E);
+    const D = La[N](e, I?.initializer ?? b, E, c);
     if (D.length === 0)
       return [];
     const M = e.compiler.shouldMinifyJsx ? [" "] : Wa(Pn($, e));
-    return N === "key" ? (m = typeof D[0] == "object" && !Ln($, e) ? D[0] : void 0, M.some(Ja) ? M : []) : N === "directives" || N === "ref" || T === "deferLoad" ? (y ||= N === "deferLoad", f.push(
+    return N === "key" ? (m = typeof D[0] == "object" && !Ln($, e) ? D[0] : void 0, M.some(Ja) ? M : []) : N === "directives" || N === "ref" || E === "deferLoad" ? (y ||= N === "deferLoad", f.push(
       ...M,
       ...D.flatMap(
         (H, K) => typeof H == "string" || K === 0 || typeof D[K - 1] == "string" ? H : [" ", H]
@@ -3876,13 +3876,13 @@ Found ${I.getText(e.sourceFile)}`
     throw Error(
       `Void HTML elements like <${c}> cannot have children. Found ${t.getText(e.sourceFile)}`
     );
-  const S = (l === oe || l === Z) && v.parts.length === 0, E = [
+  const S = (l === oe || l === Z) && v.parts.length === 0, T = [
     "<",
     typeof c == "string" ? c : r,
     ...g,
     S ? `${g.length === 0 ? "" : " "}/>` : ">"
-  ], x = h || S ? E : [
-    ...E,
+  ], x = h || S ? T : [
+    ...T,
     /**
      * If parent was an HTML element (e.g. `<svg>`), but children are SVG
      * fragments (e.g. `<circle />`, then wrap the children in their own
@@ -4152,6 +4152,8 @@ function lc(e) {
 function dc(e, t, i) {
   const n = Sn()[t] ?? Kn(e)[t];
   if (n === void 0) {
+    if (e.options?.build?.dependencies?.silenceUnknownJsxElementUsage?.(t, i, e) === !0)
+      return;
     const s = Y(i);
     throw Error(
       w(
@@ -4758,10 +4760,10 @@ async function jc(e, t, i) {
       await z(u.dirname(g), { recursive: !0 });
       const h = await J(y, "utf-8"), v = ee(u.dirname(f), `build/${i}`), S = `${l}<script type="module" src="${v}"><\/script>
 `;
-      let E = h.indexOf("<style>");
-      if (E === -1 && (E = h.indexOf("</head>")), E === -1)
+      let T = h.indexOf("<style>");
+      if (T === -1 && (T = h.indexOf("</head>")), T === -1)
         throw Error(w("@arcgis/lumina:buildWebApp", `Failed to find <head> or <style> tag in ${y}`));
-      const x = h.slice(0, E) + S + h.slice(E);
+      const x = h.slice(0, T) + S + h.slice(T);
       await F(g, x, "utf-8");
     })
   );
@@ -4987,24 +4989,24 @@ function Un(e, t) {
   let c = 0;
   const l = e.code.matchAll(Bc);
   for (const b of l) {
-    const [T, L, N, D, M] = b, H = M.startsWith(We);
+    const [E, I, N, D, M] = b, H = M.startsWith(We);
     if (c !== 0 && c !== b.index) {
       const K = e.code.slice(c, b.index);
       s.push(K), a.push([c, K.length, 0, ""]);
     }
-    if (c = b.index + T.length, H)
-      a.push([b.index, T.length, 0, ""]), n.push(`"${qn(M.slice(We.length))}"`), i.push(L?.replaceAll(" as ", ":") ?? N ?? D ?? "");
+    if (c = b.index + E.length, H)
+      a.push([b.index, E.length, 0, ""]), n.push(`"${qn(M.slice(We.length))}"`), i.push(I?.replaceAll(" as ", ":") ?? N ?? D ?? "");
     else {
       const K = zn(M, t), G = K?.isAsync === !0;
-      if (L !== void 0) {
+      if (I !== void 0) {
         const xe = [];
-        for (const Ye of L.slice(1, -1).split(",")) {
+        for (const Ye of I.slice(1, -1).split(",")) {
           const [Ot, Jt = Ot] = Ye.split(" as ");
           G || r.add(Jt), xe.push(`${Ot}:${Jt}`);
         }
         if (G) {
           const Ye = K.oldSingleExportName === void 0 ? `{${xe.join(",")}}` : xe[0].split(":")[1];
-          a.push([b.index + 6, 0, L.length, Ye]);
+          a.push([b.index + 6, 0, I.length, Ye]);
         }
       } else if (N === void 0 && D === void 0)
         G && a.push([b.index + 6, 0, 0, ""]);
@@ -5013,7 +5015,7 @@ function Un(e, t) {
           throw Error(
             w(
               _,
-              `Expected local import specifiers to use only named or side-effect import syntax. Found ${T}`
+              `Expected local import specifiers to use only named or side-effect import syntax. Found ${E}`
             )
           );
         r.add(D ?? N);
@@ -5027,32 +5029,32 @@ function Un(e, t) {
   const d = Hc(r);
   let p = e.code.slice(0, c);
   for (let b = a.length - 1; b >= 0; b--) {
-    const [T, L, N, D] = a[b];
-    let M = L, H = "";
-    if (L === 0) {
+    const [E, I, N, D] = a[b];
+    let M = I, H = "";
+    if (I === 0) {
       const G = d();
       n.push(G), H = ` ${G} from`, D !== "" ? (M = N + 4, i.push(D)) : i.push("");
     }
-    p = p.slice(0, T) + H + p.slice(T + M);
+    p = p.slice(0, E) + H + p.slice(E + M);
   }
   const m = Wc.exec(e.code), f = m?.index ?? e.code.length;
   let y = "";
   if (m !== null) {
     const b = m[1].split(",");
     if (b.length > 1)
-      y = `return{${b.map((T) => {
-        const [L, N = L] = T.split(" as ");
-        return `${N}:${L}`;
+      y = `return{${b.map((E) => {
+        const [I, N = I] = E.split(" as ");
+        return `${N}:${I}`;
       }).join(",")}}`;
     else {
-      const [T, L = T] = b[0].split(" as ");
-      e.oldSingleExportName = L, y = `return ${T}`;
+      const [E, I = E] = b[0].split(" as ");
+      e.oldSingleExportName = I, y = `return ${E}`;
     }
   }
-  const g = i.findLastIndex((b) => b.length > 0), h = i.slice(0, g + 1).join(","), S = `export default $arcgis.t(${i.length === 0 ? "_" : `([${h}])`}=>{`, E = n.join(","), x = `${y}},${E})`;
-  let I = e.code.slice(c, f);
-  I = `${s.join("")}${I}`, I = Pi(I, t);
-  const $ = `${p}${S}${I}${x}`;
+  const g = i.findLastIndex((b) => b.length > 0), h = i.slice(0, g + 1).join(","), S = `export default $arcgis.t(${i.length === 0 ? "_" : `([${h}])`}=>{`, T = n.join(","), x = `${y}},${T})`;
+  let L = e.code.slice(c, f);
+  L = `${s.join("")}${L}`, L = Pi(L, t);
+  const $ = `${p}${S}${L}${x}`;
   e.code = $;
 }
 const Bc = /import(?:(\{[^}]+\})from|\*as (\w+) from| ([\w$]+) from)?"([^"]+)";/gu, Wc = /export\{([^}]+)\};\n$/u, We = "@arcgis/core/";
@@ -5339,7 +5341,7 @@ function il(e) {
           (S) => S.length > 0 ? m() : void 0
         ) : void 0
       ), g.watcher.on("unlinkDir", (v) => {
-        e.componentFiles.some((E) => E.startsWith(v)) && m();
+        e.componentFiles.some((T) => T.startsWith(v)) && m();
       });
       function h(v) {
         he(v, e.dir.srcComponents) && m();
@@ -5364,29 +5366,29 @@ function il(e) {
       if (x === void 0)
         return;
       if (!(x.text === v)) {
-        let T;
+        let E;
         await Promise.race([
           e._typeScriptReload.promise,
-          new Promise((L) => {
-            T = setTimeout(() => {
+          new Promise((I) => {
+            E = setTimeout(() => {
               C.info(
                 l,
                 "Timed out waiting for TypeScript to finish type-checking. This may be a bug"
-              ), L(void 0);
+              ), I(void 0);
             }, 1e4);
           })
-        ]), clearTimeout(T);
+        ]), clearTimeout(E);
       }
     }
     if (!he(g, e.dir.srcComponents))
       return;
     v ??= await h();
-    const E = ia(e, g, v);
-    if (E === void 0)
+    const T = ia(e, g, v);
+    if (T === void 0)
       return !1;
-    for (const x of E) {
-      const I = yn(x);
-      e.server.ws.send({ type: "custom", event: "component-meta-update", data: I });
+    for (const x of T) {
+      const L = yn(x);
+      e.server.ws.send({ type: "custom", event: "component-meta-update", data: L });
     }
     return f(), !0;
   }
@@ -5670,7 +5672,7 @@ const dt = "@arcgis/lumina:printTotalBuildSize", dl = (e) => ({
       ...await Zr(e)
     }, { loader: g, ...h } = y, v = e.environment === "development" || e.isInTest ? {
       "process.env.ESRI_INTERNAL": "true"
-    } : void 0, S = !import.meta.url.includes("node_modules"), E = {
+    } : void 0, S = !import.meta.url.includes("node_modules"), T = {
       /**
        * Dependency pre-bundling by default scouts all index.html files to find
        * what dependencies are used. Since Lumina adds imports to index.html
@@ -5779,7 +5781,7 @@ const dt = "@arcgis/lumina:printTotalBuildSize", dl = (e) => ({
            */
           forceRerunTriggers: f === void 0 ? ["**/*.{ts,tsx}"] : void 0
         },
-        optimizeDeps: E,
+        optimizeDeps: T,
         define: v
       };
     }
@@ -5809,7 +5811,7 @@ const dt = "@arcgis/lumina:printTotalBuildSize", dl = (e) => ({
           }
         }
       },
-      optimizeDeps: E,
+      optimizeDeps: T,
       define: v,
       test: {
         /*
@@ -6042,8 +6044,8 @@ async function $l(e, t) {
         const p = d[1], m = Ll(p), f = r.indexOf("{", d.index), y = r.indexOf("}", f), g = r.slice(0, d.index).trimEnd();
         let h = "";
         if (g.endsWith("*/")) {
-          const E = g.lastIndexOf("/**");
-          h = g.slice(E + 3, -2).trim().replaceAll(Al, "");
+          const T = g.lastIndexOf("/**");
+          h = g.slice(T + 3, -2).trim().replaceAll(Al, "");
         }
         const v = r.slice(f, y).match(kl)?.[1] || m, S = Il(m);
         l.push({
@@ -6344,14 +6346,17 @@ const pt = "@arcgis/lumina:addNonLazyImports", Nl = (e) => ({
         return [];
       const l = u.dirname(r), d = ge(l, e.dir.srcComponents, e), p = u.relative(e.dir.src, d);
       function m(b) {
-        const T = pc(dc(e, b, r), p);
-        if (T !== `./${p}`)
-          return T.startsWith(".") ? `${T}/${Di}` : T;
+        const E = dc(e, b, r);
+        if (E === void 0)
+          return;
+        const I = pc(E, p);
+        if (I !== `./${p}`)
+          return I.startsWith(".") ? `${I}/${Di}` : I;
       }
       const f = new Set(a), y = new Set(c), g = Array.from(f, m).filter(j), h = (b) => `import "${b}";
-`, v = g.map(h).join(""), S = /* @__PURE__ */ new Set(), E = Array.from(y, (b) => {
-        const T = m(b);
-        if (T !== void 0) {
+`, v = g.map(h).join(""), S = /* @__PURE__ */ new Set(), T = Array.from(y, (b) => {
+        const E = m(b);
+        if (E !== void 0) {
           if (f.has(b)) {
             C.warn(
               pt,
@@ -6359,15 +6364,15 @@ const pt = "@arcgis/lumina:addNonLazyImports", Nl = (e) => ({
             );
             return;
           }
-          return S.add(h(T)), `.set("${b}", () => import("${T}"))
+          return S.add(h(E)), `.set("${b}", () => import("${E}"))
 `;
         }
-      }).filter(j), x = `${v}export * from "./${Tt}";`, I = Array.from(S).join("") + x, $ = E.length > 0 ? `import { deferredLoaders } from "@arcgis/lumina";
+      }).filter(j), x = `${v}export * from "./${Tt}";`, L = Array.from(S).join("") + x, $ = T.length > 0 ? `import { deferredLoaders } from "@arcgis/lumina";
 ${x}
-deferredLoaders${E.join("")};` : x;
+deferredLoaders${T.join("")};` : x;
       return [
         F(u.join(e.dir.dist, p, Di), $),
-        F(u.join(e.dir.dist, p, Dl), I)
+        F(u.join(e.dir.dist, p, Dl), L)
       ];
     });
     await Promise.all(s);

package/dist/publicTypes.d.ts

@@ -251,6 +251,24 @@ export type DependencyManagementOptions = Omit<RollupPluginNodeExternalsOptions,
      * technical reasons.
      */
     readonly externalize?: NonNullable<RollupPluginNodeExternalsOptions>["include"];
+    /**
+     * By default, Lumina will error if it encounters usage of an unknown custom
+     * element. This setting allows to silence such error if you are manually
+     * importing some custom elements.
+     *
+     * > [!IMPORTANT]
+     * >
+     * > This option is an escape hatch. Build-time optimizations are not applied
+     * > to such custom elements. Additionally, you assume the responsibility for
+     * > correctly loading the web component in lazy, non-lazy and CDN builds.
+     *
+     * @example
+     * ```ts
+     * // Silence errors for unknown custom elements that start with "fluent-"
+     * silenceUnknownJsxElementUsage: (tagName) => tagName.startsWith("fluent-")
+     * ```
+     */
+    readonly silenceUnknownJsxElementUsage?: (tagName: string, fileName: string, context: CompilerContext) => boolean;
 };
 export type ServeEnvironmentOptions = {
     /**

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@arcgis/lumina-compiler",
-  "version": "4.34.0-next.23",
+  "version": "4.34.0-next.25",
   "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.23",
-    "@arcgis/components-build-utils": "4.34.0-next.23",
-    "@arcgis/components-utils": "4.34.0-next.23",
+    "@arcgis/api-extractor": "4.34.0-next.25",
+    "@arcgis/components-build-utils": "4.34.0-next.25",
+    "@arcgis/components-utils": "4.34.0-next.25",
     "chalk": "^5.3.0",
     "esbuild": "^0.25.4",
     "glob": "^11.0.0",
@@ -37,6 +37,6 @@
     "vitest-fail-on-console": "^0.7.1"
   },
   "peerDependencies": {
-    "@arcgis/lumina": "~4.34.0-next.23"
+    "@arcgis/lumina": "~4.34.0-next.25"
   }
 }