@wise/dynamic-flow-types 4.14.0-experimental-2996a75 → 4.15.0

package/build/spec/feature/subflow/DynamicLaunchConfig.d.ts

@@ -1,7 +1,7 @@
 import type { Request } from '../../misc/Request';
 import type { Presentation } from './Presentation';
 /**
-* Launches a [Subflow] that is powered by Dynamic Flow.
+* Launches a [com.wise.dynamicflow.feature.subflow.Subflow] that is powered by Dynamic Flow.
 * The subflow must be started with a request to the server.
 */
 export type DynamicLaunchConfig = {

package/build/spec/feature/subflow/LaunchConfig.d.ts

@@ -1,6 +1,13 @@
 import type { DynamicLaunchConfig } from './DynamicLaunchConfig';
+import type { NativeLaunchConfig } from './NativeLaunchConfig';
 /**
-* Describes how a [Subflow] should be launched.
+* Describes how a [com.wise.dynamicflow.feature.subflow.Subflow] should be launched.
+* There are two launch config types:
+* - [com.wise.dynamicflow.feature.subflow.DynamicLaunchConfig] starts another Dynamic Flow from a server request.
+* - [com.wise.dynamicflow.feature.subflow.NativeLaunchConfig] routes to a native subflow handler registered on
+*   the client.
+* Both launch types use the same [com.wise.dynamicflow.feature.subflow.Subflow] callbacks for completion,
+* failure, and result merging.
 */
-export type LaunchConfig = DynamicLaunchConfig;
+export type LaunchConfig = DynamicLaunchConfig | NativeLaunchConfig;
 //# sourceMappingURL=LaunchConfig.d.ts.map

package/build/spec/feature/subflow/LaunchConfig.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"LaunchConfig.d.ts","sourceRoot":"","sources":["../../../../src/spec/feature/subflow/LaunchConfig.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAA;AAEhE;;EAEE;AACF,MAAM,MAAM,YAAY,GAAG,mBAAmB,CAAC"}
+{"version":3,"file":"LaunchConfig.d.ts","sourceRoot":"","sources":["../../../../src/spec/feature/subflow/LaunchConfig.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAA;AAChE,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAA;AAE9D;;;;;;;;EAQE;AACF,MAAM,MAAM,YAAY,GAAG,mBAAmB,GAAG,kBAAkB,CAAC"}

package/build/spec/feature/subflow/NativeLaunchConfig.d.ts

@@ -0,0 +1,58 @@
+import type { JsonElement } from '../../JsonElement';
+/**
+* Launches a [com.wise.dynamicflow.feature.subflow.Subflow] that is handled by native platform functionality.
+* Native subflows let a DF flow hand off to functionality that cannot be implemented within the spec,
+* while still using the standard subflow completion and error callbacks. This is useful for platform capabilities
+* and SDKs, for example, biometric authentication, passkey enrolment, permissions, or external SDKs.
+* The native flow must be handled by a native subflow handler registered on the client. The `id` in this launch
+* config is used to route to that handler, and will match the capability ID that the client advertises in the
+* `X-DF-Native-Capabilities` header.
+* If the client receives a native launch config and cannot find a handler for the `id`, the subflow is treated as failed
+* and the parent subflow's `onError` behavior is triggered.
+* Native subflow handler integration is platform-specific, so reasonable divergence between clients is expected
+* when it helps provide the most complete implementation.
+* ## When to use
+* - When a flow needs to launch a native capability, browser capability, or SDK that Dynamic Flow cannot render.
+* - When the parent flow needs a structured result from that native capability before continuing.
+* - When clients with a registered handler should get a native experience and other clients should get a fallback.
+* ## When not to use
+* - To custom render components of a DF step, continue to use traditional custom rendering solutions.
+* ## Checking support
+* We expect simple client platform and version checks to be sufficient for most use cases. Some use cases need
+* more in-depth information about the client integration. Backend implementations can use
+* [com.wise.dynamicflow.misc.NativeCapabilities] before returning a native subflow when they need more specific
+* information, such as SDK version requirements or whether a supported native subflow has the required hardware
+* available.
+* Integrations report their IDs by default because IDs are mandatory at integration sites. Integrations can also
+* provide comments for more detailed capability information.
+* ## Result handling
+* Dynamic Flow passes the `id`, optional `payload`, and any additional context required by the platform to the
+* native handler. On success, the handler
+* returns a JSON-compatible result. If `onCompletion` is an [com.wise.dynamicflow.feature.ActionBehavior], that
+* result is merged into the action payload using `resultKey`, following the same rules as a dynamic subflow.
+* ## Payload guidance
+* Use `payload` for configuration that the native handler needs to launch the experience. Keep it small, stable,
+* and specific to the handler. Clients should not include the payload in analytics.
+* ## Experience
+* Unlike dynamic subflows, native subflows only have as much control over the navigation stack as the platform
+* allows. It is generally the handler's responsibility to decide the navigation semantics.
+*/
+export type NativeLaunchConfig = {
+    /**
+    * It must be `native`.
+    */
+    type: 'native';
+    /**
+    * Identifies which native flow should be launched.
+    * This ID must match a handler registered on the client platform. By convention, it should also match the
+    * capability ID advertised by the client in the `X-DF-Native-Capabilities` header.
+    */
+    id: string;
+    /**
+    * Optional configuration payload for the native flow.
+    * The structure is determined by the native handler implementation. The payload should contain only the
+    * configuration needed to launch the native experience, and should not be included in analytics.
+    */
+    payload?: JsonElement;
+};
+//# sourceMappingURL=NativeLaunchConfig.d.ts.map

package/build/spec/feature/subflow/NativeLaunchConfig.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"NativeLaunchConfig.d.ts","sourceRoot":"","sources":["../../../../src/spec/feature/subflow/NativeLaunchConfig.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAA;AAEpD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAqCE;AACF,MAAM,MAAM,kBAAkB,GAAG;IAC7B;;MAEE;IACF,IAAI,EAAE,QAAQ,CAAC;IACf;;;;MAIE;IACF,EAAE,EAAE,MAAM,CAAC;IACX;;;;MAIE;IACF,OAAO,CAAC,EAAE,WAAW,CAAC;CACzB,CAAC"}

package/build/spec/index.d.ts

@@ -16,6 +16,7 @@ export type { ActionBehavior } from './feature/ActionBehavior';
 export type { Behavior } from './feature/Behavior';
 export type { CopyBehavior } from './feature/CopyBehavior';
 export type { DismissBehavior } from './feature/DismissBehavior';
+export type { DownloadBehavior } from './feature/DownloadBehavior';
 export type { LinkBehavior } from './feature/LinkBehavior';
 export type { ModalBehavior } from './feature/ModalBehavior';
 export type { RefreshBehavior } from './feature/RefreshBehavior';
@@ -42,7 +43,6 @@ export type { AlertLayoutCallToAction } from './layout/AlertLayoutCallToAction';
 export type { BoxLayout } from './layout/BoxLayout';
 export type { ButtonLayout } from './layout/ButtonLayout';
 export type { ColumnsLayout } from './layout/ColumnsLayout';
-export type { CollectionLayout, CollectionCallToAction, CollectionFilter, CollectionSearch, CollectionState, CollectionSection, CollectionItem, CollectionResponse, } from './layout/CollectionLayout';
 export type { DecisionLayout } from './layout/DecisionLayout';
 export type { DecisionLayoutOption } from './layout/DecisionLayoutOption';
 export type { DividerLayout } from './layout/DividerLayout';

package/build/spec/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/spec/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/spec/index.ts"],"names":[],"mappings":"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"}

package/build/spec/layout/AlertLayout.d.ts

@@ -4,6 +4,11 @@ import type { AlertLayoutCallToAction } from './AlertLayoutCallToAction';
 /**
 * Show an attention-grabbing message.
 * Alerts can be used to communicate important messages to the user, drawing more attention than a standard paragraph or info layout.
+* <!-- fixture: alert -->
+* ## When to use
+* - When the user needs to perform an action, or be aware of some key information that may impact them.
+* ## When not to use
+* - When the content is supplementary, consider using an [UpsellLayout] instead.
 */
 export type AlertLayout = {
     /**

package/build/spec/layout/AlertLayout.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"AlertLayout.d.ts","sourceRoot":"","sources":["../../../src/spec/layout/AlertLayout.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,iBAAiB,CAAA;AAC9C,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,cAAc,CAAA;AACxC,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,2BAA2B,CAAA;AAExE;;;EAGE;AACF,MAAM,MAAM,WAAW,GAAG;IACtB;;MAEE;IACF,IAAI,EAAE,OAAO,CAAC;IACd;;;MAGE;IACF,QAAQ,EAAE,MAAM,CAAC;IACjB;;MAEE;IACF,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB;;MAEE;IACF,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB;;MAEE;IACF,MAAM,CAAC,EAAE,IAAI,CAAC;IACd;;MAEE;IACF,YAAY,CAAC,EAAE,uBAAuB,CAAC;IACvC;;MAEE;IACF,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB;;MAEE;IACF,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;CACnB,CAAC"}
+{"version":3,"file":"AlertLayout.d.ts","sourceRoot":"","sources":["../../../src/spec/layout/AlertLayout.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,iBAAiB,CAAA;AAC9C,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,cAAc,CAAA;AACxC,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,2BAA2B,CAAA;AAExE;;;;;;;;EAQE;AACF,MAAM,MAAM,WAAW,GAAG;IACtB;;MAEE;IACF,IAAI,EAAE,OAAO,CAAC;IACd;;;MAGE;IACF,QAAQ,EAAE,MAAM,CAAC;IACjB;;MAEE;IACF,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB;;MAEE;IACF,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB;;MAEE;IACF,MAAM,CAAC,EAAE,IAAI,CAAC;IACd;;MAEE;IACF,YAAY,CAAC,EAAE,uBAAuB,CAAC;IACvC;;MAEE;IACF,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB;;MAEE;IACF,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;CACnB,CAAC"}

package/build/spec/layout/AlertLayoutCallToAction.d.ts

@@ -1,7 +1,7 @@
 import type { Behavior } from '../feature/Behavior';
 import type { Context } from '../misc/Context';
 /**
-* The call to action configuration to be used by the Alert.
+* The call to action configuration to be used by [com.wise.dynamicflow.layout.AlertLayout].
 */
 export type AlertLayoutCallToAction = {
     /**
@@ -13,7 +13,7 @@ export type AlertLayoutCallToAction = {
     */
     accessibilityDescription?: string;
     /**
-    * Behavior that should be performed when user interacts with call to action.
+    * The [com.wise.dynamicflow.feature.Behavior] that should be performed when user interacts with call to action.
     */
     behavior: Behavior;
     /**

package/build/spec/layout/BoxLayout.d.ts

@@ -2,6 +2,7 @@ import type { Layout } from './Layout';
 import type { Size } from '../misc/Size';
 /**
 * A container for a group of components with an optional border.
+* <!-- fixture: box -->
 */
 export type BoxLayout = {
     /**

package/build/spec/layout/BoxLayout.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"BoxLayout.d.ts","sourceRoot":"","sources":["../../../src/spec/layout/BoxLayout.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,UAAU,CAAA;AACtC,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,cAAc,CAAA;AAExC;;EAEE;AACF,MAAM,MAAM,SAAS,GAAG;IACpB;;MAEE;IACF,IAAI,EAAE,KAAK,CAAC;IACZ;;MAEE;IACF,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB;;MAEE;IACF,KAAK,CAAC,EAAE,IAAI,CAAC;IACb;;;MAGE;IACF,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB;;MAEE;IACF,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB;;MAEE;IACF,MAAM,CAAC,EAAE,IAAI,CAAC;IACd;;MAEE;IACF,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB;;MAEE;IACF,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;CACnB,CAAC"}
+{"version":3,"file":"BoxLayout.d.ts","sourceRoot":"","sources":["../../../src/spec/layout/BoxLayout.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,UAAU,CAAA;AACtC,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,cAAc,CAAA;AAExC;;;EAGE;AACF,MAAM,MAAM,SAAS,GAAG;IACpB;;MAEE;IACF,IAAI,EAAE,KAAK,CAAC;IACZ;;MAEE;IACF,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB;;MAEE;IACF,KAAK,CAAC,EAAE,IAAI,CAAC;IACb;;;MAGE;IACF,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB;;MAEE;IACF,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB;;MAEE;IACF,MAAM,CAAC,EAAE,IAAI,CAAC;IACd;;MAEE;IACF,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB;;MAEE;IACF,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;CACnB,CAAC"}

package/build/spec/layout/ButtonLayout.d.ts

@@ -5,7 +5,7 @@ import type { Context } from '../misc/Context';
 import type { Media } from '../misc/media/Media';
 /**
 * A component which performs a [com.wise.dynamicflow.feature.Behavior] when pressed.
-* You can affect the button appearance using the "control" and "context" properties.
+* <!-- fixture: button -->
 */
 export type ButtonLayout = {
     /**

package/build/spec/layout/ColumnsLayout.d.ts

@@ -4,6 +4,7 @@ import type { Size } from '../misc/Size';
 /**
 * Allows content to be displayed in two columns.
 * If screen space is limited, the contents will be collapsed into a single column.
+* <!-- fixture: columns -->
 */
 export type ColumnsLayout = {
     /**

package/build/spec/layout/ColumnsLayout.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ColumnsLayout.d.ts","sourceRoot":"","sources":["../../../src/spec/layout/ColumnsLayout.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,UAAU,CAAA;AACtC,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAA;AAC5D,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,cAAc,CAAA;AAExC;;;EAGE;AACF,MAAM,MAAM,aAAa,GAAG;IACxB;;MAEE;IACF,IAAI,EAAE,SAAS,CAAC;IAChB;;MAEE;IACF,IAAI,EAAE,MAAM,EAAE,CAAC;IACf;;MAEE;IACF,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB;;MAEE;IACF,IAAI,CAAC,EAAE,iBAAiB,CAAC;IACzB;;MAEE;IACF,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB;;MAEE;IACF,MAAM,CAAC,EAAE,IAAI,CAAC;IACd;;MAEE;IACF,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB;;MAEE;IACF,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;CACnB,CAAC"}
+{"version":3,"file":"ColumnsLayout.d.ts","sourceRoot":"","sources":["../../../src/spec/layout/ColumnsLayout.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,UAAU,CAAA;AACtC,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAA;AAC5D,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,cAAc,CAAA;AAExC;;;;EAIE;AACF,MAAM,MAAM,aAAa,GAAG;IACxB;;MAEE;IACF,IAAI,EAAE,SAAS,CAAC;IAChB;;MAEE;IACF,IAAI,EAAE,MAAM,EAAE,CAAC;IACf;;MAEE;IACF,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB;;MAEE;IACF,IAAI,CAAC,EAAE,iBAAiB,CAAC;IACzB;;MAEE;IACF,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB;;MAEE;IACF,MAAM,CAAC,EAAE,IAAI,CAAC;IACd;;MAEE;IACF,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB;;MAEE;IACF,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;CACnB,CAAC"}

package/build/spec/layout/DecisionLayout.d.ts

@@ -1,7 +1,14 @@
 import type { DecisionLayoutOption } from './DecisionLayoutOption';
 import type { Size } from '../misc/Size';
 /**
-* A set of options which each perform an [com.wise.dynamicflow.feature.Action].
+* A set of options which each perform a [com.wise.dynamicflow.feature.Behavior].
+* <!-- fixture: decision -->
+* ## When to use
+* - When the only (or primary) way for a user to progress is to choose between a set of options.
+*   For example, choosing a country, or the type of document they wish to verify with.
+* ## When not to use
+* - When each option represents an entity which is being managed, consider using a [com.wise.dynamicflow.layout.ListLayout] instead.
+*   For example, managing a list of bank cards or recipients.
 */
 export type DecisionLayout = {
     /**

package/build/spec/layout/DecisionLayout.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"DecisionLayout.d.ts","sourceRoot":"","sources":["../../../src/spec/layout/DecisionLayout.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAA;AAClE,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,cAAc,CAAA;AAExC;;EAEE;AACF,MAAM,MAAM,cAAc,GAAG;IACzB;;MAEE;IACF,IAAI,EAAE,UAAU,CAAC;IACjB;;MAEE;IACF,KAAK,CAAC,EAAE,MAAM,CAAC;IACf;;MAEE;IACF,OAAO,EAAE,oBAAoB,EAAE,CAAC;IAChC;;MAEE;IACF,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB;;MAEE;IACF,MAAM,CAAC,EAAE,IAAI,CAAC;IACd;;MAEE;IACF,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB;;MAEE;IACF,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;CACnB,CAAC"}
+{"version":3,"file":"DecisionLayout.d.ts","sourceRoot":"","sources":["../../../src/spec/layout/DecisionLayout.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAA;AAClE,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,cAAc,CAAA;AAExC;;;;;;;;;EASE;AACF,MAAM,MAAM,cAAc,GAAG;IACzB;;MAEE;IACF,IAAI,EAAE,UAAU,CAAC;IACjB;;MAEE;IACF,KAAK,CAAC,EAAE,MAAM,CAAC;IACf;;MAEE;IACF,OAAO,EAAE,oBAAoB,EAAE,CAAC;IAChC;;MAEE;IACF,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB;;MAEE;IACF,MAAM,CAAC,EAAE,IAAI,CAAC;IACd;;MAEE;IACF,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB;;MAEE;IACF,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;CACnB,CAAC"}

package/build/spec/layout/DividerLayout.d.ts

@@ -1,6 +1,7 @@
 import type { Size } from '../misc/Size';
 /**
 * A divider can be used to create a visual separation between elements
+* <!-- fixture: divider -->
 */
 export type DividerLayout = {
     /**

package/build/spec/layout/DividerLayout.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"DividerLayout.d.ts","sourceRoot":"","sources":["../../../src/spec/layout/DividerLayout.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,cAAc,CAAA;AAExC;;EAEE;AACF,MAAM,MAAM,aAAa,GAAG;IACxB;;MAEE;IACF,IAAI,EAAE,SAAS,CAAC;IAChB;;MAEE;IACF,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB;;MAEE;IACF,MAAM,CAAC,EAAE,IAAI,CAAC;IACd;;MAEE;IACF,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB;;MAEE;IACF,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;CACnB,CAAC"}
+{"version":3,"file":"DividerLayout.d.ts","sourceRoot":"","sources":["../../../src/spec/layout/DividerLayout.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,cAAc,CAAA;AAExC;;;EAGE;AACF,MAAM,MAAM,aAAa,GAAG;IACxB;;MAEE;IACF,IAAI,EAAE,SAAS,CAAC;IAChB;;MAEE;IACF,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB;;MAEE;IACF,MAAM,CAAC,EAAE,IAAI,CAAC;IACd;;MAEE;IACF,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB;;MAEE;IACF,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;CACnB,CAAC"}

package/build/spec/layout/HeadingLayout.d.ts

@@ -2,6 +2,7 @@ import type { Size } from '../misc/Size';
 import type { Align } from '../misc/Align';
 /**
 * A heading which can be used to title or separate sections of a layout.
+* <!-- fixture: heading -->
 */
 export type HeadingLayout = {
     /**

package/build/spec/layout/HeadingLayout.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"HeadingLayout.d.ts","sourceRoot":"","sources":["../../../src/spec/layout/HeadingLayout.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,cAAc,CAAA;AACxC,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,eAAe,CAAA;AAE1C;;EAEE;AACF,MAAM,MAAM,aAAa,GAAG;IACxB;;MAEE;IACF,IAAI,EAAE,SAAS,CAAC;IAChB;;MAEE;IACF,IAAI,EAAE,MAAM,CAAC;IACb;;MAEE;IACF,IAAI,CAAC,EAAE,IAAI,CAAC;IACZ;;MAEE;IACF,KAAK,CAAC,EAAE,KAAK,CAAC;IACd;;MAEE;IACF,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB;;MAEE;IACF,MAAM,CAAC,EAAE,IAAI,CAAC;IACd;;MAEE;IACF,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB;;MAEE;IACF,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;CACnB,CAAC"}
+{"version":3,"file":"HeadingLayout.d.ts","sourceRoot":"","sources":["../../../src/spec/layout/HeadingLayout.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,cAAc,CAAA;AACxC,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,eAAe,CAAA;AAE1C;;;EAGE;AACF,MAAM,MAAM,aAAa,GAAG;IACxB;;MAEE;IACF,IAAI,EAAE,SAAS,CAAC;IAChB;;MAEE;IACF,IAAI,EAAE,MAAM,CAAC;IACb;;MAEE;IACF,IAAI,CAAC,EAAE,IAAI,CAAC;IACZ;;MAEE;IACF,KAAK,CAAC,EAAE,KAAK,CAAC;IACd;;MAEE;IACF,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB;;MAEE;IACF,MAAM,CAAC,EAAE,IAAI,CAAC;IACd;;MAEE;IACF,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB;;MAEE;IACF,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;CACnB,CAAC"}

package/build/spec/layout/ImageLayout.d.ts

@@ -4,6 +4,8 @@ import type { Align } from '../misc/Align';
 /**
 * An Image, specified by URI. Accepted schemes are `http`, `https` and `urn`.
 * Relative URL or paths, are also supported.
+* This layout has been superseded by [com.wise.dynamicflow.layout.MediaLayout]. If you can,
+* consider using that instead.
 */
 export type ImageLayout = {
     /**

package/build/spec/layout/ImageLayout.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ImageLayout.d.ts","sourceRoot":"","sources":["../../../src/spec/layout/ImageLayout.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,eAAe,CAAA;AAC1C,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,cAAc,CAAA;AACxC,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,eAAe,CAAA;AAE1C;;;EAGE;AACF,MAAM,MAAM,WAAW,GAAG;IACtB;;MAEE;IACF,IAAI,EAAE,OAAO,CAAC;IACd;;MAEE;IACF,IAAI,CAAC,EAAE,MAAM,CAAC;IACd;;MAEE;IACF,GAAG,CAAC,EAAE,MAAM,CAAC;IACb;;MAEE;IACF,wBAAwB,CAAC,EAAE,MAAM,CAAC;IAClC;;MAEE;IACF,OAAO,CAAC,EAAE,KAAK,CAAC;IAChB;;;;;MAKE;IACF,IAAI,CAAC,EAAE,IAAI,CAAC;IACZ;;MAEE;IACF,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB;;MAEE;IACF,MAAM,CAAC,EAAE,IAAI,CAAC;IACd;;MAEE;IACF,KAAK,CAAC,EAAE,KAAK,CAAC;IACd;;MAEE;IACF,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB;;MAEE;IACF,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;CACnB,CAAC"}
+{"version":3,"file":"ImageLayout.d.ts","sourceRoot":"","sources":["../../../src/spec/layout/ImageLayout.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,eAAe,CAAA;AAC1C,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,cAAc,CAAA;AACxC,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,eAAe,CAAA;AAE1C;;;;;EAKE;AACF,MAAM,MAAM,WAAW,GAAG;IACtB;;MAEE;IACF,IAAI,EAAE,OAAO,CAAC;IACd;;MAEE;IACF,IAAI,CAAC,EAAE,MAAM,CAAC;IACd;;MAEE;IACF,GAAG,CAAC,EAAE,MAAM,CAAC;IACb;;MAEE;IACF,wBAAwB,CAAC,EAAE,MAAM,CAAC;IAClC;;MAEE;IACF,OAAO,CAAC,EAAE,KAAK,CAAC;IAChB;;;;;MAKE;IACF,IAAI,CAAC,EAAE,IAAI,CAAC;IACZ;;MAEE;IACF,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB;;MAEE;IACF,MAAM,CAAC,EAAE,IAAI,CAAC;IACd;;MAEE;IACF,KAAK,CAAC,EAAE,KAAK,CAAC;IACd;;MAEE;IACF,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB;;MAEE;IACF,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;CACnB,CAAC"}

package/build/spec/layout/InstructionsLayout.d.ts

@@ -2,6 +2,13 @@ import type { InstructionsLayoutItem } from './InstructionsLayoutItem';
 import type { Size } from '../misc/Size';
 /**
 * A list of fields used to inform the user of actions to do and not do.
+* <!-- fixture: instructions -->
+* ## When to use
+* - When providing a list of things the user should and should not do, for example,
+*   when creating a password, DO use something unique, with special characters. DON'T use your date of birth.
+* ## When not to use
+* - When building a list of items which have positive/negative sentiments but are not instructions, consider using a [com.wise.dynamicflow.layout.StatusListLayout] instead.
+*   For example, a list of features which are and aren't included in a subscription.
 */
 export type InstructionsLayout = {
     /**

package/build/spec/layout/InstructionsLayout.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"InstructionsLayout.d.ts","sourceRoot":"","sources":["../../../src/spec/layout/InstructionsLayout.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,0BAA0B,CAAA;AACtE,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,cAAc,CAAA;AAExC;;EAEE;AACF,MAAM,MAAM,kBAAkB,GAAG;IAC7B;;MAEE;IACF,IAAI,EAAE,cAAc,CAAC;IACrB;;MAEE;IACF,KAAK,CAAC,EAAE,MAAM,CAAC;IACf;;MAEE;IACF,KAAK,EAAE,sBAAsB,EAAE,CAAC;IAChC;;MAEE;IACF,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB;;MAEE;IACF,MAAM,CAAC,EAAE,IAAI,CAAC;IACd;;MAEE;IACF,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB;;MAEE;IACF,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;CACnB,CAAC"}
+{"version":3,"file":"InstructionsLayout.d.ts","sourceRoot":"","sources":["../../../src/spec/layout/InstructionsLayout.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,0BAA0B,CAAA;AACtE,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,cAAc,CAAA;AAExC;;;;;;;;;EASE;AACF,MAAM,MAAM,kBAAkB,GAAG;IAC7B;;MAEE;IACF,IAAI,EAAE,cAAc,CAAC;IACrB;;MAEE;IACF,KAAK,CAAC,EAAE,MAAM,CAAC;IACf;;MAEE;IACF,KAAK,EAAE,sBAAsB,EAAE,CAAC;IAChC;;MAEE;IACF,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB;;MAEE;IACF,MAAM,CAAC,EAAE,IAAI,CAAC;IACd;;MAEE;IACF,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB;;MAEE;IACF,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;CACnB,CAAC"}

package/build/spec/layout/ItemCallToAction.d.ts

@@ -1,7 +1,7 @@
 import type { Behavior } from '../feature/Behavior';
 import type { Context } from '../misc/Context';
 /**
-* The call to action configuration to be used by the status list item.
+* The call to action configuration to be used by the [com.wise.dynamicflow.layout.StatusListLayout.Item].
 */
 export type ItemCallToAction = {
     /**
@@ -13,7 +13,7 @@ export type ItemCallToAction = {
     */
     accessibilityDescription?: string;
     /**
-    * Behavior that should be performed when user interacts with call to action.
+    * The [com.wise.dynamicflow.feature.Behavior] that should be performed when user interacts with call to action.
     */
     behavior: Behavior;
     /**

package/build/spec/layout/Layout.d.ts

@@ -1,7 +1,6 @@
 import type { AlertLayout } from './AlertLayout';
 import type { BoxLayout } from './BoxLayout';
 import type { ButtonLayout } from './ButtonLayout';
-import { CollectionLayout } from './CollectionLayout';
 import type { ColumnsLayout } from './ColumnsLayout';
 import type { DecisionLayout } from './DecisionLayout';
 import type { DividerLayout } from './DividerLayout';
@@ -24,7 +23,7 @@ import type { StatusListLayout } from './StatusListLayout';
 import type { TabsLayout } from './TabsLayout';
 import type { UpsellLayout } from './UpsellLayout';
 /**
- * Layouts allow you to display information to the user and customise how a step is structured.
- */
-export type Layout = AlertLayout | BoxLayout | ButtonLayout | CollectionLayout | ColumnsLayout | DecisionLayout | DividerLayout | FormLayout | HeadingLayout | ImageLayout | InfoLayout | InstructionsLayout | ListLayout | LoadingIndicatorLayout | MarkdownLayout | MediaLayout | ModalLayout | ParagraphLayout | ProgressLayout | ReviewLayout | SearchLayout | SectionLayout | StatusListLayout | TabsLayout | UpsellLayout;
+* Layouts allow you to display information to the user and customise how a step is structured.
+*/
+export type Layout = AlertLayout | BoxLayout | ButtonLayout | ColumnsLayout | DecisionLayout | DividerLayout | FormLayout | HeadingLayout | ImageLayout | InfoLayout | InstructionsLayout | ListLayout | LoadingIndicatorLayout | MarkdownLayout | MediaLayout | ModalLayout | ParagraphLayout | ProgressLayout | ReviewLayout | SearchLayout | SectionLayout | StatusListLayout | TabsLayout | UpsellLayout;
 //# sourceMappingURL=Layout.d.ts.map

package/build/spec/layout/Layout.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Layout.d.ts","sourceRoot":"","sources":["../../../src/spec/layout/Layout.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AACjD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAC7C,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AACnD,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AACtD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AACrD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AACvD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AACrD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC/C,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AACrD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AACjD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC/C,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAC/D,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC/C,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,0BAA0B,CAAC;AACvE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AACvD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AACjD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AACjD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACzD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AACvD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AACnD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AACnD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AACrD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAC3D,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC/C,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAEnD;;GAEG;AACH,MAAM,MAAM,MAAM,GACd,WAAW,GACX,SAAS,GACT,YAAY,GACZ,gBAAgB,GAChB,aAAa,GACb,cAAc,GACd,aAAa,GACb,UAAU,GACV,aAAa,GACb,WAAW,GACX,UAAU,GACV,kBAAkB,GAClB,UAAU,GACV,sBAAsB,GACtB,cAAc,GACd,WAAW,GACX,WAAW,GACX,eAAe,GACf,cAAc,GACd,YAAY,GACZ,YAAY,GACZ,aAAa,GACb,gBAAgB,GAChB,UAAU,GACV,YAAY,CAAC"}
+{"version":3,"file":"Layout.d.ts","sourceRoot":"","sources":["../../../src/spec/layout/Layout.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,eAAe,CAAA;AAChD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAA;AAC5C,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAA;AAClD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAA;AACpD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAA;AACtD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAA;AACpD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,cAAc,CAAA;AAC9C,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAA;AACpD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,eAAe,CAAA;AAChD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,cAAc,CAAA;AAC9C,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAA;AAC9D,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,cAAc,CAAA;AAC9C,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,0BAA0B,CAAA;AACtE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAA;AACtD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,eAAe,CAAA;AAChD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,eAAe,CAAA;AAChD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAA;AACxD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAA;AACtD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAA;AAClD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAA;AAClD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAA;AACpD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAA;AAC1D,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,cAAc,CAAA;AAC9C,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAA;AAElD;;EAEE;AACF,MAAM,MAAM,MAAM,GAAG,WAAW,GAAG,SAAS,GAAG,YAAY,GAAG,aAAa,GAAG,cAAc,GAAG,aAAa,GAAG,UAAU,GAAG,aAAa,GAAG,WAAW,GAAG,UAAU,GAAG,kBAAkB,GAAG,UAAU,GAAG,sBAAsB,GAAG,cAAc,GAAG,WAAW,GAAG,WAAW,GAAG,eAAe,GAAG,cAAc,GAAG,YAAY,GAAG,YAAY,GAAG,aAAa,GAAG,gBAAgB,GAAG,UAAU,GAAG,YAAY,CAAC"}

package/build/spec/layout/ListLayout.d.ts

@@ -3,6 +3,13 @@ import type { ListLayoutItem } from './ListLayoutItem';
 import type { Size } from '../misc/Size';
 /**
 * A list of read-only fields displaying information with optional images or icons for the user.
+* <!-- fixture: list -->
+* ## When to use
+* - When each item represents an entity with meaning to the user.
+* - When building experiences to manage/edit a list of entities, for example a list of saved bank cards.
+* ## When not to use
+* - When each item represents a choice, rather than an existing entity, consider using a [com.wise.dynamicflow.layout.DecisionLayout] instead.
+* - If the purpose of the list is to provide a summary of information which the user needs to check, consider using a [com.wise.dynamicflow.layout.ReviewLayout] instead.
 */
 export type ListLayout = {
     /**

package/build/spec/layout/ListLayout.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ListLayout.d.ts","sourceRoot":"","sources":["../../../src/spec/layout/ListLayout.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,0BAA0B,CAAA;AACtE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAA;AACtD,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,cAAc,CAAA;AAExC;;EAEE;AACF,MAAM,MAAM,UAAU,GAAG;IACrB;;MAEE;IACF,IAAI,EAAE,MAAM,CAAC;IACb;;MAEE;IACF,KAAK,CAAC,EAAE,MAAM,CAAC;IACf;;MAEE;IACF,YAAY,CAAC,EAAE,sBAAsB,CAAC;IACtC;;MAEE;IACF,KAAK,EAAE,cAAc,EAAE,CAAC;IACxB;;MAEE;IACF,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB;;MAEE;IACF,MAAM,CAAC,EAAE,IAAI,CAAC;IACd;;MAEE;IACF,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB;;MAEE;IACF,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;CACnB,CAAC"}
+{"version":3,"file":"ListLayout.d.ts","sourceRoot":"","sources":["../../../src/spec/layout/ListLayout.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,0BAA0B,CAAA;AACtE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAA;AACtD,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,cAAc,CAAA;AAExC;;;;;;;;;EASE;AACF,MAAM,MAAM,UAAU,GAAG;IACrB;;MAEE;IACF,IAAI,EAAE,MAAM,CAAC;IACb;;MAEE;IACF,KAAK,CAAC,EAAE,MAAM,CAAC;IACf;;MAEE;IACF,YAAY,CAAC,EAAE,sBAAsB,CAAC;IACtC;;MAEE;IACF,KAAK,EAAE,cAAc,EAAE,CAAC;IACxB;;MAEE;IACF,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB;;MAEE;IACF,MAAM,CAAC,EAAE,IAAI,CAAC;IACd;;MAEE;IACF,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB;;MAEE;IACF,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;CACnB,CAAC"}

package/build/spec/layout/ListLayoutCallToAction.d.ts

@@ -13,7 +13,7 @@ export type ListLayoutCallToAction = {
     */
     accessibilityDescription?: string;
     /**
-    * Behavior that should be performed when user interacts with call to action.
+    * The [com.wise.dynamicflow.feature.Behavior] that should be performed when user interacts with call to action.
     */
     behavior: Behavior;
     /**

package/build/spec/layout/LoadingIndicatorLayout.d.ts

@@ -2,6 +2,7 @@ import type { Size } from '../misc/Size';
 /**
 * A symbol indicating an indeterminate loading or pending state, when the user should wait for something to happen.
 * Typically used in conjunction with [com.wise.dynamicflow.feature.LinkHandler] or [com.wise.dynamicflow.feature.Polling].
+* <!-- fixture: loadingindicator -->
 */
 export type LoadingIndicatorLayout = {
     /**

package/build/spec/layout/LoadingIndicatorLayout.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"LoadingIndicatorLayout.d.ts","sourceRoot":"","sources":["../../../src/spec/layout/LoadingIndicatorLayout.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,cAAc,CAAA;AAExC;;;EAGE;AACF,MAAM,MAAM,sBAAsB,GAAG;IACjC;;MAEE;IACF,IAAI,EAAE,mBAAmB,CAAC;IAC1B;;MAEE;IACF,IAAI,CAAC,EAAE,IAAI,CAAC;IACZ;;MAEE;IACF,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB;;MAEE;IACF,MAAM,CAAC,EAAE,IAAI,CAAC;IACd;;MAEE;IACF,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB;;MAEE;IACF,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;CACnB,CAAC"}
+{"version":3,"file":"LoadingIndicatorLayout.d.ts","sourceRoot":"","sources":["../../../src/spec/layout/LoadingIndicatorLayout.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,cAAc,CAAA;AAExC;;;;EAIE;AACF,MAAM,MAAM,sBAAsB,GAAG;IACjC;;MAEE;IACF,IAAI,EAAE,mBAAmB,CAAC;IAC1B;;MAEE;IACF,IAAI,CAAC,EAAE,IAAI,CAAC;IACZ;;MAEE;IACF,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB;;MAEE;IACF,MAAM,CAAC,EAAE,IAAI,CAAC;IACd;;MAEE;IACF,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB;;MAEE;IACF,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;CACnB,CAAC"}

package/build/spec/layout/MarkdownLayout.d.ts

@@ -9,6 +9,7 @@ import type { Size } from '../misc/Size';
 * - Emphasis
 * - Strong Emphasis
 * - Links
+* <!-- fixture: markdown -->
 */
 export type MarkdownLayout = {
     /**

package/build/spec/layout/MarkdownLayout.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"MarkdownLayout.d.ts","sourceRoot":"","sources":["../../../src/spec/layout/MarkdownLayout.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,eAAe,CAAA;AAC1C,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,cAAc,CAAA;AAExC;;;;;;;;;EASE;AACF,MAAM,MAAM,cAAc,GAAG;IACzB;;MAEE;IACF,IAAI,EAAE,UAAU,CAAC;IACjB;;MAEE;IACF,OAAO,EAAE,MAAM,CAAC;IAChB;;MAEE;IACF,KAAK,CAAC,EAAE,KAAK,CAAC;IACd;;MAEE;IACF,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB;;MAEE;IACF,MAAM,CAAC,EAAE,IAAI,CAAC;IACd;;MAEE;IACF,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB;;MAEE;IACF,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB;;MAEE;IACF,IAAI,CAAC,EAAE,IAAI,CAAC;CACf,CAAC"}
+{"version":3,"file":"MarkdownLayout.d.ts","sourceRoot":"","sources":["../../../src/spec/layout/MarkdownLayout.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,eAAe,CAAA;AAC1C,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,cAAc,CAAA;AAExC;;;;;;;;;;EAUE;AACF,MAAM,MAAM,cAAc,GAAG;IACzB;;MAEE;IACF,IAAI,EAAE,UAAU,CAAC;IACjB;;MAEE;IACF,OAAO,EAAE,MAAM,CAAC;IAChB;;MAEE;IACF,KAAK,CAAC,EAAE,KAAK,CAAC;IACd;;MAEE;IACF,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB;;MAEE;IACF,MAAM,CAAC,EAAE,IAAI,CAAC;IACd;;MAEE;IACF,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB;;MAEE;IACF,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB;;MAEE;IACF,IAAI,CAAC,EAAE,IAAI,CAAC;CACf,CAAC"}

package/build/spec/layout/MediaLayout.d.ts

@@ -2,7 +2,7 @@ import type { Media } from '../misc/media/Media';
 import type { Align } from '../misc/Align';
 import type { Size } from '../misc/Size';
 /**
-* Contains a [Media] which is added to the Layout.
+* Contains a [com.wise.dynamicflow.misc.media.Media] which is added to the Layout.
 */
 export type MediaLayout = {
     /**

package/build/spec/layout/ModalLayout.d.ts

@@ -4,6 +4,11 @@ import type { ModalLayoutContent } from './ModalLayoutContent';
 /**
 * A button that triggers a modal with the specified layout components.
 * **Note**: We do not support the use of forms inside a modal.
+* <!-- fixture: modal -->
+* ## When to use
+* - When there is a small amount of content to show to the user that is purely informational.
+* ## When not to use
+* - When the content is more complex and requires user interaction, or validation from the server. Consider using a [com.wise.dynamicflow.feature.subflow.Subflow] instead.
 */
 export type ModalLayout = {
     /**

package/build/spec/layout/ModalLayout.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ModalLayout.d.ts","sourceRoot":"","sources":["../../../src/spec/layout/ModalLayout.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,cAAc,CAAA;AACxC,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAA;AAC9D,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAA;AAE9D;;;EAGE;AACF,MAAM,MAAM,WAAW,GAAG;IACtB;;MAEE;IACF,IAAI,EAAE,OAAO,CAAC;IACd;;MAEE;IACF,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB;;MAEE;IACF,MAAM,CAAC,EAAE,IAAI,CAAC;IACd;;MAEE;IACF,OAAO,EAAE,kBAAkB,CAAC;IAC5B;;MAEE;IACF,OAAO,EAAE,kBAAkB,CAAC;IAC5B;;MAEE;IACF,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB;;MAEE;IACF,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;CACnB,CAAC"}
+{"version":3,"file":"ModalLayout.d.ts","sourceRoot":"","sources":["../../../src/spec/layout/ModalLayout.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,cAAc,CAAA;AACxC,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAA;AAC9D,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAA;AAE9D;;;;;;;;EAQE;AACF,MAAM,MAAM,WAAW,GAAG;IACtB;;MAEE;IACF,IAAI,EAAE,OAAO,CAAC;IACd;;MAEE;IACF,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB;;MAEE;IACF,MAAM,CAAC,EAAE,IAAI,CAAC;IACd;;MAEE;IACF,OAAO,EAAE,kBAAkB,CAAC;IAC5B;;MAEE;IACF,OAAO,EAAE,kBAAkB,CAAC;IAC5B;;MAEE;IACF,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB;;MAEE;IACF,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;CACnB,CAAC"}

package/build/spec/layout/ParagraphLayout.d.ts

@@ -2,6 +2,7 @@ import type { Align } from '../misc/Align';
 import type { Size } from '../misc/Size';
 /**
 * A block of plain text. For richer formatting and layout options consider using [MarkdownLayout].
+* <!-- fixture: paragraph -->
 */
 export type ParagraphLayout = {
     /**

package/build/spec/layout/ParagraphLayout.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ParagraphLayout.d.ts","sourceRoot":"","sources":["../../../src/spec/layout/ParagraphLayout.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,eAAe,CAAA;AAC1C,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,cAAc,CAAA;AAExC;;EAEE;AACF,MAAM,MAAM,eAAe,GAAG;IAC1B;;MAEE;IACF,IAAI,EAAE,WAAW,CAAC;IAClB;;MAEE;IACF,IAAI,EAAE,MAAM,CAAC;IACb;;MAEE;IACF,KAAK,CAAC,EAAE,KAAK,CAAC;IACd;;MAEE;IACF,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB;;MAEE;IACF,MAAM,CAAC,EAAE,IAAI,CAAC;IACd;;MAEE;IACF,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB;;MAEE;IACF,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB;;MAEE;IACF,IAAI,CAAC,EAAE,IAAI,CAAC;CACf,CAAC"}
+{"version":3,"file":"ParagraphLayout.d.ts","sourceRoot":"","sources":["../../../src/spec/layout/ParagraphLayout.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,eAAe,CAAA;AAC1C,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,cAAc,CAAA;AAExC;;;EAGE;AACF,MAAM,MAAM,eAAe,GAAG;IAC1B;;MAEE;IACF,IAAI,EAAE,WAAW,CAAC;IAClB;;MAEE;IACF,IAAI,EAAE,MAAM,CAAC;IACb;;MAEE;IACF,KAAK,CAAC,EAAE,KAAK,CAAC;IACd;;MAEE;IACF,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB;;MAEE;IACF,MAAM,CAAC,EAAE,IAAI,CAAC;IACd;;MAEE;IACF,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB;;MAEE;IACF,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB;;MAEE;IACF,IAAI,CAAC,EAAE,IAAI,CAAC;CACf,CAAC"}

package/build/spec/layout/ProgressLayout.d.ts

@@ -3,6 +3,12 @@ import type { Help } from '../feature/Help';
 import type { Size } from '../misc/Size';
 /**
 * An indicator which can be used to show progress towards a goal or limit.
+* <!-- fixture: progress -->
+* ## When to use
+* - When showing the user's progress which is based on their actions, or some long-running process.
+* ## When not to use
+* - When showing a loading state for a task that is expected to complete quickly, consider showing a [com.wise.dynamicflow.layout.LoadingIndicatorLayout], or
+*   some informational content instead.
 */
 export type ProgressLayout = {
     /**

package/build/spec/layout/ProgressLayout.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ProgressLayout.d.ts","sourceRoot":"","sources":["../../../src/spec/layout/ProgressLayout.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,iBAAiB,CAAA;AAC9C,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,iBAAiB,CAAA;AAC3C,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,cAAc,CAAA;AAExC;;EAEE;AACF,MAAM,MAAM,cAAc,GAAG;IACzB;;MAEE;IACF,IAAI,EAAE,UAAU,CAAC;IACjB;;MAEE;IACF,KAAK,CAAC,EAAE,MAAM,CAAC;IACf;;MAEE;IACF,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB;;MAEE;IACF,QAAQ,EAAE,MAAM,CAAC;IACjB;;MAEE;IACF,YAAY,EAAE,MAAM,CAAC;IACrB;;MAEE;IACF,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB;;MAEE;IACF,IAAI,CAAC,EAAE,IAAI,CAAC;IACZ;;MAEE;IACF,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB;;MAEE;IACF,MAAM,CAAC,EAAE,IAAI,CAAC;IACd;;MAEE;IACF,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB;;MAEE;IACF,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;CACnB,CAAC"}
+{"version":3,"file":"ProgressLayout.d.ts","sourceRoot":"","sources":["../../../src/spec/layout/ProgressLayout.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,iBAAiB,CAAA;AAC9C,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,iBAAiB,CAAA;AAC3C,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,cAAc,CAAA;AAExC;;;;;;;;EAQE;AACF,MAAM,MAAM,cAAc,GAAG;IACzB;;MAEE;IACF,IAAI,EAAE,UAAU,CAAC;IACjB;;MAEE;IACF,KAAK,CAAC,EAAE,MAAM,CAAC;IACf;;MAEE;IACF,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB;;MAEE;IACF,QAAQ,EAAE,MAAM,CAAC;IACjB;;MAEE;IACF,YAAY,EAAE,MAAM,CAAC;IACrB;;MAEE;IACF,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB;;MAEE;IACF,IAAI,CAAC,EAAE,IAAI,CAAC;IACZ;;MAEE;IACF,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB;;MAEE;IACF,MAAM,CAAC,EAAE,IAAI,CAAC;IACd;;MAEE;IACF,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB;;MAEE;IACF,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;CACnB,CAAC"}

package/build/spec/layout/ReviewLayout.d.ts

@@ -4,6 +4,14 @@ import type { ReviewLayoutCallToAction } from './ReviewLayoutCallToAction';
 import type { Size } from '../misc/Size';
 /**
 * A list of read-only fields used to show information to the user for review.
+* <!-- fixture: review -->
+* ## When to use
+* - When the users attention is meant to be on the values, rather than the labels. For example, when the user is being asked
+* to check a number of fields that they have previously entered.
+* ## When not to use
+* - When the primary action of the step is tied to an individual item, consider using a [com.wise.dynamicflow.layout.DecisionLayout] instead.
+* - When the content being displayed represents separate entities of the same category, consider using a [com.wise.dynamicflow.layout.ListLayout] instead.
+* - If the focus is on the labels rather than the values, consider using a [com.wise.dynamicflow.layout.ListLayout] instead.
 */
 export type ReviewLayout = {
     /**

package/build/spec/layout/ReviewLayout.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ReviewLayout.d.ts","sourceRoot":"","sources":["../../../src/spec/layout/ReviewLayout.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAA;AAC/C,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAA;AAC5D,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,4BAA4B,CAAA;AAC1E,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,cAAc,CAAA;AAExC;;EAEE;AACF,MAAM,MAAM,YAAY,GAAG;IACvB;;MAEE;IACF,IAAI,EAAE,QAAQ,CAAC;IACf;;MAEE;IACF,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB;;MAEE;IACF,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB;;MAEE;IACF,MAAM,EAAE,iBAAiB,EAAE,CAAC;IAC5B;;MAEE;IACF,KAAK,CAAC,EAAE,MAAM,CAAC;IACf;;MAEE;IACF,YAAY,CAAC,EAAE,wBAAwB,CAAC;IACxC;;MAEE;IACF,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB;;MAEE;IACF,MAAM,CAAC,EAAE,IAAI,CAAC;IACd;;MAEE;IACF,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB;;MAEE;IACF,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;CACnB,CAAC"}
+{"version":3,"file":"ReviewLayout.d.ts","sourceRoot":"","sources":["../../../src/spec/layout/ReviewLayout.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAA;AAC/C,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAA;AAC5D,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,4BAA4B,CAAA;AAC1E,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,cAAc,CAAA;AAExC;;;;;;;;;;EAUE;AACF,MAAM,MAAM,YAAY,GAAG;IACvB;;MAEE;IACF,IAAI,EAAE,QAAQ,CAAC;IACf;;MAEE;IACF,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB;;MAEE;IACF,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB;;MAEE;IACF,MAAM,EAAE,iBAAiB,EAAE,CAAC;IAC5B;;MAEE;IACF,KAAK,CAAC,EAAE,MAAM,CAAC;IACf;;MAEE;IACF,YAAY,CAAC,EAAE,wBAAwB,CAAC;IACxC;;MAEE;IACF,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB;;MAEE;IACF,MAAM,CAAC,EAAE,IAAI,CAAC;IACd;;MAEE;IACF,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB;;MAEE;IACF,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;CACnB,CAAC"}

package/build/spec/layout/ReviewLayoutCallToAction.d.ts

@@ -2,7 +2,7 @@ import type { Action } from '../feature/Action';
 import type { Behavior } from '../feature/Behavior';
 import type { Context } from '../misc/Context';
 /**
-* Adds an [com.wise.dynamicflow.feature.Action] to the review layout. For example, it could be used to provide an edit action.
+* The call to action configuration used by [com.wise.dynamicflow.layout.ReviewLayout] or individual fields ([com.wise.dynamicflow.layout.ReviewLayout.Field]). For example, it could be used to provide an edit action.
 */
 export type ReviewLayoutCallToAction = {
     /**

package/build/spec/layout/ReviewLayoutField.d.ts

@@ -6,7 +6,7 @@ import type { InlineAlert } from '../misc/InlineAlert';
 import type { ReviewLayoutCallToAction } from './ReviewLayoutCallToAction';
 import type { Media } from '../misc/media/Media';
 /**
-* A single field in a [ReviewLayout]
+* A single field in a [com.wise.dynamicflow.layout.ReviewLayout].
 */
 export type ReviewLayoutField = {
     /**

package/build/spec/layout/SearchLayout.d.ts

@@ -3,7 +3,12 @@ import type { Size } from '../misc/Size';
 import type { SearchInitialState } from '../responses/search/SearchInitialState';
 /**
 * Displays a search input field, which performs a search and returns a [com.wise.dynamicflow.responses.search.SearchResult].
-* Results are actions or further searches.
+* <!-- fixture: search -->
+* ## When to use
+* - When there are a large number of options which cannot all be provided. For example, an address lookup.
+* ## When not to use
+* - When there are a small number of options which could all be provided on the step, consider using a [com.wise.dynamicflow.layout.DecisionLayout] with filtering instead.
+*   For example, a list of countries.
 */
 export type SearchLayout = {
     /**

package/build/spec/layout/SearchLayout.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"SearchLayout.d.ts","sourceRoot":"","sources":["../../../src/spec/layout/SearchLayout.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAA;AACpD,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,cAAc,CAAA;AACxC,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,wCAAwC,CAAA;AAEhF;;;EAGE;AACF,MAAM,MAAM,YAAY,GAAG;IACvB;;MAEE;IACF,IAAI,EAAE,QAAQ,CAAC;IACf;;MAEE;IACF,KAAK,EAAE,MAAM,CAAC;IACd;;MAEE;IACF,MAAM,EAAE,UAAU,CAAC;IACnB;;MAEE;IACF,GAAG,EAAE,MAAM,CAAC;IACZ;;;MAGE;IACF,KAAK,EAAE,MAAM,CAAC;IACd;;MAEE;IACF,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB;;MAEE;IACF,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB;;MAEE;IACF,MAAM,CAAC,EAAE,IAAI,CAAC;IACd;;MAEE;IACF,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB;;MAEE;IACF,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB;;MAEE;IACF,IAAI,CAAC,EAAE,MAAM,CAAC;IACd;;;MAGE;IACF,YAAY,CAAC,EAAE,kBAAkB,CAAC;CACrC,CAAC"}
+{"version":3,"file":"SearchLayout.d.ts","sourceRoot":"","sources":["../../../src/spec/layout/SearchLayout.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAA;AACpD,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,cAAc,CAAA;AACxC,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,wCAAwC,CAAA;AAEhF;;;;;;;;EAQE;AACF,MAAM,MAAM,YAAY,GAAG;IACvB;;MAEE;IACF,IAAI,EAAE,QAAQ,CAAC;IACf;;MAEE;IACF,KAAK,EAAE,MAAM,CAAC;IACd;;MAEE;IACF,MAAM,EAAE,UAAU,CAAC;IACnB;;MAEE;IACF,GAAG,EAAE,MAAM,CAAC;IACZ;;;MAGE;IACF,KAAK,EAAE,MAAM,CAAC;IACd;;MAEE;IACF,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB;;MAEE;IACF,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB;;MAEE;IACF,MAAM,CAAC,EAAE,IAAI,CAAC;IACd;;MAEE;IACF,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB;;MAEE;IACF,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB;;MAEE;IACF,IAAI,CAAC,EAAE,MAAM,CAAC;IACd;;;MAGE;IACF,YAAY,CAAC,EAAE,kBAAkB,CAAC;CACrC,CAAC"}

package/build/spec/layout/SectionLayout.d.ts

@@ -3,6 +3,11 @@ import type { SectionLayoutCallToAction } from './SectionLayoutCallToAction';
 import type { Size } from '../misc/Size';
 /**
 * A container for a group of layout components topped with a section header.
+* <!-- fixture: section -->
+* ## When to use
+* - When content is grouped under a shared title, or for accessibility reasons.
+* ## When not to use
+* - When the content is a single layout which has its own title, consider using that layout directly instead. For example, [com.wise.dynamicflow.layout.DecisionLayout], [com.wise.dynamicflow.layout.ReviewLayout], or [com.wise.dynamicflow.layout.ListLayout].
 */
 export type SectionLayout = {
     /**

package/build/spec/layout/SectionLayout.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"SectionLayout.d.ts","sourceRoot":"","sources":["../../../src/spec/layout/SectionLayout.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,UAAU,CAAA;AACtC,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,6BAA6B,CAAA;AAC5E,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,cAAc,CAAA;AAExC;;EAEE;AACF,MAAM,MAAM,aAAa,GAAG;IACxB;;MAEE;IACF,IAAI,EAAE,SAAS,CAAC;IAChB;;MAEE;IACF,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB;;MAEE;IACF,KAAK,EAAE,MAAM,CAAC;IACd;;MAEE;IACF,YAAY,CAAC,EAAE,yBAAyB,CAAC;IACzC;;MAEE;IACF,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB;;MAEE;IACF,MAAM,CAAC,EAAE,IAAI,CAAC;IACd;;MAEE;IACF,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB;;MAEE;IACF,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;CACnB,CAAC"}
+{"version":3,"file":"SectionLayout.d.ts","sourceRoot":"","sources":["../../../src/spec/layout/SectionLayout.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,UAAU,CAAA;AACtC,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,6BAA6B,CAAA;AAC5E,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,cAAc,CAAA;AAExC;;;;;;;EAOE;AACF,MAAM,MAAM,aAAa,GAAG;IACxB;;MAEE;IACF,IAAI,EAAE,SAAS,CAAC;IAChB;;MAEE;IACF,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB;;MAEE;IACF,KAAK,EAAE,MAAM,CAAC;IACd;;MAEE;IACF,YAAY,CAAC,EAAE,yBAAyB,CAAC;IACzC;;MAEE;IACF,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB;;MAEE;IACF,MAAM,CAAC,EAAE,IAAI,CAAC;IACd;;MAEE;IACF,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB;;MAEE;IACF,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;CACnB,CAAC"}

package/build/spec/layout/SectionLayoutCallToAction.d.ts

@@ -13,7 +13,7 @@ export type SectionLayoutCallToAction = {
     */
     accessibilityDescription?: string;
     /**
-    * Behavior that should be performed when user interacts with call to action.
+    * The [com.wise.dynamicflow.feature.Behavior] that should be performed when user interacts with call to action.
     */
     behavior: Behavior;
     /**