@esri/solutions-components 1.0.0-next.20250513.1 → 1.0.0-next.20250521

package/dist/types/stencil.d.ts

@@ -84,7 +84,7 @@ interface StencilBufferTools extends Partial<Pick<BufferTools, 'appearance' | 'd
   onUnitChanged?: EventHandler<HTMLBufferToolsElement["unitChanged"]>;
 }
 
-interface StencilCardManager extends Partial<Pick<CardManager, 'customInfoText' | 'enableCreateFeatures' | 'enableEditGeometry' | 'enableSnapping' | 'isMobile' | 'layerOrTable' | 'mapView' | 'selectedFeaturesIds' | 'selectingFeatureFromMap' | 'zoomAndScrollToSelected'>>, StencilJsx.HTMLAttributes<HTMLCardManagerElement> {
+interface StencilCardManager extends Partial<Pick<CardManager, 'customInfoText' | 'enableCreateFeatures' | 'enableEditGeometry' | 'enableSnapping' | 'isMobile' | 'layerOrTable' | 'mapView' | 'selectedFeaturesIds' | 'selectingFeatureFromMap' | 'showSketchWidgets' | 'zoomAndScrollToSelected'>>, StencilJsx.HTMLAttributes<HTMLCardManagerElement> {
   onBackFromCreateWorkFlow?: EventHandler<HTMLCardManagerElement["backFromCreateWorkFlow"]>;
   onCreateWorkFlowStarted?: EventHandler<HTMLCardManagerElement["createWorkFlowStarted"]>;
   onFeatureOrRecordSubmitted?: EventHandler<HTMLCardManagerElement["featureOrRecordSubmitted"]>;
@@ -94,9 +94,10 @@ interface StencilConsentManager extends Required<Pick<ConsentManager, 'firstUseV
   onConsentGranted?: EventHandler<HTMLConsentManagerElement["consentGranted"]>;
 }
 
-interface StencilCreateFeature extends Partial<Pick<CreateFeature, 'customizeSubmit' | 'enableSearch' | 'enableSnapping' | 'floorLevel' | 'formElements' | 'isMobile' | 'mapView' | 'searchConfiguration' | 'selectedLayerId' | 'showGuidingMsg' | 'submitNewReportsMessage'>>, StencilJsx.HTMLAttributes<HTMLCreateFeatureElement> {
+interface StencilCreateFeature extends Partial<Pick<CreateFeature, 'customizeSubmit' | 'enableSearch' | 'enableSnapping' | 'floorLevel' | 'formElements' | 'isMobile' | 'mapView' | 'reportingAreaLayer' | 'reportOutsideAreaMessage' | 'searchConfiguration' | 'selectedLayerId' | 'showGuidingMsg' | 'showSketchWidgets' | 'submitNewReportsMessage' | 'updateMapPosition'>>, StencilJsx.HTMLAttributes<HTMLCreateFeatureElement> {
   onDrawComplete?: EventHandler<HTMLCreateFeatureElement["drawComplete"]>;
   onEditingAttachment?: EventHandler<HTMLCreateFeatureElement["editingAttachment"]>;
+  onEditingLocation?: EventHandler<HTMLCreateFeatureElement["editingLocation"]>;
   onFail?: EventHandler<HTMLCreateFeatureElement["fail"]>;
   onModeChanged?: EventHandler<HTMLCreateFeatureElement["modeChanged"]>;
   onProgressStatus?: EventHandler<HTMLCreateFeatureElement["progressStatus"]>;
@@ -115,7 +116,7 @@ interface StencilCrowdsourceManager extends Partial<Pick<CrowdsourceManager, 'ap
   onShowIntroductionWindow?: EventHandler<HTMLCrowdsourceManagerElement["showIntroductionWindow"]>;
 }
 
-interface StencilCrowdsourceReporter extends Partial<Pick<CrowdsourceReporter, 'center' | 'commentButtonText' | 'commentSubmittedMessage' | 'defaultWebmap' | 'description' | 'enableAnonymousAccess' | 'enableAnonymousComments' | 'enableComments' | 'enableHome' | 'enableLogin' | 'enableNewReports' | 'enableSearch' | 'enableSnapping' | 'enableZoom' | 'filterByMapExtent' | 'floorLevel' | 'isMobile' | 'layerExpressions' | 'layerId' | 'level' | 'loginTitle' | 'mapInfos' | 'mapView' | 'objectId' | 'reportButtonText' | 'reportingOptions' | 'reportsHeader' | 'reportSubmittedMessage' | 'searchConfiguration' | 'showComments' | 'showFeatureSymbol' | 'showFullCommentTitle' | 'showMyReportsOnly' | 'showUserImageInCommentsList' | 'sortOption' | 'submitNewReportsMessage' | 'theme' | 'zoomToScale'>>, StencilJsx.HTMLAttributes<HTMLCrowdsourceReporterElement> {
+interface StencilCrowdsourceReporter extends Partial<Pick<CrowdsourceReporter, 'center' | 'commentButtonText' | 'commentSubmittedMessage' | 'defaultWebmap' | 'description' | 'enableAnonymousAccess' | 'enableAnonymousComments' | 'enableComments' | 'enableHome' | 'enableLogin' | 'enableNewReports' | 'enableSearch' | 'enableSnapping' | 'enableZoom' | 'filterByMapExtent' | 'floorLevel' | 'isMobile' | 'layerExpressions' | 'layerId' | 'level' | 'loginTitle' | 'mapInfos' | 'mapView' | 'objectId' | 'reportButtonText' | 'reportingAreaLayer' | 'reportingOptions' | 'reportOutsideAreaMessage' | 'reportsHeader' | 'reportSubmittedMessage' | 'searchConfiguration' | 'showComments' | 'showFeatureSymbol' | 'showFullCommentTitle' | 'showMyReportsOnly' | 'showUserImageInCommentsList' | 'sortOption' | 'submitNewReportsMessage' | 'theme' | 'zoomToScale'>>, StencilJsx.HTMLAttributes<HTMLCrowdsourceReporterElement> {
   onTogglePanel?: EventHandler<HTMLCrowdsourceReporterElement["togglePanel"]>;
 }
 
@@ -123,7 +124,8 @@ interface StencilDeductCalculator extends StencilJsx.HTMLAttributes<HTMLDeductCa
   onDeductValueComplete?: EventHandler<HTMLDeductCalculatorElement["deductValueComplete"]>;
 }
 
-interface StencilDeleteButton extends Partial<Pick<DeleteButton, 'buttonType' | 'deleteDialog' | 'disabled' | 'icon' | 'ids' | 'layer'>>, StencilJsx.HTMLAttributes<HTMLDeleteButtonElement> {
+interface StencilDeleteButton extends Partial<Pick<DeleteButton, 'buttonType' | 'deleteDialog' | 'disabled' | 'icon' | 'ids' | 'layer' | 'showDeleteCount'>>, StencilJsx.HTMLAttributes<HTMLDeleteButtonElement> {
+  onDeleteClicked?: EventHandler<HTMLDeleteButtonElement["deleteClicked"]>;
   onEditsComplete?: EventHandler<HTMLDeleteButtonElement["editsComplete"]>;
 }
 
@@ -181,7 +183,7 @@ interface StencilLayerTable extends Partial<Pick<LayerTable, 'appLayout' | 'crea
   onToggleFilter?: EventHandler<HTMLLayerTableElement["toggleFilter"]>;
 }
 
-interface StencilMapCard extends Partial<Pick<MapCard, 'appLayout' | 'appProxies' | 'basemapConfig' | 'defaultLayerId' | 'defaultWebmapId' | 'enableBasemap' | 'enableFloorFilter' | 'enableFullscreen' | 'enableHome' | 'enableLegend' | 'enableSearch' | 'enableSelectionTool' | 'enableShare' | 'enableSingleExpand' | 'hide' | 'homeZoomIndex' | 'homeZoomPosition' | 'homeZoomToolsSize' | 'isMapLayout' | 'isMobile' | 'mapInfo' | 'mapInfos' | 'mapView' | 'mapWidgetsIndex' | 'mapWidgetsPosition' | 'mapWidgetsSize' | 'selectedFeaturesIds' | 'selectedLayer' | 'shareIncludeEmbed' | 'shareIncludeSocial' | 'showOnlyUpdatableLayers' | 'stackTools' | 'theme' | 'toolOrder' | 'zoomToScale'>>, StencilJsx.HTMLAttributes<HTMLMapCardElement> {
+interface StencilMapCard extends Partial<Pick<MapCard, 'appLayout' | 'appProxies' | 'basemapConfig' | 'defaultLayerId' | 'defaultWebmapId' | 'enableBasemap' | 'enableFloorFilter' | 'enableFullscreen' | 'enableHome' | 'enableLegend' | 'enableSearch' | 'enableSelectionTool' | 'enableShare' | 'enableSingleExpand' | 'hide' | 'isMapLayout' | 'isMobile' | 'mapInfo' | 'mapInfos' | 'mapToolsOrder' | 'mapView' | 'mapWidgetsIndex' | 'mapWidgetsPosition' | 'mapWidgetsSize' | 'mobileMapWidgetsPosition' | 'mobileToolsOrder' | 'selectedFeaturesIds' | 'selectedLayer' | 'shareIncludeEmbed' | 'shareIncludeSocial' | 'showOnlyUpdatableLayers' | 'stackTools' | 'theme' | 'zoomToolsSize' | 'zoomToScale'>>, StencilJsx.HTMLAttributes<HTMLMapCardElement> {
   onBeforeMapChanged?: EventHandler<HTMLMapCardElement["beforeMapChanged"]>;
   onClearSelection?: EventHandler<HTMLMapCardElement["clearSelection"]>;
   onMapChanged?: EventHandler<HTMLMapCardElement["mapChanged"]>;
@@ -199,7 +201,7 @@ interface StencilMapFullscreen extends Partial<Pick<MapFullscreen, 'fullscreenWi
   onFullscreenStateChange?: EventHandler<HTMLMapFullscreenElement["fullscreenStateChange"]>;
 }
 
-interface StencilMapLayerPicker extends Partial<Pick<MapLayerPicker, 'appearance' | 'defaultLayerId' | 'display' | 'enabledLayerIds' | 'enabledTableIds' | 'height' | 'isMobile' | 'mapView' | 'placeholderIcon' | 'scale' | 'selectedIds' | 'showOnlyUpdatableLayers' | 'showSingleLayerAsLabel' | 'showTables' | 'showTablesDisabled' | 'type'>>, StencilJsx.HTMLAttributes<HTMLMapLayerPickerElement> {
+interface StencilMapLayerPicker extends Partial<Pick<MapLayerPicker, 'appearance' | 'defaultLayerId' | 'display' | 'enabledLayerIds' | 'enabledTableIds' | 'height' | 'isMobile' | 'mapView' | 'placeholderIcon' | 'referenceElement' | 'scale' | 'selectedIds' | 'showLayersListInPopover' | 'showOnlyUpdatableLayers' | 'showSingleLayerAsLabel' | 'showTables' | 'showTablesDisabled' | 'type'>>, StencilJsx.HTMLAttributes<HTMLMapLayerPickerElement> {
   onBeforeLayerSelectionChange?: EventHandler<HTMLMapLayerPickerElement["beforeLayerSelectionChange"]>;
   onIdsFound?: EventHandler<HTMLMapLayerPickerElement["idsFound"]>;
   onLayerSelectionChange?: EventHandler<HTMLMapLayerPickerElement["layerSelectionChange"]>;
@@ -209,7 +211,7 @@ interface StencilMapLayerPicker extends Partial<Pick<MapLayerPicker, 'appearance
 interface StencilMapLegend extends Partial<Pick<MapLegend, 'legendWidget' | 'mapView'>>, StencilJsx.HTMLAttributes<HTMLMapLegendElement> {
 }
 
-interface StencilMapPicker extends Partial<Pick<MapPicker, 'isMapLayout' | 'mapInfos'>>, StencilJsx.HTMLAttributes<HTMLMapPickerElement> {
+interface StencilMapPicker extends Partial<Pick<MapPicker, 'height' | 'isMapLayout' | 'mapInfos' | 'referenceElement' | 'selectedWebMapId' | 'showMapListInPopover'>>, StencilJsx.HTMLAttributes<HTMLMapPickerElement> {
   onBeforeMapInfoChange?: EventHandler<HTMLMapPickerElement["beforeMapInfoChange"]>;
   onMapInfoChange?: EventHandler<HTMLMapPickerElement["mapInfoChange"]>;
 }
@@ -221,7 +223,7 @@ interface StencilMapSelectTools extends Partial<Pick<MapSelectTools, 'bufferColo
   onSelectionSetChange?: EventHandler<HTMLMapSelectToolsElement["selectionSetChange"]>;
 }
 
-interface StencilMapTools extends Partial<Pick<MapTools, 'basemapConfig' | 'enableBasemap' | 'enableFloorFilter' | 'enableFullscreen' | 'enableHome' | 'enableLegend' | 'enableSearch' | 'enableSelectionTool' | 'enableSingleExpand' | 'homeZoomToolsSize' | 'layout' | 'mapView' | 'mapWidgetsSize' | 'position' | 'searchConfiguration' | 'selectedLayer' | 'stackTools' | 'toolOrder'>>, StencilJsx.HTMLAttributes<HTMLMapToolsElement> {
+interface StencilMapTools extends Partial<Pick<MapTools, 'basemapConfig' | 'defaultLayerId' | 'enableBasemap' | 'enableFloorFilter' | 'enableFullscreen' | 'enableHome' | 'enableLegend' | 'enableMapLayerPicker' | 'enableMapPicker' | 'enableSearch' | 'enableSelectionTool' | 'enableSingleExpand' | 'isMobile' | 'layout' | 'mapInfos' | 'mapView' | 'mapWidgetsSize' | 'parentComponentHeight' | 'parentComponentWidth' | 'position' | 'searchConfiguration' | 'selectedLayer' | 'selectedWebMapId' | 'showOnlyUpdatableLayers' | 'stackTools' | 'toolOrder' | 'zoomToolsSize'>>, StencilJsx.HTMLAttributes<HTMLMapToolsElement> {
 }
 
 interface StencilPciCalculator extends StencilJsx.HTMLAttributes<HTMLPciCalculatorElement> {
@@ -239,7 +241,7 @@ interface StencilRefineSelection extends Partial<Pick<RefineSelection, 'addresse
   onSelectionSetsChanged?: EventHandler<HTMLRefineSelectionElement["selectionSetsChanged"]>;
 }
 
-interface StencilSelectionTool extends Partial<Pick<SelectionTool, 'locale' | 'mapView' | 'selectedLayerId' | 'tool'>>, StencilJsx.HTMLAttributes<HTMLSelectionToolElement> {
+interface StencilSelectionTool extends Partial<Pick<SelectionTool, 'mapView' | 'selectedLayerId' | 'tool'>>, StencilJsx.HTMLAttributes<HTMLSelectionToolElement> {
   onDrawingComplete?: EventHandler<HTMLSelectionToolElement["drawingComplete"]>;
   onFeaturesSelected?: EventHandler<HTMLSelectionToolElement["featuresSelected"]>;
 }
@@ -269,7 +271,7 @@ interface StencilSolutionDeployDialog extends StencilJsx.HTMLAttributes<HTMLSolu
 interface StencilSolutionDeployPanel extends StencilJsx.HTMLAttributes<HTMLSolutionDeployPanelElement> {
 }
 
-interface StencilSolutionDeployedCard extends StencilJsx.HTMLAttributes<HTMLSolutionDeployedCardElement> {
+interface StencilSolutionDeployedCard extends Partial<Pick<SolutionDeployedCard, 'deployedDate' | 'description' | 'heading' | 'itemId' | 'owner' | 'thumbnail' | 'updateAvailable'>>, StencilJsx.HTMLAttributes<HTMLSolutionDeployedCardElement> {
 }
 
 interface StencilSolutionDeployingPanel extends StencilJsx.HTMLAttributes<HTMLSolutionDeployingPanelElement> {
@@ -325,10 +327,13 @@ interface StencilSolutionVariables extends Partial<Pick<SolutionVariables, 'valu
   onSolutionVariableSelected?: EventHandler<HTMLSolutionVariablesElement["solutionVariableSelected"]>;
 }
 
-interface StencilSolutionsAllPanel extends StencilJsx.HTMLAttributes<HTMLSolutionsAllPanelElement> {
+interface StencilSolutionsAllPanel extends Partial<Pick<SolutionsAllPanel, 'agoSolutionsGroupId' | 'enterpriseSolutionsGroupId' | 'locale' | 'orgUrl' | 'portalUrl' | 'sortType'>>, StencilJsx.HTMLAttributes<HTMLSolutionsAllPanelElement> {
+  onCardsFetched?: EventHandler<HTMLSolutionsAllPanelElement["cardsFetched"]>;
 }
 
-interface StencilSolutionsAllShell extends StencilJsx.HTMLAttributes<HTMLSolutionsAllShellElement> {
+interface StencilSolutionsAllShell extends Partial<Pick<SolutionsAllShell, 'solutionsCount' | 'sortType'>>, StencilJsx.HTMLAttributes<HTMLSolutionsAllShellElement> {
+  onFilterRemoved?: EventHandler<HTMLSolutionsAllShellElement["filterRemoved"]>;
+  onTokenRefreshed?: EventHandler<HTMLSolutionsAllShellElement["tokenRefreshed"]>;
 }
 
 interface StencilSolutionsArticlePanel extends StencilJsx.HTMLAttributes<HTMLSolutionsArticlePanelElement> {
@@ -346,7 +351,8 @@ interface StencilSolutionsDeployedPanel extends StencilJsx.HTMLAttributes<HTMLSo
 interface StencilSolutionsDeployedShell extends StencilJsx.HTMLAttributes<HTMLSolutionsDeployedShellElement> {
 }
 
-interface StencilSolutionsFilterPanel extends StencilJsx.HTMLAttributes<HTMLSolutionsFilterPanelElement> {
+interface StencilSolutionsFilterPanel extends Partial<Pick<SolutionsFilterPanel, 'isAIsettingEnabled' | 'isAllSolutions'>>, StencilJsx.HTMLAttributes<HTMLSolutionsFilterPanelElement> {
+  onApplyFilter?: EventHandler<HTMLSolutionsFilterPanelElement["applyFilter"]>;
 }
 
 interface StencilSpatialRef extends Partial<Pick<SpatialRef, 'defaultWkid' | 'disabled' | 'value'>>, StencilJsx.HTMLAttributes<HTMLSpatialRefElement> {

package/dist/utils/Auth.d.ts

@@ -0,0 +1,146 @@
+/// <reference types="@arcgis/core/interfaces.d.ts" />
+import { default as Portal } from '@arcgis/core/portal/Portal';
+/** @license
+ *
+ * Copyright 2018 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
+ */
+/**
+ * Auth manages an authenticated connection to ArcGIS.
+ *
+ * @module Auth
+ */
+import * as common from "@esri/solution-common";
+export interface IPortalSubset {
+    name: string;
+    id: string;
+    restUrl: string;
+    portalUrl: string;
+    urlKey: string;
+    hostName: string;
+    orgUrl: string;
+    locationTrackingEnabled: boolean;
+    hubPremiumEnabled: boolean;
+    workflowURL: string;
+    isReadOnly: boolean;
+}
+export interface IPortalUserSubset {
+    fullName: string;
+    username: string;
+    culture: string;
+    thumbnailUrl: string;
+    privileges: string[];
+    orgId: string;
+    role: string;
+    roleId?: string;
+}
+export declare class Auth {
+    private _clientId;
+    private _credential;
+    private _locale;
+    private _portal;
+    private _portalSubset;
+    private _portalUrl;
+    private _isEnterprise;
+    private _portalUserSubset;
+    constructor(clientId: string, portalURL: string, locale: string);
+    /**
+     * Initializes the Auth object. This method must be called before any other Auth methods.
+     * If the user is not authorized to use the app, the page will be redirected to an error page.
+     *
+     * @returns Promise that resolves with the initialized Auth object
+     */
+    init(): Promise<Auth>;
+    /**
+     * Initializes the Auth object. This method must be called before any other Auth methods.
+     * If the user is not authorized to use the app, the page will be redirected to an error page.
+     *
+     * @returns Promise that resolves with the initialized Auth object
+     */
+    private _init;
+    get SignedIn(): boolean;
+    get Credential(): __esri.Credential | null;
+    get Portal(): Portal;
+    get PortalUrl(): string;
+    get PortalSubset(): IPortalSubset | null;
+    get PortalUserSubset(): IPortalUserSubset | null;
+    get PortalUserOrg(): string | null;
+    get PortalUserName(): string;
+    get PortalUserCulture(): string;
+    get PortalUserPrivileges(): string[];
+    get IsEnterprisePortal(): boolean;
+    /**
+     * Translates authentication from the format used in the [ArcGIS API for JavaScript](https://developers.arcgis.com/javascript/).
+     *
+     * @returns UserSession
+     */
+    get RestUserSession(): common.UserSession | null;
+    refreshSession(): Promise<common.UserSession> | null;
+    /**
+     * Signs into app and refreshes the window.location or switches to the supplied URL.
+     *
+     * @param signInParamValue If supplied, the parameter `signInParam` with the supplied value
+     * will be added to the redirect uri's search params
+     */
+    signIn(signInParamValue?: string): void;
+    /**
+     * Signs out of app and changes page to the portal host.
+     */
+    signOut(): void;
+    /**
+     * Signs out of app and changes page to the supplied URL.
+     *
+     * @param redirectUrl Page to replace the current page
+     */
+    signOutAndRedirect(redirectUrl: string): void;
+    destroy(): void;
+    private _getOrgUrl;
+    private _isSerializable;
+    /**
+     * Converts a hashmap of query parameters to a query string. Following formatting rules applies:
+     *   - object values that implements `toJSON()` are stringified
+     *   - array value will map to multiple key value pairs. ie `{ key: ["v1", "v2"] }` returns `key=v1&key=v2
+     *
+     * @param queryParameters the query parameters to convert to a string
+     * @param replacers optional replacer functions defined per key
+     *
+     * @example
+     * const queryParameters = {
+     *   objectIds: [1, 2, 3, 4]
+     * };
+     *
+     * // returns: "objectIds=1&objectIds=2&objectIds=3&objectIds=4"
+     * objectToQuery(queryParameters);
+     *
+     * // returns: "objectIds=1,2,3,4"
+     * objectToQuery(queryParameters, {
+     *   objectIds: (v) => v.join(",")
+     * });
+     *
+     * // returns: "objectIds=1,2,3,4"
+     * objectToQuery(queryParameters, (k, v) => {
+     *   switch (k) {
+     *     case "objectIds":
+     *       return v.join(","));
+     *     default:
+     *       return "" + v;
+     *   }
+     * });
+     *
+     * Copied from function exported in arcgis-js-api but not added to JSAPI.
+     */
+    private _objectToQuery;
+}

package/dist/utils/CardsFetcher.d.ts

@@ -0,0 +1,125 @@
+/**
+ * @license
+ * Copyright 2025 Esri
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *    http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+/**
+ * CardsFetcher is the interface between the app and the source of Solution cards. It manages the fetching, filtering,
+ * and merging of the multiple sources to present a single paged source to the app. It provides two ways of filling
+ * the cache: available and deployed solutions.
+ *
+ * @module CardsFetcher
+ */
+import * as cardsHelpers from "./cardsHelpers";
+import * as common from "@esri/solution-common";
+import * as restTypes from "@esri/arcgis-rest-types";
+export interface ISearchOptionPartial {
+    "q": string;
+    "filter": string;
+    "sortField": string;
+    "sortOrder": string;
+    "nextStart"?: any;
+    "categories": string[];
+    "delay": boolean;
+    "getSuggested"?: boolean;
+}
+export declare class CardsFetcher {
+    private readonly cMissingImageDataURI;
+    private cardCache;
+    private cardCacheParams;
+    private locale;
+    private orgUrl;
+    private portalUrl;
+    private agolPortalUrl;
+    private anonAgolSession;
+    /**
+     * Constructor
+     *
+     * @param orgUrl URL of organization, e.g., "http://myOrg.maps.arcgis.com"
+     * @param portalUrl URL of portal, e.g., "https://www.arcgis.com"
+     * @param userSession Authentication
+     */
+    constructor(locale: string, orgUrl: string, portalUrl: string);
+    /**
+     * Adds a card to the cache to keep cache fresh between full refreshes.
+     *
+     * @param card Card to add
+     */
+    addToCache(card: cardsHelpers.ISolutionInfoCard): void;
+    /**
+     * Returns the current cache.
+     *
+     * @returns Cards in the cache
+     */
+    getCache(): cardsHelpers.ISolutionInfoCard[];
+    /**
+     * Removes a card to the cache to keep cache fresh between full refreshes.
+     *
+     * @param id Id of card to remove
+     */
+    removeFromCache(id: string): void;
+    /**
+     * Fetches cards for availale Solutions from the server.
+     *
+     * @param query AGO query terms and options
+     * @param primarySolutionsGroupId Id of a group that's the primary source of Solutions for AGO or Enterprise
+     * @param agoBasedEnterpriseSolutionsGroupId Id of an AGO-based set of Enterprise Solutions
+     * @param userSession Authentication for thumbnailUrl
+     * @param pagingParams Parameters for how the request is to be batched
+     * @param acceptableIds A set of item ids that the results must be a part of; if not defined, then there's no restriction
+     * @returns A promise resolving to a collection of available Solutions as cards as well as paging information about
+     * where those cards came from in the fetcher cache; in case of failure, the promise resolves to an error message
+     */
+    requestAvailableSolutionCards(query: ISearchOptionPartial, primarySolutionsGroupId: string, agoBasedEnterpriseSolutionsGroupId: string, userSession: common.UserSession | undefined, pagingParams?: restTypes.IPagingParams, acceptableIds?: Set<string>): Promise<cardsHelpers.ICacheBatch<cardsHelpers.ISolutionInfoCard>>;
+    /**
+     * Fetches cards for deployed Solutions from the server.
+     *
+     * @param query AGO query terms and options
+     * @param userSession Authentication for thumbnailUrl
+     * @returns A collection of deployed Solutions as cards; the paging information shows that all of the cards
+     * are returned
+     */
+    requestDeployedSolutionCards(query: ISearchOptionPartial, userSession: common.UserSession | undefined): Promise<cardsHelpers.ICacheBatch<cardsHelpers.ISolutionInfoCard>>;
+    /**
+     * Stringifies categories for search.
+     *
+     * @param categories AGO item categories, e.g., "/Categories/Conservation"
+     * or ["/Categories/Conservation", "/Categories/Pipeline"]
+     * @returns Categories where each element is a stringified array of categories
+     */
+    private convertSearchCategories;
+    /**
+     * Constructs Solution cards from a Solution-query response.
+     *
+     * @param response Response from a query
+     * @returns Solution information as cards
+     */
+    private getCardsFromResponse;
+    /**
+     * Merge a set of search responses into a single response item.
+     *
+     * @param responseSet Array of search results
+     * @returns A response item that takes its query from the first item in the set and sets the other properties
+     * as if all of the responses are the result of one, large query that's independent of AGO's 100-item limit.
+     */
+    private mergeResponses;
+    /**
+     * Converts image preview information into a URL pointing to that image; returns non-image previews unchanged.
+     *
+     * @param id Item id to insert into URL
+     * @param preview List of previews to modify
+     * @returns Copy of previews with iamge previews modified
+     */
+    private preparePreviewImageUrls;
+}

package/dist/utils/cardsHelpers.d.ts

@@ -0,0 +1,146 @@
+/**
+ * @license
+ * Copyright 2025 Esri
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *    http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+import * as common from "@esri/solution-common";
+import * as helpers from "./helpers";
+import * as restTypes from "@esri/arcgis-rest-types";
+export interface ICacheBatch<T> {
+    cards: T[];
+    paging: restTypes.IPagedResponse;
+}
+export interface IKeyedStrings {
+    [key: string]: string;
+}
+export interface IPreview {
+    name: string;
+    format: string;
+    alt: string;
+}
+/**
+ * Summary of a solution item.
+ */
+export interface ISolutionInfoCard extends helpers.ISortableItem {
+    id: string;
+    title: string;
+    snippet: string;
+    description: string;
+    url: string;
+    itemUrl: string;
+    thumbnailFilename: string;
+    thumbnailUrl: string;
+    tryitUrl: string;
+    typeKeywords: string[];
+    learnMoreUrl: string;
+    createdMs: number;
+    created: string;
+    modified: string;
+    numViews: number;
+    tags: string[];
+    categories: string[];
+    licenseInfo: string;
+    deployCommonId: string;
+    deployVersion: string;
+    canDelete: boolean;
+    canDeploy: boolean;
+    preview?: IPreview[];
+    sourcePortalUrl: string;
+    knownToBePublicSource: boolean;
+    waitId: string;
+    relatedSolutions: string[];
+}
+/**
+ * Converts a set of solution ids into a set of item ids.
+ *
+ * @param solutionIds Solution ids to convert
+ * @param solutionIdMappingToItemId Mapping from solution id to item id
+ * @returns Matching item ids
+ */
+export declare function convertSolutionIdsToItemIds(solutionIds: string[], solutionIdMappingToItemId: IKeyedStrings): string[];
+/**
+ * Creates a subset of a cache in which every item in the subcache has an id in the acceptableIds list.
+ *
+ * @param sourceCache Cache to filter
+ * @param acceptableIds Set of ids that can be in the subcache
+ * @returns Filtered cache
+ */
+export declare function createFilteredSubcache(sourceCache: ISolutionInfoCard[], acceptableIds: Set<string>): ISolutionInfoCard[];
+/**
+ * Extracts a range of entries from a cache.
+ *
+ * @param cache Source
+ * @param start1 One-based index into cache
+ * @param num Number of items to extract
+ * @returns Subset of cache and paging information
+ */
+export declare function extractFromCache<T>(cache: T[], start1: number, num: number): ICacheBatch<T>;
+/**
+ * Determines the session to use for a card based on the card's source portal URL and the user's session, if any.
+ *
+ * @param card Card to determine session for
+ * @param userSession User session
+ * @param anonAgolSession Anonymous AGO session
+ * @returns userSession or anonAgolSession, depending on the card's source portal URL and if the user is signed in
+ */
+export declare function getCardSession(card: ISolutionInfoCard, userSession: common.UserSession | undefined, anonAgolSession: common.UserSession | undefined): common.UserSession | undefined;
+/**
+ * Gets the related solutions for a set of cards.
+ *
+ * @param cards Cards that may have related solutions
+ * @param cardsToSearch Cards to search for related solutions
+ * @returns Set of deduped item ids of related solutions
+ */
+export declare function getDeployedRelatedSolutionIds(cards: ISolutionInfoCard[], cardsToSearch: ISolutionInfoCard[]): Set<string>;
+/**
+ * Searches a set of cards matching supplied solution ids and returns the related solution item ids for all matches.
+ *
+ * @param solutionIds Solutions to query for related solutions
+ * @param cards Cards to search for matches in list of solutionIds
+ * @returns Set of deduped item ids of related solutions
+ */
+export declare function getRelatedSolutions(solutionIds: string[], cards: ISolutionInfoCard[]): Set<string>;
+/**
+ * Gets the solution id of a card.
+ *
+ * @param card Card to examine
+ * @returns Solution id of card
+ */
+export declare function getSolutionId(card: ISolutionInfoCard): string | null;
+/**
+ * Gets the solution ids of a list of cards.
+ *
+ * @param cards Cards to examine
+ * @returns Solution ids of cards
+ */
+export declare function getSolutionIds(cards: ISolutionInfoCard[]): string[];
+/**
+ * Sorts a cache in-place based on a sort field and a sorting order.
+ *
+ * @param cache Cache to sort in-place
+ * @param sortField Cache item field to use for sort: "created" (deployed Solutions only), "numviews",
+ *  "relevance" (default), "title"
+ * @param sortOrder Sort direction for title and numviews fields: "asc" or "desc" (default)
+ * @returns The sorted cardCache input parameter
+ */
+export declare function sortCache(cache: helpers.ISortableItem[], sortField: string, sortOrder: string): helpers.ISortableItem[];
+/**
+ * Gets the related solutions for a card and adds their corresponding item ids to a supplied set of item ids.
+ *
+ * @param deployedCard Card that may have related solutions
+ * @param cardsToSearch Cards to search for related solutions
+ * @param relatedSolutions Set of item ids of related solutions
+ * @returns Updated set of deduped item ids of related solutions
+ */
+export declare function updateDeployedRelatedSolutionIds(deployedCard: ISolutionInfoCard, cardsToSearch: ISolutionInfoCard[], relatedSolutions: Set<string>): Set<string>;

package/dist/utils/deployAppContexts.d.ts

@@ -0,0 +1,12 @@
+import { UserSession } from '@esri/solution-common';
+import { Auth } from './Auth';
+export type { UserSession } from '@esri/solution-common';
+export declare const userSessionContext: {
+    __context__: UserSession;
+};
+export declare const isMobileContext: {
+    __context__: boolean;
+};
+export declare const authContext: {
+    __context__: Auth;
+};