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

package/dist/jsxToLitHtml/autoAddNothing.d.ts

@@ -1,5 +1,5 @@
-import type { TemplatePart } from "./templateParts";
-import { type JsxContext } from "./types";
+import { TemplatePart } from './templateParts';
+import { JsxContext } from './types';
 /**
  * If JSX prop value could possibly be `undefined`, we add `?? nothing` to it.
  *

package/dist/jsxToLitHtml/comments.d.ts

@@ -1,10 +1,10 @@
-import ts from "typescript";
-import type { JsxContext } from "./types";
-import type { TemplatePart } from "./templateParts";
+import { default as ts } from 'typescript';
+import { JsxContext } from './types';
+import { TemplatePart } from './templateParts';
 /**
  * Extract comments and whitespace from a node (called "trivia" in TypeScript)
  */
-export declare const getNodeTrivia: (node: ts.Node, context: JsxContext) => string;
+export declare const getNodeTrivia: (node: ts.Node, context: Pick<JsxContext, "sourceFile">) => string;
 /**
  * Attach trivia comments to a node.
  *

package/dist/jsxToLitHtml/config.d.ts

@@ -36,7 +36,7 @@ export declare const nativeAlwaysAttributes: Set<string>;
  * These don't exist as a property, only as an attribute.
  * Or, the property is read-only, but the attribute is not.
  */
-export declare const htmlAlwaysAttributes: Record<string, Set<string>>;
+export declare const htmlAlwaysAttributes: Record<string, Set<string> | undefined>;
 /**
  * The mappings between native DOM property and the equivalent attribute it
  * reflects to.

package/dist/jsxToLitHtml/convertProps.d.ts

@@ -1,9 +1,8 @@
-import ts from "typescript";
-import type { TemplatePart } from "./templateParts";
-import type { JsxContext } from "./types";
-import type { JsxPropType } from "./inferPropType";
-import { dynamicHtmlSymbol } from "./config";
-import { type dynamicSvgSymbol } from "./config";
+import { default as ts } from 'typescript';
+import { TemplatePart } from './templateParts';
+import { JsxContext } from './types';
+import { JsxPropType } from './inferPropType';
+import { dynamicHtmlSymbol, dynamicSvgSymbol } from './config';
 /**
  * Handle the conversion for each JSX prop type
  */

package/dist/jsxToLitHtml/imports.d.ts

@@ -1,6 +1,5 @@
-import ts from "typescript";
-import { type JsxContext } from "./types";
-export declare const dynamicallyInsertedImportPaths: Set<string>;
+import { default as ts } from 'typescript';
+import { JsxContext } from './types';
 /**
  * This runs before we know what imports will be needed.
  *

package/dist/jsxToLitHtml/index.d.ts

@@ -1,4 +1,4 @@
-import type { FileTransformer } from "../publicTypes";
+import { FileTransformer } from '../publicTypes';
 /**
  * Let developers author components in JSX for better type checking and developer
  * experience, but convert JSX to lit-html at build time for better performance.

package/dist/jsxToLitHtml/inferPropType.d.ts

@@ -1,5 +1,5 @@
-import ts from "typescript";
-import { dynamicHtmlSymbol, dynamicSvgSymbol } from "./config";
+import { default as ts } from 'typescript';
+import { dynamicHtmlSymbol, dynamicSvgSymbol } from './config';
 /**
  * Check if prop initializer has bindProperty(), bindAttribute(),
  * bindBooleanAttribute() or bindEvent() call - these explicitly indicate the
@@ -34,7 +34,7 @@ export declare function checkExplicitPropType(initializer: ts.JsxAttributeValue
  * explicitly want to overwrite the below prop type inference logic.
  */
 export declare function inferPropType(propName: string, initializer: ts.JsxAttributeValue | undefined, tagName: string | typeof dynamicHtmlSymbol | typeof dynamicSvgSymbol): JsxPropType;
-declare const specialPropsArray: readonly ["class", "style", "ref", "directives", "key"];
+declare const specialPropsArray: readonly ["class", "style", "ref", "directives", "key", "deferLoad"];
 type SpecialProp = (typeof specialPropsArray)[number];
 export type JsxPropType = SpecialProp | "attribute" | "booleanAttribute" | "event" | "property";
 export {};

package/dist/jsxToLitHtml/insertRepeatCall.d.ts

@@ -1,5 +1,5 @@
-import ts from "typescript";
-import type { JsxContext } from "./types";
+import { default as ts } from 'typescript';
+import { JsxContext } from './types';
 /**
  * By default, when we see a `key=""` prop, we convert it like this:
  * ```tsx

package/dist/jsxToLitHtml/jsxVisitor.d.ts

@@ -1,7 +1,6 @@
-import ts from "typescript";
-import type { TemplatePart } from "./templateParts";
-import type { JsxHost } from "./types";
-import { type JsxContext } from "./types";
+import { default as ts } from 'typescript';
+import { TemplatePart } from './templateParts';
+import { JsxHost, JsxContext } from './types';
 /**
  * Recursively traverse the entire AST top-down, converting JSX to lit-html.
  */

package/dist/jsxToLitHtml/templateParts.d.ts

@@ -1,5 +1,5 @@
-import ts from "typescript";
-import { type JsxContext, type LitTag, type ambiguousSvgTag } from "./types";
+import { default as ts } from 'typescript';
+import { JsxContext, LitTag, ambiguousSvgTag } from './types';
 /**
  * Template part is a convenient intermediate representation for template
  * literal expressions.

package/dist/jsxToLitHtml/throwOnImportingExternalized.d.ts

@@ -1,4 +1,4 @@
-import type { JsxContext } from "./types";
+import { JsxContext } from './types';
 /**
  * Throw if encountered an explicit non-type-only import for a Calcite component
  * or some `@arcgis/*` component package - such packages should be externalized,

package/dist/jsxToLitHtml/types.d.ts

@@ -1,6 +1,6 @@
-import ts from "typescript";
-import type { ResolvedDependencyComponents } from "../dependencies/discover";
-import type { CompilerContext } from "../context";
+import { default as ts } from 'typescript';
+import { ResolvedDependencyComponents } from '../dependencies/discover';
+import { CompilerContext } from '../context';
 export type JsxContext = {
     readonly compiler: CompilerContext;
     /** Source file before the _JSX to lit-html_ transformation */
@@ -16,6 +16,7 @@ export type JsxContext = {
      * remove it from the map to not confuse any following resolvers.
      */
     readonly customElementsToImport: Set<string>;
+    readonly customElementsToImportDeferred: Set<string>;
     /**
      * Existing imported modules.
      *
@@ -64,7 +65,7 @@ export declare const mathMlTag = "mathml";
 declare const litTagsArray: readonly ["css", "html", "mathml", "staticHtml", "staticSvg", "svg"];
 export declare const litTags: Set<"html" | "css" | "mathml" | "staticHtml" | "staticSvg" | "svg">;
 export type LitTag = (typeof litTagsArray)[number];
-export declare const jsxImportNames: readonly ["keyed", "ref", "repeat", "live", "css", "html", "mathml", "staticHtml", "staticSvg", "svg", "safeClassMap", "safeStyleMap", "nothing"];
+export declare const jsxImportNames: readonly ["keyed", "ref", "repeat", "live", "css", "html", "mathml", "staticHtml", "staticSvg", "svg", "safeClassMap", "safeStyleMap", "deferLoad", "nothing"];
 export type JsxImportName = (typeof jsxImportNames)[number];
 export type JsxHost = ts.JsxElement | ts.JsxFragment | ts.JsxSelfClosingElement;
 export declare const isJsxHost: (node: ts.Node) => node is JsxHost;

package/dist/jsxToLitHtml/utils.d.ts

@@ -11,3 +11,4 @@ export declare function safeTrimText(text: string): string;
 export declare const escapeForTemplateLiteral: (string: string) => string;
 export declare const shouldQuoteAttributeValue: (value: string) => boolean;
 export declare const escapeForHtml: (string: string) => string;
+export declare const isCustomElement: (tagName: string | symbol) => tagName is string;

package/dist/loader/hideUntilHydrated.d.ts

@@ -1,4 +1,4 @@
-import type { CompilerContext } from "../context";
+import { CompilerContext } from '../context';
 export declare function addGlobalCss(context: CompilerContext): string;
 export declare const defaultHydratedAttribute = "hydrated";
 /**

package/dist/loader/index.d.ts

@@ -1,5 +1,5 @@
-import type { Plugin as VitePlugin } from "vite";
-import type { CompilerContext } from "../context";
+import { Plugin as VitePlugin } from 'vite';
+import { CompilerContext } from '../context';
 /**
  * Generate virtual files:
  * - loader.ts (for lazy loading components)

package/dist/loader/lazy.d.ts

@@ -1,6 +1,6 @@
-import type { CompilerContext } from "../context";
-import type { HmrComponentMeta } from "@arcgis/lumina/hmrSupport";
-import type { ApiCustomElementDeclaration } from "@arcgis/api-extractor";
+import { CompilerContext } from '../context';
+import { HmrComponentMeta } from '@arcgis/lumina/hmrSupport';
+import { ApiCustomElementDeclaration } from '@arcgis/api-extractor';
 /**
  * To power bundle splitting for lazy loadable components, as well as to support
  * calling async methods before the component loaded, and to ensure frameworks

package/dist/loader/storybookApiJson.d.ts

@@ -1,4 +1,4 @@
-import type { ApiJson } from "@arcgis/api-extractor";
+import { ApiJson } from '@arcgis/api-extractor';
 /**
  * Providing api.json to Storybook.
  * See https://github.com/storybookjs/storybook/tree/next/code/addons/docs/web-components

package/dist/logger-KpGU2b3R.js

@@ -0,0 +1,28 @@
+import { toSystemPathSeparators as i, path as c } from "@arcgis/components-build-utils";
+import a from "chalk";
+import { createLogger as g } from "vite";
+let n = g(), s = process.cwd();
+function e(r, o, t) {
+  return typeof t == "string" ? (t = t.startsWith(s) ? i(c.relative(s, t)) : t, t = `${t}: `) : t = "", `${r} ${t}${o}`;
+}
+const f = {
+  initialize(r, o) {
+    n = r, s = o;
+  },
+  info(r, o, t) {
+    n.info(e(a.cyan(`[${r}]`), o, t));
+  },
+  warn(r, o, t) {
+    n.warn(e(a.yellow(`[${r}]`), o, t));
+  },
+  error(r, o, t) {
+    n.error(e(a.red(`[${r}]`), o, t)), process.exitCode = 1;
+  }
+};
+function u(r, o, t) {
+  return o instanceof Error ? (o.message = e(r, o.message, t), o) : e(a.red(`[${r}]`), o, t);
+}
+export {
+  u as f,
+  f as l
+};

package/dist/plugins/buildCdn.d.ts

@@ -1,21 +1,71 @@
-import type { Plugin } from "vite";
-import type { CompilerContext } from "../context";
+import { Plugin } from 'vite';
+import { CompilerContext } from '../context';
+import { CdnChunk } from '../publicTypes';
 /**
  * Restricted due to collisions with Lumina's dist/ folder names or
  * Stencil's dist/ folder names
  */
 export declare const restrictedNamespaceNames: Set<string>;
 export declare const defaultNamespace = "cdn";
+export declare const defaultEntryJsName = "index";
+export declare const globalCssName = "main";
 /**
  * CDN build works by reading the lazy NPM build and bundling-in all used
  * dependencies (except for imports of web components from dependencies - those
  * are assumed to be defined in the environment separately)
  */
 export declare function buildCdn(context: CompilerContext): Plugin | undefined;
-declare function transformAsyncCoreImports(code: string): string;
-declare function transformSyncCoreImports(code: string): string;
+export declare function buildLoaderCode(runtimeVariableName: string, customEntrypoints: {
+    in: string;
+    out: string;
+}[]): string;
+/**
+ * Transform each core-importing chunk to use $arcgis.t for loading core in
+ * order to be both ESM and AMD CDN compatible.
+ *
+ * Previous solution
+ * (https://devtopia.esri.com/WebGIS/arcgis-web-components/pull/2995) relied on
+ * top-level await. However, due to a Safari bug
+ * (see https://devtopia.esri.com/WebGIS/arcgis-web-components/issues/3933
+ * and https://bugs.webkit.org/show_bug.cgi?id=242740), we are no longer using
+ * top-level await.
+ *
+ * Instead, we insert a top-level await polyfill - any module that imports core
+ * directly or indirectly is transformed to have a promise as a default export -
+ * such promise, once awaited, yields the actual exports of the module.
+ *
+ * List of other solutions considered:
+ * https://devtopia.esri.com/WebGIS/arcgis-web-components/discussions/3999
+ *
+ * @example
+ * ```js
+ * /// BEFORE
+ * import { b } from "./U7MU7PMX.js";
+ * import { when as M } from "@arcgis/core/core/reactiveUtils.js";
+ * var s = class extends v {
+ *   // ...
+ * };
+ * export { s as ArcgisNavigationToggle };
+ *
+ * /// AFTER
+ * import a from "./U7MU7PMX.js";
+ * export default $arcgis.t(
+ *   ([{ when: M }, { b }]) => {
+ *     // The "meat" of the file is kept unchanged by the transform
+ *     // (we only touch the imports, and the very last export line)
+ *       s = class extends v {
+ *         // ...
+ *       };
+ *     // Resolve the promise by returning the exported class
+ *     return s;
+ *   },
+ *   "core/reactiveUtils",
+ *   a,
+ * );
+ * ```
+ */
+declare function transformChunk(chunk: CdnChunk, chunks: Map<string, CdnChunk>): void;
 export declare const exportsForTests: {
-    transformAsyncCoreImports: typeof transformAsyncCoreImports;
-    transformSyncCoreImports: typeof transformSyncCoreImports;
+    transformChunk: typeof transformChunk;
 };
 export {};

package/dist/plugins/buildStencilHydrate.d.ts

@@ -1,5 +1,5 @@
-import type { Plugin } from "vite";
-import type { CompilerContext } from "../context";
+import { Plugin } from 'vite';
+import { CompilerContext } from '../context';
 /**
  * Emit output compatible with Stencil's dist-hydrate-script build.
  *

package/dist/plugins/buildWebApp.d.ts

@@ -0,0 +1,3 @@
+import { CompilerContext } from '../context';
+/** @deprecated */
+export declare function buildWebApp(context: CompilerContext, rawDestination: string, cdnEntryName: string): Promise<void>;

package/dist/plugins/buildWrappers.d.ts

@@ -1,3 +1,3 @@
-import type { Plugin } from "vite";
-import type { CompilerContext } from "../context";
+import { Plugin } from 'vite';
+import { CompilerContext } from '../context';
 export declare function buildWrappers(context: CompilerContext): Plugin;

package/dist/plugins/configureVite.d.ts

@@ -1,9 +1,9 @@
-import type { Plugin } from "vite";
-import type { CompilerContext } from "../context";
-import type { PuppeteerLaunchOptions } from "puppeteer";
-import type { InlineConfig } from "vitest/node";
+import { Plugin } from 'vite';
+import { CompilerContext } from '../context';
+import { InlineConfig } from 'vitest/node';
+import { PuppeteerTestingOptions } from '../publicTypes';
 export type PuppeteerVitestConfigOptions = InlineConfig & {
-    puppeteerLaunchOptions?: PuppeteerLaunchOptions;
+    puppeteerLaunchOptions?: PuppeteerTestingOptions["launchOptions"];
     puppeteerWaitForChangesDelay?: number;
 };
 /**

package/dist/plugins/externalizeDependencies.d.ts

@@ -1,6 +1,5 @@
-import type { Plugin } from "vite";
-import type { Nil } from "@arcgis/components-utils";
-import type { CompilerContext } from "../context";
+import { Plugin } from 'vite';
+import { CompilerContext } from '../context';
 /**
  * By default, Rollup will bundle-in all dependencies.
  *
@@ -29,6 +28,3 @@ import type { CompilerContext } from "../context";
  * be externalized (because all peerDependencies are externalized).
  */
 export declare function externalizeDependencies(context: CompilerContext): Plugin;
-export declare const exportsForTests: {
-    normalizeGlobs: (option: Nil | RegExp | string | false) => RegExp | undefined;
-};

package/dist/plugins/handleDynamicAssets.d.ts

@@ -1,3 +1,3 @@
-import type { Plugin } from "vite";
-import type { CompilerContext } from "../context";
+import { Plugin } from 'vite';
+import { CompilerContext } from '../context';
 export declare const handleDynamicAssets: (context: CompilerContext) => Plugin;

package/dist/plugins/handleStaticAssets.d.ts

@@ -1,5 +1,5 @@
-import type { Plugin } from "vite";
-import type { CompilerContext } from "../context";
+import { Plugin } from 'vite';
+import { CompilerContext } from '../context';
 /**
  * This is similar to Stencil's assets hosting, but to improve DX, the assets
  * belonging to each component are moved into a folder named after the component

package/dist/plugins/loadLitCss.d.ts

@@ -1,9 +1,5 @@
-/**
- * This file has a companion `@arcgis/lumina/typings/loadLitCss.d.ts`. Edits
- * to this file may need to be reflected there too
- */
-import type { Plugin } from "vite";
-import type { CompilerContext } from "../context";
+import { Plugin } from 'vite';
+import { CompilerContext } from '../context';
 export declare const cssLangsRe: RegExp;
 /**
  * The `.adoptedStyleSheets` API is very convenient, but it has one issue: it

package/dist/plugins/printTotalBuildSize.d.ts

@@ -1,5 +1,5 @@
-import type { Plugin } from "vite";
-import type { CompilerContext } from "../context";
+import { Plugin } from 'vite';
+import { CompilerContext } from '../context';
 /**
  * Augmenting vite's default reporter to not just report bundle sizes, but to
  * also print the total size

package/dist/plugins/provideAssets.d.ts

@@ -1,23 +1,6 @@
-/**
- * Utilities for making Vite copy assets to the output folder during build or
- * serve them when in serve mode
- *
- * This is similar to Vite's public directory, except that you can provide
- * multiple directories and re-map the path at which the files are served.
- *
- * @remarks
- * The functionality is similar to
- * https://github.com/nguyenbatranvan/vite-multiple-assets/blob/main/packages/libs/index.ts
- *
- * But with improvements:
- * - support scoping assets
- * - copy files in parallel rather than sequentially
- * - greater type safety and uses modern Node.js features
- * - transform the assets (i.e minify JSON)
- */
-import type { CompilerContext } from "../context";
-import type { AssetSpec, AssetTransformer } from "../publicTypes";
-import type { ContextDirectories } from "../context/types";
+import { CompilerContext } from '../context';
+import { AssetSpec, AssetTransformer } from '../publicTypes';
+import { ContextDirectories } from '../context/types';
 export declare function serveAssets(context: CompilerContext, assets: AssetSpec[], transformers?: AssetTransformer[]): void;
 export declare function writeAssets(context: CompilerContext, assets: AssetSpec[], transformers?: AssetTransformer[]): Promise<void>;
 /**

package/dist/plugins/setAssetsPath.d.ts

@@ -1,5 +1,5 @@
-import type { Plugin } from "vite";
-import type { CompilerContext } from "../context";
+import { Plugin } from 'vite';
+import { CompilerContext } from '../context';
 /**
  * Plugin to set the base URL for assets in the package
  *

package/dist/plugins/updatePackageJson.d.ts

@@ -1,8 +1,8 @@
-import type { MiniPackageJson } from "@arcgis/components-build-utils";
-import type { CompilerContext } from "../context";
-import type { Plugin } from "vite";
+import { MiniPackageJson } from '@arcgis/components-build-utils';
+import { CompilerContext } from '../context';
+import { Plugin } from 'vite';
 export declare const updatePackageJson: (context: CompilerContext) => Plugin;
-declare function doPackageJsonUpdate(packageJson: MiniPackageJson, context: Pick<CompilerContext, "_documentationFileNames" | "dir">): MiniPackageJson | undefined;
+declare function doPackageJsonUpdate(packageJson: MiniPackageJson, context: Pick<CompilerContext, "_documentationFileNames" | "dir" | "options">): MiniPackageJson | undefined;
 export declare const exportsForTests: {
     doPackageJsonUpdate: typeof doPackageJsonUpdate;
 };