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

package/dist/modules/forms/schema/jsonschema-extensions.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../src/modules/forms/schema/jsonschema-extensions.ts"],
+  "sourcesContent": ["import type Ajv from 'ajv'\nimport { testLinearRegex } from '@open-mercato/shared/lib/regex/linear'\nimport { validateJsonLogicGrammar } from './jsonlogic-grammar'\nimport type { OmFieldStyle, OmSectionStyle, OmTheme } from './style-extensions'\nimport {\n  validateOmFieldStyle,\n  validateOmSectionStyle,\n  validateOmTheme,\n} from './style-validators'\n\n/**\n * Forms v1 JSON Schema extensions (`x-om-*`).\n *\n * The studio writes JSON Schema 7-shaped form definitions and decorates them\n * with these annotation keywords to capture form-specific semantics\n * (per-field role policy, localized labels, sections, sensitivity flag,\n * conditional visibility, etc.). This file centralises the keyword catalog\n * so the compiler, the studio, and the renderer all agree on the v1 surface.\n *\n * The catalog itself is FROZEN: removing or renaming any of these keywords\n * is a BC break (root AGENTS.md \u00A7 Backward Compatibility Contract). Adding\n * a new `x-om-*` keyword is additive and safe.\n */\n\n// ============================================================================\n// Root-level extensions\n// ============================================================================\n\nexport const OM_ROOT_KEYWORDS = {\n  /** Array of role identifiers participating in this form. */\n  roles: 'x-om-roles',\n  /** Role auto-assigned to the actor who starts a submission. */\n  defaultActorRole: 'x-om-default-actor-role',\n  /** Ordered section list \u2014 drives the renderer's step flow. */\n  sections: 'x-om-sections',\n  /** Page rendering mode \u2014 `'stacked'` (default) renders all pages at once; `'paginated'` shows one page at a time. */\n  pageMode: 'x-om-page-mode',\n  /** Locales the form supports (additive, default `['en']`). */\n  supportedLocales: 'x-om-supported-locales',\n  /** Theme density (additive, default `'default'`). Decision 20a. */\n  formStyle: 'x-om-form-style',\n  /** Form-level label position (additive, default `'top'`; mobile collapses `'left'` \u2192 `'top'`). Decision 20b. */\n  formLabelPosition: 'x-om-form-label-position',\n  /** Show progress indicator (additive, default `false`). Active only when paginated AND pages >= 2 (Decision 20c). */\n  showProgress: 'x-om-show-progress',\n  /** Ordered jump rules \u2014 branch from a page/field to a target page, ending, or submit. Reactive-core spec. */\n  jumps: 'x-om-jumps',\n  /** Named computed variables \u2014 render-only, recomputed from answers + hidden + earlier variables. Reactive-core spec. */\n  variables: 'x-om-variables',\n  /** Declared hidden-field context names \u2014 populated from URL query params at runtime. Reactive-core spec. */\n  hiddenFields: 'x-om-hidden-fields',\n  /**\n   * Answer\u2192target mapping (W8 / INT-5). Maps a form field key to a\n   * consumer-side logical target path, e.g. `{ \"allergies\": \"patient.allergies\" }`.\n   * Config-only \u2014 never emitted in events (DP-8: events stay id-only). A\n   * consumer reads this from the version read API and applies the mapping\n   * against answers it fetches from the authed read/export API. Additive.\n   */\n  answerMappings: 'x-om-answer-mappings',\n  /**\n   * Form-wide visual theme (`OmTheme`). Additive, optional \u2014 absent \u21D2 today's\n   * appearance (byte-identical). Custom-styling spec\n   * (`.ai/specs/2026-05-22-forms-custom-styling.md`).\n   */\n  theme: 'x-om-theme',\n} as const\n\n// ============================================================================\n// Field-level extensions\n// ============================================================================\n\nexport const OM_FIELD_KEYWORDS = {\n  /** Field type key (must resolve in the FieldTypeRegistry). */\n  type: 'x-om-type',\n  /** Localized field label: `{ [locale]: string }`. */\n  label: 'x-om-label',\n  /** Localized help text: `{ [locale]: string }`. */\n  help: 'x-om-help',\n  /** Roles allowed to write this field (defaults to `['admin']`). */\n  editableBy: 'x-om-editable-by',\n  /** Roles allowed to read this field (defaults to editableBy \u222A ['admin']). */\n  visibleTo: 'x-om-visible-to',\n  /** Marks the field as sensitive \u2014 triggers redaction + per-field encryption hardening. */\n  sensitive: 'x-om-sensitive',\n  /** jsonlogic expression \u2014 evaluated by the renderer (phase 2c). */\n  visibilityIf: 'x-om-visibility-if',\n  /** Choice list for select_one / select_many: `[{ value, label: { [locale]: string } }]`. */\n  options: 'x-om-options',\n  /** Lower bound for scale / number fields. */\n  min: 'x-om-min',\n  /** Upper bound for scale / number fields. */\n  max: 'x-om-max',\n  /** uiSchema widget override. */\n  widget: 'x-om-widget',\n  /**\n   * Persisted column span within the parent section's grid (1..4). Read-time\n   * clamping against the section's `columns` is the renderer's job \u2014 the\n   * validator never rewrites the persisted value (Decision 3a).\n   */\n  gridSpan: 'x-om-grid-span',\n  /** Field alignment within its grid cell. Wired by Phase D \u2014 keyword declared now for forward consistency. */\n  align: 'x-om-align',\n  /** Hide the field on mobile viewport only. Wired by Phase D \u2014 keyword declared now for forward consistency. */\n  hideMobile: 'x-om-hide-mobile',\n  /** Regex source for string-typed fields. Tier-2 spec \u2014 additive. */\n  pattern: 'x-om-pattern',\n  /** Minimum string length for string-typed fields. Tier-2 spec \u2014 additive. */\n  minLength: 'x-om-min-length',\n  /** Maximum string length for string-typed fields. Tier-2 spec \u2014 additive. */\n  maxLength: 'x-om-max-length',\n  /** Localised custom validation messages: `{ [locale]: { [ruleType]: string } }`. Tier-2 spec \u2014 additive. */\n  validationMessages: 'x-om-validation-messages',\n  /** Icon style for opinion_scale renderer: `'star' | 'dot' | 'thumb'`. Tier-2 Phase D \u2014 additive. */\n  opinionIcon: 'x-om-opinion-icon',\n  /** NPS anchor captions: `{ low: LocalizedText, high: LocalizedText }`. Tier-2 Phase D \u2014 additive. */\n  npsAnchors: 'x-om-nps-anchors',\n  /** Require every option ranked on a `ranking` field. Tier-2 Phase E \u2014 additive. */\n  rankingExhaustive: 'x-om-ranking-exhaustive',\n  /** Row descriptors for a `matrix` field: `[{ key, label, multiple?, required? }]`. Tier-2 Phase F \u2014 additive. */\n  matrixRows: 'x-om-matrix-rows',\n  /** Column descriptors for a `matrix` field: `[{ value, label }]`. Tier-2 Phase F \u2014 additive. */\n  matrixColumns: 'x-om-matrix-columns',\n  /** Accepted MIME types for a `file` field: `string[]` (empty/absent \u21D2 any). W4 \u2014 additive. */\n  accept: 'x-om-accept',\n  /** Per-field maximum upload size in bytes for a `file` field. W4 \u2014 additive. */\n  maxSizeBytes: 'x-om-max-size-bytes',\n  /** Allow multiple files on a `file` field (default `false`). W4 \u2014 additive. */\n  multiple: 'x-om-multiple',\n  /** Consent clause shown above a `signature` field: `{ [locale]: string }`. W2 \u2014 additive. */\n  consentClause: 'x-om-consent-clause',\n  /** Allowed capture modes on a `signature` field: `('drawn'|'typed')[]` (default both). W2 \u2014 additive. */\n  signatureModes: 'x-om-signature-modes',\n  /** Minimum repeated-entry count for a `group` (repeatable) field. W6 \u2014 additive. */\n  minItems: 'x-om-min-items',\n  /** Maximum repeated-entry count for a `group` (repeatable) field. W6 \u2014 additive. */\n  maxItems: 'x-om-max-items',\n  /**\n   * Logical attribute key the `PrefillResolver` resolves at submission start\n   * (W8 / FD-1), e.g. `\"name\"`, `\"email\"`, `\"dob\"`. When set, the start route\n   * asks the injected resolver for this attribute and seeds the field's initial\n   * value (role-filtered + AJV-validated). Non-empty string. Additive.\n   */\n  prefill: 'x-om-prefill',\n  /**\n   * Per-field visual emphasis (`OmFieldStyle`). Additive, optional. Custom-styling\n   * spec (`.ai/specs/2026-05-22-forms-custom-styling.md`).\n   */\n  style: 'x-om-style',\n} as const\n\nexport type OmRootKeyword = (typeof OM_ROOT_KEYWORDS)[keyof typeof OM_ROOT_KEYWORDS]\nexport type OmFieldKeyword = (typeof OM_FIELD_KEYWORDS)[keyof typeof OM_FIELD_KEYWORDS]\n\n/** Flat list of every keyword the v1 grammar declares. */\nexport const OM_ALL_KEYWORDS: readonly string[] = [\n  ...Object.values(OM_ROOT_KEYWORDS),\n  ...Object.values(OM_FIELD_KEYWORDS),\n]\n\n// ============================================================================\n// TypeScript shapes\n// ============================================================================\n\nexport type LocalizedText = Record<string, string>\n\nexport type OmSectionKind = 'page' | 'section' | 'ending'\nexport type OmSectionColumns = 1 | 2 | 3 | 4\nexport type OmSectionGap = 'sm' | 'md' | 'lg'\n\nexport type OmSection = {\n  key: string\n  title: LocalizedText\n  fieldKeys: string[]\n  /** `'page'` marks a page boundary; `'section'` (default) is a regular group; `'ending'` is a terminal screen reached via jumps. */\n  kind?: OmSectionKind\n  /** Number of grid columns inside this section. Default `1`, applied at read time. Decision 9. */\n  columns?: OmSectionColumns\n  /** Grid gap mapping. Default `'md'`, applied at read time. Decision 9. */\n  gap?: OmSectionGap\n  /** When `true`, render a `Separator` below the section header. Decision 9. */\n  divider?: boolean\n  /** Suppress the section H2 even when `title` is non-empty. Decision 7b. */\n  hideTitle?: boolean\n  /** Section-level visibility predicate (reactive-core spec). Hidden sections cascade \u2014 their fields are treated as hidden too. Disallowed on `kind: 'ending'`. */\n  'x-om-visibility-if'?: unknown\n  /** Optional absolute or relative URL to redirect to after submit. Only valid when `kind === 'ending'`. */\n  'x-om-redirect-url'?: string | null\n  /** Per-section visual style (additive, optional). Custom-styling spec. */\n  style?: OmSectionStyle\n}\n\nexport type OmJumpTarget =\n  | { type: 'page'; pageKey: string }\n  | { type: 'ending'; endingKey: string }\n  | { type: 'next' }\n  | { type: 'submit' }\n\nexport type OmJumpRule = {\n  from: { type: 'page'; pageKey: string } | { type: 'field'; fieldKey: string }\n  rules: Array<{ if: unknown; goto: OmJumpTarget }>\n  otherwise?: OmJumpTarget\n}\n\nexport type OmFormVariableType = 'number' | 'boolean' | 'string'\n\nexport type OmFormVariable = {\n  name: string\n  type: OmFormVariableType\n  formula: unknown\n  default?: number | boolean | string\n}\n\nexport type OmHiddenFieldDecl = {\n  name: string\n  defaultValue?: string\n}\n\nexport type OmPageMode = 'stacked' | 'paginated'\nexport type OmFormStyle = 'default' | 'compact' | 'spacious'\nexport type OmFormLabelPosition = 'top' | 'left'\n\nexport type OmRootExtensions = {\n  [OM_ROOT_KEYWORDS.roles]?: string[]\n  [OM_ROOT_KEYWORDS.defaultActorRole]?: string\n  [OM_ROOT_KEYWORDS.sections]?: OmSection[]\n  [OM_ROOT_KEYWORDS.pageMode]?: OmPageMode\n  [OM_ROOT_KEYWORDS.supportedLocales]?: string[]\n  [OM_ROOT_KEYWORDS.formStyle]?: OmFormStyle\n  [OM_ROOT_KEYWORDS.formLabelPosition]?: OmFormLabelPosition\n  [OM_ROOT_KEYWORDS.showProgress]?: boolean\n  [OM_ROOT_KEYWORDS.jumps]?: OmJumpRule[]\n  [OM_ROOT_KEYWORDS.variables]?: OmFormVariable[]\n  [OM_ROOT_KEYWORDS.hiddenFields]?: OmHiddenFieldDecl[]\n  [OM_ROOT_KEYWORDS.answerMappings]?: OmAnswerMappings\n  [OM_ROOT_KEYWORDS.theme]?: OmTheme\n}\n\n/** W8 / INT-5 \u2014 `{ [fieldKey]: targetPath }`. */\nexport type OmAnswerMappings = Record<string, string>\n\nexport type OmFieldOption = {\n  value: string\n  label: LocalizedText\n}\n\nexport type OmFieldGridSpan = 1 | 2 | 3 | 4\nexport type OmFieldAlign = 'start' | 'center' | 'end'\n\nexport type OmFieldExtensions = {\n  [OM_FIELD_KEYWORDS.type]?: string\n  [OM_FIELD_KEYWORDS.label]?: LocalizedText\n  [OM_FIELD_KEYWORDS.help]?: LocalizedText\n  [OM_FIELD_KEYWORDS.editableBy]?: string[]\n  [OM_FIELD_KEYWORDS.visibleTo]?: string[]\n  [OM_FIELD_KEYWORDS.sensitive]?: boolean\n  [OM_FIELD_KEYWORDS.visibilityIf]?: unknown\n  [OM_FIELD_KEYWORDS.options]?: OmFieldOption[]\n  [OM_FIELD_KEYWORDS.min]?: number\n  [OM_FIELD_KEYWORDS.max]?: number\n  [OM_FIELD_KEYWORDS.widget]?: string\n  [OM_FIELD_KEYWORDS.gridSpan]?: OmFieldGridSpan\n  [OM_FIELD_KEYWORDS.align]?: OmFieldAlign\n  [OM_FIELD_KEYWORDS.hideMobile]?: boolean\n  [OM_FIELD_KEYWORDS.pattern]?: string\n  [OM_FIELD_KEYWORDS.minLength]?: number\n  [OM_FIELD_KEYWORDS.maxLength]?: number\n  [OM_FIELD_KEYWORDS.validationMessages]?: OmValidationMessages\n  [OM_FIELD_KEYWORDS.opinionIcon]?: OmOpinionIcon\n  [OM_FIELD_KEYWORDS.npsAnchors]?: OmNpsAnchors\n  [OM_FIELD_KEYWORDS.rankingExhaustive]?: boolean\n  [OM_FIELD_KEYWORDS.matrixRows]?: OmMatrixRow[]\n  [OM_FIELD_KEYWORDS.matrixColumns]?: OmMatrixColumn[]\n  [OM_FIELD_KEYWORDS.accept]?: string[]\n  [OM_FIELD_KEYWORDS.maxSizeBytes]?: number\n  [OM_FIELD_KEYWORDS.multiple]?: boolean\n  [OM_FIELD_KEYWORDS.consentClause]?: LocalizedText\n  [OM_FIELD_KEYWORDS.signatureModes]?: OmSignatureMode[]\n  [OM_FIELD_KEYWORDS.minItems]?: number\n  [OM_FIELD_KEYWORDS.maxItems]?: number\n  [OM_FIELD_KEYWORDS.prefill]?: string\n  [OM_FIELD_KEYWORDS.style]?: OmFieldStyle\n}\n\nexport type OmSignatureMode = 'drawn' | 'typed'\n\nexport type OmMatrixRow = {\n  key: string\n  label: LocalizedText\n  multiple?: boolean\n  required?: boolean\n}\n\nexport type OmMatrixColumn = {\n  value: string\n  label: LocalizedText\n}\n\n/** R-3 soft caps \u2014 matrix grows quadratically; cap the persisted bytes early. */\nexport const MATRIX_ROWS_SOFT_CAP = 30\nexport const MATRIX_COLUMNS_SOFT_CAP = 10\n\n/** R-3 soft cap \u2014 a group's `x-om-max-items` ceiling (repeatable entries). W6. */\nexport const GROUP_MAX_ITEMS_SOFT_CAP = 50\n\nexport type OmOpinionIcon = 'star' | 'dot' | 'thumb'\n\nexport type OmNpsAnchors = {\n  low: LocalizedText\n  high: LocalizedText\n}\n\n/**\n * Allowed rule names inside `x-om-validation-messages[locale]`. The compiler\n * surfaces matching defaults for every entry; missing locales fall back to\n * `en` and then to the generic English defaults registered in the\n * `field-validation-service`.\n */\nexport const OM_VALIDATION_MESSAGE_RULE_NAMES: ReadonlySet<string> = new Set([\n  'pattern',\n  'minLength',\n  'maxLength',\n  'minValue',\n  'maxValue',\n  'format',\n  'rankingExhaustive',\n  'matrixRowsRequired',\n])\n\nexport type OmValidationMessages = Record<string, Record<string, string>>\n\n// ============================================================================\n// Static meta-schema fragments \u2014 used by the compiler to validate the OM\n// extension payload independently of the underlying JSON Schema rules.\n// ============================================================================\n\n/**\n * Per-keyword type predicates. Used by `validateOmExtensions(...)` below to\n * report `{ keyword, message }` errors without dragging in a full JSON Schema\n * runtime \u2014 the OM grammar is small enough that explicit validators are\n * clearer than a meta-schema.\n */\nconst localizedTextValid = (value: unknown): boolean =>\n  typeof value === 'object'\n  && value !== null\n  && !Array.isArray(value)\n  && Object.values(value as Record<string, unknown>).every((entry) => typeof entry === 'string')\n\nconst stringArrayValid = (value: unknown): boolean =>\n  Array.isArray(value) && value.every((entry) => typeof entry === 'string')\n\nconst VALID_SECTION_KINDS: ReadonlySet<string> = new Set(['page', 'section', 'ending'])\nconst VARIABLE_NAME_PATTERN = /^[a-z][a-z0-9_]*$/\nconst VALID_VARIABLE_TYPES: ReadonlySet<string> = new Set(['number', 'boolean', 'string'])\nconst VALID_JUMP_TARGET_TYPES: ReadonlySet<string> = new Set(['page', 'ending', 'next', 'submit'])\nconst VALID_JUMP_FROM_TYPES: ReadonlySet<string> = new Set(['page', 'field'])\n\nfunction isJumpTargetValid(value: unknown): boolean {\n  if (!value || typeof value !== 'object') return false\n  const candidate = value as Record<string, unknown>\n  if (typeof candidate.type !== 'string' || !VALID_JUMP_TARGET_TYPES.has(candidate.type)) return false\n  if (candidate.type === 'page') return typeof candidate.pageKey === 'string' && candidate.pageKey.length > 0\n  if (candidate.type === 'ending') return typeof candidate.endingKey === 'string' && candidate.endingKey.length > 0\n  return true\n}\nconst VALID_SECTION_COLUMNS: ReadonlySet<number> = new Set([1, 2, 3, 4])\nconst VALID_SECTION_GAPS: ReadonlySet<string> = new Set(['sm', 'md', 'lg'])\nconst VALID_FIELD_GRID_SPANS: ReadonlySet<number> = new Set([1, 2, 3, 4])\nconst VALID_FIELD_ALIGN: ReadonlySet<string> = new Set(['start', 'center', 'end'])\nconst VALID_PAGE_MODES: ReadonlySet<string> = new Set(['stacked', 'paginated'])\nconst VALID_FORM_STYLES: ReadonlySet<string> = new Set(['default', 'compact', 'spacious'])\nconst VALID_FORM_LABEL_POSITIONS: ReadonlySet<string> = new Set(['top', 'left'])\n\nexport type OmExtensionViolation = {\n  keyword: string\n  path: string[]\n  message: string\n}\n\nexport const OM_ROOT_VALIDATORS: Record<OmRootKeyword, (value: unknown) => string | null> = {\n  [OM_ROOT_KEYWORDS.roles]: (value) =>\n    stringArrayValid(value) ? null : 'x-om-roles must be an array of role identifiers (strings).',\n  [OM_ROOT_KEYWORDS.defaultActorRole]: (value) =>\n    typeof value === 'string' ? null : 'x-om-default-actor-role must be a role identifier string.',\n  [OM_ROOT_KEYWORDS.sections]: (value) => {\n    if (!Array.isArray(value)) return 'x-om-sections must be an array of section descriptors.'\n    const seenKeys = new Set<string>()\n    for (const section of value) {\n      if (!section || typeof section !== 'object') return 'Each section must be an object.'\n      const candidate = section as Record<string, unknown>\n      if (typeof candidate.key !== 'string') return 'Each section must declare a string `key`.'\n      if (seenKeys.has(candidate.key)) {\n        return `Duplicate section key \"${candidate.key}\" \u2014 section keys must be unique within x-om-sections.`\n      }\n      seenKeys.add(candidate.key)\n      if (!localizedTextValid(candidate.title)) return 'Each section must declare a localized `title` map.'\n      if (!stringArrayValid(candidate.fieldKeys)) return 'Each section must declare a string array `fieldKeys`.'\n      if (candidate.kind !== undefined) {\n        if (typeof candidate.kind !== 'string' || !VALID_SECTION_KINDS.has(candidate.kind)) {\n          return 'Section `kind` must be \"page\", \"section\", or \"ending\" when present.'\n        }\n      }\n      if (candidate.columns !== undefined) {\n        if (typeof candidate.columns !== 'number' || !VALID_SECTION_COLUMNS.has(candidate.columns)) {\n          return 'Section `columns` must be an integer in [1, 4] when present.'\n        }\n      }\n      if (candidate.gap !== undefined) {\n        if (typeof candidate.gap !== 'string' || !VALID_SECTION_GAPS.has(candidate.gap)) {\n          return 'Section `gap` must be \"sm\", \"md\", or \"lg\" when present.'\n        }\n      }\n      if (candidate.divider !== undefined && typeof candidate.divider !== 'boolean') {\n        return 'Section `divider` must be a boolean when present.'\n      }\n      if (candidate.hideTitle !== undefined && typeof candidate.hideTitle !== 'boolean') {\n        return 'Section `hideTitle` must be a boolean when present.'\n      }\n      if (candidate.style !== undefined) {\n        const styleMessage = validateOmSectionStyle(candidate.style)\n        if (styleMessage) return `Section \"${candidate.key}\" style: ${styleMessage}`\n      }\n      const redirect = candidate['x-om-redirect-url']\n      if (redirect !== undefined) {\n        if (candidate.kind !== 'ending') {\n          return `Section \"${candidate.key}\" declares x-om-redirect-url but kind is not \"ending\".`\n        }\n        if (redirect !== null && typeof redirect !== 'string') {\n          return `Section \"${candidate.key}\" x-om-redirect-url must be a string or null when present.`\n        }\n      }\n      if (candidate.kind === 'ending' && candidate['x-om-visibility-if'] !== undefined) {\n        return `Ending section \"${candidate.key}\" must not declare x-om-visibility-if \u2014 endings are reached via jumps only.`\n      }\n    }\n    return null\n  },\n  [OM_ROOT_KEYWORDS.pageMode]: (value) =>\n    typeof value === 'string' && VALID_PAGE_MODES.has(value)\n      ? null\n      : 'x-om-page-mode must be \"stacked\" or \"paginated\".',\n  [OM_ROOT_KEYWORDS.supportedLocales]: (value) =>\n    stringArrayValid(value) ? null : 'x-om-supported-locales must be an array of locale strings.',\n  [OM_ROOT_KEYWORDS.formStyle]: (value) =>\n    typeof value === 'string' && VALID_FORM_STYLES.has(value)\n      ? null\n      : 'x-om-form-style must be \"default\", \"compact\", or \"spacious\".',\n  [OM_ROOT_KEYWORDS.formLabelPosition]: (value) =>\n    typeof value === 'string' && VALID_FORM_LABEL_POSITIONS.has(value)\n      ? null\n      : 'x-om-form-label-position must be \"top\" or \"left\".',\n  [OM_ROOT_KEYWORDS.showProgress]: (value) =>\n    typeof value === 'boolean' ? null : 'x-om-show-progress must be a boolean.',\n  [OM_ROOT_KEYWORDS.jumps]: (value) => {\n    if (!Array.isArray(value)) return 'x-om-jumps must be an array of jump rules.'\n    for (const entry of value) {\n      if (!entry || typeof entry !== 'object') return 'Each jump rule must be an object.'\n      const candidate = entry as Record<string, unknown>\n      const from = candidate.from\n      if (!from || typeof from !== 'object') {\n        return 'Each jump rule must declare a `from` source object.'\n      }\n      const fromCandidate = from as Record<string, unknown>\n      if (typeof fromCandidate.type !== 'string' || !VALID_JUMP_FROM_TYPES.has(fromCandidate.type)) {\n        return 'Jump rule `from.type` must be \"page\" or \"field\".'\n      }\n      if (fromCandidate.type === 'page' && typeof fromCandidate.pageKey !== 'string') {\n        return 'Jump rule with `from.type` \"page\" must declare `from.pageKey` string.'\n      }\n      if (fromCandidate.type === 'field' && typeof fromCandidate.fieldKey !== 'string') {\n        return 'Jump rule with `from.type` \"field\" must declare `from.fieldKey` string.'\n      }\n      if (!Array.isArray(candidate.rules)) {\n        return 'Jump rule must declare a `rules` array.'\n      }\n      for (const rule of candidate.rules) {\n        if (!rule || typeof rule !== 'object') return 'Each jump entry must be an object.'\n        const ruleCandidate = rule as Record<string, unknown>\n        if (!('if' in ruleCandidate)) return 'Each jump entry must declare an `if` predicate.'\n        if (!isJumpTargetValid(ruleCandidate.goto)) return 'Each jump entry must declare a valid `goto` target.'\n      }\n      if (candidate.otherwise !== undefined && !isJumpTargetValid(candidate.otherwise)) {\n        return 'Jump rule `otherwise` must be a valid jump target when present.'\n      }\n    }\n    return null\n  },\n  [OM_ROOT_KEYWORDS.variables]: (value) => {\n    if (!Array.isArray(value)) return 'x-om-variables must be an array of variable declarations.'\n    const seenNames = new Set<string>()\n    for (const entry of value) {\n      if (!entry || typeof entry !== 'object') return 'Each variable must be an object.'\n      const candidate = entry as Record<string, unknown>\n      if (typeof candidate.name !== 'string' || !VARIABLE_NAME_PATTERN.test(candidate.name)) {\n        return 'Each variable must declare a `name` matching /^[a-z][a-z0-9_]*$/.'\n      }\n      if (seenNames.has(candidate.name)) {\n        return `Duplicate variable name \"${candidate.name}\".`\n      }\n      seenNames.add(candidate.name)\n      if (typeof candidate.type !== 'string' || !VALID_VARIABLE_TYPES.has(candidate.type)) {\n        return `Variable \"${candidate.name}\" type must be \"number\", \"boolean\", or \"string\".`\n      }\n      if (!('formula' in candidate)) {\n        return `Variable \"${candidate.name}\" must declare a \\`formula\\`.`\n      }\n      if (candidate.default !== undefined) {\n        const t = candidate.type\n        const d = candidate.default\n        if (t === 'number' && typeof d !== 'number') return `Variable \"${candidate.name}\" default must be a number.`\n        if (t === 'boolean' && typeof d !== 'boolean') return `Variable \"${candidate.name}\" default must be a boolean.`\n        if (t === 'string' && typeof d !== 'string') return `Variable \"${candidate.name}\" default must be a string.`\n      }\n    }\n    return null\n  },\n  [OM_ROOT_KEYWORDS.hiddenFields]: (value) => {\n    if (!Array.isArray(value)) return 'x-om-hidden-fields must be an array of declarations.'\n    const seenNames = new Set<string>()\n    for (const entry of value) {\n      if (!entry || typeof entry !== 'object') return 'Each hidden field must be an object.'\n      const candidate = entry as Record<string, unknown>\n      if (typeof candidate.name !== 'string' || !VARIABLE_NAME_PATTERN.test(candidate.name)) {\n        return 'Each hidden field must declare a `name` matching /^[a-z][a-z0-9_]*$/.'\n      }\n      if (seenNames.has(candidate.name)) {\n        return `Duplicate hidden field name \"${candidate.name}\".`\n      }\n      seenNames.add(candidate.name)\n      if (candidate.defaultValue !== undefined && typeof candidate.defaultValue !== 'string') {\n        return `Hidden field \"${candidate.name}\" defaultValue must be a string when present.`\n      }\n    }\n    return null\n  },\n  [OM_ROOT_KEYWORDS.answerMappings]: (value) => {\n    if (!value || typeof value !== 'object' || Array.isArray(value)) {\n      return 'x-om-answer-mappings must be a `{ [fieldKey]: targetPath }` map.'\n    }\n    for (const [fieldKey, targetPath] of Object.entries(value as Record<string, unknown>)) {\n      if (fieldKey.length === 0) {\n        return 'x-om-answer-mappings field keys must be non-empty strings.'\n      }\n      if (typeof targetPath !== 'string' || targetPath.length === 0) {\n        return `x-om-answer-mappings[\"${fieldKey}\"] must be a non-empty target-path string.`\n      }\n    }\n    return null\n  },\n  [OM_ROOT_KEYWORDS.theme]: (value) => validateOmTheme(value),\n}\n\nexport const OM_FIELD_VALIDATORS: Record<OmFieldKeyword, (value: unknown) => string | null> = {\n  [OM_FIELD_KEYWORDS.type]: (value) =>\n    typeof value === 'string' && value.length > 0 ? null : 'x-om-type must be a non-empty string.',\n  [OM_FIELD_KEYWORDS.label]: (value) =>\n    localizedTextValid(value) ? null : 'x-om-label must be a `{ [locale]: string }` map.',\n  [OM_FIELD_KEYWORDS.help]: (value) =>\n    localizedTextValid(value) ? null : 'x-om-help must be a `{ [locale]: string }` map.',\n  [OM_FIELD_KEYWORDS.editableBy]: (value) =>\n    stringArrayValid(value) ? null : 'x-om-editable-by must be an array of role identifiers (strings).',\n  [OM_FIELD_KEYWORDS.visibleTo]: (value) =>\n    stringArrayValid(value) ? null : 'x-om-visible-to must be an array of role identifiers (strings).',\n  [OM_FIELD_KEYWORDS.sensitive]: (value) =>\n    typeof value === 'boolean' ? null : 'x-om-sensitive must be a boolean.',\n  [OM_FIELD_KEYWORDS.visibilityIf]: () => null, // jsonlogic \u2014 validated when phase 2c lands.\n  [OM_FIELD_KEYWORDS.options]: (value) => {\n    if (!Array.isArray(value)) return 'x-om-options must be an array of `{ value, label }` entries.'\n    for (const option of value) {\n      if (!option || typeof option !== 'object') return 'Each option must be an object.'\n      const candidate = option as Record<string, unknown>\n      if (typeof candidate.value !== 'string') return 'Each option must declare a string `value`.'\n      if (!localizedTextValid(candidate.label)) return 'Each option must declare a localized `label` map.'\n    }\n    return null\n  },\n  [OM_FIELD_KEYWORDS.min]: (value) =>\n    typeof value === 'number' && Number.isFinite(value) ? null : 'x-om-min must be a finite number.',\n  [OM_FIELD_KEYWORDS.max]: (value) =>\n    typeof value === 'number' && Number.isFinite(value) ? null : 'x-om-max must be a finite number.',\n  [OM_FIELD_KEYWORDS.widget]: (value) =>\n    typeof value === 'string' ? null : 'x-om-widget must be a widget identifier string.',\n  [OM_FIELD_KEYWORDS.gridSpan]: (value) =>\n    typeof value === 'number' && Number.isInteger(value) && VALID_FIELD_GRID_SPANS.has(value)\n      ? null\n      : 'x-om-grid-span must be an integer in [1, 4].',\n  [OM_FIELD_KEYWORDS.align]: (value) =>\n    typeof value === 'string' && VALID_FIELD_ALIGN.has(value)\n      ? null\n      : 'x-om-align must be \"start\", \"center\", or \"end\".',\n  [OM_FIELD_KEYWORDS.hideMobile]: (value) =>\n    typeof value === 'boolean' ? null : 'x-om-hide-mobile must be a boolean.',\n  [OM_FIELD_KEYWORDS.pattern]: (value) => {\n    if (typeof value !== 'string' || value.length === 0) {\n      return 'x-om-pattern must be a non-empty regex source string.'\n    }\n    if (!testLinearRegex(value, '').ok) {\n      return 'x-om-pattern must compile as a bounded linear-time regular expression.'\n    }\n    return null\n  },\n  [OM_FIELD_KEYWORDS.minLength]: (value) =>\n    typeof value === 'number' && Number.isInteger(value) && value >= 0\n      ? null\n      : 'x-om-min-length must be a non-negative integer.',\n  [OM_FIELD_KEYWORDS.maxLength]: (value) =>\n    typeof value === 'number' && Number.isInteger(value) && value >= 0\n      ? null\n      : 'x-om-max-length must be a non-negative integer.',\n  [OM_FIELD_KEYWORDS.validationMessages]: (value) => {\n    if (!value || typeof value !== 'object' || Array.isArray(value)) {\n      return 'x-om-validation-messages must be a `{ [locale]: { [rule]: string } }` map.'\n    }\n    for (const [locale, inner] of Object.entries(value as Record<string, unknown>)) {\n      if (locale.length === 0) {\n        return 'x-om-validation-messages locale keys must be non-empty strings.'\n      }\n      if (!inner || typeof inner !== 'object' || Array.isArray(inner)) {\n        return `x-om-validation-messages[\"${locale}\"] must be a `\n          + '`{ [rule]: string }` map.'\n      }\n      for (const [rule, message] of Object.entries(inner as Record<string, unknown>)) {\n        if (!OM_VALIDATION_MESSAGE_RULE_NAMES.has(rule)) {\n          return `x-om-validation-messages[\"${locale}\"][\"${rule}\"] is not a recognized rule.`\n        }\n        if (typeof message !== 'string' || message.length === 0) {\n          return `x-om-validation-messages[\"${locale}\"][\"${rule}\"] must be a non-empty string.`\n        }\n      }\n    }\n    return null\n  },\n  [OM_FIELD_KEYWORDS.opinionIcon]: (value) =>\n    value === 'star' || value === 'dot' || value === 'thumb'\n      ? null\n      : 'x-om-opinion-icon must be \"star\", \"dot\", or \"thumb\".',\n  [OM_FIELD_KEYWORDS.npsAnchors]: (value) => {\n    if (!value || typeof value !== 'object' || Array.isArray(value)) {\n      return 'x-om-nps-anchors must be a `{ low, high }` object.'\n    }\n    const candidate = value as Record<string, unknown>\n    if (!('low' in candidate) || !('high' in candidate)) {\n      return 'x-om-nps-anchors must declare both `low` and `high` anchor maps.'\n    }\n    if (!localizedTextValid(candidate.low)) {\n      return 'x-om-nps-anchors.low must be a `{ [locale]: string }` map.'\n    }\n    if (!localizedTextValid(candidate.high)) {\n      return 'x-om-nps-anchors.high must be a `{ [locale]: string }` map.'\n    }\n    return null\n  },\n  [OM_FIELD_KEYWORDS.rankingExhaustive]: (value) =>\n    typeof value === 'boolean' ? null : 'x-om-ranking-exhaustive must be a boolean.',\n  [OM_FIELD_KEYWORDS.matrixRows]: (value) => {\n    if (!Array.isArray(value)) return 'x-om-matrix-rows must be an array of `{ key, label }` entries.'\n    const seenKeys = new Set<string>()\n    for (const entry of value) {\n      if (!entry || typeof entry !== 'object' || Array.isArray(entry)) {\n        return 'Each matrix row must be an object.'\n      }\n      const candidate = entry as Record<string, unknown>\n      if (typeof candidate.key !== 'string' || !MATRIX_ROW_KEY_PATTERN.test(candidate.key)) {\n        return 'Each matrix row must declare a `key` matching /^[a-z][a-z0-9_]*$/.'\n      }\n      if (seenKeys.has(candidate.key)) {\n        return `Duplicate matrix row key \"${candidate.key}\".`\n      }\n      seenKeys.add(candidate.key)\n      if (!localizedTextValid(candidate.label)) {\n        return `Matrix row \"${candidate.key}\" must declare a localized \\`label\\` map.`\n      }\n      if (candidate.multiple !== undefined && typeof candidate.multiple !== 'boolean') {\n        return `Matrix row \"${candidate.key}\" \\`multiple\\` must be a boolean when present.`\n      }\n      if (candidate.required !== undefined && typeof candidate.required !== 'boolean') {\n        return `Matrix row \"${candidate.key}\" \\`required\\` must be a boolean when present.`\n      }\n    }\n    return null\n  },\n  [OM_FIELD_KEYWORDS.matrixColumns]: (value) => {\n    if (!Array.isArray(value)) return 'x-om-matrix-columns must be an array of `{ value, label }` entries.'\n    const seenValues = new Set<string>()\n    for (const entry of value) {\n      if (!entry || typeof entry !== 'object' || Array.isArray(entry)) {\n        return 'Each matrix column must be an object.'\n      }\n      const candidate = entry as Record<string, unknown>\n      if (typeof candidate.value !== 'string' || candidate.value.length === 0) {\n        return 'Each matrix column must declare a non-empty string `value`.'\n      }\n      if (seenValues.has(candidate.value)) {\n        return `Duplicate matrix column value \"${candidate.value}\".`\n      }\n      seenValues.add(candidate.value)\n      if (!localizedTextValid(candidate.label)) {\n        return `Matrix column \"${candidate.value}\" must declare a localized \\`label\\` map.`\n      }\n    }\n    return null\n  },\n  [OM_FIELD_KEYWORDS.accept]: (value) => {\n    if (!Array.isArray(value)) return 'x-om-accept must be an array of MIME type strings.'\n    for (const entry of value) {\n      if (typeof entry !== 'string' || entry.length === 0) {\n        return 'Each x-om-accept entry must be a non-empty MIME type string.'\n      }\n    }\n    return null\n  },\n  [OM_FIELD_KEYWORDS.maxSizeBytes]: (value) =>\n    typeof value === 'number' && Number.isInteger(value) && value > 0\n      ? null\n      : 'x-om-max-size-bytes must be a positive integer.',\n  [OM_FIELD_KEYWORDS.multiple]: (value) =>\n    typeof value === 'boolean' ? null : 'x-om-multiple must be a boolean.',\n  [OM_FIELD_KEYWORDS.consentClause]: (value) =>\n    localizedTextValid(value)\n      ? null\n      : 'x-om-consent-clause must be a `{ [locale]: string }` map.',\n  [OM_FIELD_KEYWORDS.signatureModes]: (value) => {\n    if (!Array.isArray(value) || value.length === 0) {\n      return 'x-om-signature-modes must be a non-empty array of \"drawn\" / \"typed\".'\n    }\n    const seen = new Set<string>()\n    for (const entry of value) {\n      if (entry !== 'drawn' && entry !== 'typed') {\n        return 'Each x-om-signature-modes entry must be \"drawn\" or \"typed\".'\n      }\n      if (seen.has(entry)) {\n        return `Duplicate x-om-signature-modes entry \"${entry}\".`\n      }\n      seen.add(entry)\n    }\n    return null\n  },\n  [OM_FIELD_KEYWORDS.minItems]: (value) =>\n    typeof value === 'number' && Number.isInteger(value) && value >= 0\n      ? null\n      : 'x-om-min-items must be a non-negative integer.',\n  [OM_FIELD_KEYWORDS.maxItems]: (value) =>\n    typeof value === 'number' && Number.isInteger(value) && value >= 1\n      ? null\n      : 'x-om-max-items must be a positive integer.',\n  [OM_FIELD_KEYWORDS.prefill]: (value) =>\n    typeof value === 'string' && value.length > 0\n      ? null\n      : 'x-om-prefill must be a non-empty logical attribute key string.',\n  [OM_FIELD_KEYWORDS.style]: (value) => validateOmFieldStyle(value),\n}\n\nconst MATRIX_ROW_KEY_PATTERN = /^[a-z][a-z0-9_]*$/\n\n// ============================================================================\n// Cross-keyword validation \u2014 collisions between identifier namespaces and\n// jsonlogic grammar checks on persisted expressions. Returns the first\n// violation message or `null` when the schema is consistent.\n// ============================================================================\n\nexport function validateOmCrossKeyword(schema: Record<string, unknown>): string | null {\n  const propertyKeys = readPropertyKeys(schema)\n  const sections = Array.isArray(schema[OM_ROOT_KEYWORDS.sections])\n    ? (schema[OM_ROOT_KEYWORDS.sections] as Array<Record<string, unknown>>)\n    : []\n  const hiddenDecls = Array.isArray(schema[OM_ROOT_KEYWORDS.hiddenFields])\n    ? (schema[OM_ROOT_KEYWORDS.hiddenFields] as Array<Record<string, unknown>>)\n    : []\n  const variableDecls = Array.isArray(schema[OM_ROOT_KEYWORDS.variables])\n    ? (schema[OM_ROOT_KEYWORDS.variables] as Array<Record<string, unknown>>)\n    : []\n  const jumps = Array.isArray(schema[OM_ROOT_KEYWORDS.jumps])\n    ? (schema[OM_ROOT_KEYWORDS.jumps] as Array<Record<string, unknown>>)\n    : []\n\n  const hiddenNames = hiddenDecls.map((entry) => entry?.name).filter((name): name is string => typeof name === 'string')\n  const variableNames = variableDecls.map((entry) => entry?.name).filter((name): name is string => typeof name === 'string')\n\n  for (const name of hiddenNames) {\n    if (propertyKeys.has(name)) {\n      return `Hidden field name \"${name}\" collides with a field key in properties.`\n    }\n  }\n  for (const name of variableNames) {\n    if (propertyKeys.has(name)) {\n      return `Variable name \"${name}\" collides with a field key in properties.`\n    }\n    if (hiddenNames.includes(name)) {\n      return `Variable name \"${name}\" collides with a hidden field name.`\n    }\n  }\n\n  const sectionKeys = new Set<string>()\n  const pageKeys = new Set<string>()\n  const endingKeys = new Set<string>()\n  for (const section of sections) {\n    if (typeof section.key !== 'string') continue\n    sectionKeys.add(section.key)\n    if (section.kind === 'ending') endingKeys.add(section.key)\n    else pageKeys.add(section.key)\n  }\n\n  // Validate visibility predicates (field-level + section-level) and the\n  // string-only Tier-2 validation keywords.\n  const properties = schema.properties\n  if (properties && typeof properties === 'object' && !Array.isArray(properties)) {\n    for (const [fieldKey, fieldNode] of Object.entries(properties as Record<string, unknown>)) {\n      if (!fieldNode || typeof fieldNode !== 'object') continue\n      const node = fieldNode as Record<string, unknown>\n      const predicate = node[OM_FIELD_KEYWORDS.visibilityIf]\n      if (predicate !== undefined) {\n        const message = validateJsonLogicGrammar(predicate)\n        if (message) return `Field \"${fieldKey}\" x-om-visibility-if: ${message}`\n      }\n      const requiresStringType =\n        node[OM_FIELD_KEYWORDS.pattern] !== undefined\n        || node[OM_FIELD_KEYWORDS.minLength] !== undefined\n        || node[OM_FIELD_KEYWORDS.maxLength] !== undefined\n      if (requiresStringType && node.type !== 'string') {\n        return `Field \"${fieldKey}\" declares pattern/length validation but its JSON Schema type is not \"string\".`\n      }\n      const minLen = node[OM_FIELD_KEYWORDS.minLength]\n      const maxLen = node[OM_FIELD_KEYWORDS.maxLength]\n      if (typeof minLen === 'number' && typeof maxLen === 'number' && minLen > maxLen) {\n        return `Field \"${fieldKey}\" x-om-min-length (${minLen}) must be <= x-om-max-length (${maxLen}).`\n      }\n      if (node[OM_FIELD_KEYWORDS.opinionIcon] !== undefined\n        && node[OM_FIELD_KEYWORDS.type] !== 'opinion_scale') {\n        return `Field \"${fieldKey}\" declares x-om-opinion-icon but its x-om-type is not \"opinion_scale\".`\n      }\n      if (node[OM_FIELD_KEYWORDS.npsAnchors] !== undefined\n        && node[OM_FIELD_KEYWORDS.type] !== 'nps') {\n        return `Field \"${fieldKey}\" declares x-om-nps-anchors but its x-om-type is not \"nps\".`\n      }\n      if (node[OM_FIELD_KEYWORDS.rankingExhaustive] !== undefined\n        && node[OM_FIELD_KEYWORDS.type] !== 'ranking') {\n        return `Field \"${fieldKey}\" declares x-om-ranking-exhaustive but its x-om-type is not \"ranking\".`\n      }\n      const matrixRowsValue = node[OM_FIELD_KEYWORDS.matrixRows]\n      if (matrixRowsValue !== undefined) {\n        if (node[OM_FIELD_KEYWORDS.type] !== 'matrix') {\n          return `Field \"${fieldKey}\" declares x-om-matrix-rows but its x-om-type is not \"matrix\".`\n        }\n        if (Array.isArray(matrixRowsValue) && matrixRowsValue.length > MATRIX_ROWS_SOFT_CAP) {\n          return `Matrix has too many rows (max ${MATRIX_ROWS_SOFT_CAP}).`\n        }\n      }\n      const matrixColumnsValue = node[OM_FIELD_KEYWORDS.matrixColumns]\n      if (matrixColumnsValue !== undefined) {\n        if (node[OM_FIELD_KEYWORDS.type] !== 'matrix') {\n          return `Field \"${fieldKey}\" declares x-om-matrix-columns but its x-om-type is not \"matrix\".`\n        }\n        if (Array.isArray(matrixColumnsValue) && matrixColumnsValue.length > MATRIX_COLUMNS_SOFT_CAP) {\n          return `Matrix has too many columns (max ${MATRIX_COLUMNS_SOFT_CAP}).`\n        }\n      }\n      const fileKeywords = [\n        OM_FIELD_KEYWORDS.accept,\n        OM_FIELD_KEYWORDS.maxSizeBytes,\n        OM_FIELD_KEYWORDS.multiple,\n      ]\n      for (const fileKeyword of fileKeywords) {\n        if (node[fileKeyword] !== undefined && node[OM_FIELD_KEYWORDS.type] !== 'file') {\n          return `Field \"${fieldKey}\" declares ${fileKeyword} but its x-om-type is not \"file\".`\n        }\n      }\n      const signatureKeywords = [\n        OM_FIELD_KEYWORDS.consentClause,\n        OM_FIELD_KEYWORDS.signatureModes,\n      ]\n      for (const signatureKeyword of signatureKeywords) {\n        if (node[signatureKeyword] !== undefined && node[OM_FIELD_KEYWORDS.type] !== 'signature') {\n          return `Field \"${fieldKey}\" declares ${signatureKeyword} but its x-om-type is not \"signature\".`\n        }\n      }\n      const groupKeywords = [OM_FIELD_KEYWORDS.minItems, OM_FIELD_KEYWORDS.maxItems]\n      for (const groupKeyword of groupKeywords) {\n        if (node[groupKeyword] !== undefined && node[OM_FIELD_KEYWORDS.type] !== 'group') {\n          return `Field \"${fieldKey}\" declares ${groupKeyword} but its x-om-type is not \"group\".`\n        }\n      }\n      if (node[OM_FIELD_KEYWORDS.type] === 'group') {\n        const groupViolation = validateGroupNode(fieldKey, node)\n        if (groupViolation) return groupViolation\n      }\n    }\n  }\n  for (const section of sections) {\n    const predicate = section['x-om-visibility-if']\n    if (predicate !== undefined) {\n      const message = validateJsonLogicGrammar(predicate)\n      if (message) return `Section \"${section.key}\" x-om-visibility-if: ${message}`\n    }\n  }\n\n  // Validate jump rules: grammar on each `if`, resolvable goto targets.\n  for (const rule of jumps) {\n    const from = rule.from as Record<string, unknown> | undefined\n    if (from?.type === 'page' && typeof from.pageKey === 'string' && !pageKeys.has(from.pageKey)) {\n      return `Jump rule references missing page \"${from.pageKey}\".`\n    }\n    if (from?.type === 'field' && typeof from.fieldKey === 'string' && !propertyKeys.has(from.fieldKey)) {\n      return `Jump rule references missing field \"${from.fieldKey}\".`\n    }\n    const rules = Array.isArray(rule.rules) ? (rule.rules as Array<Record<string, unknown>>) : []\n    for (const branch of rules) {\n      if (branch.if !== undefined) {\n        const message = validateJsonLogicGrammar(branch.if)\n        if (message) return `Jump rule predicate: ${message}`\n      }\n      const target = branch.goto as Record<string, unknown> | undefined\n      const targetMessage = validateJumpTargetReference(target, pageKeys, endingKeys)\n      if (targetMessage) return targetMessage\n    }\n    if (rule.otherwise) {\n      const targetMessage = validateJumpTargetReference(rule.otherwise as Record<string, unknown>, pageKeys, endingKeys)\n      if (targetMessage) return targetMessage\n    }\n  }\n\n  // Validate answer mappings reference real field keys (W8 / INT-5).\n  const answerMappings = schema[OM_ROOT_KEYWORDS.answerMappings]\n  if (answerMappings && typeof answerMappings === 'object' && !Array.isArray(answerMappings)) {\n    for (const fieldKey of Object.keys(answerMappings as Record<string, unknown>)) {\n      if (!propertyKeys.has(fieldKey)) {\n        return `x-om-answer-mappings references missing field \"${fieldKey}\".`\n      }\n    }\n  }\n\n  // Validate variable formulas.\n  for (const variable of variableDecls) {\n    const formula = (variable as Record<string, unknown>).formula\n    if (formula === undefined) continue\n    const message = validateJsonLogicGrammar(formula)\n    if (message) return `Variable \"${variable.name}\" formula: ${message}`\n  }\n\n  return null\n}\n\nfunction validateJumpTargetReference(\n  target: Record<string, unknown> | undefined,\n  pageKeys: Set<string>,\n  endingKeys: Set<string>,\n): string | null {\n  if (!target) return null\n  if (target.type === 'page' && typeof target.pageKey === 'string' && !pageKeys.has(target.pageKey)) {\n    return `Jump goto references missing page \"${target.pageKey}\".`\n  }\n  if (target.type === 'ending' && typeof target.endingKey === 'string' && !endingKeys.has(target.endingKey)) {\n    return `Jump goto references missing ending \"${target.endingKey}\".`\n  }\n  return null\n}\n\nconst GROUP_SUB_FIELD_KEY_PATTERN = /^[a-z][a-z0-9_]*$/\n\n/**\n * Validates a repeatable `group` field node (W6). A group is a JSON-Schema\n * `type: 'array'` whose `items` is `type: 'object'` with a `properties` map of\n * sub-fields. Each sub-field uses the same `x-om-type` grammar as a top-level\n * field. One level of nesting is supported \u2014 a sub-field whose `x-om-type` is\n * `group` is rejected (nested groups are explicitly out of scope).\n *\n * Returns the first violation message or `null` when the group is consistent.\n */\nfunction validateGroupNode(fieldKey: string, node: Record<string, unknown>): string | null {\n  if (node.type !== 'array') {\n    return `Group field \"${fieldKey}\" must declare JSON Schema type \"array\".`\n  }\n  const items = node.items\n  if (!items || typeof items !== 'object' || Array.isArray(items)) {\n    return `Group field \"${fieldKey}\" must declare an \"items\" object describing one entry.`\n  }\n  const itemsNode = items as Record<string, unknown>\n  if (itemsNode.type !== 'object') {\n    return `Group field \"${fieldKey}\" items must declare JSON Schema type \"object\".`\n  }\n  const properties = itemsNode.properties\n  if (!properties || typeof properties !== 'object' || Array.isArray(properties)) {\n    return `Group field \"${fieldKey}\" items must declare a \"properties\" object of sub-fields.`\n  }\n  const subEntries = Object.entries(properties as Record<string, unknown>)\n  if (subEntries.length === 0) {\n    return `Group field \"${fieldKey}\" must declare at least one sub-field.`\n  }\n  const requiredRaw = itemsNode.required\n  if (requiredRaw !== undefined && (!Array.isArray(requiredRaw) || !requiredRaw.every((entry) => typeof entry === 'string'))) {\n    return `Group field \"${fieldKey}\" items.required must be an array of sub-field keys.`\n  }\n  const subKeys = new Set<string>()\n  for (const [subKey, rawSubNode] of subEntries) {\n    if (!GROUP_SUB_FIELD_KEY_PATTERN.test(subKey)) {\n      return `Group field \"${fieldKey}\" sub-field key \"${subKey}\" must match /^[a-z][a-z0-9_]*$/.`\n    }\n    subKeys.add(subKey)\n    if (!rawSubNode || typeof rawSubNode !== 'object' || Array.isArray(rawSubNode)) {\n      return `Group field \"${fieldKey}\" sub-field \"${subKey}\" must be an object.`\n    }\n    const subNode = rawSubNode as Record<string, unknown>\n    const subType = subNode[OM_FIELD_KEYWORDS.type]\n    if (typeof subType !== 'string' || subType.length === 0) {\n      return `Group field \"${fieldKey}\" sub-field \"${subKey}\" must declare an x-om-type.`\n    }\n    if (subType === 'group') {\n      return `Group field \"${fieldKey}\" sub-field \"${subKey}\" cannot itself be a group \u2014 nested groups are not supported.`\n    }\n    for (const keyword of Object.values(OM_FIELD_KEYWORDS)) {\n      if (!(keyword in subNode)) continue\n      const message = OM_FIELD_VALIDATORS[keyword](subNode[keyword])\n      if (message) {\n        return `Group field \"${fieldKey}\" sub-field \"${subKey}\" ${keyword}: ${message}`\n      }\n    }\n  }\n  if (Array.isArray(requiredRaw)) {\n    for (const requiredKey of requiredRaw) {\n      if (typeof requiredKey === 'string' && !subKeys.has(requiredKey)) {\n        return `Group field \"${fieldKey}\" items.required references unknown sub-field \"${requiredKey}\".`\n      }\n    }\n  }\n  const minItems = node[OM_FIELD_KEYWORDS.minItems]\n  const maxItems = node[OM_FIELD_KEYWORDS.maxItems]\n  if (typeof minItems === 'number' && typeof maxItems === 'number' && minItems > maxItems) {\n    return `Group field \"${fieldKey}\" x-om-min-items (${minItems}) must be <= x-om-max-items (${maxItems}).`\n  }\n  if (typeof maxItems === 'number' && maxItems > GROUP_MAX_ITEMS_SOFT_CAP) {\n    return `Group field \"${fieldKey}\" has too many max items (max ${GROUP_MAX_ITEMS_SOFT_CAP}).`\n  }\n  return null\n}\n\nfunction readPropertyKeys(schema: Record<string, unknown>): Set<string> {\n  const properties = schema.properties\n  if (!properties || typeof properties !== 'object' || Array.isArray(properties)) return new Set()\n  return new Set(Object.keys(properties as Record<string, unknown>))\n}\n\n// ============================================================================\n// AJV registration \u2014 register OM keywords as no-op annotations so AJV does\n// not treat them as unknown keywords during schema compilation.\n// ============================================================================\n\n/**\n * Register every `x-om-*` keyword on the given AJV instance as an annotation\n * (no validation effect). The compiler validates the extension payload\n * separately via `OM_ROOT_VALIDATORS` / `OM_FIELD_VALIDATORS`.\n */\nexport function addOmKeywords(ajv: Ajv): void {\n  for (const keyword of OM_ALL_KEYWORDS) {\n    if (ajv.getKeyword(keyword)) continue\n    ajv.addKeyword({\n      keyword,\n      schemaType: ['string', 'number', 'boolean', 'object', 'array'],\n      // No validator \u2014 purely annotation. Returning true keeps schemas valid.\n      validate: () => true,\n    })\n  }\n}\n"],
+  "mappings": "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",
+  "names": []
+}

package/dist/modules/forms/schema/layout-catalog.js

@@ -0,0 +1,38 @@
+const PAGE_ENTRY = {
+  id: "page",
+  kind: "page",
+  icon: "file-text",
+  displayNameKey: "forms.studio.palette.layout.page"
+};
+const SECTION_ENTRY = {
+  id: "section",
+  kind: "section",
+  icon: "rows",
+  displayNameKey: "forms.studio.palette.layout.section"
+};
+const ENDING_ENTRY = {
+  id: "ending",
+  kind: "ending",
+  icon: "flag",
+  displayNameKey: "forms.studio.palette.layout.ending"
+};
+const layoutCatalogEntries = [
+  PAGE_ENTRY,
+  SECTION_ENTRY,
+  ENDING_ENTRY
+];
+const ENTRIES_BY_ID = new Map(
+  layoutCatalogEntries.map((entry) => [entry.id, entry])
+);
+function getLayoutCatalogEntry(id) {
+  return ENTRIES_BY_ID.get(id);
+}
+function listLayoutCatalogEntries() {
+  return layoutCatalogEntries;
+}
+export {
+  getLayoutCatalogEntry,
+  layoutCatalogEntries,
+  listLayoutCatalogEntries
+};
+//# sourceMappingURL=layout-catalog.js.map

package/dist/modules/forms/schema/layout-catalog.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../src/modules/forms/schema/layout-catalog.ts"],
+  "sourcesContent": ["/**\n * Layout palette catalog.\n *\n * Layout palette entries are studio-only \u2014 they don't register as field\n * types and never appear in `properties`. The catalog is a sibling to\n * `FieldTypeRegistry` so the compiler can keep rejecting unknown\n * `x-om-type` values on real fields while the studio enumerates the\n * `Page` and `Section/Group` palette cards from a single source.\n *\n * Decision 1 (`.ai/specs/2026-05-10-forms-visual-builder.md`): \"Grid\" is\n * not a separate primitive. Multi-column layouts are a section with\n * `columns >= 2`.\n *\n * Pack-registered layout entries (Decisions 16a/16b) take a different\n * shape: they go through `FieldTypeRegistry.register({ category: 'layout' })`\n * and persist as fields in `properties` \u2014 the registry asserts the\n * display-only contract (`validator(undefined) === true`,\n * `exportAdapter(undefined) === ''`) at register time. This catalog stays\n * limited to `kind: 'page' | 'section'` boundary entries.\n */\n\nimport type { OmSectionKind } from './jsonschema-extensions'\n\nexport type LayoutCatalogEntry = {\n  id: string\n  kind: OmSectionKind\n  icon: string\n  displayNameKey: string\n}\n\nconst PAGE_ENTRY: LayoutCatalogEntry = {\n  id: 'page',\n  kind: 'page',\n  icon: 'file-text',\n  displayNameKey: 'forms.studio.palette.layout.page',\n}\n\nconst SECTION_ENTRY: LayoutCatalogEntry = {\n  id: 'section',\n  kind: 'section',\n  icon: 'rows',\n  displayNameKey: 'forms.studio.palette.layout.section',\n}\n\nconst ENDING_ENTRY: LayoutCatalogEntry = {\n  id: 'ending',\n  kind: 'ending',\n  icon: 'flag',\n  displayNameKey: 'forms.studio.palette.layout.ending',\n}\n\nexport const layoutCatalogEntries: ReadonlyArray<LayoutCatalogEntry> = [\n  PAGE_ENTRY,\n  SECTION_ENTRY,\n  ENDING_ENTRY,\n]\n\nconst ENTRIES_BY_ID = new Map<string, LayoutCatalogEntry>(\n  layoutCatalogEntries.map((entry) => [entry.id, entry]),\n)\n\nexport function getLayoutCatalogEntry(id: string): LayoutCatalogEntry | undefined {\n  return ENTRIES_BY_ID.get(id)\n}\n\nexport function listLayoutCatalogEntries(): ReadonlyArray<LayoutCatalogEntry> {\n  return layoutCatalogEntries\n}\n"],
+  "mappings": "AA8BA,MAAM,aAAiC;AAAA,EACrC,IAAI;AAAA,EACJ,MAAM;AAAA,EACN,MAAM;AAAA,EACN,gBAAgB;AAClB;AAEA,MAAM,gBAAoC;AAAA,EACxC,IAAI;AAAA,EACJ,MAAM;AAAA,EACN,MAAM;AAAA,EACN,gBAAgB;AAClB;AAEA,MAAM,eAAmC;AAAA,EACvC,IAAI;AAAA,EACJ,MAAM;AAAA,EACN,MAAM;AAAA,EACN,gBAAgB;AAClB;AAEO,MAAM,uBAA0D;AAAA,EACrE;AAAA,EACA;AAAA,EACA;AACF;AAEA,MAAM,gBAAgB,IAAI;AAAA,EACxB,qBAAqB,IAAI,CAAC,UAAU,CAAC,MAAM,IAAI,KAAK,CAAC;AACvD;AAEO,SAAS,sBAAsB,IAA4C;AAChF,SAAO,cAAc,IAAI,EAAE;AAC7B;AAEO,SAAS,2BAA8D;AAC5E,SAAO;AACT;",
+  "names": []
+}

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

@@ -0,0 +1,67 @@
+const SIGNATURE_TYPE_KEY = "signature";
+const SIGNATURE_MODES = ["drawn", "typed"];
+const SHA256_HEX_PATTERN = /^[a-f0-9]{64}$/;
+function isSignatureMode(value) {
+  return value === "drawn" || value === "typed";
+}
+function readSignatureModes(fieldNode) {
+  const raw = fieldNode["x-om-signature-modes"];
+  if (!Array.isArray(raw)) return [...SIGNATURE_MODES];
+  const modes = raw.filter(isSignatureMode);
+  return modes.length > 0 ? Array.from(new Set(modes)) : [...SIGNATURE_MODES];
+}
+const SIGNATURE_TYPE = {
+  validator: (value, fieldNode) => {
+    if (value === null || value === void 0) return true;
+    if (typeof value !== "object" || Array.isArray(value)) {
+      return "Signature must be an object.";
+    }
+    const candidate = value;
+    if (!isSignatureMode(candidate.mode)) {
+      return 'Signature mode must be "drawn" or "typed".';
+    }
+    const allowedModes = readSignatureModes(fieldNode);
+    if (!allowedModes.includes(candidate.mode)) {
+      return `Signature mode "${candidate.mode}" is not allowed for this field.`;
+    }
+    if (candidate.affirmed !== true) {
+      return "You must affirm the consent statement before signing.";
+    }
+    if (typeof candidate.clauseSha256 !== "string" || !SHA256_HEX_PATTERN.test(candidate.clauseSha256)) {
+      return "Signature is missing the consent clause fingerprint.";
+    }
+    if (typeof candidate.signedAt !== "string" || Number.isNaN(Date.parse(candidate.signedAt))) {
+      return "Signature is missing a valid signed-at timestamp.";
+    }
+    if (candidate.mode === "drawn") {
+      if (typeof candidate.image !== "string" || candidate.image.length === 0) {
+        return "A drawn signature requires a captured image.";
+      }
+    } else {
+      if (typeof candidate.typedName !== "string" || candidate.typedName.trim().length === 0) {
+        return "A typed signature requires a name.";
+      }
+    }
+    return true;
+  },
+  renderer: null,
+  defaultUiSchema: { widget: "signature" },
+  exportAdapter: (value) => {
+    if (!value || typeof value !== "object" || Array.isArray(value)) return "";
+    const candidate = value;
+    if (!isSignatureMode(candidate.mode)) return "";
+    const signedAt = typeof candidate.signedAt === "string" ? candidate.signedAt : "";
+    const who = candidate.mode === "typed" && typeof candidate.typedName === "string" && candidate.typedName.trim().length > 0 ? candidate.typedName.trim() : "drawn";
+    return signedAt.length > 0 ? `Signed by ${who} on ${signedAt}` : `Signed by ${who}`;
+  },
+  category: "input",
+  icon: "pen-tool",
+  displayNameKey: "forms.studio.palette.input.signature"
+};
+export {
+  SIGNATURE_MODES,
+  SIGNATURE_TYPE,
+  SIGNATURE_TYPE_KEY,
+  readSignatureModes
+};
+//# sourceMappingURL=signature-field.js.map

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

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../src/modules/forms/schema/signature-field.ts"],
+  "sourcesContent": ["/**\n * `signature` field type \u2014 W2 (CN-1, FD-4; partial CN-2 / CN-3).\n *\n * Captures a patient / signer e-signature with tamper-evident audit data. This\n * is the defining capability for the consent / legal form category.\n *\n * Value shape (stored in the encrypted revision answers \u2014 never a side path):\n *   {\n *     mode: 'drawn' | 'typed',\n *     image?: string,        // data URL (PNG) for drawn mode\n *     typedName?: string,    // for typed mode\n *     affirmed: true,        // explicit affirmation checkbox must be true\n *     signedAt: string,      // ISO UTC timestamp (client-captured)\n *     clauseSha256: string,  // SHA-256 of the exact consent clause text shown\n *   }\n *\n * The signed record = version-pinned schema (`form_version`, immutable once\n * published) + encrypted answers (incl. this signature payload \u2014 append-only,\n * per-tenant envelope encryption) + submit metadata (IP / UA / UTC ts captured\n * server-side at submit). Together these form the tamper-evident bundle. Full\n * PDF reproduction of the signed record is W3.\n *\n * The `signature` 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-consent-clause` \u2014 `{ [locale]: string }` legal statement shown above\n *     the signature area (the text whose SHA-256 the signer affirms).\n *   - `x-om-signature-modes` \u2014 `('drawn'|'typed')[]` allowed capture modes\n *     (default both).\n */\n\nimport type { FieldNode, FieldTypeSpec } from './field-type-registry'\n\nexport const SIGNATURE_TYPE_KEY = 'signature' as const\n\nexport const SIGNATURE_MODES = ['drawn', 'typed'] as const\nexport type SignatureMode = (typeof SIGNATURE_MODES)[number]\n\n/** Value persisted in a `signature`-field answer. */\nexport type SignatureValue = {\n  mode: SignatureMode\n  image?: string\n  typedName?: string\n  affirmed: true\n  signedAt: string\n  clauseSha256: string\n}\n\nconst SHA256_HEX_PATTERN = /^[a-f0-9]{64}$/\n\nfunction isSignatureMode(value: unknown): value is SignatureMode {\n  return value === 'drawn' || value === 'typed'\n}\n\n/**\n * Reads the allowed capture modes for a signature field. Absent / malformed\n * `x-om-signature-modes` defaults to both modes. Unknown entries are dropped;\n * an empty result also falls back to both modes (R: never lock a signer out of\n * every mode through a bad config).\n */\nexport function readSignatureModes(fieldNode: FieldNode): SignatureMode[] {\n  const raw = (fieldNode as Record<string, unknown>)['x-om-signature-modes']\n  if (!Array.isArray(raw)) return [...SIGNATURE_MODES]\n  const modes = raw.filter(isSignatureMode)\n  return modes.length > 0 ? Array.from(new Set(modes)) : [...SIGNATURE_MODES]\n}\n\nexport const SIGNATURE_TYPE: FieldTypeSpec = {\n  validator: (value, fieldNode) => {\n    if (value === null || value === undefined) return true\n    if (typeof value !== 'object' || Array.isArray(value)) {\n      return 'Signature must be an object.'\n    }\n    const candidate = value as Record<string, unknown>\n    if (!isSignatureMode(candidate.mode)) {\n      return 'Signature mode must be \"drawn\" or \"typed\".'\n    }\n    const allowedModes = readSignatureModes(fieldNode)\n    if (!allowedModes.includes(candidate.mode)) {\n      return `Signature mode \"${candidate.mode}\" is not allowed for this field.`\n    }\n    if (candidate.affirmed !== true) {\n      return 'You must affirm the consent statement before signing.'\n    }\n    if (typeof candidate.clauseSha256 !== 'string' || !SHA256_HEX_PATTERN.test(candidate.clauseSha256)) {\n      return 'Signature is missing the consent clause fingerprint.'\n    }\n    if (typeof candidate.signedAt !== 'string' || Number.isNaN(Date.parse(candidate.signedAt))) {\n      return 'Signature is missing a valid signed-at timestamp.'\n    }\n    if (candidate.mode === 'drawn') {\n      if (typeof candidate.image !== 'string' || candidate.image.length === 0) {\n        return 'A drawn signature requires a captured image.'\n      }\n    } else {\n      if (typeof candidate.typedName !== 'string' || candidate.typedName.trim().length === 0) {\n        return 'A typed signature requires a name.'\n      }\n    }\n    return true\n  },\n  renderer: null,\n  defaultUiSchema: { widget: 'signature' },\n  exportAdapter: (value) => {\n    if (!value || typeof value !== 'object' || Array.isArray(value)) return ''\n    const candidate = value as Record<string, unknown>\n    if (!isSignatureMode(candidate.mode)) return ''\n    const signedAt = typeof candidate.signedAt === 'string' ? candidate.signedAt : ''\n    const who =\n      candidate.mode === 'typed' && typeof candidate.typedName === 'string' && candidate.typedName.trim().length > 0\n        ? candidate.typedName.trim()\n        : 'drawn'\n    return signedAt.length > 0 ? `Signed by ${who} on ${signedAt}` : `Signed by ${who}`\n  },\n  category: 'input',\n  icon: 'pen-tool',\n  displayNameKey: 'forms.studio.palette.input.signature',\n}\n"],
+  "mappings": "AAmCO,MAAM,qBAAqB;AAE3B,MAAM,kBAAkB,CAAC,SAAS,OAAO;AAahD,MAAM,qBAAqB;AAE3B,SAAS,gBAAgB,OAAwC;AAC/D,SAAO,UAAU,WAAW,UAAU;AACxC;AAQO,SAAS,mBAAmB,WAAuC;AACxE,QAAM,MAAO,UAAsC,sBAAsB;AACzE,MAAI,CAAC,MAAM,QAAQ,GAAG,EAAG,QAAO,CAAC,GAAG,eAAe;AACnD,QAAM,QAAQ,IAAI,OAAO,eAAe;AACxC,SAAO,MAAM,SAAS,IAAI,MAAM,KAAK,IAAI,IAAI,KAAK,CAAC,IAAI,CAAC,GAAG,eAAe;AAC5E;AAEO,MAAM,iBAAgC;AAAA,EAC3C,WAAW,CAAC,OAAO,cAAc;AAC/B,QAAI,UAAU,QAAQ,UAAU,OAAW,QAAO;AAClD,QAAI,OAAO,UAAU,YAAY,MAAM,QAAQ,KAAK,GAAG;AACrD,aAAO;AAAA,IACT;AACA,UAAM,YAAY;AAClB,QAAI,CAAC,gBAAgB,UAAU,IAAI,GAAG;AACpC,aAAO;AAAA,IACT;AACA,UAAM,eAAe,mBAAmB,SAAS;AACjD,QAAI,CAAC,aAAa,SAAS,UAAU,IAAI,GAAG;AAC1C,aAAO,mBAAmB,UAAU,IAAI;AAAA,IAC1C;AACA,QAAI,UAAU,aAAa,MAAM;AAC/B,aAAO;AAAA,IACT;AACA,QAAI,OAAO,UAAU,iBAAiB,YAAY,CAAC,mBAAmB,KAAK,UAAU,YAAY,GAAG;AAClG,aAAO;AAAA,IACT;AACA,QAAI,OAAO,UAAU,aAAa,YAAY,OAAO,MAAM,KAAK,MAAM,UAAU,QAAQ,CAAC,GAAG;AAC1F,aAAO;AAAA,IACT;AACA,QAAI,UAAU,SAAS,SAAS;AAC9B,UAAI,OAAO,UAAU,UAAU,YAAY,UAAU,MAAM,WAAW,GAAG;AACvE,eAAO;AAAA,MACT;AAAA,IACF,OAAO;AACL,UAAI,OAAO,UAAU,cAAc,YAAY,UAAU,UAAU,KAAK,EAAE,WAAW,GAAG;AACtF,eAAO;AAAA,MACT;AAAA,IACF;AACA,WAAO;AAAA,EACT;AAAA,EACA,UAAU;AAAA,EACV,iBAAiB,EAAE,QAAQ,YAAY;AAAA,EACvC,eAAe,CAAC,UAAU;AACxB,QAAI,CAAC,SAAS,OAAO,UAAU,YAAY,MAAM,QAAQ,KAAK,EAAG,QAAO;AACxE,UAAM,YAAY;AAClB,QAAI,CAAC,gBAAgB,UAAU,IAAI,EAAG,QAAO;AAC7C,UAAM,WAAW,OAAO,UAAU,aAAa,WAAW,UAAU,WAAW;AAC/E,UAAM,MACJ,UAAU,SAAS,WAAW,OAAO,UAAU,cAAc,YAAY,UAAU,UAAU,KAAK,EAAE,SAAS,IACzG,UAAU,UAAU,KAAK,IACzB;AACN,WAAO,SAAS,SAAS,IAAI,aAAa,GAAG,OAAO,QAAQ,KAAK,aAAa,GAAG;AAAA,EACnF;AAAA,EACA,UAAU;AAAA,EACV,MAAM;AAAA,EACN,gBAAgB;AAClB;",
+  "names": []
+}

package/dist/modules/forms/schema/style-extensions.js

@@ -0,0 +1,77 @@
+const OM_HEX_COLOR = /^#([0-9a-fA-F]{3}|[0-9a-fA-F]{6}|[0-9a-fA-F]{8})$/;
+const OM_COLOR_TOKENS = /* @__PURE__ */ new Set([
+  "surface",
+  "surface-muted",
+  "foreground",
+  "muted-foreground",
+  "accent",
+  "border",
+  "transparent",
+  "inherit"
+]);
+const OM_SPACE_SCALE = /* @__PURE__ */ new Set([
+  "none",
+  "xs",
+  "sm",
+  "md",
+  "lg",
+  "xl"
+]);
+const OM_RADIUS_SCALE = /* @__PURE__ */ new Set([
+  "none",
+  "sm",
+  "md",
+  "lg",
+  "full"
+]);
+const OM_BORDER_SCALE = /* @__PURE__ */ new Set([
+  "none",
+  "subtle",
+  "strong"
+]);
+const OM_FONT_FAMILY = /* @__PURE__ */ new Set([
+  "system",
+  "sans",
+  "serif",
+  "mono",
+  "rounded"
+]);
+const OM_FONT_SCALE = /* @__PURE__ */ new Set(["sm", "md", "lg"]);
+const OM_TEXT_WEIGHT = /* @__PURE__ */ new Set([
+  "normal",
+  "medium",
+  "semibold",
+  "bold"
+]);
+const OM_CONTENT_WIDTH = /* @__PURE__ */ new Set([
+  "sm",
+  "md",
+  "lg",
+  "full"
+]);
+const OM_TEXT_ALIGN = /* @__PURE__ */ new Set([
+  "start",
+  "center",
+  "end"
+]);
+const OM_BACKGROUND_KINDS = /* @__PURE__ */ new Set([
+  "none",
+  "color",
+  "gradient"
+]);
+const OM_LOGO_SIZE = /* @__PURE__ */ new Set(["sm", "md", "lg"]);
+export {
+  OM_BACKGROUND_KINDS,
+  OM_BORDER_SCALE,
+  OM_COLOR_TOKENS,
+  OM_CONTENT_WIDTH,
+  OM_FONT_FAMILY,
+  OM_FONT_SCALE,
+  OM_HEX_COLOR,
+  OM_LOGO_SIZE,
+  OM_RADIUS_SCALE,
+  OM_SPACE_SCALE,
+  OM_TEXT_ALIGN,
+  OM_TEXT_WEIGHT
+};
+//# sourceMappingURL=style-extensions.js.map

package/dist/modules/forms/schema/style-extensions.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../src/modules/forms/schema/style-extensions.ts"],
+  "sourcesContent": ["/**\n * Forms custom-styling vocabulary (`x-om-theme`, `OmSection.style`, `x-om-style`).\n *\n * Styling is end-user *data*, never CSS (security keystone \u2014 see\n * `.ai/specs/2026-05-22-forms-custom-styling.md` D1/D3/R-CS-1). The persisted\n * vocabulary is a small typed object of enums, integers, and **hex-only** color\n * strings; there is no member anywhere that accepts a raw CSS declaration,\n * selector, `url()`, `var()`, `calc()`, `expression()`, or free text. A pure\n * `style-compiler` (later task) turns a validated style object into a bounded\n * set of scoped CSS custom properties that remap the existing DS tokens.\n *\n * The enum sets exported here are the single source of truth consumed by\n * `style-validators.ts` (membership checks) and, later, the compiler.\n */\n\n// ============================================================================\n// Colors (D3)\n// ============================================================================\n\n/** Curated DS-role token \u2014 resolves to an existing DS var at compile time. */\nexport type OmColorToken =\n  | 'surface'\n  | 'surface-muted'\n  | 'foreground'\n  | 'muted-foreground'\n  | 'accent'\n  | 'border'\n  | 'transparent'\n  | 'inherit'\n\n/** A color: a curated role token OR a strict hex literal. Nothing else (D3). */\nexport type OmColor = OmColorToken | `#${string}`\n\n/** Strict hex literal \u2014 `#rgb`, `#rrggbb`, or `#rrggbbaa`. No other syntax. */\nexport const OM_HEX_COLOR = /^#([0-9a-fA-F]{3}|[0-9a-fA-F]{6}|[0-9a-fA-F]{8})$/\n\n/** Single source of truth for the curated color tokens. */\nexport const OM_COLOR_TOKENS: ReadonlySet<OmColorToken> = new Set<OmColorToken>([\n  'surface',\n  'surface-muted',\n  'foreground',\n  'muted-foreground',\n  'accent',\n  'border',\n  'transparent',\n  'inherit',\n])\n\n// ============================================================================\n// Scales / families / weights / alignment\n// ============================================================================\n\nexport type OmSpaceScale = 'none' | 'xs' | 'sm' | 'md' | 'lg' | 'xl'\nexport type OmRadiusScale = 'none' | 'sm' | 'md' | 'lg' | 'full'\nexport type OmBorderScale = 'none' | 'subtle' | 'strong'\nexport type OmFontFamily = 'system' | 'sans' | 'serif' | 'mono' | 'rounded'\nexport type OmFontScale = 'sm' | 'md' | 'lg'\nexport type OmTextWeight = 'normal' | 'medium' | 'semibold' | 'bold'\nexport type OmContentWidth = 'sm' | 'md' | 'lg' | 'full'\nexport type OmTextAlign = 'start' | 'center' | 'end'\n\nexport const OM_SPACE_SCALE: ReadonlySet<OmSpaceScale> = new Set<OmSpaceScale>([\n  'none',\n  'xs',\n  'sm',\n  'md',\n  'lg',\n  'xl',\n])\n\nexport const OM_RADIUS_SCALE: ReadonlySet<OmRadiusScale> = new Set<OmRadiusScale>([\n  'none',\n  'sm',\n  'md',\n  'lg',\n  'full',\n])\n\nexport const OM_BORDER_SCALE: ReadonlySet<OmBorderScale> = new Set<OmBorderScale>([\n  'none',\n  'subtle',\n  'strong',\n])\n\nexport const OM_FONT_FAMILY: ReadonlySet<OmFontFamily> = new Set<OmFontFamily>([\n  'system',\n  'sans',\n  'serif',\n  'mono',\n  'rounded',\n])\n\nexport const OM_FONT_SCALE: ReadonlySet<OmFontScale> = new Set<OmFontScale>(['sm', 'md', 'lg'])\n\nexport const OM_TEXT_WEIGHT: ReadonlySet<OmTextWeight> = new Set<OmTextWeight>([\n  'normal',\n  'medium',\n  'semibold',\n  'bold',\n])\n\nexport const OM_CONTENT_WIDTH: ReadonlySet<OmContentWidth> = new Set<OmContentWidth>([\n  'sm',\n  'md',\n  'lg',\n  'full',\n])\n\nexport const OM_TEXT_ALIGN: ReadonlySet<OmTextAlign> = new Set<OmTextAlign>([\n  'start',\n  'center',\n  'end',\n])\n\n// ============================================================================\n// Background (D6 \u2014 color + gradient in v1; image is Phase 2)\n// ============================================================================\n\nexport type OmBackgroundKind = 'none' | 'color' | 'gradient'\n\nexport const OM_BACKGROUND_KINDS: ReadonlySet<OmBackgroundKind> = new Set<OmBackgroundKind>([\n  'none',\n  'color',\n  'gradient',\n])\n\nexport type OmBackground =\n  | { kind: 'none' }\n  | { kind: 'color'; color: OmColor }\n  | { kind: 'gradient'; from: OmColor; to: OmColor; angle: number }\n// Phase 2:\n// | { kind: 'image'; assetId: string; fit?: 'cover' | 'contain'; overlay?: OmColor }\n\n// ============================================================================\n// Three style levels (D4) \u2014 root theme, section style, field style\n// ============================================================================\n\n/**\n * Logo / header image (Phase 2 of the styling spec). The author NEVER supplies a\n * URL \u2014 only `assetId`, the id of an image uploaded through the forms logo route\n * into the public attachments partition (no SSRF, no author-controlled fetch).\n * The render seam resolves it to the public image route by id.\n */\nexport type OmLogoSize = 'sm' | 'md' | 'lg'\n\nexport const OM_LOGO_SIZE: ReadonlySet<OmLogoSize> = new Set<OmLogoSize>(['sm', 'md', 'lg'])\n\nexport type OmThemeLogo = {\n  assetId: string\n  alt?: string\n  align?: OmTextAlign\n  size?: OmLogoSize\n}\n\n/** Root \u2014 `x-om-theme`. */\nexport type OmTheme = {\n  background?: OmBackground\n  surface?: OmColor\n  /** Body text color (remaps `--foreground`) \u2014 general copy, helper text, etc. */\n  foreground?: OmColor\n  /** Form-wide input/textarea/select text color, distinct from body (field `x-om-style.textColor` overrides). */\n  inputText?: OmColor\n  /** Form-wide field-label color, distinct from body text (field `x-om-style.labelColor` overrides). */\n  labelColor?: OmColor\n  /** Form-wide field-label weight (field `x-om-style.labelWeight` overrides). */\n  labelWeight?: OmTextWeight\n  accent?: OmColor\n  border?: OmColor\n  fontFamily?: OmFontFamily\n  fontScale?: OmFontScale\n  radius?: OmRadiusScale\n  contentWidth?: OmContentWidth\n  logo?: OmThemeLogo\n}\n\n/** Section \u2014 `OmSection.style`. */\nexport type OmSectionStyle = {\n  background?: OmBackground\n  foreground?: OmColor\n  padding?: OmSpaceScale\n  border?: OmBorderScale\n  radius?: OmRadiusScale\n  card?: boolean\n  align?: OmTextAlign\n}\n\n/** Field \u2014 `x-om-style`. */\nexport type OmFieldStyle = {\n  labelWeight?: OmTextWeight\n  labelColor?: OmColor\n  textColor?: OmColor\n  accent?: OmColor\n  align?: OmTextAlign\n}\n"],
+  "mappings": "AAkCO,MAAM,eAAe;AAGrB,MAAM,kBAA6C,oBAAI,IAAkB;AAAA,EAC9E;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACF,CAAC;AAeM,MAAM,iBAA4C,oBAAI,IAAkB;AAAA,EAC7E;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACF,CAAC;AAEM,MAAM,kBAA8C,oBAAI,IAAmB;AAAA,EAChF;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACF,CAAC;AAEM,MAAM,kBAA8C,oBAAI,IAAmB;AAAA,EAChF;AAAA,EACA;AAAA,EACA;AACF,CAAC;AAEM,MAAM,iBAA4C,oBAAI,IAAkB;AAAA,EAC7E;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACF,CAAC;AAEM,MAAM,gBAA0C,oBAAI,IAAiB,CAAC,MAAM,MAAM,IAAI,CAAC;AAEvF,MAAM,iBAA4C,oBAAI,IAAkB;AAAA,EAC7E;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACF,CAAC;AAEM,MAAM,mBAAgD,oBAAI,IAAoB;AAAA,EACnF;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACF,CAAC;AAEM,MAAM,gBAA0C,oBAAI,IAAiB;AAAA,EAC1E;AAAA,EACA;AAAA,EACA;AACF,CAAC;AAQM,MAAM,sBAAqD,oBAAI,IAAsB;AAAA,EAC1F;AAAA,EACA;AAAA,EACA;AACF,CAAC;AAqBM,MAAM,eAAwC,oBAAI,IAAgB,CAAC,MAAM,MAAM,IAAI,CAAC;",
+  "names": []
+}

package/dist/modules/forms/schema/style-validators.js

@@ -0,0 +1,181 @@
+import {
+  OM_BACKGROUND_KINDS,
+  OM_BORDER_SCALE,
+  OM_COLOR_TOKENS,
+  OM_CONTENT_WIDTH,
+  OM_FONT_FAMILY,
+  OM_FONT_SCALE,
+  OM_HEX_COLOR,
+  OM_LOGO_SIZE,
+  OM_RADIUS_SCALE,
+  OM_SPACE_SCALE,
+  OM_TEXT_ALIGN,
+  OM_TEXT_WEIGHT
+} from "./style-extensions.js";
+const OM_ASSET_ID = /^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$/;
+const LOGO_KEYS = /* @__PURE__ */ new Set(["assetId", "alt", "align", "size"]);
+function isPlainObject(value) {
+  return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+function unknownKey(candidate, allowed, scope) {
+  for (const key of Object.keys(candidate)) {
+    if (!allowed.has(key)) {
+      return `${scope} has an unknown key "${key}".`;
+    }
+  }
+  return null;
+}
+function validateOmColor(value) {
+  if (typeof value !== "string") {
+    return "Color must be a curated token or a hex literal string.";
+  }
+  if (OM_COLOR_TOKENS.has(value)) return null;
+  if (OM_HEX_COLOR.test(value)) return null;
+  return "Color must be a curated token or a strict hex literal (#rgb, #rrggbb, or #rrggbbaa) \u2014 no rgb()/hsl()/named/functional syntax.";
+}
+const BACKGROUND_KEYS_BY_KIND = {
+  none: /* @__PURE__ */ new Set(["kind"]),
+  color: /* @__PURE__ */ new Set(["kind", "color"]),
+  gradient: /* @__PURE__ */ new Set(["kind", "from", "to", "angle"])
+};
+function validateOmBackground(value) {
+  if (!isPlainObject(value)) {
+    return "Background must be an object with a `kind` discriminator.";
+  }
+  const kind = value.kind;
+  if (typeof kind !== "string" || !OM_BACKGROUND_KINDS.has(kind)) {
+    return 'Background `kind` must be "none", "color", or "gradient".';
+  }
+  const unknown = unknownKey(value, BACKGROUND_KEYS_BY_KIND[kind], `Background (kind "${kind}")`);
+  if (unknown) return unknown;
+  if (kind === "none") {
+    return null;
+  }
+  if (kind === "color") {
+    const colorMessage = validateOmColor(value.color);
+    if (colorMessage) return `Background color: ${colorMessage}`;
+    return null;
+  }
+  const fromMessage = validateOmColor(value.from);
+  if (fromMessage) return `Background gradient from: ${fromMessage}`;
+  const toMessage = validateOmColor(value.to);
+  if (toMessage) return `Background gradient to: ${toMessage}`;
+  const angle = value.angle;
+  if (typeof angle !== "number" || !Number.isInteger(angle) || angle < 0 || angle > 360) {
+    return "Background gradient `angle` must be an integer in [0, 360].";
+  }
+  return null;
+}
+function validateEnumMember(candidate, key, allowed, label) {
+  if (candidate[key] === void 0) return null;
+  const member = candidate[key];
+  if (typeof member !== "string" || !allowed.has(member)) {
+    return `${label} must be one of ${[...allowed].map((entry) => `"${entry}"`).join(", ")}.`;
+  }
+  return null;
+}
+function validateColorMember(candidate, key, label) {
+  if (candidate[key] === void 0) return null;
+  const message = validateOmColor(candidate[key]);
+  if (message) return `${label}: ${message}`;
+  return null;
+}
+function validateBackgroundMember(candidate, key, label) {
+  if (candidate[key] === void 0) return null;
+  const message = validateOmBackground(candidate[key]);
+  if (message) return `${label}: ${message}`;
+  return null;
+}
+const THEME_KEYS = /* @__PURE__ */ new Set([
+  "background",
+  "surface",
+  "foreground",
+  "inputText",
+  "labelColor",
+  "labelWeight",
+  "accent",
+  "border",
+  "fontFamily",
+  "fontScale",
+  "radius",
+  "contentWidth",
+  "logo"
+]);
+function validateOmThemeLogo(value) {
+  if (!isPlainObject(value)) {
+    return "x-om-theme.logo must be an object.";
+  }
+  const unknown = unknownKey(value, LOGO_KEYS, "x-om-theme.logo");
+  if (unknown) return unknown;
+  if (typeof value.assetId !== "string" || !OM_ASSET_ID.test(value.assetId)) {
+    return "x-om-theme.logo.assetId must be an uploaded image id (UUID).";
+  }
+  if (value.alt !== void 0 && (typeof value.alt !== "string" || value.alt.length > 300)) {
+    return "x-om-theme.logo.alt must be a string of at most 300 characters.";
+  }
+  return validateEnumMember(value, "align", OM_TEXT_ALIGN, "x-om-theme.logo.align") || validateEnumMember(value, "size", OM_LOGO_SIZE, "x-om-theme.logo.size");
+}
+function validateOmTheme(value) {
+  if (!isPlainObject(value)) {
+    return "x-om-theme must be an object.";
+  }
+  const unknown = unknownKey(value, THEME_KEYS, "x-om-theme");
+  if (unknown) return unknown;
+  return validateBackgroundMember(value, "background", "x-om-theme.background") || validateColorMember(value, "surface", "x-om-theme.surface") || validateColorMember(value, "foreground", "x-om-theme.foreground") || validateColorMember(value, "inputText", "x-om-theme.inputText") || validateColorMember(value, "labelColor", "x-om-theme.labelColor") || validateEnumMember(value, "labelWeight", OM_TEXT_WEIGHT, "x-om-theme.labelWeight") || validateColorMember(value, "accent", "x-om-theme.accent") || validateColorMember(value, "border", "x-om-theme.border") || validateEnumMember(value, "fontFamily", OM_FONT_FAMILY, "x-om-theme.fontFamily") || validateEnumMember(value, "fontScale", OM_FONT_SCALE, "x-om-theme.fontScale") || validateEnumMember(value, "radius", OM_RADIUS_SCALE, "x-om-theme.radius") || validateEnumMember(value, "contentWidth", OM_CONTENT_WIDTH, "x-om-theme.contentWidth") || (value.logo !== void 0 ? validateOmThemeLogo(value.logo) : null);
+}
+const SECTION_STYLE_KEYS = /* @__PURE__ */ new Set([
+  "background",
+  "foreground",
+  "padding",
+  "border",
+  "radius",
+  "card",
+  "align"
+]);
+function validateOmSectionStyle(value) {
+  if (!isPlainObject(value)) {
+    return "Section `style` must be an object.";
+  }
+  const unknown = unknownKey(value, SECTION_STYLE_KEYS, "Section `style`");
+  if (unknown) return unknown;
+  const backgroundMessage = validateBackgroundMember(value, "background", "Section style.background");
+  if (backgroundMessage) return backgroundMessage;
+  const foregroundMessage = validateColorMember(value, "foreground", "Section style.foreground");
+  if (foregroundMessage) return foregroundMessage;
+  const paddingMessage = validateEnumMember(value, "padding", OM_SPACE_SCALE, "Section style.padding");
+  if (paddingMessage) return paddingMessage;
+  const borderMessage = validateEnumMember(value, "border", OM_BORDER_SCALE, "Section style.border");
+  if (borderMessage) return borderMessage;
+  const radiusMessage = validateEnumMember(value, "radius", OM_RADIUS_SCALE, "Section style.radius");
+  if (radiusMessage) return radiusMessage;
+  if (value.card !== void 0 && typeof value.card !== "boolean") {
+    return "Section style.card must be a boolean when present.";
+  }
+  const alignMessage = validateEnumMember(value, "align", OM_TEXT_ALIGN, "Section style.align");
+  if (alignMessage) return alignMessage;
+  return null;
+}
+const FIELD_STYLE_KEYS = /* @__PURE__ */ new Set([
+  "labelWeight",
+  "labelColor",
+  "textColor",
+  "accent",
+  "align"
+]);
+function validateOmFieldStyle(value) {
+  if (!isPlainObject(value)) {
+    return "x-om-style must be an object.";
+  }
+  const unknown = unknownKey(value, FIELD_STYLE_KEYS, "x-om-style");
+  if (unknown) return unknown;
+  return validateEnumMember(value, "labelWeight", OM_TEXT_WEIGHT, "x-om-style.labelWeight") || validateColorMember(value, "labelColor", "x-om-style.labelColor") || validateColorMember(value, "textColor", "x-om-style.textColor") || validateColorMember(value, "accent", "x-om-style.accent") || validateEnumMember(value, "align", OM_TEXT_ALIGN, "x-om-style.align");
+}
+export {
+  validateOmBackground,
+  validateOmColor,
+  validateOmFieldStyle,
+  validateOmSectionStyle,
+  validateOmTheme,
+  validateOmThemeLogo
+};
+//# sourceMappingURL=style-validators.js.map