@open-mercato/core 0.8.1-develop.7296.1.2111d779db → 0.9.0

package/dist/modules/forms/schema/field-type-registry.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../src/modules/forms/schema/field-type-registry.ts"],
+  "sourcesContent": ["import { createHash } from 'node:crypto'\nimport type { ComponentType } from 'react'\nimport { testLinearRegex } from '@open-mercato/shared/lib/regex/linear'\nimport { FIELD_TYPE_DEFAULT_PATTERNS } from './field-type-patterns'\nimport { FILE_TYPE } from './file-field'\nimport { SIGNATURE_TYPE } from './signature-field'\nimport { GROUP_TYPE } from './group-field'\n\n/**\n * FieldTypeSpec \u2014 every field type the studio offers must register one entry.\n *\n * Required trio: `validator`, `defaultUiSchema`, `exportAdapter`. `renderer`\n * is intentionally nullable in phase 1a \u2014 phase 1d (FormRunner) populates it\n * via a separate `setRenderer(typeKey, component)` call so the registry shape\n * stays stable across phases.\n *\n * Visual builder metadata (`category`, `icon`, `displayNameKey`) is additive\n * (see `.ai/specs/2026-05-10-forms-visual-builder.md` Phase A). All three are\n * optional so prior registrations stay compatible; the studio applies sane\n * defaults (`category` \u2192 `'input'`, `icon` \u2192 fallback `'square'`).\n */\nexport type FieldTypeSpec = {\n  /**\n   * Validates a single field value against the field schema node. Returns\n   * `true` when the value is acceptable, or a human-readable error message\n   * string otherwise. The caller is responsible for short-circuiting `null` /\n   * `undefined` according to JSON Schema `required` semantics.\n   */\n  validator: (value: unknown, fieldNode: FieldNode) => true | string\n  /**\n   * React component that renders this field type. Always `null` in phase 1a\n   * \u2014 the renderer module (phase 1d) calls `registry.setRenderer(...)` at\n   * boot time to wire concrete components without forcing this package to\n   * depend on React at runtime.\n   */\n  renderer: ComponentType<unknown> | null\n  /** Default uiSchema fragment merged onto the field's stored uiSchema. */\n  defaultUiSchema: Record<string, unknown>\n  /**\n   * Stringifies a value for non-interactive surfaces (CSV export, PDF\n   * snapshot, audit trail). Must be deterministic and lossless for the\n   * scalar types; structured types (`select_many`) join with `, `.\n   *\n   * The optional `fieldNode` param lets registry-aware exporters consult\n   * field-level `x-om-*` keywords (e.g. `opinion_scale` reads `x-om-max` to\n   * render `\"<value>/<max>\"`). Callers that have no node available (the\n   * legacy contract) may omit it \u2014 adapters MUST tolerate `undefined`.\n   */\n  exportAdapter: (value: unknown, fieldNode?: FieldNode) => string\n  /**\n   * Studio palette grouping. `'input'` types submit a value; `'layout'`\n   * types are display-only (e.g. `info_block`). Defaults to `'input'`.\n   */\n  category?: 'input' | 'layout'\n  /** Lucide icon name shown in the studio palette card. */\n  icon?: string\n  /** i18n key for the studio palette display name. */\n  displayNameKey?: string\n}\n\n/**\n * Minimal shape of a JSON Schema property node enriched with OM extensions.\n * The compiler hands the full node to the validator so types like `scale`\n * can read `x-om-min` / `x-om-max` and `select_one` can consult\n * `x-om-options`.\n */\nexport type FieldNode = Record<string, unknown>\n\nconst requireString = (value: unknown): true | string =>\n  typeof value === 'string' ? true : 'Expected a string value.'\n\nconst requireFiniteNumber = (value: unknown): true | string =>\n  typeof value === 'number' && Number.isFinite(value) ? true : 'Expected a finite number.'\n\nconst optionValues = (fieldNode: FieldNode): string[] => {\n  const options = fieldNode['x-om-options']\n  if (!Array.isArray(options)) return []\n  return options\n    .map((entry) => (entry && typeof entry === 'object' ? (entry as Record<string, unknown>).value : null))\n    .filter((value): value is string => typeof value === 'string')\n}\n\nconst isIsoDate = (value: string): boolean => /^\\d{4}-\\d{2}-\\d{2}$/.test(value) && !Number.isNaN(Date.parse(value))\nconst isIsoDateTime = (value: string): boolean => !Number.isNaN(Date.parse(value))\n\n// ============================================================================\n// Built-in field type specs (v1)\n// ============================================================================\n\nexport const TEXT_TYPE: FieldTypeSpec = {\n  validator: (value) => (typeof value === 'string' ? true : 'Expected a string.'),\n  renderer: null,\n  defaultUiSchema: { widget: 'text' },\n  exportAdapter: (value) => (typeof value === 'string' ? value : ''),\n  category: 'input',\n  icon: 'type',\n  displayNameKey: 'forms.studio.palette.input.text',\n}\n\nexport const TEXTAREA_TYPE: FieldTypeSpec = {\n  validator: (value) => (typeof value === 'string' ? true : 'Expected a multi-line string.'),\n  renderer: null,\n  defaultUiSchema: { widget: 'textarea', rows: 4 },\n  exportAdapter: (value) => (typeof value === 'string' ? value : ''),\n  category: 'input',\n  icon: 'align-left',\n  displayNameKey: 'forms.studio.palette.input.textarea',\n}\n\nexport const NUMBER_TYPE: FieldTypeSpec = {\n  validator: (value, fieldNode) => {\n    if (!(typeof value === 'number' && Number.isFinite(value))) return 'Expected a finite number.'\n    const min = fieldNode['x-om-min']\n    const max = fieldNode['x-om-max']\n    if (typeof min === 'number' && value < min) return `Value must be >= ${min}.`\n    if (typeof max === 'number' && value > max) return `Value must be <= ${max}.`\n    return true\n  },\n  renderer: null,\n  defaultUiSchema: { widget: 'number' },\n  exportAdapter: (value) => (typeof value === 'number' && Number.isFinite(value) ? String(value) : ''),\n  category: 'input',\n  icon: 'hash',\n  displayNameKey: 'forms.studio.palette.input.number',\n}\n\nexport const INTEGER_TYPE: FieldTypeSpec = {\n  validator: (value, fieldNode) => {\n    if (!(typeof value === 'number' && Number.isInteger(value))) return 'Expected an integer.'\n    const min = fieldNode['x-om-min']\n    const max = fieldNode['x-om-max']\n    if (typeof min === 'number' && value < min) return `Value must be >= ${min}.`\n    if (typeof max === 'number' && value > max) return `Value must be <= ${max}.`\n    return true\n  },\n  renderer: null,\n  defaultUiSchema: { widget: 'integer' },\n  exportAdapter: (value) => (typeof value === 'number' && Number.isInteger(value) ? String(value) : ''),\n  category: 'input',\n  icon: 'hash',\n  displayNameKey: 'forms.studio.palette.input.integer',\n}\n\nexport const BOOLEAN_TYPE: FieldTypeSpec = {\n  validator: (value) => (typeof value === 'boolean' ? true : 'Expected true or false.'),\n  renderer: null,\n  defaultUiSchema: { widget: 'checkbox' },\n  exportAdapter: (value) => (value === true ? 'Yes' : value === false ? 'No' : ''),\n  category: 'input',\n  icon: 'check-square',\n  displayNameKey: 'forms.studio.palette.input.boolean',\n}\n\nexport const YES_NO_TYPE: FieldTypeSpec = {\n  validator: (value) => (typeof value === 'boolean' ? true : 'Expected true or false.'),\n  renderer: null,\n  defaultUiSchema: { widget: 'yes_no' },\n  exportAdapter: (value) => (value === true ? 'Yes' : value === false ? 'No' : ''),\n  category: 'input',\n  icon: 'toggle-left',\n  displayNameKey: 'forms.studio.palette.input.yesNo',\n}\n\n// Same boolean payload as YES_NO_TYPE; differs only in widget hint + palette\n// presentation. The renderer (registered separately) is a two-button row\n// instead of a slider toggle, for forms where the binary choice should read\n// as 'pick one of two' rather than 'toggle on/off'.\nexport const YES_NO_BUTTONS_TYPE: FieldTypeSpec = {\n  validator: (value) => (typeof value === 'boolean' ? true : 'Expected true or false.'),\n  renderer: null,\n  defaultUiSchema: { widget: 'yes_no_buttons' },\n  exportAdapter: (value) => (value === true ? 'Yes' : value === false ? 'No' : ''),\n  category: 'input',\n  icon: 'toggle-right',\n  displayNameKey: 'forms.studio.palette.input.yesNoButtons',\n}\n\nexport const DATE_TYPE: FieldTypeSpec = {\n  validator: (value) => {\n    if (typeof value !== 'string') return 'Expected an ISO date string (YYYY-MM-DD).'\n    return isIsoDate(value) ? true : 'Expected an ISO date string (YYYY-MM-DD).'\n  },\n  renderer: null,\n  defaultUiSchema: { widget: 'date' },\n  exportAdapter: (value) => (typeof value === 'string' ? value : ''),\n  category: 'input',\n  icon: 'calendar',\n  displayNameKey: 'forms.studio.palette.input.date',\n}\n\nexport const DATETIME_TYPE: FieldTypeSpec = {\n  validator: (value) => {\n    if (typeof value !== 'string') return 'Expected an ISO datetime string.'\n    return isIsoDateTime(value) ? true : 'Expected a parseable ISO datetime.'\n  },\n  renderer: null,\n  defaultUiSchema: { widget: 'datetime' },\n  exportAdapter: (value) => (typeof value === 'string' ? value : ''),\n  category: 'input',\n  icon: 'calendar-clock',\n  displayNameKey: 'forms.studio.palette.input.datetime',\n}\n\nexport const SELECT_ONE_TYPE: FieldTypeSpec = {\n  validator: (value, fieldNode) => {\n    const result = requireString(value)\n    if (result !== true) return result\n    const allowed = optionValues(fieldNode)\n    if (allowed.length === 0) return true\n    return allowed.includes(value as string) ? true : `Value must be one of: ${allowed.join(', ')}.`\n  },\n  renderer: null,\n  defaultUiSchema: { widget: 'select' },\n  exportAdapter: (value) => (typeof value === 'string' ? value : ''),\n  category: 'input',\n  icon: 'list',\n  displayNameKey: 'forms.studio.palette.input.selectOne',\n}\n\nexport const SELECT_MANY_TYPE: FieldTypeSpec = {\n  validator: (value, fieldNode) => {\n    if (!Array.isArray(value)) return 'Expected an array of selected values.'\n    const allowed = optionValues(fieldNode)\n    for (const entry of value) {\n      if (typeof entry !== 'string') return 'Each selected value must be a string.'\n      if (allowed.length > 0 && !allowed.includes(entry)) {\n        return `Each selected value must be one of: ${allowed.join(', ')}.`\n      }\n    }\n    return true\n  },\n  renderer: null,\n  defaultUiSchema: { widget: 'multiselect' },\n  exportAdapter: (value) => (Array.isArray(value) ? value.filter((entry) => typeof entry === 'string').join(', ') : ''),\n  category: 'input',\n  icon: 'list-checks',\n  displayNameKey: 'forms.studio.palette.input.selectMany',\n}\n\nexport const SCALE_TYPE: FieldTypeSpec = {\n  validator: (value, fieldNode) => {\n    const result = requireFiniteNumber(value)\n    if (result !== true) return result\n    if (!Number.isInteger(value as number)) return 'Scale value must be an integer.'\n    const min = typeof fieldNode['x-om-min'] === 'number' ? (fieldNode['x-om-min'] as number) : 0\n    const max = typeof fieldNode['x-om-max'] === 'number' ? (fieldNode['x-om-max'] as number) : 10\n    if (min > max) return `Scale bounds invalid: min (${min}) must be <= max (${max}).`\n    if ((value as number) < min || (value as number) > max) {\n      return `Value must be between ${min} and ${max} (inclusive).`\n    }\n    return true\n  },\n  renderer: null,\n  defaultUiSchema: { widget: 'scale' },\n  exportAdapter: (value) => (typeof value === 'number' ? String(value) : ''),\n  category: 'input',\n  icon: 'sliders-horizontal',\n  displayNameKey: 'forms.studio.palette.input.scale',\n}\n\n// ----------------------------------------------------------------------------\n// Tier-2 format-typed inputs (Phase B of\n// `.ai/specs/2026-05-14-forms-tier-2-question-palette.md`).\n//\n// Email / Phone / Website share the same shape: a JSON-string value that must\n// match the configured pattern (default from `FIELD_TYPE_DEFAULT_PATTERNS`,\n// overridable per-field via `x-om-pattern`). Empty strings pass \u2014 required-ness\n// is enforced by JSON-Schema `required`, never by the field validator.\n// ----------------------------------------------------------------------------\n\nfunction makeFormatValidator(\n  format: 'email' | 'phone' | 'website',\n  fallbackMessage: string,\n): (value: unknown, fieldNode: FieldNode) => true | string {\n  return (value, fieldNode) => {\n    if (typeof value !== 'string') return 'Expected a string value.'\n    if (value.length === 0) return true\n    const overrideRaw = fieldNode['x-om-pattern']\n    const override = typeof overrideRaw === 'string' && overrideRaw.length > 0 ? overrideRaw : null\n    const source = override ?? FIELD_TYPE_DEFAULT_PATTERNS[format]\n    const result = testLinearRegex(source, value)\n    return result.ok && result.matched ? true : fallbackMessage\n  }\n}\n\nexport const EMAIL_TYPE: FieldTypeSpec = {\n  validator: makeFormatValidator('email', 'Expected a valid email.'),\n  renderer: null,\n  defaultUiSchema: { widget: 'email' },\n  exportAdapter: (value) => (typeof value === 'string' ? value : ''),\n  category: 'input',\n  icon: 'mail',\n  displayNameKey: 'forms.studio.palette.survey.email',\n}\n\nexport const PHONE_TYPE: FieldTypeSpec = {\n  validator: makeFormatValidator('phone', 'Expected a valid phone.'),\n  renderer: null,\n  defaultUiSchema: { widget: 'phone' },\n  exportAdapter: (value) => (typeof value === 'string' ? value : ''),\n  category: 'input',\n  icon: 'phone',\n  displayNameKey: 'forms.studio.palette.survey.phone',\n}\n\nexport const WEBSITE_TYPE: FieldTypeSpec = {\n  validator: makeFormatValidator('website', 'Expected a valid URL.'),\n  renderer: null,\n  defaultUiSchema: { widget: 'website' },\n  exportAdapter: (value) => (typeof value === 'string' ? value : ''),\n  category: 'input',\n  icon: 'globe',\n  displayNameKey: 'forms.studio.palette.survey.website',\n}\n\n// ----------------------------------------------------------------------------\n// Address \u2014 composite type (Phase C of\n// `.ai/specs/2026-05-14-forms-tier-2-question-palette.md`).\n//\n// Decision 1 \u2014 single field key with a JSON-object value. Sub-fields:\n// `street1` / `city` / `country` are required; `street2` / `region` /\n// `postalCode` are optional. The persisted JSON Schema fragment carries\n// `type: 'object'`, the canonical `properties` map, `required`, and\n// `additionalProperties: false` so AJV rejects unknown sub-keys.\n// ----------------------------------------------------------------------------\n\nconst ADDRESS_REQUIRED_SUB_FIELDS = ['street1', 'city', 'country'] as const\nconst ADDRESS_OPTIONAL_SUB_FIELDS = ['street2', 'region', 'postalCode'] as const\nconst ADDRESS_KNOWN_SUB_FIELDS = new Set<string>([\n  ...ADDRESS_REQUIRED_SUB_FIELDS,\n  ...ADDRESS_OPTIONAL_SUB_FIELDS,\n])\n\nfunction addressExportSegments(value: Record<string, unknown>): string[] {\n  const segments: string[] = []\n  const street1 = typeof value.street1 === 'string' ? value.street1.trim() : ''\n  const street2 = typeof value.street2 === 'string' ? value.street2.trim() : ''\n  const city = typeof value.city === 'string' ? value.city.trim() : ''\n  const region = typeof value.region === 'string' ? value.region.trim() : ''\n  const postalCode = typeof value.postalCode === 'string' ? value.postalCode.trim() : ''\n  const country = typeof value.country === 'string' ? value.country.trim() : ''\n  if (street1) segments.push(street1)\n  if (street2) segments.push(street2)\n  if (city) segments.push(city)\n  const regionPostal = [region, postalCode].filter((entry) => entry.length > 0).join(' ')\n  if (regionPostal) segments.push(regionPostal)\n  if (country) segments.push(country)\n  return segments\n}\n\nexport const ADDRESS_TYPE: FieldTypeSpec = {\n  // Runtime UI translates the literal \"Please complete the required address\n  // fields.\" back to `forms.runner.validation.address.required` when present\n  // (the validator has no locale at this layer \u2014 see Phase C \u00A7 Validation\n  // service in the spec).\n  validator: (value) => {\n    if (value === null || value === undefined) return true\n    if (typeof value !== 'object' || Array.isArray(value)) {\n      return 'Address must be an object.'\n    }\n    const record = value as Record<string, unknown>\n    for (const key of Object.keys(record)) {\n      if (!ADDRESS_KNOWN_SUB_FIELDS.has(key)) {\n        return 'Address contains unknown fields.'\n      }\n    }\n    for (const required of ADDRESS_REQUIRED_SUB_FIELDS) {\n      const entry = record[required]\n      if (typeof entry !== 'string' || entry.trim().length === 0) {\n        return 'Please complete the required address fields.'\n      }\n    }\n    for (const optional of ADDRESS_OPTIONAL_SUB_FIELDS) {\n      const entry = record[optional]\n      if (entry === undefined) continue\n      if (typeof entry !== 'string') {\n        return 'Please complete the required address fields.'\n      }\n    }\n    return true\n  },\n  renderer: null,\n  defaultUiSchema: { widget: 'address' },\n  exportAdapter: (value) => {\n    if (!value || typeof value !== 'object' || Array.isArray(value)) return ''\n    return addressExportSegments(value as Record<string, unknown>).join(', ')\n  },\n  category: 'input',\n  icon: 'map-pin',\n  displayNameKey: 'forms.studio.palette.survey.address',\n}\n\n// ----------------------------------------------------------------------------\n// NPS + Opinion scale \u2014 survey types (Phase D of\n// `.ai/specs/2026-05-14-forms-tier-2-question-palette.md`).\n//\n// Decision 2 \u2014 NPS is a distinct registered type (separate from `scale`) so the\n// renderer / exporter can carry the promoter/passive/detractor semantics\n// without leaking them into the generic SCALE_TYPE.\n//\n// `nps`: integer 0..10 (fixed). exportAdapter emits \"<value> (<band>)\".\n// `opinion_scale`: integer respecting `x-om-min` (default 1) and `x-om-max`\n//   (default 5). exportAdapter emits \"<value>/<max>\".\n// ----------------------------------------------------------------------------\n\nfunction npsBandLabel(value: number): 'Detractor' | 'Passive' | 'Promoter' {\n  if (value <= 6) return 'Detractor'\n  if (value <= 8) return 'Passive'\n  return 'Promoter'\n}\n\nexport const NPS_TYPE: FieldTypeSpec = {\n  validator: (value) => {\n    const result = requireFiniteNumber(value)\n    if (result !== true) return result\n    if (!Number.isInteger(value as number)) return 'NPS value must be an integer.'\n    if ((value as number) < 0 || (value as number) > 10) {\n      return 'NPS value must be between 0 and 10 (inclusive).'\n    }\n    return true\n  },\n  renderer: null,\n  defaultUiSchema: { widget: 'nps' },\n  exportAdapter: (value) => {\n    if (typeof value !== 'number' || !Number.isInteger(value)) return ''\n    if (value < 0 || value > 10) return ''\n    return `${value} (${npsBandLabel(value)})`\n  },\n  category: 'input',\n  icon: 'gauge',\n  displayNameKey: 'forms.studio.palette.survey.nps',\n}\n\nexport const OPINION_SCALE_TYPE: FieldTypeSpec = {\n  validator: (value, fieldNode) => {\n    const result = requireFiniteNumber(value)\n    if (result !== true) return result\n    if (!Number.isInteger(value as number)) return 'Opinion scale value must be an integer.'\n    const min = typeof fieldNode['x-om-min'] === 'number' ? (fieldNode['x-om-min'] as number) : 1\n    const max = typeof fieldNode['x-om-max'] === 'number' ? (fieldNode['x-om-max'] as number) : 5\n    if (min > max) return `Opinion scale bounds invalid: min (${min}) must be <= max (${max}).`\n    if ((value as number) < min || (value as number) > max) {\n      return `Value must be between ${min} and ${max} (inclusive).`\n    }\n    return true\n  },\n  renderer: null,\n  defaultUiSchema: { widget: 'opinion_scale' },\n  exportAdapter: (value, fieldNode) => {\n    if (typeof value !== 'number' || !Number.isInteger(value)) return ''\n    const max =\n      fieldNode && typeof (fieldNode as FieldNode)['x-om-max'] === 'number'\n        ? ((fieldNode as FieldNode)['x-om-max'] as number)\n        : 5\n    return `${value}/${max}`\n  },\n  category: 'input',\n  icon: 'star',\n  displayNameKey: 'forms.studio.palette.survey.opinion',\n}\n\n// ----------------------------------------------------------------------------\n// Ranking \u2014 Phase E of\n// `.ai/specs/2026-05-14-forms-tier-2-question-palette.md`.\n//\n// Decision 4 \u2014 partial rankings are accepted by default; authors opt into\n// `x-om-ranking-exhaustive: true` to require every option ranked.\n//\n// Persisted value shape: an array of option-value strings in user-chosen rank\n// order. Each entry must belong to `x-om-options[*].value`; duplicates are\n// rejected. The exporter emits `A > B > C` for exhaustive rankings and\n// `A > B (partial; N unranked)` when the rank order does not cover every\n// option (R-5 mitigation \u2014 partial rankings are surfaced to consumers).\n// ----------------------------------------------------------------------------\n\nexport const RANKING_TYPE: FieldTypeSpec = {\n  validator: (value, fieldNode) => {\n    if (value === null || value === undefined) return true\n    if (!Array.isArray(value)) return 'Expected an array of ranked option values.'\n    const allowed = optionValues(fieldNode)\n    const seen = new Set<string>()\n    for (const entry of value) {\n      if (typeof entry !== 'string') return 'Each ranked entry must be a string.'\n      if (seen.has(entry)) return `Duplicate ranked entry \"${entry}\".`\n      seen.add(entry)\n      if (allowed.length > 0 && !allowed.includes(entry)) {\n        return `Each ranked entry must be one of: ${allowed.join(', ')}.`\n      }\n    }\n    const exhaustive = (fieldNode as Record<string, unknown>)['x-om-ranking-exhaustive']\n    if (exhaustive === true && value.length !== allowed.length) {\n      return 'Please rank every option.'\n    }\n    return true\n  },\n  renderer: null,\n  defaultUiSchema: { widget: 'ranking' },\n  exportAdapter: (value, fieldNode) => {\n    if (!Array.isArray(value)) return ''\n    const ordered = value.filter((entry): entry is string => typeof entry === 'string')\n    const joined = ordered.join(' > ')\n    if (!fieldNode) return joined\n    const totalOptions = optionValues(fieldNode as FieldNode).length\n    const exhaustive = (fieldNode as Record<string, unknown>)['x-om-ranking-exhaustive'] === true\n    if (totalOptions === 0) return joined\n    if (exhaustive) return joined\n    const missing = totalOptions - ordered.length\n    if (missing > 0) {\n      return `${joined} (partial; ${missing} unranked)`\n    }\n    return joined\n  },\n  category: 'input',\n  icon: 'list-ordered',\n  displayNameKey: 'forms.studio.palette.survey.ranking',\n}\n\n// ----------------------------------------------------------------------------\n// Matrix / Likert \u2014 Phase F of\n// `.ai/specs/2026-05-14-forms-tier-2-question-palette.md`.\n//\n// Decision 5 \u2014 per-row `multiple: true` opt-in. A row's value is either:\n//   - a single string (default \u2014 radio per row), OR\n//   - a string[] (when the row declares `multiple: true` \u2014 checkbox per row).\n//\n// Persisted shape is `Record<rowKey, string | string[]>`. The author defines\n// the row catalog via `x-om-matrix-rows` and the column catalog via\n// `x-om-matrix-columns`. R-3 soft caps live in `jsonschema-extensions.ts` and\n// fire from `validateOmCrossKeyword`.\n// ----------------------------------------------------------------------------\n\ntype MatrixRowNode = {\n  key: string\n  label?: Record<string, string>\n  multiple?: boolean\n  required?: boolean\n}\n\ntype MatrixColumnNode = {\n  value: string\n  label?: Record<string, string>\n}\n\nfunction readMatrixRows(fieldNode: FieldNode): MatrixRowNode[] {\n  const raw = (fieldNode as Record<string, unknown>)['x-om-matrix-rows']\n  if (!Array.isArray(raw)) return []\n  const result: MatrixRowNode[] = []\n  for (const entry of raw) {\n    if (!entry || typeof entry !== 'object' || Array.isArray(entry)) continue\n    const candidate = entry as Record<string, unknown>\n    if (typeof candidate.key !== 'string') continue\n    const row: MatrixRowNode = { key: candidate.key }\n    if (candidate.label && typeof candidate.label === 'object' && !Array.isArray(candidate.label)) {\n      row.label = candidate.label as Record<string, string>\n    }\n    if (typeof candidate.multiple === 'boolean') row.multiple = candidate.multiple\n    if (typeof candidate.required === 'boolean') row.required = candidate.required\n    result.push(row)\n  }\n  return result\n}\n\nfunction readMatrixColumnValues(fieldNode: FieldNode): string[] {\n  const raw = (fieldNode as Record<string, unknown>)['x-om-matrix-columns']\n  if (!Array.isArray(raw)) return []\n  const values: string[] = []\n  for (const entry of raw) {\n    if (!entry || typeof entry !== 'object' || Array.isArray(entry)) continue\n    const candidate = entry as Record<string, unknown>\n    if (typeof candidate.value === 'string' && candidate.value.length > 0) {\n      values.push(candidate.value)\n    }\n  }\n  return values\n}\n\nexport const MATRIX_TYPE: FieldTypeSpec = {\n  validator: (value, fieldNode) => {\n    if (value === null || value === undefined) return true\n    if (typeof value !== 'object' || Array.isArray(value)) {\n      return 'Matrix value must be an object keyed by row key.'\n    }\n    const record = value as Record<string, unknown>\n    const rows = readMatrixRows(fieldNode)\n    const rowsByKey = new Map<string, MatrixRowNode>()\n    for (const row of rows) rowsByKey.set(row.key, row)\n    const columnValues = readMatrixColumnValues(fieldNode)\n    const columnSet = new Set(columnValues)\n    for (const presentKey of Object.keys(record)) {\n      if (!rowsByKey.has(presentKey)) {\n        return `Matrix value references unknown row \"${presentKey}\".`\n      }\n    }\n    for (const row of rows) {\n      const entry = record[row.key]\n      const isMissing =\n        entry === undefined\n        || entry === null\n        || (Array.isArray(entry) && entry.length === 0)\n        || (typeof entry === 'string' && entry.length === 0)\n      if (row.required === true && isMissing) {\n        return 'Please answer every required row.'\n      }\n      if (isMissing) continue\n      if (row.multiple === true) {\n        if (!Array.isArray(entry)) {\n          return `Matrix row \"${row.key}\" expects an array of selected column values.`\n        }\n        const seen = new Set<string>()\n        for (const inner of entry) {\n          if (typeof inner !== 'string') {\n            return `Matrix row \"${row.key}\" entries must be strings.`\n          }\n          if (seen.has(inner)) {\n            return `Matrix row \"${row.key}\" contains duplicate value \"${inner}\".`\n          }\n          seen.add(inner)\n          if (columnSet.size > 0 && !columnSet.has(inner)) {\n            return `Matrix row \"${row.key}\" value \"${inner}\" is not a declared column.`\n          }\n        }\n      } else {\n        if (Array.isArray(entry)) {\n          return `Matrix row \"${row.key}\" expects a single column value, not an array.`\n        }\n        if (typeof entry !== 'string') {\n          return `Matrix row \"${row.key}\" expects a single column value.`\n        }\n        if (columnSet.size > 0 && !columnSet.has(entry)) {\n          return `Matrix row \"${row.key}\" value \"${entry}\" is not a declared column.`\n        }\n      }\n    }\n    return true\n  },\n  renderer: null,\n  defaultUiSchema: { widget: 'matrix' },\n  exportAdapter: (value, fieldNode) => {\n    if (!value || typeof value !== 'object' || Array.isArray(value)) return ''\n    const record = value as Record<string, unknown>\n    if (!fieldNode) {\n      const fallback: string[] = []\n      for (const [rowKey, entry] of Object.entries(record)) {\n        if (Array.isArray(entry)) {\n          const joined = entry.filter((inner): inner is string => typeof inner === 'string').join('+')\n          fallback.push(`${rowKey} \u2192 ${joined.length > 0 ? joined : '\u2014'}`)\n        } else if (typeof entry === 'string' && entry.length > 0) {\n          fallback.push(`${rowKey} \u2192 ${entry}`)\n        } else {\n          fallback.push(`${rowKey} \u2192 \u2014`)\n        }\n      }\n      return fallback.join('; ')\n    }\n    const rows = readMatrixRows(fieldNode as FieldNode)\n    const segments: string[] = []\n    for (const row of rows) {\n      const labelEn = row.label?.en ?? row.key\n      const entry = record[row.key]\n      if (Array.isArray(entry)) {\n        const inner = entry.filter((value): value is string => typeof value === 'string')\n        segments.push(`${labelEn} \u2192 ${inner.length > 0 ? inner.join('+') : '\u2014'}`)\n      } else if (typeof entry === 'string' && entry.length > 0) {\n        segments.push(`${labelEn} \u2192 ${entry}`)\n      } else {\n        segments.push(`${labelEn} \u2192 \u2014`)\n      }\n    }\n    return segments.join('; ')\n  },\n  category: 'input',\n  icon: 'grid-3x3',\n  displayNameKey: 'forms.studio.palette.survey.matrix',\n}\n\nexport const INFO_BLOCK_TYPE: FieldTypeSpec = {\n  // Display-only \u2014 never produces a submission value, never fails validation.\n  validator: () => true,\n  renderer: null,\n  defaultUiSchema: { widget: 'info' },\n  exportAdapter: () => '',\n  // Decision 7a (2026-05-10 grill): info_block is the single LAYOUT entry for\n  // display-only headings/text. No parallel \"Heading\" primitive.\n  category: 'layout',\n  icon: 'heading',\n  displayNameKey: 'forms.studio.palette.layout.infoBlock',\n}\n\nexport const V1_FIELD_TYPES = {\n  text: TEXT_TYPE,\n  textarea: TEXTAREA_TYPE,\n  number: NUMBER_TYPE,\n  integer: INTEGER_TYPE,\n  boolean: BOOLEAN_TYPE,\n  yes_no: YES_NO_TYPE,\n  yes_no_buttons: YES_NO_BUTTONS_TYPE,\n  date: DATE_TYPE,\n  datetime: DATETIME_TYPE,\n  select_one: SELECT_ONE_TYPE,\n  select_many: SELECT_MANY_TYPE,\n  scale: SCALE_TYPE,\n  info_block: INFO_BLOCK_TYPE,\n  // Tier-2 additive entries \u2014 Phase B (Survey & Contact group). Despite the\n  // legacy `V1_FIELD_TYPES` name, these are NOT v1-core; the FROZEN v1 list\n  // in `packages/forms/AGENTS.md \u00A7 \"v1 Field Types\"` is unchanged.\n  email: EMAIL_TYPE,\n  phone: PHONE_TYPE,\n  website: WEBSITE_TYPE,\n  // Tier-2 additive entry \u2014 Phase C (composite address, Decision 1).\n  address: ADDRESS_TYPE,\n  // Tier-2 additive entries \u2014 Phase D (survey scales).\n  // Decision 2 \u2014 NPS is a distinct registered type, not a `scale` variant.\n  nps: NPS_TYPE,\n  opinion_scale: OPINION_SCALE_TYPE,\n  // Tier-2 additive entry \u2014 Phase E (ranking \u2014 drag-to-rank list).\n  ranking: RANKING_TYPE,\n  // Tier-2 additive entry \u2014 Phase F (matrix / Likert grid).\n  // Decision 5 \u2014 per-row `multiple: true` opt-in produces a string[] value.\n  matrix: MATRIX_TYPE,\n  // W4 additive entry \u2014 file / photo upload (FA-4 file + SEC-4). Value is an\n  // attachment-reference array; bytes are stored encrypted in\n  // `forms_form_attachment` (`kind = 'user_upload'`).\n  file: FILE_TYPE,\n  // W2 additive entry \u2014 e-signature with tamper-evident audit data (CN-1,\n  // FD-4). Value travels in the encrypted revision answers (append-only +\n  // per-tenant encryption); no new storage path.\n  signature: SIGNATURE_TYPE,\n  // W6 additive entry \u2014 repeatable group (FA-8). Value is an array of objects\n  // each matching the sub-field shape declared under `items.properties`. The\n  // group is treated atomically by the role-policy service (sub-fields inherit\n  // the group's editable-by / visible-to). Nested groups are out of scope.\n  group: GROUP_TYPE,\n} as const\n\nexport type V1FieldTypeKey = keyof typeof V1_FIELD_TYPES\n\n// ============================================================================\n// Registry\n// ============================================================================\n\n/**\n * FieldTypeRegistry \u2014 singleton lookup keyed by `x-om-type` string.\n *\n * The registry version is a SHA-256 of the registered keys (sorted) \u2014 it\n * changes when types are added/removed and is captured on\n * `form_version.registry_version` at publish time so the renderer can detect\n * registry drift between publish and render (R2 mitigation, parent spec\n * \u00A7 Risks).\n */\nexport class FieldTypeRegistry {\n  private readonly entries = new Map<string, FieldTypeSpec>()\n  private cachedVersion: string | null = null\n\n  register(typeKey: string, spec: FieldTypeSpec): void {\n    if (spec.category === 'layout') {\n      // Layout-category entries are display-only (Decisions 16a/16b in\n      // `.ai/specs/2026-05-10-forms-visual-builder.md`). The registry asserts\n      // the `info_block` contract at register time so packs can't ship\n      // value-producing or non-empty-export fields under `category: 'layout'`.\n      const validatorResult = spec.validator(undefined, {})\n      if (validatorResult !== true) {\n        throw new Error(\n          `Field type \"${typeKey}\" registered with category \"layout\" must accept undefined values; validator returned: ${String(validatorResult)}`,\n        )\n      }\n      const exportResult = spec.exportAdapter(undefined)\n      if (exportResult !== '') {\n        throw new Error(\n          `Field type \"${typeKey}\" registered with category \"layout\" must export undefined as the empty string; exportAdapter returned: ${JSON.stringify(exportResult)}`,\n        )\n      }\n    }\n    this.entries.set(typeKey, spec)\n    this.cachedVersion = null\n  }\n\n  setRenderer(typeKey: string, renderer: ComponentType<unknown>): void {\n    const existing = this.entries.get(typeKey)\n    if (!existing) {\n      throw new Error(`Field type \"${typeKey}\" is not registered; cannot attach renderer.`)\n    }\n    this.entries.set(typeKey, { ...existing, renderer })\n  }\n\n  get(typeKey: string): FieldTypeSpec | undefined {\n    return this.entries.get(typeKey)\n  }\n\n  has(typeKey: string): boolean {\n    return this.entries.has(typeKey)\n  }\n\n  keys(): string[] {\n    // Canonical internal keys, and `registryVersion` hashes this order \u2014 the\n    // code-unit comparator reproduces the previous bare `sort()` exactly, so\n    // already-compiled form versions keep their hash.\n    return Array.from(this.entries.keys()).sort((a, b) => (a < b ? -1 : a > b ? 1 : 0))\n  }\n\n  /**\n   * Stable hash over the registered keys. Bumps whenever types are added or\n   * removed; pinned at publish time on `form_version.registry_version`.\n   */\n  getRegistryVersion(): string {\n    if (this.cachedVersion) return this.cachedVersion\n    const hash = createHash('sha256').update(this.keys().join('|')).digest('hex').slice(0, 16)\n    this.cachedVersion = `v1:${hash}`\n    return this.cachedVersion\n  }\n}\n\n/**\n * Pre-loaded singleton with the 11 v1 core types. Phase 1d's renderer\n * calls `defaultFieldTypeRegistry.setRenderer(...)` at module init.\n */\nexport const defaultFieldTypeRegistry = new FieldTypeRegistry()\nfor (const [key, spec] of Object.entries(V1_FIELD_TYPES)) {\n  defaultFieldTypeRegistry.register(key, spec)\n}\n"],
+  "mappings": "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",
+  "names": ["value"]
+}

package/dist/modules/forms/schema/file-field.js

@@ -0,0 +1,64 @@
+const FILE_TYPE_KEY = "file";
+function isFileAttachmentRef(value) {
+  if (!value || typeof value !== "object" || Array.isArray(value)) return false;
+  const candidate = value;
+  if (typeof candidate.id !== "string" || candidate.id.length === 0) return false;
+  if (typeof candidate.filename !== "string") return false;
+  if (typeof candidate.contentType !== "string") return false;
+  if (typeof candidate.sizeBytes !== "number" || !Number.isFinite(candidate.sizeBytes) || candidate.sizeBytes < 0) {
+    return false;
+  }
+  return true;
+}
+function readFileRefs(value) {
+  if (value === null || value === void 0) return [];
+  const entries = Array.isArray(value) ? value : [value];
+  const refs = [];
+  for (const entry of entries) {
+    if (typeof entry === "string") {
+      if (entry.length === 0) return null;
+      refs.push({ id: entry, filename: "", contentType: "", sizeBytes: 0 });
+      continue;
+    }
+    if (!isFileAttachmentRef(entry)) return null;
+    refs.push({
+      id: entry.id,
+      filename: entry.filename,
+      contentType: entry.contentType,
+      sizeBytes: entry.sizeBytes
+    });
+  }
+  return refs;
+}
+function fileFieldAllowsMultiple(fieldNode) {
+  return fieldNode["x-om-multiple"] === true;
+}
+const FILE_TYPE = {
+  validator: (value, fieldNode) => {
+    if (value === null || value === void 0) return true;
+    const refs = readFileRefs(value);
+    if (refs === null) {
+      return "Expected an uploaded file reference (id string, object, or array).";
+    }
+    if (!fileFieldAllowsMultiple(fieldNode) && refs.length > 1) {
+      return "This field accepts a single file.";
+    }
+    return true;
+  },
+  renderer: null,
+  defaultUiSchema: { widget: "file" },
+  exportAdapter: (value) => {
+    const refs = readFileRefs(value);
+    if (!refs || refs.length === 0) return "";
+    return refs.map((ref) => ref.filename.length > 0 ? ref.filename : ref.id).join(", ");
+  },
+  category: "input",
+  icon: "paperclip",
+  displayNameKey: "forms.studio.palette.input.file"
+};
+export {
+  FILE_TYPE,
+  FILE_TYPE_KEY,
+  readFileRefs
+};
+//# sourceMappingURL=file-field.js.map

package/dist/modules/forms/schema/file-field.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../src/modules/forms/schema/file-field.ts"],
+  "sourcesContent": ["/**\n * `file` field type \u2014 W4 (FA-4 file + SEC-4).\n *\n * Lets a participant upload a photo / file (e.g. a medication box) as part of\n * a submission. The persisted submission value is NEVER the bytes \u2014 it is a\n * lightweight reference array of `FileAttachmentRef`. The bytes live in a\n * `forms_form_attachment` row (`kind = 'user_upload'`), encrypted at rest via\n * the per-tenant `EncryptionService` (DP-1: file bytes are PHI).\n *\n * Value shape (single field key, always an array \u2014 single-file fields persist\n * an array of length 1):\n *   `[{ id, filename, contentType, sizeBytes }]`\n *\n * The `file` type is ADDITIVE \u2014 it is registered through the standard\n * `FieldTypeRegistry.register(...)` API and does NOT appear in the FROZEN v1\n * core list (`packages/forms/AGENTS.md \u00A7 v1 Field Types`).\n *\n * New `x-om-*` keywords (all additive, registered in `jsonschema-extensions.ts`):\n *   - `x-om-accept`         \u2014 `string[]` MIME allowlist (empty/absent \u21D2 any)\n *   - `x-om-max-size-bytes` \u2014 per-field max upload size in bytes\n *   - `x-om-multiple`       \u2014 allow more than one file (default false)\n */\n\nimport type { FieldNode, FieldTypeSpec } from './field-type-registry'\n\nexport const FILE_TYPE_KEY = 'file' as const\n\n/** Reference persisted in the submission value for a single uploaded file. */\nexport type FileAttachmentRef = {\n  id: string\n  filename: string\n  contentType: string\n  sizeBytes: number\n}\n\nfunction isFileAttachmentRef(value: unknown): value is FileAttachmentRef {\n  if (!value || typeof value !== 'object' || Array.isArray(value)) return false\n  const candidate = value as Record<string, unknown>\n  if (typeof candidate.id !== 'string' || candidate.id.length === 0) return false\n  if (typeof candidate.filename !== 'string') return false\n  if (typeof candidate.contentType !== 'string') return false\n  if (typeof candidate.sizeBytes !== 'number' || !Number.isFinite(candidate.sizeBytes) || candidate.sizeBytes < 0) {\n    return false\n  }\n  return true\n}\n\n/**\n * Normalizes a stored value into an array of refs. Accepts:\n *   - a bare attachment id string (legacy / convenience),\n *   - a single `FileAttachmentRef` object,\n *   - an array of either.\n * Returns `null` when the value cannot be interpreted as file references.\n */\nexport function readFileRefs(value: unknown): FileAttachmentRef[] | null {\n  if (value === null || value === undefined) return []\n  const entries = Array.isArray(value) ? value : [value]\n  const refs: FileAttachmentRef[] = []\n  for (const entry of entries) {\n    if (typeof entry === 'string') {\n      if (entry.length === 0) return null\n      refs.push({ id: entry, filename: '', contentType: '', sizeBytes: 0 })\n      continue\n    }\n    if (!isFileAttachmentRef(entry)) return null\n    refs.push({\n      id: entry.id,\n      filename: entry.filename,\n      contentType: entry.contentType,\n      sizeBytes: entry.sizeBytes,\n    })\n  }\n  return refs\n}\n\nfunction fileFieldAllowsMultiple(fieldNode: FieldNode): boolean {\n  return (fieldNode as Record<string, unknown>)['x-om-multiple'] === true\n}\n\nexport const FILE_TYPE: FieldTypeSpec = {\n  validator: (value, fieldNode) => {\n    if (value === null || value === undefined) return true\n    const refs = readFileRefs(value)\n    if (refs === null) {\n      return 'Expected an uploaded file reference (id string, object, or array).'\n    }\n    if (!fileFieldAllowsMultiple(fieldNode) && refs.length > 1) {\n      return 'This field accepts a single file.'\n    }\n    return true\n  },\n  renderer: null,\n  defaultUiSchema: { widget: 'file' },\n  exportAdapter: (value) => {\n    const refs = readFileRefs(value)\n    if (!refs || refs.length === 0) return ''\n    return refs.map((ref) => (ref.filename.length > 0 ? ref.filename : ref.id)).join(', ')\n  },\n  category: 'input',\n  icon: 'paperclip',\n  displayNameKey: 'forms.studio.palette.input.file',\n}\n"],
+  "mappings": "AAyBO,MAAM,gBAAgB;AAU7B,SAAS,oBAAoB,OAA4C;AACvE,MAAI,CAAC,SAAS,OAAO,UAAU,YAAY,MAAM,QAAQ,KAAK,EAAG,QAAO;AACxE,QAAM,YAAY;AAClB,MAAI,OAAO,UAAU,OAAO,YAAY,UAAU,GAAG,WAAW,EAAG,QAAO;AAC1E,MAAI,OAAO,UAAU,aAAa,SAAU,QAAO;AACnD,MAAI,OAAO,UAAU,gBAAgB,SAAU,QAAO;AACtD,MAAI,OAAO,UAAU,cAAc,YAAY,CAAC,OAAO,SAAS,UAAU,SAAS,KAAK,UAAU,YAAY,GAAG;AAC/G,WAAO;AAAA,EACT;AACA,SAAO;AACT;AASO,SAAS,aAAa,OAA4C;AACvE,MAAI,UAAU,QAAQ,UAAU,OAAW,QAAO,CAAC;AACnD,QAAM,UAAU,MAAM,QAAQ,KAAK,IAAI,QAAQ,CAAC,KAAK;AACrD,QAAM,OAA4B,CAAC;AACnC,aAAW,SAAS,SAAS;AAC3B,QAAI,OAAO,UAAU,UAAU;AAC7B,UAAI,MAAM,WAAW,EAAG,QAAO;AAC/B,WAAK,KAAK,EAAE,IAAI,OAAO,UAAU,IAAI,aAAa,IAAI,WAAW,EAAE,CAAC;AACpE;AAAA,IACF;AACA,QAAI,CAAC,oBAAoB,KAAK,EAAG,QAAO;AACxC,SAAK,KAAK;AAAA,MACR,IAAI,MAAM;AAAA,MACV,UAAU,MAAM;AAAA,MAChB,aAAa,MAAM;AAAA,MACnB,WAAW,MAAM;AAAA,IACnB,CAAC;AAAA,EACH;AACA,SAAO;AACT;AAEA,SAAS,wBAAwB,WAA+B;AAC9D,SAAQ,UAAsC,eAAe,MAAM;AACrE;AAEO,MAAM,YAA2B;AAAA,EACtC,WAAW,CAAC,OAAO,cAAc;AAC/B,QAAI,UAAU,QAAQ,UAAU,OAAW,QAAO;AAClD,UAAM,OAAO,aAAa,KAAK;AAC/B,QAAI,SAAS,MAAM;AACjB,aAAO;AAAA,IACT;AACA,QAAI,CAAC,wBAAwB,SAAS,KAAK,KAAK,SAAS,GAAG;AAC1D,aAAO;AAAA,IACT;AACA,WAAO;AAAA,EACT;AAAA,EACA,UAAU;AAAA,EACV,iBAAiB,EAAE,QAAQ,OAAO;AAAA,EAClC,eAAe,CAAC,UAAU;AACxB,UAAM,OAAO,aAAa,KAAK;AAC/B,QAAI,CAAC,QAAQ,KAAK,WAAW,EAAG,QAAO;AACvC,WAAO,KAAK,IAAI,CAAC,QAAS,IAAI,SAAS,SAAS,IAAI,IAAI,WAAW,IAAI,EAAG,EAAE,KAAK,IAAI;AAAA,EACvF;AAAA,EACA,UAAU;AAAA,EACV,MAAM;AAAA,EACN,gBAAgB;AAClB;",
+  "names": []
+}

package/dist/modules/forms/schema/group-field.js

@@ -0,0 +1,143 @@
+import { defaultFieldTypeRegistry } from "./field-type-registry.js";
+const GROUP_TYPE_KEY = "group";
+import { GROUP_MAX_ITEMS_SOFT_CAP } from "./jsonschema-extensions.js";
+function isPlainObject(value) {
+  return Boolean(value) && typeof value === "object" && !Array.isArray(value);
+}
+function readGroupSubFields(fieldNode) {
+  const items = fieldNode.items;
+  if (!isPlainObject(items)) return [];
+  const properties = items.properties;
+  if (!isPlainObject(properties)) return [];
+  const requiredRaw = items.required;
+  const requiredSet = new Set(
+    Array.isArray(requiredRaw) ? requiredRaw.filter((entry) => typeof entry === "string") : []
+  );
+  const result = [];
+  for (const [subKey, rawNode] of Object.entries(properties)) {
+    if (!isPlainObject(rawNode)) continue;
+    const subType = rawNode["x-om-type"];
+    if (typeof subType !== "string" || subType.length === 0) continue;
+    result.push({
+      key: subKey,
+      type: subType,
+      required: requiredSet.has(subKey),
+      node: rawNode
+    });
+  }
+  return result;
+}
+function readItemBound(fieldNode, keyword) {
+  const raw = fieldNode[keyword];
+  return typeof raw === "number" && Number.isInteger(raw) && raw >= 0 ? raw : null;
+}
+function readGroupMinItems(fieldNode) {
+  return readItemBound(fieldNode, "x-om-min-items") ?? 0;
+}
+function readGroupMaxItems(fieldNode) {
+  return readItemBound(fieldNode, "x-om-max-items");
+}
+function validateGroupEntry(entry, subFields, registry) {
+  if (!isPlainObject(entry)) return "Each group entry must be an object.";
+  const knownKeys = new Set(subFields.map((subField) => subField.key));
+  for (const presentKey of Object.keys(entry)) {
+    if (!knownKeys.has(presentKey)) {
+      return `Group entry references unknown sub-field "${presentKey}".`;
+    }
+  }
+  for (const subField of subFields) {
+    const value = entry[subField.key];
+    const isMissing = value === void 0 || value === null || typeof value === "string" && value.length === 0 || Array.isArray(value) && value.length === 0;
+    if (subField.required && isMissing) {
+      return `Sub-field "${subField.key}" is required in every group entry.`;
+    }
+    if (isMissing) continue;
+    const spec = registry.get(subField.type);
+    if (!spec) {
+      return `Sub-field "${subField.key}" declares unregistered type "${subField.type}".`;
+    }
+    const result = spec.validator(value, subField.node);
+    if (result !== true) {
+      return `Sub-field "${subField.key}": ${result}`;
+    }
+  }
+  return true;
+}
+function createGroupTypeSpec(registry) {
+  const resolveRegistry = () => registry ?? defaultFieldTypeRegistry;
+  return {
+    validator: (value, fieldNode) => {
+      if (value === null || value === void 0) return true;
+      if (!Array.isArray(value)) return "Expected an array of group entries.";
+      const min = readGroupMinItems(fieldNode);
+      const max = readGroupMaxItems(fieldNode);
+      if (value.length < min) {
+        return `Please add at least ${min} ${min === 1 ? "entry" : "entries"}.`;
+      }
+      if (max !== null && value.length > max) {
+        return `Please add no more than ${max} ${max === 1 ? "entry" : "entries"}.`;
+      }
+      const subFields = readGroupSubFields(fieldNode);
+      const registryInstance = resolveRegistry();
+      for (const entry of value) {
+        const result = validateGroupEntry(entry, subFields, registryInstance);
+        if (result !== true) return result;
+      }
+      return true;
+    },
+    renderer: null,
+    defaultUiSchema: { widget: "group" },
+    exportAdapter: (value, fieldNode) => {
+      if (!Array.isArray(value) || value.length === 0) return "";
+      const subFields = fieldNode ? readGroupSubFields(fieldNode) : [];
+      const registryInstance = resolveRegistry();
+      const lines = value.map((entry, index) => {
+        if (!isPlainObject(entry)) return `#${index + 1}`;
+        if (subFields.length === 0) {
+          const parts2 = Object.entries(entry).map(([key, raw]) => `${key}: ${stringifyScalar(raw)}`);
+          return `#${index + 1} ${parts2.join(", ")}`;
+        }
+        const parts = subFields.map((subField) => {
+          const spec = registryInstance.get(subField.type);
+          const raw = entry[subField.key];
+          const rendered = spec ? spec.exportAdapter(raw, subField.node) : stringifyScalar(raw);
+          const label = readEnLabel(subField.node) ?? subField.key;
+          return `${label}: ${rendered.length > 0 ? rendered : "\u2014"}`;
+        });
+        return `#${index + 1} ${parts.join(", ")}`;
+      });
+      return lines.join(" | ");
+    },
+    category: "input",
+    icon: "rows",
+    displayNameKey: "forms.studio.palette.input.group"
+  };
+}
+function stringifyScalar(value) {
+  if (value === null || value === void 0) return "";
+  if (typeof value === "string") return value;
+  if (typeof value === "number" || typeof value === "boolean") return String(value);
+  if (Array.isArray(value)) return value.map((entry) => stringifyScalar(entry)).join(", ");
+  return JSON.stringify(value);
+}
+function readEnLabel(node) {
+  const label = node["x-om-label"];
+  if (!isPlainObject(label)) return null;
+  const en = label.en;
+  if (typeof en === "string" && en.length > 0) return en;
+  for (const value of Object.values(label)) {
+    if (typeof value === "string" && value.length > 0) return value;
+  }
+  return null;
+}
+const GROUP_TYPE = createGroupTypeSpec();
+export {
+  GROUP_MAX_ITEMS_SOFT_CAP,
+  GROUP_TYPE,
+  GROUP_TYPE_KEY,
+  createGroupTypeSpec,
+  readGroupMaxItems,
+  readGroupMinItems,
+  readGroupSubFields
+};
+//# sourceMappingURL=group-field.js.map

package/dist/modules/forms/schema/group-field.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../src/modules/forms/schema/group-field.ts"],
+  "sourcesContent": ["/**\n * `group` field type \u2014 W6 (FA-8 repeatable groups).\n *\n * Lets a participant add N repeated entries \u2014 e.g. \"add a medication\" with\n * sub-fields (name, dose) repeated as many times as needed. This is the\n * defining capability for medical-history / line-item style questionnaires.\n *\n * Schema representation (additive, one level of nesting):\n *   {\n *     type: 'array',\n *     'x-om-type': 'group',\n *     'x-om-label': { en: 'Medications' },\n *     'x-om-min-items'?: number,         // lower bound on entry count\n *     'x-om-max-items'?: number,         // upper bound on entry count\n *     items: {\n *       type: 'object',\n *       additionalProperties: false,\n *       required: [<subFieldKey>...],\n *       properties: {\n *         <subFieldKey>: {                // a normal field node, SAME x-om-*\n *           type: 'string',               // keywords as a top-level field\n *           'x-om-type': 'text',\n *           'x-om-label': { en: 'Name' },\n *         },\n *         ...\n *       },\n *     },\n *   }\n *\n * Value shape: an array of objects, each object keyed by sub-field key:\n *   [{ name: 'Aspirin', dose: '100mg' }, { name: 'Ibuprofen', dose: '200mg' }]\n *\n * Role policy: the group is treated ATOMICALLY. Sub-fields inherit the group's\n * `x-om-editable-by` / `x-om-visible-to` \u2014 they are NOT independent\n * fieldIndex entries, so the RolePolicyService slices the whole array in/out\n * as a unit (W6 decision \u2014 keep it simple).\n *\n * The `group` type is ADDITIVE \u2014 registered through the standard\n * `FieldTypeRegistry.register(...)` API; it does NOT appear in the FROZEN v1\n * core list (`packages/forms/AGENTS.md \u00A7 v1 Field Types`).\n *\n * New `x-om-*` keywords (all additive, registered in `jsonschema-extensions.ts`):\n *   - `x-om-min-items` \u2014 minimum number of entries (default 0)\n *   - `x-om-max-items` \u2014 maximum number of entries (absent \u21D2 unbounded)\n *\n * Out of scope (explicitly): nested groups within a group. A sub-field whose\n * `x-om-type` is itself `group` is rejected by `validateOmCrossKeyword`. One\n * level of nesting is sufficient for the FA-8 requirement.\n */\n\nimport type { FieldNode, FieldTypeSpec } from './field-type-registry'\nimport { defaultFieldTypeRegistry, type FieldTypeRegistry } from './field-type-registry'\n\nexport const GROUP_TYPE_KEY = 'group' as const\n\nexport { GROUP_MAX_ITEMS_SOFT_CAP } from './jsonschema-extensions'\n\n/** Descriptor for a single sub-field declared under the group's `items.properties`. */\nexport type GroupSubFieldDescriptor = {\n  key: string\n  type: string\n  required: boolean\n  /** The raw sub-field node (carries `x-om-label`, validation keywords, etc.). */\n  node: FieldNode\n}\n\nfunction isPlainObject(value: unknown): value is Record<string, unknown> {\n  return Boolean(value) && typeof value === 'object' && !Array.isArray(value)\n}\n\n/**\n * Reads the group's sub-field descriptors from `items.properties`, in the\n * persisted `Object.entries` order. Returns an empty list when the group is\n * malformed (defensive \u2014 the compiler validates the shape up front).\n */\nexport function readGroupSubFields(fieldNode: FieldNode): GroupSubFieldDescriptor[] {\n  const items = (fieldNode as Record<string, unknown>).items\n  if (!isPlainObject(items)) return []\n  const properties = items.properties\n  if (!isPlainObject(properties)) return []\n  const requiredRaw = items.required\n  const requiredSet = new Set(\n    Array.isArray(requiredRaw)\n      ? requiredRaw.filter((entry): entry is string => typeof entry === 'string')\n      : [],\n  )\n  const result: GroupSubFieldDescriptor[] = []\n  for (const [subKey, rawNode] of Object.entries(properties)) {\n    if (!isPlainObject(rawNode)) continue\n    const subType = rawNode['x-om-type']\n    if (typeof subType !== 'string' || subType.length === 0) continue\n    result.push({\n      key: subKey,\n      type: subType,\n      required: requiredSet.has(subKey),\n      node: rawNode as FieldNode,\n    })\n  }\n  return result\n}\n\nfunction readItemBound(fieldNode: FieldNode, keyword: 'x-om-min-items' | 'x-om-max-items'): number | null {\n  const raw = (fieldNode as Record<string, unknown>)[keyword]\n  return typeof raw === 'number' && Number.isInteger(raw) && raw >= 0 ? raw : null\n}\n\nexport function readGroupMinItems(fieldNode: FieldNode): number {\n  return readItemBound(fieldNode, 'x-om-min-items') ?? 0\n}\n\nexport function readGroupMaxItems(fieldNode: FieldNode): number | null {\n  return readItemBound(fieldNode, 'x-om-max-items')\n}\n\n/**\n * Validates a single repeated entry against the sub-field descriptors using\n * the per-type validators from the registry. Returns `true` or an error string.\n */\nfunction validateGroupEntry(\n  entry: unknown,\n  subFields: GroupSubFieldDescriptor[],\n  registry: FieldTypeRegistry,\n): true | string {\n  if (!isPlainObject(entry)) return 'Each group entry must be an object.'\n  const knownKeys = new Set(subFields.map((subField) => subField.key))\n  for (const presentKey of Object.keys(entry)) {\n    if (!knownKeys.has(presentKey)) {\n      return `Group entry references unknown sub-field \"${presentKey}\".`\n    }\n  }\n  for (const subField of subFields) {\n    const value = entry[subField.key]\n    const isMissing =\n      value === undefined\n      || value === null\n      || (typeof value === 'string' && value.length === 0)\n      || (Array.isArray(value) && value.length === 0)\n    if (subField.required && isMissing) {\n      return `Sub-field \"${subField.key}\" is required in every group entry.`\n    }\n    if (isMissing) continue\n    const spec = registry.get(subField.type)\n    if (!spec) {\n      return `Sub-field \"${subField.key}\" declares unregistered type \"${subField.type}\".`\n    }\n    const result = spec.validator(value, subField.node)\n    if (result !== true) {\n      return `Sub-field \"${subField.key}\": ${result}`\n    }\n  }\n  return true\n}\n\n/**\n * Builds the `group` field-type spec. The validator and exportAdapter consult\n * the registry to resolve each sub-field's per-type behaviour, so the spec is\n * a factory bound to a registry (defaults to the singleton).\n *\n * The registry is resolved lazily at call time (not at construction): the\n * default-singleton `GROUP_TYPE` is built from this module, which is imported\n * by `field-type-registry.ts` BEFORE the singleton is constructed \u2014 binding\n * eagerly would capture `undefined` (circular-import init order).\n */\nexport function createGroupTypeSpec(registry?: FieldTypeRegistry): FieldTypeSpec {\n  const resolveRegistry = (): FieldTypeRegistry => registry ?? defaultFieldTypeRegistry\n  return {\n    validator: (value, fieldNode) => {\n      if (value === null || value === undefined) return true\n      if (!Array.isArray(value)) return 'Expected an array of group entries.'\n      const min = readGroupMinItems(fieldNode)\n      const max = readGroupMaxItems(fieldNode)\n      if (value.length < min) {\n        return `Please add at least ${min} ${min === 1 ? 'entry' : 'entries'}.`\n      }\n      if (max !== null && value.length > max) {\n        return `Please add no more than ${max} ${max === 1 ? 'entry' : 'entries'}.`\n      }\n      const subFields = readGroupSubFields(fieldNode)\n      const registryInstance = resolveRegistry()\n      for (const entry of value) {\n        const result = validateGroupEntry(entry, subFields, registryInstance)\n        if (result !== true) return result\n      }\n      return true\n    },\n    renderer: null,\n    defaultUiSchema: { widget: 'group' },\n    exportAdapter: (value, fieldNode) => {\n      if (!Array.isArray(value) || value.length === 0) return ''\n      const subFields = fieldNode ? readGroupSubFields(fieldNode) : []\n      const registryInstance = resolveRegistry()\n      const lines = value.map((entry, index) => {\n        if (!isPlainObject(entry)) return `#${index + 1}`\n        if (subFields.length === 0) {\n          const parts = Object.entries(entry).map(([key, raw]) => `${key}: ${stringifyScalar(raw)}`)\n          return `#${index + 1} ${parts.join(', ')}`\n        }\n        const parts = subFields.map((subField) => {\n          const spec = registryInstance.get(subField.type)\n          const raw = entry[subField.key]\n          const rendered = spec ? spec.exportAdapter(raw, subField.node) : stringifyScalar(raw)\n          const label = readEnLabel(subField.node) ?? subField.key\n          return `${label}: ${rendered.length > 0 ? rendered : '\u2014'}`\n        })\n        return `#${index + 1} ${parts.join(', ')}`\n      })\n      return lines.join(' | ')\n    },\n    category: 'input',\n    icon: 'rows',\n    displayNameKey: 'forms.studio.palette.input.group',\n  }\n}\n\nfunction stringifyScalar(value: unknown): string {\n  if (value === null || value === undefined) return ''\n  if (typeof value === 'string') return value\n  if (typeof value === 'number' || typeof value === 'boolean') return String(value)\n  if (Array.isArray(value)) return value.map((entry) => stringifyScalar(entry)).join(', ')\n  return JSON.stringify(value)\n}\n\nfunction readEnLabel(node: FieldNode): string | null {\n  const label = (node as Record<string, unknown>)['x-om-label']\n  if (!isPlainObject(label)) return null\n  const en = label.en\n  if (typeof en === 'string' && en.length > 0) return en\n  for (const value of Object.values(label)) {\n    if (typeof value === 'string' && value.length > 0) return value\n  }\n  return null\n}\n\n/** The `group` spec bound to the default singleton registry. */\nexport const GROUP_TYPE: FieldTypeSpec = createGroupTypeSpec()\n"],
+  "mappings": "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",
+  "names": ["parts"]
+}

package/dist/modules/forms/schema/jsonlogic-grammar.js

@@ -0,0 +1,66 @@
+const COMPARISON_OPS = /* @__PURE__ */ new Set(["==", "!=", "<", "<=", ">", ">=", "===", "!=="]);
+const BOOLEAN_OPS = /* @__PURE__ */ new Set(["and", "or", "not", "!", "!!"]);
+const ARITHMETIC_OPS = /* @__PURE__ */ new Set(["+", "-", "*", "/", "%"]);
+const MEMBERSHIP_OPS = /* @__PURE__ */ new Set(["in"]);
+const VARIABLE_OPS = /* @__PURE__ */ new Set(["var"]);
+const CONDITIONAL_OPS = /* @__PURE__ */ new Set(["if"]);
+const ALLOWED_JSONLOGIC_OPS = /* @__PURE__ */ new Set([
+  ...COMPARISON_OPS,
+  ...BOOLEAN_OPS,
+  ...ARITHMETIC_OPS,
+  ...MEMBERSHIP_OPS,
+  ...VARIABLE_OPS,
+  ...CONDITIONAL_OPS
+]);
+const JSONLOGIC_VAR_NAMESPACES = {
+  hidden: "hidden.",
+  variable: "var."
+};
+function classifyVarPath(path) {
+  if (path.startsWith(JSONLOGIC_VAR_NAMESPACES.variable)) {
+    return { namespace: "variable", name: path.slice(JSONLOGIC_VAR_NAMESPACES.variable.length) };
+  }
+  if (path.startsWith(JSONLOGIC_VAR_NAMESPACES.hidden)) {
+    return { namespace: "hidden", name: path.slice(JSONLOGIC_VAR_NAMESPACES.hidden.length) };
+  }
+  return { namespace: "field", name: path };
+}
+function validateJsonLogicGrammar(expression, maxDepth = 64) {
+  return walk(expression, 0, maxDepth);
+}
+function walk(expr, depth, maxDepth) {
+  if (depth > maxDepth) return "Expression nesting exceeds the depth limit.";
+  if (expr === null || expr === void 0) return null;
+  if (typeof expr !== "object") return null;
+  if (Array.isArray(expr)) {
+    for (const entry of expr) {
+      const message = walk(entry, depth + 1, maxDepth);
+      if (message) return message;
+    }
+    return null;
+  }
+  const keys = Object.keys(expr);
+  if (keys.length === 0) return null;
+  if (keys.length !== 1) {
+    return "jsonlogic expression nodes must have exactly one operator key.";
+  }
+  const op = keys[0];
+  if (!ALLOWED_JSONLOGIC_OPS.has(op)) {
+    return `Operator "${op}" is not allowed by the forms jsonlogic grammar.`;
+  }
+  const args = expr[op];
+  return walk(args, depth + 1, maxDepth);
+}
+export {
+  ALLOWED_JSONLOGIC_OPS,
+  ARITHMETIC_OPS,
+  BOOLEAN_OPS,
+  COMPARISON_OPS,
+  CONDITIONAL_OPS,
+  JSONLOGIC_VAR_NAMESPACES,
+  MEMBERSHIP_OPS,
+  VARIABLE_OPS,
+  classifyVarPath,
+  validateJsonLogicGrammar
+};
+//# sourceMappingURL=jsonlogic-grammar.js.map

package/dist/modules/forms/schema/jsonlogic-grammar.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../src/modules/forms/schema/jsonlogic-grammar.ts"],
+  "sourcesContent": ["/**\n * Forms reactive-core jsonlogic grammar (Q3 decision \u2014 jsonlogic-only).\n *\n * Both the `form-logic-evaluator` runtime and the validators that gate\n * persisted schemas read this allowlist as the single source of truth.\n * Anything outside the grammar is rejected at compile-time (validator) AND\n * at evaluate-time (defence in depth \u2014 R-5 mitigation).\n *\n * The grammar is intentionally small. The set of operators here covers the\n * Tier-1 use cases (visibility, jumps, score variables). Adding a new\n * operator is additive but MUST be reviewed against R-5 (sandbox escape).\n */\n\n/** Comparison + boolean operators (subset of jsonlogic). */\nexport const COMPARISON_OPS = new Set(['==', '!=', '<', '<=', '>', '>=', '===', '!=='])\nexport const BOOLEAN_OPS = new Set(['and', 'or', 'not', '!', '!!'])\nexport const ARITHMETIC_OPS = new Set(['+', '-', '*', '/', '%'])\nexport const MEMBERSHIP_OPS = new Set(['in'])\nexport const VARIABLE_OPS = new Set(['var'])\nexport const CONDITIONAL_OPS = new Set(['if'])\n\n/** Flat allowlist used by both the evaluator and validators. */\nexport const ALLOWED_JSONLOGIC_OPS: ReadonlySet<string> = new Set<string>([\n  ...COMPARISON_OPS,\n  ...BOOLEAN_OPS,\n  ...ARITHMETIC_OPS,\n  ...MEMBERSHIP_OPS,\n  ...VARIABLE_OPS,\n  ...CONDITIONAL_OPS,\n])\n\n/**\n * `var` path namespaces. A bare path (no dot) resolves to a field key under\n * `properties`; the two prefixes route lookups to the hidden-field map or\n * the computed-variable map.\n */\nexport const JSONLOGIC_VAR_NAMESPACES = {\n  hidden: 'hidden.',\n  variable: 'var.',\n} as const\n\nexport type JsonLogicVarNamespace = 'field' | 'hidden' | 'variable'\n\n/**\n * Classifies a `var` path into one of the three namespaces.\n *\n * - `var.<name>` \u2192 `variable`\n * - `hidden.<name>` \u2192 `hidden`\n * - everything else \u2192 `field` (the bare path resolves to a field key, optionally with a deeper sub-path)\n */\nexport function classifyVarPath(path: string): { namespace: JsonLogicVarNamespace; name: string } {\n  if (path.startsWith(JSONLOGIC_VAR_NAMESPACES.variable)) {\n    return { namespace: 'variable', name: path.slice(JSONLOGIC_VAR_NAMESPACES.variable.length) }\n  }\n  if (path.startsWith(JSONLOGIC_VAR_NAMESPACES.hidden)) {\n    return { namespace: 'hidden', name: path.slice(JSONLOGIC_VAR_NAMESPACES.hidden.length) }\n  }\n  return { namespace: 'field', name: path }\n}\n\n/**\n * Validates that an expression uses only operators in the grammar allowlist.\n * Returns `null` when the expression is valid; otherwise returns a message\n * naming the first offending operator.\n *\n * This is a structural walk, not an evaluation \u2014 it does not require any\n * runtime data.\n */\nexport function validateJsonLogicGrammar(expression: unknown, maxDepth = 64): string | null {\n  return walk(expression, 0, maxDepth)\n}\n\nfunction walk(expr: unknown, depth: number, maxDepth: number): string | null {\n  if (depth > maxDepth) return 'Expression nesting exceeds the depth limit.'\n  if (expr === null || expr === undefined) return null\n  if (typeof expr !== 'object') return null\n  if (Array.isArray(expr)) {\n    for (const entry of expr) {\n      const message = walk(entry, depth + 1, maxDepth)\n      if (message) return message\n    }\n    return null\n  }\n  const keys = Object.keys(expr as Record<string, unknown>)\n  if (keys.length === 0) return null\n  if (keys.length !== 1) {\n    return 'jsonlogic expression nodes must have exactly one operator key.'\n  }\n  const op = keys[0]\n  if (!ALLOWED_JSONLOGIC_OPS.has(op)) {\n    return `Operator \"${op}\" is not allowed by the forms jsonlogic grammar.`\n  }\n  const args = (expr as Record<string, unknown>)[op]\n  return walk(args, depth + 1, maxDepth)\n}\n"],
+  "mappings": "AAcO,MAAM,iBAAiB,oBAAI,IAAI,CAAC,MAAM,MAAM,KAAK,MAAM,KAAK,MAAM,OAAO,KAAK,CAAC;AAC/E,MAAM,cAAc,oBAAI,IAAI,CAAC,OAAO,MAAM,OAAO,KAAK,IAAI,CAAC;AAC3D,MAAM,iBAAiB,oBAAI,IAAI,CAAC,KAAK,KAAK,KAAK,KAAK,GAAG,CAAC;AACxD,MAAM,iBAAiB,oBAAI,IAAI,CAAC,IAAI,CAAC;AACrC,MAAM,eAAe,oBAAI,IAAI,CAAC,KAAK,CAAC;AACpC,MAAM,kBAAkB,oBAAI,IAAI,CAAC,IAAI,CAAC;AAGtC,MAAM,wBAA6C,oBAAI,IAAY;AAAA,EACxE,GAAG;AAAA,EACH,GAAG;AAAA,EACH,GAAG;AAAA,EACH,GAAG;AAAA,EACH,GAAG;AAAA,EACH,GAAG;AACL,CAAC;AAOM,MAAM,2BAA2B;AAAA,EACtC,QAAQ;AAAA,EACR,UAAU;AACZ;AAWO,SAAS,gBAAgB,MAAkE;AAChG,MAAI,KAAK,WAAW,yBAAyB,QAAQ,GAAG;AACtD,WAAO,EAAE,WAAW,YAAY,MAAM,KAAK,MAAM,yBAAyB,SAAS,MAAM,EAAE;AAAA,EAC7F;AACA,MAAI,KAAK,WAAW,yBAAyB,MAAM,GAAG;AACpD,WAAO,EAAE,WAAW,UAAU,MAAM,KAAK,MAAM,yBAAyB,OAAO,MAAM,EAAE;AAAA,EACzF;AACA,SAAO,EAAE,WAAW,SAAS,MAAM,KAAK;AAC1C;AAUO,SAAS,yBAAyB,YAAqB,WAAW,IAAmB;AAC1F,SAAO,KAAK,YAAY,GAAG,QAAQ;AACrC;AAEA,SAAS,KAAK,MAAe,OAAe,UAAiC;AAC3E,MAAI,QAAQ,SAAU,QAAO;AAC7B,MAAI,SAAS,QAAQ,SAAS,OAAW,QAAO;AAChD,MAAI,OAAO,SAAS,SAAU,QAAO;AACrC,MAAI,MAAM,QAAQ,IAAI,GAAG;AACvB,eAAW,SAAS,MAAM;AACxB,YAAM,UAAU,KAAK,OAAO,QAAQ,GAAG,QAAQ;AAC/C,UAAI,QAAS,QAAO;AAAA,IACtB;AACA,WAAO;AAAA,EACT;AACA,QAAM,OAAO,OAAO,KAAK,IAA+B;AACxD,MAAI,KAAK,WAAW,EAAG,QAAO;AAC9B,MAAI,KAAK,WAAW,GAAG;AACrB,WAAO;AAAA,EACT;AACA,QAAM,KAAK,KAAK,CAAC;AACjB,MAAI,CAAC,sBAAsB,IAAI,EAAE,GAAG;AAClC,WAAO,aAAa,EAAE;AAAA,EACxB;AACA,QAAM,OAAQ,KAAiC,EAAE;AACjD,SAAO,KAAK,MAAM,QAAQ,GAAG,QAAQ;AACvC;",
+  "names": []
+}