@arcgis/lumina-compiler 4.34.0-next.12 → 4.34.0-next.121

package/dist/jsxToLitHtml/importsConfig.d.ts

@@ -0,0 +1,10 @@
+import { JsxImportName } from './types';
+/**
+ * Most Lit API's are re-exported from multiple packages. Because only Lit
+ * package is declared as an explicit dependency, Lumina's auto-inserted imports
+ * should only import from the Lit package (from the first import path in the
+ * lists below). However, to avoid double-importing things if the file already
+ * imports these APIs from another package, we need to check for all the places
+ * that export these APIs (the 2nd+ items in the lists below).
+ */
+export declare const dynamicallyInsertedImportsByName: Record<JsxImportName, string[]>;

package/dist/jsxToLitHtml/types.d.ts

@@ -63,10 +63,12 @@ export declare const ambiguousSvgTag: unique symbol;
 export declare const cssTag = "css";
 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 declare const litTags: Set<"html" | "svg" | "css" | "mathml" | "staticHtml" | "staticSvg">;
 export type LitTag = (typeof litTagsArray)[number];
-export declare const jsxImportNames: readonly ["keyed", "ref", "repeat", "live", "css", "html", "mathml", "staticHtml", "staticSvg", "svg", "safeClassMap", "safeStyleMap", "deferLoad", "nothing"];
+export declare const jsxImportNames: readonly ["keyed", "ref", "repeat", "live", "css", "html", "mathml", "staticHtml", "staticSvg", "svg", "safeClassMap", "safeStyleMap", "deferLoad", "stabilizedRef", "nothing"];
 export type JsxImportName = (typeof jsxImportNames)[number];
 export type JsxHost = ts.JsxElement | ts.JsxFragment | ts.JsxSelfClosingElement;
+/** Returns `true` if the given node is an array expression containing jsx nodes */
+export declare const isJsxArray: (node: ts.Node) => node is ts.ArrayLiteralExpression;
 export declare const isJsxHost: (node: ts.Node) => node is JsxHost;
 export {};

package/dist/loader/{hideUntilHydrated.d.ts → css.d.ts}

@@ -9,7 +9,12 @@ export declare const defaultHydratedAttribute = "hydrated";
  * @see https://discord.com/channels/1012791295170859069/1274527043614150708
  */
 export declare function getGlobalCssInjectionCode(globalCssString: string | undefined, context: CompilerContext): string;
-/**
+/**a
  * Get a CSS string that can be printed into a .css file
+ *
+ * Global CSS is auto-imported by bundlers. To ensure it is always loaded with
+ * lower precedence order than user styles, we wrap it in `@layer{}`.
+ *
+ * @see https://devtopia.esri.com/WebGIS/arcgis-web-components/discussions/1824#discussioncomment-12625
  */
 export declare const getGlobalCssAsString: (context: CompilerContext) => string;

package/dist/plugins/buildCdn.d.ts

@@ -65,7 +65,13 @@ export declare function buildLoaderCode(runtimeVariableName: string, customEntry
  * ```
  */
 declare function transformChunk(chunk: CdnChunk, chunks: Map<string, CdnChunk>): void;
+/**
+ * Given set of identifiers, produce the shortest possible ASCII-only identifier.
+ * We restrict to ASCII-range as it is faster to parse for engines.
+ */
+declare function createIdentifierGenerator(seen: Set<string>): () => string;
 export declare const exportsForTests: {
     transformChunk: typeof transformChunk;
+    createIdentifierGenerator: typeof createIdentifierGenerator;
 };
 export {};

package/dist/plugins/loadLitCss.d.ts

@@ -1,6 +1,22 @@
 import { Plugin } from 'vite';
 import { CompilerContext } from '../context';
+/**
+ * CSS extension list taken from https://github.com/vitejs/vite/blob/a8c7083a3d7d7fe2e83e994ff008f39ee4f298f8/packages/vite/src/node/constants.ts#L50
+ */
 export declare const cssLangsRe: RegExp;
+/**
+ * A flag added by Lumina at compile time to named CSS imports to turn
+ * them into Lit css`` tagged template literals (using `styles` named import).
+ *
+ * We do not automatically process every CSS file to allow for both:
+ * - keeping side-effect CSS imports inside external library code as is
+ *   - tricky to do using resolveId() because ESBuild is used for some files in
+ *     dev server.
+ * - explicitly importing external library's CSS as Lit css into shadow root
+ *   - example: monaco or ckeditor styles, but attached into shadow root, rather
+ *     than global
+ */
+export declare const litCssFlag = "?litCss";
 /**
  * The `.adoptedStyleSheets` API is very convenient, but it has one issue: it
  * has higher precedence order than the `<link>` or `<style>` tags. This API was
@@ -12,18 +28,42 @@ export declare const cssLangsRe: RegExp;
  * More information:
  * https://discord.com/channels/1012791295170859069/1274527043614150708
  */
-export declare const layeredCssFlag = "?layered";
+export declare const layeredLitCssFlag = "?layeredLitCss";
 /**
- * During build, we insert a side-effect import into the loader.ts file purely
- * so that the transform() is triggered for that file so that we can piggy back
- * on the transformed output (and create a separate .css file out of it). We do
- * not intend for such file to be included in the JS bundle in the NPM build.
- * Such import will be dropped by the minifier.
- *
- * It's a bit hacky, but that is needed to workaround this Vite behavior:
- * https://github.com/vitejs/vite/pull/11469#:~:text=Further%2C%20this.load%20is%20supposed%20to%20trigger%20transform%20and%20moduleParsed%20%2D%20this%20does%20not%20(in%20accordance%20with%20vite%27s%20on%2Ddemand%20nature
+ * Vite's library mode has CSS support (https://vite.dev/guide/build.html#css-support).
+ * However, if global css file references assets, the library mode will insert
+ * the assets base path in the CSS file. This does not work for us since the
+ * asset path is determined at runtime - provided by the user.
+ *
+ * Additionally, Vite's library mode css handling does not quite fit our use case:
+ * - We need to transform the global CSS to add hydrate CSS
+ *   - Trickier given that we need to emit hydrate CSS even if user did not
+ *     provide global css
+ * - Vite has css chunking support, which we don't need
+ * - We need to add an import for our CSS file (and those of libraries we are
+ *   consuming) in runtime.ts, without processing the external CSS files
+ *
+ * It is possible to make Vite's library mode css work, but requires too much
+ * effort. Instead, we are bypassing Vite's global CSS handling and doing the
+ * simple handling sufficient for our single global css file:
+ * - During build, we insert a import into the loader.ts file purely
+ *   so that the transform() is triggered for that file so that we can piggy back
+ *   on the transformed output (and create a separate .css file out of it).
+ *   Such import has no side-effects and is removed by Rollup.
+ *
+ *   This is the only way to trigger the CSS transform without getting it added
+ *   to the bundle because of this Vite behavior:
+ *   https://github.com/vitejs/vite/pull/11469#:~:text=Further%2C%20this.load%20is%20supposed%20to%20trigger%20transform%20and%20moduleParsed%20%2D%20this%20does%20not%20(in%20accordance%20with%20vite%27s%20on%2Ddemand%20nature
+ * - We manually write dist/main.css based on hydrate CSS and global CSS.
+ * - During generateBundle() stage, we transform the emitted chunks/runtime.js
+ *   to add the import to global CSS for our library and web component libraries
+ *   we are consuming. We do this in generateBundle() stage so that such imports
+ *   are not processed by bundler. Additionally, our loadLitCss plugin's
+ *   transform() has a detection of side-effect CSS imports to error for them
+ *   saying they should be import as named to be added to the shadow root - by
+ *   doing this in generateBundle(), we bypass that check.
  */
-export declare const globalCssFlag = "?global";
+export declare const globalCssFileFlag = "?globalFileLitCss";
 /**
  * Given a CSS file like:
  *
@@ -56,7 +96,7 @@ export declare const globalCssFlag = "?global";
  *
  * Then, we augment it into this:
  * ```js
- * import { css } from '@lit/reactive-element/css-tag.js';
+ * import { css } from 'lit/css-tag.js';
  * const styles = css`:host{display:flex;gap:1rem}button{padding:1rem}`;
  * export default styles;
  * ```
@@ -84,3 +124,4 @@ export declare const globalCssFlag = "?global";
  * will be inlined as base64 to simplify our life.
  */
 export declare const loadLitCss: (context: CompilerContext) => Plugin;
+export declare function viteCssModuleToLit(code: string, withHmr: boolean, minify: boolean, isLayered: boolean): string;

package/dist/publicTypes.d.ts

@@ -3,9 +3,9 @@ import { Plugin } from 'vite';
 import { build as esbuildBuild } from 'esbuild';
 import { CompilerContext } from './context';
 import { PluginOptions as VitePluginDtsOptions } from 'vite-plugin-dts';
-import { ExternalsOptions as RollupPluginNodeExternalsOptions } from 'rollup-plugin-node-externals';
 import { WebTypesOptions } from './docs/webTypes/types';
 import { VsCodeDocOptions } from './docs/vsCodeCustomData/types';
+import { DependencyManagementOptions as BaseDependencyManagementOptions } from '@arcgis/components-build-utils';
 import { ApiJson, ApiModule, CopyDocDefinitions } from '@arcgis/api-extractor';
 import { LuminaApiExtractor } from './extractor/extractor';
 /**
@@ -64,6 +64,10 @@ export type LuminaOptions = {
      */
     readonly assets?: AssetHandlingOptions;
     readonly linting?: LintingOptions;
+    readonly experimental?: {
+        /** @deprecated See https://discord.com/channels/1012791295170859069/1047015641225371718 */
+        readonly stabilizeRef?: boolean;
+    };
 };
 export type BuildOptions = {
     /**
@@ -79,9 +83,13 @@ export type BuildOptions = {
          * @default undefined
          * @example "www"
          * @see [Based on Stencil's www build](https://stenciljs.com/docs/www)
-         * @deprecated Use Storybook build or separate test app package.
+         * @deprecated Use Storybook build or a separate test app package.
          */
         readonly destination?: string;
+        /** @deprecated Use Storybook build or a separate test app package. */
+        readonly transformFile?: (htmlContent: string, htmlFilePath: string, context: CompilerContext) => string;
+        /** @deprecated Use Storybook build or a separate test app package. */
+        readonly afterBuildEnd?: (context: CompilerContext) => Promise<void> | void;
     };
     /**
      * Options for externalizing or bundling in dependencies.
@@ -113,7 +121,6 @@ export type BuildOptions = {
      * Wrappers to generate.
      */
     readonly wrappers?: WrappersOptions[];
-    readonly ssr?: SsrOptions;
 };
 export type BuildCdnOptions = {
     /**
@@ -158,6 +165,11 @@ export type BuildCdnOptions = {
 };
 export type CdnChunk = {
     code: string;
+    /**
+     * Whether chunk is currently being processed. Used to detect cyclical imports.
+     * @private
+     */
+    isProcessing: boolean;
     isAsync: boolean | undefined;
     oldSingleExportName: string | undefined;
 };
@@ -168,32 +180,6 @@ export type CdnChunk = {
  * https://devtopia.esri.com/WebGIS/arcgis-web-components/discussions/1281
  */
 export type WrappersOptions = React18WrapperOptions;
-export type SsrOptions = {
-    /**
-     * Emit output compatible with Stencil's dist-hydrate-script build.
-     *
-     * @deprecated
-     * This option should be used to smooth the migration path from Stencil.
-     * You should instruct your SSR users to migrate to Lit's SSR implementation,
-     * and then stop using this option.
-     *
-     * @see https://stenciljs.com/docs/hydrate-app
-     * @see https://lit.dev/docs/ssr/overview/
-     */
-    readonly stencilCompatibility?: {
-        /**
-         * @default false
-         */
-        enabled?: boolean;
-        /**
-         * By default, the hydrate directory is output to package root, outside
-         * of dist.
-         *
-         * @default "hydrate"
-         */
-        path?: string;
-    };
-};
 /**
  * Options for creating React 18 wrapper.
  *
@@ -211,46 +197,31 @@ export type React18WrapperOptions = {
 /**
  * Options for externalizing dependencies.
  *
- * Reuse the options from rollup-plugin-node-externals, but rename two options for clarity.
- * - `include` is renamed to `externalize` to make it clear that these are externalized
- * - `exclude` is renamed to `bundleIn` to make it clear that these are bundled in
- *
- * @see https://www.npmjs.com/package/rollup-plugin-node-externals
- *
  * @remarks
  * If Vite is running under Storybook, these options are ignored. This is
  * because in Storybook build, unlike in a library build, we want to bundle in
  * all dependencies (with exception of @arcgis/core and web component
  * dependencies, which are loaded using the ESM CDN).
  */
-export type DependencyManagementOptions = Omit<RollupPluginNodeExternalsOptions, "exclude" | "include"> & {
+export type DependencyManagementOptions = BaseDependencyManagementOptions & {
     /**
-     * Force bundle in these dependencies even if they are declared as
-     * dependencies or peerDependencies.
+     * 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.
      *
-     * @example
-     * This is desirable if you wish to control the version of a dependency or
-     * need to post-process the dependency in some way. Usually, you will declare
-     * such as a devDependency, but there is a use case for declaring it as a
-     * dependency instead:
-     *
-     * - If TypeScript types from the bundled in dependencies are referenced in
-     *   the `.d.ts` files of your library, you will need to declare the package
-     *   as a `dependency`, so that it is still installed on the consumer's
-     *   computer so that TypeScript can correctly resolve the types of that
-     *   library.
-     */
-    readonly bundleIn?: NonNullable<RollupPluginNodeExternalsOptions>["exclude"];
-    /**
-     * Force externalize these dependencies, even if they are declared as
-     * devDependencies.
+     * > [!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
-     * This is desirable if you are sure the end user will have these dependencies
-     * available, yet do not wish to declare these as devDependencies for some
-     * technical reasons.
+     * ```ts
+     * // Silence errors for unknown custom elements that start with "fluent-"
+     * silenceUnknownJsxElementUsage: (tagName) => tagName.startsWith("fluent-")
+     * ```
      */
-    readonly externalize?: NonNullable<RollupPluginNodeExternalsOptions>["include"];
+    readonly silenceUnknownJsxElementUsage?: (tagName: string, fileName: string, context: CompilerContext) => boolean;
 };
 export type ServeEnvironmentOptions = {
     /**
@@ -274,7 +245,11 @@ export type ServeEnvironmentOptions = {
 export type DetailedExtraDependency = {
     /** @example "@arcgis/map-config-components" */
     name: string;
-    /** @example ():string => `https://example.com/arcgis-components/builds/main/cdn/map-config-components/` */
+    /**
+     * Overwrite the default CDN asset path for this dependency.
+     *
+     * @example (): string => `https://example.com/arcgis-components/builds/main/cdn/map-config-components/`
+     */
     getCdnUrl: (context: CompilerContext) => string;
 };
 export type PuppeteerTestingOptions = {
@@ -537,65 +512,27 @@ export type CssHandlingOptions = {
      * @default "hydrated"
      */
     hydratedAttribute?: string;
-    /**
-     * By default, if a side effect CSS import is detected, an error will thrown.
-     * This is due to the requirement of handling shadow DOM styling.
-     * Instead, you should import the "styles" variable from the .css file and add
-     * it to your component.
-     *
-     * If there is a side effect CSS import from a file you don't control (i.e a
-     * library you are using), then assign this property to a function that would
-     * return "drop" to ignore those imports. In such case, you will be
-     * responsible for manually providing the styles to the web component.
-     *
-     * If neither of these is satisfactory, a more complex solution can be
-     * implemented in the future.
-     *
-     * @remarks
-     * In regular codebases, it's common to have an import statement like so:
-     * ```ts
-     * import 'some-library/styles.css';
-     * ```
-     *
-     * Doing so in a web component codebase is a bit trickier as the styles
-     * need to be attached not to the `<head>` of the page, but to the shadow
-     * root of the component that imported it. Doing so for transitive imports
-     * is even trickier (if your component imported a .js file, which in turn
-     * imported a .css file) as dependency tracking becomes necessary.
-     *
-     * That is why, for now, css imports need to be handled like so:
-     *
-     * - If import is originating from a file you control (your component file),
-     *   import the "styles" variable from the css file:
-     *
-     *   ```ts
-     *   import { styles } from 'some-library/styles.css';
-     *   ```
-     *
-     *   And then add it to your component
-     *
-     *   ```ts
-     *   export class MyComponent extends LitElement {
-     *     static override styles = styles;
-     *   }
-     *   ```
-     *
-     * - If the import is originating from a file you don't control (i.e a library
-     *   code), you have to set this property to a function that will return
-     *   "drop" for a given library import to ignore such import, and then you
-     *   will have to manually provide the CSS file by importing "styles"
-     *   variable.
-     *
-     * @default () => "throwError"
-     *
-     */
-    readonly sideEffectImportHandling?: (specifier: string, importer: string) => "drop" | "throwError";
 };
 export type AssetHandlingOptions = {
     /**
      * Any additional assets you wish to provide, besides those located in the
      * assets/ directories
      *
+     * @example
+     * ```ts
+     * import resolvePkg from "resolve-pkg";
+     *
+     * // ...
+     *
+     * extra: [
+     *   {
+     *     type: "directory",
+     *     source: resolvePkg("@arcgis/arcade-sdk/dist/arcgis-arcade-editor")!,
+     *     destination: "arcade-language",
+     *   },
+     * ]
+     * ```
+     *
      * @remarks
      * If you need additional flexibility, you can call the
      * `compilerContext.provideAssets()` utility at any time

package/dist/puppeteerTesting/vitest/matchers/index.d.ts

@@ -1,17 +1,17 @@
 export declare const expectExtend: {
-    toEqualAttribute: import('@vitest/expect').RawMatcherFn<import('@vitest/expect').MatcherState>;
-    toEqualAttributes: import('@vitest/expect').RawMatcherFn<import('@vitest/expect').MatcherState>;
-    toEqualText: import('@vitest/expect').RawMatcherFn<import('@vitest/expect').MatcherState>;
-    toHaveAttribute: import('@vitest/expect').RawMatcherFn<import('@vitest/expect').MatcherState>;
-    toHaveClass: import('@vitest/expect').RawMatcherFn<import('@vitest/expect').MatcherState>;
+    toEqualAttribute: import('@vitest/expect').RawMatcherFn<import('@vitest/expect').MatcherState, any[]>;
+    toEqualAttributes: import('@vitest/expect').RawMatcherFn<import('@vitest/expect').MatcherState, any[]>;
+    toEqualText: import('@vitest/expect').RawMatcherFn<import('@vitest/expect').MatcherState, any[]>;
+    toHaveAttribute: import('@vitest/expect').RawMatcherFn<import('@vitest/expect').MatcherState, any[]>;
+    toHaveClass: import('@vitest/expect').RawMatcherFn<import('@vitest/expect').MatcherState, any[]>;
     toHaveClasses: (element: unknown, expectClassNames: string[]) => import('@vitest/expect').SyncExpectationResult;
-    toMatchClasses: import('@vitest/expect').RawMatcherFn<import('@vitest/expect').MatcherState>;
-    toHaveReceivedEvent: import('@vitest/expect').RawMatcherFn<import('@vitest/expect').MatcherState>;
-    toHaveReceivedEventTimes: import('@vitest/expect').RawMatcherFn<import('@vitest/expect').MatcherState>;
-    toHaveReceivedEventDetail: import('@vitest/expect').RawMatcherFn<import('@vitest/expect').MatcherState>;
-    toHaveFirstReceivedEventDetail: import('@vitest/expect').RawMatcherFn<import('@vitest/expect').MatcherState>;
-    toHaveLastReceivedEventDetail: import('@vitest/expect').RawMatcherFn<import('@vitest/expect').MatcherState>;
-    toHaveNthReceivedEventDetail: import('@vitest/expect').RawMatcherFn<import('@vitest/expect').MatcherState>;
+    toMatchClasses: import('@vitest/expect').RawMatcherFn<import('@vitest/expect').MatcherState, any[]>;
+    toHaveReceivedEvent: import('@vitest/expect').RawMatcherFn<import('@vitest/expect').MatcherState, any[]>;
+    toHaveReceivedEventTimes: import('@vitest/expect').RawMatcherFn<import('@vitest/expect').MatcherState, any[]>;
+    toHaveReceivedEventDetail: import('@vitest/expect').RawMatcherFn<import('@vitest/expect').MatcherState, any[]>;
+    toHaveFirstReceivedEventDetail: import('@vitest/expect').RawMatcherFn<import('@vitest/expect').MatcherState, any[]>;
+    toHaveLastReceivedEventDetail: import('@vitest/expect').RawMatcherFn<import('@vitest/expect').MatcherState, any[]>;
+    toHaveNthReceivedEventDetail: import('@vitest/expect').RawMatcherFn<import('@vitest/expect').MatcherState, any[]>;
 };
 export interface PuppeteerMatchers<R = unknown> {
     toEqualAttribute: (expectedAttribute: string, expectedValue: unknown) => R;

package/dist/testing/index.js

@@ -1,7 +1,7 @@
-import { render as C } from "lit-html";
-import { unsafeStatic as m, html as w } from "lit-html/static.js";
+import { render as C } from "lit";
+import { unsafeStatic as m, html as w } from "lit/static-html.js";
 import { devOnly$getLitElementTagNameAndRuntime as $, LitElement as S } from "@arcgis/lumina";
-import { camelToKebab as _ } from "@arcgis/components-utils";
+import { camelToKebab as _ } from "@arcgis/toolkit/string";
 import { onTestFinished as x, expect as E } from "vitest";
 import O from "vitest-fail-on-console";
 import R from "js-beautify";

package/dist/testing/mount.d.ts

@@ -1,4 +1,4 @@
-import { TemplateResult } from 'lit-html';
+import { TemplateResult } from 'lit';
 import { JsxNode, LitElement, ToElement } from '@arcgis/lumina';
 export type RenderResult<Component extends HTMLElement> = {
     /**
@@ -98,7 +98,7 @@ export type RenderOptions<Component extends HTMLElement = HTMLElement> = {
  * In it's simplest form, what this function is doing is the following:
  *
  * ```tsx
- * import { render } from "lit-html";
+ * import { render } from "lit";
  * render(<arcgis-counter />, document.body);
  * const el = document.querySelector("arcgis-counter")!;
  * await el.componentOnReady();

package/dist/testing/vitestTypes.d.ts

@@ -0,0 +1,8 @@
+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/injectRuntimeOptions.d.ts

@@ -1,3 +1,13 @@
-import { SourceDescription } from 'rollup';
 import { CompilerContext } from '../context';
-export declare function injectRuntimeOptions(runtimeTsCode: string, context: CompilerContext): SourceDescription;
+import { TransformResult } from 'vite';
+export declare function injectRuntimeOptions(runtimeTsCode: string, context: CompilerContext): TransformResult;
+/**
+ * Add to chunks/runtime.js import statement for the global CSS file.
+ * This way CSS is injected automatically, simplifying get started instructions.
+ * We also inject CSS imports for Lumina dependencies this package uses - this
+ * is needed to ensure CSS is loaded in correct order - this does not cause
+ * duplicate CSS bundling.
+ *
+ * Research notes: https://devtopia.esri.com/WebGIS/arcgis-web-components/discussions/1824#discussioncomment-12625
+ */
+export declare function getGlobalCssImport(context: CompilerContext): string;

package/dist/transformers/internalTypeScriptApis.d.ts

@@ -1,5 +1,8 @@
-import { SourceMap } from 'rollup';
 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;

package/dist/transformers/utils.d.ts

@@ -6,9 +6,3 @@ import { CompilerContext } from '../context';
  * the resulting source file
  */
 export declare function runTransformers(context: CompilerContext, transformationContext: ts.TransformationContext, sourceFile: ts.SourceFile, transformers: readonly FileTransformer[]): ts.SourceFile;
-/**
- * For performance reasons, to avoid the need to re-create the source map
- * after this change, replace the given code string with a comment string of
- * equal length :)
- */
-export declare const commentOutCode: (match: string) => string;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@arcgis/lumina-compiler",
-  "version": "4.34.0-next.12",
+  "version": "4.34.0-next.121",
   "type": "module",
   "main": "dist/index.js",
   "module": "dist/index.js",
@@ -18,25 +18,28 @@
   ],
   "license": "SEE LICENSE IN LICENSE.md",
   "dependencies": {
-    "@arcgis/api-extractor": "4.34.0-next.12",
-    "@arcgis/components-build-utils": "4.34.0-next.12",
-    "@arcgis/components-utils": "4.34.0-next.12",
-    "chalk": "^5.3.0",
-    "esbuild": "^0.25.4",
-    "glob": "^11.0.0",
-    "js-beautify": "^1.15.1",
-    "mime-types": "^2.1.35",
-    "rollup": "^4.40.2",
-    "rollup-plugin-node-externals": "^8.0.0",
-    "sass-embedded": "^1.79.3",
+    "@arcgis/api-extractor": "4.34.0-next.121",
+    "@arcgis/components-build-utils": "4.34.0-next.121",
+    "@arcgis/toolkit": "4.34.0-next.121",
+    "chalk": "^5.4.1",
+    "esbuild": "^0.25.5",
+    "glob": "^11.0.3",
+    "js-beautify": "^1.15.4",
+    "mime-types": "^3.0.1",
     "tslib": "^2.8.1",
-    "typescript": "~5.8.3",
-    "vite": "^6.3.4",
-    "vite-plugin-dts": "^4.5.3",
-    "vitest": "^3.1.3",
+    "vite-plugin-dts": "^4.5.4",
     "vitest-fail-on-console": "^0.7.1"
   },
   "peerDependencies": {
-    "@arcgis/lumina": "~4.34.0-next.12"
+    "@arcgis/lumina": "~4.34.0-next.121",
+    "lit": "^3.3.0",
+    "typescript": "~5.8.3",
+    "vite": "^7.0.0",
+    "vitest": "^3.2.4"
+  },
+  "peerDependenciesMeta": {
+    "vitest": {
+      "optional": true
+    }
   }
 }

package/dist/jsxToLitHtml/escapeForTemplateLiteral.d.ts

@@ -1,45 +0,0 @@
-/**
- * This file is a workaround for a TypeScript bug:
- * https://github.com/microsoft/TypeScript/issues/59150
- *
- * Once that bug is fixed, the code can be simplified like so:
- * - This file can be removed
- * - For each place where `escapeBackticks` or `escapeForTemplateLiteral` was
- *   used and the result was passed as the 1st AND 2nd parameter to one of
- *   ts.factory.createNoSubstitutionTemplateLiteral,
- *   ts.factory.createTemplateHead, ts.factory.createTemplateMiddle, or
- *   ts.factory.createTemplateTail, change those places like so:
- *   - DO NOT call `escapeBackticks` or `escapeForTemplateLiteral` anymore -
- *     pass the value as is.
- *   - DO NOT provide the 2nd parameter to the factory function.
- * - If `escapeForTemplateLiteral` was used in some other place, it can
- *   potentially be replaced with a function like this:
- *   string=>escapeTemplateSubstitution(string).replaceAll('`','\`')
- *   (where escapeTemplateSubstitution is defined in the current file - move it)
- *
- * More details:
- *
- * In template literals, even though we *really* only need to escape ${ and
- * backticks, we are escaping non-ASCII characters too as that improves scanner
- * performance in JavaScript engines.
- *
- * This is what esbuild does (https://esbuild.github.io/api/#charset), what
- * V8 recommends (https://v8.dev/blog/scanner) and what TypeScript does.
- *
- * The code in this file has been copied from TypeScript's code for escaping
- * template literals (but simplified to remove dead branches and fix eslint
- * warnings):
- * https://github.com/microsoft/TypeScript/blob/3163fe7e3898c1f48cd9bc097b96e3426cd2a453/src/compiler/utilities.ts#L5918-L5986
- *
- * TypeScript can automatically escape template literals for us, but we opt out
- * of that as, due to a bug, they also escape new line characters which is not
- * good as it decreases readability when debugging code.
- *
- * TypeScript does not expose the template literal escaping utils so we had
- * to copy the code here, but modify to not escape new lines.
- *
- */
-declare function escapeNonAsciiString(s: string): string;
-export declare const escapeBackticks: typeof escapeNonAsciiString;
-export declare const escapeTemplateSubstitution: (str: string) => string;
-export {};

package/dist/plugins/buildStencilHydrate.d.ts

@@ -1,16 +0,0 @@
-import { Plugin } from 'vite';
-import { CompilerContext } from '../context';
-/**
- * Emit output compatible with Stencil's dist-hydrate-script build.
- *
- * Based on https://github.com/ionic-team/stencil/blob/main/src/compiler/output-targets/dist-hydrate-script/write-hydrate-outputs.ts
- *
- * @deprecated
- * This option should be used to smooth the migration path from Stencil.
- * You should instruct your SSR users to migrate to Lit's SSR implementation,
- * and then stop using this option.
- *
- * @see https://stenciljs.com/docs/hydrate-app
- * @see https://lit.dev/docs/ssr/overview/
- */
-export declare function buildStencilHydrate(context: CompilerContext): Plugin | undefined;