@esri/solutions-components 1.0.0-next.20250521.1 → 1.0.0-next.20250527.1

package/dist/types/react.d.ts

@@ -176,7 +176,7 @@ interface ReactLayerList extends Partial<Pick<LayerList, 'applyLayerViewFilter'
   onlayersListLoaded?: EventHandler<HTMLLayerListElement["layersListLoaded"]>;
 }
 
-interface ReactLayerTable extends Partial<Pick<LayerTable, 'appLayout' | 'createFilterModal' | 'defaultGlobalId' | 'defaultLayerId' | 'defaultOid' | 'enableAutoRefresh' | 'enableColumnReorder' | 'enableCSV' | 'enableInlineEdit' | 'enableShare' | 'featureSelectionMode' | 'honorMapFieldSettings' | 'isMobile' | 'mapHidden' | 'mapInfo' | 'mapView' | 'selectedIds' | 'selectedRelatedIds' | 'shareIncludeEmbed' | 'shareIncludeSocial' | 'showNewestFirst' | 'showOnlyUpdatableLayers' | 'zoomAndScrollToSelected' | 'zoomToScale'>>, HTMLProps<HTMLLayerTableElement> {
+interface ReactLayerTable extends Partial<Pick<LayerTable, 'appLayout' | 'defaultGlobalId' | 'defaultLayerId' | 'defaultOid' | 'enableAutoRefresh' | 'enableColumnReorder' | 'enableCSV' | 'enableInlineEdit' | 'enableShare' | 'featureSelectionMode' | 'honorMapFieldSettings' | 'isMobile' | 'mapHidden' | 'mapInfo' | 'mapView' | 'selectedIds' | 'selectedRelatedIds' | 'shareIncludeEmbed' | 'shareIncludeSocial' | 'showNewestFirst' | 'showOnlyUpdatableLayers' | 'zoomAndScrollToSelected' | 'zoomToScale'>>, HTMLProps<HTMLLayerTableElement> {
   onfeatureSelectionChange?: EventHandler<HTMLLayerTableElement["featureSelectionChange"]>;
   onrelatedRecordToggled?: EventHandler<HTMLLayerTableElement["relatedRecordToggled"]>;
   onshowDelete?: EventHandler<HTMLLayerTableElement["showDelete"]>;
@@ -268,7 +268,7 @@ interface ReactSolutionDeleteDialog extends HTMLProps<HTMLSolutionDeleteDialogEl
 interface ReactSolutionDeployDialog extends HTMLProps<HTMLSolutionDeployDialogElement> {
 }
 
-interface ReactSolutionDeployPanel extends HTMLProps<HTMLSolutionDeployPanelElement> {
+interface ReactSolutionDeployPanel extends Partial<Pick<SolutionDeployPanel, 'solutionItem' | 'wkid'>>, HTMLProps<HTMLSolutionDeployPanelElement> {
 }
 
 interface ReactSolutionDeployedCard extends Partial<Pick<SolutionDeployedCard, 'deployedDate' | 'description' | 'heading' | 'itemId' | 'owner' | 'thumbnail' | 'updateAvailable'>>, HTMLProps<HTMLSolutionDeployedCardElement> {
@@ -345,10 +345,13 @@ interface ReactSolutionsArticles extends HTMLProps<HTMLSolutionsArticlesElement>
 interface ReactSolutionsArticlesShell extends HTMLProps<HTMLSolutionsArticlesShellElement> {
 }
 
-interface ReactSolutionsDeployedPanel extends HTMLProps<HTMLSolutionsDeployedPanelElement> {
+interface ReactSolutionsDeployedPanel extends Partial<Pick<SolutionsDeployedPanel, 'agoSolutionsGroupId' | 'enterpriseSolutionsGroupId' | 'locale' | 'orgUrl' | 'portalUrl' | 'sortType'>>, HTMLProps<HTMLSolutionsDeployedPanelElement> {
+  ondeployedCardsFetched?: EventHandler<HTMLSolutionsDeployedPanelElement["deployedCardsFetched"]>;
 }
 
-interface ReactSolutionsDeployedShell extends HTMLProps<HTMLSolutionsDeployedShellElement> {
+interface ReactSolutionsDeployedShell extends Partial<Pick<SolutionsDeployedShell, 'solutionsCount' | 'sortType'>>, HTMLProps<HTMLSolutionsDeployedShellElement> {
+  onfilterRemoved?: EventHandler<HTMLSolutionsDeployedShellElement["filterRemoved"]>;
+  ontokenRefreshed?: EventHandler<HTMLSolutionsDeployedShellElement["tokenRefreshed"]>;
 }
 
 interface ReactSolutionsFilterPanel extends Partial<Pick<SolutionsFilterPanel, 'isAIsettingEnabled' | 'isAllSolutions'>>, HTMLProps<HTMLSolutionsFilterPanelElement> {

package/dist/types/stencil.d.ts

@@ -176,7 +176,7 @@ interface StencilLayerList extends Partial<Pick<LayerList, 'applyLayerViewFilter
   onLayersListLoaded?: EventHandler<HTMLLayerListElement["layersListLoaded"]>;
 }
 
-interface StencilLayerTable extends Partial<Pick<LayerTable, 'appLayout' | 'createFilterModal' | 'defaultGlobalId' | 'defaultLayerId' | 'defaultOid' | 'enableAutoRefresh' | 'enableColumnReorder' | 'enableCSV' | 'enableInlineEdit' | 'enableShare' | 'featureSelectionMode' | 'honorMapFieldSettings' | 'isMobile' | 'mapHidden' | 'mapInfo' | 'mapView' | 'selectedIds' | 'selectedRelatedIds' | 'shareIncludeEmbed' | 'shareIncludeSocial' | 'showNewestFirst' | 'showOnlyUpdatableLayers' | 'zoomAndScrollToSelected' | 'zoomToScale'>>, StencilJsx.HTMLAttributes<HTMLLayerTableElement> {
+interface StencilLayerTable extends Partial<Pick<LayerTable, 'appLayout' | 'defaultGlobalId' | 'defaultLayerId' | 'defaultOid' | 'enableAutoRefresh' | 'enableColumnReorder' | 'enableCSV' | 'enableInlineEdit' | 'enableShare' | 'featureSelectionMode' | 'honorMapFieldSettings' | 'isMobile' | 'mapHidden' | 'mapInfo' | 'mapView' | 'selectedIds' | 'selectedRelatedIds' | 'shareIncludeEmbed' | 'shareIncludeSocial' | 'showNewestFirst' | 'showOnlyUpdatableLayers' | 'zoomAndScrollToSelected' | 'zoomToScale'>>, StencilJsx.HTMLAttributes<HTMLLayerTableElement> {
   onFeatureSelectionChange?: EventHandler<HTMLLayerTableElement["featureSelectionChange"]>;
   onRelatedRecordToggled?: EventHandler<HTMLLayerTableElement["relatedRecordToggled"]>;
   onShowDelete?: EventHandler<HTMLLayerTableElement["showDelete"]>;
@@ -268,7 +268,7 @@ interface StencilSolutionDeleteDialog extends StencilJsx.HTMLAttributes<HTMLSolu
 interface StencilSolutionDeployDialog extends StencilJsx.HTMLAttributes<HTMLSolutionDeployDialogElement> {
 }
 
-interface StencilSolutionDeployPanel extends StencilJsx.HTMLAttributes<HTMLSolutionDeployPanelElement> {
+interface StencilSolutionDeployPanel extends Partial<Pick<SolutionDeployPanel, 'solutionItem' | 'wkid'>>, StencilJsx.HTMLAttributes<HTMLSolutionDeployPanelElement> {
 }
 
 interface StencilSolutionDeployedCard extends Partial<Pick<SolutionDeployedCard, 'deployedDate' | 'description' | 'heading' | 'itemId' | 'owner' | 'thumbnail' | 'updateAvailable'>>, StencilJsx.HTMLAttributes<HTMLSolutionDeployedCardElement> {
@@ -345,10 +345,13 @@ interface StencilSolutionsArticles extends StencilJsx.HTMLAttributes<HTMLSolutio
 interface StencilSolutionsArticlesShell extends StencilJsx.HTMLAttributes<HTMLSolutionsArticlesShellElement> {
 }
 
-interface StencilSolutionsDeployedPanel extends StencilJsx.HTMLAttributes<HTMLSolutionsDeployedPanelElement> {
+interface StencilSolutionsDeployedPanel extends Partial<Pick<SolutionsDeployedPanel, 'agoSolutionsGroupId' | 'enterpriseSolutionsGroupId' | 'locale' | 'orgUrl' | 'portalUrl' | 'sortType'>>, StencilJsx.HTMLAttributes<HTMLSolutionsDeployedPanelElement> {
+  onDeployedCardsFetched?: EventHandler<HTMLSolutionsDeployedPanelElement["deployedCardsFetched"]>;
 }
 
-interface StencilSolutionsDeployedShell extends StencilJsx.HTMLAttributes<HTMLSolutionsDeployedShellElement> {
+interface StencilSolutionsDeployedShell extends Partial<Pick<SolutionsDeployedShell, 'solutionsCount' | 'sortType'>>, StencilJsx.HTMLAttributes<HTMLSolutionsDeployedShellElement> {
+  onFilterRemoved?: EventHandler<HTMLSolutionsDeployedShellElement["filterRemoved"]>;
+  onTokenRefreshed?: EventHandler<HTMLSolutionsDeployedShellElement["tokenRefreshed"]>;
 }
 
 interface StencilSolutionsFilterPanel extends Partial<Pick<SolutionsFilterPanel, 'isAIsettingEnabled' | 'isAllSolutions'>>, StencilJsx.HTMLAttributes<HTMLSolutionsFilterPanelElement> {

package/dist/utils/CardsFetcher.d.ts

@@ -1,3 +1,4 @@
+import { ICacheBatch, ISolutionInfoCard, ISearchOptionPartial } from './interfaces';
 /**
  * @license
  * Copyright 2025 Esri
@@ -14,26 +15,8 @@
  * 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;
@@ -56,13 +39,13 @@ export declare class CardsFetcher {
      *
      * @param card Card to add
      */
-    addToCache(card: cardsHelpers.ISolutionInfoCard): void;
+    addToCache(card: ISolutionInfoCard): void;
     /**
      * Returns the current cache.
      *
      * @returns Cards in the cache
      */
-    getCache(): cardsHelpers.ISolutionInfoCard[];
+    getCache(): ISolutionInfoCard[];
     /**
      * Removes a card to the cache to keep cache fresh between full refreshes.
      *
@@ -81,7 +64,7 @@ export declare class CardsFetcher {
      * @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>>;
+    requestAvailableSolutionCards(query: ISearchOptionPartial, primarySolutionsGroupId: string, agoBasedEnterpriseSolutionsGroupId: string, userSession: common.UserSession | undefined, pagingParams?: restTypes.IPagingParams, acceptableIds?: Set<string>): Promise<ICacheBatch<ISolutionInfoCard>>;
     /**
      * Fetches cards for deployed Solutions from the server.
      *
@@ -90,7 +73,7 @@ export declare class CardsFetcher {
      * @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>>;
+    requestDeployedSolutionCards(query: ISearchOptionPartial, userSession: common.UserSession | undefined): Promise<ICacheBatch<ISolutionInfoCard>>;
     /**
      * Stringifies categories for search.
      *

package/dist/utils/cardFetchingUtils.d.ts

@@ -0,0 +1,24 @@
+import { UserSession } from '@esri/solution-common';
+import { Auth } from './Auth';
+import { CardsFetcher } from './CardsFetcher';
+import { IDeployedSolutionCards, ISolutionInfoCard, SortOrder, SortType } from './interfaces';
+/**
+ * Generates a string containing the organization id and/or the organization owner if that information is
+ * available in the authentication.
+ *
+ * @param auth Authentication the authentication from global nave
+ * @param userSession UserSession the current rest js user session auth
+ * @param _cardsFetcher CardsFetcher instance of fetcher of all solutions
+ * @param _cardsFetcherDeployed CardsFetcher instance of fetcher of deployed solutions
+ * @param q string the query terms to fetch solutions with. Defaults to base query for deploying all deployed solutions.
+ * @param sortField SortType the field to sort cards by. Defaults to 'created'
+ * @param sortOrder SortOrder should the sort be ascending or descending. Defaults to descending.
+ * @param delay boolean Should the fecthing be delayed. Defaults to false.
+ * @param categories string[] Any filter categories that should be leveraged when fetching solutions.
+ * @param allCards ISolutionInfoCard[] All of the deployed solutions cards.
+ *
+ * @returns IDeployedSolutionCards that contains the fetched solution card details and
+ * String with key/value pairs for org id and/or org owner; string is prefixed with a space so that it
+ * can be added to an AGO query; empty string returnd if neither property is available
+ */
+export declare function getDeployedSolutions(auth: Auth, userSession: UserSession, _cardsFetcher: CardsFetcher, _cardsFetcherDeployed: CardsFetcher, q?: string, sortField?: SortType, sortOrder?: SortOrder, delay?: boolean, categories?: string[], allCards?: ISolutionInfoCard[]): Promise<IDeployedSolutionCards | undefined>;

package/dist/utils/cardsHelpers.d.ts

@@ -1,3 +1,4 @@
+import { ICacheBatch, IKeyedStrings, ISolutionInfoCard, ISortableItem } from './interfaces';
 /**
  * @license
  * Copyright 2025 Esri
@@ -15,52 +16,6 @@
  * 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.
  *
@@ -134,7 +89,7 @@ export declare function getSolutionIds(cards: ISolutionInfoCard[]): string[];
  * @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[];
+export declare function sortCache(cache: ISortableItem[], sortField: string, sortOrder: string): ISortableItem[];
 /**
  * Gets the related solutions for a card and adds their corresponding item ids to a supplied set of item ids.
  *

package/dist/utils/helpers.d.ts

@@ -1,3 +1,4 @@
+import { ISpatialReference, IURLParamPair, TEnvironments } from './interfaces';
 /**
  * @license
  * Copyright 2025 Esri
@@ -15,27 +16,6 @@
  * limitations under the License.
  */
 import * as common from "@esri/solution-common";
-import * as restTypes from "@esri/arcgis-rest-types";
-export type TEnvironments = "dev" | "qa" | "prod";
-export interface ICacheBatch<T> {
-    cards: T[];
-    paging: restTypes.IPagedResponse;
-}
-export interface ISortableItem {
-    createdMs: number;
-    numViews: number;
-    title: string;
-    [key: string]: any;
-}
-export interface ISpatialReference {
-    label: string;
-    wkid: number;
-    defaultExtent: string;
-}
-export interface IURLParamPair {
-    "k": string;
-    "v": string;
-}
 /**
  * Generates a URL search string from a set of key/value pairs.
  *

package/dist/utils/interfaces.d.ts

@@ -2,6 +2,7 @@
 import { IDeployFileCopyPath, IItemTemplate } from '@esri/solution-common';
 import { MapPicker } from '../components/map-picker/customElement.js';
 import { MapLayerPicker } from '../components/map-layer-picker/customElement.js';
+import * as restTypes from "@esri/arcgis-rest-types";
 export declare enum EImageDisplayType {
     GRID = "GRID",
     GALLERY = "GALLERY"
@@ -510,7 +511,8 @@ export interface ISolutionTypeHover {
     entering: boolean;
 }
 export type ChipType = 'updated' | 'deployed' | 'none';
-export type SortType = "relevance" | "title" | "numviews" | "new" | "updated" | "suggested";
+export type SortType = "relevance" | "title" | "numviews" | "new" | "updated" | "suggested" | "created";
+export type SortOrder = 'asc' | 'desc';
 export type FilterType = "type" | "industry" | "domain" | "owner";
 export declare enum EIndustry {
     AEC = "Architecture, Engineering, and Construction (AEC)",
@@ -580,6 +582,15 @@ export interface ISolutionDetailsCard {
     itemId: string;
     thumbnail: string;
 }
+export interface ISolutionDeployedCard {
+    deployedDate: string;
+    description: string;
+    heading: string;
+    itemId: string;
+    owner: string;
+    thumbnail: string;
+    updateAvailable: boolean;
+}
 export declare enum ECustomPrivileges {
     HUBPREMIUM = "solutions:hubPremium",
     NOTEBOOK = "solutions:notebook",
@@ -594,3 +605,85 @@ export declare enum EPrivileges {
     VELOCITYFEEDS = "portal:publisher:publishFeeds",
     VELOCITYREALTIME = "portal:publisher:publishRealTimeAnalytics"
 }
+export interface IDeployedSolutionCards {
+    cards: ISolutionInfoCard[];
+    relatedSolutions: Set<string>;
+}
+export declare const BASE_DEPLOYED_TERMS = "((typekeywords:Solution,Deployed,\"ArcGIS Solution\") OR ((typekeywords:Solution,Deployed) AND (created:[1577862000000 TO 1622576880000])))";
+export declare const BASE_SOLUTIONS_TERMS = "(typekeywords:Solution,Template)";
+export declare const BASE_DISPLAY_ONLY_TERMS = "(typekeywords:Solution,Display Only)";
+export interface ISearchOptionPartial {
+    "q": string;
+    "filter": string;
+    "sortField": string;
+    "sortOrder": string;
+    "nextStart"?: any;
+    "categories": string[];
+    "delay": boolean;
+    "getSuggested"?: boolean;
+}
+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 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[];
+    owner: string;
+}
+export type TEnvironments = "dev" | "qa" | "prod";
+export interface ICacheBatch<T> {
+    cards: T[];
+    paging: restTypes.IPagedResponse;
+}
+export interface ISortableItem {
+    createdMs: number;
+    numViews: number;
+    title: string;
+    [key: string]: any;
+}
+export interface ISpatialReference {
+    label: string;
+    wkid: number;
+    defaultExtent: string;
+}
+export interface IURLParamPair {
+    "k": string;
+    "v": string;
+}