@questify/core 1.0.0

package/dist/vue/index.mjs

@@ -0,0 +1,322 @@
+// src/vue/index.ts
+import { ref, computed, onUnmounted } from "vue";
+
+// src/core/index.ts
+function evaluateSimple(condition, responses) {
+  var _a;
+  const response = responses[condition.questionId];
+  if (response === void 0 || response === null) return false;
+  const op = (_a = condition.operator) != null ? _a : "eq";
+  const val = condition.value;
+  switch (op) {
+    case "eq":
+      return response === val;
+    case "neq":
+      return response !== val;
+    case "gt":
+      return typeof response === "number" && typeof val === "number" && response > val;
+    case "lt":
+      return typeof response === "number" && typeof val === "number" && response < val;
+    case "gte":
+      return typeof response === "number" && typeof val === "number" && response >= val;
+    case "lte":
+      return typeof response === "number" && typeof val === "number" && response <= val;
+    case "includes":
+      return Array.isArray(response) ? response.includes(val) : String(response).includes(String(val));
+    default:
+      return response === val;
+  }
+}
+var MAX_CONDITION_DEPTH = 20;
+function evaluateRule(rule, responses, depth = 0) {
+  if (depth > MAX_CONDITION_DEPTH) {
+    console.warn("[questify] showIf condition tree exceeds maximum depth. Defaulting to visible.");
+    return true;
+  }
+  if ("and" in rule && rule.and) {
+    if (rule.and.length === 0) return true;
+    return rule.and.every((r) => evaluateRule(r, responses, depth + 1));
+  }
+  if ("or" in rule && rule.or) {
+    if (rule.or.length === 0) return false;
+    return rule.or.some((r) => evaluateRule(r, responses, depth + 1));
+  }
+  return evaluateSimple(rule, responses);
+}
+function getVisibleQuestions(questions, responses) {
+  return questions.filter((q) => q.showIf ? evaluateRule(q.showIf, responses) : true);
+}
+function isEmpty(value) {
+  if (value === void 0 || value === null) return true;
+  if (typeof value === "string" && value.trim() === "") return true;
+  if (Array.isArray(value) && value.length === 0) return true;
+  return false;
+}
+function validateAnswer(question, value) {
+  var _a, _b, _c, _d, _e, _f, _g, _h, _i;
+  if (question.required && isEmpty(value)) {
+    return (_b = (_a = question.validation) == null ? void 0 : _a.message) != null ? _b : "This field is required.";
+  }
+  if (isEmpty(value)) return null;
+  const v = question.validation;
+  if (question.type === "number" || question.type === "rating") {
+    const num = Number(value);
+    if (isNaN(num) || !isFinite(num)) return "Must be a valid number.";
+    if ((v == null ? void 0 : v.min) !== void 0 && num < v.min) return (_c = v.message) != null ? _c : `Minimum value is ${v.min}.`;
+    if ((v == null ? void 0 : v.max) !== void 0 && num > v.max) return (_d = v.message) != null ? _d : `Maximum value is ${v.max}.`;
+  }
+  if (question.type === "text") {
+    const str = String(value).trim();
+    if ((v == null ? void 0 : v.minLength) !== void 0 && str.length < v.minLength)
+      return (_e = v.message) != null ? _e : `Minimum ${v.minLength} characters required.`;
+    if ((v == null ? void 0 : v.maxLength) !== void 0 && str.length > v.maxLength)
+      return (_f = v.message) != null ? _f : `Maximum ${v.maxLength} characters allowed.`;
+    if (v == null ? void 0 : v.regex) {
+      try {
+        if (!new RegExp(v.regex).test(str)) return (_g = v.message) != null ? _g : "Invalid format.";
+      } catch {
+      }
+    }
+  }
+  if (question.type === "email") {
+    const str = String(value).trim();
+    if ((v == null ? void 0 : v.minLength) !== void 0 && str.length < v.minLength)
+      return (_h = v.message) != null ? _h : `Minimum ${v.minLength} characters required.`;
+    if ((v == null ? void 0 : v.maxLength) !== void 0 && str.length > v.maxLength)
+      return (_i = v.message) != null ? _i : `Maximum ${v.maxLength} characters allowed.`;
+    if (!/^[^\s@]+@[^\s@]+\.[^\s@]+$/.test(str))
+      return "Please enter a valid email address.";
+  }
+  if (question.type === "date") {
+    const str = String(value);
+    if (!/^\d{4}-\d{2}-\d{2}$/.test(str)) return "Please enter a valid date (YYYY-MM-DD).";
+    const d = /* @__PURE__ */ new Date(str + "T00:00:00");
+    if (isNaN(d.getTime())) return "Please enter a valid date.";
+  }
+  return null;
+}
+function computeProgress(visibleQuestions, responses) {
+  if (visibleQuestions.length === 0) return 0;
+  const answered = visibleQuestions.filter((q) => !isEmpty(responses[q.id])).length;
+  return answered / visibleQuestions.length;
+}
+function checkComplete(visibleQuestions, responses) {
+  return visibleQuestions.filter((q) => q.required).every((q) => !isEmpty(responses[q.id]) && validateAnswer(q, responses[q.id]) === null);
+}
+function buildState(config, responses, questionIndex, errors) {
+  var _a;
+  const visibleQuestions = getVisibleQuestions(config.questions, responses);
+  const safeIndex = Math.min(questionIndex, Math.max(0, visibleQuestions.length - 1));
+  const question = (_a = visibleQuestions[safeIndex]) != null ? _a : null;
+  const visibleIds = new Set(visibleQuestions.map((q) => q.id));
+  const visibleErrors = Object.fromEntries(
+    Object.entries(errors).filter(([id]) => visibleIds.has(id))
+  );
+  return {
+    question,
+    visibleQuestions,
+    questionIndex: safeIndex,
+    totalQuestions: visibleQuestions.length,
+    progress: computeProgress(visibleQuestions, responses),
+    // [H-2] Defensive copy — prevents external mutation of internal state
+    responses: { ...responses },
+    isComplete: checkComplete(visibleQuestions, responses),
+    errors: visibleErrors,
+    canGoBack: safeIndex > 0,
+    canGoNext: safeIndex < visibleQuestions.length - 1
+  };
+}
+var UNSAFE_KEYS = /* @__PURE__ */ new Set(["__proto__", "constructor", "prototype"]);
+var Questionnaire = class {
+  constructor(config) {
+    this.subscribers = [];
+    var _a;
+    const ids = config.questions.map((q) => q.id);
+    const dupes = ids.filter((id, i) => ids.indexOf(id) !== i);
+    if (dupes.length > 0) {
+      console.warn(
+        `[questify] Duplicate question IDs detected: ${[...new Set(dupes)].join(", ")}. Each question must have a unique id.`
+      );
+    }
+    this.config = { mode: "step", ...config };
+    this.responses = { ...(_a = config.initialResponses) != null ? _a : {} };
+    this.questionIndex = 0;
+    this.errors = {};
+    this.cachedState = buildState(this.config, this.responses, 0, {});
+  }
+  recompute() {
+    this.cachedState = buildState(
+      this.config,
+      this.responses,
+      this.questionIndex,
+      this.errors
+    );
+  }
+  notify() {
+    const snapshot = this.subscribers.slice();
+    snapshot.forEach((s) => s(this.cachedState));
+  }
+  // ── Read ──────────────────────────────────────────────────────────────────
+  getState() {
+    return this.cachedState;
+  }
+  /**
+   * Returns only responses for currently visible questions.
+   * Use this for form submission — avoids sending hidden-branch data to the server.
+   *
+   * `state.responses` retains all answers for back-navigation; this method prunes them.
+   */
+  getSubmittableResponses() {
+    const { visibleQuestions } = this.cachedState;
+    const visibleIds = new Set(visibleQuestions.map((q) => q.id));
+    return Object.fromEntries(
+      Object.entries(this.responses).filter(([id]) => visibleIds.has(id))
+    );
+  }
+  subscribe(callback) {
+    this.subscribers.push(callback);
+    callback(this.cachedState);
+    return () => {
+      this.subscribers = this.subscribers.filter((s) => s !== callback);
+    };
+  }
+  // ── Write ─────────────────────────────────────────────────────────────────
+  /**
+   * Answer the current question (step mode).
+   * In `mode: "all"` prefer `answerById()`.
+   */
+  answer(value) {
+    const { visibleQuestions, questionIndex } = this.cachedState;
+    const q = visibleQuestions[questionIndex];
+    if (!q) return;
+    this._setAnswer(q, value);
+  }
+  /**
+   * Answer any visible question by its id — the right API for `mode: "all"`.
+   * Safe to call in step mode too (allows answering any step by id).
+   */
+  answerById(questionId, value) {
+    const q = this.cachedState.visibleQuestions.find((q2) => q2.id === questionId);
+    if (!q) return;
+    this._setAnswer(q, value);
+  }
+  _setAnswer(question, value) {
+    if (UNSAFE_KEYS.has(question.id)) return;
+    this.responses = { ...this.responses, [question.id]: value };
+    const error = validateAnswer(question, value);
+    if (error) {
+      this.errors = { ...this.errors, [question.id]: error };
+    } else {
+      const { [question.id]: _dropped, ...rest } = this.errors;
+      this.errors = rest;
+    }
+    this.recompute();
+    this.notify();
+  }
+  /**
+   * Advance to the next step (step mode).
+   * Validates the current required question first; populates `errors` if invalid.
+   */
+  next() {
+    const { visibleQuestions, questionIndex } = this.cachedState;
+    const q = visibleQuestions[questionIndex];
+    if (q) {
+      const error = validateAnswer(q, this.responses[q.id]);
+      if (error) {
+        this.errors = { ...this.errors, [q.id]: error };
+        this.recompute();
+        this.notify();
+        return;
+      }
+    }
+    if (questionIndex < visibleQuestions.length - 1) {
+      this.questionIndex = questionIndex + 1;
+      this.recompute();
+      this.notify();
+    }
+  }
+  /** Go to the previous step. No-op on step 0. */
+  back() {
+    if (this.questionIndex > 0) {
+      this.questionIndex -= 1;
+      this.recompute();
+      this.notify();
+    }
+  }
+  /**
+   * Jump to a specific step index (0-based, within visible questions).
+   * Out-of-range indices are silently ignored.
+   */
+  jumpTo(index) {
+    const { visibleQuestions } = this.cachedState;
+    if (index >= 0 && index < visibleQuestions.length) {
+      this.questionIndex = index;
+      this.recompute();
+      this.notify();
+    }
+  }
+  /**
+   * Validate all visible required questions and return a map of errors.
+   * Useful for "submit" gates in `mode: "all"`.
+   */
+  validate() {
+    const newErrors = {};
+    for (const q of this.cachedState.visibleQuestions) {
+      const error = validateAnswer(q, this.responses[q.id]);
+      if (error) newErrors[q.id] = error;
+    }
+    if (Object.keys(newErrors).length > 0) {
+      this.errors = { ...this.errors, ...newErrors };
+      this.recompute();
+      this.notify();
+    }
+    return newErrors;
+  }
+  /** Reset all responses and errors, restart from step 0. */
+  reset() {
+    var _a;
+    this.responses = { ...(_a = this.config.initialResponses) != null ? _a : {} };
+    this.questionIndex = 0;
+    this.errors = {};
+    this.recompute();
+    this.notify();
+  }
+};
+
+// src/vue/index.ts
+function useQuestionnaire(config) {
+  const q = new Questionnaire(config);
+  const state = ref(q.getState());
+  const unsubscribe = q.subscribe((newState) => {
+    state.value = newState;
+  });
+  onUnmounted(() => unsubscribe());
+  return {
+    question: computed(() => state.value.question),
+    visibleQuestions: computed(() => state.value.visibleQuestions),
+    questionIndex: computed(() => state.value.questionIndex),
+    totalQuestions: computed(() => state.value.totalQuestions),
+    progress: computed(() => state.value.progress),
+    responses: computed(() => state.value.responses),
+    isComplete: computed(() => state.value.isComplete),
+    errors: computed(() => state.value.errors),
+    canGoBack: computed(() => state.value.canGoBack),
+    canGoNext: computed(() => state.value.canGoNext),
+    /** Answer the current step question (step mode). In all-mode, use `answerById`. */
+    answer: (value) => q.answer(value),
+    /** Answer any visible question by id — correct API for mode:"all". */
+    answerById: (questionId, value) => q.answerById(questionId, value),
+    next: () => q.next(),
+    back: () => q.back(),
+    jumpTo: (index) => q.jumpTo(index),
+    /** Validate all visible required questions. Returns id→error map. */
+    validate: () => q.validate(),
+    reset: () => q.reset(),
+    /** Returns only responses for currently visible questions. Use for submission. */
+    getSubmittableResponses: () => q.getSubmittableResponses()
+  };
+}
+export {
+  useQuestionnaire
+};
+//# sourceMappingURL=index.mjs.map

package/dist/vue/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/vue/index.ts","../../src/core/index.ts"],"sourcesContent":["import { ref, computed, onUnmounted } from \"vue\";\nimport { Questionnaire } from \"../core\";\nimport type { QuestionnaireConfig, QuestionnaireState } from \"../core/types\";\n\n/**\n * Vue 3 composable for questify.\n *\n * All state values are `computed` refs — fully reactive.\n * The Questionnaire instance is created once per composable call and cleaned\n * up via `onUnmounted`. Do not call this outside of `setup()`.\n *\n * If the parent component passes different config on re-render, the composable\n * does NOT reinitialise. Use a `key` attribute on the component to force remount.\n */\nexport function useQuestionnaire(config: QuestionnaireConfig) {\n  const q = new Questionnaire(config);\n  const state = ref<QuestionnaireState>(q.getState());\n\n  const unsubscribe = q.subscribe((newState) => {\n    state.value = newState;\n  });\n\n  onUnmounted(() => unsubscribe());\n\n  return {\n    question:         computed(() => state.value.question),\n    visibleQuestions: computed(() => state.value.visibleQuestions),\n    questionIndex:    computed(() => state.value.questionIndex),\n    totalQuestions:   computed(() => state.value.totalQuestions),\n    progress:         computed(() => state.value.progress),\n    responses:        computed(() => state.value.responses),\n    isComplete:       computed(() => state.value.isComplete),\n    errors:           computed(() => state.value.errors),\n    canGoBack:        computed(() => state.value.canGoBack),\n    canGoNext:        computed(() => state.value.canGoNext),\n\n    /** Answer the current step question (step mode). In all-mode, use `answerById`. */\n    answer:     (value: unknown) => q.answer(value),\n    /** Answer any visible question by id — correct API for mode:\"all\". */\n    answerById: (questionId: string, value: unknown) => q.answerById(questionId, value),\n    next:       () => q.next(),\n    back:       () => q.back(),\n    jumpTo:     (index: number) => q.jumpTo(index),\n    /** Validate all visible required questions. Returns id→error map. */\n    validate:   () => q.validate(),\n    reset:      () => q.reset(),\n    /** Returns only responses for currently visible questions. Use for submission. */\n    getSubmittableResponses: () => q.getSubmittableResponses(),\n  };\n}\n","import type {\n  Question,\n  QuestionnaireConfig,\n  QuestionnaireState,\n  ShowIfCondition,\n  ShowIfRule,\n} from \"./types\";\n\nexport * from \"./types\";\n\n// ─── Conditional visibility ───────────────────────────────────────────────────\n\nfunction evaluateSimple(\n  condition: ShowIfCondition,\n  responses: Record<string, unknown>\n): boolean {\n  const response = responses[condition.questionId];\n  if (response === undefined || response === null) return false;\n\n  const op = condition.operator ?? \"eq\";\n  const val = condition.value;\n\n  switch (op) {\n    case \"eq\":  return response === val;\n    case \"neq\": return response !== val;\n    case \"gt\":\n      return typeof response === \"number\" && typeof val === \"number\" && response > val;\n    case \"lt\":\n      return typeof response === \"number\" && typeof val === \"number\" && response < val;\n    case \"gte\":\n      return typeof response === \"number\" && typeof val === \"number\" && response >= val;\n    case \"lte\":\n      return typeof response === \"number\" && typeof val === \"number\" && response <= val;\n    case \"includes\":\n      return Array.isArray(response)\n        ? response.includes(val)\n        : String(response).includes(String(val));\n    default: return response === val;\n  }\n}\n\n// Maximum nesting depth for showIf condition trees.\n// Guards against stack overflows from accidentally deep or circular configs.\nconst MAX_CONDITION_DEPTH = 20;\n\nfunction evaluateRule(\n  rule: ShowIfRule,\n  responses: Record<string, unknown>,\n  depth = 0\n): boolean {\n  if (depth > MAX_CONDITION_DEPTH) {\n    // Tree too deep — default to visible so questions don't silently disappear.\n    console.warn(\"[questify] showIf condition tree exceeds maximum depth. Defaulting to visible.\");\n    return true;\n  }\n  if (\"and\" in rule && rule.and) {\n    if (rule.and.length === 0) return true;\n    return rule.and.every((r) => evaluateRule(r, responses, depth + 1));\n  }\n  if (\"or\" in rule && rule.or) {\n    if (rule.or.length === 0) return false;\n    return rule.or.some((r) => evaluateRule(r, responses, depth + 1));\n  }\n  return evaluateSimple(rule as ShowIfCondition, responses);\n}\n\nfunction getVisibleQuestions(\n  questions: Question[],\n  responses: Record<string, unknown>\n): Question[] {\n  return questions.filter((q) => (q.showIf ? evaluateRule(q.showIf, responses) : true));\n}\n\n// ─── Validation ───────────────────────────────────────────────────────────────\n\nfunction isEmpty(value: unknown): boolean {\n  if (value === undefined || value === null) return true;\n  if (typeof value === \"string\" && value.trim() === \"\") return true;\n  if (Array.isArray(value) && value.length === 0) return true;\n  return false;\n}\n\nexport function validateAnswer(question: Question, value: unknown): string | null {\n  // Required check — uses isEmpty which trims whitespace\n  if (question.required && isEmpty(value)) {\n    return question.validation?.message ?? \"This field is required.\";\n  }\n\n  // No further validation on empty optional fields\n  if (isEmpty(value)) return null;\n\n  const v = question.validation;\n\n  // Number / rating\n  if (question.type === \"number\" || question.type === \"rating\") {\n    const num = Number(value);\n    if (isNaN(num) || !isFinite(num)) return \"Must be a valid number.\";\n    if (v?.min !== undefined && num < v.min) return v.message ?? `Minimum value is ${v.min}.`;\n    if (v?.max !== undefined && num > v.max) return v.message ?? `Maximum value is ${v.max}.`;\n  }\n\n  // Text (length + regex)\n  if (question.type === \"text\") {\n    const str = String(value).trim();\n    if (v?.minLength !== undefined && str.length < v.minLength)\n      return v.message ?? `Minimum ${v.minLength} characters required.`;\n    if (v?.maxLength !== undefined && str.length > v.maxLength)\n      return v.message ?? `Maximum ${v.maxLength} characters allowed.`;\n    if (v?.regex) {\n      try {\n        if (!new RegExp(v.regex).test(str)) return v.message ?? \"Invalid format.\";\n      } catch {\n        // Malformed regex in config — skip silently in production\n      }\n    }\n  }\n\n  // Email — format check always runs, regardless of whether a validation object exists\n  if (question.type === \"email\") {\n    const str = String(value).trim();\n    if (v?.minLength !== undefined && str.length < v.minLength)\n      return v.message ?? `Minimum ${v.minLength} characters required.`;\n    if (v?.maxLength !== undefined && str.length > v.maxLength)\n      return v.message ?? `Maximum ${v.maxLength} characters allowed.`;\n    if (!/^[^\\s@]+@[^\\s@]+\\.[^\\s@]+$/.test(str))\n      return \"Please enter a valid email address.\";\n  }\n\n  // Date — always validate YYYY-MM-DD format to avoid timezone surprises\n  if (question.type === \"date\") {\n    const str = String(value);\n    if (!/^\\d{4}-\\d{2}-\\d{2}$/.test(str)) return \"Please enter a valid date (YYYY-MM-DD).\";\n    const d = new Date(str + \"T00:00:00\");\n    if (isNaN(d.getTime())) return \"Please enter a valid date.\";\n  }\n\n  return null;\n}\n\n// ─── Progress + completion ────────────────────────────────────────────────────\n\nfunction computeProgress(\n  visibleQuestions: Question[],\n  responses: Record<string, unknown>\n): number {\n  if (visibleQuestions.length === 0) return 0;\n  const answered = visibleQuestions.filter((q) => !isEmpty(responses[q.id])).length;\n  return answered / visibleQuestions.length;\n}\n\nfunction checkComplete(\n  visibleQuestions: Question[],\n  responses: Record<string, unknown>\n): boolean {\n  return visibleQuestions\n    .filter((q) => q.required)\n    .every((q) => !isEmpty(responses[q.id]) && validateAnswer(q, responses[q.id]) === null);\n}\n\n// ─── State builder ────────────────────────────────────────────────────────────\n\nfunction buildState(\n  config: QuestionnaireConfig,\n  responses: Record<string, unknown>,\n  questionIndex: number,\n  errors: Record<string, string>\n): QuestionnaireState {\n  const visibleQuestions = getVisibleQuestions(config.questions, responses);\n  const safeIndex = Math.min(questionIndex, Math.max(0, visibleQuestions.length - 1));\n  const question = visibleQuestions[safeIndex] ?? null;\n\n  // [H-1] Filter stale errors for hidden questions\n  const visibleIds = new Set(visibleQuestions.map((q) => q.id));\n  const visibleErrors = Object.fromEntries(\n    Object.entries(errors).filter(([id]) => visibleIds.has(id))\n  );\n\n  return {\n    question,\n    visibleQuestions,\n    questionIndex: safeIndex,\n    totalQuestions: visibleQuestions.length,\n    progress: computeProgress(visibleQuestions, responses),\n    // [H-2] Defensive copy — prevents external mutation of internal state\n    responses: { ...responses },\n    isComplete: checkComplete(visibleQuestions, responses),\n    errors: visibleErrors,\n    canGoBack: safeIndex > 0,\n    canGoNext: safeIndex < visibleQuestions.length - 1,\n  };\n}\n\n// ─── Questionnaire class ──────────────────────────────────────────────────────\n\n// Keys that must never become property names on a plain object.\n// Guards against prototype pollution via developer-supplied question IDs.\nconst UNSAFE_KEYS = new Set([\"__proto__\", \"constructor\", \"prototype\"]);\n\ntype Subscriber = (state: QuestionnaireState) => void;\n\nexport class Questionnaire {\n  private config: QuestionnaireConfig;\n  private responses: Record<string, unknown>;\n  private questionIndex: number;\n  private errors: Record<string, string>;\n  private subscribers: Subscriber[] = [];\n  private cachedState: QuestionnaireState;\n\n  constructor(config: QuestionnaireConfig) {\n    // [M-1] Warn on duplicate IDs — always a config bug, regardless of environment\n    const ids = config.questions.map((q) => q.id);\n    const dupes = ids.filter((id, i) => ids.indexOf(id) !== i);\n    if (dupes.length > 0) {\n      console.warn(\n        `[questify] Duplicate question IDs detected: ${[...new Set(dupes)].join(\", \")}. ` +\n        `Each question must have a unique id.`\n      );\n    }\n\n    this.config = { mode: \"step\", ...config };\n    this.responses = { ...(config.initialResponses ?? {}) };\n    this.questionIndex = 0;\n    this.errors = {};\n    this.cachedState = buildState(this.config, this.responses, 0, {});\n  }\n\n  private recompute(): void {\n    this.cachedState = buildState(\n      this.config,\n      this.responses,\n      this.questionIndex,\n      this.errors\n    );\n  }\n\n  private notify(): void {\n    // [M-5] Snapshot before iterating — safe against subscribe/unsubscribe during emit\n    const snapshot = this.subscribers.slice();\n    snapshot.forEach((s) => s(this.cachedState));\n  }\n\n  // ── Read ──────────────────────────────────────────────────────────────────\n\n  getState(): QuestionnaireState {\n    return this.cachedState;\n  }\n\n  /**\n   * Returns only responses for currently visible questions.\n   * Use this for form submission — avoids sending hidden-branch data to the server.\n   *\n   * `state.responses` retains all answers for back-navigation; this method prunes them.\n   */\n  getSubmittableResponses(): Record<string, unknown> {\n    const { visibleQuestions } = this.cachedState;\n    const visibleIds = new Set(visibleQuestions.map((q) => q.id));\n    return Object.fromEntries(\n      Object.entries(this.responses).filter(([id]) => visibleIds.has(id))\n    );\n  }\n\n  subscribe(callback: Subscriber): () => void {\n    this.subscribers.push(callback);\n    callback(this.cachedState);\n    return () => {\n      this.subscribers = this.subscribers.filter((s) => s !== callback);\n    };\n  }\n\n  // ── Write ─────────────────────────────────────────────────────────────────\n\n  /**\n   * Answer the current question (step mode).\n   * In `mode: \"all\"` prefer `answerById()`.\n   */\n  answer(value: unknown): void {\n    const { visibleQuestions, questionIndex } = this.cachedState;\n    const q = visibleQuestions[questionIndex];\n    if (!q) return;\n    this._setAnswer(q, value);\n  }\n\n  /**\n   * Answer any visible question by its id — the right API for `mode: \"all\"`.\n   * Safe to call in step mode too (allows answering any step by id).\n   */\n  answerById(questionId: string, value: unknown): void {\n    const q = this.cachedState.visibleQuestions.find((q) => q.id === questionId);\n    if (!q) return;\n    this._setAnswer(q, value);\n  }\n\n  private _setAnswer(question: Question, value: unknown): void {\n    // Guard against prototype pollution — unsafe IDs are silently ignored.\n    if (UNSAFE_KEYS.has(question.id)) return;\n    this.responses = { ...this.responses, [question.id]: value };\n\n    const error = validateAnswer(question, value);\n    if (error) {\n      this.errors = { ...this.errors, [question.id]: error };\n    } else {\n      const { [question.id]: _dropped, ...rest } = this.errors;\n      this.errors = rest;\n    }\n\n    this.recompute();\n    this.notify();\n  }\n\n  /**\n   * Advance to the next step (step mode).\n   * Validates the current required question first; populates `errors` if invalid.\n   */\n  next(): void {\n    const { visibleQuestions, questionIndex } = this.cachedState;\n    const q = visibleQuestions[questionIndex];\n\n    if (q) {\n      const error = validateAnswer(q, this.responses[q.id]);\n      if (error) {\n        this.errors = { ...this.errors, [q.id]: error };\n        this.recompute();\n        this.notify();\n        return;\n      }\n    }\n\n    if (questionIndex < visibleQuestions.length - 1) {\n      this.questionIndex = questionIndex + 1;\n      this.recompute();\n      this.notify();\n    }\n  }\n\n  /** Go to the previous step. No-op on step 0. */\n  back(): void {\n    if (this.questionIndex > 0) {\n      this.questionIndex -= 1;\n      this.recompute();\n      this.notify();\n    }\n  }\n\n  /**\n   * Jump to a specific step index (0-based, within visible questions).\n   * Out-of-range indices are silently ignored.\n   */\n  jumpTo(index: number): void {\n    const { visibleQuestions } = this.cachedState;\n    if (index >= 0 && index < visibleQuestions.length) {\n      this.questionIndex = index;\n      this.recompute();\n      this.notify();\n    }\n  }\n\n  /**\n   * Validate all visible required questions and return a map of errors.\n   * Useful for \"submit\" gates in `mode: \"all\"`.\n   */\n  validate(): Record<string, string> {\n    const newErrors: Record<string, string> = {};\n    for (const q of this.cachedState.visibleQuestions) {\n      const error = validateAnswer(q, this.responses[q.id]);\n      if (error) newErrors[q.id] = error;\n    }\n    if (Object.keys(newErrors).length > 0) {\n      this.errors = { ...this.errors, ...newErrors };\n      this.recompute();\n      this.notify();\n    }\n    return newErrors;\n  }\n\n  /** Reset all responses and errors, restart from step 0. */\n  reset(): void {\n    this.responses = { ...(this.config.initialResponses ?? {}) };\n    this.questionIndex = 0;\n    this.errors = {};\n    this.recompute();\n    this.notify();\n  }\n}\n"],"mappings":"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","names":["q"]}

package/package.json

@@ -0,0 +1,71 @@
+{
+  "name": "@questify/core",
+  "version": "1.0.0",
+  "description": "Headless, zero-dependency questionnaire engine. Works with React, Vue, Svelte, or vanilla JS.",
+  "keywords": [
+    "questionnaire",
+    "survey",
+    "quiz",
+    "form",
+    "headless",
+    "react",
+    "vue",
+    "typescript",
+    "conditional-logic",
+    "step-form",
+    "multi-step"
+  ],
+  "author": "Ashish Kumar",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/ashishcumar/questify.git"
+  },
+  "main": "./dist/index.js",
+  "module": "./dist/index.mjs",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.mjs",
+      "require": "./dist/index.js"
+    },
+    "./react": {
+      "types": "./dist/react/index.d.ts",
+      "import": "./dist/react/index.mjs",
+      "require": "./dist/react/index.js"
+    },
+    "./vue": {
+      "types": "./dist/vue/index.d.ts",
+      "import": "./dist/vue/index.mjs",
+      "require": "./dist/vue/index.js"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsup",
+    "dev": "tsup --watch",
+    "lint": "tsc --noEmit"
+  },
+  "devDependencies": {
+    "tsup": "^8.0.0",
+    "typescript": "^5.0.0",
+    "@types/react": "^19.0.0",
+    "react": "^19.0.0",
+    "vue": "^3.0.0"
+  },
+  "peerDependencies": {
+    "react": ">=17.0.0",
+    "vue": ">=3.0.0"
+  },
+  "peerDependenciesMeta": {
+    "react": {
+      "optional": true
+    },
+    "vue": {
+      "optional": true
+    }
+  }
+}