payload-dynamic-forms 0.0.0-stage → 0.1.0

package/dist/shared/answers.js

@@ -0,0 +1,282 @@
+import { getFieldLabel, getInputFields, getOptions, getSectionKey, hasAnswer, isChoiceBlock, toStringList } from './rules.js';
+import { getVisibility } from './steps.js';
+import { interpolate } from './tokens.js';
+import { fillWords } from './words.js';
+const TRUE_WORDS = [
+    '1',
+    'on',
+    'true',
+    'yes'
+];
+/** Default limits for file-upload fields. */ export const DEFAULT_FILE_LIMITS = {
+    maxFileSize: 10 * 1024 * 1024,
+    maxTotalSize: 25 * 1024 * 1024,
+    mimeTypes: [
+        'application/pdf',
+        'image/jpeg',
+        'image/png',
+        'image/webp',
+        'text/plain',
+        'text/csv',
+        'application/msword',
+        'application/vnd.openxmlformats-officedocument.wordprocessingml.document'
+    ]
+};
+/** One valid address: no spaces, commas or lists, a dot in the domain. */ export function isValidEmail(value) {
+    if (typeof value !== 'string') {
+        return false;
+    }
+    return /^[^\s@,;<>()"'[\]\\]+@[A-Z0-9](?:[A-Z0-9-]*[A-Z0-9])?(?:\.[A-Z0-9](?:[A-Z0-9-]*[A-Z0-9])?)+$/i.test(value.trim());
+}
+const DATE = /^\d{4}-\d{2}-\d{2}$/;
+function isValidDate(value) {
+    if (!DATE.test(value)) {
+        return false;
+    }
+    const time = Date.parse(`${value}T00:00:00Z`);
+    return !Number.isNaN(time) && new Date(time).toISOString().slice(0, 10) === value;
+}
+function first(raw) {
+    return Array.isArray(raw) ? raw[0] : raw;
+}
+/** Turns a raw answer (form data or JSON) into the value the field type keeps. */ export function normalizeAnswer(field, raw, fieldTypes) {
+    const custom = fieldTypes?.[field.blockType]?.normalize;
+    if (custom) {
+        return custom(raw, field);
+    }
+    switch(field.blockType){
+        case 'checkbox':
+            {
+                const v = first(raw);
+                if (typeof v === 'boolean') {
+                    return v;
+                }
+                return TRUE_WORDS.includes(String(v ?? '').trim().toLowerCase());
+            }
+        case 'checkboxGroup':
+            return toStringList(raw);
+        case 'number':
+            {
+                const v = first(raw);
+                if (typeof v === 'number') {
+                    return Number.isFinite(v) ? v : String(v);
+                }
+                const text = String(v ?? '').trim();
+                if (!text) {
+                    return '';
+                }
+                const n = Number(text);
+                return Number.isFinite(n) ? n : text;
+            }
+        default:
+            {
+                const v = first(raw);
+                if (v === null || v === undefined) {
+                    return '';
+                }
+                return typeof v === 'object' ? '' : String(v).trim();
+            }
+    }
+}
+/**
+ * The text of an answer in messages and snapshots: option labels, file names, and the form's
+ * `yes` / `no` words for a checkbox (pass `fillWords(form.wording)` or the public form's wording).
+ */ export function answerToText(field, value, words, fieldTypes) {
+    const custom = fieldTypes?.[field.blockType]?.toText;
+    if (custom) {
+        return custom(value, field, words);
+    }
+    if (value === null || value === undefined) {
+        return '';
+    }
+    if (typeof value === 'boolean') {
+        return value ? words.yes : words.no;
+    }
+    if (typeof value === 'object' && !Array.isArray(value)) {
+        return Array.isArray(value.filenames) ? value.filenames.join(', ') : '';
+    }
+    if (isChoiceBlock(field)) {
+        const options = getOptions(field);
+        return toStringList(value).map((v)=>options.find((o)=>String(o.value) === v)?.label || v).join(', ');
+    }
+    if (Array.isArray(value)) {
+        return value.join(', ');
+    }
+    return String(value);
+}
+function checkValue(field, value) {
+    switch(field.blockType){
+        case 'checkboxGroup':
+            {
+                const listed = new Set(getOptions(field).map((o)=>String(o.value)));
+                return toStringList(value).every((v)=>listed.has(v)) ? null : 'invalid';
+            }
+        case 'date':
+            {
+                const text = String(value);
+                if (!isValidDate(text)) {
+                    return 'invalid';
+                }
+                const min = field.minDate?.slice(0, 10);
+                const max = field.maxDate?.slice(0, 10);
+                if (min && text < min || max && text > max) {
+                    return 'invalid';
+                }
+                return null;
+            }
+        case 'email':
+            return isValidEmail(value) ? null : 'invalid';
+        case 'number':
+            {
+                if (typeof value !== 'number' || !Number.isFinite(value)) {
+                    return 'invalid';
+                }
+                if (typeof field.min === 'number' && value < field.min) {
+                    return 'invalid';
+                }
+                if (typeof field.max === 'number' && value > field.max) {
+                    return 'invalid';
+                }
+                return null;
+            }
+        case 'radio':
+        case 'select':
+            {
+                const listed = new Set(getOptions(field).map((o)=>String(o.value)));
+                return listed.has(String(value)) ? null : 'invalid';
+            }
+        case 'text':
+        case 'textarea':
+            {
+                const length = [
+                    ...String(value)
+                ].length;
+                if (typeof field.minLength === 'number' && field.minLength > 0 && length < field.minLength) {
+                    return 'invalid';
+                }
+                if (typeof field.maxLength === 'number' && field.maxLength > 0 && length > field.maxLength) {
+                    return 'invalid';
+                }
+                return null;
+            }
+        default:
+            return null;
+    }
+}
+/** Checks the files given to one upload field: count, MIME type and size. */ export function checkFiles(field, files, limits = {}) {
+    const maxFiles = Math.max(1, Number(field.maxFiles) || 1);
+    if (files.length > maxFiles) {
+        return false;
+    }
+    const pluginTypes = limits.mimeTypes || DEFAULT_FILE_LIMITS.mimeTypes;
+    const fieldTypes = (field.mimeTypes || []).filter((t)=>pluginTypes.includes(t));
+    const allowed = fieldTypes.length ? fieldTypes : pluginTypes;
+    const pluginMax = limits.maxFileSize ?? DEFAULT_FILE_LIMITS.maxFileSize;
+    const fieldMax = Number(field.maxFileSizeMB) > 0 ? Number(field.maxFileSizeMB) * 1024 * 1024 : pluginMax;
+    const maxSize = Math.min(fieldMax, pluginMax);
+    return files.every((file)=>allowed.includes(file.type || 'application/octet-stream') && file.size <= maxSize && file.size > 0);
+}
+function errorWords(field, key, problem, words) {
+    const label = getFieldLabel(field, key);
+    if (problem === 'empty') {
+        return field.words?.errorEmpty?.trim() || interpolate(words.required, {
+            label
+        });
+    }
+    if (field.words?.errorInvalid?.trim()) {
+        return field.words.errorInvalid.trim();
+    }
+    return interpolate(problem === 'file' ? words.fileRejected : words.invalid, {
+        label
+    });
+}
+/**
+ * Normalises raw answers, drops hidden ones (and, in steps, those of sections off the path), and
+ * reports a field error for every shown field that is required and empty or has a bad value.
+ */ export function checkAnswers(form, raw, options = {}) {
+    const words = options.words || fillWords(form.wording);
+    const files = options.files || {};
+    const normalized = {};
+    for (const { field, key } of getInputFields(form)){
+        if (field.blockType === 'fileUpload') {
+            normalized[key] = (files[key] || []).map((f)=>f.name || 'upload');
+            continue;
+        }
+        normalized[key] = normalizeAnswer(field, raw[key], options.fieldTypes);
+    }
+    const visibility = getVisibility(form, normalized);
+    const answers = {};
+    const fieldErrors = {};
+    const fileKeys = [];
+    let totalSize = 0;
+    const maxTotal = options.limits?.maxTotalSize ?? DEFAULT_FILE_LIMITS.maxTotalSize;
+    for (const { field, key } of getInputFields(form)){
+        if (!visibility.fieldKeys.has(key) || fieldErrors[key]) {
+            continue;
+        }
+        if (field.blockType === 'fileUpload') {
+            const given = files[key] || [];
+            if (!given.length) {
+                if (field.required) {
+                    fieldErrors[key] = errorWords(field, key, 'empty', words);
+                }
+                continue;
+            }
+            fileKeys.push(key);
+            totalSize += given.reduce((sum, f)=>sum + f.size, 0);
+            if (!checkFiles(field, given, options.limits) || totalSize > maxTotal) {
+                fieldErrors[key] = errorWords(field, key, 'file', words);
+            }
+            continue;
+        }
+        const value = normalized[key];
+        answers[key] = value;
+        const given = hasAnswer(value);
+        if (!given) {
+            if (field.required) {
+                fieldErrors[key] = errorWords(field, key, 'empty', words);
+            }
+            continue;
+        }
+        const custom = options.fieldTypes?.[field.blockType]?.validate;
+        if (custom) {
+            const result = custom(value, {
+                answers: normalized,
+                field
+            });
+            if (result !== true) {
+                fieldErrors[key] = typeof result === 'string' && result ? result : errorWords(field, key, 'invalid', words);
+                continue;
+            }
+        }
+        const problem = checkValue(field, value);
+        if (problem) {
+            fieldErrors[key] = errorWords(field, key, problem, words);
+        }
+    }
+    return {
+        answers,
+        fieldErrors,
+        fileKeys,
+        ok: Object.keys(fieldErrors).length === 0
+    };
+}
+/** Section title, label and value per answered, shown field, as worded now. */ export function buildSnapshot(form, answers, fieldTypes) {
+    const words = fillWords(form.wording);
+    const rows = [];
+    for (const { field, key, section } of getInputFields(form)){
+        if (!(key in answers) || !hasAnswer(answers[key])) {
+            continue;
+        }
+        rows.push({
+            fieldKey: key,
+            label: getFieldLabel(field, key),
+            sectionKey: getSectionKey(section),
+            sectionTitle: section.title?.trim() || getSectionKey(section),
+            value: answerToText(field, answers[key], words, fieldTypes)
+        });
+    }
+    return rows;
+}
+
+//# sourceMappingURL=answers.js.map

package/dist/shared/answers.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/shared/answers.ts"],"sourcesContent":["import type {\n  Answers,\n  AnswerValue,\n  FieldTypeChecks,\n  FileLike,\n  FormLike,\n  FormWords,\n  InputBlock,\n  SnapshotRow,\n  YesNoWords,\n} from './types.js'\n\nimport {\n  getFieldLabel,\n  getInputFields,\n  getOptions,\n  getSectionKey,\n  hasAnswer,\n  isChoiceBlock,\n  toStringList,\n} from './rules.js'\nimport { getVisibility } from './steps.js'\nimport { interpolate } from './tokens.js'\nimport { fillWords } from './words.js'\n\nconst TRUE_WORDS = ['1', 'on', 'true', 'yes']\n\n/** Default limits for file-upload fields. */\nexport const DEFAULT_FILE_LIMITS = {\n  maxFileSize: 10 * 1024 * 1024,\n  maxTotalSize: 25 * 1024 * 1024,\n  mimeTypes: [\n    'application/pdf',\n    'image/jpeg',\n    'image/png',\n    'image/webp',\n    'text/plain',\n    'text/csv',\n    'application/msword',\n    'application/vnd.openxmlformats-officedocument.wordprocessingml.document',\n  ],\n} as const\n\nexport type FileLimits = {\n  maxFileSize?: number\n  maxTotalSize?: number\n  mimeTypes?: readonly string[]\n}\n\n/** One valid address: no spaces, commas or lists, a dot in the domain. */\nexport function isValidEmail(value: unknown): boolean {\n  if (typeof value !== 'string') {\n    return false\n  }\n  return /^[^\\s@,;<>()\"'[\\]\\\\]+@[A-Z0-9](?:[A-Z0-9-]*[A-Z0-9])?(?:\\.[A-Z0-9](?:[A-Z0-9-]*[A-Z0-9])?)+$/i.test(\n    value.trim(),\n  )\n}\n\nconst DATE = /^\\d{4}-\\d{2}-\\d{2}$/\n\nfunction isValidDate(value: string): boolean {\n  if (!DATE.test(value)) {\n    return false\n  }\n  const time = Date.parse(`${value}T00:00:00Z`)\n  return !Number.isNaN(time) && new Date(time).toISOString().slice(0, 10) === value\n}\n\nfunction first(raw: unknown): unknown {\n  return Array.isArray(raw) ? raw[0] : raw\n}\n\n/** Turns a raw answer (form data or JSON) into the value the field type keeps. */\nexport function normalizeAnswer(\n  field: InputBlock,\n  raw: unknown,\n  fieldTypes?: Record<string, FieldTypeChecks>,\n): AnswerValue {\n  const custom = fieldTypes?.[field.blockType]?.normalize\n  if (custom) {\n    return custom(raw, field)\n  }\n  switch (field.blockType) {\n    case 'checkbox': {\n      const v = first(raw)\n      if (typeof v === 'boolean') {\n        return v\n      }\n      return TRUE_WORDS.includes(String(v ?? '').trim().toLowerCase())\n    }\n    case 'checkboxGroup':\n      return toStringList(raw)\n    case 'number': {\n      const v = first(raw)\n      if (typeof v === 'number') {\n        return Number.isFinite(v) ? v : String(v)\n      }\n      const text = String(v ?? '').trim()\n      if (!text) {\n        return ''\n      }\n      const n = Number(text)\n      return Number.isFinite(n) ? n : text\n    }\n    default: {\n      const v = first(raw)\n      if (v === null || v === undefined) {\n        return ''\n      }\n      return typeof v === 'object' ? '' : String(v).trim()\n    }\n  }\n}\n\n/**\n * The text of an answer in messages and snapshots: option labels, file names, and the form's\n * `yes` / `no` words for a checkbox (pass `fillWords(form.wording)` or the public form's wording).\n */\nexport function answerToText(\n  field: InputBlock,\n  value: AnswerValue,\n  words: YesNoWords,\n  fieldTypes?: Record<string, FieldTypeChecks>,\n): string {\n  const custom = fieldTypes?.[field.blockType]?.toText\n  if (custom) {\n    return custom(value, field, words)\n  }\n  if (value === null || value === undefined) {\n    return ''\n  }\n  if (typeof value === 'boolean') {\n    return value ? words.yes : words.no\n  }\n  if (typeof value === 'object' && !Array.isArray(value)) {\n    return Array.isArray(value.filenames) ? value.filenames.join(', ') : ''\n  }\n  if (isChoiceBlock(field)) {\n    const options = getOptions(field)\n    return toStringList(value)\n      .map((v) => options.find((o) => String(o.value) === v)?.label || v)\n      .join(', ')\n  }\n  if (Array.isArray(value)) {\n    return value.join(', ')\n  }\n  return String(value)\n}\n\ntype Problem = 'empty' | 'file' | 'invalid' | null\n\nfunction checkValue(field: InputBlock, value: AnswerValue): Problem {\n  switch (field.blockType) {\n    case 'checkboxGroup': {\n      const listed = new Set(getOptions(field).map((o) => String(o.value)))\n      return toStringList(value).every((v) => listed.has(v)) ? null : 'invalid'\n    }\n    case 'date': {\n      const text = String(value)\n      if (!isValidDate(text)) {\n        return 'invalid'\n      }\n      const min = field.minDate?.slice(0, 10)\n      const max = field.maxDate?.slice(0, 10)\n      if ((min && text < min) || (max && text > max)) {\n        return 'invalid'\n      }\n      return null\n    }\n    case 'email':\n      return isValidEmail(value) ? null : 'invalid'\n    case 'number': {\n      if (typeof value !== 'number' || !Number.isFinite(value)) {\n        return 'invalid'\n      }\n      if (typeof field.min === 'number' && value < field.min) {\n        return 'invalid'\n      }\n      if (typeof field.max === 'number' && value > field.max) {\n        return 'invalid'\n      }\n      return null\n    }\n    case 'radio':\n    case 'select': {\n      const listed = new Set(getOptions(field).map((o) => String(o.value)))\n      return listed.has(String(value)) ? null : 'invalid'\n    }\n    case 'text':\n    case 'textarea': {\n      const length = [...String(value)].length\n      if (typeof field.minLength === 'number' && field.minLength > 0 && length < field.minLength) {\n        return 'invalid'\n      }\n      if (typeof field.maxLength === 'number' && field.maxLength > 0 && length > field.maxLength) {\n        return 'invalid'\n      }\n      return null\n    }\n    default:\n      return null\n  }\n}\n\n/** Checks the files given to one upload field: count, MIME type and size. */\nexport function checkFiles(field: InputBlock, files: FileLike[], limits: FileLimits = {}): boolean {\n  const maxFiles = Math.max(1, Number(field.maxFiles) || 1)\n  if (files.length > maxFiles) {\n    return false\n  }\n  const pluginTypes = limits.mimeTypes || DEFAULT_FILE_LIMITS.mimeTypes\n  const fieldTypes = (field.mimeTypes || []).filter((t) => pluginTypes.includes(t))\n  const allowed = fieldTypes.length ? fieldTypes : pluginTypes\n  const pluginMax = limits.maxFileSize ?? DEFAULT_FILE_LIMITS.maxFileSize\n  const fieldMax = Number(field.maxFileSizeMB) > 0 ? Number(field.maxFileSizeMB) * 1024 * 1024 : pluginMax\n  const maxSize = Math.min(fieldMax, pluginMax)\n  return files.every(\n    (file) => allowed.includes(file.type || 'application/octet-stream') && file.size <= maxSize && file.size > 0,\n  )\n}\n\nexport type CheckOptions = {\n  /** Checks for app-registered field types. */\n  fieldTypes?: Record<string, FieldTypeChecks>\n  /** Files per upload field key. */\n  files?: Record<string, FileLike[]>\n  limits?: FileLimits\n  /** Form words; default: the form's wording filled from the defaults. */\n  words?: FormWords\n}\n\nexport type CheckResult = {\n  /** Shown answers only, normalised. Upload fields are left out (the server adds them). */\n  answers: Answers\n  fieldErrors: Record<string, string>\n  /** Keys of shown upload fields that got files. */\n  fileKeys: string[]\n  ok: boolean\n}\n\nfunction errorWords(field: InputBlock, key: string, problem: Exclude<Problem, null>, words: FormWords): string {\n  const label = getFieldLabel(field, key)\n  if (problem === 'empty') {\n    return field.words?.errorEmpty?.trim() || interpolate(words.required, { label })\n  }\n  if (field.words?.errorInvalid?.trim()) {\n    return field.words.errorInvalid.trim()\n  }\n  return interpolate(problem === 'file' ? words.fileRejected : words.invalid, { label })\n}\n\n/**\n * Normalises raw answers, drops hidden ones (and, in steps, those of sections off the path), and\n * reports a field error for every shown field that is required and empty or has a bad value.\n */\nexport function checkAnswers(form: FormLike, raw: Record<string, unknown>, options: CheckOptions = {}): CheckResult {\n  const words = options.words || fillWords(form.wording)\n  const files = options.files || {}\n  const normalized: Answers = {}\n  for (const { field, key } of getInputFields(form)) {\n    if (field.blockType === 'fileUpload') {\n      normalized[key] = (files[key] || []).map((f) => f.name || 'upload')\n      continue\n    }\n    normalized[key] = normalizeAnswer(field, raw[key], options.fieldTypes)\n  }\n  const visibility = getVisibility(form, normalized)\n  const answers: Answers = {}\n  const fieldErrors: Record<string, string> = {}\n  const fileKeys: string[] = []\n  let totalSize = 0\n  const maxTotal = options.limits?.maxTotalSize ?? DEFAULT_FILE_LIMITS.maxTotalSize\n\n  for (const { field, key } of getInputFields(form)) {\n    if (!visibility.fieldKeys.has(key) || fieldErrors[key]) {\n      continue\n    }\n    if (field.blockType === 'fileUpload') {\n      const given = files[key] || []\n      if (!given.length) {\n        if (field.required) {\n          fieldErrors[key] = errorWords(field, key, 'empty', words)\n        }\n        continue\n      }\n      fileKeys.push(key)\n      totalSize += given.reduce((sum, f) => sum + f.size, 0)\n      if (!checkFiles(field, given, options.limits) || totalSize > maxTotal) {\n        fieldErrors[key] = errorWords(field, key, 'file', words)\n      }\n      continue\n    }\n    const value = normalized[key]!\n    answers[key] = value\n    const given = hasAnswer(value)\n    if (!given) {\n      if (field.required) {\n        fieldErrors[key] = errorWords(field, key, 'empty', words)\n      }\n      continue\n    }\n    const custom = options.fieldTypes?.[field.blockType]?.validate\n    if (custom) {\n      const result = custom(value, { answers: normalized, field })\n      if (result !== true) {\n        fieldErrors[key] = typeof result === 'string' && result ? result : errorWords(field, key, 'invalid', words)\n        continue\n      }\n    }\n    const problem = checkValue(field, value)\n    if (problem) {\n      fieldErrors[key] = errorWords(field, key, problem, words)\n    }\n  }\n  return { answers, fieldErrors, fileKeys, ok: Object.keys(fieldErrors).length === 0 }\n}\n\n/** Section title, label and value per answered, shown field, as worded now. */\nexport function buildSnapshot(\n  form: FormLike,\n  answers: Answers,\n  fieldTypes?: Record<string, FieldTypeChecks>,\n): SnapshotRow[] {\n  const words = fillWords(form.wording)\n  const rows: SnapshotRow[] = []\n  for (const { field, key, section } of getInputFields(form)) {\n    if (!(key in answers) || !hasAnswer(answers[key])) {\n      continue\n    }\n    rows.push({\n      fieldKey: key,\n      label: getFieldLabel(field, key),\n      sectionKey: getSectionKey(section),\n      sectionTitle: section.title?.trim() || getSectionKey(section),\n      value: answerToText(field, answers[key], words, fieldTypes),\n    })\n  }\n  return rows\n}\n"],"names":["getFieldLabel","getInputFields","getOptions","getSectionKey","hasAnswer","isChoiceBlock","toStringList","getVisibility","interpolate","fillWords","TRUE_WORDS","DEFAULT_FILE_LIMITS","maxFileSize","maxTotalSize","mimeTypes","isValidEmail","value","test","trim","DATE","isValidDate","time","Date","parse","Number","isNaN","toISOString","slice","first","raw","Array","isArray","normalizeAnswer","field","fieldTypes","custom","blockType","normalize","v","includes","String","toLowerCase","isFinite","text","n","undefined","answerToText","words","toText","yes","no","filenames","join","options","map","find","o","label","checkValue","listed","Set","every","has","min","minDate","max","maxDate","length","minLength","maxLength","checkFiles","files","limits","maxFiles","Math","pluginTypes","filter","t","allowed","pluginMax","fieldMax","maxFileSizeMB","maxSize","file","type","size","errorWords","key","problem","errorEmpty","required","errorInvalid","fileRejected","invalid","checkAnswers","form","wording","normalized","f","name","visibility","answers","fieldErrors","fileKeys","totalSize","maxTotal","fieldKeys","given","push","reduce","sum","validate","result","ok","Object","keys","buildSnapshot","rows","section","fieldKey","sectionKey","sectionTitle","title"],"mappings":"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"}

package/dist/shared/operators.d.ts

@@ -0,0 +1,41 @@
+/**
+ * The one list of rule operators. Every rule field in the forms collection uses this array,
+ * and the rule engine handles exactly these values.
+ */
+export declare const OPERATORS: readonly [{
+    readonly label: "Equals";
+    readonly value: "equals";
+}, {
+    readonly label: "Does not equal";
+    readonly value: "notEquals";
+}, {
+    readonly label: "Contains";
+    readonly value: "contains";
+}, {
+    readonly label: "Does not contain";
+    readonly value: "notContains";
+}, {
+    readonly label: "Has a value";
+    readonly value: "hasValue";
+}, {
+    readonly label: "Has no value";
+    readonly value: "notHasValue";
+}, {
+    readonly label: "Greater than";
+    readonly value: "greaterThan";
+}, {
+    readonly label: "Less than";
+    readonly value: "lessThan";
+}, {
+    readonly label: "Includes option";
+    readonly value: "includesOption";
+}];
+export type OperatorValue = (typeof OPERATORS)[number]['value'];
+export declare const OPERATOR_VALUES: readonly OperatorValue[];
+export declare const MATCH_MODES: readonly [{
+    readonly label: "All rules must match";
+    readonly value: "all";
+}, {
+    readonly label: "Any rule can match";
+    readonly value: "any";
+}];

package/dist/shared/operators.js

@@ -0,0 +1,54 @@
+/**
+ * The one list of rule operators. Every rule field in the forms collection uses this array,
+ * and the rule engine handles exactly these values.
+ */ export const OPERATORS = [
+    {
+        label: 'Equals',
+        value: 'equals'
+    },
+    {
+        label: 'Does not equal',
+        value: 'notEquals'
+    },
+    {
+        label: 'Contains',
+        value: 'contains'
+    },
+    {
+        label: 'Does not contain',
+        value: 'notContains'
+    },
+    {
+        label: 'Has a value',
+        value: 'hasValue'
+    },
+    {
+        label: 'Has no value',
+        value: 'notHasValue'
+    },
+    {
+        label: 'Greater than',
+        value: 'greaterThan'
+    },
+    {
+        label: 'Less than',
+        value: 'lessThan'
+    },
+    {
+        label: 'Includes option',
+        value: 'includesOption'
+    }
+];
+export const OPERATOR_VALUES = OPERATORS.map((o)=>o.value);
+export const MATCH_MODES = [
+    {
+        label: 'All rules must match',
+        value: 'all'
+    },
+    {
+        label: 'Any rule can match',
+        value: 'any'
+    }
+];
+
+//# sourceMappingURL=operators.js.map

package/dist/shared/operators.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/shared/operators.ts"],"sourcesContent":["/**\n * The one list of rule operators. Every rule field in the forms collection uses this array,\n * and the rule engine handles exactly these values.\n */\nexport const OPERATORS = [\n  { label: 'Equals', value: 'equals' },\n  { label: 'Does not equal', value: 'notEquals' },\n  { label: 'Contains', value: 'contains' },\n  { label: 'Does not contain', value: 'notContains' },\n  { label: 'Has a value', value: 'hasValue' },\n  { label: 'Has no value', value: 'notHasValue' },\n  { label: 'Greater than', value: 'greaterThan' },\n  { label: 'Less than', value: 'lessThan' },\n  { label: 'Includes option', value: 'includesOption' },\n] as const satisfies ReadonlyArray<{ label: string; value: string }>\n\nexport type OperatorValue = (typeof OPERATORS)[number]['value']\n\nexport const OPERATOR_VALUES: readonly OperatorValue[] = OPERATORS.map((o) => o.value)\n\nexport const MATCH_MODES = [\n  { label: 'All rules must match', value: 'all' },\n  { label: 'Any rule can match', value: 'any' },\n] as const\n"],"names":["OPERATORS","label","value","OPERATOR_VALUES","map","o","MATCH_MODES"],"mappings":"AAAA;;;CAGC,GACD,OAAO,MAAMA,YAAY;IACvB;QAAEC,OAAO;QAAUC,OAAO;IAAS;IACnC;QAAED,OAAO;QAAkBC,OAAO;IAAY;IAC9C;QAAED,OAAO;QAAYC,OAAO;IAAW;IACvC;QAAED,OAAO;QAAoBC,OAAO;IAAc;IAClD;QAAED,OAAO;QAAeC,OAAO;IAAW;IAC1C;QAAED,OAAO;QAAgBC,OAAO;IAAc;IAC9C;QAAED,OAAO;QAAgBC,OAAO;IAAc;IAC9C;QAAED,OAAO;QAAaC,OAAO;IAAW;IACxC;QAAED,OAAO;QAAmBC,OAAO;IAAiB;CACrD,CAAmE;AAIpE,OAAO,MAAMC,kBAA4CH,UAAUI,GAAG,CAAC,CAACC,IAAMA,EAAEH,KAAK,EAAC;AAEtF,OAAO,MAAMI,cAAc;IACzB;QAAEL,OAAO;QAAwBC,OAAO;IAAM;IAC9C;QAAED,OAAO;QAAsBC,OAAO;IAAM;CAC7C,CAAS"}

package/dist/shared/rules.d.ts

@@ -0,0 +1,58 @@
+import type { Answers, AnswerValue, ChoiceOption, FieldBlock, FormLike, FormSection, InputBlock, RuleGroup, RuleRow } from './types.js';
+/** Lower-case kebab-case: ` Project Type ` → `project-type`. */
+export declare function normalizeKey(value: unknown): string;
+/**
+ * Splits a rule key into the field key and an optional option attribute:
+ * `Need.fieldSet` → `{ key: 'need', attribute: 'fieldSet' }`. The attribute keeps its case.
+ */
+export declare function splitRuleKey(value: unknown): {
+    attribute?: string;
+    key: string;
+};
+export declare const DISPLAY_BLOCK_TYPES: readonly string[];
+export declare const CHOICE_BLOCK_TYPES: readonly string[];
+export declare function isInputBlock(block: FieldBlock | null | undefined): block is InputBlock;
+export declare function isChoiceBlock(block: FieldBlock | null | undefined): boolean;
+export declare function getFieldKey(block: FieldBlock | null | undefined): string;
+export declare function getSectionKey(section: FormSection | null | undefined): string;
+export declare function getSections(form: FormLike): FormSection[];
+export type InputEntry = {
+    field: InputBlock;
+    key: string;
+    section: FormSection;
+};
+/** Every input of the form in order, with its normalised key. */
+export declare function getInputFields(form: FormLike): InputEntry[];
+export declare function getInputFieldMap(form: FormLike): Map<string, InputEntry>;
+export declare function getFieldLabel(field: InputBlock, key?: string): string;
+export declare function getRowLabel(field: InputBlock, key?: string): string;
+/** True when an answer counts as given: `false` and empty strings, lists and objects don't. */
+export declare function hasAnswer(value: unknown): boolean;
+export declare function toStringList(value: unknown): string[];
+/** The options a choice field offers (typed, or resolved from a source by the server). */
+export declare function getOptions(field: InputBlock | undefined): ChoiceOption[];
+/**
+ * The value a rule row reads: the answer, or for `<key>.<attribute>` the attribute of the
+ * chosen option(s) of that field.
+ */
+export declare function readRuleValue(ruleKey: unknown, answers: Answers, form?: FormLike): unknown;
+export declare function evaluateRow(row: null | RuleRow | undefined, answers: Answers, form?: FormLike): boolean;
+/** A group matches when all rows match (`all`, default) or any row does (`any`); empty matches. */
+export declare function evaluateRules(group: null | RuleGroup | undefined, answers: Answers, form?: FormLike): boolean;
+export declare function isSectionVisible(section: FormSection, answers: Answers, form?: FormLike): boolean;
+/** A field is shown when its section is shown and its own rules match. */
+export declare function isFieldVisible(section: FormSection, field: FieldBlock, answers: Answers, form?: FormLike): boolean;
+export declare function getVisibleSections(form: FormLike, answers: Answers): FormSection[];
+type SearchParamsLike = {
+    get(name: string): null | string;
+    getAll?(name: string): string[];
+} | Record<string, string | string[] | undefined> | string | URLSearchParams;
+/** The starting answer of a field from its default value. */
+export declare function defaultAnswer(field: InputBlock): AnswerValue;
+/**
+ * Starting answers for a renderer: each input's default, or the value of its link parameter
+ * when the app passes the page's search parameters. Choice fields take the parameter only when
+ * it is one of their options.
+ */
+export declare function initialAnswers(form: FormLike, searchParams?: SearchParamsLike): Answers;
+export {};