@posthog/browser-common 0.9.4 → 0.9.6

package/dist/surveys/survey-styles.mjs

@@ -0,0 +1,2 @@
+const surveyStyles = ':host{--ph-survey-font-family:-apple-system, BlinkMacSystemFont, "Inter", "Segoe UI", "Roboto", Helvetica, Arial, sans-serif, "Apple Color Emoji", "Segoe UI Emoji", "Segoe UI Symbol";--ph-survey-box-padding:20px 24px;--ph-survey-max-width:300px;--ph-survey-z-index:calc(2147480000 + 3645);--ph-survey-border-color:#dcdcdc;--ph-survey-border-bottom:1.5px solid var(--ph-survey-border-color);--ph-survey-border-radius:10px;--ph-survey-background-color:#eeeded;--ph-survey-box-shadow:0 4px 12px #00000026;--ph-survey-submit-button-color:black;--ph-survey-submit-button-text-color:white;--ph-survey-rating-bg-color:white;--ph-survey-rating-text-color:#020617;--ph-survey-rating-active-bg-color:black;--ph-survey-rating-active-text-color:white;--ph-survey-text-primary-color:#020617;--ph-survey-text-subtle-color:#939393;--ph-widget-color:#e0a045;--ph-widget-text-color:white;--ph-survey-scrollbar-thumb-color:var(--ph-survey-border-color);--ph-survey-scrollbar-track-color:var(--ph-survey-background-color);--ph-survey-outline-color:#3b82f6cc;--ph-survey-input-background:white;--ph-survey-input-text-color:#020617;--ph-survey-disabled-button-opacity:.6}.ph-survey{min-width:300px;width:var(--ph-survey-max-width);max-width:85%;z-index:var(--ph-survey-z-index);height:fit-content;margin:0;position:fixed;bottom:0}.ph-survey h3,.ph-survey p{margin:0}.ph-survey *{box-sizing:border-box;font-family:var(--ph-survey-font-family);color:var(--ph-survey-text-primary-color)}.ph-survey textarea,.ph-survey input[type=text],.ph-survey .multiple-choice-options label{color:var(--ph-survey-input-text-color);background:var(--ph-survey-input-background);border:1.5px solid var(--ph-survey-border-color);border-radius:4px;padding:10px;transition:border-color .2s ease-out,box-shadow .2s ease-out,transform .15s ease-out}.ph-survey textarea,.ph-survey input[type=text]{transition:border-color .2s ease-out,box-shadow .2s ease-out,transform .15s ease-out}.ph-survey input{margin:0}.ph-survey textarea:focus,.ph-survey textarea:focus-visible,.ph-survey input[type=text]:focus,.ph-survey input[type=text]:focus-visible,.ph-survey .form-submit:focus,.ph-survey .form-submit:focus-visible,.ph-survey input[type=checkbox]:focus,.ph-survey input[type=radio]:focus,.ph-survey input[type=checkbox]:focus-visible,.ph-survey input[type=radio]:focus-visible{outline:1.5px solid var(--ph-survey-outline-color);border-color:var(--ph-survey-rating-active-bg-color);outline-offset:2px}.ph-survey textarea:focus:not(:focus-visible),.ph-survey input[type=text]:focus:not(:focus-visible),.ph-survey button:focus:not(:focus-visible),.ph-survey input[type=checkbox]:focus:not(:focus-visible),.ph-survey input[type=radio]:focus:not(:focus-visible){outline:none}.ph-survey textarea:hover:not(:focus),.ph-survey input[type=text]:hover:not(:focus){border-color:var(--ph-survey-rating-active-bg-color)}@media (max-width:768px){.ph-survey textarea,.ph-survey input[type=text]{font-size:1rem}}.ph-survey .multiple-choice-options label,.ph-survey .rating-options-number,.ph-survey .form-cancel,.ph-survey input[type=checkbox],.ph-survey input[type=radio]{border:1.5px solid var(--ph-survey-border-color)}.ph-survey label,.ph-survey input[type=checkbox],.ph-survey input[type=radio],.ph-survey .ratings-emoji,.ph-survey .ratings-number,.ph-survey .footer-branding,.ph-survey .form-cancel,.ph-survey .form-submit{transition:all .2s ease-out}@media (prefers-reduced-motion:no-preference){.ph-survey button:active,.ph-survey input[type=checkbox]:active,.ph-survey input[type=radio]:active,.ph-survey label:active{transition-duration:.1s}}.ph-survey-widget-tab{background:var(--ph-widget-color);color:var(--ph-widget-text-color);text-align:center;cursor:pointer;z-index:var(--ph-survey-z-index);border:none;border-radius:3px 3px 0 0;padding:10px 12px;transition:padding .2s ease-out;position:fixed}.ph-survey-widget-tab:hover:not(.widget-tab-top){padding-bottom:16px}.ph-survey-widget-tab.widget-tab-top{border-radius:0 0 3px 3px}.ph-survey-widget-tab.widget-tab-top:hover{padding-top:16px}@keyframes ph-survey-fade-in{0%{opacity:0}to{opacity:1}}.survey-box{flex-direction:column;gap:16px;display:flex}.bottom-section{flex-direction:column;gap:8px;display:flex}.thank-you-message-header~.bottom-section,.intro-screen-header~.bottom-section{padding-top:16px}.question-container,.thank-you-message,.intro-screen{flex-direction:column;gap:8px;display:flex}.survey-question{font-size:14px;font-weight:500}.survey-question-description{opacity:.8;padding-top:4px;font-size:13px}.survey-question-description,.thank-you-message-body,.intro-screen-body{word-wrap:break-word;overflow-wrap:break-word}:is(.survey-question-description,.thank-you-message-body,.intro-screen-body) img,:is(.survey-question-description,.thank-you-message-body,.intro-screen-body) video,:is(.survey-question-description,.thank-you-message-body,.intro-screen-body) iframe,:is(.survey-question-description,.thank-you-message-body,.intro-screen-body) embed,:is(.survey-question-description,.thank-you-message-body,.intro-screen-body) object,:is(.survey-question-description,.thank-you-message-body,.intro-screen-body) svg{max-width:100%;height:auto}.question-textarea-wrapper{flex-direction:column;display:flex}.survey-form{animation:.3s ease-out forwards ph-survey-fade-in}.survey-form,.thank-you-message,.intro-screen{text-align:left;width:100%;z-index:var(--ph-survey-z-index);border:1.5px solid var(--ph-survey-border-color);border-bottom:var(--ph-survey-border-bottom);background:var(--ph-survey-background-color);border-radius:var(--ph-survey-border-radius);box-shadow:var(--ph-survey-box-shadow);padding:var(--ph-survey-box-padding);margin:0;position:relative}.survey-form textarea,.survey-form input[type=text]{min-width:100%}.survey-form textarea:focus,.survey-form textarea:focus-visible{box-shadow:0 4px 12px #00000014}.survey-form textarea:focus:not(:focus-visible){box-shadow:none}.survey-box .question-header--empty~.multiple-choice-options,.survey-box .question-header--empty~textarea{margin-top:0}.multiple-choice-options{border:none;flex-direction:column;gap:8px;margin:0;padding:1px 0;font-size:14px;display:flex}.multiple-choice-options label,.multiple-choice-options .response-choice{color:inherit;align-items:center;gap:8px;display:flex}.multiple-choice-options label{cursor:pointer;font-size:13px}.multiple-choice-options label:hover:not(:has(input:checked)){border-color:var(--ph-survey-text-subtle-color);box-shadow:0 2px 8px #00000014}.multiple-choice-options label:has(input:checked){border-color:var(--ph-survey-rating-active-bg-color);box-shadow:0 1px 4px #0000000d}.multiple-choice-options label.choice-option-open{flex-wrap:wrap}.multiple-choice-options label span{color:inherit}.multiple-choice-options input[type=checkbox],.multiple-choice-options input[type=radio]{-webkit-appearance:none;-moz-appearance:none;appearance:none;background:var(--ph-survey-input-background);cursor:pointer;z-index:1;border-radius:3px;flex-shrink:0;width:1rem;height:1rem;transition:all .2s cubic-bezier(.4,0,.2,1),transform .15s ease-out;position:relative}:is(.multiple-choice-options input[type=checkbox],.multiple-choice-options input[type=radio]):focus{transform:scale(1.05)}:is(.multiple-choice-options input[type=checkbox],.multiple-choice-options input[type=radio]):hover{border-color:var(--ph-survey-rating-active-bg-color);transform:scale(1.05)}:is(.multiple-choice-options input[type=checkbox],.multiple-choice-options input[type=radio]):active{transform:scale(.95)}:is(.multiple-choice-options input[type=checkbox],.multiple-choice-options input[type=radio]):checked{background:var(--ph-survey-rating-active-bg-color);border-color:var(--ph-survey-rating-active-bg-color);transform:scale(1)}:is(.multiple-choice-options input[type=checkbox],.multiple-choice-options input[type=radio]):checked:hover{transform:scale(1.05)}.multiple-choice-options input[type=checkbox]:checked:after{border:solid var(--ph-survey-rating-active-text-color);border-width:0 2px 2px 0;width:4px;height:8px;animation:.2s ease-out .1s forwards ph-survey-checkmark-reveal;left:4px;transform:rotate(45deg)scale(0)}.multiple-choice-options input[type=radio]:checked:after{background:var(--ph-survey-rating-active-text-color);border-radius:50%;width:6px;height:6px;animation:.15s ease-out 50ms forwards ph-survey-radio-reveal;top:5px;left:5px;transform:scale(0)}.multiple-choice-options input[type=checkbox]:checked:after,.multiple-choice-options input[type=radio]:checked:after{content:"";box-sizing:content-box;position:absolute}.multiple-choice-options input[type=radio]{border-radius:50%}.multiple-choice-options input[type=radio]:checked{border:none}:is(.multiple-choice-options input[type=checkbox]:checked,.multiple-choice-options input[type=radio]:checked)~*{font-weight:700}.multiple-choice-options .choice-option-open input[type=text]::placeholder{color:var(--ph-survey-text-subtle-color);font-weight:400}.rating-options-emoji{justify-content:space-between;display:flex}.rating-options-emoji-2{justify-content:space-around}.ratings-emoji{opacity:.5;background-color:#0000;border:none;padding:0;font-size:16px}.ratings-emoji:hover{cursor:pointer;opacity:1;transform:scale(1.15)}.ratings-emoji.rating-active{opacity:1}.ratings-emoji svg{fill:var(--ph-survey-text-primary-color);transition:fill .2s ease-out}.rating-options-number{border-radius:6px;grid-auto-columns:1fr;grid-auto-flow:column;display:grid;overflow:hidden}.rating-options-number .ratings-number{border-right:1px solid var(--ph-survey-border-color);text-align:center;cursor:pointer;color:var(--ph-survey-rating-text-color);border-top:none;border-bottom:none;border-left:none;font-weight:700}.rating-options-number .ratings-number:last-of-type{border-right:0}.rating-options-number .ratings-number.rating-active{background:var(--ph-survey-rating-active-bg-color);color:var(--ph-survey-rating-active-text-color)}.ratings-number{background-color:var(--ph-survey-rating-bg-color);border:none;padding:8px 0}.ratings-number .rating-active{background-color:var(--ph-survey-rating-active-bg-color)}.ratings-number{cursor:pointer}@media (hover:hover) and (pointer:fine){.ratings-number:hover:not(.rating-active){background-color:color-mix(in srgb, var(--ph-survey-rating-active-bg-color) 14%, var(--ph-survey-rating-bg-color))}}.rating-text{opacity:.7;flex-direction:row;justify-content:space-between;font-size:11px;display:flex}.form-buttons{flex-direction:row;gap:8px;width:100%;display:flex}.form-buttons-with-back>.form-submit{flex:auto;min-width:0}.form-submit{text-align:center;cursor:pointer;user-select:none;background:var(--ph-survey-submit-button-color);color:var(--ph-survey-submit-button-text-color);border:none;border-radius:6px;min-width:100%;padding:12px;font-weight:700;box-shadow:0 2px #0000000b}.form-submit:not([disabled]):hover{transform:scale(1.02);box-shadow:0 4px 8px #0000001a}.form-submit:not([disabled]):active{transform:scale(.98);box-shadow:0 1px 2px #0000000d}.form-submit[disabled]{opacity:var(--ph-survey-disabled-button-opacity);cursor:not-allowed}.form-back{text-align:center;cursor:pointer;user-select:none;color:var(--ph-survey-text-primary-color);border:1.5px solid var(--ph-survey-border-color);background:0 0;border-radius:6px;flex:none;padding:12px 16px;font-weight:600}.form-back:hover{transform:scale(1.02)}.form-back:active{transform:scale(.98)}.validation-hint{opacity:.7;margin-top:4px;font-size:12px}.form-cancel{cursor:pointer;background:#fff;border-radius:100%;padding:12px;line-height:0;position:absolute;top:0;right:0;transform:translate(50%,-50%)}.form-cancel:hover{opacity:.7;transform:translate(50%,-50%)scale(1.1)}.footer-branding{opacity:.6;justify-content:center;align-items:center;gap:4px;font-size:11px;font-weight:500;text-decoration:none;display:flex}.footer-branding:hover{opacity:1}.footer-branding a{text-decoration:none}.thank-you-message{text-align:center}.thank-you-message-header{margin:10px 0 0}.thank-you-message-body{opacity:.8;font-size:14px}.intro-screen{text-align:center;animation:.3s ease-out forwards ph-survey-fade-in}.intro-screen-header{margin:10px 0 0}.intro-screen-body{opacity:.8;font-size:14px}.limit-height{scrollbar-width:thin;scrollbar-color:var(--ph-survey-scrollbar-thumb-color) var(--ph-survey-scrollbar-track-color);max-height:256px;overflow:hidden auto}.limit-height::-webkit-scrollbar{width:8px}.limit-height::-webkit-scrollbar-track{background:var(--ph-survey-scrollbar-track-color);border-radius:4px}.limit-height::-webkit-scrollbar-thumb{background-color:var(--ph-survey-scrollbar-thumb-color);border:2px solid var(--ph-survey-scrollbar-track-color);border-radius:4px}.limit-height::-webkit-scrollbar-thumb:hover{background-color:var(--ph-survey-text-subtle-color)}.sr-only{clip:rect(0, 0, 0, 0);white-space:nowrap;border:0;width:1px;height:1px;margin:-1px;padding:0;position:absolute;overflow:hidden}@media (prefers-reduced-motion:reduce){.ph-survey *{scroll-behavior:auto!important;transition-duration:.01ms!important;animation-duration:.01ms!important;animation-iteration-count:1!important}}@keyframes ph-survey-checkmark-reveal{0%{opacity:0;transform:rotate(45deg)scale(0)}50%{opacity:1;transform:rotate(45deg)scale(1.2)}to{opacity:1;transform:rotate(45deg)scale(1)}}@keyframes ph-survey-radio-reveal{0%{opacity:0;transform:scale(0)}50%{opacity:1;transform:scale(1.3)}to{opacity:1;transform:scale(1)}}';
+export { surveyStyles };

package/dist/surveys/survey-translations.d.ts

@@ -0,0 +1,22 @@
+import type { SurveyRenderContext } from '../survey-render-context';
+import type { Survey } from '../types/surveys';
+/**
+ * Detects the user's language using priority order:
+ * 1. config.override_display_language (explicit override)
+ * 2. person properties 'language' (allows programmatic control via posthog.identify())
+ * 3. navigator.language or navigator.userLanguage (browser language)
+ *
+ * @param instance - SurveyRenderContext instance to retrieve config and person properties
+ * @returns The detected language code (e.g., 'fr', 'es', 'en-US') or null if not found
+ */
+export declare function detectUserLanguage(instance: SurveyRenderContext): string | null;
+/**
+ * Applies translations to a survey based on the user's language from person properties
+ * @param survey - The original survey object
+ * @param instance - SurveyRenderContext instance to retrieve person properties
+ * @returns An object containing the translated survey and the language used (or null if no translation applied)
+ */
+export declare function applySurveyTranslationForUser(survey: Survey, instance: SurveyRenderContext): {
+    survey: Survey;
+    language: string | null;
+};

package/dist/surveys/survey-translations.js

@@ -0,0 +1,68 @@
+"use strict";
+var __webpack_require__ = {};
+(()=>{
+    __webpack_require__.d = (exports1, getters, values)=>{
+        var define = (defs, kind)=>{
+            for(var key in defs)if (__webpack_require__.o(defs, key) && !__webpack_require__.o(exports1, key)) Object.defineProperty(exports1, key, {
+                enumerable: true,
+                [kind]: defs[key]
+            });
+        };
+        define(getters, "get");
+        define(values, "value");
+    };
+})();
+(()=>{
+    __webpack_require__.o = (obj, prop)=>Object.prototype.hasOwnProperty.call(obj, prop);
+})();
+(()=>{
+    __webpack_require__.r = (exports1)=>{
+        if ("u" > typeof Symbol && Symbol.toStringTag) Object.defineProperty(exports1, Symbol.toStringTag, {
+            value: 'Module'
+        });
+        Object.defineProperty(exports1, '__esModule', {
+            value: true
+        });
+    };
+})();
+var __webpack_exports__ = {};
+__webpack_require__.r(__webpack_exports__);
+__webpack_require__.d(__webpack_exports__, {
+    applySurveyTranslationForUser: ()=>applySurveyTranslationForUser,
+    detectUserLanguage: ()=>detectUserLanguage
+});
+const external_constants_js_namespaceObject = require("../constants.js");
+const logger_js_namespaceObject = require("../utils/logger.js");
+const surveys_namespaceObject = require("@posthog/core/surveys");
+const logger = (0, logger_js_namespaceObject.createLogger)('[SurveyTranslations]');
+function detectUserLanguage(instance) {
+    return (0, surveys_namespaceObject.detectSurveyLanguage)({
+        overrideLanguage: instance.config.overrideLanguage,
+        storedPersonProperties: instance.client?.kv.get(external_constants_js_namespaceObject.STORED_PERSON_PROPERTIES_KEY),
+        locale: "u" > typeof navigator ? navigator.language || navigator.userLanguage : void 0
+    }, logger);
+}
+function applySurveyTranslationForUser(survey, instance) {
+    const userLanguage = detectUserLanguage(instance);
+    if (!userLanguage) {
+        logger.info('No user language detected');
+        return {
+            survey,
+            language: null
+        };
+    }
+    const result = (0, surveys_namespaceObject.applySurveyTranslation)(survey, userLanguage, logger);
+    return {
+        survey: result.survey,
+        language: result.matchedKey
+    };
+}
+exports.applySurveyTranslationForUser = __webpack_exports__.applySurveyTranslationForUser;
+exports.detectUserLanguage = __webpack_exports__.detectUserLanguage;
+for(var __rspack_i in __webpack_exports__)if (-1 === [
+    "applySurveyTranslationForUser",
+    "detectUserLanguage"
+].indexOf(__rspack_i)) exports[__rspack_i] = __webpack_exports__[__rspack_i];
+Object.defineProperty(exports, '__esModule', {
+    value: true
+});

package/dist/surveys/survey-translations.mjs

@@ -0,0 +1,27 @@
+import { STORED_PERSON_PROPERTIES_KEY } from "../constants.mjs";
+import { createLogger } from "../utils/logger.mjs";
+import { applySurveyTranslation, detectSurveyLanguage } from "@posthog/core/surveys";
+const logger = createLogger('[SurveyTranslations]');
+function detectUserLanguage(instance) {
+    return detectSurveyLanguage({
+        overrideLanguage: instance.config.overrideLanguage,
+        storedPersonProperties: instance.client?.kv.get(STORED_PERSON_PROPERTIES_KEY),
+        locale: "u" > typeof navigator ? navigator.language || navigator.userLanguage : void 0
+    }, logger);
+}
+function applySurveyTranslationForUser(survey, instance) {
+    const userLanguage = detectUserLanguage(instance);
+    if (!userLanguage) {
+        logger.info('No user language detected');
+        return {
+            survey,
+            language: null
+        };
+    }
+    const result = applySurveyTranslation(survey, userLanguage, logger);
+    return {
+        survey: result.survey,
+        language: result.matchedKey
+    };
+}
+export { applySurveyTranslationForUser, detectUserLanguage };

package/dist/surveys/survey-url-prefill.d.ts

@@ -0,0 +1,36 @@
+import type { Survey } from '../types/surveys';
+/**
+ * Extracted URL prefill parameters by question index
+ */
+export interface PrefillParams {
+    [questionIndex: number]: string[];
+}
+/**
+ * Extract prefill parameters from URL search string
+ * Format: ?q0=1&q1=8&q2=0&q2=2&auto_submit=true
+ * NOTE: Manual parsing for IE11/op_mini compatibility (no URLSearchParams)
+ */
+export declare function extractPrefillParamsFromUrl(searchString: string): {
+    params: PrefillParams;
+    autoSubmit: boolean;
+};
+/**
+ * Convert URL prefill values to SDK response format
+ */
+export declare function convertPrefillToResponses(survey: Survey, prefillParams: PrefillParams): Record<string, any>;
+/**
+ * Calculate which question index to start at based on prefilled questions.
+ * Advances past consecutive prefilled questions (starting from index 0)
+ * that have skipSubmitButton enabled, respecting any branching logic configured
+ * on those questions.
+ *
+ * @param survey - The full survey object (needed for branching logic)
+ * @param prefilledIndices - Array of question indices that have been prefilled
+ * @param responses - Map of response keys to response values
+ * @returns Object with startQuestionIndex and map of questions which have been skipped
+ */
+export declare function calculatePrefillStartIndex(survey: Survey, prefilledIndices: number[], responses: Record<string, any>): {
+    startQuestionIndex: number;
+    skippedResponses: Record<string, any>;
+    skippedIndices: number[];
+};

package/dist/surveys/survey-url-prefill.js

@@ -0,0 +1,162 @@
+"use strict";
+var __webpack_require__ = {};
+(()=>{
+    __webpack_require__.d = (exports1, getters, values)=>{
+        var define = (defs, kind)=>{
+            for(var key in defs)if (__webpack_require__.o(defs, key) && !__webpack_require__.o(exports1, key)) Object.defineProperty(exports1, key, {
+                enumerable: true,
+                [kind]: defs[key]
+            });
+        };
+        define(getters, "get");
+        define(values, "value");
+    };
+})();
+(()=>{
+    __webpack_require__.o = (obj, prop)=>Object.prototype.hasOwnProperty.call(obj, prop);
+})();
+(()=>{
+    __webpack_require__.r = (exports1)=>{
+        if ("u" > typeof Symbol && Symbol.toStringTag) Object.defineProperty(exports1, Symbol.toStringTag, {
+            value: 'Module'
+        });
+        Object.defineProperty(exports1, '__esModule', {
+            value: true
+        });
+    };
+})();
+var __webpack_exports__ = {};
+__webpack_require__.r(__webpack_exports__);
+__webpack_require__.d(__webpack_exports__, {
+    calculatePrefillStartIndex: ()=>calculatePrefillStartIndex,
+    convertPrefillToResponses: ()=>convertPrefillToResponses,
+    extractPrefillParamsFromUrl: ()=>extractPrefillParamsFromUrl
+});
+const external_survey_constants_js_namespaceObject = require("../survey-constants.js");
+const external_surveys_extension_utils_js_namespaceObject = require("./surveys-extension-utils.js");
+const logger_js_namespaceObject = require("../utils/logger.js");
+const core_namespaceObject = require("@posthog/core");
+const external_survey_branching_js_namespaceObject = require("./survey-branching.js");
+function extractPrefillParamsFromUrl(searchString) {
+    const params = {};
+    let autoSubmit = false;
+    const cleanSearch = searchString.replace(/^\?/, '');
+    if (!cleanSearch) return {
+        params,
+        autoSubmit
+    };
+    const pairs = cleanSearch.split('&');
+    for (const pair of pairs){
+        const separator = pair.indexOf('=');
+        if (separator <= 0) continue;
+        let decodedKey;
+        let decodedValue;
+        try {
+            decodedKey = decodeURIComponent(pair.slice(0, separator));
+            decodedValue = decodeURIComponent(pair.slice(separator + 1));
+        } catch  {
+            continue;
+        }
+        if ('auto_submit' === decodedKey && 'true' === decodedValue) {
+            autoSubmit = true;
+            continue;
+        }
+        const match = decodedKey.match(/^q(\d+)$/);
+        if (match) {
+            const questionIndex = parseInt(match[1], 10);
+            if (!params[questionIndex]) params[questionIndex] = [];
+            params[questionIndex].push(decodedValue);
+        }
+    }
+    return {
+        params,
+        autoSubmit
+    };
+}
+function convertPrefillToResponses(survey, prefillParams) {
+    const responses = {};
+    survey.questions.forEach((question, index)=>{
+        if (!prefillParams[index] || !question.id) return;
+        const values = prefillParams[index];
+        const responseKey = (0, external_surveys_extension_utils_js_namespaceObject.getSurveyResponseKey)(question.id);
+        try {
+            switch(question.type){
+                case external_survey_constants_js_namespaceObject.SurveyQuestionType.SingleChoice:
+                    {
+                        if (!question.choices || 0 === question.choices.length) return void logger_js_namespaceObject.logger.warn(`[Survey Prefill] Question ${index} has no choices`);
+                        const choiceIndex = parseInt(values[0], 10);
+                        if (isNaN(choiceIndex) || choiceIndex < 0 || choiceIndex >= question.choices.length) return void logger_js_namespaceObject.logger.warn(`[Survey Prefill] Invalid choice index for q${index}: ${values[0]}`);
+                        responses[responseKey] = question.choices[choiceIndex];
+                        break;
+                    }
+                case external_survey_constants_js_namespaceObject.SurveyQuestionType.MultipleChoice:
+                    {
+                        if (!question.choices || 0 === question.choices.length) return void logger_js_namespaceObject.logger.warn(`[Survey Prefill] Question ${index} has no choices`);
+                        const choiceIndices = values.map((v)=>parseInt(v, 10)).filter((i)=>!isNaN(i) && i >= 0 && i < question.choices.length);
+                        if (0 === choiceIndices.length) return void logger_js_namespaceObject.logger.warn(`[Survey Prefill] No valid choices for q${index}`);
+                        const uniqueChoices = [
+                            ...new Set(choiceIndices.map((i)=>question.choices[i]))
+                        ];
+                        if (uniqueChoices.length < choiceIndices.length) logger_js_namespaceObject.logger.warn(`[Survey Prefill] Removed duplicate choices for q${index}`);
+                        responses[responseKey] = uniqueChoices;
+                        break;
+                    }
+                case external_survey_constants_js_namespaceObject.SurveyQuestionType.Rating:
+                    {
+                        const rating = parseInt(values[0], 10);
+                        const scale = question.scale || 10;
+                        if (isNaN(rating) || rating < 0 || rating > scale) return void logger_js_namespaceObject.logger.warn(`[Survey Prefill] Invalid rating for q${index}: ${values[0]} (scale: 0-${scale})`);
+                        responses[responseKey] = rating;
+                        break;
+                    }
+                default:
+                    logger_js_namespaceObject.logger.info(`[Survey Prefill] Question type ${question.type} does not support prefill`);
+            }
+        } catch (error) {
+            logger_js_namespaceObject.logger.error(`[Survey Prefill] Error converting q${index}:`, error);
+        }
+    });
+    return responses;
+}
+function calculatePrefillStartIndex(survey, prefilledIndices, responses) {
+    let currentIndex = 0;
+    const skippedResponses = {};
+    const skippedIndices = [];
+    const MAX_ITERATIONS = survey.questions.length + 1;
+    let iterations = 0;
+    while(currentIndex < survey.questions.length && iterations < MAX_ITERATIONS){
+        iterations++;
+        if (!prefilledIndices.includes(currentIndex)) break;
+        const question = survey.questions[currentIndex];
+        if (!question || !('skipSubmitButton' in question) || !question.skipSubmitButton) break;
+        if (question.id) {
+            const responseKey = (0, external_surveys_extension_utils_js_namespaceObject.getSurveyResponseKey)(question.id);
+            if (!(0, core_namespaceObject.isUndefined)(responses[responseKey])) skippedResponses[responseKey] = responses[responseKey];
+        }
+        skippedIndices.push(currentIndex);
+        const response = question.id ? responses[(0, external_surveys_extension_utils_js_namespaceObject.getSurveyResponseKey)(question.id)] : null;
+        const nextStep = (0, external_survey_branching_js_namespaceObject.getNextSurveyStep)(survey, currentIndex, response);
+        if (nextStep === external_survey_constants_js_namespaceObject.SurveyQuestionBranchingType.End) return {
+            startQuestionIndex: survey.questions.length,
+            skippedResponses,
+            skippedIndices
+        };
+        currentIndex = nextStep;
+    }
+    return {
+        startQuestionIndex: currentIndex,
+        skippedResponses,
+        skippedIndices
+    };
+}
+exports.calculatePrefillStartIndex = __webpack_exports__.calculatePrefillStartIndex;
+exports.convertPrefillToResponses = __webpack_exports__.convertPrefillToResponses;
+exports.extractPrefillParamsFromUrl = __webpack_exports__.extractPrefillParamsFromUrl;
+for(var __rspack_i in __webpack_exports__)if (-1 === [
+    "calculatePrefillStartIndex",
+    "convertPrefillToResponses",
+    "extractPrefillParamsFromUrl"
+].indexOf(__rspack_i)) exports[__rspack_i] = __webpack_exports__[__rspack_i];
+Object.defineProperty(exports, '__esModule', {
+    value: true
+});

package/dist/surveys/survey-url-prefill.mjs

@@ -0,0 +1,118 @@
+import { SurveyQuestionBranchingType, SurveyQuestionType } from "../survey-constants.mjs";
+import { getSurveyResponseKey } from "./surveys-extension-utils.mjs";
+import { logger } from "../utils/logger.mjs";
+import { isUndefined } from "@posthog/core";
+import { getNextSurveyStep } from "./survey-branching.mjs";
+function extractPrefillParamsFromUrl(searchString) {
+    const params = {};
+    let autoSubmit = false;
+    const cleanSearch = searchString.replace(/^\?/, '');
+    if (!cleanSearch) return {
+        params,
+        autoSubmit
+    };
+    const pairs = cleanSearch.split('&');
+    for (const pair of pairs){
+        const separator = pair.indexOf('=');
+        if (separator <= 0) continue;
+        let decodedKey;
+        let decodedValue;
+        try {
+            decodedKey = decodeURIComponent(pair.slice(0, separator));
+            decodedValue = decodeURIComponent(pair.slice(separator + 1));
+        } catch  {
+            continue;
+        }
+        if ('auto_submit' === decodedKey && 'true' === decodedValue) {
+            autoSubmit = true;
+            continue;
+        }
+        const match = decodedKey.match(/^q(\d+)$/);
+        if (match) {
+            const questionIndex = parseInt(match[1], 10);
+            if (!params[questionIndex]) params[questionIndex] = [];
+            params[questionIndex].push(decodedValue);
+        }
+    }
+    return {
+        params,
+        autoSubmit
+    };
+}
+function convertPrefillToResponses(survey, prefillParams) {
+    const responses = {};
+    survey.questions.forEach((question, index)=>{
+        if (!prefillParams[index] || !question.id) return;
+        const values = prefillParams[index];
+        const responseKey = getSurveyResponseKey(question.id);
+        try {
+            switch(question.type){
+                case SurveyQuestionType.SingleChoice:
+                    {
+                        if (!question.choices || 0 === question.choices.length) return void logger.warn(`[Survey Prefill] Question ${index} has no choices`);
+                        const choiceIndex = parseInt(values[0], 10);
+                        if (isNaN(choiceIndex) || choiceIndex < 0 || choiceIndex >= question.choices.length) return void logger.warn(`[Survey Prefill] Invalid choice index for q${index}: ${values[0]}`);
+                        responses[responseKey] = question.choices[choiceIndex];
+                        break;
+                    }
+                case SurveyQuestionType.MultipleChoice:
+                    {
+                        if (!question.choices || 0 === question.choices.length) return void logger.warn(`[Survey Prefill] Question ${index} has no choices`);
+                        const choiceIndices = values.map((v)=>parseInt(v, 10)).filter((i)=>!isNaN(i) && i >= 0 && i < question.choices.length);
+                        if (0 === choiceIndices.length) return void logger.warn(`[Survey Prefill] No valid choices for q${index}`);
+                        const uniqueChoices = [
+                            ...new Set(choiceIndices.map((i)=>question.choices[i]))
+                        ];
+                        if (uniqueChoices.length < choiceIndices.length) logger.warn(`[Survey Prefill] Removed duplicate choices for q${index}`);
+                        responses[responseKey] = uniqueChoices;
+                        break;
+                    }
+                case SurveyQuestionType.Rating:
+                    {
+                        const rating = parseInt(values[0], 10);
+                        const scale = question.scale || 10;
+                        if (isNaN(rating) || rating < 0 || rating > scale) return void logger.warn(`[Survey Prefill] Invalid rating for q${index}: ${values[0]} (scale: 0-${scale})`);
+                        responses[responseKey] = rating;
+                        break;
+                    }
+                default:
+                    logger.info(`[Survey Prefill] Question type ${question.type} does not support prefill`);
+            }
+        } catch (error) {
+            logger.error(`[Survey Prefill] Error converting q${index}:`, error);
+        }
+    });
+    return responses;
+}
+function calculatePrefillStartIndex(survey, prefilledIndices, responses) {
+    let currentIndex = 0;
+    const skippedResponses = {};
+    const skippedIndices = [];
+    const MAX_ITERATIONS = survey.questions.length + 1;
+    let iterations = 0;
+    while(currentIndex < survey.questions.length && iterations < MAX_ITERATIONS){
+        iterations++;
+        if (!prefilledIndices.includes(currentIndex)) break;
+        const question = survey.questions[currentIndex];
+        if (!question || !('skipSubmitButton' in question) || !question.skipSubmitButton) break;
+        if (question.id) {
+            const responseKey = getSurveyResponseKey(question.id);
+            if (!isUndefined(responses[responseKey])) skippedResponses[responseKey] = responses[responseKey];
+        }
+        skippedIndices.push(currentIndex);
+        const response = question.id ? responses[getSurveyResponseKey(question.id)] : null;
+        const nextStep = getNextSurveyStep(survey, currentIndex, response);
+        if (nextStep === SurveyQuestionBranchingType.End) return {
+            startQuestionIndex: survey.questions.length,
+            skippedResponses,
+            skippedIndices
+        };
+        currentIndex = nextStep;
+    }
+    return {
+        startQuestionIndex: currentIndex,
+        skippedResponses,
+        skippedIndices
+    };
+}
+export { calculatePrefillStartIndex, convertPrefillToResponses, extractPrefillParamsFromUrl };

package/dist/surveys/surveys-extension-utils.d.ts

@@ -0,0 +1,133 @@
+import { type VNode, type JSX } from 'preact';
+import type { SurveyRenderContext } from '../survey-render-context';
+import type { Survey, SurveyAppearance, SurveyQuestion } from '../types/surveys';
+import { SurveyPosition, SurveyType, SurveyWidgetType } from '../survey-constants';
+import { type SurveyResponses } from '@posthog/core';
+import { getSurveyResponseKey } from '@posthog/core/surveys';
+import type { Properties } from '@posthog/types';
+export declare function getFontFamily(fontFamily?: string): string;
+export { getSurveyResponseKey };
+export declare const defaultSurveyAppearance: {
+    readonly fontFamily: 'inherit';
+    readonly backgroundColor: '#eeeded';
+    readonly submitButtonColor: 'black';
+    readonly submitButtonTextColor: 'white';
+    readonly ratingButtonColor: 'white';
+    readonly ratingButtonActiveColor: 'black';
+    readonly borderColor: '#c9c6c6';
+    readonly whiteLabel: false;
+    readonly displayThankYouMessage: true;
+    readonly thankYouMessageHeader: 'Thank you for your feedback!';
+    readonly position: "right";
+    readonly widgetType: "tab";
+    readonly widgetLabel: 'Feedback';
+    readonly widgetColor: 'black';
+    readonly zIndex: string;
+    readonly disabledButtonOpacity: '0.6';
+    readonly maxWidth: '300px';
+    readonly textSubtleColor: '#939393';
+    readonly boxPadding: '20px 24px';
+    readonly boxShadow: '0 4px 12px rgba(0, 0, 0, 0.15)';
+    readonly borderRadius: '10px';
+    readonly shuffleQuestions: false;
+    readonly outlineColor: 'rgba(59, 130, 246, 0.8)';
+    readonly inputBackground: 'white';
+    readonly inputTextColor: "#020617";
+    readonly scrollbarThumbColor: 'var(--ph-survey-border-color)';
+    readonly scrollbarTrackColor: 'var(--ph-survey-background-color)';
+};
+export declare const addSurveyCSSVariablesToElement: (element: HTMLElement, type: SurveyType, appearance?: SurveyAppearance | null) => void;
+export declare function hex2rgb(c: string): string;
+export declare function hexToRgba(hex: string, opacity: number): string;
+export declare function getContrastingTextColor(color?: string): "#020617" | "white";
+export declare function getSurveyStylesheet(posthog?: SurveyRenderContext): HTMLStyleElement | null;
+export declare const retrieveSurveyShadow: (survey: Pick<Survey, 'id' | 'appearance' | 'type'>, posthog?: SurveyRenderContext, element?: Element) => {
+    shadow: ShadowRoot;
+    isNewlyCreated: boolean;
+};
+interface SendSurveyEventArgs {
+    responses: SurveyResponses;
+    survey: Survey;
+    surveySubmissionId: string;
+    isSurveyCompleted: boolean;
+    posthog?: SurveyRenderContext | undefined;
+    /** Additional properties to include in the survey event */
+    properties?: Properties | undefined;
+    /** The language that was applied to the survey. */
+    surveyLanguage?: (string | null) | undefined;
+    /** Question text as displayed to the user at answer time, keyed by question id. */
+    questionSnapshots?: Record<string, string> | undefined;
+}
+export declare const sendSurveyEvent: ({ responses, survey, surveySubmissionId, posthog, isSurveyCompleted, properties, surveyLanguage, questionSnapshots, }: SendSurveyEventArgs) => void;
+export declare const dismissedSurveyEvent: (survey: Survey, posthog?: SurveyRenderContext, readOnly?: boolean, surveyLanguage?: string | null) => void;
+export declare const sendSurveyAbandonedEvent: (survey: Survey, posthog?: SurveyRenderContext) => void;
+export { getDisplayOrderChoices, shuffle } from '@posthog/core/surveys';
+/** Question ids in the given order, or undefined when any question lacks an id to record. */
+export declare const getQuestionOrder: (questions: SurveyQuestion[]) => string[] | undefined;
+/**
+ * Branching rules hold the position of their target question in survey.questions, so a survey that
+ * uses branching is always read in the configured order. The API rejects surveys that set both
+ * shuffleQuestions and branching, so that covers rows predating the validation.
+ *
+ * A survey the respondent has already started keeps the order its persisted indices point into.
+ * Without a recorded order those indices came from a build that did not store one, and the order
+ * that produced them is unknowable, so the configured order is the only safe reading.
+ */
+export declare const getDisplayOrderQuestions: (survey: Survey, inProgressState?: InProgressSurveyState | null) => SurveyQuestion[];
+export declare const canActivateRepeatedly: (survey: Pick<Survey, 'schedule' | 'conditions' | 'id' | 'current_iteration'>) => boolean;
+/**
+ * getSurveySeen checks local storage for the surveySeen Key a
+ * and overrides this value if the survey can be repeatedly activated by its events.
+ * @param survey
+ */
+export declare const getSurveySeen: (survey: Survey) => boolean;
+export declare const hasWaitPeriodPassed: (waitPeriodInDays: number | undefined) => boolean;
+interface SurveyContextProps {
+    isPreviewMode: boolean;
+    previewPageIndex: number | undefined;
+    onPopupSurveyDismissed: () => void;
+    isPopup: boolean;
+    onPreviewSubmit: (res: string | string[] | number | null) => void;
+    onPreviewBack: () => void;
+    surveySubmissionId: string;
+    /** Additional properties to include in all survey events */
+    properties?: Properties | undefined;
+    /** The language that was applied to the survey. */
+    surveyLanguage?: (string | null) | undefined;
+}
+export declare const SurveyContext: import("preact").Context<SurveyContextProps>;
+export declare const useSurveyContext: () => SurveyContextProps;
+interface RenderProps {
+    component: VNode<{
+        className: string;
+    }>;
+    children: string;
+    renderAsHtml?: boolean | undefined;
+    style?: JSX.CSSProperties | undefined;
+}
+export declare const renderChildrenAsTextOrHtml: ({ component, children, renderAsHtml, style }: RenderProps) => VNode<{
+    className: string;
+}>;
+export declare function doesSurveyUrlMatch(survey: Pick<Survey, 'conditions'>, posthog?: SurveyRenderContext): boolean;
+export declare function doesSurveyDeviceTypesMatch(survey: Survey): boolean;
+export declare function doesSurveyMatchSelector(survey: Survey): boolean;
+interface InProgressSurveyState {
+    surveySubmissionId: string;
+    lastQuestionIndex: number;
+    questionOrder?: string[] | undefined;
+    visitedIndices?: number[] | undefined;
+    responses: SurveyResponses;
+    surveyLanguage?: (string | null) | undefined;
+    questionSnapshots?: Record<string, string> | undefined;
+}
+export declare const clearAllInMemoryInProgressSurveyState: () => void;
+export declare const setInProgressSurveyState: (survey: Pick<Survey, 'id' | 'current_iteration'>, state: InProgressSurveyState) => void;
+export declare const getInProgressSurveyState: (survey: Pick<Survey, 'id' | 'current_iteration'>) => InProgressSurveyState | null;
+export declare const isSurveyInProgress: (survey: Pick<Survey, 'id' | 'current_iteration'>) => boolean;
+export declare const clearInProgressSurveyState: (survey: Pick<Survey, 'id' | 'current_iteration'>) => void;
+export declare function getSurveyContainerClass(survey: Pick<Survey, 'id'>, asSelector?: boolean): string;
+/**
+ * Get CSS position styles for a popover/modal based on SurveyPosition
+ * Used by both surveys and product tours for consistent positioning
+ */
+export declare function getPopoverPosition(type?: SurveyType, position?: SurveyPosition, surveyWidgetType?: SurveyWidgetType): Record<string, string>;