@arcgis/lumina-compiler 5.0.0-next.1 → 5.0.0-next.100

package/dist/testing/index.js

@@ -1,109 +1,112 @@
 import { render as C } from "lit";
-import { unsafeStatic as m, html as w } from "lit/static-html.js";
-import { devOnly$getLitElementTagNameAndRuntime as x, LitElement as O } from "@arcgis/lumina";
+import { unsafeStatic as m, html as b } from "lit/static-html.js";
+import { devOnly$getLitElementTagNameAndRuntime as O, LitElement as x } from "@arcgis/lumina";
 import { camelToKebab as S } from "@arcgis/toolkit/string";
-import { onTestFinished as _, beforeEach as R, afterEach as D, expect as M } from "vitest";
-import b from "chalk";
-import j from "js-beautify";
+import { onTestFinished as _, beforeEach as R, afterEach as j, expect as D } from "vitest";
+import v from "chalk";
+import M from "js-beautify";
 import { toFunction as z } from "@arcgis/lumina/controllers";
-async function X(e, { parent: t = document.body, afterConnect: o, dynamicComponents: f, cleanupAfterTest: r = !0 } = {}) {
-  const n = document.createElement("div");
-  n.style.display = "contents", t.append(n), r && _(() => F(n)), v(e);
-  const l = f?.some(v);
-  let i;
+import { rethrowError as A } from "@arcgis/toolkit/log";
+async function Z(e, { parent: t = document.body, afterConnect: n, dynamicComponents: f, cleanupAfterTest: r = !0 } = {}) {
+  const i = document.createElement("div");
+  i.style.display = "contents", t.append(i), r && _(() => P(i)), g(e);
+  const s = f?.some(g);
+  let o;
   if (typeof e == "string")
-    i = w`<${m(e)}></${m(e)}>`;
+    o = b`<${m(e)}></${m(e)}>`;
   else if (typeof e == "function")
-    if (p(e)) {
-      const a = x(e).tagName;
-      i = w`<${m(a)}></${m(a)}>`;
+    if (d(e)) {
+      const a = O(e).tagName;
+      o = b`<${m(a)}></${m(a)}>`;
     } else
-      i = e();
+      o = e();
   else {
-    if (l)
+    if (s)
       throw new Error(
         'When rendering a dynamically created custom element using Lit\'s html`` function, you must ensure that the custom element class name is unique in the test file, or the class should explicitly have the `static tagName = "some-tag-name";` property with a unique tag name within the test file'
       );
-    i = e;
+    o = e;
   }
-  const s = [];
-  function c(a) {
-    s.push(a.error), a.preventDefault(), a.stopPropagation();
+  const c = [];
+  function u(a) {
+    c.push(a.error), a.preventDefault(), a.stopPropagation();
   }
-  if (window.addEventListener("error", c), C(i, n), window.removeEventListener("error", c), s.length === 1)
-    throw s[0];
-  if (s.length > 1)
-    throw new AggregateError(s, "Multiple errors occurred while creating the custom element");
-  const u = L(n), N = g, y = o?.(u);
-  y?.then !== void 0 && await y;
-  const d = u;
-  typeof d?.componentOnReady == "function" && await d.componentOnReady();
-  const h = d?.$component ?? N ?? u;
+  if (window.addEventListener("error", u), C(o, i), window.removeEventListener("error", u), c.length === 1)
+    throw c[0];
+  if (c.length > 1)
+    throw new AggregateError(c, "Multiple errors occurred while creating the custom element");
+  const l = L(i), N = y, w = n?.(l);
+  w?.then !== void 0 && await w;
+  const h = l;
+  typeof h?.componentOnReady == "function" && await h.componentOnReady();
+  const p = h?.$component ?? N ?? l;
   return {
-    el: u,
-    component: h,
+    el: l,
+    component: p,
     async reRender() {
-      return typeof e == "function" && !p(e) && C(e(), t), h.requestUpdate(), await h.updateComplete;
+      return typeof e == "function" && !d(e) && C(e(), t), p.requestUpdate(), await p.updateComplete;
     },
-    container: n
+    container: i
   };
 }
-let g;
-const A = globalThis;
-A.devOnly$luminaComponentRefCallback = (e) => {
-  g = e;
+let y;
+const F = globalThis;
+F.devOnly$luminaComponentRefCallback = (e) => {
+  y = e;
 };
-function F(e) {
+function P(e) {
   for (; e.firstChild; )
     e.removeChild(e.firstChild);
   e instanceof HTMLElement && e.remove();
 }
-function v(e) {
-  if (!p(e))
+function g(e) {
+  if (!d(e))
     return !1;
-  const { runtime: t, tagName: o = e.tagName } = x(e);
+  const { runtime: t, tagName: n = e.tagName } = O(e);
   if (t !== void 0)
     return !1;
-  let r = !1, n = o;
-  if (n === void 0) {
-    const l = S(
+  const r = Object.getPrototypeOf(e);
+  r !== x && d(r) && g(r);
+  let i = !1, s = n;
+  if (s === void 0) {
+    const o = S(
       /*
        * If name is a single letter, it was probably minified - thus is not
        * stable, thus don't use it. Example: class produced by wrapController()
        */
       (e.name.length > 1 ? e.name.replaceAll(q, "") : "") || "Test"
-    ), i = l === "test" ? "te-st" : l.includes("-") ? l : `${l}-`;
-    n = i;
-    for (let s = 2, c = customElements.get(n); c !== e && c !== void 0; s += 1)
-      r = !0, n = `${i}-${s}`, c = customElements.get(n);
+    ), c = o === "test" ? "te-st" : o.includes("-") ? o : `${o}-`;
+    s = c;
+    for (let u = 2, l = customElements.get(s); l !== e && l !== void 0; u += 1)
+      i = !0, s = `${c}-${u}`, l = customElements.get(s);
   }
-  return globalThis.devOnly$luminaRuntime?.customElement(n, e), Object.defineProperty(e.prototype, "tagName", { value: n.toUpperCase() }), r;
+  return globalThis.devOnly$luminaRuntime?.customElement(s, e), Object.defineProperty(e.prototype, "tagName", { value: s.toUpperCase() }), i;
 }
-const p = (e) => typeof e == "function" && "lumina" in e, q = /\d+$/gu;
+const d = (e) => typeof e == "function" && "lumina" in e, q = /\d+$/gu;
 function L(e) {
   for (const t of e.children)
     if ("lumina" in t.constructor)
       return t;
   for (const t of e.children) {
-    const o = L(t);
-    if (o != null)
-      return o;
+    const n = L(t);
+    if (n != null)
+      return n;
   }
-  return e.firstElementChild ?? g?.el;
+  return e.firstElementChild ?? y?.el;
 }
 function H() {
   const e = $("warn"), t = $("error");
   R(() => {
     e.beforeEach(), t.beforeEach();
-  }), D(() => {
+  }), j(() => {
     e.afterEach(), t.afterEach();
   });
 }
 function $(e) {
   let t = !1;
-  const o = console[e];
+  const n = console[e];
   function f(...r) {
-    o(...r), t = !0;
+    n(...r), t = !0;
   }
   return {
     beforeEach() {
@@ -111,23 +114,23 @@ function $(e) {
     },
     afterEach() {
       if (t)
-        throw new Error(`[@arcgis/lumina:failOnConsole] Expected test not to call ${b.bold(`console.${e}()`)}.
+        throw new Error(`[@arcgis/lumina:failOnConsole] Expected test not to call ${v.bold(`console.${e}()`)}.
     If the ${e} is expected, test for it explicitly by mocking it out using:
-    ${b.bold(`vi.spyOn(console, '${e}').mockImplementation(() => {}) `)}
+    ${v.bold(`vi.spyOn(console, '${e}').mockImplementation(() => {}) `)}
     and test that the ${e} occurs.`);
-      console[e] = o;
+      console[e] = n;
     }
   };
 }
-function P() {
-  M.addSnapshotSerializer({
+function U() {
+  D.addSnapshotSerializer({
     // Using duck typing to detect ShadowRoot. Not using instanceof to keep test fast
     test(e) {
       return typeof e == "object" && e !== null && "innerHTML" in e && "onslotchange" in e;
     },
     serialize(e) {
-      const t = e.innerHTML.replaceAll(U, "");
-      return j.html(t, {
+      const t = e.innerHTML.replaceAll(I, "");
+      return M.html(t, {
         /* eslint-disable @typescript-eslint/naming-convention */
         indent_size: 2,
         indent_char: " ",
@@ -140,17 +143,17 @@ function P() {
     }
   });
 }
-const U = /<!--\??(?:lit\$\d+\$)?-->/gu;
-function Y() {
-  T[E] || (T[E] = !0, H(), P());
+const I = /<!--\??(?:lit\$\d+\$)?-->/gu;
+function k() {
+  T[E] || (T[E] = !0, H(), U());
 }
 const E = Symbol.for("lumina:didSetupTest"), T = globalThis;
-function Z(e, t) {
-  class o extends O {
+function ee(e, t) {
+  class n extends x {
     constructor() {
       super();
       const r = "prototype" in e ? z(e) : e;
-      this.controller = r(this), Promise.resolve(t?.(this)).catch(console.error);
+      this.controller = r(this), Promise.resolve(t?.(this)).catch(A(this));
     }
     /*
      * Emitting controller's exports here is useful to let controller tests
@@ -162,10 +165,10 @@ function Z(e, t) {
       );
     }
   }
-  return o;
+  return n;
 }
 export {
-  X as mount,
-  Y as setupLuminaTest,
-  Z as wrapController
+  Z as mount,
+  k as setupLuminaTest,
+  ee as wrapController
 };

package/dist/testing/mount.d.ts

@@ -82,7 +82,7 @@ export type RenderOptions<Component extends HTMLElement = HTMLElement> = {
  * Render Lit Element in a test environment.
  *
  * See documentation:
- * https://qawebgis.esri.com/components/lumina/testing
+ * https://webgis.esri.com/references/lumina/testing
  *
  * @example
  * ```tsx

package/dist/tests/utils.d.ts

@@ -1,4 +1,4 @@
-import { ContextDirectories } from '../context/types';
-import { CompilerContext } from '../context';
+import { ContextDirectories } from '../context/types.ts';
+import { CompilerContext } from '../context/index.ts';
 export declare const testDir: ContextDirectories;
 export declare const testContext: Pick<CompilerContext, "_documentationFileNames" | "dir" | "options">;

package/dist/transformers/index.d.ts

@@ -1,5 +1,5 @@
 import { Plugin } from 'vite';
-import { CompilerContext } from '../context';
+import { CompilerContext } from '../context/index.ts';
 import { default as ts } from 'typescript';
 /**
  * A pipeline of transformers for .tsx files.

package/dist/transformers/injectRuntimeOptions.d.ts

@@ -1,4 +1,4 @@
-import { CompilerContext } from '../context';
+import { CompilerContext } from '../context/index.ts';
 import { Plugin } from 'vite';
 export declare const injectRuntimeOptions: (context: CompilerContext) => Plugin;
 /**

package/dist/transformers/members.d.ts

@@ -1,5 +1,5 @@
 import { default as ts } from 'typescript';
-import { FileTransformContext, FileTransformer } from '../publicTypes';
+import { FileTransformContext, FileTransformer } from '../publicTypes.ts';
 /**
  * - Remove `@Method()` decorators from the code. `@Method()` decorators are
  *   only needed for the docs extraction.

package/dist/transformers/property.d.ts

@@ -1,6 +1,6 @@
 import { default as ts } from 'typescript';
-import { FileTransformContext } from '../publicTypes';
-import { LiftedDecorators } from './liftDecorators';
+import { FileTransformContext } from '../publicTypes.ts';
+import { LiftedDecorators } from './liftDecorators.ts';
 export declare function transformProperty(context: FileTransformContext, property: ts.AccessorDeclaration | ts.PropertyDeclaration, className: string | undefined, sourceFile: ts.SourceFile, liftedDecorators: LiftedDecorators): ts.ClassElement;
 export type ParsedPropertyDecorator = {
     decorator: ts.Decorator;

package/dist/transformers/propertyOptions.d.ts

@@ -1,6 +1,6 @@
 import { default as ts } from 'typescript';
-import { FileTransformContext } from '../publicTypes';
-import { ParsedPropertyDecorator } from './property';
+import { FileTransformContext } from '../publicTypes.ts';
+import { ParsedPropertyDecorator } from './property.ts';
 import { ApiCustomElementField } from '@arcgis/api-extractor';
 /**
  * In Stencil, the compiler uses type checking to determine if the inferred

package/dist/transformers/utils.d.ts

@@ -1,6 +1,6 @@
 import { default as ts } from 'typescript';
-import { FileTransformContext, FileTransformer } from '../publicTypes';
-import { CompilerContext } from '../context';
+import { FileTransformContext, FileTransformer } from '../publicTypes.ts';
+import { CompilerContext } from '../context/index.ts';
 /**
  * Run a chain of transformers on a TypeScript .tsx or .d.ts file and return
  * the resulting source file

package/dist/types/astTransformers.d.ts

@@ -1,3 +1,3 @@
-import { CompilerContext } from '../context';
+import { CompilerContext } from '../context/index.ts';
 import { PluginOptions } from 'vite-plugin-dts';
 export declare function runAstDtsTransformers(context: CompilerContext): NonNullable<PluginOptions["resolvers"]>[number];

package/dist/types/hideInternalLitElement.d.ts

@@ -1,4 +1,4 @@
-import { FileTransformer } from '../publicTypes';
+import { FileTransformer } from '../publicTypes.ts';
 /**
  * Modify the .d.ts to make it appear that components extend the
  * PublicLitElement rather than LitElement

package/dist/types/index.d.ts

@@ -1,5 +1,5 @@
 import { Plugin } from 'vite';
-import { CompilerContext } from '../context';
+import { CompilerContext } from '../context/index.ts';
 /**
  * Generate TypeScript definition files for the files in the project.
  * There is a corresponding .d.ts file emitted for each source .ts and .tsx file.

package/dist/types/liftSetterTypes.d.ts

@@ -1,5 +1,5 @@
 import { PropertyDeclaration, default as ts } from 'typescript';
-import { CompilerContext } from '../context';
+import { CompilerContext } from '../context/index.ts';
 export type LiftedSetter = {
     name: ts.PropertyName;
     type: ts.TypeNode;

package/dist/types/textTransformers.d.ts

@@ -1,4 +1,4 @@
-import { CompilerContext } from '../context';
+import { CompilerContext } from '../context/index.ts';
 import { PluginOptions } from 'vite-plugin-dts';
 export declare const runTextDtsTransformers: (context: CompilerContext) => PluginOptions["beforeWriteFile"];
 export declare const isTestFile: (id: string) => boolean;

package/dist/types/transformComponentMembers.d.ts

@@ -1,4 +1,4 @@
-import { FileTransformer } from '../publicTypes';
+import { FileTransformer } from '../publicTypes.ts';
 /**
  * Cleanup public component typings:
  * - Hide all non-property, non-events, non-methods from public typings

package/dist/useLumina.d.ts

@@ -1,4 +1,4 @@
-import { LuminaPlugins, LuminaOptions } from './publicTypes';
+import { LuminaPlugins, LuminaOptions } from './publicTypes.ts';
 /**
  * Auto-configure Vite for a Lit web component project.
  *

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@arcgis/lumina-compiler",
-  "version": "5.0.0-next.1",
+  "version": "5.0.0-next.100",
   "type": "module",
   "main": "dist/index.js",
   "module": "dist/index.js",
@@ -18,11 +18,11 @@
   ],
   "license": "SEE LICENSE IN LICENSE.md",
   "dependencies": {
-    "@arcgis/api-extractor": "5.0.0-next.1",
-    "@arcgis/components-build-utils": "5.0.0-next.1",
-    "@arcgis/toolkit": "~5.0.0-next.1",
+    "@arcgis/api-extractor": "5.0.0-next.100",
+    "@arcgis/components-build-utils": "5.0.0-next.100",
+    "@arcgis/toolkit": "~5.0.0-next.100",
     "chalk": "^5.4.1",
-    "esbuild": "^0.25.5",
+    "esbuild": "^0.25.12",
     "glob": "^11.0.3",
     "js-beautify": "^1.15.4",
     "mime-types": "^3.0.1",
@@ -30,11 +30,11 @@
     "vite-plugin-dts": "^4.5.4"
   },
   "peerDependencies": {
-    "@arcgis/lumina": "~5.0.0-next.1",
+    "@arcgis/lumina": "~5.0.0-next.100",
     "lit": "^3.3.0",
-    "typescript": "~5.8.3",
-    "vite": "^7.0.0",
-    "vitest": "^3.2.4"
+    "typescript": "~5.9.3",
+    "vite": "^7.2.2",
+    "vitest": "^4.0.8"
   },
   "peerDependenciesMeta": {
     "vitest": {

package/dist/extractor/extractor.d.ts

@@ -1,54 +0,0 @@
-import { default as ts } from 'typescript';
-import { ApiExtractor, ApiAttribute, ApiClassMethod, ApiCustomElementDeclaration, ApiCustomElementField, ApiCustomElementMember, ApiDeclaration, ApiEvent, ApiExport, ApiJson, ApiModule, ApiReference, CopyDocDefinitions } from '@arcgis/api-extractor';
-import { CompilerContext } from '../context';
-export declare class LuminaApiExtractor extends ApiExtractor {
-    context: CompilerContext;
-    protected isPathOnly: boolean;
-    constructor(context: CompilerContext, isPathOnly: boolean);
-    protected localCssImports?: Set<string>;
-    protected localDeclaredComponents: Map<string, string>;
-    protected indexedComponents: Map<string, ApiCustomElementDeclaration>;
-    protected apiComponent: ApiCustomElementDeclaration;
-    protected pairedSetter: ts.SetAccessorDeclaration | undefined;
-    protected copyDocDefinitions: CopyDocDefinitions | undefined;
-    extract(files: readonly ts.SourceFile[]): ApiJson;
-    protected extractModules(files: readonly ts.SourceFile[]): ApiModule[];
-    protected extractDeclarations(module: ts.SourceFile): ApiDeclaration[];
-    protected extractDeclaration(statement: ts.Statement): ApiDeclaration | undefined;
-    protected collectCssImports(node: ts.ImportDeclaration): void;
-    protected extractComponentDeclaration(node: ts.ClassDeclaration): ApiCustomElementDeclaration | undefined;
-    protected extractComponentMembers(node: ts.ClassDeclaration): ApiCustomElementMember[];
-    protected extractComponentMember(node: ts.ClassElement, name: string | undefined): ApiCustomElementMember | undefined;
-    protected extractComponentField(node: ts.AccessorDeclaration | ts.PropertyDeclaration, name: string): ApiCustomElementField | undefined;
-    /**
-     * Based on a `non-@property()` property, extract a public event if it is one.
-     */
-    protected extractComponentEvent(node: ts.PropertyDeclaration, name: string): ApiEvent | undefined;
-    /**
-     * When doing full API extraction, extract additional details for a field.
-     */
-    protected extractComponentFieldDetails(node: ts.AccessorDeclaration | ts.PropertyDeclaration, property: ApiCustomElementField): void;
-    static loggedBooleanWarning: boolean;
-    /**
-     * Find the properties given to the `@property()` decorator.
-     */
-    protected findPropertyOptions(member: ts.AccessorDeclaration | ts.PropertyDeclaration): readonly ts.ObjectLiteralElementLike[] | undefined;
-    protected extractComponentMethod(node: ts.MethodDeclaration, name: string): ApiClassMethod | undefined;
-    /**
-     * Infer attributes based on public component members.
-     */
-    protected inferAttributes(members: ApiCustomElementMember[]): ApiAttribute[];
-    protected inferExport(declaration: ApiDeclaration): ApiExport | undefined;
-    protected inferCustomElementExport(declaration: ApiCustomElementDeclaration): ApiExport;
-    /**
-     * Inherit public members from a superclass. For this to work, the superclass
-     * needs to be in a a file named like a component
-     * (src/components/name/name.tsx), even if it is not a standalone component.
-     */
-    protected inheritMembers(component: ApiCustomElementDeclaration, modules: ApiModule[], superClass?: ApiReference, existingMembers?: Set<string>, existingAttributes?: Set<string>, existingEvents?: Set<string>): void;
-    private _resolvedInheritance;
-    /**
-     * Based on the superclass name, find the actual declaration in the modules.
-     */
-    protected resolveInheritance(superClassName: string, modules: ApiModule[]): ApiCustomElementDeclaration | undefined;
-}

package/dist/testing/vitestTypes.d.ts

@@ -1,8 +0,0 @@
-export type VitestBrowserModeProvider = "playwright" | "preview" | "webdriverio" | (string & {}) | undefined;
-export type VitestPartialConfig = {
-    globalSetup?: string[] | string;
-    runner?: string;
-    include?: string[];
-    environment?: "edge-runtime" | "happy-dom" | "jsdom" | "node" | (Record<never, never> & string);
-    forceRerunTriggers?: string[];
-};

package/dist/transformers/internalTypeScriptApis.d.ts

@@ -1,31 +0,0 @@
-import { default as ts } from 'typescript';
-import { TransformResult } from 'vite';
-type SourceMap = Extract<NonNullable<TransformResult["map"]>, {
-    file: string;
-}>;
-export type UndocumentedTypeScript = {
-    readonly createSourceMapGenerator?: (host: ts.CompilerHost, basename: string, sourceRoot: string, dirname: string, compilerOptions: ts.CompilerOptions) => SourceMapGenerator;
-    readonly createTextWriter?: (newLine: string) => EmitTextWriter;
-    readonly getNewLineCharacter?: (options: ts.CompilerOptions) => string;
-    readonly createPrinter: (
-    /**
-     * Printer has undocumented options for printing source maps:
-     * https://github.com/microsoft/TypeScript/blob/7319968e90600102892a79142fb804bcbe384160/src/compiler/types.ts#L9689C18-L9707
-     */
-    options: ts.CompilerOptions & ts.PrinterOptions) => ReturnType<typeof ts.createPrinter> & UndocumentedPrinter;
-};
-type SourceMapGenerator = {
-    readonly toJSON: () => SourceMap;
-};
-type UndocumentedPrinter = {
-    readonly writeFile?: (writeFile: ts.SourceFile, writer: EmitTextWriter, sourceMapGenerator: SourceMapGenerator | undefined) => void;
-    writeNode?(hint: ts.EmitHint, node: ts.TypeNode, sourceFile: undefined, output: EmitTextWriter): void;
-    writeNode?(hint: ts.EmitHint, node: Node, sourceFile: ts.SourceFile, output: EmitTextWriter): void;
-};
-type EmitTextWriter = {
-    readonly getText: () => string;
-    readonly clear: () => void;
-};
-export declare const undocumentedTs: Required<UndocumentedTypeScript>;
-export declare function getPrinter(compilerOptions: ts.CompilerOptions): ReturnType<typeof ts.createPrinter> & UndocumentedPrinter;
-export {};