@arcgis/lumina-compiler 4.33.0-next.111 → 4.33.0-next.113

package/dist/plugins/buildCdn.d.ts

@@ -63,28 +63,7 @@ type Chunk = {
  * ```
  */
 declare function transformChunk(chunk: Chunk, chunks: Map<string, Chunk>): void;
-/**
- * @example Dynamic core import
- * ```diff
- * -import("core/Handles");
- * +$arcgis.t(m=>m[0],"core/Handles")
- * ```
- *
- * @example Dynamic import of a chunk with top-level await
- * ```diff
- * -import("./chunk.js");
- * +import("./chunk.js").then(m=>m.default)
- * ```
- *
- * @example Dynamic import of a chunk with top-level await and single export that got inlined
- * ```diff
- * -import("./chunk.js");
- * +import("./chunk.js").then(m=>m.default.then(e=>({ArcgisHome:e})))
- * ```
- */
-declare function transformDynamicCoreImports(code: string, chunks: Map<string, Chunk>): string;
 export declare const exportsForTests: {
-    transformDynamicCoreImports: typeof transformDynamicCoreImports;
     transformChunk: typeof transformChunk;
 };
 export {};

package/dist/publicTypes.d.ts

@@ -6,7 +6,7 @@ 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 { ApiJson, ApiModule } from '@arcgis/api-extractor';
+import { ApiJson, ApiModule, CopyDocDefinitions } from '@arcgis/api-extractor';
 import { LuminaApiExtractor } from './extractor/extractor';
 /**
  * `useLumina()` returns an array of Vite plugins. The array additionally
@@ -70,6 +70,7 @@ export type BuildOptions = {
      * Configuration for CDN build.
      */
     readonly cdn?: BuildCdnOptions;
+    /** @deprecated Use Storybook build or separate test app package. */
     readonly webApp?: {
         /**
          * If set, will produce a web app build, based on index.html files and
@@ -285,6 +286,7 @@ export type PuppeteerTestingOptions = {
     readonly launchOptions?: Record<string, unknown>;
 };
 export type GenerateDocumentationOptions = {
+    readonly copyDefinitions?: CopyDocDefinitions;
     /**
      * The name of the file to write the api.json to. api.json is a file format
      * based on custom-elements-manifest that describes all the components in the
@@ -297,22 +299,39 @@ export type GenerateDocumentationOptions = {
      * The name of the file to write the Stencil-like docs JSON to.
      * For backwards compatibility.
      *
+     * @deprecated Use api.json instead.
      * @default "docs/docs.json"
      * @see https://stenciljs.com/docs/docs-json
      */
     readonly stencilLikeDocsJsonFileName?: string | false;
+    /**
+     * Get a prefix for a public-facing URL for each component story.
+     *
+     * @example
+     * Set this to "https://developers.arcgis.com/javascript/latest/storybook/map-components/".
+     * This will produce URLs like
+     * "https://developers.arcgis.com/javascript/latest/storybook/map-components/?path=/story/arcgis-area-measurement-2d--demo&singleStory=true"
+     * @see https://qawebgis.esri.com/components/lumina/storybook
+     */
+    readonly publicStoryUrlPrefix?: string;
     /**
      * Provide a URL to a page that documents the component.
      * This URL will be visible in VS Code and IntelliJ when hovering over a
      * component tag in an .html file
+     *
+     * @example (tagName) => `https://developers.arcgis.com/javascript/latest/references/map-components/${tagName}/`
      */
-    readonly getComponentDocsUrl?: (tag: string, name: string) => string | undefined;
+    readonly getComponentDocsUrl?: (tagName: string, className: string) => string | undefined;
     /**
      * Provide a URL to a page that documents the component.
      * This URL will be visible in VS Code and IntelliJ when hovering over a
      * component tag in an .html file
+     *
+     * If you wish to provide multiple URLs, use "getPublicStoryUrl" instead.
+     *
+     * @example (tagName) => `https://developers.arcgis.com/javascript/latest/storybook/map-components/?path=/story/${tagName}--demo&singleStory=true`
      */
-    readonly getComponentDemoUrl?: (tag: string, name: string) => string | undefined;
+    readonly getComponentDemoUrl?: (tagName: string, className: string) => string | undefined;
     /**
      * Additional options for web component documentation for VS Code. This
      * documentation provides intellisense when editing .html and .css files.
@@ -437,7 +456,7 @@ export type ApiJsonOptions = {
      *
      * @default LuminaApiExtractor
      */
-    readonly Extractor: typeof LuminaApiExtractor;
+    readonly Extractor?: typeof LuminaApiExtractor;
     /**
      * This function will be called after the api.json is created but before it is
      * used to generate any output files.

package/package.json

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

package/dist/extractor/helpers/jsDoc.d.ts

@@ -1,11 +0,0 @@
-import { default as ts } from 'typescript';
-import { ApiCustomElementDeclaration, ApiCustomElementField, ApiDocsTag } from '@arcgis/api-extractor';
-export declare function symbolToDocs(checker: ts.TypeChecker, symbol: ts.Signature | ts.Symbol): {
-    description: ApiCustomElementField["description"];
-    docsTags: ApiDocsTag[];
-};
-export declare const internalJsDocTag = "internal";
-export declare const findDecorator: ({ modifiers }: {
-    modifiers?: readonly ts.ModifierLike[];
-}, name: string) => ts.CallExpression | undefined;
-export declare function setJsDocFields(node: ts.PropertyName, checker: ts.TypeChecker, api: Partial<Pick<ApiCustomElementField, "default" | "deprecated" | "description" | "docsTags" | "privacy" | "readonly" | "summary"> & Pick<ApiCustomElementDeclaration, "cssParts" | "cssProperties" | "cssStates" | "slots">>, docs?: ReturnType<typeof symbolToDocs>): void;