@dou-ui/form-builder 0.0.0-stage → 0.1.0-alpha.1

package/dist/core/check.js

@@ -0,0 +1,314 @@
+import { isContainer, isField, isList, isPage, isSteps, isTabs } from "./document.js";
+import { checkExpression } from "./expression.js";
+import { resolveFields } from "../fields/builtin.js";
+import { analyseFormulas } from "./formulas.js";
+// src/core/check.ts
+var EXPRESSIONS = [
+	"visibleWhen",
+	"disabledWhen",
+	"requiredWhen",
+	"formula"
+];
+/**
+* The problems of a document, for an editor to point at, before it is
+* saved or rendered: ids used twice, fields without a name or sharing one,
+* types nobody registered, pages outside tabs and steps, expressions that
+* do not parse or read fields that are not there, formulas that read
+* each other, and rules naming a validator nobody gave.
+*/
+function checkDocument(document, options = {}) {
+	const problems = [];
+	if (document.version !== 1) problems.push({
+		code: "version",
+		path: "version",
+		text: String(document.version),
+		message: `Version ${String(document.version)} is not known`
+	});
+	const types = resolveFields(options.fields);
+	const ids = /* @__PURE__ */ new Set();
+	const known = scopeNames(document.nodes);
+	/** Where each node is, by the node itself, so nodes that share an id each have their own. */
+	const paths = /* @__PURE__ */ new Map();
+	/** `itemFields`: the names an item of the list around the nodes has; none outside lists. */
+	function visit(nodes, parent, itemFields, at) {
+		for (const [index, node] of nodes.entries()) {
+			const path = `${at}[${index}]`;
+			paths.set(node, path);
+			if (ids.has(node.id)) problems.push({
+				code: "duplicate-id",
+				nodeId: node.id,
+				path,
+				text: node.id,
+				message: `The id "${node.id}" is used twice`
+			});
+			ids.add(node.id);
+			const pageParent = !!parent && (isTabs(parent) || isSteps(parent));
+			if (isPage(node) && !pageParent) problems.push({
+				code: "misplaced-page",
+				nodeId: node.id,
+				path,
+				text: node.id,
+				message: "A page belongs in tabs or steps"
+			});
+			if (pageParent && !isPage(node)) problems.push({
+				code: "not-a-page",
+				nodeId: node.id,
+				path,
+				text: node.id,
+				message: "Tabs and steps hold pages only"
+			});
+			if ((isTabs(node) || isSteps(node) || isList(node)) && !node.children?.length) problems.push({
+				code: "empty",
+				nodeId: node.id,
+				path,
+				text: node.id,
+				message: isList(node) ? "The list has no fields" : `The ${node.type} have no pages`
+			});
+			if (isList(node) && !node.name) problems.push({
+				code: "missing-name",
+				nodeId: node.id,
+				path,
+				text: node.id,
+				message: "The list has no name"
+			});
+			if (isField(node)) {
+				const type = types.get(node.type);
+				if (!type) problems.push({
+					code: "unknown-type",
+					nodeId: node.id,
+					path,
+					text: node.type,
+					message: `There is no field type "${node.type}"`
+				});
+				else if (type.kind !== "display" && !node.name) problems.push({
+					code: "missing-name",
+					nodeId: node.id,
+					path,
+					text: node.id,
+					message: "The field has no name"
+				});
+			}
+			const expressions = EXPRESSIONS.map((key) => [key, node[key]]);
+			if (isField(node) || isList(node)) (node.rules ?? []).forEach((rule, order) => {
+				expressions.push([`rules.${order}.check`, rule.check]);
+				if (rule.validator === void 0) return;
+				const rulePath = `${path}.rules[${order}]`;
+				if (rule.check) problems.push({
+					code: "check-and-validator",
+					nodeId: node.id,
+					path: rulePath,
+					text: rule.validator,
+					message: "A rule has both check and validator; only check runs"
+				});
+				else if (options.validators && !options.validators.includes(rule.validator)) problems.push({
+					code: "unknown-validator",
+					nodeId: node.id,
+					path: `${rulePath}.validator`,
+					text: rule.validator,
+					message: `There is no validator "${rule.validator}"`
+				});
+			});
+			if (isField(node) && node.source?.arg) expressions.push(["source.arg", node.source.arg]);
+			for (const [property, source] of expressions) {
+				if (!source) continue;
+				const found = checkExpression(source, {
+					fields: known,
+					itemFields,
+					functions: options.functions
+				});
+				for (const problem of found) problems.push({
+					code: "expression",
+					nodeId: node.id,
+					path: `${path}.${property.replace(/\.(\d+)/g, "[$1]")}`,
+					property,
+					text: source,
+					expression: problem,
+					message: `${property}: ${problem.message}`
+				});
+			}
+			if (isList(node)) visit(node.children ?? [], node, scopeNames(node.children ?? []), `${path}.children`);
+			else if (isContainer(node)) visit(node.children ?? [], node, itemFields, `${path}.children`);
+		}
+	}
+	visit(document.nodes, void 0, [], "nodes");
+	duplicateNames(document.nodes, problems, paths);
+	for (const cycle of analyseFormulas(document, options.functions).cycles) {
+		const text = cycle.map(({ label }) => label);
+		const node = cycle[0].node;
+		problems.push({
+			code: "formula-cycle",
+			nodeId: node.id,
+			path: paths.get(node) ?? "",
+			text: text.join(" → "),
+			message: `The formulas read each other: ${text.join(" -> ")}`
+		});
+	}
+	return problems;
+}
+var nameOf = (node) => isList(node) || isField(node) ? node.name : void 0;
+/** The names of one scope: the document's, or a list item's. Groups and pages share their parent's. */
+function scopeNames(nodes) {
+	const result = [];
+	for (const node of nodes) {
+		const name = nameOf(node);
+		if (name) result.push(name);
+		if (isContainer(node) && !isList(node)) result.push(...scopeNames(node.children ?? []));
+	}
+	return result;
+}
+/** Names used twice within one scope. */
+function duplicateNames(nodes, problems, paths) {
+	const scan = (list, seen) => {
+		for (const node of list) {
+			const name = nameOf(node);
+			if (name) {
+				if (seen.has(name)) problems.push({
+					code: "duplicate-name",
+					nodeId: node.id,
+					path: paths.get(node) ?? "",
+					text: name,
+					message: `The name "${name}" is used twice`
+				});
+				seen.add(name);
+			}
+			if (isList(node)) scan(node.children ?? [], /* @__PURE__ */ new Set());
+			else if (isContainer(node)) scan(node.children ?? [], seen);
+		}
+	};
+	scan(nodes, /* @__PURE__ */ new Set());
+}
+/** Upgrades from an older version of the document, by the version they start from. */
+var migrations = {};
+/**
+* The document in the current version (`1`). Documents of an older
+* version are upgraded step by step; there are none yet, so for now this
+* only checks the version. A document without a version is read as
+* version 1, as the renderer does. Throws for anything that is not a
+* document and for a version it does not know.
+*/
+function migrateDocument(document) {
+	if (document === null || typeof document !== "object" || Array.isArray(document)) throw new Error("[@dou-ui/form-builder] a form document must be an object");
+	let current = document;
+	if (current.version === void 0) current = {
+		...current,
+		version: 1
+	};
+	while (current.version !== 1) {
+		const step = typeof current.version === "number" ? migrations[current.version] : void 0;
+		if (!step) throw new Error(`[@dou-ui/form-builder] form document version ${String(current.version)} is not known`);
+		current = step(current);
+	}
+	return current;
+}
+var NODE_KEYS = {
+	id: "string",
+	type: "string",
+	name: "string",
+	label: "string",
+	help: "string",
+	title: "string",
+	description: "string",
+	addText: "string",
+	visibleWhen: "string",
+	disabledWhen: "string",
+	requiredWhen: "string",
+	formula: "string",
+	required: "boolean",
+	bordered: "boolean",
+	sortable: "boolean",
+	min: "number",
+	max: "number",
+	columns: "number",
+	span: "span",
+	props: "object",
+	source: "object",
+	rules: "array",
+	children: "array"
+};
+var RULE_KEYS = {
+	required: "boolean",
+	type: "string",
+	min: "number",
+	max: "number",
+	pattern: "string",
+	flags: "string",
+	check: "string",
+	validator: "string",
+	message: "string",
+	trigger: "string"
+};
+var DOCUMENT_KEYS = {
+	version: "number",
+	layout: "string",
+	labelAlign: "string",
+	labelWidth: "number",
+	size: "string",
+	requiredMark: "mark",
+	columns: "number",
+	nodes: "array"
+};
+var CONTAINER_TYPES = /* @__PURE__ */ new Set([
+	"section",
+	"tabs",
+	"steps",
+	"page",
+	"list"
+]);
+var SHAPE_LIMIT = 50;
+var isObject = (value) => value !== null && typeof value === "object" && !Array.isArray(value);
+function fits(value, expected) {
+	switch (expected) {
+		case "object": return isObject(value);
+		case "array": return Array.isArray(value);
+		case "span": return typeof value === "number" && Number.isFinite(value) || isObject(value) && Object.values(value).every((each) => typeof each === "number");
+		case "mark": return typeof value === "boolean" || value === "optional";
+		case "number": return typeof value === "number" && Number.isFinite(value);
+		default: return typeof value === expected;
+	}
+}
+/**
+* Where some data, e.g. JSON pasted into an editor, is not shaped like a
+* form document: a key holding the wrong kind of value, or a node without
+* its `id`, `type` or `children`. Problems name the path to the value, so
+* they can be found in the text. Run `checkDocument` on the result for
+* the problems of a document that is shaped right.
+*/
+function checkDocumentShape(data) {
+	const problems = [];
+	const add = (path, code, expected) => {
+		if (problems.length >= SHAPE_LIMIT) return;
+		problems.push({
+			path,
+			code,
+			expected,
+			message: code === "required" ? `${path} is missing` : `${path || "The document"} should be ${expected === "span" ? "a number or an object of numbers" : expected === "mark" ? "a boolean or \"optional\"" : `a ${expected}`}`
+		});
+	};
+	const keys = (value, spec, path) => {
+		for (const [key, expected] of Object.entries(spec)) if (value[key] !== void 0 && !fits(value[key], expected)) add(`${path}.${key}`, "type", expected);
+	};
+	const node = (value, path) => {
+		if (!isObject(value)) return add(path, "type", "object");
+		keys(value, NODE_KEYS, path);
+		for (const key of ["id", "type"]) if (value[key] === void 0) add(`${path}.${key}`, "required", "string");
+		if (Array.isArray(value.rules)) value.rules.forEach((rule, index) => {
+			const at = `${path}.rules[${index}]`;
+			if (isObject(rule)) keys(rule, RULE_KEYS, at);
+			else add(at, "type", "object");
+		});
+		if (isObject(value.source) && typeof value.source.name !== "string") add(`${path}.source.name`, value.source.name === void 0 ? "required" : "type", "string");
+		if (typeof value.type === "string" && CONTAINER_TYPES.has(value.type) && value.children === void 0) add(`${path}.children`, "required", "array");
+		if (Array.isArray(value.children)) value.children.forEach((child, index) => node(child, `${path}.children[${index}]`));
+	};
+	if (!isObject(data)) {
+		add("", "type", "object");
+		return problems;
+	}
+	for (const [key, expected] of Object.entries(DOCUMENT_KEYS)) if (data[key] !== void 0 && !fits(data[key], expected)) add(key, "type", expected);
+	if (data.nodes === void 0) add("nodes", "required", "array");
+	if (Array.isArray(data.nodes)) data.nodes.forEach((each, index) => node(each, `nodes[${index}]`));
+	return problems;
+}
+export { checkDocument, checkDocumentShape, migrateDocument };
+
+//# sourceMappingURL=check.js.map

package/dist/core/check.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"check.js","names":[],"sources":["../../src/core/check.ts"],"sourcesContent":["import { isContainer, isField, isList, isPage, isSteps, isTabs } from './document'\nimport { checkExpression } from './expression'\nimport type { ExpressionProblem } from './expression'\nimport { analyseFormulas } from './formulas'\nimport type { FormDocument, FormNode } from './types'\nimport { resolveFields } from '../fields/builtin'\nimport type { FormFieldType } from '../fields/define'\n\nexport interface DocumentProblem {\n  code:\n    | 'version'\n    | 'duplicate-id'\n    | 'missing-name'\n    | 'duplicate-name'\n    | 'unknown-type'\n    | 'misplaced-page'\n    | 'not-a-page'\n    | 'empty'\n    | 'expression'\n    | 'formula-cycle'\n    | 'unknown-validator'\n    | 'check-and-validator'\n  /** The node at fault; none for the document's own problems. */\n  nodeId?: string\n  /**\n   * Where the problem is, as a path into the document, e.g.\n   * `nodes[1].children[0]` or `nodes[2].rules[0].check`; `version` for the\n   * version, and `''` for a problem of the whole.\n   */\n  path: string\n  /** The property at fault, e.g. `visibleWhen`, for an expression. */\n  property?: string\n  /** The id, name, type or expression source at fault, for the editor's message. */\n  text: string\n  /** The expression's own problem, for `expression`. */\n  expression?: ExpressionProblem\n  /** An English description, for logs. */\n  message: string\n}\n\nexport interface CheckDocumentOptions {\n  /** Field types besides the built-in ones, as given to the renderer. */\n  fields?: readonly FormFieldType<any>[]\n  /** Functions the expressions can call besides the built-in ones. */\n  functions?: readonly string[]\n  /**\n   * The names of the validators given to the renderer. Left out, a rule's\n   * `validator` is not checked against them.\n   */\n  validators?: readonly string[]\n}\n\nconst EXPRESSIONS = ['visibleWhen', 'disabledWhen', 'requiredWhen', 'formula'] as const\n\n/**\n * The problems of a document, for an editor to point at, before it is\n * saved or rendered: ids used twice, fields without a name or sharing one,\n * types nobody registered, pages outside tabs and steps, expressions that\n * do not parse or read fields that are not there, formulas that read\n * each other, and rules naming a validator nobody gave.\n */\nexport function checkDocument(\n  document: FormDocument,\n  options: CheckDocumentOptions = {},\n): DocumentProblem[] {\n  const problems: DocumentProblem[] = []\n  if (document.version !== 1)\n    problems.push({\n      code: 'version',\n      path: 'version',\n      text: String(document.version),\n      message: `Version ${String(document.version)} is not known`,\n    })\n  const types = resolveFields(options.fields)\n  const ids = new Set<string>()\n  const known = scopeNames(document.nodes)\n  /** Where each node is, by the node itself, so nodes that share an id each have their own. */\n  const paths = new Map<FormNode, string>()\n\n  /** `itemFields`: the names an item of the list around the nodes has; none outside lists. */\n  function visit(\n    nodes: readonly FormNode[],\n    parent: FormNode | undefined,\n    itemFields: readonly string[],\n    at: string,\n  ) {\n    for (const [index, node] of nodes.entries()) {\n      const path = `${at}[${index}]`\n      paths.set(node, path)\n      if (ids.has(node.id))\n        problems.push({\n          code: 'duplicate-id',\n          nodeId: node.id,\n          path,\n          text: node.id,\n          message: `The id \"${node.id}\" is used twice`,\n        })\n      ids.add(node.id)\n\n      const pageParent = !!parent && (isTabs(parent) || isSteps(parent))\n      if (isPage(node) && !pageParent)\n        problems.push({\n          code: 'misplaced-page',\n          nodeId: node.id,\n          path,\n          text: node.id,\n          message: 'A page belongs in tabs or steps',\n        })\n      if (pageParent && !isPage(node))\n        problems.push({\n          code: 'not-a-page',\n          nodeId: node.id,\n          path,\n          text: node.id,\n          message: 'Tabs and steps hold pages only',\n        })\n\n      if ((isTabs(node) || isSteps(node) || isList(node)) && !node.children?.length)\n        problems.push({\n          code: 'empty',\n          nodeId: node.id,\n          path,\n          text: node.id,\n          message: isList(node) ? 'The list has no fields' : `The ${node.type} have no pages`,\n        })\n      if (isList(node) && !node.name)\n        problems.push({\n          code: 'missing-name',\n          nodeId: node.id,\n          path,\n          text: node.id,\n          message: 'The list has no name',\n        })\n\n      if (isField(node)) {\n        const type = types.get(node.type)\n        if (!type)\n          problems.push({\n            code: 'unknown-type',\n            nodeId: node.id,\n            path,\n            text: node.type,\n            message: `There is no field type \"${node.type}\"`,\n          })\n        else if (type.kind !== 'display' && !node.name)\n          problems.push({\n            code: 'missing-name',\n            nodeId: node.id,\n            path,\n            text: node.id,\n            message: 'The field has no name',\n          })\n      }\n\n      const expressions: [string, string | undefined][] = EXPRESSIONS.map((key) => [\n        key,\n        (node as Partial<Record<(typeof EXPRESSIONS)[number], string>>)[key],\n      ])\n      if (isField(node) || isList(node))\n        (node.rules ?? []).forEach((rule, order) => {\n          expressions.push([`rules.${order}.check`, rule.check])\n          if (rule.validator === undefined) return\n          const rulePath = `${path}.rules[${order}]`\n          if (rule.check)\n            problems.push({\n              code: 'check-and-validator',\n              nodeId: node.id,\n              path: rulePath,\n              text: rule.validator,\n              message: 'A rule has both check and validator; only check runs',\n            })\n          else if (options.validators && !options.validators.includes(rule.validator))\n            problems.push({\n              code: 'unknown-validator',\n              nodeId: node.id,\n              path: `${rulePath}.validator`,\n              text: rule.validator,\n              message: `There is no validator \"${rule.validator}\"`,\n            })\n        })\n      if (isField(node) && node.source?.arg) expressions.push(['source.arg', node.source.arg])\n      for (const [property, source] of expressions) {\n        if (!source) continue\n        const found = checkExpression(source, {\n          fields: known,\n          itemFields,\n          functions: options.functions,\n        })\n        for (const problem of found)\n          problems.push({\n            code: 'expression',\n            nodeId: node.id,\n            path: `${path}.${property.replace(/\\.(\\d+)/g, '[$1]')}`,\n            property,\n            text: source,\n            expression: problem,\n            message: `${property}: ${problem.message}`,\n          })\n      }\n\n      if (isList(node))\n        visit(node.children ?? [], node, scopeNames(node.children ?? []), `${path}.children`)\n      else if (isContainer(node)) visit(node.children ?? [], node, itemFields, `${path}.children`)\n    }\n  }\n  visit(document.nodes, undefined, [], 'nodes')\n  duplicateNames(document.nodes, problems, paths)\n\n  for (const cycle of analyseFormulas(document, options.functions).cycles) {\n    const text = cycle.map(({ label }) => label)\n    const node = cycle[0]!.node\n    problems.push({\n      code: 'formula-cycle',\n      nodeId: node.id,\n      path: paths.get(node) ?? '',\n      text: text.join(' → '),\n      message: `The formulas read each other: ${text.join(' -> ')}`,\n    })\n  }\n  return problems\n}\n\nconst nameOf = (node: FormNode) => (isList(node) || isField(node) ? node.name : undefined)\n\n/** The names of one scope: the document's, or a list item's. Groups and pages share their parent's. */\nfunction scopeNames(nodes: readonly FormNode[]): string[] {\n  const result: string[] = []\n  for (const node of nodes) {\n    const name = nameOf(node)\n    if (name) result.push(name)\n    if (isContainer(node) && !isList(node)) result.push(...scopeNames(node.children ?? []))\n  }\n  return result\n}\n\n/** Names used twice within one scope. */\nfunction duplicateNames(\n  nodes: readonly FormNode[],\n  problems: DocumentProblem[],\n  paths: ReadonlyMap<FormNode, string>,\n) {\n  const scan = (list: readonly FormNode[], seen: Set<string>) => {\n    for (const node of list) {\n      const name = nameOf(node)\n      if (name) {\n        if (seen.has(name))\n          problems.push({\n            code: 'duplicate-name',\n            nodeId: node.id,\n            path: paths.get(node) ?? '',\n            text: name,\n            message: `The name \"${name}\" is used twice`,\n          })\n        seen.add(name)\n      }\n      if (isList(node)) scan(node.children ?? [], new Set())\n      else if (isContainer(node)) scan(node.children ?? [], seen)\n    }\n  }\n  scan(nodes, new Set())\n}\n\n/** Upgrades from an older version of the document, by the version they start from. */\nconst migrations: Record<number, (document: any) => any> = {}\n\n/**\n * The document in the current version (`1`). Documents of an older\n * version are upgraded step by step; there are none yet, so for now this\n * only checks the version. A document without a version is read as\n * version 1, as the renderer does. Throws for anything that is not a\n * document and for a version it does not know.\n */\nexport function migrateDocument(document: unknown): FormDocument {\n  if (document === null || typeof document !== 'object' || Array.isArray(document))\n    throw new Error('[@dou-ui/form-builder] a form document must be an object')\n  let current = document as { version?: unknown } & Record<string, unknown>\n  if (current.version === undefined) current = { ...current, version: 1 }\n  while (current.version !== 1) {\n    const step = typeof current.version === 'number' ? migrations[current.version] : undefined\n    if (!step)\n      throw new Error(\n        `[@dou-ui/form-builder] form document version ${String(current.version)} is not known`,\n      )\n    current = step(current)\n  }\n  return current as unknown as FormDocument\n}\n\n/** A part of some data that is not shaped like a form document. */\nexport interface DocumentShapeProblem {\n  /** Where, as a path into the data, e.g. `nodes[2].children[0].label`; `''` for the whole. */\n  path: string\n  /** `type`: the value is of another kind; `required`: it is missing. */\n  code: 'type' | 'required'\n  /** What the value should be. */\n  expected: 'object' | 'array' | 'string' | 'number' | 'boolean' | 'span' | 'mark'\n  /** An English description, for logs. */\n  message: string\n}\n\ntype Expected = DocumentShapeProblem['expected']\n\nconst NODE_KEYS: Record<string, Expected> = {\n  id: 'string',\n  type: 'string',\n  name: 'string',\n  label: 'string',\n  help: 'string',\n  title: 'string',\n  description: 'string',\n  addText: 'string',\n  visibleWhen: 'string',\n  disabledWhen: 'string',\n  requiredWhen: 'string',\n  formula: 'string',\n  required: 'boolean',\n  bordered: 'boolean',\n  sortable: 'boolean',\n  min: 'number',\n  max: 'number',\n  columns: 'number',\n  span: 'span',\n  props: 'object',\n  source: 'object',\n  rules: 'array',\n  children: 'array',\n}\n\nconst RULE_KEYS: Record<string, Expected> = {\n  required: 'boolean',\n  type: 'string',\n  min: 'number',\n  max: 'number',\n  pattern: 'string',\n  flags: 'string',\n  check: 'string',\n  validator: 'string',\n  message: 'string',\n  trigger: 'string',\n}\n\nconst DOCUMENT_KEYS: Record<string, Expected> = {\n  version: 'number',\n  layout: 'string',\n  labelAlign: 'string',\n  labelWidth: 'number',\n  size: 'string',\n  requiredMark: 'mark',\n  columns: 'number',\n  nodes: 'array',\n}\n\nconst CONTAINER_TYPES = new Set(['section', 'tabs', 'steps', 'page', 'list'])\nconst SHAPE_LIMIT = 50\n\nconst isObject = (value: unknown): value is Record<string, unknown> =>\n  value !== null && typeof value === 'object' && !Array.isArray(value)\n\nfunction fits(value: unknown, expected: Expected): boolean {\n  switch (expected) {\n    case 'object':\n      return isObject(value)\n    case 'array':\n      return Array.isArray(value)\n    case 'span':\n      return (\n        (typeof value === 'number' && Number.isFinite(value)) ||\n        (isObject(value) && Object.values(value).every((each) => typeof each === 'number'))\n      )\n    case 'mark':\n      return typeof value === 'boolean' || value === 'optional'\n    case 'number':\n      return typeof value === 'number' && Number.isFinite(value)\n    default:\n      return typeof value === expected\n  }\n}\n\n/**\n * Where some data, e.g. JSON pasted into an editor, is not shaped like a\n * form document: a key holding the wrong kind of value, or a node without\n * its `id`, `type` or `children`. Problems name the path to the value, so\n * they can be found in the text. Run `checkDocument` on the result for\n * the problems of a document that is shaped right.\n */\nexport function checkDocumentShape(data: unknown): DocumentShapeProblem[] {\n  const problems: DocumentShapeProblem[] = []\n  const add = (path: string, code: 'type' | 'required', expected: Expected) => {\n    if (problems.length >= SHAPE_LIMIT) return\n    problems.push({\n      path,\n      code,\n      expected,\n      message:\n        code === 'required'\n          ? `${path} is missing`\n          : `${path || 'The document'} should be ${expected === 'span' ? 'a number or an object of numbers' : expected === 'mark' ? 'a boolean or \"optional\"' : `a ${expected}`}`,\n    })\n  }\n  const keys = (value: Record<string, unknown>, spec: Record<string, Expected>, path: string) => {\n    for (const [key, expected] of Object.entries(spec))\n      if (value[key] !== undefined && !fits(value[key], expected))\n        add(`${path}.${key}`, 'type', expected)\n  }\n  const node = (value: unknown, path: string) => {\n    if (!isObject(value)) return add(path, 'type', 'object')\n    keys(value, NODE_KEYS, path)\n    for (const key of ['id', 'type'] as const)\n      if (value[key] === undefined) add(`${path}.${key}`, 'required', 'string')\n    if (Array.isArray(value.rules))\n      value.rules.forEach((rule, index) => {\n        const at = `${path}.rules[${index}]`\n        if (isObject(rule)) keys(rule, RULE_KEYS, at)\n        else add(at, 'type', 'object')\n      })\n    if (isObject(value.source) && typeof value.source.name !== 'string')\n      add(`${path}.source.name`, value.source.name === undefined ? 'required' : 'type', 'string')\n    const container = typeof value.type === 'string' && CONTAINER_TYPES.has(value.type)\n    if (container && value.children === undefined) add(`${path}.children`, 'required', 'array')\n    if (Array.isArray(value.children))\n      value.children.forEach((child, index) => node(child, `${path}.children[${index}]`))\n  }\n  if (!isObject(data)) {\n    add('', 'type', 'object')\n    return problems\n  }\n  for (const [key, expected] of Object.entries(DOCUMENT_KEYS))\n    if (data[key] !== undefined && !fits(data[key], expected)) add(key, 'type', expected)\n  if (data.nodes === undefined) add('nodes', 'required', 'array')\n  if (Array.isArray(data.nodes)) data.nodes.forEach((each, index) => node(each, `nodes[${index}]`))\n  return problems\n}\n"],"mappings":";;;;;AAoDA,IAAM,cAAc;CAAC;CAAe;CAAgB;CAAgB;AAAS;;;;;;;;AAS7E,SAAgB,cACd,UACA,UAAgC,CAAC,GACd;CACnB,MAAM,WAA8B,CAAC;CACrC,IAAI,SAAS,YAAY,GACvB,SAAS,KAAK;EACZ,MAAM;EACN,MAAM;EACN,MAAM,OAAO,SAAS,OAAO;EAC7B,SAAS,WAAW,OAAO,SAAS,OAAO,EAAE;CAC/C,CAAC;CACH,MAAM,QAAQ,cAAc,QAAQ,MAAM;CAC1C,MAAM,sBAAM,IAAI,IAAY;CAC5B,MAAM,QAAQ,WAAW,SAAS,KAAK;;CAEvC,MAAM,wBAAQ,IAAI,IAAsB;;CAGxC,SAAS,MACP,OACA,QACA,YACA,IACA;EACA,KAAK,MAAM,CAAC,OAAO,SAAS,MAAM,QAAQ,GAAG;GAC3C,MAAM,OAAO,GAAG,GAAG,GAAG,MAAM;GAC5B,MAAM,IAAI,MAAM,IAAI;GACpB,IAAI,IAAI,IAAI,KAAK,EAAE,GACjB,SAAS,KAAK;IACZ,MAAM;IACN,QAAQ,KAAK;IACb;IACA,MAAM,KAAK;IACX,SAAS,WAAW,KAAK,GAAG;GAC9B,CAAC;GACH,IAAI,IAAI,KAAK,EAAE;GAEf,MAAM,aAAa,CAAC,CAAC,WAAW,OAAO,MAAM,KAAK,QAAQ,MAAM;GAChE,IAAI,OAAO,IAAI,KAAK,CAAC,YACnB,SAAS,KAAK;IACZ,MAAM;IACN,QAAQ,KAAK;IACb;IACA,MAAM,KAAK;IACX,SAAS;GACX,CAAC;GACH,IAAI,cAAc,CAAC,OAAO,IAAI,GAC5B,SAAS,KAAK;IACZ,MAAM;IACN,QAAQ,KAAK;IACb;IACA,MAAM,KAAK;IACX,SAAS;GACX,CAAC;GAEH,KAAK,OAAO,IAAI,KAAK,QAAQ,IAAI,KAAK,OAAO,IAAI,MAAM,CAAC,KAAK,UAAU,QACrE,SAAS,KAAK;IACZ,MAAM;IACN,QAAQ,KAAK;IACb;IACA,MAAM,KAAK;IACX,SAAS,OAAO,IAAI,IAAI,2BAA2B,OAAO,KAAK,KAAK;GACtE,CAAC;GACH,IAAI,OAAO,IAAI,KAAK,CAAC,KAAK,MACxB,SAAS,KAAK;IACZ,MAAM;IACN,QAAQ,KAAK;IACb;IACA,MAAM,KAAK;IACX,SAAS;GACX,CAAC;GAEH,IAAI,QAAQ,IAAI,GAAG;IACjB,MAAM,OAAO,MAAM,IAAI,KAAK,IAAI;IAChC,IAAI,CAAC,MACH,SAAS,KAAK;KACZ,MAAM;KACN,QAAQ,KAAK;KACb;KACA,MAAM,KAAK;KACX,SAAS,2BAA2B,KAAK,KAAK;IAChD,CAAC;SACE,IAAI,KAAK,SAAS,aAAa,CAAC,KAAK,MACxC,SAAS,KAAK;KACZ,MAAM;KACN,QAAQ,KAAK;KACb;KACA,MAAM,KAAK;KACX,SAAS;IACX,CAAC;GACL;GAEA,MAAM,cAA8C,YAAY,KAAK,QAAQ,CAC3E,KACC,KAA+D,IAClE,CAAC;GACD,IAAI,QAAQ,IAAI,KAAK,OAAO,IAAI,GAC9B,CAAC,KAAK,SAAS,CAAC,EAAA,CAAG,SAAS,MAAM,UAAU;IAC1C,YAAY,KAAK,CAAC,SAAS,MAAM,SAAS,KAAK,KAAK,CAAC;IACrD,IAAI,KAAK,cAAc,KAAA,GAAW;IAClC,MAAM,WAAW,GAAG,KAAK,SAAS,MAAM;IACxC,IAAI,KAAK,OACP,SAAS,KAAK;KACZ,MAAM;KACN,QAAQ,KAAK;KACb,MAAM;KACN,MAAM,KAAK;KACX,SAAS;IACX,CAAC;SACE,IAAI,QAAQ,cAAc,CAAC,QAAQ,WAAW,SAAS,KAAK,SAAS,GACxE,SAAS,KAAK;KACZ,MAAM;KACN,QAAQ,KAAK;KACb,MAAM,GAAG,SAAS;KAClB,MAAM,KAAK;KACX,SAAS,0BAA0B,KAAK,UAAU;IACpD,CAAC;GACL,CAAC;GACH,IAAI,QAAQ,IAAI,KAAK,KAAK,QAAQ,KAAK,YAAY,KAAK,CAAC,cAAc,KAAK,OAAO,GAAG,CAAC;GACvF,KAAK,MAAM,CAAC,UAAU,WAAW,aAAa;IAC5C,IAAI,CAAC,QAAQ;IACb,MAAM,QAAQ,gBAAgB,QAAQ;KACpC,QAAQ;KACR;KACA,WAAW,QAAQ;IACrB,CAAC;IACD,KAAK,MAAM,WAAW,OACpB,SAAS,KAAK;KACZ,MAAM;KACN,QAAQ,KAAK;KACb,MAAM,GAAG,KAAK,GAAG,SAAS,QAAQ,YAAY,MAAM;KACpD;KACA,MAAM;KACN,YAAY;KACZ,SAAS,GAAG,SAAS,IAAI,QAAQ;IACnC,CAAC;GACL;GAEA,IAAI,OAAO,IAAI,GACb,MAAM,KAAK,YAAY,CAAC,GAAG,MAAM,WAAW,KAAK,YAAY,CAAC,CAAC,GAAG,GAAG,KAAK,UAAU;QACjF,IAAI,YAAY,IAAI,GAAG,MAAM,KAAK,YAAY,CAAC,GAAG,MAAM,YAAY,GAAG,KAAK,UAAU;EAC7F;CACF;CACA,MAAM,SAAS,OAAO,KAAA,GAAW,CAAC,GAAG,OAAO;CAC5C,eAAe,SAAS,OAAO,UAAU,KAAK;CAE9C,KAAK,MAAM,SAAS,gBAAgB,UAAU,QAAQ,SAAS,CAAC,CAAC,QAAQ;EACvE,MAAM,OAAO,MAAM,KAAK,EAAE,YAAY,KAAK;EAC3C,MAAM,OAAO,MAAM,EAAE,CAAE;EACvB,SAAS,KAAK;GACZ,MAAM;GACN,QAAQ,KAAK;GACb,MAAM,MAAM,IAAI,IAAI,KAAK;GACzB,MAAM,KAAK,KAAK,KAAK;GACrB,SAAS,iCAAiC,KAAK,KAAK,MAAM;EAC5D,CAAC;CACH;CACA,OAAO;AACT;AAEA,IAAM,UAAU,SAAoB,OAAO,IAAI,KAAK,QAAQ,IAAI,IAAI,KAAK,OAAO,KAAA;;AAGhF,SAAS,WAAW,OAAsC;CACxD,MAAM,SAAmB,CAAC;CAC1B,KAAK,MAAM,QAAQ,OAAO;EACxB,MAAM,OAAO,OAAO,IAAI;EACxB,IAAI,MAAM,OAAO,KAAK,IAAI;EAC1B,IAAI,YAAY,IAAI,KAAK,CAAC,OAAO,IAAI,GAAG,OAAO,KAAK,GAAG,WAAW,KAAK,YAAY,CAAC,CAAC,CAAC;CACxF;CACA,OAAO;AACT;;AAGA,SAAS,eACP,OACA,UACA,OACA;CACA,MAAM,QAAQ,MAA2B,SAAsB;EAC7D,KAAK,MAAM,QAAQ,MAAM;GACvB,MAAM,OAAO,OAAO,IAAI;GACxB,IAAI,MAAM;IACR,IAAI,KAAK,IAAI,IAAI,GACf,SAAS,KAAK;KACZ,MAAM;KACN,QAAQ,KAAK;KACb,MAAM,MAAM,IAAI,IAAI,KAAK;KACzB,MAAM;KACN,SAAS,aAAa,KAAK;IAC7B,CAAC;IACH,KAAK,IAAI,IAAI;GACf;GACA,IAAI,OAAO,IAAI,GAAG,KAAK,KAAK,YAAY,CAAC,mBAAG,IAAI,IAAI,CAAC;QAChD,IAAI,YAAY,IAAI,GAAG,KAAK,KAAK,YAAY,CAAC,GAAG,IAAI;EAC5D;CACF;CACA,KAAK,uBAAO,IAAI,IAAI,CAAC;AACvB;;AAGA,IAAM,aAAqD,CAAC;;;;;;;;AAS5D,SAAgB,gBAAgB,UAAiC;CAC/D,IAAI,aAAa,QAAQ,OAAO,aAAa,YAAY,MAAM,QAAQ,QAAQ,GAC7E,MAAM,IAAI,MAAM,0DAA0D;CAC5E,IAAI,UAAU;CACd,IAAI,QAAQ,YAAY,KAAA,GAAW,UAAU;EAAE,GAAG;EAAS,SAAS;CAAE;CACtE,OAAO,QAAQ,YAAY,GAAG;EAC5B,MAAM,OAAO,OAAO,QAAQ,YAAY,WAAW,WAAW,QAAQ,WAAW,KAAA;EACjF,IAAI,CAAC,MACH,MAAM,IAAI,MACR,gDAAgD,OAAO,QAAQ,OAAO,EAAE,cAC1E;EACF,UAAU,KAAK,OAAO;CACxB;CACA,OAAO;AACT;AAgBA,IAAM,YAAsC;CAC1C,IAAI;CACJ,MAAM;CACN,MAAM;CACN,OAAO;CACP,MAAM;CACN,OAAO;CACP,aAAa;CACb,SAAS;CACT,aAAa;CACb,cAAc;CACd,cAAc;CACd,SAAS;CACT,UAAU;CACV,UAAU;CACV,UAAU;CACV,KAAK;CACL,KAAK;CACL,SAAS;CACT,MAAM;CACN,OAAO;CACP,QAAQ;CACR,OAAO;CACP,UAAU;AACZ;AAEA,IAAM,YAAsC;CAC1C,UAAU;CACV,MAAM;CACN,KAAK;CACL,KAAK;CACL,SAAS;CACT,OAAO;CACP,OAAO;CACP,WAAW;CACX,SAAS;CACT,SAAS;AACX;AAEA,IAAM,gBAA0C;CAC9C,SAAS;CACT,QAAQ;CACR,YAAY;CACZ,YAAY;CACZ,MAAM;CACN,cAAc;CACd,SAAS;CACT,OAAO;AACT;AAEA,IAAM,kCAAkB,IAAI,IAAI;CAAC;CAAW;CAAQ;CAAS;CAAQ;AAAM,CAAC;AAC5E,IAAM,cAAc;AAEpB,IAAM,YAAY,UAChB,UAAU,QAAQ,OAAO,UAAU,YAAY,CAAC,MAAM,QAAQ,KAAK;AAErE,SAAS,KAAK,OAAgB,UAA6B;CACzD,QAAQ,UAAR;EACE,KAAK,UACH,OAAO,SAAS,KAAK;EACvB,KAAK,SACH,OAAO,MAAM,QAAQ,KAAK;EAC5B,KAAK,QACH,OACG,OAAO,UAAU,YAAY,OAAO,SAAS,KAAK,KAClD,SAAS,KAAK,KAAK,OAAO,OAAO,KAAK,CAAC,CAAC,OAAO,SAAS,OAAO,SAAS,QAAQ;EAErF,KAAK,QACH,OAAO,OAAO,UAAU,aAAa,UAAU;EACjD,KAAK,UACH,OAAO,OAAO,UAAU,YAAY,OAAO,SAAS,KAAK;EAC3D,SACE,OAAO,OAAO,UAAU;CAC5B;AACF;;;;;;;;AASA,SAAgB,mBAAmB,MAAuC;CACxE,MAAM,WAAmC,CAAC;CAC1C,MAAM,OAAO,MAAc,MAA2B,aAAuB;EAC3E,IAAI,SAAS,UAAU,aAAa;EACpC,SAAS,KAAK;GACZ;GACA;GACA;GACA,SACE,SAAS,aACL,GAAG,KAAK,eACR,GAAG,QAAQ,eAAe,aAAa,aAAa,SAAS,qCAAqC,aAAa,SAAS,8BAA4B,KAAK;EACjK,CAAC;CACH;CACA,MAAM,QAAQ,OAAgC,MAAgC,SAAiB;EAC7F,KAAK,MAAM,CAAC,KAAK,aAAa,OAAO,QAAQ,IAAI,GAC/C,IAAI,MAAM,SAAS,KAAA,KAAa,CAAC,KAAK,MAAM,MAAM,QAAQ,GACxD,IAAI,GAAG,KAAK,GAAG,OAAO,QAAQ,QAAQ;CAC5C;CACA,MAAM,QAAQ,OAAgB,SAAiB;EAC7C,IAAI,CAAC,SAAS,KAAK,GAAG,OAAO,IAAI,MAAM,QAAQ,QAAQ;EACvD,KAAK,OAAO,WAAW,IAAI;EAC3B,KAAK,MAAM,OAAO,CAAC,MAAM,MAAM,GAC7B,IAAI,MAAM,SAAS,KAAA,GAAW,IAAI,GAAG,KAAK,GAAG,OAAO,YAAY,QAAQ;EAC1E,IAAI,MAAM,QAAQ,MAAM,KAAK,GAC3B,MAAM,MAAM,SAAS,MAAM,UAAU;GACnC,MAAM,KAAK,GAAG,KAAK,SAAS,MAAM;GAClC,IAAI,SAAS,IAAI,GAAG,KAAK,MAAM,WAAW,EAAE;QACvC,IAAI,IAAI,QAAQ,QAAQ;EAC/B,CAAC;EACH,IAAI,SAAS,MAAM,MAAM,KAAK,OAAO,MAAM,OAAO,SAAS,UACzD,IAAI,GAAG,KAAK,eAAe,MAAM,OAAO,SAAS,KAAA,IAAY,aAAa,QAAQ,QAAQ;EAE5F,IADkB,OAAO,MAAM,SAAS,YAAY,gBAAgB,IAAI,MAAM,IAAI,KACjE,MAAM,aAAa,KAAA,GAAW,IAAI,GAAG,KAAK,YAAY,YAAY,OAAO;EAC1F,IAAI,MAAM,QAAQ,MAAM,QAAQ,GAC9B,MAAM,SAAS,SAAS,OAAO,UAAU,KAAK,OAAO,GAAG,KAAK,YAAY,MAAM,EAAE,CAAC;CACtF;CACA,IAAI,CAAC,SAAS,IAAI,GAAG;EACnB,IAAI,IAAI,QAAQ,QAAQ;EACxB,OAAO;CACT;CACA,KAAK,MAAM,CAAC,KAAK,aAAa,OAAO,QAAQ,aAAa,GACxD,IAAI,KAAK,SAAS,KAAA,KAAa,CAAC,KAAK,KAAK,MAAM,QAAQ,GAAG,IAAI,KAAK,QAAQ,QAAQ;CACtF,IAAI,KAAK,UAAU,KAAA,GAAW,IAAI,SAAS,YAAY,OAAO;CAC9D,IAAI,MAAM,QAAQ,KAAK,KAAK,GAAG,KAAK,MAAM,SAAS,MAAM,UAAU,KAAK,MAAM,SAAS,MAAM,EAAE,CAAC;CAChG,OAAO;AACT"}

package/dist/core/document.js

@@ -0,0 +1,112 @@
+// src/core/document.ts
+/** A document with nothing in it. */
+function emptyDocument() {
+	return {
+		version: 1,
+		nodes: []
+	};
+}
+var warnedVersion = false;
+/** Warn once, for the whole page, about a document of a version this package does not know. */
+function checkVersion(document) {
+	if (document.version === 1 || warnedVersion) return;
+	warnedVersion = true;
+	console.warn(`[@dou-ui/form-builder] form document version ${String(document.version)} is not supported; it is read as version 1`);
+}
+var counter = 0;
+/** A short id that is unique enough within one document, e.g. `f-lz3k9a-1`. */
+function createId(prefix = "f") {
+	counter = (counter + 1) % 1679616;
+	return `${prefix}-${Date.now().toString(36)}-${counter.toString(36)}`;
+}
+var CONTAINERS = /* @__PURE__ */ new Set([
+	"section",
+	"tabs",
+	"steps",
+	"page",
+	"list"
+]);
+var isSection = (node) => node.type === "section";
+var isTabs = (node) => node.type === "tabs";
+var isSteps = (node) => node.type === "steps";
+var isPage = (node) => node.type === "page";
+var isList = (node) => node.type === "list";
+/** Whether a node holds other nodes: a section, tabs, steps, a page or a list. */
+var isContainer = (node) => CONTAINERS.has(node.type);
+/** Whether a node is a field, of a built-in or a registered type. */
+var isField = (node) => !CONTAINERS.has(node.type);
+/** Every node in document order, containers before their children, the fields of list items included. */
+function* walkNodes(nodes) {
+	for (const node of nodes) {
+		yield node;
+		if (isContainer(node)) yield* walkNodes(node.children);
+	}
+}
+/**
+* The nodes that write a value of their own, in document order: fields
+* with a `name` and lists. Fields inside a list belong to its items, so
+* they are not among them.
+*/
+function valueNodes(nodes) {
+	const result = [];
+	const visit = (list) => {
+		for (const node of list) if (isList(node)) result.push(node);
+		else if (isContainer(node)) visit(node.children);
+		else if (node.name) result.push(node);
+	};
+	visit(nodes);
+	return result;
+}
+/** The fields that write a value, in document order, outside lists. */
+function fieldNodes(document) {
+	return valueNodes(document.nodes).filter(isField);
+}
+/** The node with this id, anywhere in the document. */
+function findNode(document, id) {
+	for (const node of walkNodes(document.nodes)) if (node.id === id) return node;
+}
+var keysOf = (path) => path.split(".");
+/** The value at a dotted path, or `undefined` when part of it is missing. */
+function getPath(model, path) {
+	let value = model;
+	for (const key of keysOf(path)) {
+		if (value === null || typeof value !== "object") return void 0;
+		value = value[key];
+	}
+	return value;
+}
+/** Write a value at a dotted path, creating the objects on the way. */
+function setPath(model, path, value) {
+	const keys = keysOf(path);
+	const last = keys.pop();
+	let target = model;
+	for (const key of keys) {
+		let next = target[key];
+		if (next === null || typeof next !== "object") next = target[key] = {};
+		target = next;
+	}
+	target[last] = value;
+}
+/** Remove the value at a dotted path, if it is there. */
+function unsetPath(model, path) {
+	const keys = keysOf(path);
+	const last = keys.pop();
+	let target = model;
+	for (const key of keys) {
+		if (target === null || typeof target !== "object") return;
+		target = target[key];
+	}
+	if (target !== null && typeof target === "object") delete target[last];
+}
+/** A deep copy of plain data, so a default is never shared between forms. */
+function cloneValue(value) {
+	if (value === null || typeof value !== "object") return value;
+	if (Array.isArray(value)) return value.map(cloneValue);
+	if (value instanceof Date) return new Date(value);
+	const result = {};
+	for (const [key, item] of Object.entries(value)) result[key] = cloneValue(item);
+	return result;
+}
+export { checkVersion, cloneValue, createId, emptyDocument, fieldNodes, findNode, getPath, isContainer, isField, isList, isPage, isSection, isSteps, isTabs, setPath, unsetPath, valueNodes, walkNodes };
+
+//# sourceMappingURL=document.js.map

package/dist/core/document.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"document.js","names":[],"sources":["../../src/core/document.ts"],"sourcesContent":["import type {\n  FormContainerNode,\n  FormDocument,\n  FormFieldNode,\n  FormListNode,\n  FormNode,\n  FormPageNode,\n  FormSectionNode,\n  FormStepsNode,\n  FormTabsNode,\n} from './types'\n\n/** A document with nothing in it. */\nexport function emptyDocument(): FormDocument {\n  return { version: 1, nodes: [] }\n}\n\nlet warnedVersion = false\n\n/** Warn once, for the whole page, about a document of a version this package does not know. */\nexport function checkVersion(document: FormDocument) {\n  if (document.version === 1 || warnedVersion) return\n  warnedVersion = true\n  console.warn(\n    `[@dou-ui/form-builder] form document version ${String(document.version)} is not supported; it is read as version 1`,\n  )\n}\n\nlet counter = 0\n\n/** A short id that is unique enough within one document, e.g. `f-lz3k9a-1`. */\nexport function createId(prefix = 'f'): string {\n  counter = (counter + 1) % 1679616\n  return `${prefix}-${Date.now().toString(36)}-${counter.toString(36)}`\n}\n\nconst CONTAINERS = new Set(['section', 'tabs', 'steps', 'page', 'list'])\n\nexport const isSection = (node: FormNode): node is FormSectionNode => node.type === 'section'\nexport const isTabs = (node: FormNode): node is FormTabsNode => node.type === 'tabs'\nexport const isSteps = (node: FormNode): node is FormStepsNode => node.type === 'steps'\nexport const isPage = (node: FormNode): node is FormPageNode => node.type === 'page'\nexport const isList = (node: FormNode): node is FormListNode => node.type === 'list'\n/** Whether a node holds other nodes: a section, tabs, steps, a page or a list. */\nexport const isContainer = (node: FormNode): node is FormContainerNode => CONTAINERS.has(node.type)\n/** Whether a node is a field, of a built-in or a registered type. */\nexport const isField = (node: FormNode): node is FormFieldNode => !CONTAINERS.has(node.type)\n\n/** Every node in document order, containers before their children, the fields of list items included. */\nexport function* walkNodes(nodes: readonly FormNode[]): Generator<FormNode> {\n  for (const node of nodes) {\n    yield node\n    if (isContainer(node)) yield* walkNodes(node.children)\n  }\n}\n\n/**\n * The nodes that write a value of their own, in document order: fields\n * with a `name` and lists. Fields inside a list belong to its items, so\n * they are not among them.\n */\nexport function valueNodes(nodes: readonly FormNode[]): (FormFieldNode | FormListNode)[] {\n  const result: (FormFieldNode | FormListNode)[] = []\n  const visit = (list: readonly FormNode[]) => {\n    for (const node of list) {\n      if (isList(node)) result.push(node)\n      else if (isContainer(node)) visit(node.children)\n      else if (node.name) result.push(node)\n    }\n  }\n  visit(nodes)\n  return result\n}\n\n/** The fields that write a value, in document order, outside lists. */\nexport function fieldNodes(document: FormDocument): FormFieldNode[] {\n  return valueNodes(document.nodes).filter(isField)\n}\n\n/** The node with this id, anywhere in the document. */\nexport function findNode(document: FormDocument, id: string): FormNode | undefined {\n  for (const node of walkNodes(document.nodes)) if (node.id === id) return node\n  return undefined\n}\n\nconst keysOf = (path: string) => path.split('.')\n\n/** The value at a dotted path, or `undefined` when part of it is missing. */\nexport function getPath(model: unknown, path: string): unknown {\n  let value = model\n  for (const key of keysOf(path)) {\n    if (value === null || typeof value !== 'object') return undefined\n    value = (value as Record<string, unknown>)[key]\n  }\n  return value\n}\n\n/** Write a value at a dotted path, creating the objects on the way. */\nexport function setPath(model: Record<string, unknown>, path: string, value: unknown) {\n  const keys = keysOf(path)\n  const last = keys.pop()!\n  let target = model\n  for (const key of keys) {\n    let next = target[key]\n    if (next === null || typeof next !== 'object') next = target[key] = {}\n    target = next as Record<string, unknown>\n  }\n  target[last] = value\n}\n\n/** Remove the value at a dotted path, if it is there. */\nexport function unsetPath(model: Record<string, unknown>, path: string) {\n  const keys = keysOf(path)\n  const last = keys.pop()!\n  let target: unknown = model\n  for (const key of keys) {\n    if (target === null || typeof target !== 'object') return\n    target = (target as Record<string, unknown>)[key]\n  }\n  if (target !== null && typeof target === 'object')\n    delete (target as Record<string, unknown>)[last]\n}\n\n/** A deep copy of plain data, so a default is never shared between forms. */\nexport function cloneValue<T>(value: T): T {\n  if (value === null || typeof value !== 'object') return value\n  if (Array.isArray(value)) return value.map(cloneValue) as T\n  if (value instanceof Date) return new Date(value) as T\n  const result: Record<string, unknown> = {}\n  for (const [key, item] of Object.entries(value)) result[key] = cloneValue(item)\n  return result as T\n}\n"],"mappings":"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"}