@zealicsolutions/web-ui 1.0.140-beta.220 → 1.0.140-beta.222

package/dist/cjs/helpers/utils.d.ts

@@ -70,10 +70,16 @@ export interface ResolvedDataDrivenLink {
  *
  * ## Data-Driven Link Resolution
  *
- * ### Link Type Detection
- * The `dataDrivenLinkType` field references a picklist value: `{ id, code, label }`
- * - Internal: `code === "internal"` or `label === "Internal"`
- * - External: `code === "external"` or `label === "External"`
+ * ### Link Type Detection (Priority Order)
+ * 1. **Data-driven type**: If `dataDrivenLinkType` is configured AND has data:
+ *    - References a picklist value: `{ id, code, label }`
+ *    - Internal: `code === "internal"` or `label === "Internal"`
+ *    - External: `code === "external"` or `label === "External"`
+ *
+ * 2. **Smart inference**: If type not resolved from data (field not connected or no data):
+ *    - Only `externalLinkFieldId` configured → inferred as **external**
+ *    - Only `internalLinkFieldId` configured → inferred as **internal**
+ *    - Both configured without type data → link disabled (cannot infer)
  *
  * ### Internal Links
  * Uses `internalLinkFieldId` to get the target page ID:
@@ -92,8 +98,15 @@ export interface ResolvedDataDrivenLink {
  * @returns Resolved link details or null if link cannot be resolved (disabled state)
  *
  * @example
- * // External URL
- * // Data: { externalLinkFieldId: { value: 'https://example.com' } }
+ * // External URL with data-driven type
+ * // Data: { linkTypeField: { code: 'external' }, urlField: { value: 'https://example.com' } }
+ * const result = resolveDataDrivenLink(link, data);
+ * // Returns: { destination: 'https://example.com', isExternal: true }
+ *
+ * @example
+ * // External URL with smart inference (no dataDrivenLinkType connected)
+ * // Config: { externalLinkFieldId: 'urlField' } (no internalLinkFieldId)
+ * // Data: { urlField: { value: 'https://example.com' } }
  * const result = resolveDataDrivenLink(link, data);
  * // Returns: { destination: 'https://example.com', isExternal: true }
  *
@@ -101,7 +114,7 @@ export interface ResolvedDataDrivenLink {
  * // Internal page with internalTaskTagId
  * // Data: { internalLinkFieldId: { id: '777a77bc-a0d4-4bdd-933b-9a343daa7891' } }
  * const result = resolveDataDrivenLink(link, data);
- * // Returns: { destination: '?internalTaskTagId=777a77bc-...', isExternal: false, internalTaskTagId: '777a77bc-...' }
+ * // Returns: { destination: '?internalTaskTagId=777a77bc-...', isExternal: false, webpageAlias: '777a77bc-...' }
  */
 export declare const resolveDataDrivenLink: (link: LinkProperties, rawItemDataByDmfId: Record<string, unknown> | undefined) => ResolvedDataDrivenLink | null;
 export declare const addInternalParamsToCurrentLink: (internalLink?: Nullable<string>, isPreview?: boolean) => string | undefined;