@namiml/sdk-core 3.5.0-dev.202610312243 → 3.5.0-dev.202611011549

package/dist/index.cjs

@@ -106,7 +106,7 @@ const {
 // version — stamped by scripts/version.sh
 NAMI_SDK_VERSION: exports.NAMI_SDK_VERSION = "3.5.0", 
 // full package version including dev suffix — stamped by scripts/version.sh
-NAMI_SDK_PACKAGE_VERSION: exports.NAMI_SDK_PACKAGE_VERSION = "3.5.0-dev.202610312243", 
+NAMI_SDK_PACKAGE_VERSION: exports.NAMI_SDK_PACKAGE_VERSION = "3.5.0-dev.202611011549", 
 // environments
 PRODUCTION: exports.PRODUCTION = "production", DEVELOPMENT: exports.DEVELOPMENT = "development", 
 // error messages
@@ -64652,33 +64652,60 @@ let NamiFlowManager$2 = class NamiFlowManager {
     getCurrentFlowProgress(key) {
         if (!this.currentFlow)
             return 1;
-        if (!this.currentFlow.currentFlowStep)
+        const position = this.getCurrentFlowStepPosition();
+        if (!position)
+            return 0;
+        let progress = position.index / position.total;
+        progress = Math.max(0, Math.min(1, progress));
+        if (key) {
+            this.setLastAnimatedFlowProgress(key, progress);
+        }
+        return progress;
+    }
+    /**
+     * Gets the 1-based position of the current screen within the flow, using the
+     * same step math as {@link getCurrentFlowProgress}.
+     * @returns The current step index (1-based), or 0 when unknown
+     */
+    getCurrentFlowStepIndex() {
+        const position = this.getCurrentFlowStepPosition();
+        if (!position)
             return 0;
+        return Math.max(0, Math.min(position.total, position.index));
+    }
+    /**
+     * Gets the total number of screen steps the current flow's progress is measured against.
+     * @returns The total step count, or 0 when unknown (no open flow, no current step, no screens)
+     */
+    getTotalFlowSteps() {
+        return this.getCurrentFlowStepPosition()?.total ?? 0;
+    }
+    /**
+     * Resolves the current flow position as an integer pair. `index / total` is the
+     * flow progress. Returns null when the position is unknown.
+     */
+    getCurrentFlowStepPosition() {
+        if (!this.currentFlow)
+            return null;
+        if (!this.currentFlow.currentFlowStep)
+            return null;
         const allScreens = this.currentFlow.steps.filter(step => step.type === NamiFlowStepType.SCREEN);
         if (allScreens.length === 0)
-            return 0;
+            return null;
         const visitedScreens = this.currentFlow.stepcrumbs.filter(step => step.type === NamiFlowStepType.SCREEN);
         if (visitedScreens.length === 0)
-            return 0;
+            return null;
         const navGraph = this.buildNavGraph(this.currentFlow);
         const currentStep = this.currentFlow.currentFlowStep;
         // Find the branch point (first screen with multiple forward paths)
         const branchPoint = this.findBranchPoint(allScreens, navGraph);
-        let progress = 0;
         if (branchPoint) {
             // Branching flow
-            progress = this.calculateBranchingProgress(visitedScreens, allScreens, currentStep, branchPoint, navGraph);
-        }
-        else {
-            // Linear flow
-            const currentIndex = allScreens.findIndex(s => s.id === currentStep.id);
-            progress = currentIndex >= 0 ? (currentIndex + 1) / allScreens.length : 0;
-        }
-        progress = Math.max(0, Math.min(1, progress));
-        if (key) {
-            this.setLastAnimatedFlowProgress(key, progress);
+            return this.calculateBranchingProgress(visitedScreens, allScreens, currentStep, branchPoint, navGraph);
         }
-        return progress;
+        // Linear flow
+        const currentIndex = allScreens.findIndex(s => s.id === currentStep.id);
+        return { index: currentIndex >= 0 ? currentIndex + 1 : 0, total: allScreens.length };
     }
     /**
      * Find the first screen that has branching (multiple forward navigation targets)
@@ -64692,7 +64719,8 @@ let NamiFlowManager$2 = class NamiFlowManager {
         return null;
     }
     /**
-     * Calculate progress for flows with branching (supports 2+ branches)
+     * Calculate the step position for flows with branching (supports 2+ branches).
+     * Progress is `index / total`.
      */
     calculateBranchingProgress(visitedScreens, allScreens, currentStep, branchPoint, navGraph) {
         const visitedCount = visitedScreens.length;
@@ -64706,14 +64734,14 @@ let NamiFlowManager$2 = class NamiFlowManager {
             //   - visitedScreens = currentPosition + 1 (0-indexed)
             //   - minimumTotalPathLength = branchPosition + 2
             //     (all screens before branch + branch itself + at least 1 screen after)
-            return (currentIndexInAll + 1) / (branchPointIndexInAll + 2);
+            return { index: currentIndexInAll + 1, total: branchPointIndexInAll + 2 };
         }
         // Case 2: Past the branch point (entered a specific branch)
         // Calculate based on: visitedScreens / (visitedScreens + remainingInThisBranch)
         const remainingInBranch = this.countForwardScreens(currentStep, allScreens, navGraph);
         const totalPathLength = visitedCount + remainingInBranch;
         logger.debug(`Branching progress: visited=${visitedCount}, remaining=${remainingInBranch}, total=${totalPathLength}, step=${currentStep.id}`);
-        return visitedCount / totalPathLength;
+        return { index: visitedCount, total: totalPathLength };
     }
     /**
      * Count how many screens are forward-reachable from the current step
@@ -64811,6 +64839,12 @@ let NamiFlowManager$2 = class NamiFlowManager {
     static getCurrentFlowProgress(key) {
         return this.instance.getCurrentFlowProgress(key);
     }
+    static getCurrentFlowStepIndex() {
+        return this.instance.getCurrentFlowStepIndex();
+    }
+    static getTotalFlowSteps() {
+        return this.instance.getTotalFlowSteps();
+    }
     /**
      * Gets the current flow step's auto-advance delay (in seconds)
      * Parses __appear__ actions to find flowNav/flowNext with a delay parameter
@@ -67015,6 +67049,111 @@ function aggregateScreenreaderText(page, focusedButtonLabel = '') {
     return joinFragments(fragments);
 }
 
+/**
+ * Step model for the stepped `progressIndicator` (`style: "steps"`).
+ *
+ * Pure helpers shared by every TypeScript renderer (Web, Expo). Apple and
+ * Android mirror these rules natively, so keep the behaviour in sync with
+ * them when changing anything here.
+ */
+/** Smallest step count a fixed (non-"auto") `stepCount` resolves to. */
+const MIN_FIXED_STEP_COUNT = 2;
+/** Largest step count a fixed (non-"auto") `stepCount` resolves to. */
+const MAX_FIXED_STEP_COUNT = 12;
+/**
+ * Parses a numeric field that may arrive as a number or as a numeric string
+ * (for example from smart text). Returns NaN for "auto", missing, empty or
+ * unparseable values.
+ */
+function parseStepNumber(value) {
+    if (typeof value === "number")
+        return Number.isFinite(value) ? value : NaN;
+    if (typeof value === "string") {
+        const trimmed = value.trim();
+        if (trimmed === "")
+            return NaN;
+        const parsed = Number(trimmed);
+        return Number.isFinite(parsed) ? parsed : NaN;
+    }
+    return NaN;
+}
+/** True when the component asks for the stepped style; anything else renders the bar. */
+function isStepsStyle(c) {
+    return c.style === "steps";
+}
+/**
+ * Resolves the number of segments to draw.
+ *
+ * "auto", missing or unparseable values use `autoTotal` as is (not clamped).
+ * A number or numeric string is rounded and clamped to
+ * [MIN_FIXED_STEP_COUNT, MAX_FIXED_STEP_COUNT].
+ */
+function resolveStepCount(stepCount, autoTotal) {
+    const parsed = parseStepNumber(stepCount);
+    if (Number.isNaN(parsed))
+        return autoTotal;
+    return Math.min(MAX_FIXED_STEP_COUNT, Math.max(MIN_FIXED_STEP_COUNT, Math.round(parsed)));
+}
+/**
+ * Resolves the 1-based current step.
+ *
+ * "auto", missing or unparseable values use `autoIndex`. A number or numeric
+ * string is rounded but not clamped: out-of-range values are handled by
+ * {@link stepSegmentState}.
+ */
+function resolveCurrentStep(currentStep, autoIndex) {
+    const parsed = parseStepNumber(currentStep);
+    if (Number.isNaN(parsed))
+        return autoIndex;
+    return Math.round(parsed);
+}
+/**
+ * State of the segment at 1-based `index1` given the 1-based `current` step.
+ *
+ * `currentStep` mode marks only the matching segment as current. Any other
+ * `fillMode` (including unknown or missing) behaves as `fillUp`, which marks
+ * every segment up to and including `current` as active.
+ */
+function stepSegmentState(index1, current, fillMode) {
+    if (fillMode === "currentStep") {
+        return index1 === current ? "current" : "inactive";
+    }
+    return index1 <= current ? "active" : "inactive";
+}
+/**
+ * Width of one segment when `count` segments separated by `spacing` share
+ * `available` width evenly. Never negative; 0 when `count <= 0`.
+ */
+function evenSegmentWidth(available, count, spacing) {
+    if (count <= 0)
+        return 0;
+    return Math.max(0, (available - (count - 1) * spacing) / count);
+}
+/** Resolves `stepSizing`; unknown or missing values fall back to "even". */
+function resolveStepSizing(v) {
+    return v === "fixed" ? "fixed" : "even";
+}
+/** Resolves `alignment`; unknown or missing values fall back to "center". */
+function resolveStepAlignment(v) {
+    return v === "left" || v === "right" ? v : "center";
+}
+/**
+ * First value that is actually set: skips `undefined`, `null`, `""` and
+ * whitespace-only strings, so an empty `current*` field falls back to the
+ * next candidate (for example `active*`) the way Apple and Android do.
+ * `0`, `false` and other falsy non-string values count as set.
+ */
+function firstSet(...values) {
+    for (const v of values) {
+        if (v === undefined || v === null)
+            continue;
+        if (typeof v === "string" && v.trim() === "")
+            continue;
+        return v;
+    }
+    return undefined;
+}
+
 function namiBuySKU(skuRefId) {
     if (!hasPurchaseManagement("NamiPurchaseManager.buySKU")) {
         return;
@@ -67101,6 +67240,8 @@ exports.ExternalIDRequiredError = ExternalIDRequiredError;
 exports.FlowScreensNotAvailableError = FlowScreensNotAvailableError;
 exports.InternalServerError = InternalServerError;
 exports.LaunchContextResolver = LaunchContextResolver;
+exports.MAX_FIXED_STEP_COUNT = MAX_FIXED_STEP_COUNT;
+exports.MIN_FIXED_STEP_COUNT = MIN_FIXED_STEP_COUNT;
 exports.NAMI_STORAGE_KEYS = NAMI_STORAGE_KEYS;
 exports.Nami = Nami;
 exports.NamiAPI = NamiAPI;
@@ -67155,7 +67296,9 @@ exports.didReceiveResponse = didReceiveResponse;
 exports.empty = empty;
 exports.evaluateSystemTimeAssertion = evaluateSystemTimeAssertion;
 exports.evaluateSystemTimeCondition = evaluateSystemTimeCondition;
+exports.evenSegmentWidth = evenSegmentWidth;
 exports.extractStandardPricingPhases = extractStandardPricingPhases;
+exports.firstSet = firstSet;
 exports.formatDate = formatDate;
 exports.formattedPrice = formattedPrice;
 exports.generateUUID = generateUUID;
@@ -67201,6 +67344,7 @@ exports.invokeHandler = invokeHandler;
 exports.isAnonymousMode = isAnonymousMode;
 exports.isInitialConfigCompressed = isInitialConfigCompressed;
 exports.isNamiFlowCampaign = isNamiFlowCampaign;
+exports.isStepsStyle = isStepsStyle;
 exports.isSubscription = isSubscription;
 exports.isSystemTimeAssertion = isSystemTimeAssertion;
 exports.isValidISODate = isValidISODate;
@@ -67216,12 +67360,17 @@ exports.productDetail = productDetail;
 exports.registerAPITrafficObserver = registerAPITrafficObserver;
 exports.registerPlatformAdapters = registerPlatformAdapters;
 exports.registerPurchaseAdapter = registerPurchaseAdapter;
+exports.resolveCurrentStep = resolveCurrentStep;
 exports.resolveLoopSource = resolveLoopSource;
+exports.resolveStepAlignment = resolveStepAlignment;
+exports.resolveStepCount = resolveStepCount;
+exports.resolveStepSizing = resolveStepSizing;
 exports.selectSegment = selectSegment;
 exports.setActiveNamiEntitlements = setActiveNamiEntitlements;
 exports.shouldValidateProductGroups = shouldValidateProductGroups;
 exports.skuItems = skuItems;
 exports.skuMapFromEntitlements = skuMapFromEntitlements;
+exports.stepSegmentState = stepSegmentState;
 exports.storageService = storageService;
 exports.toDouble = toDouble;
 exports.toNamiEntitlements = toNamiEntitlements;

package/dist/index.d.ts

@@ -1274,6 +1274,20 @@ type TProgressIndicatorComponent = TBaseComponent & {
     innerPadding?: number;
     activeDropShadow?: string;
     inactiveDropShadow?: string;
+    style?: "bar" | "steps";
+    stepSizing?: "even" | "fixed";
+    fillMode?: "fillUp" | "currentStep";
+    stepCount?: "auto" | number | string;
+    currentStep?: "auto" | number | string;
+    indicatorSpacing?: number;
+    alignment?: "left" | "center" | "right";
+    activeSize?: number;
+    currentSize?: number;
+    inactiveSize?: number;
+    currentFillColor?: string;
+    currentFillColorFallback?: string;
+    currentBorderRadius?: number;
+    currentDropShadow?: string;
 };
 type TProgressBarComponent = TBaseComponent & {
     component: "progressBar";
@@ -2270,12 +2284,29 @@ declare class NamiFlowManager$2 {
      * @returns Progress as a percentage (0-1)
      */
     getCurrentFlowProgress(key?: string): number;
+    /**
+     * Gets the 1-based position of the current screen within the flow, using the
+     * same step math as {@link getCurrentFlowProgress}.
+     * @returns The current step index (1-based), or 0 when unknown
+     */
+    getCurrentFlowStepIndex(): number;
+    /**
+     * Gets the total number of screen steps the current flow's progress is measured against.
+     * @returns The total step count, or 0 when unknown (no open flow, no current step, no screens)
+     */
+    getTotalFlowSteps(): number;
+    /**
+     * Resolves the current flow position as an integer pair. `index / total` is the
+     * flow progress. Returns null when the position is unknown.
+     */
+    private getCurrentFlowStepPosition;
     /**
      * Find the first screen that has branching (multiple forward navigation targets)
      */
     private findBranchPoint;
     /**
-     * Calculate progress for flows with branching (supports 2+ branches)
+     * Calculate the step position for flows with branching (supports 2+ branches).
+     * Progress is `index / total`.
      */
     private calculateBranchingProgress;
     /**
@@ -2296,6 +2327,8 @@ declare class NamiFlowManager$2 {
     static getLastAnimatedFlowProgress(key: string): number;
     static setLastAnimatedFlowProgress(key: string, value: number): void;
     static getCurrentFlowProgress(key?: string): number;
+    static getCurrentFlowStepIndex(): number;
+    static getTotalFlowSteps(): number;
     /**
      * Gets the current flow step's auto-advance delay (in seconds)
      * Parses __appear__ actions to find flowNav/flowNext with a delay parameter
@@ -3434,6 +3467,64 @@ declare function isAnonymousMode(): boolean;
  */
 declare function aggregateScreenreaderText(page: TPages, focusedButtonLabel?: string): string;
 
+/**
+ * Step model for the stepped `progressIndicator` (`style: "steps"`).
+ *
+ * Pure helpers shared by every TypeScript renderer (Web, Expo). Apple and
+ * Android mirror these rules natively, so keep the behaviour in sync with
+ * them when changing anything here.
+ */
+/** Smallest step count a fixed (non-"auto") `stepCount` resolves to. */
+declare const MIN_FIXED_STEP_COUNT = 2;
+/** Largest step count a fixed (non-"auto") `stepCount` resolves to. */
+declare const MAX_FIXED_STEP_COUNT = 12;
+/** Visual state of one step segment. */
+type TStepState = "active" | "current" | "inactive";
+/** True when the component asks for the stepped style; anything else renders the bar. */
+declare function isStepsStyle(c: {
+    style?: string;
+}): boolean;
+/**
+ * Resolves the number of segments to draw.
+ *
+ * "auto", missing or unparseable values use `autoTotal` as is (not clamped).
+ * A number or numeric string is rounded and clamped to
+ * [MIN_FIXED_STEP_COUNT, MAX_FIXED_STEP_COUNT].
+ */
+declare function resolveStepCount(stepCount: unknown, autoTotal: number): number;
+/**
+ * Resolves the 1-based current step.
+ *
+ * "auto", missing or unparseable values use `autoIndex`. A number or numeric
+ * string is rounded but not clamped: out-of-range values are handled by
+ * {@link stepSegmentState}.
+ */
+declare function resolveCurrentStep(currentStep: unknown, autoIndex: number): number;
+/**
+ * State of the segment at 1-based `index1` given the 1-based `current` step.
+ *
+ * `currentStep` mode marks only the matching segment as current. Any other
+ * `fillMode` (including unknown or missing) behaves as `fillUp`, which marks
+ * every segment up to and including `current` as active.
+ */
+declare function stepSegmentState(index1: number, current: number, fillMode?: string): TStepState;
+/**
+ * Width of one segment when `count` segments separated by `spacing` share
+ * `available` width evenly. Never negative; 0 when `count <= 0`.
+ */
+declare function evenSegmentWidth(available: number, count: number, spacing: number): number;
+/** Resolves `stepSizing`; unknown or missing values fall back to "even". */
+declare function resolveStepSizing(v?: string): "even" | "fixed";
+/** Resolves `alignment`; unknown or missing values fall back to "center". */
+declare function resolveStepAlignment(v?: string): "left" | "center" | "right";
+/**
+ * First value that is actually set: skips `undefined`, `null`, `""` and
+ * whitespace-only strings, so an empty `current*` field falls back to the
+ * next candidate (for example `active*`) the way Apple and Android do.
+ * `0`, `false` and other falsy non-string values count as set.
+ */
+declare function firstSet<T>(...values: T[]): Exclude<T, "" | null | undefined> | undefined;
+
 /**
  * Returns the translated string for the given key in the current SDK language.
  * Uses Nami language code from storage (set via Nami.configure({ namiLanguageCode })).
@@ -4451,5 +4542,5 @@ declare namespace internal {
   };
 }
 
-export { ALREADY_CONFIGURED, ANONYMOUS_MODE, ANONYMOUS_MODE_ALREADY_OFF, ANONYMOUS_MODE_ALREADY_ON, ANONYMOUS_MODE_LOGIN_NOT_ALLOWED, ANONYMOUS_UUID, APIError, API_ACTIVE_ENTITLEMENTS, API_CAMPAIGN_RULES, API_CAMPAIGN_SESSION_TIMESTAMP, API_CONFIG, API_MAX_CALLS_LIMIT, API_PAYWALLS, API_PRODUCTS, API_RETRY_DELAY_SEC, API_TIMEOUT_LIMIT, API_TRAFFIC_OBSERVER, API_VERSION, AUTH_DEVICE, AVAILABLE_ACTIVE_ENTITLEMENTS_CHANGED, AVAILABLE_CAMPAIGNS_CHANGED, AccountStateAction, AnonymousCDPError, AnonymousLoginError, AnonymousModeAlreadyOffError, AnonymousModeAlreadyOnError, BASE_STAGING_URL, BASE_URL, BASE_URL_PATH, BadRequestError, BasicNamiFlow, BorderMap, BorderSideMap, CAMPAIGN_CACHE_TTL_PREFIX, CAMPAIGN_NOT_AVAILABLE, CONFIG_API_TIMEOUT_LIMIT, CONFIG_MAX_ATTEMPTS, CUSTOMER_ATTRIBUTES_KEY_PREFIX, CUSTOMER_JOURNEY_STATE_CHANGED, CUSTOM_HOST_PREFIX, CampaignNotAvailableError, CampaignRuleConversionEventType, CampaignRuleRepository, Capabilities, ClientError, ConfigRepository, ConflictError, CustomerJourneyRepository, DEFAULT_JOURNEY_SETTINGS, DEVELOPMENT, DEVICE_API_TIMEOUT_LIMIT, DEVICE_ID_NOT_SET, DEVICE_ID_REQUIRED, DISABLE_ASYNC_LOGIN_LOGOUT, DeviceIDRequiredError, DeviceRepository, EXTENDED_CLIENT_INFO_DELIMITER, EXTENDED_CLIENT_INFO_PREFIX, EXTENDED_PLATFORM, EXTENDED_PLATFORM_VERSION, EXTERNAL_ID_REQUIRED, EntitlementRepository, EntitlementUtils, ExternalIDRequiredError, FLOW_SCREENS_NOT_AVAILABLE, FlowScreensNotAvailableError, HTML_REGEX, INITIAL_APP_CONFIG, INITIAL_CAMPAIGN_RULES, INITIAL_PAYWALLS, INITIAL_PRODUCTS, INITIAL_SESSION_COUNTER_VALUE, INITIAL_SUCCESS, InternalServerError, KEY_SESSION_COUNTER, LIQUID_VARIABLE_REGEX, LOCAL_NAMI_ENTITLEMENTS, LOG_HTTP_REQUESTS, LOG_HTTP_TRAFFIC, LaunchCampaignError, LaunchContextResolver, LogLevel, NAMI_CONFIGURATION, NAMI_CUSTOMER_JOURNEY_STATE, NAMI_LANGUAGE_CODE, NAMI_LAST_IMPRESSION_ID, NAMI_LAUNCH_ID, NAMI_PROFILE, NAMI_PURCHASE_CHANNEL, NAMI_PURCHASE_IMPRESSION_ID, NAMI_SDK_PACKAGE_VERSION, NAMI_SDK_VERSION, NAMI_SESSION_ID, NAMI_STORAGE_KEYS, Nami, NamiAPI, NamiAnimationType, NamiCampaignManager$2 as NamiCampaignManager, NamiCampaignRuleType, NamiConditionEvaluator, NamiCustomerManager$2 as NamiCustomerManager, NamiEntitlementManager$2 as NamiEntitlementManager, NamiEventEmitter, NamiFlow, NamiFlowActionFunction, NamiFlowManager$1 as NamiFlowManager, NamiFlowStepType, NamiHandoffTag, NamiPaywallAction, NamiPaywallManager$2 as NamiPaywallManager, PaywallManagerEvents as NamiPaywallManagerEvents, NamiPermissionOutcome, NamiPurchaseManager$2 as NamiPurchaseManager, NamiRefs, NamiReservedActions, NotFoundError, PAYWALL_ACTION_EVENT, PLATFORM_ID_REQUIRED, PRODUCTION, PaywallManagerEvents, PaywallRepository, PaywallState, PlacementLabelResolver, PlatformIDRequiredError, ProductRepository, RECONFIG_SUCCESS, RESUME_THROTTLE_MS, RetryLimitExceededError, SDKNotInitializedError, SDK_NOT_INITIALIZED, SERVER_NAMI_ENTITLEMENTS, SESSION_REQUIRED, SHOULD_SHOW_LOADING_INDICATOR, SIMULATE_CONFIG_FETCH_FAILURE, SIMULATE_PAYWALL_FETCH_FAILURE, SKU_TEXT_REGEX, SMART_TEXT_PATTERN, STARTUP_TELEMETRY, STATUS_BAD_REQUEST, STATUS_CONFLICT, STATUS_INTERNAL_SERVER_ERROR, STATUS_NOT_FOUND, STATUS_SUCCESS, SYSTEM_TIME_FILTER_PREFIX, SYSTEM_TIME_TOKEN_PREFIX, SessionService, SimpleEventTarget, StorageService, TIME_OVERRIDE_PREFIX, TRANSPORT_FAILURE_STATUS, UNABLE_TO_UPDATE_CDP_ID, USE_STAGING_API, VALIDATE_PRODUCT_GROUPS, VAR_REGEX, NamiProfileManager$1 as _NamiProfileManager, internal as _internal, activateEntitlementByPurchase, activeEntitlements, aggregateScreenreaderText, allCampaigns, allPaywalls, applyEntitlementActivation, audienceSplitPosition, bestUrlCampaignMatch, bigintToUuid, checkAnySkuHasPromoOffer, checkAnySkuHasTrialOffer, convertISO8601PeriodToText, convertLocale, convertOfferToPricingPhase, createNamiEntitlements, currentSku, didReceiveResponse, empty, evaluateSystemTimeAssertion, evaluateSystemTimeCondition, extractStandardPricingPhases, formatDate, formattedPrice, generateUUID, getApiCampaigns, getApiPaywalls, getBaseUrl, getBillingPeriodNumber, getCurrencyFormat, getDeviceData, getDeviceFormFactor, getDeviceScaleFactor, getEffectiveWebStyle, getEntitlementRefIdsForSku, getExtendedClientInfo, getFreeTrialPeriod, getInitialCampaigns, getInitialPaywalls, getJourneySettings, getPaywall, getPaywallDataFromLabel, getPercentagePriceDifference, getPeriodNumberInDays, getPeriodNumberInWeeks, getPlatformAdapters, getPriceDifference, getPricePerMonth, getProductDetail, getPurchaseAdapter, getReferenceSku, getSkuProductDetailKeys, getSkuSmartTextValue, getSlideSmartTextValue, getStandardBillingPeriod, getSystemTimeNow, getTranslate, getUrlParams, handleErrors, hasAllPaywalls, hasCapability, hasPurchaseManagement, initialState, invokeHandler, isAnonymousMode, isInitialConfigCompressed, isNamiFlowCampaign, isSubscription, isSystemTimeAssertion, isValidISODate, isValidUrl, logger, mapAnonymousCampaigns, namiBuySKU, normalizeLaunchContext, parseTimeOverride, parseToSemver, postConversion, productDetail, registerAPITrafficObserver, registerPlatformAdapters, registerPurchaseAdapter, resolveLoopSource, selectSegment, setActiveNamiEntitlements, shouldValidateProductGroups, skuItems, skuMapFromEntitlements, storageService, toDouble, toNamiEntitlements, toNamiSKU, tryParseB64Gzip, tryParseJson, updateRelatedSKUsForNamiEntitlement, uuidFromSplitPosition, validateForm, validateMinSDKVersion, validateTextInput };
-export type { AccountStateHandler$1 as AccountStateHandler, AlignmentType, AmazonProduct, ApiResponse, AppleProduct, AvailableCampaignsResponseHandler, BorderLocationType, BorderSideType, Callback$1 as Callback, CloseHandler, CustomerJourneyState, DeepLinkUrlHandler, Device, DevicePayload, DeviceProfile, DirectionType, ExtendedPlatformInfo, FlexDirectionObject, FlowNavigationOptions, FontCollection, FontDetails, FormFactor, FormFieldValidator, GoogleProduct, IConfig, IDeviceAdapter, IEntitlements$1 as IEntitlements, IPaywall, IPlatformAdapters, IProductsWithComponents, IPurchaseAdapter, ISkuMenu, IStorageAdapter, IUIAdapter, Impression, InitialConfig, InitialConfigCompressed, InitiateStateGroup, JourneySettings, LoginResponse, NamiAPITrafficKind, NamiAPITrafficObserver, NamiAPITrafficRecord, NamiAnimation, NamiAnimationObjectSpec, NamiAnimationSpec, NamiAnonymousCampaign, NamiAppSuppliedVideoDetails, NamiCampaign, NamiCampaignManagerStatic, NamiCampaignSegment, NamiCompletionResult, NamiConfiguration, NamiConfigurationState, NamiCustomAttributeValue, NamiCustomerManagerStatic, NamiEntitlement$1 as NamiEntitlement, NamiEntitlementManagerStatic, NamiFlowAction, NamiFlowAnimation, NamiFlowCampaign, NamiFlowCompletionCondition, NamiFlowDTO, NamiFlowEventHandler, NamiFlowHandoffStepHandler, NamiFlowManagerStatic, NamiFlowObjectDTO, NamiFlowOn, NamiFlowStep, NamiFlowTransition, NamiFlowTransitionDirection, NamiFlowWithObject, NamiHandoffAttributeValue, NamiHandoffComplete, NamiHandoffOutcome, NamiHandoffTagValue, NamiInitialConfig, NamiKnownHandoffTag, NamiLanguageCodes, NamiLogLevel, NamiLoginSuccess, NamiPaywallActionHandler, NamiPaywallComponentChange, NamiPaywallEvent, NamiPaywallEventVideoMetadata, NamiPaywallLaunchContext, NamiPaywallManagerStatic, NamiPresentationStyle, NamiProductDetails, NamiProductOffer, NamiProfile, NamiPurchase, NamiPurchaseCompleteResult, NamiPurchaseDetails, NamiPurchaseManagerStatic, NamiPurchaseSuccess, NamiPurchasesState, NamiSKU, NamiSKUType, NamiSubscriptionInterval, NamiSubscriptionPeriod, NamiUserDataEnvelope, None, NoneSpec, PaywallActionEvent, PaywallHandle, PaywallResultHandler, PaywallSKU, PricingPhase, ProductGroup, Pulse, PulseSpec, PurchaseContext, PurchaseResult, PurchaseValidationRequest, SKU, SKUActionHandler, ScreenInfo, Session, TBaseComponent, TButtonContainer, TCarouselContainer, TCarouselSlide, TCarouselSlidesState, TCollapseContainer, TComponent, TConditionalAttributes, TConditionalComponent, TContainer, TContainerPosition, TCountdownTimerTextComponent, TDevice, TDisabledButton, TField, TFieldSettings, TFlexProductContainer, THeaderFooter, TImageComponent, TInitialState, TMediaTypes, TOffer, TPages, TPaywallContext, TPaywallLaunchContext, TPaywallMedia, TPaywallTemplate, TPlayPauseButton, TProductContainer, TProductGroup, TProgressBarComponent, TProgressIndicatorComponent, TQRCodeComponent, TRadioButton, TRepeatingGrid, TResponsiveGrid, TSegmentPicker, TSegmentPickerItem, TSemverObj, TSlot, TSlotGroupSelector, TSpacerComponent, TStack, TSvgImageComponent, TSymbolComponent, TTestObject, TTextComponent, TTextInputComponent, TTextInputType, TTextLikeComponent, TTextListComponent, TTimelineRail, TToggleButtonComponent, TToggleSwitch, TVariablePattern, TVideoComponent, TVolumeButton, TimerState, TransactionRequest, UserAction, UserActionParameters, Wave, WaveSpec };
+export { ALREADY_CONFIGURED, ANONYMOUS_MODE, ANONYMOUS_MODE_ALREADY_OFF, ANONYMOUS_MODE_ALREADY_ON, ANONYMOUS_MODE_LOGIN_NOT_ALLOWED, ANONYMOUS_UUID, APIError, API_ACTIVE_ENTITLEMENTS, API_CAMPAIGN_RULES, API_CAMPAIGN_SESSION_TIMESTAMP, API_CONFIG, API_MAX_CALLS_LIMIT, API_PAYWALLS, API_PRODUCTS, API_RETRY_DELAY_SEC, API_TIMEOUT_LIMIT, API_TRAFFIC_OBSERVER, API_VERSION, AUTH_DEVICE, AVAILABLE_ACTIVE_ENTITLEMENTS_CHANGED, AVAILABLE_CAMPAIGNS_CHANGED, AccountStateAction, AnonymousCDPError, AnonymousLoginError, AnonymousModeAlreadyOffError, AnonymousModeAlreadyOnError, BASE_STAGING_URL, BASE_URL, BASE_URL_PATH, BadRequestError, BasicNamiFlow, BorderMap, BorderSideMap, CAMPAIGN_CACHE_TTL_PREFIX, CAMPAIGN_NOT_AVAILABLE, CONFIG_API_TIMEOUT_LIMIT, CONFIG_MAX_ATTEMPTS, CUSTOMER_ATTRIBUTES_KEY_PREFIX, CUSTOMER_JOURNEY_STATE_CHANGED, CUSTOM_HOST_PREFIX, CampaignNotAvailableError, CampaignRuleConversionEventType, CampaignRuleRepository, Capabilities, ClientError, ConfigRepository, ConflictError, CustomerJourneyRepository, DEFAULT_JOURNEY_SETTINGS, DEVELOPMENT, DEVICE_API_TIMEOUT_LIMIT, DEVICE_ID_NOT_SET, DEVICE_ID_REQUIRED, DISABLE_ASYNC_LOGIN_LOGOUT, DeviceIDRequiredError, DeviceRepository, EXTENDED_CLIENT_INFO_DELIMITER, EXTENDED_CLIENT_INFO_PREFIX, EXTENDED_PLATFORM, EXTENDED_PLATFORM_VERSION, EXTERNAL_ID_REQUIRED, EntitlementRepository, EntitlementUtils, ExternalIDRequiredError, FLOW_SCREENS_NOT_AVAILABLE, FlowScreensNotAvailableError, HTML_REGEX, INITIAL_APP_CONFIG, INITIAL_CAMPAIGN_RULES, INITIAL_PAYWALLS, INITIAL_PRODUCTS, INITIAL_SESSION_COUNTER_VALUE, INITIAL_SUCCESS, InternalServerError, KEY_SESSION_COUNTER, LIQUID_VARIABLE_REGEX, LOCAL_NAMI_ENTITLEMENTS, LOG_HTTP_REQUESTS, LOG_HTTP_TRAFFIC, LaunchCampaignError, LaunchContextResolver, LogLevel, MAX_FIXED_STEP_COUNT, MIN_FIXED_STEP_COUNT, NAMI_CONFIGURATION, NAMI_CUSTOMER_JOURNEY_STATE, NAMI_LANGUAGE_CODE, NAMI_LAST_IMPRESSION_ID, NAMI_LAUNCH_ID, NAMI_PROFILE, NAMI_PURCHASE_CHANNEL, NAMI_PURCHASE_IMPRESSION_ID, NAMI_SDK_PACKAGE_VERSION, NAMI_SDK_VERSION, NAMI_SESSION_ID, NAMI_STORAGE_KEYS, Nami, NamiAPI, NamiAnimationType, NamiCampaignManager$2 as NamiCampaignManager, NamiCampaignRuleType, NamiConditionEvaluator, NamiCustomerManager$2 as NamiCustomerManager, NamiEntitlementManager$2 as NamiEntitlementManager, NamiEventEmitter, NamiFlow, NamiFlowActionFunction, NamiFlowManager$1 as NamiFlowManager, NamiFlowStepType, NamiHandoffTag, NamiPaywallAction, NamiPaywallManager$2 as NamiPaywallManager, PaywallManagerEvents as NamiPaywallManagerEvents, NamiPermissionOutcome, NamiPurchaseManager$2 as NamiPurchaseManager, NamiRefs, NamiReservedActions, NotFoundError, PAYWALL_ACTION_EVENT, PLATFORM_ID_REQUIRED, PRODUCTION, PaywallManagerEvents, PaywallRepository, PaywallState, PlacementLabelResolver, PlatformIDRequiredError, ProductRepository, RECONFIG_SUCCESS, RESUME_THROTTLE_MS, RetryLimitExceededError, SDKNotInitializedError, SDK_NOT_INITIALIZED, SERVER_NAMI_ENTITLEMENTS, SESSION_REQUIRED, SHOULD_SHOW_LOADING_INDICATOR, SIMULATE_CONFIG_FETCH_FAILURE, SIMULATE_PAYWALL_FETCH_FAILURE, SKU_TEXT_REGEX, SMART_TEXT_PATTERN, STARTUP_TELEMETRY, STATUS_BAD_REQUEST, STATUS_CONFLICT, STATUS_INTERNAL_SERVER_ERROR, STATUS_NOT_FOUND, STATUS_SUCCESS, SYSTEM_TIME_FILTER_PREFIX, SYSTEM_TIME_TOKEN_PREFIX, SessionService, SimpleEventTarget, StorageService, TIME_OVERRIDE_PREFIX, TRANSPORT_FAILURE_STATUS, UNABLE_TO_UPDATE_CDP_ID, USE_STAGING_API, VALIDATE_PRODUCT_GROUPS, VAR_REGEX, NamiProfileManager$1 as _NamiProfileManager, internal as _internal, activateEntitlementByPurchase, activeEntitlements, aggregateScreenreaderText, allCampaigns, allPaywalls, applyEntitlementActivation, audienceSplitPosition, bestUrlCampaignMatch, bigintToUuid, checkAnySkuHasPromoOffer, checkAnySkuHasTrialOffer, convertISO8601PeriodToText, convertLocale, convertOfferToPricingPhase, createNamiEntitlements, currentSku, didReceiveResponse, empty, evaluateSystemTimeAssertion, evaluateSystemTimeCondition, evenSegmentWidth, extractStandardPricingPhases, firstSet, formatDate, formattedPrice, generateUUID, getApiCampaigns, getApiPaywalls, getBaseUrl, getBillingPeriodNumber, getCurrencyFormat, getDeviceData, getDeviceFormFactor, getDeviceScaleFactor, getEffectiveWebStyle, getEntitlementRefIdsForSku, getExtendedClientInfo, getFreeTrialPeriod, getInitialCampaigns, getInitialPaywalls, getJourneySettings, getPaywall, getPaywallDataFromLabel, getPercentagePriceDifference, getPeriodNumberInDays, getPeriodNumberInWeeks, getPlatformAdapters, getPriceDifference, getPricePerMonth, getProductDetail, getPurchaseAdapter, getReferenceSku, getSkuProductDetailKeys, getSkuSmartTextValue, getSlideSmartTextValue, getStandardBillingPeriod, getSystemTimeNow, getTranslate, getUrlParams, handleErrors, hasAllPaywalls, hasCapability, hasPurchaseManagement, initialState, invokeHandler, isAnonymousMode, isInitialConfigCompressed, isNamiFlowCampaign, isStepsStyle, isSubscription, isSystemTimeAssertion, isValidISODate, isValidUrl, logger, mapAnonymousCampaigns, namiBuySKU, normalizeLaunchContext, parseTimeOverride, parseToSemver, postConversion, productDetail, registerAPITrafficObserver, registerPlatformAdapters, registerPurchaseAdapter, resolveCurrentStep, resolveLoopSource, resolveStepAlignment, resolveStepCount, resolveStepSizing, selectSegment, setActiveNamiEntitlements, shouldValidateProductGroups, skuItems, skuMapFromEntitlements, stepSegmentState, storageService, toDouble, toNamiEntitlements, toNamiSKU, tryParseB64Gzip, tryParseJson, updateRelatedSKUsForNamiEntitlement, uuidFromSplitPosition, validateForm, validateMinSDKVersion, validateTextInput };
+export type { AccountStateHandler$1 as AccountStateHandler, AlignmentType, AmazonProduct, ApiResponse, AppleProduct, AvailableCampaignsResponseHandler, BorderLocationType, BorderSideType, Callback$1 as Callback, CloseHandler, CustomerJourneyState, DeepLinkUrlHandler, Device, DevicePayload, DeviceProfile, DirectionType, ExtendedPlatformInfo, FlexDirectionObject, FlowNavigationOptions, FontCollection, FontDetails, FormFactor, FormFieldValidator, GoogleProduct, IConfig, IDeviceAdapter, IEntitlements$1 as IEntitlements, IPaywall, IPlatformAdapters, IProductsWithComponents, IPurchaseAdapter, ISkuMenu, IStorageAdapter, IUIAdapter, Impression, InitialConfig, InitialConfigCompressed, InitiateStateGroup, JourneySettings, LoginResponse, NamiAPITrafficKind, NamiAPITrafficObserver, NamiAPITrafficRecord, NamiAnimation, NamiAnimationObjectSpec, NamiAnimationSpec, NamiAnonymousCampaign, NamiAppSuppliedVideoDetails, NamiCampaign, NamiCampaignManagerStatic, NamiCampaignSegment, NamiCompletionResult, NamiConfiguration, NamiConfigurationState, NamiCustomAttributeValue, NamiCustomerManagerStatic, NamiEntitlement$1 as NamiEntitlement, NamiEntitlementManagerStatic, NamiFlowAction, NamiFlowAnimation, NamiFlowCampaign, NamiFlowCompletionCondition, NamiFlowDTO, NamiFlowEventHandler, NamiFlowHandoffStepHandler, NamiFlowManagerStatic, NamiFlowObjectDTO, NamiFlowOn, NamiFlowStep, NamiFlowTransition, NamiFlowTransitionDirection, NamiFlowWithObject, NamiHandoffAttributeValue, NamiHandoffComplete, NamiHandoffOutcome, NamiHandoffTagValue, NamiInitialConfig, NamiKnownHandoffTag, NamiLanguageCodes, NamiLogLevel, NamiLoginSuccess, NamiPaywallActionHandler, NamiPaywallComponentChange, NamiPaywallEvent, NamiPaywallEventVideoMetadata, NamiPaywallLaunchContext, NamiPaywallManagerStatic, NamiPresentationStyle, NamiProductDetails, NamiProductOffer, NamiProfile, NamiPurchase, NamiPurchaseCompleteResult, NamiPurchaseDetails, NamiPurchaseManagerStatic, NamiPurchaseSuccess, NamiPurchasesState, NamiSKU, NamiSKUType, NamiSubscriptionInterval, NamiSubscriptionPeriod, NamiUserDataEnvelope, None, NoneSpec, PaywallActionEvent, PaywallHandle, PaywallResultHandler, PaywallSKU, PricingPhase, ProductGroup, Pulse, PulseSpec, PurchaseContext, PurchaseResult, PurchaseValidationRequest, SKU, SKUActionHandler, ScreenInfo, Session, TBaseComponent, TButtonContainer, TCarouselContainer, TCarouselSlide, TCarouselSlidesState, TCollapseContainer, TComponent, TConditionalAttributes, TConditionalComponent, TContainer, TContainerPosition, TCountdownTimerTextComponent, TDevice, TDisabledButton, TField, TFieldSettings, TFlexProductContainer, THeaderFooter, TImageComponent, TInitialState, TMediaTypes, TOffer, TPages, TPaywallContext, TPaywallLaunchContext, TPaywallMedia, TPaywallTemplate, TPlayPauseButton, TProductContainer, TProductGroup, TProgressBarComponent, TProgressIndicatorComponent, TQRCodeComponent, TRadioButton, TRepeatingGrid, TResponsiveGrid, TSegmentPicker, TSegmentPickerItem, TSemverObj, TSlot, TSlotGroupSelector, TSpacerComponent, TStack, TStepState, TSvgImageComponent, TSymbolComponent, TTestObject, TTextComponent, TTextInputComponent, TTextInputType, TTextLikeComponent, TTextListComponent, TTimelineRail, TToggleButtonComponent, TToggleSwitch, TVariablePattern, TVideoComponent, TVolumeButton, TimerState, TransactionRequest, UserAction, UserActionParameters, Wave, WaveSpec };

package/dist/index.mjs

@@ -104,7 +104,7 @@ const {
 // version — stamped by scripts/version.sh
 NAMI_SDK_VERSION = "3.5.0", 
 // full package version including dev suffix — stamped by scripts/version.sh
-NAMI_SDK_PACKAGE_VERSION = "3.5.0-dev.202610312243", 
+NAMI_SDK_PACKAGE_VERSION = "3.5.0-dev.202611011549", 
 // environments
 PRODUCTION = "production", DEVELOPMENT = "development", 
 // error messages
@@ -64650,33 +64650,60 @@ let NamiFlowManager$2 = class NamiFlowManager {
     getCurrentFlowProgress(key) {
         if (!this.currentFlow)
             return 1;
-        if (!this.currentFlow.currentFlowStep)
+        const position = this.getCurrentFlowStepPosition();
+        if (!position)
+            return 0;
+        let progress = position.index / position.total;
+        progress = Math.max(0, Math.min(1, progress));
+        if (key) {
+            this.setLastAnimatedFlowProgress(key, progress);
+        }
+        return progress;
+    }
+    /**
+     * Gets the 1-based position of the current screen within the flow, using the
+     * same step math as {@link getCurrentFlowProgress}.
+     * @returns The current step index (1-based), or 0 when unknown
+     */
+    getCurrentFlowStepIndex() {
+        const position = this.getCurrentFlowStepPosition();
+        if (!position)
             return 0;
+        return Math.max(0, Math.min(position.total, position.index));
+    }
+    /**
+     * Gets the total number of screen steps the current flow's progress is measured against.
+     * @returns The total step count, or 0 when unknown (no open flow, no current step, no screens)
+     */
+    getTotalFlowSteps() {
+        return this.getCurrentFlowStepPosition()?.total ?? 0;
+    }
+    /**
+     * Resolves the current flow position as an integer pair. `index / total` is the
+     * flow progress. Returns null when the position is unknown.
+     */
+    getCurrentFlowStepPosition() {
+        if (!this.currentFlow)
+            return null;
+        if (!this.currentFlow.currentFlowStep)
+            return null;
         const allScreens = this.currentFlow.steps.filter(step => step.type === NamiFlowStepType.SCREEN);
         if (allScreens.length === 0)
-            return 0;
+            return null;
         const visitedScreens = this.currentFlow.stepcrumbs.filter(step => step.type === NamiFlowStepType.SCREEN);
         if (visitedScreens.length === 0)
-            return 0;
+            return null;
         const navGraph = this.buildNavGraph(this.currentFlow);
         const currentStep = this.currentFlow.currentFlowStep;
         // Find the branch point (first screen with multiple forward paths)
         const branchPoint = this.findBranchPoint(allScreens, navGraph);
-        let progress = 0;
         if (branchPoint) {
             // Branching flow
-            progress = this.calculateBranchingProgress(visitedScreens, allScreens, currentStep, branchPoint, navGraph);
-        }
-        else {
-            // Linear flow
-            const currentIndex = allScreens.findIndex(s => s.id === currentStep.id);
-            progress = currentIndex >= 0 ? (currentIndex + 1) / allScreens.length : 0;
-        }
-        progress = Math.max(0, Math.min(1, progress));
-        if (key) {
-            this.setLastAnimatedFlowProgress(key, progress);
+            return this.calculateBranchingProgress(visitedScreens, allScreens, currentStep, branchPoint, navGraph);
         }
-        return progress;
+        // Linear flow
+        const currentIndex = allScreens.findIndex(s => s.id === currentStep.id);
+        return { index: currentIndex >= 0 ? currentIndex + 1 : 0, total: allScreens.length };
     }
     /**
      * Find the first screen that has branching (multiple forward navigation targets)
@@ -64690,7 +64717,8 @@ let NamiFlowManager$2 = class NamiFlowManager {
         return null;
     }
     /**
-     * Calculate progress for flows with branching (supports 2+ branches)
+     * Calculate the step position for flows with branching (supports 2+ branches).
+     * Progress is `index / total`.
      */
     calculateBranchingProgress(visitedScreens, allScreens, currentStep, branchPoint, navGraph) {
         const visitedCount = visitedScreens.length;
@@ -64704,14 +64732,14 @@ let NamiFlowManager$2 = class NamiFlowManager {
             //   - visitedScreens = currentPosition + 1 (0-indexed)
             //   - minimumTotalPathLength = branchPosition + 2
             //     (all screens before branch + branch itself + at least 1 screen after)
-            return (currentIndexInAll + 1) / (branchPointIndexInAll + 2);
+            return { index: currentIndexInAll + 1, total: branchPointIndexInAll + 2 };
         }
         // Case 2: Past the branch point (entered a specific branch)
         // Calculate based on: visitedScreens / (visitedScreens + remainingInThisBranch)
         const remainingInBranch = this.countForwardScreens(currentStep, allScreens, navGraph);
         const totalPathLength = visitedCount + remainingInBranch;
         logger.debug(`Branching progress: visited=${visitedCount}, remaining=${remainingInBranch}, total=${totalPathLength}, step=${currentStep.id}`);
-        return visitedCount / totalPathLength;
+        return { index: visitedCount, total: totalPathLength };
     }
     /**
      * Count how many screens are forward-reachable from the current step
@@ -64809,6 +64837,12 @@ let NamiFlowManager$2 = class NamiFlowManager {
     static getCurrentFlowProgress(key) {
         return this.instance.getCurrentFlowProgress(key);
     }
+    static getCurrentFlowStepIndex() {
+        return this.instance.getCurrentFlowStepIndex();
+    }
+    static getTotalFlowSteps() {
+        return this.instance.getTotalFlowSteps();
+    }
     /**
      * Gets the current flow step's auto-advance delay (in seconds)
      * Parses __appear__ actions to find flowNav/flowNext with a delay parameter
@@ -67013,6 +67047,111 @@ function aggregateScreenreaderText(page, focusedButtonLabel = '') {
     return joinFragments(fragments);
 }
 
+/**
+ * Step model for the stepped `progressIndicator` (`style: "steps"`).
+ *
+ * Pure helpers shared by every TypeScript renderer (Web, Expo). Apple and
+ * Android mirror these rules natively, so keep the behaviour in sync with
+ * them when changing anything here.
+ */
+/** Smallest step count a fixed (non-"auto") `stepCount` resolves to. */
+const MIN_FIXED_STEP_COUNT = 2;
+/** Largest step count a fixed (non-"auto") `stepCount` resolves to. */
+const MAX_FIXED_STEP_COUNT = 12;
+/**
+ * Parses a numeric field that may arrive as a number or as a numeric string
+ * (for example from smart text). Returns NaN for "auto", missing, empty or
+ * unparseable values.
+ */
+function parseStepNumber(value) {
+    if (typeof value === "number")
+        return Number.isFinite(value) ? value : NaN;
+    if (typeof value === "string") {
+        const trimmed = value.trim();
+        if (trimmed === "")
+            return NaN;
+        const parsed = Number(trimmed);
+        return Number.isFinite(parsed) ? parsed : NaN;
+    }
+    return NaN;
+}
+/** True when the component asks for the stepped style; anything else renders the bar. */
+function isStepsStyle(c) {
+    return c.style === "steps";
+}
+/**
+ * Resolves the number of segments to draw.
+ *
+ * "auto", missing or unparseable values use `autoTotal` as is (not clamped).
+ * A number or numeric string is rounded and clamped to
+ * [MIN_FIXED_STEP_COUNT, MAX_FIXED_STEP_COUNT].
+ */
+function resolveStepCount(stepCount, autoTotal) {
+    const parsed = parseStepNumber(stepCount);
+    if (Number.isNaN(parsed))
+        return autoTotal;
+    return Math.min(MAX_FIXED_STEP_COUNT, Math.max(MIN_FIXED_STEP_COUNT, Math.round(parsed)));
+}
+/**
+ * Resolves the 1-based current step.
+ *
+ * "auto", missing or unparseable values use `autoIndex`. A number or numeric
+ * string is rounded but not clamped: out-of-range values are handled by
+ * {@link stepSegmentState}.
+ */
+function resolveCurrentStep(currentStep, autoIndex) {
+    const parsed = parseStepNumber(currentStep);
+    if (Number.isNaN(parsed))
+        return autoIndex;
+    return Math.round(parsed);
+}
+/**
+ * State of the segment at 1-based `index1` given the 1-based `current` step.
+ *
+ * `currentStep` mode marks only the matching segment as current. Any other
+ * `fillMode` (including unknown or missing) behaves as `fillUp`, which marks
+ * every segment up to and including `current` as active.
+ */
+function stepSegmentState(index1, current, fillMode) {
+    if (fillMode === "currentStep") {
+        return index1 === current ? "current" : "inactive";
+    }
+    return index1 <= current ? "active" : "inactive";
+}
+/**
+ * Width of one segment when `count` segments separated by `spacing` share
+ * `available` width evenly. Never negative; 0 when `count <= 0`.
+ */
+function evenSegmentWidth(available, count, spacing) {
+    if (count <= 0)
+        return 0;
+    return Math.max(0, (available - (count - 1) * spacing) / count);
+}
+/** Resolves `stepSizing`; unknown or missing values fall back to "even". */
+function resolveStepSizing(v) {
+    return v === "fixed" ? "fixed" : "even";
+}
+/** Resolves `alignment`; unknown or missing values fall back to "center". */
+function resolveStepAlignment(v) {
+    return v === "left" || v === "right" ? v : "center";
+}
+/**
+ * First value that is actually set: skips `undefined`, `null`, `""` and
+ * whitespace-only strings, so an empty `current*` field falls back to the
+ * next candidate (for example `active*`) the way Apple and Android do.
+ * `0`, `false` and other falsy non-string values count as set.
+ */
+function firstSet(...values) {
+    for (const v of values) {
+        if (v === undefined || v === null)
+            continue;
+        if (typeof v === "string" && v.trim() === "")
+            continue;
+        return v;
+    }
+    return undefined;
+}
+
 function namiBuySKU(skuRefId) {
     if (!hasPurchaseManagement("NamiPurchaseManager.buySKU")) {
         return;
@@ -67074,4 +67213,4 @@ var internal = /*#__PURE__*/Object.freeze({
     NamiPurchaseManager: NamiPurchaseManager
 });
 
-export { ALREADY_CONFIGURED, ANONYMOUS_MODE, ANONYMOUS_MODE_ALREADY_OFF, ANONYMOUS_MODE_ALREADY_ON, ANONYMOUS_MODE_LOGIN_NOT_ALLOWED, ANONYMOUS_UUID, APIError, API_ACTIVE_ENTITLEMENTS, API_CAMPAIGN_RULES, API_CAMPAIGN_SESSION_TIMESTAMP, API_CONFIG, API_MAX_CALLS_LIMIT, API_PAYWALLS, API_PRODUCTS, API_RETRY_DELAY_SEC, API_TIMEOUT_LIMIT, API_TRAFFIC_OBSERVER, API_VERSION, AUTH_DEVICE, AVAILABLE_ACTIVE_ENTITLEMENTS_CHANGED, AVAILABLE_CAMPAIGNS_CHANGED, AccountStateAction, AnonymousCDPError, AnonymousLoginError, AnonymousModeAlreadyOffError, AnonymousModeAlreadyOnError, BASE_STAGING_URL, BASE_URL, BASE_URL_PATH, BadRequestError, BasicNamiFlow, BorderMap, BorderSideMap, CAMPAIGN_CACHE_TTL_PREFIX, CAMPAIGN_NOT_AVAILABLE, CONFIG_API_TIMEOUT_LIMIT, CONFIG_MAX_ATTEMPTS, CUSTOMER_ATTRIBUTES_KEY_PREFIX, CUSTOMER_JOURNEY_STATE_CHANGED, CUSTOM_HOST_PREFIX, CampaignNotAvailableError, CampaignRuleConversionEventType, CampaignRuleRepository, Capabilities, ClientError, ConfigRepository, ConflictError, CustomerJourneyRepository, DEFAULT_JOURNEY_SETTINGS, DEVELOPMENT, DEVICE_API_TIMEOUT_LIMIT, DEVICE_ID_NOT_SET, DEVICE_ID_REQUIRED, DISABLE_ASYNC_LOGIN_LOGOUT, DeviceIDRequiredError, DeviceRepository, EXTENDED_CLIENT_INFO_DELIMITER, EXTENDED_CLIENT_INFO_PREFIX, EXTENDED_PLATFORM, EXTENDED_PLATFORM_VERSION, EXTERNAL_ID_REQUIRED, EntitlementRepository, EntitlementUtils, ExternalIDRequiredError, FLOW_SCREENS_NOT_AVAILABLE, FlowScreensNotAvailableError, HTML_REGEX, INITIAL_APP_CONFIG, INITIAL_CAMPAIGN_RULES, INITIAL_PAYWALLS, INITIAL_PRODUCTS, INITIAL_SESSION_COUNTER_VALUE, INITIAL_SUCCESS, InternalServerError, KEY_SESSION_COUNTER, LIQUID_VARIABLE_REGEX, LOCAL_NAMI_ENTITLEMENTS, LOG_HTTP_REQUESTS, LOG_HTTP_TRAFFIC, LaunchCampaignError, LaunchContextResolver, LogLevel, NAMI_CONFIGURATION, NAMI_CUSTOMER_JOURNEY_STATE, NAMI_LANGUAGE_CODE, NAMI_LAST_IMPRESSION_ID, NAMI_LAUNCH_ID, NAMI_PROFILE, NAMI_PURCHASE_CHANNEL, NAMI_PURCHASE_IMPRESSION_ID, NAMI_SDK_PACKAGE_VERSION, NAMI_SDK_VERSION, NAMI_SESSION_ID, NAMI_STORAGE_KEYS, Nami, NamiAPI, NamiAnimationType, NamiCampaignManager$1 as NamiCampaignManager, NamiCampaignRuleType, NamiConditionEvaluator, NamiCustomerManager$1 as NamiCustomerManager, NamiEntitlementManager$1 as NamiEntitlementManager, NamiEventEmitter, NamiFlow, NamiFlowActionFunction, NamiFlowManager$1 as NamiFlowManager, NamiFlowStepType, NamiHandoffTag, NamiPaywallAction, NamiPaywallManager$1 as NamiPaywallManager, PaywallManagerEvents as NamiPaywallManagerEvents, NamiPermissionOutcome, NamiPurchaseManager$1 as NamiPurchaseManager, NamiRefs, NamiReservedActions, NotFoundError, PAYWALL_ACTION_EVENT, PLATFORM_ID_REQUIRED, PRODUCTION, PaywallManagerEvents, PaywallRepository, PaywallState, PlacementLabelResolver, PlatformIDRequiredError, ProductRepository, RECONFIG_SUCCESS, RESUME_THROTTLE_MS, RetryLimitExceededError, SDKNotInitializedError, SDK_NOT_INITIALIZED, SERVER_NAMI_ENTITLEMENTS, SESSION_REQUIRED, SHOULD_SHOW_LOADING_INDICATOR, SIMULATE_CONFIG_FETCH_FAILURE, SIMULATE_PAYWALL_FETCH_FAILURE, SKU_TEXT_REGEX, SMART_TEXT_PATTERN, STARTUP_TELEMETRY, STATUS_BAD_REQUEST, STATUS_CONFLICT, STATUS_INTERNAL_SERVER_ERROR, STATUS_NOT_FOUND, STATUS_SUCCESS, SYSTEM_TIME_FILTER_PREFIX, SYSTEM_TIME_TOKEN_PREFIX, SessionService, SimpleEventTarget, StorageService, TIME_OVERRIDE_PREFIX, TRANSPORT_FAILURE_STATUS, UNABLE_TO_UPDATE_CDP_ID, USE_STAGING_API, VALIDATE_PRODUCT_GROUPS, VAR_REGEX, NamiProfileManager$1 as _NamiProfileManager, internal as _internal, activateEntitlementByPurchase, activeEntitlements, aggregateScreenreaderText, allCampaigns, allPaywalls, applyEntitlementActivation, audienceSplitPosition, bestUrlCampaignMatch, bigintToUuid, checkAnySkuHasPromoOffer, checkAnySkuHasTrialOffer, convertISO8601PeriodToText, convertLocale, convertOfferToPricingPhase, createNamiEntitlements, currentSku, didReceiveResponse, empty, evaluateSystemTimeAssertion, evaluateSystemTimeCondition, extractStandardPricingPhases, formatDate, formattedPrice, generateUUID, getApiCampaigns, getApiPaywalls, getBaseUrl, getBillingPeriodNumber, getCurrencyFormat, getDeviceData, getDeviceFormFactor, getDeviceScaleFactor, getEffectiveWebStyle, getEntitlementRefIdsForSku, getExtendedClientInfo, getFreeTrialPeriod, getInitialCampaigns, getInitialPaywalls, getJourneySettings, getPaywall, getPaywallDataFromLabel, getPercentagePriceDifference, getPeriodNumberInDays, getPeriodNumberInWeeks, getPlatformAdapters, getPriceDifference, getPricePerMonth, getProductDetail, getPurchaseAdapter, getReferenceSku, getSkuProductDetailKeys, getSkuSmartTextValue, getSlideSmartTextValue, getStandardBillingPeriod, getSystemTimeNow, getTranslate, getUrlParams, handleErrors, hasAllPaywalls, hasCapability, hasPurchaseManagement, initialState, invokeHandler, isAnonymousMode, isInitialConfigCompressed, isNamiFlowCampaign, isSubscription, isSystemTimeAssertion, isValidISODate, isValidUrl, logger, mapAnonymousCampaigns, namiBuySKU, normalizeLaunchContext, parseTimeOverride, parseToSemver, postConversion, productDetail, registerAPITrafficObserver, registerPlatformAdapters, registerPurchaseAdapter, resolveLoopSource, selectSegment, setActiveNamiEntitlements, shouldValidateProductGroups, skuItems, skuMapFromEntitlements, storageService, toDouble, toNamiEntitlements, toNamiSKU, tryParseB64Gzip, tryParseJson, updateRelatedSKUsForNamiEntitlement, uuidFromSplitPosition, validateForm, validateMinSDKVersion, validateTextInput };
+export { ALREADY_CONFIGURED, ANONYMOUS_MODE, ANONYMOUS_MODE_ALREADY_OFF, ANONYMOUS_MODE_ALREADY_ON, ANONYMOUS_MODE_LOGIN_NOT_ALLOWED, ANONYMOUS_UUID, APIError, API_ACTIVE_ENTITLEMENTS, API_CAMPAIGN_RULES, API_CAMPAIGN_SESSION_TIMESTAMP, API_CONFIG, API_MAX_CALLS_LIMIT, API_PAYWALLS, API_PRODUCTS, API_RETRY_DELAY_SEC, API_TIMEOUT_LIMIT, API_TRAFFIC_OBSERVER, API_VERSION, AUTH_DEVICE, AVAILABLE_ACTIVE_ENTITLEMENTS_CHANGED, AVAILABLE_CAMPAIGNS_CHANGED, AccountStateAction, AnonymousCDPError, AnonymousLoginError, AnonymousModeAlreadyOffError, AnonymousModeAlreadyOnError, BASE_STAGING_URL, BASE_URL, BASE_URL_PATH, BadRequestError, BasicNamiFlow, BorderMap, BorderSideMap, CAMPAIGN_CACHE_TTL_PREFIX, CAMPAIGN_NOT_AVAILABLE, CONFIG_API_TIMEOUT_LIMIT, CONFIG_MAX_ATTEMPTS, CUSTOMER_ATTRIBUTES_KEY_PREFIX, CUSTOMER_JOURNEY_STATE_CHANGED, CUSTOM_HOST_PREFIX, CampaignNotAvailableError, CampaignRuleConversionEventType, CampaignRuleRepository, Capabilities, ClientError, ConfigRepository, ConflictError, CustomerJourneyRepository, DEFAULT_JOURNEY_SETTINGS, DEVELOPMENT, DEVICE_API_TIMEOUT_LIMIT, DEVICE_ID_NOT_SET, DEVICE_ID_REQUIRED, DISABLE_ASYNC_LOGIN_LOGOUT, DeviceIDRequiredError, DeviceRepository, EXTENDED_CLIENT_INFO_DELIMITER, EXTENDED_CLIENT_INFO_PREFIX, EXTENDED_PLATFORM, EXTENDED_PLATFORM_VERSION, EXTERNAL_ID_REQUIRED, EntitlementRepository, EntitlementUtils, ExternalIDRequiredError, FLOW_SCREENS_NOT_AVAILABLE, FlowScreensNotAvailableError, HTML_REGEX, INITIAL_APP_CONFIG, INITIAL_CAMPAIGN_RULES, INITIAL_PAYWALLS, INITIAL_PRODUCTS, INITIAL_SESSION_COUNTER_VALUE, INITIAL_SUCCESS, InternalServerError, KEY_SESSION_COUNTER, LIQUID_VARIABLE_REGEX, LOCAL_NAMI_ENTITLEMENTS, LOG_HTTP_REQUESTS, LOG_HTTP_TRAFFIC, LaunchCampaignError, LaunchContextResolver, LogLevel, MAX_FIXED_STEP_COUNT, MIN_FIXED_STEP_COUNT, NAMI_CONFIGURATION, NAMI_CUSTOMER_JOURNEY_STATE, NAMI_LANGUAGE_CODE, NAMI_LAST_IMPRESSION_ID, NAMI_LAUNCH_ID, NAMI_PROFILE, NAMI_PURCHASE_CHANNEL, NAMI_PURCHASE_IMPRESSION_ID, NAMI_SDK_PACKAGE_VERSION, NAMI_SDK_VERSION, NAMI_SESSION_ID, NAMI_STORAGE_KEYS, Nami, NamiAPI, NamiAnimationType, NamiCampaignManager$1 as NamiCampaignManager, NamiCampaignRuleType, NamiConditionEvaluator, NamiCustomerManager$1 as NamiCustomerManager, NamiEntitlementManager$1 as NamiEntitlementManager, NamiEventEmitter, NamiFlow, NamiFlowActionFunction, NamiFlowManager$1 as NamiFlowManager, NamiFlowStepType, NamiHandoffTag, NamiPaywallAction, NamiPaywallManager$1 as NamiPaywallManager, PaywallManagerEvents as NamiPaywallManagerEvents, NamiPermissionOutcome, NamiPurchaseManager$1 as NamiPurchaseManager, NamiRefs, NamiReservedActions, NotFoundError, PAYWALL_ACTION_EVENT, PLATFORM_ID_REQUIRED, PRODUCTION, PaywallManagerEvents, PaywallRepository, PaywallState, PlacementLabelResolver, PlatformIDRequiredError, ProductRepository, RECONFIG_SUCCESS, RESUME_THROTTLE_MS, RetryLimitExceededError, SDKNotInitializedError, SDK_NOT_INITIALIZED, SERVER_NAMI_ENTITLEMENTS, SESSION_REQUIRED, SHOULD_SHOW_LOADING_INDICATOR, SIMULATE_CONFIG_FETCH_FAILURE, SIMULATE_PAYWALL_FETCH_FAILURE, SKU_TEXT_REGEX, SMART_TEXT_PATTERN, STARTUP_TELEMETRY, STATUS_BAD_REQUEST, STATUS_CONFLICT, STATUS_INTERNAL_SERVER_ERROR, STATUS_NOT_FOUND, STATUS_SUCCESS, SYSTEM_TIME_FILTER_PREFIX, SYSTEM_TIME_TOKEN_PREFIX, SessionService, SimpleEventTarget, StorageService, TIME_OVERRIDE_PREFIX, TRANSPORT_FAILURE_STATUS, UNABLE_TO_UPDATE_CDP_ID, USE_STAGING_API, VALIDATE_PRODUCT_GROUPS, VAR_REGEX, NamiProfileManager$1 as _NamiProfileManager, internal as _internal, activateEntitlementByPurchase, activeEntitlements, aggregateScreenreaderText, allCampaigns, allPaywalls, applyEntitlementActivation, audienceSplitPosition, bestUrlCampaignMatch, bigintToUuid, checkAnySkuHasPromoOffer, checkAnySkuHasTrialOffer, convertISO8601PeriodToText, convertLocale, convertOfferToPricingPhase, createNamiEntitlements, currentSku, didReceiveResponse, empty, evaluateSystemTimeAssertion, evaluateSystemTimeCondition, evenSegmentWidth, extractStandardPricingPhases, firstSet, formatDate, formattedPrice, generateUUID, getApiCampaigns, getApiPaywalls, getBaseUrl, getBillingPeriodNumber, getCurrencyFormat, getDeviceData, getDeviceFormFactor, getDeviceScaleFactor, getEffectiveWebStyle, getEntitlementRefIdsForSku, getExtendedClientInfo, getFreeTrialPeriod, getInitialCampaigns, getInitialPaywalls, getJourneySettings, getPaywall, getPaywallDataFromLabel, getPercentagePriceDifference, getPeriodNumberInDays, getPeriodNumberInWeeks, getPlatformAdapters, getPriceDifference, getPricePerMonth, getProductDetail, getPurchaseAdapter, getReferenceSku, getSkuProductDetailKeys, getSkuSmartTextValue, getSlideSmartTextValue, getStandardBillingPeriod, getSystemTimeNow, getTranslate, getUrlParams, handleErrors, hasAllPaywalls, hasCapability, hasPurchaseManagement, initialState, invokeHandler, isAnonymousMode, isInitialConfigCompressed, isNamiFlowCampaign, isStepsStyle, isSubscription, isSystemTimeAssertion, isValidISODate, isValidUrl, logger, mapAnonymousCampaigns, namiBuySKU, normalizeLaunchContext, parseTimeOverride, parseToSemver, postConversion, productDetail, registerAPITrafficObserver, registerPlatformAdapters, registerPurchaseAdapter, resolveCurrentStep, resolveLoopSource, resolveStepAlignment, resolveStepCount, resolveStepSizing, selectSegment, setActiveNamiEntitlements, shouldValidateProductGroups, skuItems, skuMapFromEntitlements, stepSegmentState, storageService, toDouble, toNamiEntitlements, toNamiSKU, tryParseB64Gzip, tryParseJson, updateRelatedSKUsForNamiEntitlement, uuidFromSplitPosition, validateForm, validateMinSDKVersion, validateTextInput };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@namiml/sdk-core",
-  "version": "3.5.0-dev.202610312243",
+  "version": "3.5.0-dev.202611011549",
   "description": "Platform-agnostic core for the Nami SDK — business logic, API, types, and state management",
   "type": "module",
   "main": "./dist/index.cjs",