cbrowser 16.10.0 → 16.14.0

package/dist/persona-questionnaire.d.ts

@@ -44,7 +44,8 @@ export declare function generatePersonaQuestionnaire(options?: {
 }): QuestionnaireQuestion[];
 /**
  * Build cognitive traits from questionnaire answers.
- * Missing answers default to 0.5 (neutral baseline).
+ * v16.11.0: Research-based defaults instead of flat 0.5 neutral.
+ * Missing answers use "typical adult internet user" baseline from research.
  */
 export declare function buildTraitsFromAnswers(answers: Record<string, number>): CognitiveTraits;
 /**
@@ -52,6 +53,7 @@ export declare function buildTraitsFromAnswers(answers: Record<string, number>):
  * When one trait is set, related traits should adjust unless explicitly set.
  * v16.7.2: Added precision rounding to avoid floating-point artifacts.
  * v16.7.2: Exported for use in createCognitivePersona.
+ * v16.11.0: Updated to use research-based baseline checks
  */
 export declare function applyTraitCorrelations(traits: CognitiveTraits): void;
 /**
@@ -78,4 +80,143 @@ export declare function formatForAskUserQuestion(questions: QuestionnaireQuestio
     }>;
     multiSelect: boolean;
 }>;
+/**
+ * Persona categories with different value assignment strategies.
+ *
+ * Research-grounded approach:
+ * - COGNITIVE: Disabilities affecting brain function → specific values based on neuroscience
+ * - PHYSICAL: Motor/mobility impairments → security/autonomy shifts
+ * - SENSORY: Perception-only differences → neutral values (doesn't change motivation)
+ * - EMOTIONAL: Trait anxiety/confidence → specific values based on psychology
+ * - GENERAL: No disability → research-based population defaults
+ */
+export type PersonaCategory = "cognitive" | "physical" | "sensory" | "emotional" | "general";
+/**
+ * Category-specific value presets with research citations.
+ */
+export interface CategoryValuePreset {
+    category: PersonaCategory;
+    description: string;
+    valueStrategy: "specific" | "security_autonomy_shift" | "neutral" | "trait_based";
+    researchBasis: string[];
+    defaultValues: {
+        selfDirection?: number;
+        stimulation?: number;
+        hedonism?: number;
+        achievement?: number;
+        power?: number;
+        security?: number;
+        conformity?: number;
+        tradition?: number;
+        benevolence?: number;
+        universalism?: number;
+        autonomyNeed?: number;
+        competenceNeed?: number;
+        relatednessNeed?: number;
+        maslowLevel?: "physiological" | "safety" | "belonging" | "esteem" | "self-actualization";
+    };
+    guidance: string;
+}
+/**
+ * Research-grounded value presets for each category.
+ */
+export declare const CATEGORY_VALUE_PRESETS: CategoryValuePreset[];
+/**
+ * Detect persona category from name and description.
+ * Returns the most specific matching category.
+ */
+export declare function detectPersonaCategory(name: string, description?: string): PersonaCategory;
+/**
+ * Get the value preset for a category.
+ */
+export declare function getCategoryValuePreset(category: PersonaCategory): CategoryValuePreset;
+/**
+ * Build persona values based on category with research grounding.
+ * Returns values, research citations, and guidance.
+ *
+ * v16.14.0: For trait_based categories (general, emotional), can derive values from traits.
+ */
+export declare function buildValuesFromCategory(category: PersonaCategory, overrides?: Partial<CategoryValuePreset["defaultValues"]>, traits?: Partial<CognitiveTraits> | Record<string, number>): {
+    values: CategoryValuePreset["defaultValues"];
+    researchBasis: string[];
+    guidance: string;
+    valueStrategy: CategoryValuePreset["valueStrategy"];
+    derivations?: Array<{
+        trait: string;
+        affectedValue: string;
+        contribution: number;
+    }>;
+};
+/**
+ * ADHD-specific value adjustments based on subtype.
+ * More granular than the general cognitive preset.
+ */
+export declare const COGNITIVE_SUBTYPES: Record<string, {
+    values: Partial<CategoryValuePreset["defaultValues"]>;
+    researchBasis: string;
+}>;
+/**
+ * Get cognitive subtype-specific values if available.
+ */
+export declare function getCognitiveSubtypeValues(subtypeName: string): {
+    values: Partial<CategoryValuePreset["defaultValues"]>;
+    researchBasis: string;
+} | undefined;
+/**
+ * Trait-to-Value Correlations (v16.14.0)
+ *
+ * Research-backed mappings from cognitive traits to Schwartz values.
+ * Used for general-category personas to derive meaningful values from traits.
+ *
+ * @references
+ * - Kashdan, T.B., et al. (2018). The five-dimensional curiosity scale. JPSP.
+ * - Schwartz, S.H. (2012). An overview of the Schwartz theory of basic values.
+ * - Duckworth, A.L. (2016). Grit: The power of passion and perseverance.
+ * - Bandura, A. (1997). Self-efficacy: The exercise of control.
+ * - Cialdini, R.B. (2001). Influence: Science and practice.
+ */
+export declare const TRAIT_VALUE_CORRELATIONS: Record<string, {
+    affects: Array<{
+        value: string;
+        direction: "positive" | "negative";
+        weight: number;
+    }>;
+    researchBasis: string;
+}>;
+/**
+ * Derive Schwartz values from cognitive traits. (v16.14.0)
+ *
+ * For general-category personas, values should reflect their cognitive profile.
+ * Uses weighted correlations from psychological research.
+ *
+ * @param traits - Cognitive traits (0-1 scale)
+ * @returns Derived values with research basis
+ */
+export declare function deriveValuesFromTraits(traits: Partial<CognitiveTraits> | Record<string, number>): {
+    values: Partial<CategoryValuePreset["defaultValues"]>;
+    derivations: Array<{
+        trait: string;
+        affectedValue: string;
+        contribution: number;
+    }>;
+    researchBasis: string[];
+};
+/**
+ * Validate that category-appropriate values are being assigned.
+ * Returns warnings if values violate category guidelines.
+ */
+export declare function validateCategoryValues(category: PersonaCategory, values: Partial<CategoryValuePreset["defaultValues"]>): string[];
+/**
+ * Category question for the persona questionnaire.
+ * Ask this first to determine appropriate value guidance.
+ */
+export declare const CATEGORY_QUESTION: {
+    question: string;
+    header: string;
+    options: Array<{
+        label: string;
+        description: string;
+        category: PersonaCategory;
+    }>;
+};
 //# sourceMappingURL=persona-questionnaire.d.ts.map

package/dist/persona-questionnaire.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"persona-questionnaire.d.ts","sourceRoot":"","sources":["../src/persona-questionnaire.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAOlD,MAAM,WAAW,UAAU;IACzB,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,eAAe,CAAC;IAC5B,WAAW,EAAE,MAAM,CAAC;IACpB,aAAa,EAAE,MAAM,CAAC;IACtB,MAAM,EAAE,UAAU,EAAE,CAAC;CACtB;AAED;;;GAGG;AACH,eAAO,MAAM,sBAAsB,EAAE,cAAc,EAk5ClD,CAAC;AAMF,MAAM,WAAW,qBAAqB;IACpC,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,eAAe,CAAC;IAC7B,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,KAAK,CAAC;QACb,KAAK,EAAE,MAAM,CAAC;QACd,KAAK,EAAE,MAAM,CAAC;QACd,WAAW,EAAE,MAAM,CAAC;KACrB,CAAC,CAAC;CACJ;AAED;;;GAGG;AACH,wBAAgB,4BAA4B,CAAC,OAAO,CAAC,EAAE;IACrD,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,MAAM,CAAC,EAAE,CAAC,MAAM,eAAe,CAAC,EAAE,CAAC;CACpC,GAAG,qBAAqB,EAAE,CA0C1B;AAkCD;;;GAGG;AACH,wBAAgB,sBAAsB,CACpC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAC9B,eAAe,CAwCjB;AAUD;;;;;GAKG;AACH,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,eAAe,GAAG,IAAI,CA8BpE;AAMD;;GAEG;AACH,wBAAgB,iBAAiB,CAC/B,KAAK,EAAE,MAAM,eAAe,EAC5B,KAAK,EAAE,MAAM,GACZ,MAAM,EAAE,CAUV;AAED;;GAEG;AACH,wBAAgB,aAAa,CAC3B,KAAK,EAAE,MAAM,eAAe,EAC5B,KAAK,EAAE,MAAM,GACZ,MAAM,CASR;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,MAAM,eAAe,GAAG,cAAc,GAAG,SAAS,CAE1F;AA+CD;;GAEG;AACH,wBAAgB,wBAAwB,CAAC,SAAS,EAAE,qBAAqB,EAAE,GAAG,KAAK,CAAC;IAClF,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,KAAK,CAAC;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACvD,WAAW,EAAE,OAAO,CAAC;CACtB,CAAC,CAUD"}
+{"version":3,"file":"persona-questionnaire.d.ts","sourceRoot":"","sources":["../src/persona-questionnaire.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAOlD,MAAM,WAAW,UAAU;IACzB,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,eAAe,CAAC;IAC5B,WAAW,EAAE,MAAM,CAAC;IACpB,aAAa,EAAE,MAAM,CAAC;IACtB,MAAM,EAAE,UAAU,EAAE,CAAC;CACtB;AAED;;;GAGG;AACH,eAAO,MAAM,sBAAsB,EAAE,cAAc,EAk5ClD,CAAC;AAMF,MAAM,WAAW,qBAAqB;IACpC,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,eAAe,CAAC;IAC7B,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,KAAK,CAAC;QACb,KAAK,EAAE,MAAM,CAAC;QACd,KAAK,EAAE,MAAM,CAAC;QACd,WAAW,EAAE,MAAM,CAAC;KACrB,CAAC,CAAC;CACJ;AAED;;;GAGG;AACH,wBAAgB,4BAA4B,CAAC,OAAO,CAAC,EAAE;IACrD,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,MAAM,CAAC,EAAE,CAAC,MAAM,eAAe,CAAC,EAAE,CAAC;CACpC,GAAG,qBAAqB,EAAE,CA0C1B;AAkCD;;;;GAIG;AACH,wBAAgB,sBAAsB,CACpC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAC9B,eAAe,CAuDjB;AA+CD;;;;;;GAMG;AACH,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,eAAe,GAAG,IAAI,CA8BpE;AAMD;;GAEG;AACH,wBAAgB,iBAAiB,CAC/B,KAAK,EAAE,MAAM,eAAe,EAC5B,KAAK,EAAE,MAAM,GACZ,MAAM,EAAE,CAUV;AAED;;GAEG;AACH,wBAAgB,aAAa,CAC3B,KAAK,EAAE,MAAM,eAAe,EAC5B,KAAK,EAAE,MAAM,GACZ,MAAM,CASR;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,MAAM,eAAe,GAAG,cAAc,GAAG,SAAS,CAE1F;AA+CD;;GAEG;AACH,wBAAgB,wBAAwB,CAAC,SAAS,EAAE,qBAAqB,EAAE,GAAG,KAAK,CAAC;IAClF,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,KAAK,CAAC;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACvD,WAAW,EAAE,OAAO,CAAC;CACtB,CAAC,CAUD;AAOD;;;;;;;;;GASG;AACH,MAAM,MAAM,eAAe,GACvB,WAAW,GACX,UAAU,GACV,SAAS,GACT,WAAW,GACX,SAAS,CAAC;AAEd;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,QAAQ,EAAE,eAAe,CAAC;IAC1B,WAAW,EAAE,MAAM,CAAC;IACpB,aAAa,EAAE,UAAU,GAAG,yBAAyB,GAAG,SAAS,GAAG,aAAa,CAAC;IAClF,aAAa,EAAE,MAAM,EAAE,CAAC;IACxB,aAAa,EAAE;QAEb,aAAa,CAAC,EAAE,MAAM,CAAC;QACvB,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,YAAY,CAAC,EAAE,MAAM,CAAC;QAEtB,YAAY,CAAC,EAAE,MAAM,CAAC;QACtB,cAAc,CAAC,EAAE,MAAM,CAAC;QACxB,eAAe,CAAC,EAAE,MAAM,CAAC;QAEzB,WAAW,CAAC,EAAE,eAAe,GAAG,QAAQ,GAAG,WAAW,GAAG,QAAQ,GAAG,oBAAoB,CAAC;KAC1F,CAAC;IACF,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED;;GAEG;AACH,eAAO,MAAM,sBAAsB,EAAE,mBAAmB,EAgHvD,CAAC;AA6BF;;;GAGG;AACH,wBAAgB,qBAAqB,CACnC,IAAI,EAAE,MAAM,EACZ,WAAW,CAAC,EAAE,MAAM,GACnB,eAAe,CAcjB;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,QAAQ,EAAE,eAAe,GAAG,mBAAmB,CAGrF;AAED;;;;;GAKG;AACH,wBAAgB,uBAAuB,CACrC,QAAQ,EAAE,eAAe,EACzB,SAAS,CAAC,EAAE,OAAO,CAAC,mBAAmB,CAAC,eAAe,CAAC,CAAC,EACzD,MAAM,CAAC,EAAE,OAAO,CAAC,eAAe,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GACzD;IACD,MAAM,EAAE,mBAAmB,CAAC,eAAe,CAAC,CAAC;IAC7C,aAAa,EAAE,MAAM,EAAE,CAAC;IACxB,QAAQ,EAAE,MAAM,CAAC;IACjB,aAAa,EAAE,mBAAmB,CAAC,eAAe,CAAC,CAAC;IACpD,WAAW,CAAC,EAAE,KAAK,CAAC;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,aAAa,EAAE,MAAM,CAAC;QAAC,YAAY,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CACrF,CAmCA;AAED;;;GAGG;AACH,eAAO,MAAM,kBAAkB,EAAE,MAAM,CAAC,MAAM,EAAE;IAC9C,MAAM,EAAE,OAAO,CAAC,mBAAmB,CAAC,eAAe,CAAC,CAAC,CAAC;IACtD,aAAa,EAAE,MAAM,CAAC;CACvB,CAgDA,CAAC;AAEF;;GAEG;AACH,wBAAgB,yBAAyB,CACvC,WAAW,EAAE,MAAM,GAClB;IAAE,MAAM,EAAE,OAAO,CAAC,mBAAmB,CAAC,eAAe,CAAC,CAAC,CAAC;IAAC,aAAa,EAAE,MAAM,CAAA;CAAE,GAAG,SAAS,CAG9F;AAED;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,wBAAwB,EAAE,MAAM,CAAC,MAAM,EAAE;IACpD,OAAO,EAAE,KAAK,CAAC;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,UAAU,GAAG,UAAU,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACtF,aAAa,EAAE,MAAM,CAAC;CACvB,CAuFA,CAAC;AAEF;;;;;;;;GAQG;AACH,wBAAgB,sBAAsB,CACpC,MAAM,EAAE,OAAO,CAAC,eAAe,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GACxD;IACD,MAAM,EAAE,OAAO,CAAC,mBAAmB,CAAC,eAAe,CAAC,CAAC,CAAC;IACtD,WAAW,EAAE,KAAK,CAAC;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,aAAa,EAAE,MAAM,CAAC;QAAC,YAAY,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACnF,aAAa,EAAE,MAAM,EAAE,CAAC;CACzB,CA+DA;AAED;;;GAGG;AACH,wBAAgB,sBAAsB,CACpC,QAAQ,EAAE,eAAe,EACzB,MAAM,EAAE,OAAO,CAAC,mBAAmB,CAAC,eAAe,CAAC,CAAC,GACpD,MAAM,EAAE,CA8CV;AAED;;;GAGG;AACH,eAAO,MAAM,iBAAiB,EAAE;IAC9B,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,KAAK,CAAC;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,eAAe,CAAA;KAAE,CAAC,CAAC;CA2BnF,CAAC"}