CRUDUI

명세 구조

English. 이 문서는 필드와 목록 선언을 정의합니다. 폼 인스턴스, 반복 행 키, 캐싱은 폼 런타임에 정의합니다. 구현과 배포 상태는 기능 상태에 기록합니다.

패키지 API

CRUDUI의 초기 패키지 버전은 0.0.1입니다. 파일명·공개 API·내부 식별자는 구현 세대 표기 없이 역할을 설명합니다. 패키지 루트는 현재 검증기와 폼 렌더러를 제공하며 프레임워크에 독립적인 @polyspec/crudui-generator-html renderer도 포함합니다. 제거한 버전 경로에는 호환 별칭을 제공하지 않습니다.

기계가 읽는 계약은 contracts/schema/crudui.schema.json에 관리합니다. 폼, 목록, 상세 선언 형태를 검증합니다. make docs-schema는 규칙을 생성하거나 교체하지 않고 이 문서와 공유 고정 데이터를 검사합니다.

멤버 순서

명세는 JSON 데이터입니다. JavaScript는 명세를 일반 객체로 받으며, 일반 객체는 배열 인덱스인 멤버 이름(앞자리 0 없이 쓴 0부터 4294967294까지의 십진 정수)을 먼저 숫자 오름차순으로 나열하고 나머지 이름은 작성한 순서로 나열합니다. 모든 런타임은 명세 안의 모든 객체에 이 순서를 사용합니다. properties의 필드, 목록 열, 상세 필드, items 값과 라벨의 맵, 모든 버킷의 키, 조건 맵, 조합 파일과 조합이 만드는 객체, 컴파일된 템플릿이 해당합니다. 이 문서들의 "선언 순서"는 이 순서를 뜻합니다. 예를 들어 b, 10, a 순서로 작성한 properties는 모든 런타임에서 10, b, a 순서로 컴파일, 렌더링, 검증됩니다.

배열은 작성한 순서를 유지합니다. 선택 목록은 정수 형태의 값을 가진 선택지를 작성한 순서로 선언합니다.

레코드 데이터는 들어온 순서를 유지합니다. 폼 데이터, 목록 행, 상세 레코드, options.data는 재정렬하지 않으며, 순서 있는 JSON이 그 안의 숫자 멤버 이름을 보존합니다.

필드

폼 루트는 properties 필드 맵이 있는 group입니다. 속성명이 데이터 경로를 정의합니다. 필드는 구조, 콘텐츠, 동작을 다음과 같이 분리합니다.

  • CUSC-001 구조 — 키: type, name, default, properties, items, multiple, lang; 계약: 값, 중첩 그룹, 선택지, 반복을 정의합니다.
  • CUSC-002 콘텐츠 — 키: label, description, placeholder, prepend, append, help, content; 계약: 문자열 또는 언어 맵을 사용합니다. content는 버튼·액션 필드의 컨트롤 텍스트입니다.
  • CUSC-003 검증 — 키: validate, messages; 계약: validate는 규칙을 정의하고 messages는 규칙 이름별로 오류 메시지를 재정의합니다.
  • CUSC-004 외형 — 키: design; 계약: 특정 DOM 노드의 표시와 스타일을 정의합니다.
  • CUSC-005 동작 — 키: behavior; 계약: 이벤트 스크립트를 표현식 평가 없이 보존합니다.
  • CUSC-006 타입 옵션 — 키: options; 계약: 특정 위젯 타입의 설정을 저장합니다.
  • CUSC-007 합성 — 키: $ref, $patch; 계약: 데이터를 바인딩하기 전에 필드 정의를 로드, 병합, 수정합니다.

콘텐츠는 폼 필드와 목록·상세 표시 설정 모두 모든 런타임에서 같은 방식으로 표시 언어의 텍스트가 됩니다. 문자열은 그대로입니다. 언어 맵은 표시 언어 항목, en, ko, 첫 키 순서에서 처음으로 비어 있지 않은 문자열 항목이 되며, 문자열이 아닌 항목은 건너뜁니다. 그 밖의 값(숫자, 불리언, 배열, 그런 항목이 없는 맵)은 빈 텍스트입니다.

종속 설정은 해당 대상 아래에 작성합니다. 반복 행 설정은 multiple, 언어 입력 설정은 lang, 위젯 설정은 options, 동적 선택지 설정은 items에 작성합니다. 역할과 구조 설정은 타입 정의가 허용하는 경우 false, true, 객체를 사용합니다. false는 설정을 끄고 true는 기본 설정을 선택합니다. TypeScript 타입이 허용하는 선언 형태를 정의합니다. 파서는 선언된 키를 보존하며 검증기는 금지된 스키마 키를 제거하지 않고 오류로 처리합니다.

type: group
properties:
  email:
    type: email
    label: { en: Email, ko: 이메일 }
    validate: { required: true, email: true }
    design:
      show: ".enabled"
      class: { ".priority == 'high'": text-danger, true: "" }

범위 필드

range 필드는 슬라이더로 고르는 숫자 하나를 가집니다. 범위와 증가 단위는 검증 규칙입니다. validate.range는 [minimum, maximum]이고 validate.step은 증가 단위입니다. 둘 다 필수이며 표현식이나 조건 맵이 아닌 리터럴 값입니다. 슬라이더는 최솟값에서 단계만큼 움직이므로 최솟값은 단계의 배수이고, 슬라이더의 모든 위치가 두 규칙을 통과합니다. 모든 검증기는 제출된 값을 이 규칙으로 검사합니다 (숫자). 숫자이고 범위 안에 있으며 단계의 배수인 값이 통과하고, 빈 값은 required를 선언하지 않으면 통과합니다. append는 현재 값 뒤에 쓰는 단위입니다. 컨트롤은 폼 마크업이 정의합니다.

volume:
  type: range
  label: Volume
  default: 50
  append: "%"
  validate: { range: [0, 100], step: 5 }

컴파일은 범위 필드를 behavior 다음에 검사하며 INVALID_FORM_INPUT와 빈 위치로 실패합니다. 배수 여부는 step 규칙과 같이 정확하게 판정합니다.

  • CUSC-008 validate.range가 없거나, 최솟값이 최댓값보다 크지 않은 유한한 숫자 두 개가 아님: Invalid validate.range at {path}: expected [minimum, maximum] finite numbers with minimum not above maximum
  • CUSC-009 validate.step이 없거나 0보다 큰 유한한 숫자가 아님: Invalid validate.step at {path}: expected a finite number above 0
  • CUSC-010 최솟값이 단계의 배수가 아님: Invalid validate.range at {path}: expected a minimum that is a multiple of validate.step

조건 필드

condition 필드는 데이터로 조건 트리 하나를 가지며, 컨트롤은 그 트리를 JSON 텍스트로 편집합니다. 규칙은 validate.conditionTree입니다. 이 규칙은 필수이며 표현식이나 조건 맵이 아닌 리터럴 true 또는 judge입니다. 따라서 필드의 모든 값을 조건 트리로 검사하고, 판정 문장은 judge에서만 허용합니다. 트리가 필수이면 required도 선언합니다. 컨트롤은 폼 마크업이 정의하고, 브라우저가 그 텍스트를 트리로 다시 읽는 방법과 서버가 제출된 트리를 읽는 방법은 폼 런타임이 정의합니다.

pass:
  type: condition
  label: Pass condition
  validate: { required: true, conditionTree: judge }

컴파일은 조건 필드를 behavior 다음에 검사하며 INVALID_FORM_INPUT와 빈 위치로 실패합니다.

  • CUSC-070 validate.conditionTree가 없거나 true도 judge도 아님: Invalid validate.conditionTree at {path}: expected true or judge

구조 조건 편집기

조건 필드는 design.editor를 선언할 수 있습니다. text는 폼 마크업의 textarea이며 그 멤버가 없는 필드의 편집기이기도 합니다. structured는 트리를 중첩한 컨트롤로 편집합니다 (구조 편집기). 구조 필드는 비교가 고르는 필드 이름인 options.fields를 선언할 수 있으며, 그것이 없으면 비교의 필드는 입력하는 텍스트입니다.

opens_when:
  type: condition
  label: Opens when
  validate: { conditionTree: true }
  design: { editor: structured }
  options: { fields: [episodes.e1.status, clues.size] }

컴파일은 이 멤버들을 validate.conditionTree 다음에 검사하며 INVALID_FORM_INPUT와 빈 위치로 실패합니다.

  • CUSC-083 조건 필드가 아닌 필드의 design.editor: Invalid design.editor at {path}: unknown key, 그리고 조건 필드에서 text나 structured가 아닌 값: Invalid design.editor at {path}: expected text or structured
  • CUSC-084 구조 조건 필드가 아닌 필드의 options.fields, 또는 다듬은 뒤 비지 않고 서로 같지 않은 문자열의 목록이 아닌 options.fields: Invalid options.fields at {path}: expected distinct field names of a structured condition editor

편집기는 필드의 규칙이 받는 것을 제공하고 값을 잃지 않고 보여 줍니다.

  • CUSC-085 편집기는 CUSC-073의 op 값 여덟 개를 그 순서로 제공합니다. 판정 텍스트는 추가할 조건으로도, 보여 줄 조건으로도 conditionTree: judge에서만 제공합니다.
  • CUSC-086 편집기는 값이 빈 값이면 빈 all 그룹으로, 또는 비어 있는 모든 field와 비어 있는 모든 judge 텍스트를 채운 것으로 볼 때 필드의 conditionTree가 받는 조건 트리이면 컨트롤로 보여 줍니다. 편집기가 추가하는 조건은 비어서 시작하기 때문입니다. 그 밖의 값은 컨트롤로 보여 주지 않고 바꾸지도 않습니다. 필드는 textarea를 보이게 값의 조건 텍스트와 함께 쓰고, 규칙과 필드의 데이터 경로를 밝히는 이름 있는 오류를 씁니다(CUMK-068). 그래서 작성자는 텍스트를 고칩니다. 값은 필드의 데이터로 남고, 폼을 검증하면 conditionTree가 알립니다.

조건과 외형

조건은 해당 설정의 값으로 작성합니다. design.show는 표시 여부를 결정합니다. design.class와 design.style은 주 노드에 적용합니다. design.label, design.wrapper, design.group, design.prepend는 해당 노드에 적용합니다. 조건 맵은 처음 일치한 표현식의 값을 선택합니다. 리터럴 키 true는 선택적 기본값이며 위치와 무관하게 다른 조건이 모두 실패한 뒤에만 적용됩니다. 일치하는 조건도 기본값도 없으면 결과는 null입니다 (조건맵). design.show, design.class, design.style을 포함한 모든 조건 설정에서 문자열은 표현식 문법으로 끝까지 파싱될 때만 표현식이고 그 밖의 문자열은 리터럴이므로 class: "modal fade in show"는 클래스 텍스트입니다. CRUDUI 스키마는 show_if, display_switch, display_target 같은 별도 조건 메타키를 거부합니다.

선언한 속성

폼 필드는 CRUDUI가 렌더링하는 요소의 속성을 선언합니다. design.attributes는 컨트롤의 속성이고 design.wrapper.attributes는 노드 루트의 속성입니다. 대상 요소와 렌더러가 쓰는 방식은 폼 마크업이 정의합니다. 각각은 속성 이름에서 문자열 값으로의 객체이며, 값은 표현식이나 조건 맵이 아닌 리터럴 텍스트입니다. 이름은 data- 또는 aria- 뒤에 소문자나 숫자 하나, 그 뒤에 소문자, 숫자, -, _, .가 오는 형태입니다. CRUDUI가 컨트롤이나 노드 루트에 쓰는 이름은 거부합니다: data-field-path, data-lang, data-crudui- 또는 data-source-로 시작하는 모든 이름, data-name, data-rule-name, data-default, data-is-default, data-type, data-height, data-upload-server, data-fileserver, data-server, data-max-tags, data-keyword-min-length, data-delay, data-api-server, data-max-width, data-min-width, data-max-height, data-min-height, data-preview-max-width, data-preview-max-height, data-unsupported-type.

속성은 폼 필드만 받습니다. 폼 버튼, 목록, 상세의 design과 label, group, prepend 노드는 attributes를 알 수 없는 키로 거부합니다. 컴파일은 design.attributes를 design.class와 design.style 다음, 디자인 노드 전에 검사하고, design.wrapper.attributes를 wrapper의 class와 style 다음에 검사합니다. 선언 순서로 모든 이름을 검사한 뒤 모든 값을 검사하며, INVALID_FORM_INPUT와 빈 위치로 실패합니다.

  • CUSC-011 객체가 아님: Invalid design.attributes at {path}: expected an object
  • CUSC-012 규칙 밖의 이름 또는 거부된 이름: Invalid design.attributes.{name} at {path}: expected a data-* or aria-* name that crudui does not write
  • CUSC-013 문자열이 아닌 값: Invalid design.attributes.{name} at {path}: expected a string

wrapper 아래에서 키는 design.wrapper.attributes입니다.

배치

group 필드는 design.layout으로 안에 있는 필드의 배치를 선언합니다. 값은 표현식이나 조건 맵이 아닌 리터럴 문자열입니다.

  • CUSC-014 inline: group 안의 모든 field 노드는 깊이에 관계없이 한 행입니다. 너비가 --crudui-label-width인 레이블 열은 레이블을 담고, 컨트롤 열은 컨트롤, 그 아래의 설명, 오류를 담습니다. 레이블이 없는 필드는 레이블 열을 비워 두므로 모든 행의 컨트롤이 정렬됩니다. group, collection, lang 노드는 쌓인 배치를 유지하며 안에 있는 field 노드에 inline 배치를 전달합니다. 반복 스칼라 필드의 행과 언어 필드의 항목은 field 노드가 아니므로 쌓인 배치를 유지합니다.
  • CUSC-015 line: group의 자식 노드를 한 줄에 나란히 둡니다. 예를 들어 select 뒤에 작은 버튼을 둡니다. inline 배치 안에서 group은 한 행이며, 레이블은 레이블 열에, 줄은 컨트롤 열에 둡니다. line의 자식 노드는 inline 배치를 받지 않습니다.
  • CUSC-016 stacked: 레이블을 컨트롤 위에 두며, 선언이 없는 폼의 배치입니다. group은 상속받을 inline 배치를 끝내기 위해 이 값을 선언합니다.

design.layout이 없는 group은 둘러싼 group의 배치를 상속합니다. 반복 group은 stacked와 inline을 받으며, 이 값은 행의 필드에 적용됩니다. 출력은 폼 마크업이 정의합니다.

appearance:
  type: group
  label: Appearance
  design: { layout: inline }
  properties:
    theme: { type: select, label: Theme, items: { light: Light, dark: Dark }, description: Applies to every window. }
    font:
      type: group
      label: Font
      design: { layout: line }
      properties:
        family: { type: select, items: { mono: Mono, sans: Sans } }
        size: { type: text }

컴파일은 design.layout을 design.attributes 다음, 디자인 노드 전에 검사하며 INVALID_FORM_INPUT와 빈 위치로 실패합니다. 폼 루트는 배치를 받지 않으며, 컴파일은 루트의 design.layout을 buttons 다음에 검사합니다. JSON Schema는 필드 선언을 기술하므로 루트를 group으로 검사하고, 루트의 배치는 컴파일이 검사합니다.

  • CUSC-017 group이 아닌 필드, 폼 버튼, 폼 루트의 design.layout: Invalid design.layout at {path}: unknown key, 루트의 {path}는 form
  • CUSC-018 stacked, inline, line이 아닌 값: Invalid design.layout at {path}: expected stacked, inline or line
  • CUSC-019 반복 group의 line: Invalid design.layout at {path}: expected stacked or inline

표현식 문법은 토크나이저, 파서, 평가기를 정의합니다. 상대 경로, 와일드카드, 목록, 비교, 논리, 포함 여부, 조건부 값을 지원합니다. 산술, 함수 호출, JavaScript 평가는 지원하지 않습니다. behavior의 이벤트 스크립트는 문자열로 보존하며 실행은 표현식 엔진의 범위 밖입니다.

조건 트리

조건 트리는 필드가 데이터로 담는 JSON 값입니다. 애플리케이션은 이야기의 한 단계가 열리는 조건 같은 조건을 여기에 쓰고 직접 평가합니다. 조건 트리는 선언이 아니라 데이터입니다. CRUDUI는 이를 평가하지 않으며, 위 설정의 표현식이나 조건 맵과는 별개입니다. conditionTree 규칙은 값이 이 형태인지 검사합니다. 조건은 다음 형태 중 하나인 객체이며, 멤버는 어떤 순서로 써도 됩니다.

  • CUSC-072 group: { "all": [ … ] } 또는 { "any": [ … ] }. 유일한 멤버가 all 또는 any이고 그 값이 조건의 목록인 객체입니다. 목록은 비어 있어도 됩니다.
  • CUSC-073 필드 비교: { "field": …, "op": …, "value": … }. 정확히 이 세 멤버를 가진 객체입니다. field는 trim 후 비어 있지 않은 문자열입니다. op는 eq, ne, lt, le, gt, ge, in, has 중 하나입니다. value는 in이면 문자열, 유한한 숫자, boolean의 목록(비어 있어도 됨)이고, 그 밖의 op이면 문자열, 유한한 숫자 또는 boolean입니다.
  • CUSC-074 판정 문장: { "judge": … }. 유일한 멤버가 judge이고 그 값이 trim 후 비어 있지 않은 문자열인 객체입니다. 문장이 성립하는지는 애플리케이션이 판정합니다. 판정 문장은 규칙이 허용하는 곳에서만 조건입니다.
  • CUSC-075 깊이: 조건 트리의 깊이는 최대 32단계입니다. 루트 조건이 1단계이고, group 목록의 각 조건은 그 group보다 한 단계 아래입니다. 더 깊은 값은 조건 트리가 아닙니다. 이 한도는 검사의 작업량을 제한하므로 어떤 값도 runtime의 stack을 소진하지 못합니다. 또한 트리는 단계마다 JSON 두 단계(객체와 그 목록)를 중첩하므로, 이 한도는 트리와 그것을 둘러싼 form 데이터를 runtime의 JSON reader가 기본으로 받는 128단계의 중첩(Rust의 serde_json) 안에 둡니다.

조건의 의미(field가 가리키는 데이터, op의 비교 방식, group이 성립하는 때)는 트리를 평가하는 애플리케이션에 속합니다.

opens_when:
  type: textarea
  validate: { conditionTree: true }
pass:
  type: textarea
  validate: { required: true, conditionTree: judge }

데이터 { "opens_when": { "all": [{ "field": "episodes.e1.status", "op": "eq", "value": "passed" }] }, "pass": { "any": [{ "field": "clues.size", "op": "ge", "value": 2 }, { "judge": "Jian finds the second recording." }] } }는 두 규칙을 모두 통과합니다. opens_when에 judge 멤버가 있으면 그 규칙에 실패합니다.

언어와 선택지

콘텐츠 번역과 언어별 입력값은 별개입니다. 콘텐츠는 { en: Name, ko: 이름 } 같은 맵을 사용합니다. lang은 설정한 언어별 입력을 생성하며 only, frame, title, group_class를 설정합니다. 기본 언어는 ko, en, ja, zh입니다.

items는 인덱스가 값인 정적 배열, 값과 라벨의 맵, 선택 목록, from이 있는 그룹 소스, model이 있는 동적 소스 설정을 사용합니다. 정적 라벨에는 언어 맵을 사용할 수 있습니다. 생성기는 동적 소스 설정을 보존합니다. 레코드 조회와 외부 위젯 실행은 생성기 밖에서 처리합니다.

선택 목록

선택 목록은 { "value": …, "label": … } 객체의 배열입니다. 각 value는 문자열이나 유한한 숫자이며, option 값은 그 정규 텍스트입니다. 문자열은 그대로, 숫자는 Number.prototype.toString이 쓰는 텍스트입니다. 각 label은 값과 라벨의 맵의 라벨과 같습니다. 선택지는 값에 관계없이 목록 순서를 유지합니다.

items 배열의 원소 중 하나가 value 멤버나 choices 멤버가 있는 객체이면 그 배열은 선택 목록입니다. 이때 모든 원소는 멤버가 value와 label(choice·multichoice 필드에서는 외형 멤버도)뿐인 객체이거나, select 필드에서는 그룹이어야 하고, 모든 value는 문자열이나 유한한 숫자여야 하며, 그룹 안을 포함하여 목록 안에서 정규 텍스트가 같은 값이 둘 있으면 안 됩니다. items가 이 규칙 중 하나를 어긴 선택 목록인 필드를 바인딩하면 INVALID_FORM_INPUT, 메시지 Invalid items at {path}: expected value and label pairs with distinct string or number values, 빈 위치로 실패하며, {path}는 필드의 데이터 경로입니다. 이 검사는 필드 타입을 평가하기 전에 실행됩니다. select, choice, multichoice, search 필드는 값과 라벨의 맵처럼 쌍을 목록 순서대로 option으로 나열하고, dummy 필드는 값의 라벨을 표시합니다. in과 choice-label 형식도 같은 선택 목록을 받습니다.

필요한 순서로 형식을 고릅니다.

  • CUSC-020 값과 라벨의 맵은 값을 멤버 순서로 나열하므로 정수 형태의 값이 숫자 오름차순으로 먼저 옵니다. { "1": "Yes", "0": "No" }는 No를 Yes보다 먼저 표시합니다. 정수 형태가 아닌 값처럼 그 순서가 필요한 순서일 때 맵을 사용합니다.
  • CUSC-021 선택 목록은 값에 관계없이 작성한 순서를 유지합니다. [{ "value": 1, "label": "Yes" }, { "value": 0, "label": "No" }]는 Yes를 No보다 먼저 표시합니다. 값이 정수 형태이거나 섞여 있고 작성한 순서가 필요할 때 사용합니다.
  • CUSC-022 라벨의 배열은 인덱스 0, 1, …을 값으로 하여 작성한 순서를 유지합니다.

option이 없는 select 필드(select, dropdown, selectbox 타입)나 search 필드(search, autocomplete 타입)는 select 요소가 비지 않도록 placeholder option을 씁니다.

  • CUSC-080 items가 option을 주지 않는 select나 search 필드(items 없음, 빈 배열, 빈 맵, 또는 생성기가 레코드를 가져오지 않는 model이 있는 동적 소스 설명자)는 값이 빈 문자열이고 텍스트가 select인 option 요소를 정확히 하나 씁니다: <option value="">select</option>. 텍스트는 모든 표시 언어에서 같고 번역하지 않으며, 필드의 값과 관계없이 이 option은 선택되지 않습니다. option이 하나 이상인 필드는 placeholder option을 쓰지 않습니다. placeholder의 값은 빈 값입니다(CUVR-080).

선택지 그룹

select 필드(select, dropdown, selectbox 타입)의 선택 목록은 그룹 항목을 가질 수 있습니다. 그룹은 멤버가 label(값과 라벨의 맵의 라벨과 같음)과 choices({ "value": …, "label": … } 선택지가 하나 이상인 목록)뿐인 객체입니다. 그룹과 일반 선택지는 섞을 수 있으며 option은 작성한 순서를 유지합니다. 일반 선택지는 select의 option이고 그룹의 선택지는 optgroup 요소 하나의 option이며, 출력은 폼 마크업이 정의합니다. 그룹은 다른 그룹을 담지 않고, 그룹의 선택지에는 외형 멤버가 없습니다. 그룹 안팎의 모든 선택지의 값이 필드의 선택지입니다. 값은 목록 전체에서 정규 텍스트로 서로 다르고, 필드의 값은 어느 그룹에 있든 텍스트가 같은 option을 선택하며, in도 같은 목록을 받습니다.

다음 선택 목록을 가진 필드를 바인딩하면 위에서 설명한 대로 실패합니다. 다른 멤버가 있거나, label이나 choices가 없거나, choices가 목록이 아니거나 빈 목록이거나, 선택지 규칙을 어긴 선택지가 있는 그룹, 같은 그룹이나 다른 그룹이나 그룹 밖에 있는 값과 정규 텍스트가 같은 값, select 필드가 아닌 필드의 그룹입니다. choice-label 형식의 선택 목록에 있는 그룹은 그곳에서 선택지의 다른 멤버처럼 실패합니다.

region:
  type: select
  label: Region
  items:
    - { value: auto, label: Automatic }
    - label: Europe
      choices:
        - { value: eu-west, label: West }
        - { value: eu-north, label: North }
    - label: Asia
      choices:
        - { value: ap-east, label: East }
  validate:
    in:
      - { value: auto, label: Automatic }
      - { label: Europe, choices: [{ value: eu-west, label: West }, { value: eu-north, label: North }] }
      - { label: Asia, choices: [{ value: ap-east, label: East }] }

선택지 외형

choice·multichoice 필드(choice, radio, multichoice, checkboxes, checkcontainer 타입)의 선택 목록에서 각 선택지는 외형을 선언할 수 있습니다. class와 style은 선택지의 레이블에 적용하는 리터럴 문자열이고, attributes는 선택지의 input에 쓰는 선언한 속성입니다. 필드의 design.group(class와 style)은 선택지를 담는 요소에 적용합니다. 이를 사용해 선택지를 배치할 수 있습니다. 예를 들어 각 선택지가 style에서 설정한 사용자 정의 속성을 레이블이 읽는 색 견본 격자로 배치합니다. 출력은 폼 마크업이 정의합니다. 다른 필드, in, choice-label 형식의 선택 목록은 value와 label만 가지며, 다른 멤버는 위와 같이 실패합니다.

accent:
  type: choice
  label: Accent
  items:
    - { value: blue, label: Blue, class: swatch, style: "--swatch-bg: #1d4ed8", attributes: { aria-label: Blue accent } }
    - { value: green, label: Green, class: swatch, style: "--swatch-bg: #15803d" }
  design:
    group: { class: swatches }

바인딩은 선택 목록 규칙 다음에 외형을 검사합니다. 선택지를 목록 순서로, 각 선택지에서는 class, style, attributes 순서로 검사하며 모든 이름을 모든 값보다 먼저 검사합니다. INVALID_FORM_INPUT와 빈 위치로 실패하며, {index}는 선택지의 0부터 시작하는 위치입니다.

  • CUSC-023 문자열이 아닌 class 또는 style: Invalid items.{index}.{member} at {path}: expected a string
  • CUSC-024 객체가 아닌 attributes: Invalid items.{index}.attributes at {path}: expected an object
  • CUSC-025 규칙 밖의 이름 또는 거부된 이름: Invalid items.{index}.attributes.{name} at {path}: expected a data-* or aria-* name that crudui does not write
  • CUSC-026 문자열이 아닌 값: Invalid items.{index}.attributes.{name} at {path}: expected a string

반복 그룹의 선택지

lang이 없는 선택 필드(select, dropdown, selectbox, choice, radio, multichoice, checkboxes, checkcontainer 타입)는 같은 폼의 반복 그룹 행에서 선택지를 가져올 수 있습니다. 예를 들어 역할 필드는 폼이 선언한 인물 중 하나를 고릅니다. 이때 items는 그룹 소스이며, from 멤버와 선택 멤버 label, choices를 가진 객체입니다. from 멤버가 있는 items 객체는 그룹 소스이며 값과 라벨의 맵이 아닙니다. 값 from이 필요한 맵은 선택 목록으로 씁니다.

characters:
  type: group
  multiple: true
  properties:
    id: { type: text, validate: { required: true, unique: true } }
    name: { type: text }
roles:
  type: group
  multiple: true
  properties:
    character:
      type: select
      items: { from: characters.*.id, label: name }

  • CUSC-061 from은 {group}.*.{value} 경로입니다. {group}은 루트에서 반복 그룹까지의 속성 이름을 .으로 이은 것이며, 그 경로에서 마지막 그룹 말고는 반복 그룹이 없으므로 그룹은 폼 전체에서 행 집합이 하나입니다. *는 그룹의 행을 나타내고, {value}는 반복되지 않고 그룹이 아니며 lang이 없고 boolean을 담지 않는 (CUSC-068) 그룹의 직계 자식 필드 이름입니다. 소스를 선언한 필드는 그 그룹 안에 있어도 되고 폼의 다른 곳에 있어도 됩니다.

  • CUSC-062 label은 같은 그룹에서 반복되지 않고 그룹이 아니며 lang이 없고 boolean을 담지 않는 (CUSC-068) 직계 자식 필드의 이름입니다. label이 없으면 선택지의 라벨은 그 값입니다.

  • CUSC-063 선택지는 폼을 렌더링하거나 데이터를 검증할 때 읽는 그룹의 행이며, 그룹 데이터의 순서를 따릅니다. 행의 {value} 필드 값이 문자열이나 유한한 숫자이고 그 정규 텍스트가 다듬은 뒤 비어 있지 않으면, 그 행은 정규 텍스트를 값으로 하는 선택지가 됩니다. 그 밖의 행은 선택지가 되지 않습니다. 앞선 행과 정규 텍스트가 같은 행은 그 값을 반복합니다(CUSC-090). 선택지의 라벨은 행의 label 필드 값이 문자열이나 유한한 숫자이고 그 정규 텍스트가 다듬은 뒤 비어 있지 않으면 그 정규 텍스트이고, 그렇지 않으면 선택지의 값입니다. 데이터가 없는 그룹에는 선택지가 없습니다. 필드는 이 선택지를 같은 쌍의 선택 목록처럼 나열합니다.

  • CUSC-090 선택지의 값은 선택 목록의 값처럼 서로 다릅니다. 렌더링은 반복된 값을 첫 행의 선택지로 한 번 나열하고, 검증은 그룹의 행이 값을 반복하는 데이터를 거부합니다. INVALID_FORM_INPUT, 빈 위치, 메시지 Group source value repeats an earlier row: {value} at {path}의 입력 오류입니다 (반복 그룹의 선택지, CUVR-087). 그룹의 행은 폼이 제출하는 데이터에서 오므로, 반복된 값은 선택지가 표현할 수 없는 데이터이고 검증은 행 하나를 고르지 않고 그것을 보고합니다.

  • CUSC-089 choices는 행의 선택지에 더해지는 리터럴 선택지 목록입니다. 예를 들어 인물 id 옆의 청중 player가 그렇습니다. 선택 목록처럼 { "value": …, "label": … } 쌍이며, 각 쌍은 이 두 멤버만 가지고, value는 행의 모든 선택지처럼 정규 텍스트가 다듬은 뒤 비어 있지 않은 문자열이나 유한한 숫자, label은 값과 라벨의 맵의 라벨이며, 정규 텍스트가 같은 두 값은 없습니다. 필드의 선택지는 쓴 순서의 리터럴 선택지 다음에 행의 선택지(CUSC-063)가 옵니다. 값의 정규 텍스트가 리터럴 선택지와 같은 행은 그 값을 두 번 내므로 버리지 않고 거부합니다: 바인딩이나 데이터 검증을 위해 선택지를 읽을 때 INVALID_FORM_INPUT, 빈 위치, 메시지 Group source value repeats a literal choice at {path}: {value}로 실패하며, {path}는 행의 {value} 필드의 데이터 경로(예: characters.c4.id), {value}는 그 정규 텍스트입니다. 컴파일은 label이 가리키는 필드의 type 다음에 choices를 마지막으로 검사하며, 이 규칙을 어기는 choices는 Invalid items.choices at {path}: expected value and label pairs with distinct string or number values로 실패합니다.

    audience:
  type: select
  items: { from: characters.*.id, label: name, choices: [{ value: player, label: Player }] }

  • CUSC-071 선택지는 데이터를 따릅니다. 폼 인스턴스는 데이터가 바뀔 때마다(setValue, setData, addRow, copyRow, removeRow, moveRow, rekeyRow, undo, redo) 현재 데이터에서 선택지를 나열하므로, 소스 그룹의 행이나 그 {value} 필드나 label 필드가 바뀌면 인스턴스의 다음 뷰가 나열하는 선택지가 바뀝니다. 선택지를 나열해도 값은 바뀌지 않습니다. 더 이상 어떤 선택지와도 맞지 않는 값은 데이터에 남고, 검증이 그 값을 보고합니다(반복 그룹의 선택지).

브라우저 바인딩은 페이지가 보여 주는 선택지를 자신이 가진 데이터의 선택지와 같게 유지합니다. React, Vue, Svelte의 Form 컴포넌트와 HTML 렌더러의 페이지는 인스턴스의 모든 뷰를 렌더링하므로 변경마다 그 선택지를 보여 줍니다. 서버가 렌더링한 폼의 브라우저 검증 바인딩(폼 바인딩)은 연결할 때와 input 또는 change 이벤트마다 컨트롤의 데이터로 그룹 소스가 있는 각 필드의 위젯을 다시 렌더링하고, 아직 선택지인 선택된 값은 계속 선택된 상태로 둡니다. 더 이상 선택지가 아닌 값은 어떤 컨트롤도 갖지 않으므로, 네이티브 제출처럼 그 데이터에 그 값이 없습니다.

모든 검증기는 값을 이 선택지와 대조합니다(반복 그룹의 선택지). 컴파일은 필드의 다른 선언(behavior와 범위 필드의 규칙 포함) 다음에 그룹 소스를 검사하며, 순서는 items의 멤버(선언 순서), 필드, from, from이 가리키는 필드의 type, label, label이 가리키는 필드의 type, choices(CUSC-089)입니다. INVALID_FORM_INPUT와 빈 위치로 실패합니다.

  • CUSC-064 from, label, choices 말고 다른 멤버: Invalid items.{key} at {path}: unknown key
  • CUSC-065 선택 필드가 아니거나 lang이 있는 필드: Invalid items.from at {path}: expected a choice field without lang
  • CUSC-066 그 형식의 문자열이 아니거나 그룹 또는 필드가 이 규칙을 어기는 from: Invalid items.from at {path}: expected {group}.*.{field} for a field of a repeated group outside repeated groups
  • CUSC-067 그룹의 그런 필드 이름이 아닌 label: Invalid items.label at {path}: expected the name of a direct child field of the group without multiple, properties or lang
  • CUSC-068 boolean을 담는 필드를 가리키는 from이나 label: Invalid items.{member} at {path}: {field} holds a boolean, expected a field whose values are strings or numbers. {member}는 from이나 label이고 {field}는 가리킨 필드의 선언 경로(예: characters.active)입니다. type이 값으로 boolean을 저장하는 필드는 boolean을 담습니다: 데이터가 true나 false인 type checkbox와 switcher입니다(checkbox 필드, CUMK-027, 스위치). 그런 필드의 행은 선택지도 라벨도 주지 않으므로(CUSC-063) 컴파일은 선택지 없이 나열하지 않고 거부합니다. 나중에 추가되는 type이 값으로 boolean을 저장하면 이 규칙을 따르고 이 문장에 추가됩니다.

합성과 검증

합성은 $ref를 해석하고 $patch를 적용한 후 결과 필드 정의를 처리합니다. 참조가 없으면 로드 오류입니다. 합성은 레코드 값에 의존하지 않습니다. 폼 컴파일은 템플릿마다 합성을 한 번 처리합니다.

$ref 값은 파일 경로 하나 또는 파일 경로 목록입니다. 목록은 선언 순서대로 해석해 병합하므로 같은 키에서는 뒤의 경로가 앞의 경로를 덮어씁니다. 문자열이 아닌 항목은 로드 오류입니다. 경로는 (file.yml).key 형태로 파일의 일부를 선택할 수 있습니다. 참조는 선택한 계층의 필드 맵으로 해석되며, 그래서 루트가 $ref뿐인 선언은 아직 명세가 아니라 그 필드 맵입니다.

CLI 정적 검사도 해결되지 않은 조합을 거부합니다. 조합 전 필드 검사를 참조 해석 성공으로 처리하지 않습니다.

검증기는 validate 규칙과 현재 데이터를 검사합니다. 검증 규칙은 규칙의 의미를 설명합니다. tests/fixtures/expr, tests/fixtures/compose, tests/fixtures/validate의 공유 사례로 TypeScript, PHP, Go, Rust 구현을 비교합니다. SSR 비교와 마운트한 DOM 테스트는 서로 다른 동작을 검사하므로 별도로 기록합니다.

다른 repeated group의 행 id처럼 다른 필드의 항목을 가리키는 값을 가진 필드는 그 필드의 선언 경로로 validate.reference를 선언합니다(예: reference: facts.id). 데이터가 그곳에 선언한 id와 값의 검사는 참조가 정의합니다.

목록

목록은 columns를 선언합니다. 행 레코드는 buildList(spec, rows, options)의 별도 인자입니다. 각 열은 field 경로, label, format, design, 선택적 sortable을 정의합니다. 목록과 폼은 합성, 조건, 외형, 콘텐츠 번역을 공유합니다. 목록은 입력 대신 표시 셀을 사용합니다. columns가 없는 목록은 List specification must declare columns로 실패하며, 표시 형식 선언이 모든 목록과 상세 선언의 검사를 정의합니다.

  • CUSC-027 text: truncate
  • CUSC-028 date: pattern
  • CUSC-029 number: decimals, thousands, prefix, suffix
  • CUSC-030 badge: 값과 스타일의 map, 번역된 라벨
  • CUSC-031 link: href, target, text
  • CUSC-032 choice-label: items
  • CUSC-033 bool: true, false 라벨과 as
  • CUSC-034 image: width, height, alt
  • CUSC-035 html: 이스케이프하지 않은 표시 HTML

format은 타입 문자열 또는 객체를 사용합니다. 생략, false, true는 텍스트를 선택합니다. 형식별 설정은 해당 객체에 작성합니다. 표시 형식은 각 형식, 목록과 상세가 받는 입력, 마크업을 정의합니다. sort, pagination, search, actions는 페이지 동작을 선언합니다. empty는 번역된 빈 목록 메시지를, description은 목록 앞에 표시하는 번역된 텍스트를 정의합니다. 목록 모델은 { columns, rows, pagination, sort, actions, empty, description, design }입니다. 정렬 필드를 선언하지 않으면 sort가 없고, description은 번역한 description이며 선언하지 않으면 빈 텍스트입니다. 코어는 데이터베이스 조회, 레코드 필터링, 서버 페이지 처리를 수행하지 않습니다. 현재 페이지와 전체 레코드 수는 호출자가 제공합니다. pagination이 활성화되면 생략된 perPage는 20, mode는 pages, page는 1로 해석합니다. 해석된 모델에는 pageCount가 포함됩니다. 전체 수가 없으면 0이고, 있으면 total이 0이어도 최소 1입니다. per_page는 1 이상의 정수이며, 선언 검사와 페이지 번호 범위는 표시 규칙이 정합니다. 모든 렌더러는 이전·페이지 번호·다음 버튼을 출력합니다. 현재 페이지에는 aria-current="page"를 지정하고 비활성화하며, 경계의 이전·다음 버튼도 비활성화합니다. 버튼은 data-page를 가지며 실제 이동과 데이터 조회는 호출자가 담당합니다.

상세

상세는 fields를 선언하며, 하나의 레코드는 buildDetail(spec, record, options)에 별도로 전달합니다. 각 필드는 목록 셀과 같은 읽기 전용 표시 계약인 field, label, format, design을 사용합니다. 상세 필드는 목록과 합성, 조건, 외형, 콘텐츠 번역, 셀 형식을 공유하지만 정렬과 페이지 처리를 선언하지 않습니다. 상세는 목록과 같은 방식으로 actions를 선언합니다. buildDetail은 순서가 있는 표시 필드, 해석한 동작과 평가된 상세 외형을 반환하고, 렌더러는 다른 데이터를 조회하지 않고 그 모델을 소비합니다.

모델은 { fields, actions, design }입니다. actions는 목록 동작 모델을 멤버 순서로 가지며, 상세가 동작을 선언하지 않으면 비어 있습니다. 각 필드는 key, label, format, value, display, design 멤버를 이 순서로 가집니다. 하나의 레코드에 대한 목록 셀 앞에 키와 번역한 라벨을 둔 것입니다. 레코드의 필드 경로에 값이 없으면 목록 셀과 마찬가지로 value는 null입니다. 객체가 아닌 선언은 Detail specification must be an object, fields가 없는 선언은 Detail specification must declare fields, 객체가 아닌 레코드는 Detail record must be an object로 실패합니다. 모든 런타임은 같은 모델과 같은 오류를 반환하고, 모든 문자열 렌더러는 정의 목록 앞의 이미지 preload 링크를 포함해 React 서버 렌더링과 같은 상세 HTML을 씁니다.

인수 기준

  1. CUSC-036 필드 평가 전에 합성을 처리하고 누락된 참조를 오류로 반환합니다.
  2. CUSC-038 JavaScript 평가 없이 표현식 파서로 조건을 평가합니다.
  3. CUSC-039 표시 언어와 별도로 언어별 입력값을 보존합니다.

스키마는 구조, 콘텐츠, 검증, 외형, 위젯 옵션을 분리합니다. 4개 언어의 공유 검증 사례와 3개 프레임워크의 SSR 출력을 비교하고, 마운트한 뷰에서 폼 편집 동작을 검증합니다.

반복 필드는 행 개수 제한으로 숫자형 multiple.min과 multiple.max를, 행 컨트롤로 multiple.copy와 multiple.sortable을, 각 행의 제목이 되는 자식 필드로 multiple.title을, 컨트롤 위치로 multiple.controls(기본 header)를, 행 헤더 고정 여부로 multiple.header(기본 static, 또는 sticky)를 받습니다. 렌더링은 폼 마크업에서 정의합니다. 인스턴스의 컬렉션 키가 행을 식별하며 스키마는 숨김 식별자 필드를 정의하지 않습니다. 행 연산은 폼 런타임에 정의합니다. multiple.only: true와 같은 multiple: only는 데이터에만 존재하는 행을 선언합니다. 데이터의 키가 곧 행이고, 데이터가 없으면 행이 없으며, 폼은 행 컨트롤과 행 연산을 제공하지 않습니다. multiple.only는 title, header, keys와 함께 쓰며 min, max, copy, sortable, controls, onclick과 함께 쓸 수 없습니다. 컴파일은 그 밖의 문자열을 Invalid multiple at {path}: expected a boolean, only or an object로, 불리언이 아닌 only를 Invalid multiple.only at {path}: expected a boolean으로, only: true 옆의 제외된 키를 Invalid multiple.{key} at {path}: unknown key로 보고합니다.

button·action 필드의 컨트롤 텍스트는 content에서만 가져오며 필드 호환 키 text는 사용하지 않습니다. 폼 컴파일은 multiple, lang, design의 값 형식이 잘못되면 INVALID_FORM_INPUT와 Invalid {key} at {path}: expected {expected} 메시지로 거부합니다. {path}는 companies.name처럼 필드의 구조 경로입니다. 조건 맵은 비어 있지 않은 객체입니다. buttons가 없는 폼은 제출 버튼 하나를 가지며, button과 link는 text가, link는 href가 필요합니다(폼 마크업 참고).

  • CUSC-041 multiple: 불리언, only 또는 객체
  • CUSC-081 검증은 multiple이 있고 불리언, 문자열 only, 객체가 아닌 필드(null과 목록 포함)를 로드할 때 INVALID_RULE_PARAMETER, 메시지 Invalid multiple at {path}: expected a boolean, only or an object, 위치와 {path}인 필드의 선언 경로로 거부한다. 필드는 선언 순서로, 각 필드는 자식보다 먼저 검사하며, 필드의 multiple은 그 그룹 소스와 규칙보다 먼저 검사한다(매개변수 오류).
  • CUSC-042 multiple.only: 불리언
  • CUSC-043 multiple.min, multiple.max: 숫자
  • CUSC-044 multiple.copy, multiple.sortable: 불리언
  • CUSC-045 multiple.title: 반복 그룹의 직속 자식 중 반복·그룹·lang이 아닌 필드 이름
  • CUSC-046 multiple.controls: header, footer 또는 outline
  • CUSC-047 multiple.header: static 또는 sticky
  • CUSC-048 lang: 불리언 또는 객체
  • CUSC-049 lang.only: 언어 코드 문자열 목록 또는 객체
  • CUSC-050 design: 불리언 또는 객체
  • CUSC-051 content: 문자열 또는 언어 맵; 버튼·액션 필드의 컨트롤 텍스트
  • CUSC-052 messages: 등록된 규칙 이름과 메시지 문자열의 객체
  • CUSC-053 buttons: 버튼 목록(type: submit, reset, button, link); 폼 루트에서만
  • CUSC-054 action: 문자열 method, url, enctype을 가진 객체; 폼 루트에서만
  • CUSC-087 dataLimits: 정수 depth(1부터 512)와 values(1부터 1000000)를 가진 객체; 폼 루트에서만 (데이터 한도)
  • CUSC-055 design.show: 표현식, 불리언 또는 조건 맵
  • CUSC-056 design.class, design.style: 문자열 또는 조건 맵
  • CUSC-057 design.label, design.wrapper, design.group, design.prepend: 객체
  • CUSC-058 해당 노드의 class와 style: 문자열 또는 조건 맵
  • CUSC-059 design.attributes, design.wrapper.attributes: data-* 또는 aria-* 이름에서 문자열로의 객체; 폼 필드에서만(선언한 속성)
  • CUSC-060 design.layout: stacked, inline, line; group 필드에서만(배치)
  • CUSC-076 multiple.keys: 반복 그룹을 가리키는 참조; only: true와 함께(키 맵)

컴파일은 선언 순서로 필드를 검사하며 자식보다 필드를 먼저 검사합니다. 스키마는 multiple, lang, design, 디자인 노드, behavior를 닫습니다. 이들이 나열하지 않은 키는 Invalid {bucket}.{key} at {path}: unknown key로 실패합니다(예: Invalid design.label.text at name: unknown key). 버킷 안에서는 값보다 먼저 선언 순서로 알 수 없는 키를 검사합니다. 순서는 buttons와 action, multiple, lang, design(이어서 노드 label, wrapper, group, prepend), behavior입니다. options와 동적 items 원천은 타입별 설정을 위해 열려 있으며, 금지 메타 키는 어디서나 거부합니다. validate와 messages의 키는 등록된 규칙 이름입니다. 메타 스키마는 다른 이름을 거부하고, 검증은 UNKNOWN_RULE로 로드에 실패합니다(매개변수 오류). 메타 스키마는 등록된 모든 검증 규칙의 매개변수 형태를 선언하고, 열어 둔 모든 값의 모든 깊이에서 금지 키를 거부합니다.

키 맵

키 맵은 키가 폼의 다른 반복 그룹의 id인, 데이터에만 존재하는 컬렉션입니다. 예를 들어 사실 하나에 대한 각 인물의 입장이나, 다른 각 인물에 대한 메모입니다. 반복 그룹의 id는 그 행 키입니다. 행은 id라는 필드가 아니라 키로 식별합니다(폼 런타임). 필드는 only: true 옆의 multiple.keys로 키 맵을 선언하며, 이 필드는 반복 스칼라 필드이거나 반복 그룹일 수 있습니다.

characters:
  type: group
  multiple: true
  properties:
    name: { type: text }
    relation_notes:
      type: text
      multiple: { only: true, keys: ..characters }
facts:
  type: group
  multiple: true
  properties:
    truth: { type: text }
    holders:
      type: select
      items: { knows: Knows, suspects: Suspects }
      multiple: { only: true, keys: ..characters }
  • CUSC-077 multiple.keys의 값은 반복 그룹을 가리키는 필드 참조이며 enddate 매개변수와 같은 방식으로 씁니다(조건부 매개변수). .name이나 점 없는 name은 선언한 필드 옆의 필드를 가리키고, 앞의 점이 하나 늘 때마다 필드 한 단계 위로 올라가며 행 키는 그 컬렉션과 함께 떠납니다. 앞에 점이 없고 안에 점이 있는 참조는 폼 루트에서 시작하는 경로입니다. 따라서 선언에서 참조는 선언한 필드의 선언 경로에서 앞의 점 개수만큼(점 없는 이름은 하나, 루트에서 시작하는 경로는 전부) 필드를 떠난 뒤 그 이름들을 따라갑니다. 참조가 폼 루트를 벗어나지 않고, 빈 이름과 *가 없으며, 마지막을 제외한 각 이름이 그때까지 도달한 그룹의 필드 중 반복이 아닌 그룹을 가리키고, 마지막 이름이 반복 그룹을 가리키면 참조는 반복 그룹을 가리킵니다. 예에서 두 참조는 모두 relation_notes 또는 holders와 그것을 둘러싼 반복 그룹을 떠나 characters를 가리킵니다.
  • CUSC-078 컴파일은 multiple.only 다음에 multiple.keys를 검사합니다. only: true 없는 keys는 Invalid multiple.keys at {path}: expected multiple.only: true로, 문자열이 아닌 값은 Invalid multiple.keys at {path}: expected a reference to a repeated group로 실패하며, 둘 다 INVALID_FORM_INPUT와 빈 위치를 가집니다. 렌더링은 keys를 읽지 않습니다. 필드의 행은 데이터의 행입니다. 검증은 참조를 해석하고 데이터의 키를 검사합니다(키 맵).

위젯과 소스 설정

options는 해당 위젯의 설정을 보존합니다. 선언을 허용하는 것이 코어가 외부 위젯을 실행한다는 뜻은 아닙니다. 검색은 keyword_min_length, 지도 기술자는 marker_draggable, zoom, geometry_type, 태그는 max_tags를 사용합니다. 라벨 설정은 checkbox_label과 on_label을 포함합니다. 컨테이너 설정은 collapse, expend, view_total, stepper, blank_message를 포함합니다. callback과 event는 위젯 스크립트를 보존합니다.

동적 선택지 기술자는 model, method, table, relations, keys, api_server를 지정할 수 있습니다. 내부 items 컬렉션은 초기 정적 선택지를 제공합니다. 질의와 엔드포인트 호출은 생성기 밖에서 수행합니다. 생성기는 relations를 JSON.stringify가 쓰는 대로 data-source-relations에 쓰고, 각 숫자는 ECMAScript Number.prototype.toString이 쓰는 대로 쓰므로 1e21은 1e+21이고 100000000000000000000은 자릿수를 유지하며 -0은 0입니다.

  • CUSC-088 relations는 그 값의 JSON 텍스트로 data-source-relations에 씁니다. 없거나 null인 relations는 []로 씁니다.

언어 설정은 mode, 언어 목록 또는 재정의 맵인 only, 그룹의 name, key, frame, title, group_class 설정을 받습니다. 언어별 재정의는 validate, design, behavior, options를 변경할 수 있습니다.