@pega/custom-dx-components 26.1.11 → 26.1.12-alpha.0.2

package/src/ai/catalog/references/pconnect-state-config.md

@@ -0,0 +1,316 @@
+# PConnect: State & Configuration Management, Data Access
+
+> Part of the [PCore / PConnect API Reference skills](../README.md). Methods documented here are called on a `PConnect` instance (`pConn`), obtained via the `getPConnect()` prop passed to every component.
+
+## `getStateProps()`
+
+**Purpose:** Returns the reactive properties bound to state for the current component — the properties that trigger a re-render when they change.
+
+**Signature:**
+
+```typescript
+getStateProps(): Record<string, unknown>
+```
+
+**Example:**
+
+```typescript
+const pConn = getPConnect();
+const currentValue = pConn.getStateProps().value;
+```
+
+---
+
+## `getConfigProps(destinationObject?)`
+
+**Purpose:** Returns the fully resolved configuration props for the component — annotations such as `@P` (property references) and `@L` (localized text) are resolved to their live values.
+
+**Signature:**
+
+```typescript
+getConfigProps(destinationObject?: Record<string, unknown>): Record<string, unknown>
+```
+
+**Example:**
+
+```typescript
+const MyComponent = ({ getPConnect }) => {
+  const pConn = getPConnect();
+  const { label, value } = pConn.getConfigProps();
+  return null;
+};
+```
+
+**Notes:** This is the primary way a component reads its resolved configuration — prefer it over reading raw, unresolved metadata.
+
+---
+
+## `populateAdditionalProps(configData)`
+
+**Purpose:** Populates component-specific properties that aren't part of the raw configuration — for example, page/case/HTTP messages, validation messages, and stage info — directly onto the given config object.
+
+**Signature:**
+
+```typescript
+populateAdditionalProps(configData: Record<string, unknown>): void
+```
+
+**Example:**
+
+```typescript
+const configData = pConn.getConfigProps();
+pConn.populateAdditionalProps(configData);
+// configData now also has any applicable validatemessage/pageMessages/httpMessages/stages props
+```
+
+---
+
+## `getRawMetadata()`
+
+**Purpose:** Returns the component's complete, unresolved metadata (`type`, `config`, `children`).
+
+**Signature:**
+
+```typescript
+getRawMetadata(): { type: string; config?: Record<string, unknown>; children?: unknown[] }
+```
+
+**Example:**
+
+```typescript
+const rawMetadata = pConn.getRawMetadata();
+```
+
+**Notes:** Prefer `getConfigProps()` for most use cases; use `getRawMetadata()` only when you specifically need the unresolved shape (for example, to inspect `children`).
+
+---
+
+## `resolveConfigProps(configProps, destinationObject?)`
+
+**Purpose:** Resolves a given props object (for example, one containing `@P` property references) against the component's context.
+
+**Signature:**
+
+```typescript
+resolveConfigProps(configProps: Record<string, unknown>, destinationObject?: Record<string, unknown>): Record<string, unknown>
+```
+
+**Example:**
+
+```typescript
+const resolvedParams = pConn.resolveConfigProps(rawParameters);
+```
+
+---
+
+## `registerAdditionalProps(additionalMeta?)`
+
+**Purpose:** Resolves and registers an additional props object so it is merged into subsequent `getConfigProps()` calls.
+
+**Signature:**
+
+```typescript
+registerAdditionalProps(additionalMeta?: Record<string, unknown>): Record<string, unknown>
+```
+
+**Example:**
+
+```typescript
+useEffect(() => {
+  pConn.registerAdditionalProps({ readOnly: true });
+});
+```
+
+---
+
+## `deRegisterAdditionalProps(deRegisterKeys?)`
+
+**Purpose:** Removes previously registered additional prop keys so they no longer appear in `getConfigProps()` output.
+
+**Signature:**
+
+```typescript
+deRegisterAdditionalProps(deRegisterKeys?: string[]): boolean
+```
+
+**Example:**
+
+```typescript
+pConn.registerAdditionalProps({ label: 'Custom label' });
+// ...later, once the override is no longer needed
+pConn.deRegisterAdditionalProps(['label']);
+```
+
+---
+
+## `getInheritedProps()`
+
+**Purpose:** Returns props inherited from a parent view reference's configuration — used to cascade values (for example, a label override) down into a reused view.
+
+**Signature:**
+
+```typescript
+getInheritedProps(): Record<string, unknown>
+```
+
+**Example:**
+
+```typescript
+const parentProps = getPConnect().getInheritedProps();
+const label = parentProps.label ?? defaultLabel;
+```
+
+---
+
+## `setInheritedProp(propName, value)`
+
+**Purpose:** Sets a single inherited prop that propagates to the component and all of its children.
+
+**Signature:**
+
+```typescript
+setInheritedProp(propName: string, value: unknown): void
+```
+
+**Example:**
+
+```typescript
+pConn.setInheritedProp('displayMode', 'DISPLAY_ONLY');
+```
+
+---
+
+## `setInheritedConfig(rawConfig)`
+
+**Purpose:** Merges select configuration fields (for example, `readOnly`, `displayMode`, `hideLabel`) into the component's inherited configuration.
+
+**Signature:**
+
+```typescript
+setInheritedConfig(rawConfig: Record<string, unknown>): void
+```
+
+**Example:**
+
+```typescript
+childPConn.setInheritedConfig({ readOnly: true, displayMode: null });
+```
+
+---
+
+## `getValue(prop, pageReference?)`
+
+**Purpose:** Resolves and returns a property's current value from the application state, relative to the component's (or a given) page reference.
+
+**Signature:**
+
+```typescript
+getValue(prop: string, pageReference?: string): unknown
+```
+
+**Example:**
+
+```typescript
+const firstName = pConn.getValue('.FirstName');
+```
+
+**Notes:** This is one of the most commonly used PConnect APIs — nearly every field-reading component uses it.
+
+---
+
+## `setValue(prop, value, initialValue?, isImplicit?, options?)`
+
+**Purpose:** Writes a value to a property in the application state.
+
+**Signature:**
+
+```typescript
+setValue(
+  prop: string,
+  value: { [key: string]: any } | undefined,
+  initialValue?: string,
+  isImplicit?: boolean,
+  options?: { isArrayDeepMerge?: boolean }
+): void
+```
+
+**Example:**
+
+```typescript
+pConn.setValue('.FirstName', 'Jane' as unknown as { [key: string]: any });
+```
+
+**Notes:** The 5.1.0 typedefs type `value` as `{ [key: string]: any } | undefined`, even though the typedef's own example passes a string; a primitive therefore needs a cast to compile (as in the example above). For field-editing components, prefer `pConn.getActionsApi().updateFieldValue()` or `triggerFieldChange()`, which also handle message clearing and validation — see [pconnect-actions-api.md](./pconnect-actions-api.md).
+
+---
+
+## `replaceState(prop, value, options?)`
+
+**Purpose:** Fully replaces (rather than merges) the state value at a given property or page path.
+
+**Signature:**
+
+```typescript
+replaceState(prop: string, value: unknown, options?: { skipDirtyValidation?: boolean }): void
+```
+
+**Example:**
+
+```typescript
+pConn.replaceState('.Address', { Country: 'US', State: 'MA' });
+```
+
+---
+
+## `updateState(dataObject)`
+
+**Purpose:** Deep-merges a data object into the store at the component's root page reference.
+
+**Signature:**
+
+```typescript
+updateState(dataObject: Record<string, unknown>): void
+```
+
+**Example:**
+
+```typescript
+const response = await fetchRelatedData();
+pConn.updateState({ relatedRecords: response.data });
+```
+
+---
+
+## `resolveDatasourceReference(datasourceRef)`
+
+**Purpose:** Resolves a data-page-backed reference (for example, `D_MyDataPage`) against the current context's cached list summaries.
+
+**Signature:**
+
+```typescript
+resolveDatasourceReference(datasourceRef: string): unknown
+```
+
+**Example:**
+
+```typescript
+const resolvedReference = pConn.resolveDatasourceReference('D_MyDataPage');
+```
+
+---
+
+## `getCurrentClassID()`
+
+**Purpose:** Returns the class ID (Pega class name) for the component's current context.
+
+**Signature:**
+
+```typescript
+getCurrentClassID(): string
+```
+
+**Example:**
+
+```typescript
+const classID = pConn.getCurrentClassID();
+```

package/src/ai/catalog/references/pconnect-validation-api.md

@@ -0,0 +1,45 @@
+# ValidationApi
+
+> Part of the [PCore / PConnect API Reference skills](../README.md). Obtained via `pConn.getValidationApi()`.
+
+## `validate(value, propertyName?)`
+
+**Purpose:** Validates a field's value against the validators configured on that field, and updates the field's validation message in application state.
+
+**Signature:**
+
+```typescript
+validate(value: string, propertyName?: string): { status: boolean; message?: string }
+```
+
+**Example:**
+
+```typescript
+const result = pConn.getValidationApi().validate(inputValue);
+if (!result.status) {
+  // result.message contains the validation error
+}
+```
+
+---
+
+## `validateEmail(value, options?)`
+
+**Purpose:** Validates an email address (RFC 5322 by default, or RFC 822 if requested) without automatically displaying errors on the field — the result is returned directly to the caller.
+
+**Signature:**
+
+```typescript
+validateEmail(value: string, options?: { useRFC822Validation?: boolean }): { status: 'success' } | { status: 'failure'; message: string }
+```
+
+**Example:**
+
+```typescript
+const result = pConn.getValidationApi().validateEmail(emailValue);
+if (result.status === 'failure') {
+  // show result.message next to the email field
+}
+```
+
+**Notes:** Unlike `validate()`, this does not write anything to application state — it's a pure validation utility for custom error handling.

package/src/ai/catalog/references/pcore-analytics-genai-details.md

@@ -0,0 +1,50 @@
+# Analytics & GenAI — Method Details
+
+> Part of the [PCore / PConnect API Reference skills](../README.md). Companion to [pcore-case-collaboration-genai.md](./pcore-case-collaboration-genai.md), which covers the top-level `PCore.get*()` accessors. This file catalogs the methods available on the objects those accessors return.
+
+## AnalyticsUtils (via `PCore.getAnalyticsUtils()`)
+
+| Method                                                                  | Signature                                                                                         | Purpose                                                              |
+| ----------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------- |
+| `getInsightIDs()`                                                       | `(): Promise<unknown>`                                                                            | Retrieves all available insight IDs.                                 |
+| `getInsightByID(insightID)`                                             | `(insightID: string): Promise<unknown>`                                                           | Retrieves metadata for a specific insight.                           |
+| `getDataObjects()`                                                      | `(): Promise<unknown>`                                                                            | Retrieves the list of data objects corresponding to data/case types. |
+| `getDataPageObjects(useCache?)`                                         | `(useCache?: boolean): Promise<unknown>`                                                          | Retrieves the list of data objects corresponding to data pages.      |
+| `getDefaultColumns(payload)`                                            | `(payload: { reportName: string; className: string }): Promise<unknown>`                          | Retrieves the default columns configured for a report.               |
+| `getFieldsForDataSource(dataViewName, skipStoreCheck, context)`         | `(dataViewName: string, skipStoreCheck: boolean, context: string): Promise<unknown>`              | Retrieves the fields configured for a data view.                     |
+| `getPrimaryFieldsForDataSource(dataViewName?, dataViewClassName?)`      | `(dataViewName?: string, dataViewClassName?: string): Promise<unknown>`                           | Retrieves the primary fields for a data view.                        |
+| `getDataViewMetadata(dataViewName, skipStoreCheck, associationFilter?)` | `(dataViewName: string, skipStoreCheck: boolean, associationFilter?: string[]): Promise<unknown>` | Retrieves and caches metadata for a data view.                       |
+| `translateStrings(stringsToTranslate)`                                  | `(stringsToTranslate: string): Promise<unknown>`                                                  | Translates a list of strings.                                        |
+
+**Example:**
+
+```typescript
+const insightIDs = await PCore.getAnalyticsUtils().getInsightIDs();
+```
+
+---
+
+## GenAIAssistantUtils (via `PCore.getGenAIAssistantUtils()`)
+
+| Method                                                                                  | Signature                                                                                                             | Purpose                                                       |
+| --------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------- |
+| `createConversation(contextID, assistantID, context, cancelTokenSource?)` | `(contextID: string, assistantID: string, context: string, cancelTokenSource?: CancelTokenSource[]): Promise<ConversationResponse>` | Starts a conversation with a GenAI Assistant. Resolves to `{ data: { ID, response, suggestedPrompts, ... } }` — the conversation ID is `conversation.data.ID`. |
+| `createConversationForAgent(contextID, agentID, context, cancelTokenSource?, config?)` | `(contextID: string, agentID: string, context: string, cancelTokenSource?: CancelTokenSource[], config?: CreateConversationConfig): Promise<ConversationResponse>` | Starts a conversation with an Agent. Resolves to the same `ConversationResponse` shape (`conversation.data.ID`). |
+| `sendMessage(assistantID, conversationID, message, context, config?)` | `(assistantID: string, conversationID: string, message: string, context: string, config?: SendMessageConfig): Promise<AxiosResponse>` | Sends a message in an Assistant conversation. `SendMessageConfig` requires `enableStreaming: boolean`. |
+| `sendMessageForAgent(agentID, conversationID, message, context, attachments?, config?)` | `(agentID: string, conversationID: string, message: string, context: string, attachments?: Attachment[], config?: SendMessageConfig): Promise<AxiosResponse>` | Sends a message in an Agent conversation. |
+| `getConversations(assistantID, contextID, pageSize, pageIndex, context, cancelTokenSource?)` | `(assistantID: string, contextID: string, pageSize: number, pageIndex: number, context: string, cancelTokenSource?: CancelTokenSource[]): Promise<AxiosResponse>` | Retrieves a paginated list of Assistant conversations. |
+| `getConversationsForAgent(agentID, contextID, pageSize, pageIndex, context, cancelTokenSource?)` | `(agentID: string, contextID: string, pageSize: number, pageIndex: number, context: string, cancelTokenSource?: CancelTokenSource[]): Promise<AxiosResponse>` | Retrieves a paginated list of Agent conversations. |
+| `getMessages(assistantID, conversationID, context, cancelTokenSource?)` | `(assistantID: string, conversationID: string, context: string, cancelTokenSource?: CancelTokenSource[]): Promise<AxiosResponse>` | Retrieves messages from an Assistant conversation. Resolves to an Axios response (not an array) — the payload is on `.data`; its inner shape is not typed in the 5.1.0 typedefs (`any`). |
+| `getMessagesForAgent(agentID, conversationID, context, cancelTokenSource?)` | `(agentID: string, conversationID: string, context: string, cancelTokenSource?: CancelTokenSource[]): Promise<AxiosResponse>` | Retrieves messages from an Agent conversation (Axios response; payload on `.data`, inner shape untyped). |
+| `getAgent(agentID, context, contextID, cancelTokenSource?)` | `(agentID: string, context: string, contextID: string, cancelTokenSource?: CancelTokenSource[]): Promise<AxiosResponse>` | Retrieves details for a configured Agent. |
+| `getCoach(assistantID, context, contextID, cancelTokenSource?)` | `(assistantID: string, context: string, contextID: string, cancelTokenSource?: CancelTokenSource[]): Promise<AxiosResponse>` | Retrieves details for a configured GenAI Coach (Assistant). |
+| `likeAgentMessage(agentID, conversationID, messageID, context)` | `(agentID: string, conversationID: string, messageID: string, context: string): Promise<AxiosResponse>` | Likes a message in an Agent conversation. |
+| `unLikeAgentMessage(agentID, conversationID, messageID, context, feedbackText?)` | `(agentID: string, conversationID: string, messageID: string, context: string, feedbackText?: string): Promise<AxiosResponse>` | Removes a like from a message, optionally with feedback text. |
+
+**Example:**
+
+```typescript
+const { createConversation, sendMessage } = PCore.getGenAIAssistantUtils();
+const conversation = await createConversation(contextID, assistantID, context);
+await sendMessage(assistantID, conversation.data.ID, userMessage, context);
+```

package/src/ai/catalog/references/pcore-bootstrap-init-details.md

@@ -0,0 +1,121 @@
+# Bootstrap, Initialisation & Component Registry — Method Details
+
+> Part of the [PCore / PConnect API Reference skills](../README.md). Companion to [pcore-bootstrap-registry-routing.md](./pcore-bootstrap-registry-routing.md), which covers the top-level `PCore.get*()` accessors. This file catalogs the methods available on the objects those accessors return.
+>
+> **Audience note:** `Initialiser` and `BootstrapUtils` are almost entirely used by the portal shell / SDK bridge layer during application startup — a typical custom component does not call these directly. They're cataloged here for completeness (for example, if you're building a custom SDK bridge or embedding integration), but most component authors can skip this section entirely.
+
+## ComponentsRegistry (via `PCore.getComponentsRegistry()`)
+
+| Method                                                     | Signature                                           | Purpose                                                  |
+| ---------------------------------------------------------- | --------------------------------------------------- | -------------------------------------------------------- |
+| `register(componentName, component)`                       | `(componentName: string, component: unknown): void` | Registers a component descriptor with the registry.      |
+| `getComponent(componentName)`                              | `(componentName: string): unknown`                  | Returns a registered component descriptor by name.       |
+| `registerLazyMap(componentName, component)`                | `(componentName: string, component: unknown): void` | Registers a component for lazy (deferred) loading.       |
+| `getLazyComponent(componentName)`                          | `(componentName: string): unknown`                  | Returns a lazily-loaded component by name.               |
+| `registerCustomComponentLazyMap(componentName, component)` | `(componentName: string, component: unknown): void` | Registers a custom component for lazy loading.           |
+| `getCustomComponent(componentName)`                        | `(componentName: string): unknown`                  | Returns a lazily-loaded custom component by name.        |
+| `mergeComponentsMap(componentsMap?)`                       | `(componentsMap?: unknown): void`                   | Merges a map of component descriptors into the registry. |
+| `mergeOverrideMap(overrideMap?)`                           | `(overrideMap?: unknown): void`                     | Merges a map of component overrides into the registry.   |
+| `getOverrideMap()`                                         | `(): unknown`                                       | Returns the current override map.                        |
+| `getLazyMap()`                                             | `(): unknown`                                       | Returns the current lazy-component map.                  |
+
+**Example:**
+
+```typescript
+const registry = PCore.getComponentsRegistry();
+registry.register('MyCustomWidget', { component: MyCustomWidgetComponent });
+```
+
+---
+
+## Initialiser (via `PCore.getInitialiser()`)
+
+| Method                                                                                                                                             | Signature                                                                       | Purpose                                                            |
+| -------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------- | ------------------------------------------------------------------ |
+| `init(configObj)`                                                                                                                                  | `(configObj: unknown): Promise<void>`                                           | Initializes the application with the given configuration.          |
+| `start(config, callback?)`                                                                                                                         | `(config: unknown, callback?: () => void): Promise<boolean>`                    | Initiates bootstrapping and loads component libraries.             |
+| `configureTheme(theme?)`                                                                                                                           | `(theme?: unknown): void`                                                       | Configures light/dark theme settings. Not in the 5.1.0 typedefs, so TypeScript may need a cast (e.g. `(PCore.getInitialiser() as any).configureTheme(...)`). |
+| `getBootstrapConfig(restServerUrl, tokenInfo)`                                                                                                     | `(restServerUrl: string, tokenInfo: unknown): Promise<unknown>`                 | Fetches the bootstrap configuration from the server.               |
+| `initCoreContainers(options?)`                                                                                                                     | `(options?: { containerType?: string }): unknown`                               | Initializes core containers and returns a `getPConnect` function.  |
+| `initCoreConfig(config)`                                                                                                                           | `(config: unknown): Promise<void>`                                              | Initializes core configuration, routing, and history.              |
+| `launchPortal(targetDom, portalName, containerTargetName?, preLoadComponents?, ccLibs?)`                                                           | `(...): Promise<unknown>`                                                       | Launches the portal shell into a DOM target.                       |
+| `launchView(targetDom, viewMetadata, preLoadComponents, runtimeParams, portalTarget, styleSheetTarget, containerTargetName)`                      | `(...): void`                                                                   | Launches a specific view into a DOM target. All 7 arguments are required (`preLoadComponents` is typed `string[] \| undefined`, so pass `undefined` explicitly if unused). |
+| `launchViewByName(targetDom, viewName, portalName, viewClass, additionalComponents, portalTarget, styleSheetTarget, containerTargetName, ccLibs?)` | `(...): Promise<void>`                                                          | Launches a view identified by name into a DOM target.              |
+| `launchMashup(targetDom, usePegaMashupStyling?, ccLibs?)`                                                                                          | `(targetDom: string, usePegaMashupStyling?: boolean, ccLibs?: unknown[]): void` | Launches a mashup/embed into a DOM target.                         |
+| `loadEnvironmentInfoFromDataPage(config)`                                                                                                          | `(config: unknown): Promise<void>`                                              | Loads environment information from the environment-info data page. |
+| `loadDataPagesIntoEnvironmentInfo(dataPages)`                                                                                                      | `(dataPages: unknown[]): Promise<void>`                                         | Merges specified data page results into environment info.          |
+| `loadEnvironmentInfo(config)`                                                                                                                      | `(config: unknown): Promise<void>`                                              | Loads theme, branding, and key-mapping info from configuration.    |
+| `loadCustomComponentLibrariesIfEnabled(ccLibs)`                                                                                                    | `(ccLibs: unknown[]): Promise<void>`                                            | Conditionally loads custom component libraries if enabled.         |
+| `loadCustomComponentLibraries(ccLibs)`                                                                                                             | `(ccLibs: unknown[]): Promise<void>`                                            | Loads all custom component libraries from the given list.          |
+| `importSingleCustomComponent(ccLib)`                                                                                                               | `(ccLib: unknown): Promise<void>`                                               | Imports a single custom component.                                 |
+| `importReactRoot()`                                                                                                                                | `(): Promise<unknown>`                                                          | Imports the React root component module.                           |
+| `importDesignSystemComponentMap(appStaticContentServer, environmentId, alternateDesignSystemName)`                                                 | `(...): Promise<void>`                                                          | Dynamically loads an alternate design system's component map.      |
+| `buildSemanticUrl(pathInfo, queryParams, noPortal, restServer, viewName)`                                                                          | `(...): string`                                                                 | Constructs a semantic URL from path and query information.         |
+| `registerForDebugInfo(channel)`                                                                                                                    | `(channel: unknown): void`                                                      | Registers a debug-message handler and enables preview mode.        |
+| `toggleTracerHeaders(channel)`                                                                                                                     | `(channel: unknown): void`                                                      | Toggles tracer headers on/off based on channel messages.           |
+
+**Example:**
+
+```typescript
+PCore.getInitialiser()
+  .start(bootstrapConfig)
+  .then(() => {
+    // application is ready
+  });
+```
+
+---
+
+## BootstrapUtils (via `PCore.getBootstrapUtils()`)
+
+| Method                                                                                                                            | Signature                                                            | Purpose                                                            |
+| --------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------- | ------------------------------------------------------------------ |
+| `loadRootComponent(domContainerID, componentMetaData, additionalComponents?, portalTarget?, styleSheetTarget?, removeContainer?)` | `(...): Promise<void>`                                               | Renders the root container and loads the component tree.           |
+| `renderApp(translatedDXAPIResponse, domContainerID)`                                                                              | `(translatedDXAPIResponse: unknown, domContainerID: string): void`   | Renders the application from a DX API response.                    |
+| `updateStoreWithUiRoot(dxAPIResponse, containerName, isPortal)`                                                                   | `(...): Promise<void>`                                               | Updates application state with a UI root response.                 |
+| `loadComponent(componentConfig, domContainerID, additionalComponents)`                                                            | `(...): Promise<void>`                                               | Loads and renders a single component.                              |
+| `loadView(dxAPIResponse, domContainerID, additionalComponents?)`                                                                  | `(...): Promise<void>`                                               | Loads view metadata and renders the application.                   |
+| `loadViewByName(viewName, portalName, viewClass, containerName)`                                                                  | `(...): void`                                                        | Loads a view by name into a container.                             |
+| `loadPortalView(portalName, containerName)`                                                                                       | `(portalName: string, containerName: string): void`                  | Loads the portal shell and renders it.                             |
+| `loadMashup(targetDom, usePegaMashupStyling?)`                                                                                    | `(targetDom: string, usePegaMashupStyling?: boolean): Promise<void>` | Loads a Constellation mashup into a DOM target.                    |
+| `bootstrapWithAuthHeader(config, target, preLoadComponents?, portalTarget?, styleSheetTarget?)`                                   | `(...): Promise<void>`                                               | Runs a full bootstrap sequence with an authorization header.       |
+| `getBootstrapConfig(restServerUrl, tokenInfo)`                                                                                    | `(restServerUrl: string, tokenInfo: unknown): Promise<unknown>`      | Fetches the bootstrap configuration via a direct fetch call.       |
+| `getBootstrapConfigViaSB(restServerUrl, additionalHeaders, themeID)`                                                              | `(...): Promise<unknown>`                                            | Fetches bootstrap configuration via the service broker.            |
+| `getBootstrapConfigExtended(restServerUrl, authorizationHeader, additionalHeaders, themeID, customCookies, locale)`               | `(...): Promise<unknown>`                                            | Fetches bootstrap configuration with theme/locale parameters.      |
+| `getLPConfig(restServerUrl, authorizationHeader, additionalHeaders, customCookies)`                                               | `(...): Promise<unknown>`                                            | Fetches Launchpad environment configuration.                       |
+| `applyEnvironmentInfoResponse(config)`                                                                                            | `(config: unknown): Promise<unknown>`                                | Parses and applies an environment-info server response.            |
+| `initAppShell(appRoutingTable, actionsTargetModel, servicesObj)`                                                                  | `(...): void`                                                        | Initializes routing, actions, and services for the app shell.      |
+| `initRoutingTable(appRoutingTable, servicesObj)`                                                                                  | `(appRoutingTable: unknown, servicesObj: unknown): void`             | Initializes routing and services only.                             |
+| `initStore()`                                                                                                                     | `(): void`                                                           | Initializes the application state store.                           |
+| `enableAppRouting(enableRouting)`                                                                                                 | `(enableRouting: boolean): void`                                     | Enables or disables application routing.                           |
+| `setAppAlias(appAlias)`                                                                                                           | `(appAlias: string): void`                                           | Sets the application alias used for asset loading.                 |
+| `setStaticServerUrl(staticUrl, appStaticUrl, b2sJWT)`                                                                             | `(staticUrl: string, appStaticUrl: string, b2sJWT: string): void`    | Configures the static asset server URLs.                           |
+| `setFetchDefaultHeaders(headersObj)`                                                                                              | `(headersObj: unknown): void`                                        | Sets default HTTP headers applied to all requests.                 |
+| `setFetchAuthInfo(authInfo)`                                                                                                      | `(authInfo: unknown): void`                                          | Sets authentication information used by outgoing requests.         |
+| `setFieldsDefaultConfigs(config)`                                                                                                 | `(config: unknown): void`                                            | Sets default field configurations.                                 |
+| `setGoogleMapsAPIKey(googleMapsAPIKey)`                                                                                           | `(googleMapsAPIKey: string): void`                                   | Configures the Google Maps API key.                                |
+| `getHomeRestApi(portalName)`                                                                                                      | `(portalName: string): string`                                       | Returns the REST path to a portal's home endpoint.                 |
+| `getViewRestApi(viewID, viewClass)`                                                                                               | `(viewID: string, viewClass: string): string`                        | Returns the REST path to a view endpoint.                          |
+| `getCaseApi()`                                                                                                                    | `(): unknown`                                                        | Returns the case API module.                                       |
+| `getMashupApi()`                                                                                                                  | `(): unknown`                                                        | Returns the mashup API module.                                     |
+| `getContextUtils()`                                                                                                               | `(): unknown`                                                        | Returns the context utilities module.                              |
+| `getRoutingManager()`                                                                                                             | `(): unknown`                                                        | Returns the routing manager module.                                |
+| `getComponentsRegistry()`                                                                                                         | `(): ComponentsRegistry`                                             | Returns the components registry instance.                          |
+| `getStateManager()`                                                                                                               | `(): unknown`                                                        | Returns the state manager module.                                  |
+| `createC11nEnv(meta)`                                                                                                             | `(meta: unknown): PConnect`                                          | Creates a `PConnect` (`C11nEnv`) object from metadata.             |
+| `configureForBrowserBookmark(payload)`                                                                                            | `(payload: unknown): void`                                           | Publishes browser bookmark configuration.                          |
+| `checkIfSemanticURL()`                                                                                                            | `(): boolean`                                                        | Checks whether the current URL is a semantic URL.                  |
+| `onPCoreReady(callback)`                                                                                                          | `(callback: Function): void`                                         | Registers a callback for when the render infrastructure is ready.  |
+| `onPCoreCleanup(callback)`                                                                                                        | `(callback: Function): void`                                         | Registers a callback for when the application should be unmounted. |
+
+**Example:**
+
+```typescript
+PCore.getBootstrapUtils()
+  .loadRootComponent('app-root', rootContainer, [], rootElement, stylesElement, true)
+  .then(() => {
+    // root component is ready
+  });
+```
+
+**Notes:** Several `BootstrapUtils` methods overlap with dedicated top-level `PCore.*` accessors (for example, `PCore.onPCoreReady()`, `PCore.configureForBrowserBookmark()`) — prefer the top-level `PCore.*` accessor when one exists, and reach for `getBootstrapUtils()` only for lower-level bootstrap customization not otherwise exposed.