@baravak/risloo-profile-cli 4.46.2 → 4.70.0

package/src/samples/NEO9A.js

@@ -1,54 +1,75 @@
-const { Profile, FS } = require("../Profile");
+const { Profile } = require("../Profile");
 
+const DOMAIN_MAX = 48;
+const BAR_WIDTH = 500;
+const LEVELS = {
+  1: "خیلی پایین",
+  2: "پایین",
+  3: "متوسط",
+  4: "بالا",
+  5: "خیلی بالا",
+};
+const COLORS = {
+  light: "#BAE6FD",
+  dark: "#0369A1",
+  accent: "#0284C7",
+  stroke: "#0284C7",
+};
+const percentageFromRatio = (ratio) => Math.round(Number(ratio) * 100);
+const DOMAINS = [
+  { d: "n", fa: "روان‌آزرده‌گرایی", letter: "N" },
+  { d: "e", fa: "برون‌گرایی", letter: "E" },
+  { d: "o", fa: "گشودگی", letter: "O" },
+  { d: "a", fa: "موافق بودن", letter: "A" },
+  { d: "c", fa: "با وجدان بودن", letter: "C" },
+];
 
 class NEO9A extends Profile {
-  // Number of pages
   static pages = 1;
 
-  // Labels of the sample
-  labels = {
-    L0: { eng: "n", fr: "روان‌آزده‌گرایی", startColor:"#F9A8D4", endColor: "#DB2777", textColor:"#BE185D", bgColor: "#FDF2F8", steps: [15, 20, 25, 31, 48]},
-    L1: { eng: "n_raw"},
-
-    L2: { eng: "e", fr: "برون‌گرایی", startColor:"#67E8F9", endColor: "#0891B2", textColor:"#0E7490", bgColor: "#ECFEFF", steps: [22, 26, 29, 32, 48]},
-    L3: { eng: "e_raw"},
-
-    L4: { eng: "o", fr: "گشودگی", startColor:"#7DD3FC", endColor: "#0284C7", textColor:"#0369A1", bgColor: "#F0F9FF", steps: [23, 27, 29, 32, 48]},
-    L5: { eng: "o_raw"},
-
-    L6: { eng: "a", fr: "موافق‌بودن", startColor:"#A5B4FC", endColor: "#4F46E5", textColor:"#4338CA", bgColor: "#EEF2FF", steps: [27, 31, 33, 37, 48]},
-    L7: { eng: "a_raw"},
+  static partials = {
+    NEO_main: "NEO_main.hbs",
+  };
 
-    L8: { eng: "c", fr: "با وجدان‌بودن", startColor:"#C4B5FD", endColor: "#7C3AED", textColor:"#6D28D9", bgColor: "#F5F3FF", steps: [27, 32, 35, 39, 48]},
-    L9: { eng: "c_raw"},
+  labels = {
+    N_raw: { eng: "n_raw", fa: "روان‌آزرده‌گرایی", letter: "N", max: DOMAIN_MAX },
+    N_score: { eng: "n_score" },
+    N_lvl: { eng: "n_level" },
+    E_raw: { eng: "e_raw", fa: "برون‌گرایی", letter: "E", max: DOMAIN_MAX },
+    E_score: { eng: "e_score" },
+    E_lvl: { eng: "e_level" },
+    O_raw: { eng: "o_raw", fa: "گشودگی", letter: "O", max: DOMAIN_MAX },
+    O_score: { eng: "o_score" },
+    O_lvl: { eng: "o_level" },
+    A_raw: { eng: "a_raw", fa: "موافق بودن", letter: "A", max: DOMAIN_MAX },
+    A_score: { eng: "a_score" },
+    A_lvl: { eng: "a_level" },
+    C_raw: { eng: "c_raw", fa: "با وجدان بودن", letter: "C", max: DOMAIN_MAX },
+    C_score: { eng: "c_score" },
+    C_lvl: { eng: "c_level" },
+    validity: { eng: "validity" },
   };
 
   profileSpec = {
-    /* "sample" determines some important info about the sample and profile */
-    /* Default prerequisites: 1. gender, 2. age, 3. education */
-    /* "prerequisites" is synonym to "fields" in our program */
     sample: {
-      name: "پرسشنامه شخصیت نئو ۶۰ سوالی (NEO-FFI-60)" /* Name of the sample */,
-      multiProfile: false /* Whether the sample has multiple profiles or not */,
-      questions: true /* Determines whether to get questions from inital dataset or not */,
-      defaultFields: true /* Determines whether to have default prerequisites in the profile or not */,
-      fields: [] /* In case you want to get some additional fields and show in the profile */,
+      name: "پرسشنامه شخصیت نئو ۶۰ سوالی (NEO-FFI-60)",
+      multiProfile: false,
+      questions: true,
+      defaultFields: true,
+      fields: [],
     },
-    /* "profile" determines the dimensions of the drawn profile (to be used in svg tag viewbox) */
-    /* calculating its dimensions carefully is of great importance */
     profile: {
       get dimensions() {
         return {
-          width: 866 + 2 * this.padding.x,
-          height: 649 + 2 * this.padding.y,
+          width: 800 + 2 * this.padding.x,
+          height: 674 + 2 * this.padding.y,
         };
       },
       padding: {
-        x: 18,
-        y: 32,
+        x: 71.5,
+        y: 40,
       },
     },
-    /* "labels" part which has to be provided for each profile */
     labels: Object.values(this.labels),
   };
 
@@ -56,36 +77,46 @@ class NEO9A extends Profile {
     super();
     this._init(dataset, options, config);
   }
+
   _calcContext() {
-    const {
-        dataset,
-      } = this;
-    const factors = []
-    for(let i = 0; i < 10; i+=2){
-        const factor = {
-            ...dataset.score[i],
-            mark: dataset.score[i+1].mark,
-            raw: dataset.score[i].mark - 1,
-            label: {
-                ...dataset.score[i].label,
-                eng: dataset.score[i].label.eng.toUpperCase(),
-                stepTitle: [],
-                fill: `url(#bar-${dataset.score[i].label.eng.toUpperCase()})`
-            }
-        }
-        for(let j = 0; j < factor.label.steps.length; j++){
-            const start = j === 0 ? 0 : factor.label.steps[j-1]
-            const step = factor.label.steps[j]
-            const middle = (((step - start) * 14) / 2) + (start * 14)
-            factor.label.stepTitle.push(middle)
-        }
-        factors.push(factor)
-    }
-    const steps = ['خیلی پایین', 'پایین', 'وسط', 'بالا', 'خیلی بالا']
-    return [{factors, steps}];
-  }
-}
+    const { dataset } = this;
+    const mark = (eng) => dataset.score.find((item) => item.label.eng === eng)?.mark ?? 0;
+
+    const items = DOMAINS.map(({ d, fa, letter }) => {
+      const raw = mark(`${d}_raw`);
+      const p = Number(mark(`${d}_score`));
+      const level = mark(`${d}_level`);
+      const percentage = percentageFromRatio(p);
+      return {
+        fa,
+        letter,
+        max: DOMAIN_MAX,
+        raw,
+        mark: raw,
+        p,
+        barW: (BAR_WIDTH * percentage) / 100,
+        percentage,
+        levelText: LEVELS[level] ?? "-",
+      };
+    });
 
+    const invalidValidity = mark("validity") === 0;
+    const redErrors = invalidValidity
+      ? [{ text: "پاسخ سؤالات اعتبار", length: 105, start: 0, last: true }]
+      : [];
 
+    return [
+      {
+        page: 1,
+        titleAppend: "",
+        theme: "sky",
+        colors: COLORS,
+        items,
+        redErrors,
+        showRed: redErrors.length > 0,
+      },
+    ];
+  }
+}
 
 module.exports = NEO9A;

package/src/samples/NEO9Q.js

@@ -0,0 +1,279 @@
+const { Profile } = require("../Profile");
+
+const DOMAIN_MAX = 192;
+const FACET_MAX = 32;
+const INSIDE_THRESHOLD = 24;
+
+const LEVELS = ["", "بسیار پایین", "پایین", "طبیعی", "بالا", "بسیار بالا"];
+
+const DOMAINS = [
+  { key: "n", fa: "بی‌ثباتی هیجانی", letter: "N" },
+  { key: "e", fa: "برون‌گرایی", letter: "E" },
+  { key: "o", fa: "باز بودن به تجربه", letter: "O" },
+  { key: "a", fa: "توافق با دیگران", letter: "A" },
+  { key: "c", fa: "وجدانی بودن", letter: "C" },
+];
+
+const FACET_NAMES = {
+  n: ["اضطراب", "خشم و کینه‌ورزی", "افسردگی", "شرم", "تکانش‌وری", "آسیب‌پذیری از استرس"],
+  e: ["صمیمیت", "جمع‌گرایی", "قاطعیت", "جنب‌وجوش", "هیجان‌خواهی", "هیجان‌‌های مثبت"],
+  o: ["تخیل", "زیبایی شناسی", "عواطف", "کنش‌ها", "دیدگاه‌ها", "ارزش‌ها"],
+  a: ["اعتماد", "سادگی", "نوع‌دوستی", "تبعیت", "تواضع", "نرمش در برابر دیگران"],
+  c: ["شایستگی", "نظم", "وظیفه‌شناسی", "تلاش برای موفقیت", "نظم درونی", "انعطاف‌ناپذیری"],
+};
+
+const COLOR_THEMES = {
+  female: {
+    light: "#E9D5FF",
+    dark: "#7E22CE",
+    accent: "#9333EA",
+    stroke: "#C084FC",
+  },
+  male: {
+    light: "#BFDBFE",
+    dark: "#1D4ED8",
+    accent: "#2563EB",
+    stroke: "#60A5FA",
+  },
+};
+
+const FACTOR_LABELS = {};
+for (const { key } of DOMAINS) {
+  for (const suffix of ["raw", "score", "level"]) {
+    FACTOR_LABELS[`${key}_${suffix}`] = { eng: `${key}_${suffix}` };
+  }
+
+  for (let index = 1; index <= 6; index += 1) {
+    for (const suffix of ["raw", "score", "level"]) {
+      FACTOR_LABELS[`${key}${index}_${suffix}`] = {
+        eng: `${key}${index}_${suffix}`,
+      };
+    }
+  }
+}
+
+function clamp(value, min, max) {
+  const number = Number(value);
+  if (!Number.isFinite(number)) return min;
+  return Math.min(max, Math.max(min, number));
+}
+
+function layoutIndicators(indicators) {
+  let start = 0;
+
+  return indicators.map((indicator, index) => {
+    const positioned = {
+      ...indicator,
+      start,
+      last: index === indicators.length - 1,
+    };
+    start += indicator.length + 54;
+    return positioned;
+  });
+}
+
+class NEO9Q extends Profile {
+  static pages = 3;
+
+  static partials = {
+    NEO_main: "NEO_main.hbs",
+    NEO_long_facets: "NEO_long_facets.hbs",
+  };
+
+  labels = {
+    ...FACTOR_LABELS,
+    validity: { eng: "validity" },
+    options_3_count: { eng: "options_3_count" },
+    acquiescence: { eng: "acquiescence" },
+    nay_saying: { eng: "nay_saying" },
+    random_responding: { eng: "random_responding" },
+  };
+
+  profileSpec = {
+    sample: {
+      name: "پرسشنامه شخصیت نئو فرم بلند (حق‌شناس)",
+      multiProfile: false,
+      questions: false,
+      defaultFields: true,
+      fields: [],
+    },
+    profile: {
+      get dimensions() {
+        const [page1, page2, page3] = this.padding;
+        return [
+          {
+            width: 800 + 2 * page1.x,
+            height: 674 + 2 * page1.y,
+          },
+          {
+            width: 811 + 2 * page2.x,
+            height: 668 + 2 * page2.y,
+          },
+          {
+            width: 811 + 2 * page3.x,
+            height: 464 + 2 * page3.y,
+          },
+        ];
+      },
+      padding: [
+        { x: 71.5, y: 40 },
+        { x: 66, y: 43 },
+        { x: 66, y: 145 },
+      ],
+    },
+    labels: Object.values(this.labels),
+  };
+
+  constructor(dataset, options, config = {}) {
+    super();
+    this._init(dataset, options, config);
+  }
+
+  _calcContext() {
+    const { dataset } = this;
+    const scoreByKey = new Map(dataset.score.map((item) => [item.label.eng, item]));
+
+    // Dataset._extractData drops a numeric zero, so every read deliberately
+    // restores it with ?? 0 before converting it to a drawing value.
+    const mark = (eng) => scoreByKey.get(eng)?.mark ?? 0;
+    const number = (eng) => {
+      const value = Number(mark(eng));
+      return Number.isFinite(value) ? value : 0;
+    };
+
+    const genderField = (dataset.info.fields ?? []).find((field) => field?.eng === "gender");
+    const isFemale = Number(genderField?.user_answered) === 1;
+    const gender = isFemale ? "female" : "male";
+    const colors = COLOR_THEMES[gender];
+    const sharedContext = {
+      gender,
+      isFemale,
+      theme: gender,
+      colors,
+    };
+
+    const items = DOMAINS.map(({ key, fa, letter }) => {
+      const raw = number(`${key}_raw`);
+      const score = number(`${key}_score`);
+      const level = number(`${key}_level`);
+      const barW = clamp(8 * score - 140, 0, 500);
+
+      return {
+        key,
+        fa,
+        letter,
+        raw,
+        mark: raw,
+        max: DOMAIN_MAX,
+        score,
+        tScore: score,
+        percentage: score,
+        barW,
+        p: barW / 500,
+        inside: score >= INSIDE_THRESHOLD,
+        level,
+        levelText: LEVELS[level] ?? "-",
+      };
+    });
+
+    const redErrors = [];
+    if (number("validity") === 0) {
+      redErrors.push({ text: "پاسخ سؤالات اعتبار", length: 108 });
+    }
+    if (number("options_3_count") >= 41) {
+      redErrors.push({ text: "تعداد پاسخ‌های «نظری ندارم»", length: 170 });
+    }
+
+    const yellowErrors = [];
+    if (number("acquiescence") === 1) {
+      yellowErrors.push({ text: "احتمال تمایل به پاسخ مثبت", length: 155 });
+    }
+    if (number("nay_saying") === 1) {
+      yellowErrors.push({ text: "احتمال تمایل به پاسخ منفی", length: 143 });
+    }
+    if (number("random_responding") === 1) {
+      yellowErrors.push({ text: "احتمال پاسخ تصادفی", length: 105 });
+    }
+
+    const blocks = DOMAINS.map(({ key, fa, letter }, domainIndex) => {
+      const raw = number(`${key}_raw`);
+      const score = number(`${key}_score`);
+      const level = number(`${key}_level`);
+      const barW = clamp(8 * score - 140, 0, 500);
+
+      const facets = FACET_NAMES[key].map((facetName, facetIndex) => {
+        const factorKey = `${key}${facetIndex + 1}`;
+        const facetRaw = number(`${factorKey}_raw`);
+        const facetScore = number(`${factorKey}_score`);
+        const facetLevel = number(`${factorKey}_level`);
+        const facetBarW = clamp(6 * facetScore - 100, 0, 380);
+
+        return {
+          key: factorKey,
+          fa: facetName,
+          raw: facetRaw,
+          mark: facetRaw,
+          max: FACET_MAX,
+          score: facetScore,
+          tScore: facetScore,
+          percentage: facetScore,
+          barW: facetBarW,
+          p: facetBarW / 380,
+          inside: facetScore >= INSIDE_THRESHOLD,
+          level: facetLevel,
+          levelText: LEVELS[facetLevel] ?? "-",
+        };
+      });
+
+      return {
+        key,
+        fa,
+        letter,
+        raw,
+        mark: raw,
+        max: DOMAIN_MAX,
+        score,
+        tScore: score,
+        percentage: score,
+        barW,
+        p: barW / 500,
+        inside: score >= INSIDE_THRESHOLD,
+        level,
+        levelText: LEVELS[level] ?? "-",
+        isPrimary: domainIndex % 2 === 0,
+        isBlue: domainIndex % 2 === 0,
+        facetOffsetY: key === "c" ? -1 : 0,
+        facets,
+      };
+    });
+
+    return [
+      {
+        ...sharedContext,
+        page: 1,
+        titleAppend: "",
+        items,
+        redErrors: layoutIndicators(redErrors),
+        yellowErrors: layoutIndicators(yellowErrors),
+        showRed: redErrors.length > 0,
+        showYellow: yellowErrors.length > 0,
+      },
+      {
+        ...sharedContext,
+        page: 2,
+        titleAppend: " - 2",
+        blocks: blocks.slice(0, 3),
+        gridBottom: 664.5,
+      },
+      {
+        ...sharedContext,
+        page: 3,
+        titleAppend: " - 3",
+        blocks: blocks.slice(3, 5),
+        gridBottom: 460.5,
+      },
+    ];
+  }
+}
+
+module.exports = NEO9Q;

package/src/samples/NEO9V.js

@@ -0,0 +1,215 @@
+const { Profile } = require("../Profile");
+
+const DOMAIN_MAX = 48;
+const MAIN_BAR_WIDTH = 500;
+const DETAIL_BAR_WIDTH = 300;
+const COLORS = {
+  light: "#BFDBFE",
+  dark: "#1D4ED8",
+  accent: "#2563EB",
+  stroke: "#60A5FA",
+};
+const percentageFromRatio = (ratio) => Math.round(Number(ratio) * 100);
+
+const DOMAINS = [
+  {
+    d: "n",
+    fa: "بی‌ثباتی هیجانی",
+    letter: "N",
+    facets: [
+      { d: "n1", fa: "عاطفه منفی", max: 20 },
+      { d: "n2", fa: "سرزنش خویش", max: 28 },
+    ],
+  },
+  {
+    d: "e",
+    fa: "برون‌گرایی",
+    letter: "E",
+    facets: [
+      { d: "e1", fa: "عاطفه مثبت", max: 16 },
+      { d: "e2", fa: "جامعه‌پذیری", max: 16 },
+      { d: "e3", fa: "فعالیت", max: 16 },
+    ],
+  },
+  {
+    d: "o",
+    fa: "باز بودن به تجربه",
+    letter: "O",
+    facets: [
+      { d: "o1", fa: "علایق زیبایی‌شناختی", max: 12 },
+      { d: "o2", fa: "علایق ذهنی", max: 12 },
+      { d: "o3", fa: "غیرسنتی", max: 16 },
+    ],
+  },
+  {
+    d: "a",
+    fa: "توافق با دیگران",
+    letter: "A",
+    facets: [
+      { d: "a1", fa: "گرایش موافق (نامتضاد)", max: 32 },
+      { d: "a2", fa: "گرایش عام‌المنفعه", max: 16 },
+    ],
+  },
+  {
+    d: "c",
+    fa: "وجدانی بودن",
+    letter: "C",
+    facets: [
+      { d: "c1", fa: "نظم‌پذیری", max: 20 },
+      { d: "c2", fa: "تلاش هدفمند", max: 12 },
+      { d: "c3", fa: "قابل اتکا بودن", max: 16 },
+    ],
+  },
+];
+
+const SCORE_LABELS = {};
+for (const domain of DOMAINS) {
+  SCORE_LABELS[`${domain.d}_raw`] = {
+    eng: `${domain.d}_raw`,
+    fa: domain.fa,
+    letter: domain.letter,
+    max: DOMAIN_MAX,
+  };
+  SCORE_LABELS[`${domain.d}_score`] = { eng: `${domain.d}_score` };
+
+  for (const facet of domain.facets) {
+    SCORE_LABELS[`${facet.d}_raw`] = {
+      eng: `${facet.d}_raw`,
+      fa: facet.fa,
+      max: facet.max,
+    };
+    SCORE_LABELS[`${facet.d}_score`] = { eng: `${facet.d}_score` };
+  }
+}
+
+const layoutErrors = (errors) => {
+  let start = 0;
+  return errors.map((error, index) => {
+    const item = {
+      ...error,
+      start,
+      last: index === errors.length - 1,
+    };
+    start += error.length + 54;
+    return item;
+  });
+};
+
+class NEO9V extends Profile {
+  static pages = 2;
+
+  static partials = {
+    NEO_main: "NEO_main.hbs",
+    NEO_short_facets: "NEO_short_facets.hbs",
+  };
+
+  labels = {
+    ...SCORE_LABELS,
+    validity: { eng: "validity" },
+    options_3_count: { eng: "options_3_count" },
+  };
+
+  profileSpec = {
+    sample: {
+      name: "آزمون شخصیت نئو فرم کوتاه (PI-R)",
+      multiProfile: false,
+      questions: false,
+      defaultFields: true,
+      fields: [],
+    },
+    profile: {
+      get dimensions() {
+        const [page1, page2] = this.padding;
+        return [
+          {
+            width: 801 + 2 * page1.x,
+            height: 674 + 2 * page1.y,
+          },
+          {
+            width: 760 + 2 * page2.x,
+            height: 662 + 2 * page2.y,
+          },
+        ];
+      },
+      padding: [
+        { x: 71, y: 40 },
+        { x: 91.5, y: 46 },
+      ],
+    },
+    labels: Object.values(this.labels),
+  };
+
+  constructor(dataset, options, config = {}) {
+    super();
+    this._init(dataset, options, config);
+  }
+
+  _calcContext() {
+    const { dataset } = this;
+    const mark = (eng) => dataset.score.find((item) => item.label.eng === eng)?.mark ?? 0;
+
+    const blocks = DOMAINS.map((domain, index) => {
+      const raw = mark(`${domain.d}_raw`);
+      const p = Number(mark(`${domain.d}_score`));
+      const percentage = percentageFromRatio(p);
+      const facets = domain.facets.map((facet) => {
+        const facetRaw = mark(`${facet.d}_raw`);
+        const facetP = Number(mark(`${facet.d}_score`));
+        const facetPercentage = percentageFromRatio(facetP);
+        return {
+          fa: facet.fa,
+          max: facet.max,
+          raw: facetRaw,
+          mark: facetRaw,
+          p: facetP,
+          barW: (DETAIL_BAR_WIDTH * facetPercentage) / 100,
+          percentage: facetPercentage,
+        };
+      });
+
+      return {
+        fa: domain.fa,
+        letter: domain.letter,
+        max: DOMAIN_MAX,
+        raw,
+        mark: raw,
+        p,
+        barW: (MAIN_BAR_WIDTH * percentage) / 100,
+        percentage,
+        isBlue: index % 2 === 0,
+        facets,
+      };
+    });
+
+    const invalidErrors = [];
+    if (mark("validity") === 0) {
+      invalidErrors.push({ text: "پاسخ سؤالات اعتبار", length: 108 });
+    }
+    if (Number(mark("options_3_count")) >= 10) {
+      invalidErrors.push({ text: "تعداد پاسخ‌های «نظری ندارم»", length: 170 });
+    }
+    const redErrors = layoutErrors(invalidErrors);
+
+    return [
+      {
+        page: 1,
+        titleAppend: "",
+        theme: "blue",
+        colors: COLORS,
+        items: blocks.map(({ facets, isBlue, ...item }) => item),
+        redErrors,
+        showRed: redErrors.length > 0,
+      },
+      {
+        page: 2,
+        titleAppend: " - 2",
+        theme: "blue",
+        colors: COLORS,
+        blocks,
+        gridBottom: 658.5,
+      },
+    ];
+  }
+}
+
+module.exports = NEO9V;

package/src/samples/OBQ4493.js

@@ -23,7 +23,7 @@ class OBQ4493 extends Profile {
       multiProfile: false /* Whether the sample has multiple profiles or not */,
       questions: false /* Determines whether to get questions from inital dataset or not */,
       defaultFields: true /* Determines whether to have default prerequisites in the profile or not */,
-      fields: ["marital_status"] /* In case you want to get some additional fields and show in the profile */,
+      fields: [] /* In case you want to get some additional fields and show in the profile */,
     },
     /* "profile" determines the dimensions of the drawn profile (to be used in svg tag viewbox) */
     /* calculating its dimensions carefully is of great importance */

package/src/samples/PIES93.js

@@ -26,7 +26,7 @@ class PIES93 extends Profile {
       multiProfile: false /* Whether the sample has multiple profiles or not */,
       questions: false /* Determines whether to get questions from inital dataset or not */,
       defaultFields: true /* Determines whether to have default prerequisites in the profile or not */,
-      fields: ["marital_status"] /* In case you want to get some additional fields and show in the profile */,
+      fields: [] /* In case you want to get some additional fields and show in the profile */,
     },
     /* "profile" determines the dimensions of the drawn profile (to be used in svg tag viewbox) */
     /* calculating its dimensions carefully is of great importance */