@guidemode/types 0.1.44 → 0.1.46

package/dist/cjs/surveys.d.ts

@@ -1,5 +1,34 @@
 import { z } from 'zod';
-export type ScheduleType = 'weekly' | 'monthly' | 'triggered';
+/**
+ * A choice option for survey questions with a stable ID.
+ * The ID remains constant even if the display text is updated.
+ */
+export interface SurveyChoice {
+    /** Stable identifier (e.g., "never", "reactive", "level_1") */
+    id: string;
+    /** Display text shown to respondents */
+    text: string;
+}
+export declare const surveyChoiceSchema: z.ZodObject<{
+    id: z.ZodString;
+    text: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    id?: string;
+    text?: string;
+}, {
+    id?: string;
+    text?: string;
+}>;
+/**
+ * Get the display text for a choice value.
+ * Handles both new ID-based values (string) and legacy index-based values (number).
+ *
+ * @param choices - Array of SurveyChoice objects
+ * @param value - The response value (choice ID or legacy index)
+ * @returns The display text, or undefined if not found
+ */
+export declare function getChoiceText(choices: SurveyChoice[] | undefined, value: string | number): string | undefined;
+export type ScheduleType = 'weekly' | 'biweekly' | 'monthly' | 'triggered' | 'manual';
 export type TargetType = 'organization' | 'teams' | 'individual';
 export type SurveyStatus = 'pending' | 'completed' | 'expired';
 export interface TriggerConfig {
@@ -68,7 +97,11 @@ export declare const questionConfigSchema: z.ZodObject<{
         enabled?: boolean;
     }[];
 }>;
-export type SurveyPurpose = 'discovery' | 'delivery' | 'whole_team' | 'happiness' | 'ai_effectiveness';
+export type SurveyPurpose = 'discovery' | 'delivery' | 'whole_team' | 'happiness' | 'ai_effectiveness' | 'aiva';
+export interface SurveyInstanceMetadata {
+    /** AIVA respondent role (only set for AIVA surveys) */
+    aivaRole?: 'leadership' | 'product' | 'engineering' | 'operations';
+}
 export interface SurveySchedule {
     id: string;
     tenantId: string;
@@ -92,12 +125,12 @@ export interface SurveySchedule {
     createdAt: Date;
     updatedAt: Date;
 }
-export declare const surveyScheduleCreateSchema: z.ZodEffects<z.ZodEffects<z.ZodEffects<z.ZodObject<{
+export declare const surveyScheduleCreateSchema: z.ZodEffects<z.ZodEffects<z.ZodEffects<z.ZodEffects<z.ZodObject<{
     name: z.ZodString;
     description: z.ZodOptional<z.ZodString>;
     surveyType: z.ZodDefault<z.ZodString>;
-    purpose: z.ZodOptional<z.ZodEnum<["discovery", "delivery", "whole_team", "happiness", "ai_effectiveness"]>>;
-    scheduleType: z.ZodEnum<["weekly", "monthly", "triggered"]>;
+    purpose: z.ZodOptional<z.ZodEnum<["discovery", "delivery", "whole_team", "happiness", "ai_effectiveness", "aiva"]>>;
+    scheduleType: z.ZodEnum<["weekly", "biweekly", "monthly", "triggered", "manual"]>;
     dayOfWeek: z.ZodOptional<z.ZodNumber>;
     dayOfMonth: z.ZodOptional<z.ZodNumber>;
     timeOfDay: z.ZodOptional<z.ZodString>;
@@ -111,7 +144,7 @@ export declare const surveyScheduleCreateSchema: z.ZodEffects<z.ZodEffects<z.Zod
         type?: "session_count";
         threshold?: number;
     }>>;
-    questionConfig: z.ZodOptional<z.ZodObject<{
+    questionConfig: z.ZodOptional<z.ZodNullable<z.ZodObject<{
         version: z.ZodString;
         questions: z.ZodArray<z.ZodObject<{
             id: z.ZodString;
@@ -140,7 +173,7 @@ export declare const surveyScheduleCreateSchema: z.ZodEffects<z.ZodEffects<z.Zod
             order?: number;
             enabled?: boolean;
         }[];
-    }>>;
+    }>>>;
     randomizeQuestionOrder: z.ZodDefault<z.ZodBoolean>;
     textQuestionsAtEnd: z.ZodDefault<z.ZodBoolean>;
     targetType: z.ZodEnum<["organization", "teams", "individual"]>;
@@ -151,8 +184,8 @@ export declare const surveyScheduleCreateSchema: z.ZodEffects<z.ZodEffects<z.Zod
     name?: string;
     description?: string;
     surveyType?: string;
-    purpose?: "delivery" | "discovery" | "whole_team" | "happiness" | "ai_effectiveness";
-    scheduleType?: "weekly" | "monthly" | "triggered";
+    purpose?: "delivery" | "discovery" | "whole_team" | "happiness" | "ai_effectiveness" | "aiva";
+    scheduleType?: "manual" | "weekly" | "biweekly" | "monthly" | "triggered";
     dayOfWeek?: number;
     dayOfMonth?: number;
     timeOfDay?: string;
@@ -178,8 +211,8 @@ export declare const surveyScheduleCreateSchema: z.ZodEffects<z.ZodEffects<z.Zod
     name?: string;
     description?: string;
     surveyType?: string;
-    purpose?: "delivery" | "discovery" | "whole_team" | "happiness" | "ai_effectiveness";
-    scheduleType?: "weekly" | "monthly" | "triggered";
+    purpose?: "delivery" | "discovery" | "whole_team" | "happiness" | "ai_effectiveness" | "aiva";
+    scheduleType?: "manual" | "weekly" | "biweekly" | "monthly" | "triggered";
     dayOfWeek?: number;
     dayOfMonth?: number;
     timeOfDay?: string;
@@ -205,8 +238,8 @@ export declare const surveyScheduleCreateSchema: z.ZodEffects<z.ZodEffects<z.Zod
     name?: string;
     description?: string;
     surveyType?: string;
-    purpose?: "delivery" | "discovery" | "whole_team" | "happiness" | "ai_effectiveness";
-    scheduleType?: "weekly" | "monthly" | "triggered";
+    purpose?: "delivery" | "discovery" | "whole_team" | "happiness" | "ai_effectiveness" | "aiva";
+    scheduleType?: "manual" | "weekly" | "biweekly" | "monthly" | "triggered";
     dayOfWeek?: number;
     dayOfMonth?: number;
     timeOfDay?: string;
@@ -232,8 +265,8 @@ export declare const surveyScheduleCreateSchema: z.ZodEffects<z.ZodEffects<z.Zod
     name?: string;
     description?: string;
     surveyType?: string;
-    purpose?: "delivery" | "discovery" | "whole_team" | "happiness" | "ai_effectiveness";
-    scheduleType?: "weekly" | "monthly" | "triggered";
+    purpose?: "delivery" | "discovery" | "whole_team" | "happiness" | "ai_effectiveness" | "aiva";
+    scheduleType?: "manual" | "weekly" | "biweekly" | "monthly" | "triggered";
     dayOfWeek?: number;
     dayOfMonth?: number;
     timeOfDay?: string;
@@ -259,8 +292,8 @@ export declare const surveyScheduleCreateSchema: z.ZodEffects<z.ZodEffects<z.Zod
     name?: string;
     description?: string;
     surveyType?: string;
-    purpose?: "delivery" | "discovery" | "whole_team" | "happiness" | "ai_effectiveness";
-    scheduleType?: "weekly" | "monthly" | "triggered";
+    purpose?: "delivery" | "discovery" | "whole_team" | "happiness" | "ai_effectiveness" | "aiva";
+    scheduleType?: "manual" | "weekly" | "biweekly" | "monthly" | "triggered";
     dayOfWeek?: number;
     dayOfMonth?: number;
     timeOfDay?: string;
@@ -286,8 +319,8 @@ export declare const surveyScheduleCreateSchema: z.ZodEffects<z.ZodEffects<z.Zod
     name?: string;
     description?: string;
     surveyType?: string;
-    purpose?: "delivery" | "discovery" | "whole_team" | "happiness" | "ai_effectiveness";
-    scheduleType?: "weekly" | "monthly" | "triggered";
+    purpose?: "delivery" | "discovery" | "whole_team" | "happiness" | "ai_effectiveness" | "aiva";
+    scheduleType?: "manual" | "weekly" | "biweekly" | "monthly" | "triggered";
     dayOfWeek?: number;
     dayOfMonth?: number;
     timeOfDay?: string;
@@ -313,8 +346,8 @@ export declare const surveyScheduleCreateSchema: z.ZodEffects<z.ZodEffects<z.Zod
     name?: string;
     description?: string;
     surveyType?: string;
-    purpose?: "delivery" | "discovery" | "whole_team" | "happiness" | "ai_effectiveness";
-    scheduleType?: "weekly" | "monthly" | "triggered";
+    purpose?: "delivery" | "discovery" | "whole_team" | "happiness" | "ai_effectiveness" | "aiva";
+    scheduleType?: "manual" | "weekly" | "biweekly" | "monthly" | "triggered";
     dayOfWeek?: number;
     dayOfMonth?: number;
     timeOfDay?: string;
@@ -340,8 +373,62 @@ export declare const surveyScheduleCreateSchema: z.ZodEffects<z.ZodEffects<z.Zod
     name?: string;
     description?: string;
     surveyType?: string;
-    purpose?: "delivery" | "discovery" | "whole_team" | "happiness" | "ai_effectiveness";
-    scheduleType?: "weekly" | "monthly" | "triggered";
+    purpose?: "delivery" | "discovery" | "whole_team" | "happiness" | "ai_effectiveness" | "aiva";
+    scheduleType?: "manual" | "weekly" | "biweekly" | "monthly" | "triggered";
+    dayOfWeek?: number;
+    dayOfMonth?: number;
+    timeOfDay?: string;
+    triggerConfig?: {
+        type?: "session_count";
+        threshold?: number;
+    };
+    questionConfig?: {
+        version?: string;
+        questions?: {
+            id?: string;
+            order?: number;
+            enabled?: boolean;
+        }[];
+    };
+    randomizeQuestionOrder?: boolean;
+    textQuestionsAtEnd?: boolean;
+    targetType?: "organization" | "individual" | "teams";
+    targetUserIds?: string[];
+    targetTeamIds?: string[];
+    isActive?: boolean;
+}>, {
+    name?: string;
+    description?: string;
+    surveyType?: string;
+    purpose?: "delivery" | "discovery" | "whole_team" | "happiness" | "ai_effectiveness" | "aiva";
+    scheduleType?: "manual" | "weekly" | "biweekly" | "monthly" | "triggered";
+    dayOfWeek?: number;
+    dayOfMonth?: number;
+    timeOfDay?: string;
+    triggerConfig?: {
+        type?: "session_count";
+        threshold?: number;
+    };
+    questionConfig?: {
+        version?: string;
+        questions?: {
+            id?: string;
+            order?: number;
+            enabled?: boolean;
+        }[];
+    };
+    randomizeQuestionOrder?: boolean;
+    textQuestionsAtEnd?: boolean;
+    targetType?: "organization" | "individual" | "teams";
+    targetUserIds?: string[];
+    targetTeamIds?: string[];
+    isActive?: boolean;
+}, {
+    name?: string;
+    description?: string;
+    surveyType?: string;
+    purpose?: "delivery" | "discovery" | "whole_team" | "happiness" | "ai_effectiveness" | "aiva";
+    scheduleType?: "manual" | "weekly" | "biweekly" | "monthly" | "triggered";
     dayOfWeek?: number;
     dayOfMonth?: number;
     timeOfDay?: string;
@@ -368,8 +455,8 @@ export declare const surveyScheduleUpdateSchema: z.ZodObject<{
     name: z.ZodOptional<z.ZodString>;
     description: z.ZodOptional<z.ZodOptional<z.ZodString>>;
     surveyType: z.ZodOptional<z.ZodDefault<z.ZodString>>;
-    purpose: z.ZodOptional<z.ZodOptional<z.ZodEnum<["discovery", "delivery", "whole_team", "happiness", "ai_effectiveness"]>>>;
-    scheduleType: z.ZodOptional<z.ZodEnum<["weekly", "monthly", "triggered"]>>;
+    purpose: z.ZodOptional<z.ZodOptional<z.ZodEnum<["discovery", "delivery", "whole_team", "happiness", "ai_effectiveness", "aiva"]>>>;
+    scheduleType: z.ZodOptional<z.ZodEnum<["weekly", "biweekly", "monthly", "triggered", "manual"]>>;
     dayOfWeek: z.ZodOptional<z.ZodOptional<z.ZodNumber>>;
     dayOfMonth: z.ZodOptional<z.ZodOptional<z.ZodNumber>>;
     timeOfDay: z.ZodOptional<z.ZodOptional<z.ZodString>>;
@@ -383,7 +470,7 @@ export declare const surveyScheduleUpdateSchema: z.ZodObject<{
         type?: "session_count";
         threshold?: number;
     }>>>;
-    questionConfig: z.ZodOptional<z.ZodOptional<z.ZodObject<{
+    questionConfig: z.ZodOptional<z.ZodOptional<z.ZodNullable<z.ZodObject<{
         version: z.ZodString;
         questions: z.ZodArray<z.ZodObject<{
             id: z.ZodString;
@@ -412,7 +499,7 @@ export declare const surveyScheduleUpdateSchema: z.ZodObject<{
             order?: number;
             enabled?: boolean;
         }[];
-    }>>>;
+    }>>>>;
     randomizeQuestionOrder: z.ZodOptional<z.ZodDefault<z.ZodBoolean>>;
     textQuestionsAtEnd: z.ZodOptional<z.ZodDefault<z.ZodBoolean>>;
     targetType: z.ZodOptional<z.ZodEnum<["organization", "teams", "individual"]>>;
@@ -423,8 +510,8 @@ export declare const surveyScheduleUpdateSchema: z.ZodObject<{
     name?: string;
     description?: string;
     surveyType?: string;
-    purpose?: "delivery" | "discovery" | "whole_team" | "happiness" | "ai_effectiveness";
-    scheduleType?: "weekly" | "monthly" | "triggered";
+    purpose?: "delivery" | "discovery" | "whole_team" | "happiness" | "ai_effectiveness" | "aiva";
+    scheduleType?: "manual" | "weekly" | "biweekly" | "monthly" | "triggered";
     dayOfWeek?: number;
     dayOfMonth?: number;
     timeOfDay?: string;
@@ -450,8 +537,8 @@ export declare const surveyScheduleUpdateSchema: z.ZodObject<{
     name?: string;
     description?: string;
     surveyType?: string;
-    purpose?: "delivery" | "discovery" | "whole_team" | "happiness" | "ai_effectiveness";
-    scheduleType?: "weekly" | "monthly" | "triggered";
+    purpose?: "delivery" | "discovery" | "whole_team" | "happiness" | "ai_effectiveness" | "aiva";
+    scheduleType?: "manual" | "weekly" | "biweekly" | "monthly" | "triggered";
     dayOfWeek?: number;
     dayOfMonth?: number;
     timeOfDay?: string;
@@ -486,6 +573,7 @@ export interface SurveyInstance {
     completedAt?: Date | null;
     createdAt: Date;
     surveyResponseId?: string | null;
+    metadata?: SurveyInstanceMetadata | null;
 }
 export interface SurveyResponse {
     id: string;
@@ -515,29 +603,29 @@ export interface SurveyResponse {
 export type TeamExperienceSurveyResponse = SurveyResponse;
 export interface SurveyQuestionResponse {
     questionId: string;
-    value: string | number | null;
+    value: string | number | boolean | string[] | number[] | null;
 }
 export declare const surveyResponseSchema: z.ZodObject<{
     responses: z.ZodArray<z.ZodObject<{
         questionId: z.ZodString;
-        value: z.ZodUnion<[z.ZodString, z.ZodNumber, z.ZodNull]>;
+        value: z.ZodUnion<[z.ZodString, z.ZodNumber, z.ZodBoolean, z.ZodArray<z.ZodString, "many">, z.ZodArray<z.ZodNumber, "many">, z.ZodNull]>;
     }, "strip", z.ZodTypeAny, {
-        value?: string | number;
+        value?: string | number | boolean | string[] | number[];
         questionId?: string;
     }, {
-        value?: string | number;
+        value?: string | number | boolean | string[] | number[];
         questionId?: string;
     }>, "many">;
     durationSeconds: z.ZodOptional<z.ZodNumber>;
 }, "strip", z.ZodTypeAny, {
     responses?: {
-        value?: string | number;
+        value?: string | number | boolean | string[] | number[];
         questionId?: string;
     }[];
     durationSeconds?: number;
 }, {
     responses?: {
-        value?: string | number;
+        value?: string | number | boolean | string[] | number[];
         questionId?: string;
     }[];
     durationSeconds?: number;
@@ -551,18 +639,153 @@ export interface SurveyQuestion {
     category: QuestionCategory;
     required: boolean;
     labels?: [string, string];
-    choices?: string[];
+    choices?: SurveyChoice[];
     placeholder?: string;
     helpText?: string;
     reverseScored?: boolean;
     skipLabel?: string;
     min?: number;
     max?: number;
+    multiSelect?: boolean;
     importance?: 'low' | 'medium' | 'high';
     version?: string[];
+    roles?: ('leadership' | 'product' | 'engineering' | 'operations')[];
+    dimensionContributions?: Array<{
+        dimension: string;
+        weight: number;
+    }>;
+    aivaType?: 'scenario-choice' | 'frequency-scale' | 'evidence-checklist' | 'comparison-anchor' | 'open-feedback';
+    scoringMode?: 'highest-tier' | 'count-based' | 'cumulative';
+    frequencyMapping?: Record<string, number>;
+    itemTiers?: Record<string, number>;
 }
 export interface SurveyQuestionConfig {
     version: string;
     questions: SurveyQuestion[];
 }
+export interface QuestionOverride {
+    text?: string;
+    helpText?: string;
+    required?: boolean;
+    choices?: SurveyChoice[];
+    type?: QuestionType;
+    labels?: [string, string];
+}
+export interface QuestionOverrides {
+    version: string;
+    overrides: Record<string, QuestionOverride>;
+}
+export interface ScaleConversion {
+    from: QuestionType;
+    to: QuestionType;
+}
+/**
+ * Compatible scale type conversions.
+ * Only these conversions are allowed when overriding question types.
+ */
+export declare const COMPATIBLE_SCALE_CONVERSIONS: ScaleConversion[];
+export declare const questionTypeSchema: z.ZodEnum<["likert-7", "likert-5", "nps", "text", "choice", "number", "boolean"]>;
+export declare const questionOverrideSchema: z.ZodObject<{
+    text: z.ZodOptional<z.ZodString>;
+    helpText: z.ZodOptional<z.ZodString>;
+    required: z.ZodOptional<z.ZodBoolean>;
+    choices: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        text: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        id?: string;
+        text?: string;
+    }, {
+        id?: string;
+        text?: string;
+    }>, "many">>;
+    type: z.ZodOptional<z.ZodEnum<["likert-7", "likert-5", "nps", "text", "choice", "number", "boolean"]>>;
+    labels: z.ZodOptional<z.ZodTuple<[z.ZodString, z.ZodString], null>>;
+}, "strip", z.ZodTypeAny, {
+    required?: boolean;
+    type?: "number" | "boolean" | "text" | "likert-7" | "likert-5" | "nps" | "choice";
+    text?: string;
+    labels?: [string, string, ...unknown[]];
+    helpText?: string;
+    choices?: {
+        id?: string;
+        text?: string;
+    }[];
+}, {
+    required?: boolean;
+    type?: "number" | "boolean" | "text" | "likert-7" | "likert-5" | "nps" | "choice";
+    text?: string;
+    labels?: [string, string, ...unknown[]];
+    helpText?: string;
+    choices?: {
+        id?: string;
+        text?: string;
+    }[];
+}>;
+export declare const questionOverridesSchema: z.ZodObject<{
+    version: z.ZodString;
+    overrides: z.ZodRecord<z.ZodString, z.ZodObject<{
+        text: z.ZodOptional<z.ZodString>;
+        helpText: z.ZodOptional<z.ZodString>;
+        required: z.ZodOptional<z.ZodBoolean>;
+        choices: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            id: z.ZodString;
+            text: z.ZodString;
+        }, "strip", z.ZodTypeAny, {
+            id?: string;
+            text?: string;
+        }, {
+            id?: string;
+            text?: string;
+        }>, "many">>;
+        type: z.ZodOptional<z.ZodEnum<["likert-7", "likert-5", "nps", "text", "choice", "number", "boolean"]>>;
+        labels: z.ZodOptional<z.ZodTuple<[z.ZodString, z.ZodString], null>>;
+    }, "strip", z.ZodTypeAny, {
+        required?: boolean;
+        type?: "number" | "boolean" | "text" | "likert-7" | "likert-5" | "nps" | "choice";
+        text?: string;
+        labels?: [string, string, ...unknown[]];
+        helpText?: string;
+        choices?: {
+            id?: string;
+            text?: string;
+        }[];
+    }, {
+        required?: boolean;
+        type?: "number" | "boolean" | "text" | "likert-7" | "likert-5" | "nps" | "choice";
+        text?: string;
+        labels?: [string, string, ...unknown[]];
+        helpText?: string;
+        choices?: {
+            id?: string;
+            text?: string;
+        }[];
+    }>>;
+}, "strip", z.ZodTypeAny, {
+    version?: string;
+    overrides?: Record<string, {
+        required?: boolean;
+        type?: "number" | "boolean" | "text" | "likert-7" | "likert-5" | "nps" | "choice";
+        text?: string;
+        labels?: [string, string, ...unknown[]];
+        helpText?: string;
+        choices?: {
+            id?: string;
+            text?: string;
+        }[];
+    }>;
+}, {
+    version?: string;
+    overrides?: Record<string, {
+        required?: boolean;
+        type?: "number" | "boolean" | "text" | "likert-7" | "likert-5" | "nps" | "choice";
+        text?: string;
+        labels?: [string, string, ...unknown[]];
+        helpText?: string;
+        choices?: {
+            id?: string;
+            text?: string;
+        }[];
+    }>;
+}>;
 //# sourceMappingURL=surveys.d.ts.map

package/dist/cjs/surveys.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"surveys.d.ts","sourceRoot":"","sources":["../../src/surveys.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAGvB,MAAM,MAAM,YAAY,GAAG,QAAQ,GAAG,SAAS,GAAG,WAAW,CAAA;AAC7D,MAAM,MAAM,UAAU,GAAG,cAAc,GAAG,OAAO,GAAG,YAAY,CAAA;AAChE,MAAM,MAAM,YAAY,GAAG,SAAS,GAAG,WAAW,GAAG,SAAS,CAAA;AAG9D,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,eAAe,CAAA;IACrB,SAAS,EAAE,MAAM,CAAA;CAClB;AAED,eAAO,MAAM,mBAAmB;;;;;;;;;EAG9B,CAAA;AAGF,MAAM,WAAW,kBAAkB;IACjC,EAAE,EAAE,MAAM,CAAA;IACV,OAAO,EAAE,OAAO,CAAA;IAChB,KAAK,EAAE,MAAM,CAAA;CACd;AAED,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,MAAM,CAAA;IACf,SAAS,EAAE,kBAAkB,EAAE,CAAA;CAChC;AAED,eAAO,MAAM,wBAAwB;;;;;;;;;;;;EAInC,CAAA;AAEF,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAG/B,CAAA;AAGF,MAAM,MAAM,aAAa,GACrB,WAAW,GACX,UAAU,GACV,YAAY,GACZ,WAAW,GACX,kBAAkB,CAAA;AAGtB,MAAM,WAAW,cAAc;IAC7B,EAAE,EAAE,MAAM,CAAA;IACV,QAAQ,EAAE,MAAM,CAAA;IAChB,IAAI,EAAE,MAAM,CAAA;IACZ,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IAC3B,UAAU,EAAE,MAAM,CAAA;IAClB,OAAO,CAAC,EAAE,aAAa,GAAG,IAAI,CAAA;IAC9B,YAAY,EAAE,YAAY,CAAA;IAC1B,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IACzB,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IAC1B,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IACzB,aAAa,CAAC,EAAE,aAAa,GAAG,IAAI,CAAA;IACpC,cAAc,CAAC,EAAE,cAAc,GAAG,IAAI,CAAA;IACtC,sBAAsB,EAAE,OAAO,CAAA;IAC/B,kBAAkB,EAAE,OAAO,CAAA;IAC3B,UAAU,EAAE,UAAU,CAAA;IACtB,aAAa,CAAC,EAAE,MAAM,EAAE,GAAG,IAAI,CAAA;IAC/B,aAAa,CAAC,EAAE,MAAM,EAAE,GAAG,IAAI,CAAA;IAC/B,QAAQ,EAAE,OAAO,CAAA;IACjB,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IACzB,SAAS,EAAE,IAAI,CAAA;IACf,SAAS,EAAE,IAAI,CAAA;CAChB;AA4BD,eAAO,MAAM,0BAA0B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAuCpC,CAAA;AAGH,eAAO,MAAM,0BAA0B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAAqC,CAAA;AAG5E,MAAM,WAAW,cAAc;IAC7B,EAAE,EAAE,MAAM,CAAA;IACV,QAAQ,EAAE,MAAM,CAAA;IAChB,UAAU,EAAE,MAAM,CAAA;IAClB,MAAM,EAAE,MAAM,CAAA;IACd,MAAM,EAAE,YAAY,CAAA;IACpB,OAAO,EAAE,IAAI,CAAA;IACb,MAAM,CAAC,EAAE,IAAI,GAAG,IAAI,CAAA;IACpB,cAAc,CAAC,EAAE,IAAI,GAAG,IAAI,CAAA;IAC5B,WAAW,CAAC,EAAE,IAAI,GAAG,IAAI,CAAA;IACzB,SAAS,EAAE,IAAI,CAAA;IACf,gBAAgB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;CACjC;AAGD,MAAM,WAAW,cAAc;IAC7B,EAAE,EAAE,MAAM,CAAA;IACV,QAAQ,EAAE,MAAM,CAAA;IAChB,MAAM,EAAE,MAAM,CAAA;IACd,gBAAgB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IAChC,UAAU,EAAE,MAAM,CAAA;IAClB,eAAe,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IAC/B,WAAW,EAAE,IAAI,CAAA;IACjB,SAAS,EAAE,IAAI,CAAA;IAGf,eAAe,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IAC/B,aAAa,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IAC7B,eAAe,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IAC/B,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IACxB,oBAAoB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IACpC,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IAC5B,gBAAgB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IAChC,qBAAqB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IAGrC,mBAAmB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IACnC,eAAe,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IAC/B,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IAC5B,iBAAiB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IACjC,cAAc,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IAC9B,eAAe,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IAC/B,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;CAC7B;AAGD,MAAM,MAAM,4BAA4B,GAAG,cAAc,CAAA;AAGzD,MAAM,WAAW,sBAAsB;IACrC,UAAU,EAAE,MAAM,CAAA;IAClB,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAAA;CAC9B;AAED,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;;;;;;;;;;;EAQ/B,CAAA;AAGF,MAAM,MAAM,YAAY,GACpB,UAAU,GACV,UAAU,GACV,KAAK,GACL,MAAM,GACN,QAAQ,GACR,QAAQ,GACR,SAAS,CAAA;AACb,MAAM,MAAM,gBAAgB,GACxB,cAAc,GACd,cAAc,GACd,UAAU,GACV,eAAe,GACf,UAAU,GACV,WAAW,GACX,UAAU,GACV,wBAAwB,GACxB,oBAAoB,GACpB,yBAAyB,GACzB,sBAAsB,GACtB,sBAAsB,GACtB,qBAAqB,GACrB,wBAAwB,GACxB,mBAAmB,CAAA;AAEvB,MAAM,WAAW,cAAc;IAC7B,EAAE,EAAE,MAAM,CAAA;IACV,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,EAAE,YAAY,CAAA;IAClB,QAAQ,EAAE,gBAAgB,CAAA;IAC1B,QAAQ,EAAE,OAAO,CAAA;IACjB,MAAM,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IACzB,OAAO,CAAC,EAAE,MAAM,EAAE,CAAA;IAClB,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,aAAa,CAAC,EAAE,OAAO,CAAA;IACvB,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,GAAG,CAAC,EAAE,MAAM,CAAA;IACZ,GAAG,CAAC,EAAE,MAAM,CAAA;IAEZ,UAAU,CAAC,EAAE,KAAK,GAAG,QAAQ,GAAG,MAAM,CAAA;IACtC,OAAO,CAAC,EAAE,MAAM,EAAE,CAAA;CACnB;AAED,MAAM,WAAW,oBAAoB;IACnC,OAAO,EAAE,MAAM,CAAA;IACf,SAAS,EAAE,cAAc,EAAE,CAAA;CAC5B"}
+{"version":3,"file":"surveys.d.ts","sourceRoot":"","sources":["../../src/surveys.ts"],"names":[],"mappings":"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"}

package/dist/cjs/surveys.js

@@ -1,7 +1,33 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.surveyResponseSchema = exports.surveyScheduleUpdateSchema = exports.surveyScheduleCreateSchema = exports.questionConfigSchema = exports.questionConfigItemSchema = exports.triggerConfigSchema = void 0;
+exports.questionOverridesSchema = exports.questionOverrideSchema = exports.questionTypeSchema = exports.COMPATIBLE_SCALE_CONVERSIONS = exports.surveyResponseSchema = exports.surveyScheduleUpdateSchema = exports.surveyScheduleCreateSchema = exports.questionConfigSchema = exports.questionConfigItemSchema = exports.triggerConfigSchema = exports.surveyChoiceSchema = void 0;
+exports.getChoiceText = getChoiceText;
 const zod_1 = require("zod");
+exports.surveyChoiceSchema = zod_1.z.object({
+    id: zod_1.z.string(),
+    text: zod_1.z.string(),
+});
+/**
+ * Get the display text for a choice value.
+ * Handles both new ID-based values (string) and legacy index-based values (number).
+ *
+ * @param choices - Array of SurveyChoice objects
+ * @param value - The response value (choice ID or legacy index)
+ * @returns The display text, or undefined if not found
+ */
+function getChoiceText(choices, value) {
+    if (!choices || choices.length === 0)
+        return undefined;
+    // New format: ID lookup (string value)
+    if (typeof value === 'string') {
+        return choices.find(c => c.id === value)?.text;
+    }
+    // Legacy format: Index lookup (for historical data display only)
+    if (typeof value === 'number' && value >= 0 && value < choices.length) {
+        return choices[value]?.text;
+    }
+    return undefined;
+}
 exports.triggerConfigSchema = zod_1.z.object({
     type: zod_1.z.literal('session_count'),
     threshold: zod_1.z.number().int().positive(),
@@ -21,9 +47,9 @@ const surveyScheduleBaseSchema = zod_1.z.object({
     description: zod_1.z.string().optional(),
     surveyType: zod_1.z.string().default('team_experience'),
     purpose: zod_1.z
-        .enum(['discovery', 'delivery', 'whole_team', 'happiness', 'ai_effectiveness'])
+        .enum(['discovery', 'delivery', 'whole_team', 'happiness', 'ai_effectiveness', 'aiva'])
         .optional(),
-    scheduleType: zod_1.z.enum(['weekly', 'monthly', 'triggered']),
+    scheduleType: zod_1.z.enum(['weekly', 'biweekly', 'monthly', 'triggered', 'manual']),
     dayOfWeek: zod_1.z.number().int().min(0).max(6).optional(), // 0=Sunday, 6=Saturday
     dayOfMonth: zod_1.z.number().int().min(1).max(31).optional(), // Business day 1-31
     timeOfDay: zod_1.z
@@ -31,7 +57,7 @@ const surveyScheduleBaseSchema = zod_1.z.object({
         .regex(/^([0-1][0-9]|2[0-3]):[0-5][0-9]$/)
         .optional(), // HH:MM 24-hour
     triggerConfig: exports.triggerConfigSchema.optional(),
-    questionConfig: exports.questionConfigSchema.optional(),
+    questionConfig: exports.questionConfigSchema.nullable().optional(),
     randomizeQuestionOrder: zod_1.z.boolean().default(true),
     textQuestionsAtEnd: zod_1.z.boolean().default(true),
     targetType: zod_1.z.enum(['organization', 'teams', 'individual']),
@@ -50,6 +76,16 @@ exports.surveyScheduleCreateSchema = surveyScheduleBaseSchema
 }, {
     message: 'Weekly schedules require dayOfWeek and timeOfDay',
     path: ['dayOfWeek'],
+})
+    .refine(data => {
+    // Biweekly schedules must have dayOfWeek and timeOfDay
+    if (data.scheduleType === 'biweekly') {
+        return data.dayOfWeek !== undefined && data.timeOfDay !== undefined;
+    }
+    return true;
+}, {
+    message: 'Biweekly schedules require dayOfWeek and timeOfDay',
+    path: ['dayOfWeek'],
 })
     .refine(data => {
     // Monthly schedules must have dayOfMonth and timeOfDay
@@ -76,8 +112,52 @@ exports.surveyScheduleUpdateSchema = surveyScheduleBaseSchema.partial();
 exports.surveyResponseSchema = zod_1.z.object({
     responses: zod_1.z.array(zod_1.z.object({
         questionId: zod_1.z.string(),
-        value: zod_1.z.union([zod_1.z.string(), zod_1.z.number(), zod_1.z.null()]),
+        value: zod_1.z.union([
+            zod_1.z.string(),
+            zod_1.z.number(),
+            zod_1.z.boolean(),
+            zod_1.z.array(zod_1.z.string()),
+            zod_1.z.array(zod_1.z.number()),
+            zod_1.z.null(),
+        ]),
     })),
     durationSeconds: zod_1.z.number().optional(),
 });
+/**
+ * Compatible scale type conversions.
+ * Only these conversions are allowed when overriding question types.
+ */
+exports.COMPATIBLE_SCALE_CONVERSIONS = [
+    { from: 'likert-7', to: 'likert-5' },
+    { from: 'likert-5', to: 'likert-7' },
+    { from: 'likert-7', to: 'nps' },
+    { from: 'likert-5', to: 'nps' },
+    { from: 'nps', to: 'likert-7' },
+    { from: 'nps', to: 'likert-5' },
+    { from: 'number', to: 'likert-5' },
+    { from: 'number', to: 'likert-7' },
+    { from: 'likert-5', to: 'number' },
+    { from: 'likert-7', to: 'number' },
+];
+exports.questionTypeSchema = zod_1.z.enum([
+    'likert-7',
+    'likert-5',
+    'nps',
+    'text',
+    'choice',
+    'number',
+    'boolean',
+]);
+exports.questionOverrideSchema = zod_1.z.object({
+    text: zod_1.z.string().optional(),
+    helpText: zod_1.z.string().optional(),
+    required: zod_1.z.boolean().optional(),
+    choices: zod_1.z.array(exports.surveyChoiceSchema).optional(),
+    type: exports.questionTypeSchema.optional(),
+    labels: zod_1.z.tuple([zod_1.z.string(), zod_1.z.string()]).optional(),
+});
+exports.questionOverridesSchema = zod_1.z.object({
+    version: zod_1.z.string(),
+    overrides: zod_1.z.record(zod_1.z.string(), exports.questionOverrideSchema),
+});
 //# sourceMappingURL=surveys.js.map

package/dist/cjs/surveys.js.map

@@ -1 +1 @@
-{"version":3,"file":"surveys.js","sourceRoot":"","sources":["../../src/surveys.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"surveys.js","sourceRoot":"","sources":["../../src/surveys.ts"],"names":[],"mappings":";;;AA8BA,sCAiBC;AA/CD,6BAAuB;AAiBV,QAAA,kBAAkB,GAAG,OAAC,CAAC,MAAM,CAAC;IACzC,EAAE,EAAE,OAAC,CAAC,MAAM,EAAE;IACd,IAAI,EAAE,OAAC,CAAC,MAAM,EAAE;CACjB,CAAC,CAAA;AAEF;;;;;;;GAOG;AACH,SAAgB,aAAa,CAC3B,OAAmC,EACnC,KAAsB;IAEtB,IAAI,CAAC,OAAO,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,SAAS,CAAA;IAEtD,uCAAuC;IACvC,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAC9B,OAAO,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,KAAK,CAAC,EAAE,IAAI,CAAA;IAChD,CAAC;IAED,iEAAiE;IACjE,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,IAAI,CAAC,IAAI,KAAK,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;QACtE,OAAO,OAAO,CAAC,KAAK,CAAC,EAAE,IAAI,CAAA;IAC7B,CAAC;IAED,OAAO,SAAS,CAAA;AAClB,CAAC;AAaY,QAAA,mBAAmB,GAAG,OAAC,CAAC,MAAM,CAAC;IAC1C,IAAI,EAAE,OAAC,CAAC,OAAO,CAAC,eAAe,CAAC;IAChC,SAAS,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE;CACvC,CAAC,CAAA;AAcW,QAAA,wBAAwB,GAAG,OAAC,CAAC,MAAM,CAAC;IAC/C,EAAE,EAAE,OAAC,CAAC,MAAM,EAAE;IACd,OAAO,EAAE,OAAC,CAAC,OAAO,EAAE;IACpB,KAAK,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;CAC/B,CAAC,CAAA;AAEW,QAAA,oBAAoB,GAAG,OAAC,CAAC,MAAM,CAAC;IAC3C,OAAO,EAAE,OAAC,CAAC,MAAM,EAAE;IACnB,SAAS,EAAE,OAAC,CAAC,KAAK,CAAC,gCAAwB,CAAC;CAC7C,CAAC,CAAA;AA0CF,kCAAkC;AAClC,MAAM,wBAAwB,GAAG,OAAC,CAAC,MAAM,CAAC;IACxC,IAAI,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC;IAChC,WAAW,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAClC,UAAU,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,OAAO,CAAC,iBAAiB,CAAC;IACjD,OAAO,EAAE,OAAC;SACP,IAAI,CAAC,CAAC,WAAW,EAAE,UAAU,EAAE,YAAY,EAAE,WAAW,EAAE,kBAAkB,EAAE,MAAM,CAAC,CAAC;SACtF,QAAQ,EAAE;IACb,YAAY,EAAE,OAAC,CAAC,IAAI,CAAC,CAAC,QAAQ,EAAE,UAAU,EAAE,SAAS,EAAE,WAAW,EAAE,QAAQ,CAAC,CAAC;IAC9E,SAAS,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE,EAAE,uBAAuB;IAC7E,UAAU,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,QAAQ,EAAE,EAAE,oBAAoB;IAC5E,SAAS,EAAE,OAAC;SACT,MAAM,EAAE;SACR,KAAK,CAAC,kCAAkC,CAAC;SACzC,QAAQ,EAAE,EAAE,gBAAgB;IAC/B,aAAa,EAAE,2BAAmB,CAAC,QAAQ,EAAE;IAC7C,cAAc,EAAE,4BAAoB,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE;IAC1D,sBAAsB,EAAE,OAAC,CAAC,OAAO,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC;IACjD,kBAAkB,EAAE,OAAC,CAAC,OAAO,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC;IAC7C,UAAU,EAAE,OAAC,CAAC,IAAI,CAAC,CAAC,cAAc,EAAE,OAAO,EAAE,YAAY,CAAC,CAAC;IAC3D,aAAa,EAAE,OAAC,CAAC,KAAK,CAAC,OAAC,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,CAAC,CAAC,QAAQ,EAAE;IACpD,aAAa,EAAE,OAAC,CAAC,KAAK,CAAC,OAAC,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,CAAC,CAAC,QAAQ,EAAE;IACpD,QAAQ,EAAE,OAAC,CAAC,OAAO,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC;CACpC,CAAC,CAAA;AAEF,iCAAiC;AACpB,QAAA,0BAA0B,GAAG,wBAAwB;KAC/D,MAAM,CACL,IAAI,CAAC,EAAE;IACL,qDAAqD;IACrD,IAAI,IAAI,CAAC,YAAY,KAAK,QAAQ,EAAE,CAAC;QACnC,OAAO,IAAI,CAAC,SAAS,KAAK,SAAS,IAAI,IAAI,CAAC,SAAS,KAAK,SAAS,CAAA;IACrE,CAAC;IACD,OAAO,IAAI,CAAA;AACb,CAAC,EACD;IACE,OAAO,EAAE,kDAAkD;IAC3D,IAAI,EAAE,CAAC,WAAW,CAAC;CACpB,CACF;KACA,MAAM,CACL,IAAI,CAAC,EAAE;IACL,uDAAuD;IACvD,IAAI,IAAI,CAAC,YAAY,KAAK,UAAU,EAAE,CAAC;QACrC,OAAO,IAAI,CAAC,SAAS,KAAK,SAAS,IAAI,IAAI,CAAC,SAAS,KAAK,SAAS,CAAA;IACrE,CAAC;IACD,OAAO,IAAI,CAAA;AACb,CAAC,EACD;IACE,OAAO,EAAE,oDAAoD;IAC7D,IAAI,EAAE,CAAC,WAAW,CAAC;CACpB,CACF;KACA,MAAM,CACL,IAAI,CAAC,EAAE;IACL,uDAAuD;IACvD,IAAI,IAAI,CAAC,YAAY,KAAK,SAAS,EAAE,CAAC;QACpC,OAAO,IAAI,CAAC,UAAU,KAAK,SAAS,IAAI,IAAI,CAAC,SAAS,KAAK,SAAS,CAAA;IACtE,CAAC;IACD,OAAO,IAAI,CAAA;AACb,CAAC,EACD;IACE,OAAO,EAAE,oDAAoD;IAC7D,IAAI,EAAE,CAAC,YAAY,CAAC;CACrB,CACF;KACA,MAAM,CACL,IAAI,CAAC,EAAE;IACL,sEAAsE;IACtE,IAAI,CAAC,IAAI,CAAC,sBAAsB,IAAI,IAAI,CAAC,kBAAkB,EAAE,CAAC;QAC5D,OAAO,KAAK,CAAA;IACd,CAAC;IACD,OAAO,IAAI,CAAA;AACb,CAAC,EACD;IACE,OAAO,EAAE,yEAAyE;IAClF,IAAI,EAAE,CAAC,oBAAoB,CAAC;CAC7B,CACF,CAAA;AAEH,8DAA8D;AACjD,QAAA,0BAA0B,GAAG,wBAAwB,CAAC,OAAO,EAAE,CAAA;AA0D/D,QAAA,oBAAoB,GAAG,OAAC,CAAC,MAAM,CAAC;IAC3C,SAAS,EAAE,OAAC,CAAC,KAAK,CAChB,OAAC,CAAC,MAAM,CAAC;QACP,UAAU,EAAE,OAAC,CAAC,MAAM,EAAE;QACtB,KAAK,EAAE,OAAC,CAAC,KAAK,CAAC;YACb,OAAC,CAAC,MAAM,EAAE;YACV,OAAC,CAAC,MAAM,EAAE;YACV,OAAC,CAAC,OAAO,EAAE;YACX,OAAC,CAAC,KAAK,CAAC,OAAC,CAAC,MAAM,EAAE,CAAC;YACnB,OAAC,CAAC,KAAK,CAAC,OAAC,CAAC,MAAM,EAAE,CAAC;YACnB,OAAC,CAAC,IAAI,EAAE;SACT,CAAC;KACH,CAAC,CACH;IACD,eAAe,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;CACvC,CAAC,CAAA;AAoFF;;;GAGG;AACU,QAAA,4BAA4B,GAAsB;IAC7D,EAAE,IAAI,EAAE,UAAU,EAAE,EAAE,EAAE,UAAU,EAAE;IACpC,EAAE,IAAI,EAAE,UAAU,EAAE,EAAE,EAAE,UAAU,EAAE;IACpC,EAAE,IAAI,EAAE,UAAU,EAAE,EAAE,EAAE,KAAK,EAAE;IAC/B,EAAE,IAAI,EAAE,UAAU,EAAE,EAAE,EAAE,KAAK,EAAE;IAC/B,EAAE,IAAI,EAAE,KAAK,EAAE,EAAE,EAAE,UAAU,EAAE;IAC/B,EAAE,IAAI,EAAE,KAAK,EAAE,EAAE,EAAE,UAAU,EAAE;IAC/B,EAAE,IAAI,EAAE,QAAQ,EAAE,EAAE,EAAE,UAAU,EAAE;IAClC,EAAE,IAAI,EAAE,QAAQ,EAAE,EAAE,EAAE,UAAU,EAAE;IAClC,EAAE,IAAI,EAAE,UAAU,EAAE,EAAE,EAAE,QAAQ,EAAE;IAClC,EAAE,IAAI,EAAE,UAAU,EAAE,EAAE,EAAE,QAAQ,EAAE;CACnC,CAAA;AAEY,QAAA,kBAAkB,GAAG,OAAC,CAAC,IAAI,CAAC;IACvC,UAAU;IACV,UAAU;IACV,KAAK;IACL,MAAM;IACN,QAAQ;IACR,QAAQ;IACR,SAAS;CACV,CAAC,CAAA;AAEW,QAAA,sBAAsB,GAAG,OAAC,CAAC,MAAM,CAAC;IAC7C,IAAI,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC3B,QAAQ,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC/B,QAAQ,EAAE,OAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE;IAChC,OAAO,EAAE,OAAC,CAAC,KAAK,CAAC,0BAAkB,CAAC,CAAC,QAAQ,EAAE;IAC/C,IAAI,EAAE,0BAAkB,CAAC,QAAQ,EAAE;IACnC,MAAM,EAAE,OAAC,CAAC,KAAK,CAAC,CAAC,OAAC,CAAC,MAAM,EAAE,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,QAAQ,EAAE;CACrD,CAAC,CAAA;AAEW,QAAA,uBAAuB,GAAG,OAAC,CAAC,MAAM,CAAC;IAC9C,OAAO,EAAE,OAAC,CAAC,MAAM,EAAE;IACnB,SAAS,EAAE,OAAC,CAAC,MAAM,CAAC,OAAC,CAAC,MAAM,EAAE,EAAE,8BAAsB,CAAC;CACxD,CAAC,CAAA"}