@stonecrop/schema 0.10.16 → 0.11.1

package/dist/{index-D6Up-BP5.js → index-CLc5mUMQ.js}

@@ -1,6 +1,6 @@
 import { z as e } from "zod";
-import { isScalarType as M, isEnumType as E, isObjectType as g, isNonNullType as k, isListType as x, buildSchema as v, buildClientSchema as j } from "graphql";
-const U = e.enum([
+import { isScalarType as v, isEnumType as x, isObjectType as g, isNonNullType as L, isListType as U, buildSchema as q, buildClientSchema as P } from "graphql";
+const R = e.enum([
   "Data",
   // Short text, varchar
   "Text",
@@ -29,8 +29,6 @@ const U = e.enum([
   // Code/source (with syntax highlighting)
   "Link",
   // Reference to another doctype
-  "Doctype",
-  // Child doctype (1:1 nested form or 1:many table via cardinality)
   "Attach",
   // File attachment
   "Currency",
@@ -42,7 +40,7 @@ const U = e.enum([
 ]).meta({
   title: "StonecropFieldType",
   description: "Semantic field types for Stonecrop doctypes, consistent across forms and tables"
-}), P = {
+}), J = {
   // Text
   Data: { component: "ATextInput", fieldtype: "Data" },
   Text: { component: "ATextInput", fieldtype: "Text" },
@@ -63,7 +61,6 @@ const U = e.enum([
   Code: { component: "ACodeEditor", fieldtype: "Code" },
   // Relational
   Link: { component: "ALink", fieldtype: "Link" },
-  Doctype: { component: "AForm", fieldtype: "Doctype" },
   // Files
   Attach: { component: "AFileAttach", fieldtype: "Attach" },
   // Specialized
@@ -71,10 +68,10 @@ const U = e.enum([
   Quantity: { component: "AQuantityInput", fieldtype: "Quantity" },
   Select: { component: "ADropdown", fieldtype: "Select" }
 };
-function ae(t) {
-  return P[t]?.component ?? "ATextInput";
+function ge(t) {
+  return J[t]?.component ?? "ATextInput";
 }
-const R = e.union([
+const Q = e.union([
   e.string(),
   // Link/Doctype target: "customer"
   e.array(e.string()),
@@ -84,18 +81,18 @@ const R = e.union([
 ]).meta({
   title: "FieldOptions",
   description: "Field options - flexible bag for type-specific configuration"
-}), q = e.looseObject({
+}), W = e.looseObject({
   /** Error message to display when validation fails */
   errorMessage: e.string()
 }).meta({
   title: "FieldValidation",
   description: "Validation configuration for form fields"
-}), I = e.object({
+}), k = e.object({
   // === CORE (required) ===
   /** Unique identifier for the field within its doctype */
   fieldname: e.string().min(1),
   /** Semantic field type - determines behavior and default component */
-  fieldtype: U,
+  fieldtype: R,
   // === COMPONENT (optional - derived from fieldtype when not specified) ===
   /** Vue component to render this field. If not specified, derived from TYPE_MAP */
   component: e.string().optional(),
@@ -129,13 +126,15 @@ const R = e.union([
    * - Decimal: \{ precision, scale \}
    * - Code: \{ language \}
    */
-  options: R.optional(),
+  options: Q.optional(),
   /**
    * Cardinality for Doctype fields:
-   * - 'one': 1:1 nested form (default)
-   * - 'many': 1:many child table
+   * - 'one': exactly 1 (default)
+   * - 'atMostOne': 0 or 1
+   * - 'noneOrMany': 0 or more
+   * - 'atLeastOne': 1 or more
    */
-  cardinality: e.enum(["one", "many"]).optional(),
+  cardinality: e.enum(["one", "atMostOne", "noneOrMany", "atLeastOne"]).optional(),
   /**
    * Input mask pattern. Accepts either a plain mask string or a stringified
    * arrow function that receives `locale` and returns a mask string.
@@ -147,11 +146,57 @@ const R = e.union([
   mask: e.string().optional(),
   // === VALIDATION ===
   /** Validation configuration */
-  validation: q.optional()
+  validation: W.optional()
 }).meta({
   title: "FieldMeta",
   description: "Unified field metadata - the single source of truth for field definitions, works for both forms (AForm) and tables (ATable)"
-}), J = e.object({
+}), z = e.enum(["atMostOne", "one", "noneOrMany", "atLeastOne"]).meta({
+  title: "Cardinality",
+  description: "Cardinality for relationship links between doctypes"
+}), $ = e.object({
+  /** Fetch method type */
+  method: e.literal("sync"),
+  /** Optional limit on number of records to fetch */
+  limit: e.number().int().positive().optional()
+}).meta({
+  title: "SyncFetch",
+  description: "Sync fetch strategy - data is fetched in the initial query"
+}), B = 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"
+}), G = e.object({
+  /** Fetch method type */
+  method: e.literal("custom"),
+  /** Serialized handler function to invoke */
+  handler: e.string()
+}).meta({
+  title: "CustomFetch",
+  description: "Custom fetch strategy - uses a custom handler function"
+}), V = e.discriminatedUnion("method", [$, B, G]).meta({
+  title: "FetchStrategy",
+  description: "Fetch strategy for link data loading"
+}), Z = e.object({
+  /** Target doctype slug */
+  target: e.string().min(1),
+  /** Cardinality of the relationship */
+  cardinality: z,
+  /** 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) */
+  component: e.string().optional(),
+  /** Fieldname of the corresponding Link field in the fields array */
+  fieldname: e.string().min(1).optional(),
+  /** Fetch strategy for loading nested data */
+  fetch: V.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"
+}), Y = e.object({
   /** Display label for the action */
   label: e.string().min(1),
   /** Handler function name or path */
@@ -167,11 +212,11 @@ const R = e.union([
 }).meta({
   title: "ActionDefinition",
   description: "Action definition within a workflow"
-}), Q = e.object({
+}), K = e.object({
   /** List of workflow states */
   states: e.array(e.string()).optional(),
   /** Actions available in this workflow */
-  actions: e.record(e.string(), J).optional()
+  actions: e.record(e.string(), Y).optional()
 }).meta({
   title: "WorkflowMeta",
   description: "Workflow metadata - states and actions for a doctype"
@@ -182,75 +227,73 @@ const R = e.union([
   slug: e.string().min(1).optional(),
   /** Database table name */
   tableName: e.string().optional(),
-  /** Field definitions */
-  fields: e.array(I),
+  /** Field definitions (including link fields with fieldtype: 'Link') */
+  fields: e.array(k),
+  /** Relationship links to other doctypes */
+  links: e.record(e.string(), Z).optional(),
   /** Workflow configuration */
-  workflow: Q.optional(),
+  workflow: K.optional(),
   /** Parent doctype for inheritance */
-  inherits: e.string().optional(),
-  /** Doctype to use for list views */
-  listDoctype: e.string().optional(),
-  /** Parent doctype for child tables */
-  parentDoctype: e.string().optional()
+  inherits: e.string().optional()
 }).meta({
   title: "DoctypeMeta",
   description: "Doctype metadata - complete definition of a doctype"
 });
-function re(t) {
-  const n = I.safeParse(t);
+function he(t) {
+  const n = k.safeParse(t);
   return n.success ? { success: !0, errors: [] } : {
     success: !1,
-    errors: n.error.issues.map((i) => ({
-      path: i.path,
-      message: i.message
+    errors: n.error.issues.map((o) => ({
+      path: o.path,
+      message: o.message
     }))
   };
 }
-function pe(t) {
+function Ae(t) {
   const n = _.safeParse(t);
   return n.success ? { success: !0, errors: [] } : {
     success: !1,
-    errors: n.error.issues.map((i) => ({
-      path: i.path,
-      message: i.message
+    errors: n.error.issues.map((o) => ({
+      path: o.path,
+      message: o.message
     }))
   };
 }
-function se(t) {
-  return I.parse(t);
+function Te(t) {
+  return k.parse(t);
 }
-function ce(t) {
+function De(t) {
   return _.parse(t);
 }
-function le(t) {
-  return t.replace(/_([a-z])/g, (n, i) => i.toUpperCase());
+function be(t) {
+  return t.replace(/_([a-z])/g, (n, o) => o.toUpperCase());
 }
-function de(t) {
+function Se(t) {
   return t.replace(/[A-Z]/g, (n) => `_${n.toLowerCase()}`);
 }
-function ue(t) {
+function ke(t) {
   return t.split("_").map((n) => n.charAt(0).toUpperCase() + n.slice(1).toLowerCase()).join(" ");
 }
-function W(t) {
+function H(t) {
   const n = t.replace(/([A-Z])/g, " $1").trim();
   return n.charAt(0).toUpperCase() + n.slice(1);
 }
-function fe(t) {
+function Fe(t) {
   return t.split(/[-_\s]+/).map((n) => n.charAt(0).toUpperCase() + n.slice(1).toLowerCase()).join("");
 }
-function T(t) {
+function D(t) {
   return t.replace(/([a-z])([A-Z])/g, "$1-$2").replace(/[\s_]+/g, "-").toLowerCase();
 }
-function $(t) {
+function X(t) {
   return t.replace(/([a-z])([A-Z])/g, "$1_$2").replace(/[\s-]+/g, "_").toLowerCase();
 }
-const B = {
+const ee = {
   String: { component: "ATextInput", fieldtype: "Data" },
   Int: { component: "ANumericInput", fieldtype: "Int" },
   Float: { component: "ANumericInput", fieldtype: "Float" },
   Boolean: { component: "ACheckbox", fieldtype: "Check" },
   ID: { component: "ATextInput", fieldtype: "Data" }
-}, z = {
+}, te = {
   // Arbitrary precision / large numbers
   BigFloat: { component: "ADecimalInput", fieldtype: "Decimal" },
   BigDecimal: { component: "ADecimalInput", fieldtype: "Decimal" },
@@ -270,20 +313,20 @@ const B = {
   JSON: { component: "ACodeEditor", fieldtype: "JSON" },
   JSONObject: { component: "ACodeEditor", fieldtype: "JSON" },
   JsonNode: { component: "ACodeEditor", fieldtype: "JSON" }
-}, G = /* @__PURE__ */ new Set(["Cursor"]);
-function V(t) {
-  const n = { ...z };
-  for (const [i, a] of Object.entries(B))
-    n[i] = a;
+}, ne = /* @__PURE__ */ new Set(["Cursor"]);
+function ie(t) {
+  const n = { ...te };
+  for (const [o, a] of Object.entries(ee))
+    n[o] = a;
   if (t)
-    for (const [i, a] of Object.entries(t))
-      n[i] = {
+    for (const [o, a] of Object.entries(t))
+      n[o] = {
         component: a.component ?? "ATextInput",
         fieldtype: a.fieldtype ?? "Data"
       };
   return n;
 }
-const Z = [
+const oe = [
   "Connection",
   "Edge",
   "Input",
@@ -299,137 +342,137 @@ const Z = [
   "InsertResponse",
   "UpdateResponse",
   "MutationResponse"
-], Y = /* @__PURE__ */ new Set(["Query", "Mutation", "Subscription"]);
-function K(t, n) {
-  if (t.startsWith("__") || Y.has(t) || t === "Node")
+], ae = /* @__PURE__ */ new Set(["Query", "Mutation", "Subscription"]);
+function re(t, n) {
+  if (t.startsWith("__") || ae.has(t) || t === "Node")
     return !1;
-  for (const a of Z)
+  for (const a of oe)
     if (t.endsWith(a))
       return !1;
-  const i = n.getFields();
-  return Object.keys(i).length !== 0;
+  const o = n.getFields();
+  return Object.keys(o).length !== 0;
 }
-const H = /* @__PURE__ */ new Set(["nodeId", "__typename", "clientMutationId"]);
-function X(t, n, i) {
-  return !H.has(t);
+const se = /* @__PURE__ */ new Set(["nodeId", "__typename", "clientMutationId"]);
+function ce(t, n, o) {
+  return !se.has(t);
 }
 function S(t) {
-  let n = !1, i = !1, a = t;
-  return k(a) && (n = !0, a = a.ofType), x(a) && (i = !0, a = a.ofType, k(a) && (a = a.ofType)), { namedType: a, required: n, isList: i };
+  let n = !1, o = !1, a = t;
+  return L(a) && (n = !0, a = a.ofType), U(a) && (o = !0, a = a.ofType, L(a) && (a = a.ofType)), { namedType: a, required: n, isList: o };
 }
-function ee(t) {
-  const i = t.getFields().edges;
-  if (!i) return;
-  const { namedType: a, isList: r } = S(i.type);
+function le(t) {
+  const o = t.getFields().edges;
+  if (!o) return;
+  const { namedType: a, isList: r } = S(o.type);
   if (!r || !g(a)) return;
   const d = a.getFields().node;
   if (!d) return;
-  const { namedType: f } = S(d.type);
-  if (g(f))
-    return f.name;
+  const { namedType: u } = S(d.type);
+  if (g(u))
+    return u.name;
 }
-function te(t, n, i, a = {}) {
-  const { namedType: r, required: m, isList: d } = S(n.type), f = V(a.customScalars), o = {
+function pe(t, n, o, a = {}) {
+  const { namedType: r, required: f, isList: d } = S(n.type), u = ie(a.customScalars), i = {
     fieldname: t,
-    label: W(t),
+    label: H(t),
     component: "ATextInput",
     fieldtype: "Data"
   };
-  if (m && (o.required = !0), M(r)) {
-    if (G.has(r.name))
-      return o._unmapped = !0, a.includeUnmappedMeta && (o._graphqlType = r.name), o;
-    const s = f[r.name];
-    return s ? (o.component = s.component, o.fieldtype = s.fieldtype) : (o._unmapped = !0, a.includeUnmappedMeta && (o._graphqlType = r.name)), o;
+  if (f && (i.required = !0), v(r)) {
+    if (ne.has(r.name))
+      return i._unmapped = !0, a.includeUnmappedMeta && (i._graphqlType = r.name), i;
+    const l = u[r.name];
+    return l ? (i.component = l.component, i.fieldtype = l.fieldtype) : (i._unmapped = !0, a.includeUnmappedMeta && (i._graphqlType = r.name)), i;
   }
-  if (E(r))
-    return o.component = "ADropdown", o.fieldtype = "Select", o.options = r.getValues().map((s) => s.name), o;
+  if (x(r))
+    return i.component = "ADropdown", i.fieldtype = "Select", i.options = r.getValues().map((l) => l.name), i;
   if (g(r)) {
-    if (!d && i.has(r.name))
-      return o.component = "ALink", o.fieldtype = "Link", o.options = T(r.name), o;
-    const s = ee(r);
-    return s && i.has(s) ? (o.component = "ATable", o.fieldtype = "Doctype", o.options = T(s), o.cardinality = "many", o) : d && i.has(r.name) ? (o.component = "ATable", o.fieldtype = "Doctype", o.options = T(r.name), o.cardinality = "many", o) : (o._unmapped = !0, a.includeUnmappedMeta && (o._graphqlType = r.name), o);
+    if (!d && o.has(r.name))
+      return i.component = "ALink", i.fieldtype = "Link", i.options = D(r.name), i;
+    const l = le(r);
+    return l && o.has(l) ? (i.component = "ATable", i._isLink = !0, i.options = D(l), i.cardinality = "noneOrMany", delete i.fieldtype, i) : d && o.has(r.name) ? (i.component = "ATable", i._isLink = !0, i.options = D(r.name), i.cardinality = "noneOrMany", delete i.fieldtype, i) : (i._unmapped = !0, a.includeUnmappedMeta && (i._graphqlType = r.name), i);
   }
-  return o._unmapped = !0, a.includeUnmappedMeta && (o._graphqlType = r.name), o;
+  return i._unmapped = !0, a.includeUnmappedMeta && (i._graphqlType = r.name), i;
 }
-function me(t, n = {}) {
-  const i = ne(t), a = i.getTypeMap(), r = /* @__PURE__ */ new Set(), m = i.getQueryType(), d = i.getMutationType(), f = i.getSubscriptionType();
-  m && r.add(m.name), d && r.add(d.name), f && r.add(f.name);
-  const o = n.isEntityType ?? K, s = /* @__PURE__ */ new Set();
-  for (const [p, c] of Object.entries(a))
-    g(c) && (r.has(p) || o(p, c) && s.add(p));
-  let A = s;
+function Ie(t, n = {}) {
+  const o = de(t), a = o.getTypeMap(), r = /* @__PURE__ */ new Set(), f = o.getQueryType(), d = o.getMutationType(), u = o.getSubscriptionType();
+  f && r.add(f.name), d && r.add(d.name), u && r.add(u.name);
+  const i = n.isEntityType ?? re, l = /* @__PURE__ */ new Set();
+  for (const [c, p] of Object.entries(a))
+    g(p) && (r.has(c) || i(c, p) && l.add(c));
+  let h = l;
   if (n.include) {
-    const p = new Set(n.include);
-    A = new Set([...s].filter((c) => p.has(c)));
+    const c = new Set(n.include);
+    h = new Set([...l].filter((p) => c.has(p)));
   }
   if (n.exclude) {
-    const p = new Set(n.exclude);
-    A = new Set([...A].filter((c) => !p.has(c)));
+    const c = new Set(n.exclude);
+    h = new Set([...h].filter((p) => !c.has(p)));
   }
-  const w = n.isEntityField ?? X, L = n.deriveTableName ?? ((p) => $(p)), b = [];
-  for (const p of A) {
-    const c = a[p];
-    if (!g(c)) continue;
-    const N = c.getFields(), F = n.typeOverrides?.[p], O = Object.entries(N).filter(([l, y]) => w(l, y, c)).map(([l, y]) => {
+  const O = n.isEntityField ?? ce, w = n.deriveTableName ?? ((c) => X(c)), F = [];
+  for (const c of h) {
+    const p = a[c];
+    if (!g(p)) continue;
+    const M = p.getFields(), I = n.typeOverrides?.[c], N = Object.entries(M).filter(([s, y]) => O(s, y, p)).map(([s, y]) => {
       if (n.classifyField) {
-        const u = n.classifyField(l, y, c);
-        if (u != null)
+        const m = n.classifyField(s, y, p);
+        if (m != null)
           return {
-            fieldname: l,
-            label: u.label ?? l,
-            component: u.component ?? "ATextInput",
-            fieldtype: u.fieldtype ?? "Data",
-            ...u
+            fieldname: s,
+            label: m.label ?? s,
+            component: m.component ?? "ATextInput",
+            fieldtype: m.fieldtype ?? "Data",
+            ...m
           };
       }
-      const h = te(l, y, s, n);
-      return F?.[l] ? { ...h, ...F[l] } : h;
-    }).map((l) => {
+      const T = pe(s, y, l, n);
+      return I?.[s] ? { ...T, ...I[s] } : T;
+    }), b = {}, E = N.filter((s) => s._isLink && typeof s.options == "string" && s.cardinality ? (b[s.fieldname] = {
+      target: s.options,
+      cardinality: s.cardinality
+    }, !1) : !0).map((s) => {
       if (!n.includeUnmappedMeta) {
-        const { _graphqlType: y, _unmapped: h, ...u } = l;
-        return u;
+        const { _graphqlType: m, _unmapped: ue, _isLink: me, ...j } = s;
+        return j;
       }
-      return l;
-    }), D = {
-      name: p,
-      slug: T(p),
-      fields: O
-    }, C = L(p);
-    C && (D.tableName = C), n.includeUnmappedMeta && (D._graphqlTypeName = p), b.push(D);
+      const { _isLink: y, ...T } = s;
+      return T;
+    }), A = {
+      name: c,
+      slug: D(c),
+      fields: E
+    };
+    Object.keys(b).length > 0 && (A.links = b);
+    const C = w(c);
+    C && (A.tableName = C), n.includeUnmappedMeta && (A._graphqlTypeName = c), F.push(A);
   }
-  return b;
+  return F;
 }
-function ne(t) {
-  return typeof t == "string" ? v(t) : j(t);
+function de(t) {
+  return typeof t == "string" ? q(t) : P(t);
 }
 export {
-  J as A,
-  _ as D,
-  I as F,
-  B as G,
-  G as I,
-  U as S,
-  P as T,
-  z as W,
-  R as a,
-  q as b,
-  Q as c,
-  V as d,
-  W as e,
-  de as f,
-  te as g,
-  me as h,
-  X as i,
-  K as j,
-  ae as k,
-  se as l,
-  $ as m,
-  ue as n,
-  T as o,
-  ce as p,
-  re as q,
-  le as s,
-  fe as t,
-  pe as v
+  ee as G,
+  ne as I,
+  R as S,
+  J as T,
+  te as W,
+  Se as a,
+  ie as b,
+  H as c,
+  pe as d,
+  Ie as e,
+  ce as f,
+  re as g,
+  ge as h,
+  Te as i,
+  X as j,
+  ke as k,
+  D as l,
+  he as m,
+  De as p,
+  be as s,
+  Fe as t,
+  Ae as v
 };
-//# sourceMappingURL=index-D6Up-BP5.js.map
+//# sourceMappingURL=index-CLc5mUMQ.js.map