@stonecrop/schema 0.18.0 → 0.19.0

package/dist/{validation-C25HJXWs.js → validation-1DGAGmuU.js}

@@ -1,34 +1,34 @@
-import { isScalarType as P, isEnumType as K, isObjectType as k, isNonNullType as v, isListType as V, isNamedType as z, buildSchema as B, buildClientSchema as W } from "graphql";
+import { isScalarType as K, isEnumType as V, isObjectType as k, isNonNullType as v, isListType as z, isNamedType as B, buildSchema as W, buildClientSchema as J } from "graphql";
 import { z as e } from "zod";
-function je(t) {
+function Ne(t) {
   return t.replace(/_([a-z])/g, (n, i) => i.toUpperCase());
 }
-function Oe(t) {
+function $e(t) {
   return t.replace(/[A-Z]/g, (n) => `_${n.toLowerCase()}`);
 }
-function Ce(t) {
+function ve(t) {
   return t.split("_").map((n) => n.charAt(0).toUpperCase() + n.slice(1).toLowerCase()).join(" ");
 }
 function G(t) {
   const n = t.replace(/([A-Z])/g, " $1").trim();
   return n.charAt(0).toUpperCase() + n.slice(1);
 }
-function J(t) {
+function Q(t) {
   return t.split(/[-_\s]+/).map((n) => n.charAt(0).toUpperCase() + n.slice(1).toLowerCase()).join("");
 }
 function T(t) {
   return t.replace(/([a-z])([A-Z])/g, "$1-$2").replace(/[\s_]+/g, "-").toLowerCase();
 }
-function Ne(t) {
+function Me(t) {
   return t.replace(/([a-z])([A-Z])/g, "$1_$2").replace(/[\s-]+/g, "_").toLowerCase();
 }
-const Q = {
+const H = {
   String: { component: "ATextInput" },
   Int: { component: "ANumericInput" },
   Float: { component: "ANumericInput" },
   Boolean: { component: "ACheckbox" },
   ID: { component: "ATextInput" }
-}, Z = {
+}, Y = {
   // Arbitrary precision / large numbers — all numeric variants render with ANumericInput.
   BigFloat: { component: "ANumericInput" },
   BigDecimal: { component: "ANumericInput" },
@@ -48,17 +48,17 @@ const Q = {
   JSON: { component: "ACodeEditor" },
   JSONObject: { component: "ACodeEditor" },
   JsonNode: { component: "ACodeEditor" }
-}, H = /* @__PURE__ */ new Set(["Cursor"]);
-function Y(t) {
-  const n = { ...Z };
-  for (const [i, o] of Object.entries(Q))
+}, Z = /* @__PURE__ */ new Set(["Cursor"]);
+function X(t) {
+  const n = { ...Y };
+  for (const [i, o] of Object.entries(H))
     n[i] = o;
   if (t)
     for (const [i, o] of Object.entries(t))
       n[i] = { component: o.component ?? "ATextInput" };
   return n;
 }
-const X = [
+const ee = [
   "Connection",
   "Edge",
   "Input",
@@ -74,66 +74,66 @@ const X = [
   "InsertResponse",
   "UpdateResponse",
   "MutationResponse"
-], ee = /* @__PURE__ */ new Set(["Query", "Mutation", "Subscription"]);
-function te(t, n) {
-  if (t.startsWith("__") || ee.has(t) || t === "Node")
+], te = /* @__PURE__ */ new Set(["Query", "Mutation", "Subscription"]);
+function ne(t, n) {
+  if (t.startsWith("__") || te.has(t) || t === "Node")
     return !1;
-  for (const o of X)
+  for (const o of ee)
     if (t.endsWith(o))
       return !1;
   const i = n.getFields();
   return Object.keys(i).length !== 0;
 }
-const ne = /* @__PURE__ */ new Set(["nodeId", "__typename", "clientMutationId"]);
-function ie(t, n, i) {
-  return !ne.has(t);
+const ie = /* @__PURE__ */ new Set(["nodeId", "__typename", "clientMutationId"]);
+function oe(t, n, i) {
+  return !ie.has(t);
 }
 function _(t) {
   let n = !1, i = !1, o = t;
-  if (v(o) && (n = !0, o = o.ofType), V(o) && (i = !0, o = o.ofType, v(o) && (o = o.ofType)), !z(o))
+  if (v(o) && (n = !0, o = o.ofType), z(o) && (i = !0, o = o.ofType, v(o) && (o = o.ofType)), !B(o))
     throw new Error(`Expected a named GraphQL type, got: ${String(o)}`);
   return { namedType: o, required: n, isList: i };
 }
-function oe(t) {
+function ae(t) {
   const i = t.getFields().edges;
   if (!i) return;
-  const { namedType: o, isList: r } = _(i.type);
-  if (!r || !k(o)) return;
+  const { namedType: o, isList: a } = _(i.type);
+  if (!a || !k(o)) return;
   const f = o.getFields().node;
   if (!f) return;
   const { namedType: g } = _(f.type);
   if (k(g))
     return g.name;
 }
-function ae(t, n, i, o = {}) {
-  const { namedType: r, required: p, isList: f } = _(n.type), g = Y(o.customScalars), a = {
+function re(t, n, i, o = {}) {
+  const { namedType: a, required: p, isList: f } = _(n.type), g = X(o.customScalars), r = {
     kind: "field",
     fieldname: t,
     label: G(t),
     component: "ATextInput"
   };
-  if (p && (a.required = !0), P(r)) {
-    if (H.has(r.name))
-      return a._unmapped = !0, o.includeUnmappedMeta && (a._graphqlType = r.name), a;
-    if (r.name === "ID") {
-      const u = J(t);
+  if (p && (r.required = !0), K(a)) {
+    if (Z.has(a.name))
+      return r._unmapped = !0, o.includeUnmappedMeta && (r._graphqlType = a.name), r;
+    if (a.name === "ID") {
+      const u = Q(t);
       if (i.has(u))
-        return a.component = "AFormLink", a.doctype = T(u), a;
+        return r.component = "AFormLink", r.doctype = T(u), r;
     }
-    const l = g[r.name];
-    return l ? a.component = l.component : (a._unmapped = !0, o.includeUnmappedMeta && (a._graphqlType = r.name)), a;
+    const c = g[a.name];
+    return c ? r.component = c.component : (r._unmapped = !0, o.includeUnmappedMeta && (r._graphqlType = a.name)), r;
   }
-  if (K(r))
-    return a.component = "ADropdown", a.options = r.getValues().map((l) => l.name), a;
-  if (k(r)) {
-    if (!f && i.has(r.name))
-      return a.component = "AFormLink", a.doctype = T(r.name), a;
-    const l = oe(r);
-    return l && i.has(l) ? (a.component = "ATable", a._isLink = !0, a.doctype = T(l), a.cardinality = "noneOrMany", a) : f && i.has(r.name) ? (a.component = "ATable", a._isLink = !0, a.doctype = T(r.name), a.cardinality = "noneOrMany", a) : (a._unmapped = !0, o.includeUnmappedMeta && (a._graphqlType = r.name), a);
+  if (V(a))
+    return r.component = "ADropdown", r.options = a.getValues().map((c) => c.name), r;
+  if (k(a)) {
+    if (!f && i.has(a.name))
+      return r.component = "AFormLink", r.doctype = T(a.name), r;
+    const c = ae(a);
+    return c && i.has(c) ? (r.component = "ATable", r._isLink = !0, r.doctype = T(c), r.cardinality = "noneOrMany", r) : f && i.has(a.name) ? (r.component = "ATable", r._isLink = !0, r.doctype = T(a.name), r.cardinality = "noneOrMany", r) : (r._unmapped = !0, o.includeUnmappedMeta && (r._graphqlType = a.name), r);
   }
-  return a._unmapped = !0, o.includeUnmappedMeta && (a._graphqlType = r.name), a;
+  return r._unmapped = !0, o.includeUnmappedMeta && (r._graphqlType = a.name), r;
 }
-const re = e.object({
+const se = e.object({
   /** The table view type */
   view: e.enum(["list", "uncounted", "list-expansion", "tree", "gantt", "tree-gantt"]).optional(),
   /** Allow the table to use the full width of its container */
@@ -145,7 +145,7 @@ const re = e.object({
 }).meta({
   title: "TableViewConfig",
   description: "JSON-safe view configuration for table fields in doctype authoring"
-}), se = e.union([
+}), le = e.union([
   e.array(e.string()),
   // Select choices: ["A", "B", "C"]
   e.record(e.string(), e.unknown())
@@ -160,18 +160,18 @@ const re = e.object({
   title: "FieldValidation",
   description: "Validation configuration for form fields"
 });
-function $(t) {
+function M(t) {
   if (typeof t != "object" || t === null || Array.isArray(t)) return t;
   const n = t;
   return "kind" in n ? t : "schema" in n ? { kind: "fieldset", ...n } : "columns" in n ? { kind: "table", ...n } : { kind: "field", ...n };
 }
-function le(t) {
-  const n = $(t);
+function de(t) {
+  const n = M(t);
   if (typeof n != "object" || n === null) return n;
   const i = n;
-  return i.kind === "fieldset" && Array.isArray(i.schema) ? { ...i, schema: i.schema.map(le) } : n;
+  return i.kind === "fieldset" && Array.isArray(i.schema) ? { ...i, schema: i.schema.map(de) } : n;
 }
-const de = [
+const pe = [
   "fieldname",
   "primaryKey",
   "required",
@@ -179,20 +179,32 @@ const de = [
   "cardinality",
   "doctype"
 ];
-function M(t) {
+function q(t) {
   return t.find((n) => n.kind === "field" && !!n.primaryKey);
 }
-function ve(t) {
-  return M(t)?.fieldname ?? "id";
+function O(t) {
+  const n = [];
+  for (const i of t)
+    i.kind === "fieldset" ? n.push(...O(i.schema)) : n.push(i);
+  return n;
+}
+function me(t, n) {
+  if (n)
+    return O(t).find(
+      (i) => i.kind === "field" && !i.computed && i.fieldname === n
+    );
 }
-function $e(t, n) {
-  const i = M(t), o = i ? [n[i.fieldname], n.id] : [n.id];
-  for (const r of o) {
-    if (typeof r == "number") return String(r);
-    if (typeof r == "string" && r !== "") return r;
+function qe(t) {
+  return q(t)?.fieldname ?? "id";
+}
+function Ee(t, n) {
+  const i = q(t), o = i ? [n[i.fieldname], n.id] : [n.id];
+  for (const a of o) {
+    if (typeof a == "number") return String(a);
+    if (typeof a == "string" && a !== "") return a;
   }
 }
-function pe() {
+function ue() {
   const t = e.object({
     kind: e.literal("field"),
     fieldname: e.string().min(1),
@@ -208,7 +220,7 @@ function pe() {
     mask: e.string().optional(),
     format: e.string().optional(),
     mode: e.enum(["edit", "read", "display"]).optional(),
-    options: se.optional(),
+    options: le.optional(),
     required: e.boolean().optional(),
     readOnly: e.boolean().optional(),
     hidden: e.boolean().optional(),
@@ -223,7 +235,7 @@ function pe() {
     label: e.string().optional(),
     // Validates that each column has fieldname; allows all other ColumnSchema properties
     columns: e.array(e.object({ fieldname: e.string().min(1) }).passthrough()),
-    config: re.optional(),
+    config: se.optional(),
     mode: e.enum(["edit", "read", "display"]).optional()
   }).meta({ title: "TableField" });
   let i = e.never();
@@ -235,10 +247,10 @@ function pe() {
     collapsible: e.boolean().optional(),
     mode: e.enum(["edit", "read", "display"]).optional(),
     schema: e.lazy(() => i.array())
-  }).meta({ title: "FieldsetField" }), r = e.discriminatedUnion("kind", [t, o, n]);
-  return i = e.preprocess($, r), { ValueFieldSchema: t, TableFieldSchema: n, FieldsetFieldSchema: o, DoctypeFieldSchema: i };
+  }).meta({ title: "FieldsetField" }), a = e.discriminatedUnion("kind", [t, o, n]);
+  return i = e.preprocess(M, a), { ValueFieldSchema: t, TableFieldSchema: n, FieldsetFieldSchema: o, DoctypeFieldSchema: i };
 }
-const D = pe(), Me = D.ValueFieldSchema, qe = D.FieldsetFieldSchema, Ee = D.TableFieldSchema, O = D.DoctypeFieldSchema;
+const D = ue(), xe = D.ValueFieldSchema, Ue = D.FieldsetFieldSchema, Pe = D.TableFieldSchema, C = D.DoctypeFieldSchema;
 function L(t) {
   const n = [];
   for (const i of t)
@@ -251,8 +263,8 @@ function j(t) {
 function A(t) {
   return t === void 0 ? "—" : JSON.stringify(t);
 }
-function xe(t, n) {
-  const i = Array.isArray(t.fields) ? t.fields.filter(j) : [], o = new Map(n.fields.map((s) => [s.fieldname, s])), r = new Set(Object.keys(n.links ?? {})), p = {
+function Re(t, n) {
+  const i = Array.isArray(t.fields) ? t.fields.filter(j) : [], o = new Map(n.fields.map((s) => [s.fieldname, s])), a = new Set(Object.keys(n.links ?? {})), p = {
     doctype: typeof t.name == "string" ? t.name : "(unnamed)",
     mode: "clean",
     tagged: [],
@@ -266,43 +278,43 @@ function xe(t, n) {
       return { ...s, schema: s.schema.filter(j).map(f) };
     const y = typeof s.fieldname == "string" ? s.fieldname : "", d = o.get(y);
     if (!d)
-      return s.computed !== !0 && !r.has(y) && p.orphan.push(y), s;
+      return s.computed !== !0 && !a.has(y) && p.orphan.push(y), s;
     p.tagged.push(y), d.component !== s.component && p.componentDrift.push(`${y}: authored=${A(s.component)} schema=${A(d.component)}`), !!d.required != !!s.required && p.requiredDrift.push(`${y}: authored=${!!s.required} schema=${!!d.required}`);
-    for (const m of de) {
+    for (const m of pe) {
       if (m === "fieldname" || m === "required") continue;
       const h = s[m], F = d[m];
       h === void 0 && F === void 0 || JSON.stringify(h) !== JSON.stringify(F) && p.identityDrift.push(`${y}.${m}: authored=${A(h)} schema=${A(F)}`);
     }
     return { ...s, source: "introspected" };
-  }, g = { ...t, fields: i.map(f) }, a = new Set(L(i).map((s) => s.fieldname));
-  p.omitted = n.fields.map((s) => s.fieldname).filter((s) => !a.has(s));
-  const l = L(i).find((s) => s.primaryKey === !0), u = n.fields.find((s) => s.primaryKey === !0);
-  return l && u && l.fieldname !== u.fieldname ? (p.mode = "partial", p.reason = `authored primary key '${String(l.fieldname)}' is not the derivable '${u.fieldname}' — left as authored`) : l && !u ? (p.mode = "partial", p.reason = `authored primary key '${String(l.fieldname)}' is not derivable from the schema — left as authored`) : !l && u && (p.mode = "partial", p.reason = `schema suggests '${u.fieldname}' as primary key but the doctype declares none — not applied`), { doctype: g, drift: p };
+  }, g = { ...t, fields: i.map(f) }, r = new Set(L(i).map((s) => s.fieldname));
+  p.omitted = n.fields.map((s) => s.fieldname).filter((s) => !r.has(s));
+  const c = L(i).find((s) => s.primaryKey === !0), u = n.fields.find((s) => s.primaryKey === !0);
+  return c && u && c.fieldname !== u.fieldname ? (p.mode = "partial", p.reason = `authored primary key '${String(c.fieldname)}' is not the derivable '${u.fieldname}' — left as authored`) : c && !u ? (p.mode = "partial", p.reason = `authored primary key '${String(c.fieldname)}' is not derivable from the schema — left as authored`) : !c && u && (p.mode = "partial", p.reason = `schema suggests '${u.fieldname}' as primary key but the doctype declares none — not applied`), { doctype: g, drift: p };
 }
-function Re(t) {
+function Ke(t) {
   const n = [];
   t.reason && n.push(`  ${t.doctype}: ${t.reason}`);
-  const i = (o, r) => {
-    r.length && n.push(`  ${t.doctype}: ${o} ${r.join("; ")}`);
+  const i = (o, a) => {
+    a.length && n.push(`  ${t.doctype}: ${o} ${a.join("; ")}`);
   };
   return i("identity drift", t.identityDrift), i("component drift", t.componentDrift), i("required drift", t.requiredDrift), i("authored fields with no schema field:", t.orphan), i("schema fields not modelled:", t.omitted), n;
 }
-function Ue(t, n = {}) {
-  const i = me(t), o = i.getTypeMap(), r = /* @__PURE__ */ new Set(), p = i.getQueryType(), f = i.getMutationType(), g = i.getSubscriptionType();
-  p && r.add(p.name), f && r.add(f.name), g && r.add(g.name);
-  const a = n.isEntityType ?? te, l = /* @__PURE__ */ new Set();
+function Ve(t, n = {}) {
+  const i = fe(t), o = i.getTypeMap(), a = /* @__PURE__ */ new Set(), p = i.getQueryType(), f = i.getMutationType(), g = i.getSubscriptionType();
+  p && a.add(p.name), f && a.add(f.name), g && a.add(g.name);
+  const r = n.isEntityType ?? ne, c = /* @__PURE__ */ new Set();
   for (const [d, m] of Object.entries(o))
-    k(m) && (r.has(d) || a(d, m) && l.add(d));
-  let u = l;
+    k(m) && (a.has(d) || r(d, m) && c.add(d));
+  let u = c;
   if (n.include) {
     const d = new Set(n.include);
-    u = new Set([...l].filter((m) => d.has(m)));
+    u = new Set([...c].filter((m) => d.has(m)));
   }
   if (n.exclude) {
     const d = new Set(n.exclude);
     u = new Set([...u].filter((m) => !d.has(m)));
   }
-  const s = n.isEntityField ?? ie, y = [];
+  const s = n.isEntityField ?? oe, y = [];
   for (const d of u) {
     const m = o[d];
     if (!k(m)) continue;
@@ -310,50 +322,50 @@ function Ue(t, n = {}) {
     F && n.onWarning?.(
       `${d}: schema exposes both 'id' (Relay identifier) and 'rowId' (the real column). Skipping 'id' and emitting 'rowId' verbatim — no primary key can be derived. Override the '_attributeName' and 'nodeIdFieldName' inflectors so the column keeps its own name.`
     );
-    const C = Object.entries(h).filter(
-      ([c, b]) => s(c, b, m) && !(F && c === "id")
-    ).map(([c, b]) => {
+    const N = Object.entries(h).filter(
+      ([l, b]) => s(l, b, m) && !(F && l === "id")
+    ).map(([l, b]) => {
       if (n.classifyField) {
-        const S = n.classifyField(c, b, m);
+        const S = n.classifyField(l, b, m);
         if (S != null)
           return {
             kind: "field",
-            fieldname: c,
-            label: S.label ?? c,
+            fieldname: l,
+            label: S.label ?? l,
             component: S.component ?? "ATextInput",
             ...S
           };
       }
-      return ae(c, b, l, n);
-    }), E = C.find(
-      (c) => c.fieldname === "id" && c.required && !c.doctype && !c._isLink
-    )?.fieldname, w = {}, x = C.filter((c) => c._isLink && c.doctype && c.cardinality ? (w[c.fieldname] = {
-      target: c.doctype,
-      cardinality: c.cardinality
-    }, !1) : !0).map((c) => {
-      const b = c.fieldname === E ? { primaryKey: !0 } : {};
+      return re(l, b, c, n);
+    }), x = N.find(
+      (l) => l.fieldname === "id" && l.required && !l.doctype && !l._isLink
+    )?.fieldname, w = {}, U = N.filter((l) => l._isLink && l.doctype && l.cardinality ? (w[l.fieldname] = {
+      target: l.doctype,
+      cardinality: l.cardinality
+    }, !1) : !0).map((l) => {
+      const b = l.fieldname === x ? { primaryKey: !0 } : {};
       if (!n.includeUnmappedMeta) {
-        const { _graphqlType: De, _unmapped: we, _isLink: Ie, ...U } = c;
-        return Object.assign(U, b, { source: "introspected" });
+        const { _graphqlType: _e, _unmapped: Le, _isLink: je, ...R } = l;
+        return Object.assign(R, b, { source: "introspected" });
       }
-      const { _isLink: S, ...R } = c;
-      return Object.assign(R, b, { source: "introspected" });
-    }), N = n.doctypeNames?.[d] ?? d, I = {
-      name: N,
-      slug: T(N),
-      fields: x
+      const { _isLink: S, ...P } = l;
+      return Object.assign(P, b, { source: "introspected" });
+    }), $ = n.doctypeNames?.[d] ?? d, I = {
+      name: $,
+      slug: T($),
+      fields: U
     };
     Object.keys(w).length > 0 && (I.links = w), n.includeUnmappedMeta && (I._graphqlTypeName = d), y.push(I);
   }
   return y;
 }
-function me(t) {
-  return typeof t == "string" ? B(t) : W(t);
+function fe(t) {
+  return typeof t == "string" ? W(t) : J(t);
 }
-const ue = e.enum(["atMostOne", "one", "noneOrMany", "atLeastOne"]).meta({
+const ye = e.enum(["atMostOne", "one", "noneOrMany", "atLeastOne"]).meta({
   title: "Cardinality",
   description: "Cardinality for relationship links between doctypes"
-}), fe = e.object({
+}), ge = e.object({
   /** Fetch method type */
   method: e.literal("sync"),
   /** Optional limit on number of records to fetch */
@@ -361,13 +373,13 @@ const ue = e.enum(["atMostOne", "one", "noneOrMany", "atLeastOne"]).meta({
 }).meta({
   title: "SyncFetch",
   description: "Sync fetch strategy - data is fetched in the initial query"
-}), ye = e.object({
+}), he = e.object({
   /** Fetch method type */
   method: e.literal("lazy")
 }).meta({
   title: "LazyFetch",
   description: "Lazy fetch strategy - data is fetched on demand in a separate query"
-}), ge = e.object({
+}), be = e.object({
   /** Fetch method type */
   method: e.literal("custom"),
   /** Serialized handler function to invoke */
@@ -375,14 +387,14 @@ const ue = e.enum(["atMostOne", "one", "noneOrMany", "atLeastOne"]).meta({
 }).meta({
   title: "CustomFetch",
   description: "Custom fetch strategy - uses a custom handler function"
-}), he = e.discriminatedUnion("method", [fe, ye, ge]).meta({
+}), Fe = e.discriminatedUnion("method", [ge, he, be]).meta({
   title: "FetchStrategy",
   description: "Fetch strategy for link data loading"
-}), be = e.object({
+}), Se = e.object({
   /** Target doctype slug */
   target: e.string().min(1),
   /** Cardinality of the relationship */
-  cardinality: ue,
+  cardinality: ye,
   /** Backlink fieldname on the target doctype that points back to this link */
   backlink: e.string().optional(),
   /** Override default rendering component (AForm for 1:1, ATable for 1:many) */
@@ -390,13 +402,13 @@ const ue = e.enum(["atMostOne", "one", "noneOrMany", "atLeastOne"]).meta({
   /** Fieldname of the corresponding Link field in the fields array */
   fieldname: e.string().min(1).optional(),
   /** Fetch strategy for loading nested data */
-  fetch: he.optional(),
+  fetch: Fe.optional(),
   /** Whether to block workflow actions until nested data is loaded (default: true) */
   blockWorkflows: e.boolean().optional()
 }).meta({
   title: "LinkDeclaration",
   description: "Declares a relationship from one doctype to another"
-}), Fe = e.object({
+}), Te = e.object({
   /** Display label for the action */
   label: e.string().min(1),
   /** Fields that must have values before action can execute */
@@ -420,7 +432,7 @@ const ue = e.enum(["atMostOne", "one", "noneOrMany", "atLeastOne"]).meta({
 }).meta({
   title: "ActionDefinition",
   description: "Action definition within a workflow"
-}), Se = e.object({
+}), ke = e.object({
   /** Optional display label; the map key is the trigger's identity */
   label: e.string().optional(),
   /** Fieldnames whose edits fire this trigger (fires when any listed field changes) */
@@ -431,44 +443,50 @@ const ue = e.enum(["atMostOne", "one", "noneOrMany", "atLeastOne"]).meta({
   title: "TriggerDefinition",
   description: "Reactive field-validation trigger — advisory client-side"
 });
-function Pe(t, n) {
+function ze(t, n) {
   const i = t.allowedStates;
   return !i || i.length === 0 ? !0 : i.includes(n);
 }
-const Te = e.record(
+const Ae = e.record(
   e.string(),
   e.object({
     position: e.object({ x: e.number(), y: e.number() }).optional(),
     targetPosition: e.enum(["left", "top", "right", "bottom"]).optional(),
     sourcePosition: e.enum(["left", "top", "right", "bottom"]).optional()
   })
-), ke = e.object({
+), De = e.object({
   /** List of workflow states */
   states: e.array(e.string()).optional(),
   /** Actions available in this workflow */
-  actions: e.record(e.string(), Fe).optional(),
+  actions: e.record(e.string(), Te).optional(),
   /** Reactive field-validation triggers (advisory, client-side), keyed by trigger name */
-  triggers: e.record(e.string(), Se).optional(),
+  triggers: e.record(e.string(), ke).optional(),
   /**
    * DocBuilder node positions keyed by state name — authoring view-state. Persisted here so a
    * doctype author's manual graph arrangement survives reloads; like `triggers`, it is client-only
    * and never enters the runtime GraphQL SDL. See {@link (WorkflowLayout:variable)}.
    */
-  layout: Te.optional()
+  layout: Ae.optional()
 }).meta({
   title: "WorkflowMeta",
   description: "Workflow metadata - states and actions for a doctype"
-}), q = e.object({
+}), E = e.object({
   /** Display name of the doctype */
   name: e.string().min(1),
   /** URL-friendly slug (kebab-case) */
   slug: e.string().min(1).optional(),
+  /**
+   * Field on this doctype used when displaying a reference to one of its records.
+   * When a record elsewhere holds a foreign key to this doctype, the middleware may
+   * include `fieldname__display` alongside the raw id, resolved from this field.
+   */
+  displayField: e.string().min(1).optional(),
   /** Field definitions (a link field is one carrying `doctype`) */
-  fields: e.array(O),
+  fields: e.array(C),
   /** Relationship links to other doctypes */
-  links: e.record(e.string(), be).optional(),
+  links: e.record(e.string(), Se).optional(),
   /** Workflow configuration */
-  workflow: ke.optional(),
+  workflow: De.optional(),
   /** Parent doctype for inheritance */
   inherits: e.string().optional()
 }).meta({
@@ -476,16 +494,26 @@ const Te = e.record(
   description: "Doctype metadata - complete definition of a doctype"
 }).superRefine((t, n) => {
   const i = t.fields.filter((o) => o.kind === "field" && o.primaryKey);
-  i.length > 1 && n.addIssue({
+  if (i.length > 1 && n.addIssue({
     code: "custom",
     path: ["fields"],
     message: `Doctype declares ${i.length} primaryKey fields (${i.map((o) => o.kind === "field" ? o.fieldname : "").join(
       ", "
     )}); a record is identified by exactly one field. A composite database key is mapped to a single identity by the adapter, so a doctype never declares its parts`
-  });
-});
-function Ke(t) {
-  const n = O.safeParse(t);
+  }), t.displayField && !me(t.fields, t.displayField)) {
+    const o = O(t.fields).find((a) => a.fieldname === t.displayField);
+    n.addIssue({
+      code: "custom",
+      path: ["displayField"],
+      message: o ? `displayField "${t.displayField}" names a computed field, which has no column to read a display value from` : `displayField "${t.displayField}" is not declared on this doctype`
+    });
+  }
+}), we = "__display";
+function Be(t) {
+  return `${t}${we}`;
+}
+function We(t) {
+  const n = C.safeParse(t);
   return n.success ? { success: !0, errors: [] } : {
     success: !1,
     errors: n.error.issues.map((i) => ({
@@ -494,8 +522,8 @@ function Ke(t) {
     }))
   };
 }
-function Ve(t) {
-  const n = q.safeParse(t);
+function Je(t) {
+  const n = E.safeParse(t);
   return n.success ? { success: !0, errors: [] } : {
     success: !1,
     errors: n.error.issues.map((i) => ({
@@ -504,48 +532,52 @@ function Ve(t) {
     }))
   };
 }
-function ze(t) {
-  return O.parse(t);
+function Ge(t) {
+  return C.parse(t);
 }
-function Be(t) {
-  return q.parse(t);
+function Qe(t) {
+  return E.parse(t);
 }
 export {
-  Fe as A,
-  T as B,
-  Ke as C,
-  O as D,
-  qe as F,
-  Q as G,
-  H as I,
-  Ee as T,
-  Me as V,
-  Z as W,
-  de as a,
-  re as b,
-  Ue as c,
-  Se as d,
-  Te as e,
-  Re as f,
-  ke as g,
-  Y as h,
+  Te as A,
+  Ne as B,
+  ve as C,
+  C as D,
+  Q as E,
+  Ue as F,
+  H as G,
+  T as H,
+  Z as I,
+  We as J,
+  we as L,
+  Pe as T,
+  xe as V,
+  Y as W,
+  pe as a,
+  se as b,
+  Ve as c,
+  ke as d,
+  Ae as e,
+  Ke as f,
+  De as g,
+  X as h,
   G as i,
-  Oe as j,
-  ae as k,
-  ie as l,
-  xe as m,
-  te as n,
-  M as o,
-  ve as p,
-  $e as q,
-  Pe as r,
-  le as s,
-  Be as t,
-  ze as u,
-  Ve as v,
-  Ne as w,
-  je as x,
-  Ce as y,
-  J as z
+  $e as j,
+  re as k,
+  oe as l,
+  Re as m,
+  ne as n,
+  O as o,
+  me as p,
+  q,
+  qe as r,
+  Ee as s,
+  ze as t,
+  Be as u,
+  Je as v,
+  de as w,
+  Qe as x,
+  Ge as y,
+  Me as z
 };
-//# sourceMappingURL=validation-C25HJXWs.js.map
+//# sourceMappingURL=validation-1DGAGmuU.js.map