@arcgis/lumina-compiler 4.34.0-next.16 → 4.34.0-next.161

package/LICENSE.md

@@ -1,6 +1,6 @@
 # Licensing
 
-COPYRIGHT © 2025 Esri
+COPYRIGHT © Esri
 
 All rights reserved under the copyright laws of the United States and applicable international laws, treaties, and conventions.
 

package/README.md

@@ -8,14 +8,6 @@ It is not intended to be used directly, but rather used as a dependency by other
 
 ## License
 
-COPYRIGHT © 2025 Esri
+COPYRIGHT © Esri
 
-All rights reserved under the copyright laws of the United States and applicable international laws, treaties, and conventions.
-
-This material is licensed for use under the Esri Master License Agreement (MLA), and is bound by the terms of that agreement. You may redistribute and use this code without modification, provided you adhere to the terms of the MLA and include this copyright notice.
-
-See use restrictions at <http://www.esri.com/legal/pdfs/mla_e204_e300/english>
-
-For additional information, contact: Environmental Systems Research Institute, Inc. Attn: Contracts and Legal Services Department 380 New York Street Redlands, California, USA 92373 USA
-
-email: contracts@esri.com
+This package is licensed under the terms described in the `LICENSE.md` file, located in the root of the package.

package/dist/context/index.d.ts

@@ -11,7 +11,7 @@ import { CustomElementInterdependencies } from '../entrypoints/config';
 import { getCompilerOptionsForPrinter } from '../transformers';
 import { getPrinter } from '../transformers/internalTypeScriptApis';
 import { getLocalDefinedComponentsFromApiJson } from '../entrypoints/resolveTagName';
-import { Deferred } from '@arcgis/components-utils';
+import { Deferred } from '@arcgis/toolkit/promise';
 export declare class CompilerContext {
     /**
      * The path to the resolved TypeScript configuration
@@ -105,6 +105,15 @@ export declare class CompilerContext {
      * JSDoc tag.
      */
     privateApiJson: ApiJson;
+    /**
+     * Resolves once api.json is first generated.
+     * @private
+     */
+    readonly apiJsonDeferred: Deferred<void>;
+    /**
+     * In some test environments, api.json will never be produced.
+     */
+    apiJsonEnabled: boolean;
     /**
      * @private
      */
@@ -267,7 +276,8 @@ export declare class CompilerContext {
      */
     _globalHydratedCssString: string;
     /**
-     * Contents of the bundled global CSS file
+     * Contents of the bundled global CSS file. The string is JSON-encoded so that
+     * it can be injected into a JavaScript file as a string literal.
      *
      * @private
      */

package/dist/dependencies/arcgisCore.d.ts

@@ -27,4 +27,4 @@ export declare const hasCore: boolean;
  * - for external users, having both storybook and docs use the ESM CDN means
  *   they benefit from caching the ESM CDN across both sites
  */
-export declare function produceArcgisCoreTags(baseUrl: string, mode: DependencyInjectionMode): Promise<DependencyInjectionResult[]>;
+export declare function produceArcgisCoreTags(baseUrl: string, mode: DependencyInjectionMode, preferNext: boolean): Promise<DependencyInjectionResult[]>;

package/dist/dependencies/discover.d.ts

@@ -1,11 +1,15 @@
+import { MiniPackageJson } from '@arcgis/components-build-utils';
 import { ModulePath } from '../extractor/helpers/resolveType';
 import { WebTypes } from '../docs/webTypes/types';
 import { ApiJson } from '@arcgis/api-extractor';
+import { LuminaOptions } from '../publicTypes';
 export type ResolvedDependencyComponents = {
     readonly packageName: string;
     readonly type: "@arcgis/lumina" | "stencil" | "unknown";
     readonly components: Readonly<Record<string, ResolvedDependencyComponent>>;
     readonly cdnUrl?: string;
+    readonly packageLocation: string;
+    readonly packageJson: MiniPackageJson;
 };
 export type ResolvedDependencyComponent = ModulePath & {
     /**
@@ -15,6 +19,7 @@ export type ResolvedDependencyComponent = ModulePath & {
      * big deal as we will then play safe and leave jsx properties as properties.
      */
     readonly propToAttribute: Readonly<Record<string, string>>;
+    requiredProperties?: Set<string>;
 };
 /**
  * Read information about our web component dependencies. This will be used to:
@@ -45,7 +50,7 @@ export type ResolvedDependencyComponent = ModulePath & {
  * If this does not work for one of your dependencies, provide a custom resolver
  * to autoAddImports() or useLumina().
  */
-export declare function initializeComponentDependencies(cwd?: string): Promise<readonly ResolvedDependencyComponents[]>;
+export declare function initializeComponentDependencies(cwd?: string, options?: LuminaOptions): Promise<readonly ResolvedDependencyComponents[]>;
 export declare function retrieveComponentDependencies(): readonly ResolvedDependencyComponents[];
 export declare function retrieveFlatComponentDependencies(): ResolvedDependencyComponents["components"];
 export declare let componentDependenciesPromise: Promise<readonly ResolvedDependencyComponents[]> | undefined;
@@ -55,7 +60,7 @@ export declare function findPackageComponents(packageName: string, cwd?: string)
  */
 export declare function manifestToDependencyComponents(manifest: Partial<ApiJson>, dependency: Omit<ModulePath, "moduleName"> & {
     readonly getImportPath: (tagName: string) => string;
-}): ResolvedDependencyComponents["components"];
+}, computeRequiredProperties?: boolean): ResolvedDependencyComponents["components"];
 export declare const webTypesToDependencyComponents: (webTypes: Partial<WebTypes>, dependency: Omit<ModulePath, "moduleName"> & {
     readonly packageRoot: string | undefined;
     readonly getImportPath: (tagName: string) => string;

package/dist/dependencies/lumina.d.ts

@@ -1,3 +1,3 @@
 import { DependencyInjectionMode, DependencyInjectionResult } from './utils';
 import { ResolvedDependencyComponents } from './discover';
-export declare function makeLuminaLoader(baseUrl: string, dependency: ResolvedDependencyComponents, mode: DependencyInjectionMode, index: number): Promise<DependencyInjectionResult>;
+export declare function makeLuminaLoader(baseUrl: string, dependency: ResolvedDependencyComponents, mode: DependencyInjectionMode, index: number, preferNext: boolean): Promise<DependencyInjectionResult>;

package/dist/dependencies/stencil.d.ts

@@ -1,7 +1,7 @@
 import { DependencyInjectionMode, DependencyInjectionResult } from './utils';
 import { ResolvedDependencyComponents } from './discover';
-export declare function makeStencilLoader(baseUrl: string, dependency: ResolvedDependencyComponents, mode: DependencyInjectionMode, index: number): Promise<DependencyInjectionResult[]>;
-export declare function findCdnFiles(distDirectory: string): Promise<{
+export declare function makeStencilLoader(baseUrl: string, dependency: ResolvedDependencyComponents, mode: DependencyInjectionMode, index: number, preferNext: boolean): Promise<DependencyInjectionResult[]>;
+export declare function findCdnFiles(packageDirectory: string): Promise<{
     readonly cdnName: string;
     readonly hasCss: boolean;
 } | undefined>;

package/dist/dependencies/testSetupFiles.d.ts

@@ -1,5 +1,6 @@
 import { CompilerContext } from '../context';
 export declare const testSetupFileName = "/@arcgis/lumina-compiler/testSetupFile";
+export declare const testSetupFileRegex: RegExp;
 export declare const testSetupFileNames: string[];
 /**
  * Get the entrypoint code for lazy-loading all components and their

package/dist/dependencies/updateLumina.d.ts

@@ -1,7 +1,7 @@
 import { ResolvedDependencyComponents } from './discover';
-import { BrowserConfigOptions } from 'vitest/node';
-export declare function updateLuminaTs(dependencies: readonly ResolvedDependencyComponents[], srcDir: string, hasCore: boolean, browserProvider?: BrowserConfigOptions["provider"], packageJson?: import('@arcgis/components-build-utils').MiniPackageJson): Promise<boolean>;
-declare function produceLuminaTs(dependencies: readonly ResolvedDependencyComponents[], hasCore: boolean, browserProvider?: BrowserConfigOptions["provider"], packageJson?: import('@arcgis/components-build-utils').MiniPackageJson): string;
+import { VitestBrowserModeProvider } from '../testing/vitestTypes';
+export declare function updateLuminaTs(dependencies: readonly ResolvedDependencyComponents[], srcDir: string, hasCore: boolean, browserProvider?: VitestBrowserModeProvider, packageJson?: import('@arcgis/components-build-utils').MiniPackageJson): Promise<boolean>;
+declare function produceLuminaTs(dependencies: readonly ResolvedDependencyComponents[], hasCore: boolean, browserProvider?: VitestBrowserModeProvider, packageJson?: import('@arcgis/components-build-utils').MiniPackageJson): string;
 export declare const exportsForTests: {
     produceLuminaTs: typeof produceLuminaTs;
 };

package/dist/entrypoints/resolveTagName.d.ts

@@ -5,9 +5,9 @@ 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 function getLocalDefinedComponentsFromApiJson(context: Pick<CompilerContext, "_localDefinedComponents" | "privateApiJson" | "viteCommand">): Readonly<Record<string, ResolvedDependencyComponent>>;
 export declare const exportsForTests: {
     modulePathToString: typeof modulePathToString;
 };

package/dist/frameworkTypes/preact.d.ts

@@ -2,5 +2,6 @@ import { ApiCustomElementDeclaration } from '@arcgis/api-extractor';
 /**
  * @see https://github.com/preactjs/preact/issues/1180#issuecomment-643681851
  * @see https://github.com/preactjs/preact/pull/1448/files
+ * @see https://github.com/esri/calcite-design-system/issues/9494
  */
 export declare function generatePreactTypes(components: ApiCustomElementDeclaration[]): string;

package/dist/frameworkTypes/preact10.d.ts

@@ -0,0 +1,10 @@
+import { ApiCustomElementDeclaration } from '@arcgis/api-extractor';
+/**
+ * Typings for Preact 10 and earlier.
+ * Preact 11 had a breaking change requiring separate typings.
+ *
+ * @see https://github.com/preactjs/preact/issues/4903
+ * @deprecated These are exposed for internal consumption only. Drop once Home App
+ * updates to Preact 11.
+ */
+export declare function generatePreact10Types(components: ApiCustomElementDeclaration[]): string;