@stonecrop/schema 0.11.4 → 0.11.5

package/dist/cli.js

@@ -3,7 +3,7 @@ import { readFileSync as u, existsSync as S, mkdirSync as w, writeFileSync as x
 import { resolve as c, join as O } from "node:path";
 import { parseArgs as $ } from "node:util";
 import { getIntrospectionQuery as N } from "graphql";
-import { e as P, v as j } from "./index-CLc5mUMQ.js";
+import { e as P, v as j } from "./index-DqxTn6jG.js";
 async function C(e, m) {
   const t = await fetch(e, {
     method: "POST",

package/dist/fieldtype.js

@@ -1,11 +1,11 @@
 import { z } from 'zod';
 /**
- * Stonecrop field types - the semantic type of the field.
- * These are consistent across forms and tables.
+ * The complete list of field types built into Stonecrop.
+ * User apps can use any string as a fieldtype; this const is the exhaustive set of types
+ * that Stonecrop provides default components for.
  * @public
  */
-export const StonecropFieldType = z
-    .enum([
+export const BUILTIN_FIELD_TYPES = [
     'Data', // Short text, varchar
     'Text', // Long text
     'Int', // Integer
@@ -24,13 +24,26 @@ export const StonecropFieldType = z
     'Currency', // Currency value
     'Quantity', // Quantity with unit
     'Select', // Dropdown selection
-])
-    .meta({
+];
+/**
+ * Stonecrop field type — any non-empty string is valid; Stonecrop provides default components
+ * for the builtin types listed in {@link BUILTIN_FIELD_TYPES}. Custom fieldtypes are supported
+ * by supplying an explicit `component` on the field definition.
+ * @public
+ */
+export const StonecropFieldType = z.string().min(1).meta({
     title: 'StonecropFieldType',
     description: 'Semantic field types for Stonecrop doctypes, consistent across forms and tables',
 });
 /**
- * Mapping from StonecropFieldType to default Vue component.
+ * Returns `true` when `fieldtype` is one of the builtin types Stonecrop ships with.
+ * @public
+ */
+export function isBuiltinFieldType(fieldtype) {
+    return BUILTIN_FIELD_TYPES.includes(fieldtype);
+}
+/**
+ * Mapping from builtin fieldtypes to their default Vue component.
  * Components can be overridden in the field definition.
  * @public
  */
@@ -63,11 +76,22 @@ export const TYPE_MAP = {
     Select: { component: 'ADropdown', fieldtype: 'Select' },
 };
 /**
- * Get the default component for a field type
- * @param fieldtype - The semantic field type
+ * Get the default component for a builtin field type.
+ * For an open-string fieldtype that may be custom, use {@link resolveComponent} instead.
+ * @param fieldtype - A builtin field type
  * @returns The default component name
  * @public
  */
 export function getDefaultComponent(fieldtype) {
     return TYPE_MAP[fieldtype]?.component ?? 'ATextInput';
 }
+/**
+ * Resolve the component name for any fieldtype string, falling back to `'ATextInput'`
+ * for unknown custom types.
+ * @param fieldtype - Any fieldtype string (builtin or custom)
+ * @returns The component name to use for rendering
+ * @public
+ */
+export function resolveComponent(fieldtype) {
+    return isBuiltinFieldType(fieldtype) ? getDefaultComponent(fieldtype) : 'ATextInput';
+}

package/dist/{index-CLc5mUMQ.js → index-DqxTn6jG.js}

@@ -1,6 +1,6 @@
 import { z as e } from "zod";
-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([
+import { isScalarType as x, isEnumType as j, isObjectType as g, isNonNullType as L, isListType as U, buildSchema as P, buildClientSchema as q } from "graphql";
+const R = [
   "Data",
   // Short text, varchar
   "Text",
@@ -37,10 +37,14 @@ const R = e.enum([
   // Quantity with unit
   "Select"
   // Dropdown selection
-]).meta({
+], J = e.string().min(1).meta({
   title: "StonecropFieldType",
   description: "Semantic field types for Stonecrop doctypes, consistent across forms and tables"
-}), J = {
+});
+function Q(t) {
+  return R.includes(t);
+}
+const W = {
   // Text
   Data: { component: "ATextInput", fieldtype: "Data" },
   Text: { component: "ATextInput", fieldtype: "Text" },
@@ -68,10 +72,13 @@ const R = e.enum([
   Quantity: { component: "AQuantityInput", fieldtype: "Quantity" },
   Select: { component: "ADropdown", fieldtype: "Select" }
 };
-function ge(t) {
-  return J[t]?.component ?? "ATextInput";
+function z(t) {
+  return W[t]?.component ?? "ATextInput";
+}
+function Ae(t) {
+  return Q(t) ? z(t) : "ATextInput";
 }
-const Q = e.union([
+const B = e.union([
   e.string(),
   // Link/Doctype target: "customer"
   e.array(e.string()),
@@ -81,18 +88,18 @@ const Q = e.union([
 ]).meta({
   title: "FieldOptions",
   description: "Field options - flexible bag for type-specific configuration"
-}), W = e.looseObject({
+}), $ = e.looseObject({
   /** Error message to display when validation fails */
   errorMessage: e.string()
 }).meta({
   title: "FieldValidation",
   description: "Validation configuration for form fields"
-}), k = e.object({
+}), I = 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: R,
+  fieldtype: J,
   // === 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(),
@@ -126,7 +133,7 @@ const Q = e.union([
    * - Decimal: \{ precision, scale \}
    * - Code: \{ language \}
    */
-  options: Q.optional(),
+  options: B.optional(),
   /**
    * Cardinality for Doctype fields:
    * - 'one': exactly 1 (default)
@@ -146,14 +153,14 @@ const Q = e.union([
   mask: e.string().optional(),
   // === VALIDATION ===
   /** Validation configuration */
-  validation: W.optional()
+  validation: $.optional()
 }).meta({
   title: "FieldMeta",
   description: "Unified field metadata - the single source of truth for field definitions, works for both forms (AForm) and tables (ATable)"
-}), z = e.enum(["atMostOne", "one", "noneOrMany", "atLeastOne"]).meta({
+}), G = e.enum(["atMostOne", "one", "noneOrMany", "atLeastOne"]).meta({
   title: "Cardinality",
   description: "Cardinality for relationship links between doctypes"
-}), $ = e.object({
+}), V = e.object({
   /** Fetch method type */
   method: e.literal("sync"),
   /** Optional limit on number of records to fetch */
@@ -161,13 +168,13 @@ const Q = e.union([
 }).meta({
   title: "SyncFetch",
   description: "Sync fetch strategy - data is fetched in the initial query"
-}), B = e.object({
+}), Y = 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({
+}), Z = e.object({
   /** Fetch method type */
   method: e.literal("custom"),
   /** Serialized handler function to invoke */
@@ -175,14 +182,14 @@ const Q = e.union([
 }).meta({
   title: "CustomFetch",
   description: "Custom fetch strategy - uses a custom handler function"
-}), V = e.discriminatedUnion("method", [$, B, G]).meta({
+}), K = e.discriminatedUnion("method", [V, Y, Z]).meta({
   title: "FetchStrategy",
   description: "Fetch strategy for link data loading"
-}), Z = e.object({
+}), H = e.object({
   /** Target doctype slug */
   target: e.string().min(1),
   /** Cardinality of the relationship */
-  cardinality: z,
+  cardinality: G,
   /** 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) */
@@ -190,13 +197,13 @@ const Q = e.union([
   /** 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(),
+  fetch: K.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({
+}), X = e.object({
   /** Display label for the action */
   label: e.string().min(1),
   /** Handler function name or path */
@@ -212,11 +219,11 @@ const Q = e.union([
 }).meta({
   title: "ActionDefinition",
   description: "Action definition within a workflow"
-}), K = e.object({
+}), ee = e.object({
   /** List of workflow states */
   states: e.array(e.string()).optional(),
   /** Actions available in this workflow */
-  actions: e.record(e.string(), Y).optional()
+  actions: e.record(e.string(), X).optional()
 }).meta({
   title: "WorkflowMeta",
   description: "Workflow metadata - states and actions for a doctype"
@@ -228,19 +235,19 @@ const Q = e.union([
   /** Database table name */
   tableName: e.string().optional(),
   /** Field definitions (including link fields with fieldtype: 'Link') */
-  fields: e.array(k),
+  fields: e.array(I),
   /** Relationship links to other doctypes */
-  links: e.record(e.string(), Z).optional(),
+  links: e.record(e.string(), H).optional(),
   /** Workflow configuration */
-  workflow: K.optional(),
+  workflow: ee.optional(),
   /** Parent doctype for inheritance */
   inherits: e.string().optional()
 }).meta({
   title: "DoctypeMeta",
   description: "Doctype metadata - complete definition of a doctype"
 });
-function he(t) {
-  const n = k.safeParse(t);
+function De(t) {
+  const n = I.safeParse(t);
   return n.success ? { success: !0, errors: [] } : {
     success: !1,
     errors: n.error.issues.map((o) => ({
@@ -249,7 +256,7 @@ function he(t) {
     }))
   };
 }
-function Ae(t) {
+function Se(t) {
   const n = _.safeParse(t);
   return n.success ? { success: !0, errors: [] } : {
     success: !1,
@@ -259,41 +266,41 @@ function Ae(t) {
     }))
   };
 }
-function Te(t) {
-  return k.parse(t);
+function be(t) {
+  return I.parse(t);
 }
-function De(t) {
+function Ie(t) {
   return _.parse(t);
 }
-function be(t) {
+function ke(t) {
   return t.replace(/_([a-z])/g, (n, o) => o.toUpperCase());
 }
-function Se(t) {
+function Fe(t) {
   return t.replace(/[A-Z]/g, (n) => `_${n.toLowerCase()}`);
 }
-function ke(t) {
+function Ce(t) {
   return t.split("_").map((n) => n.charAt(0).toUpperCase() + n.slice(1).toLowerCase()).join(" ");
 }
-function H(t) {
+function te(t) {
   const n = t.replace(/([A-Z])/g, " $1").trim();
   return n.charAt(0).toUpperCase() + n.slice(1);
 }
-function Fe(t) {
+function Le(t) {
   return t.split(/[-_\s]+/).map((n) => n.charAt(0).toUpperCase() + n.slice(1).toLowerCase()).join("");
 }
 function D(t) {
   return t.replace(/([a-z])([A-Z])/g, "$1-$2").replace(/[\s_]+/g, "-").toLowerCase();
 }
-function X(t) {
+function ne(t) {
   return t.replace(/([a-z])([A-Z])/g, "$1_$2").replace(/[\s-]+/g, "_").toLowerCase();
 }
-const ee = {
+const ie = {
   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" }
-}, te = {
+}, oe = {
   // Arbitrary precision / large numbers
   BigFloat: { component: "ADecimalInput", fieldtype: "Decimal" },
   BigDecimal: { component: "ADecimalInput", fieldtype: "Decimal" },
@@ -313,10 +320,10 @@ const ee = {
   JSON: { component: "ACodeEditor", fieldtype: "JSON" },
   JSONObject: { component: "ACodeEditor", fieldtype: "JSON" },
   JsonNode: { component: "ACodeEditor", fieldtype: "JSON" }
-}, ne = /* @__PURE__ */ new Set(["Cursor"]);
-function ie(t) {
-  const n = { ...te };
-  for (const [o, a] of Object.entries(ee))
+}, ae = /* @__PURE__ */ new Set(["Cursor"]);
+function re(t) {
+  const n = { ...oe };
+  for (const [o, a] of Object.entries(ie))
     n[o] = a;
   if (t)
     for (const [o, a] of Object.entries(t))
@@ -326,7 +333,7 @@ function ie(t) {
       };
   return n;
 }
-const oe = [
+const se = [
   "Connection",
   "Edge",
   "Input",
@@ -342,62 +349,62 @@ const oe = [
   "InsertResponse",
   "UpdateResponse",
   "MutationResponse"
-], ae = /* @__PURE__ */ new Set(["Query", "Mutation", "Subscription"]);
-function re(t, n) {
-  if (t.startsWith("__") || ae.has(t) || t === "Node")
+], ce = /* @__PURE__ */ new Set(["Query", "Mutation", "Subscription"]);
+function le(t, n) {
+  if (t.startsWith("__") || ce.has(t) || t === "Node")
     return !1;
-  for (const a of oe)
+  for (const a of se)
     if (t.endsWith(a))
       return !1;
   const o = n.getFields();
   return Object.keys(o).length !== 0;
 }
-const se = /* @__PURE__ */ new Set(["nodeId", "__typename", "clientMutationId"]);
-function ce(t, n, o) {
-  return !se.has(t);
+const pe = /* @__PURE__ */ new Set(["nodeId", "__typename", "clientMutationId"]);
+function de(t, n, o) {
+  return !pe.has(t);
 }
-function S(t) {
+function b(t) {
   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 le(t) {
+function ue(t) {
   const o = t.getFields().edges;
   if (!o) return;
-  const { namedType: a, isList: r } = S(o.type);
+  const { namedType: a, isList: r } = b(o.type);
   if (!r || !g(a)) return;
   const d = a.getFields().node;
   if (!d) return;
-  const { namedType: u } = S(d.type);
+  const { namedType: u } = b(d.type);
   if (g(u))
     return u.name;
 }
-function pe(t, n, o, a = {}) {
-  const { namedType: r, required: f, isList: d } = S(n.type), u = ie(a.customScalars), i = {
+function me(t, n, o, a = {}) {
+  const { namedType: r, required: f, isList: d } = b(n.type), u = re(a.customScalars), i = {
     fieldname: t,
-    label: H(t),
+    label: te(t),
     component: "ATextInput",
     fieldtype: "Data"
   };
-  if (f && (i.required = !0), v(r)) {
-    if (ne.has(r.name))
+  if (f && (i.required = !0), x(r)) {
+    if (ae.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 (x(r))
+  if (j(r))
     return i.component = "ADropdown", i.fieldtype = "Select", i.options = r.getValues().map((l) => l.name), i;
   if (g(r)) {
     if (!d && o.has(r.name))
       return i.component = "ALink", i.fieldtype = "Link", i.options = D(r.name), i;
-    const l = le(r);
+    const l = ue(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 i._unmapped = !0, a.includeUnmappedMeta && (i._graphqlType = r.name), i;
 }
-function Ie(t, n = {}) {
-  const o = de(t), a = o.getTypeMap(), r = /* @__PURE__ */ new Set(), f = o.getQueryType(), d = o.getMutationType(), u = o.getSubscriptionType();
+function _e(t, n = {}) {
+  const o = fe(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();
+  const i = n.isEntityType ?? le, 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;
@@ -409,11 +416,11 @@ function Ie(t, n = {}) {
     const c = new Set(n.exclude);
     h = new Set([...h].filter((p) => !c.has(p)));
   }
-  const O = n.isEntityField ?? ce, w = n.deriveTableName ?? ((c) => X(c)), F = [];
+  const O = n.isEntityField ?? de, w = n.deriveTableName ?? ((c) => ne(c)), k = [];
   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]) => {
+    const M = p.getFields(), F = n.typeOverrides?.[c], N = Object.entries(M).filter(([s, y]) => O(s, y, p)).map(([s, y]) => {
       if (n.classifyField) {
         const m = n.classifyField(s, y, p);
         if (m != null)
@@ -425,54 +432,57 @@ function Ie(t, n = {}) {
             ...m
           };
       }
-      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] = {
+      const A = me(s, y, l, n);
+      return F?.[s] ? { ...A, ...F[s] } : A;
+    }), S = {}, E = N.filter((s) => s._isLink && typeof s.options == "string" && s.cardinality ? (S[s.fieldname] = {
       target: s.options,
       cardinality: s.cardinality
     }, !1) : !0).map((s) => {
       if (!n.includeUnmappedMeta) {
-        const { _graphqlType: m, _unmapped: ue, _isLink: me, ...j } = s;
-        return j;
+        const { _graphqlType: m, _unmapped: ye, _isLink: ge, ...v } = s;
+        return v;
       }
-      const { _isLink: y, ...T } = s;
-      return T;
-    }), A = {
+      const { _isLink: y, ...A } = s;
+      return A;
+    }), T = {
       name: c,
       slug: D(c),
       fields: E
     };
-    Object.keys(b).length > 0 && (A.links = b);
+    Object.keys(S).length > 0 && (T.links = S);
     const C = w(c);
-    C && (A.tableName = C), n.includeUnmappedMeta && (A._graphqlTypeName = c), F.push(A);
+    C && (T.tableName = C), n.includeUnmappedMeta && (T._graphqlTypeName = c), k.push(T);
   }
-  return F;
+  return k;
 }
-function de(t) {
-  return typeof t == "string" ? q(t) : P(t);
+function fe(t) {
+  return typeof t == "string" ? P(t) : q(t);
 }
 export {
-  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
+  R as B,
+  ie as G,
+  ae as I,
+  J as S,
+  W as T,
+  oe as W,
+  Fe as a,
+  re as b,
+  te as c,
+  me as d,
+  _e as e,
+  de as f,
+  le as g,
+  z as h,
+  Q as i,
+  be as j,
+  ne as k,
+  Ce as l,
+  D as m,
+  De as n,
+  Ie as p,
+  Ae as r,
+  ke as s,
+  Le as t,
+  Se as v
 };
-//# sourceMappingURL=index-CLc5mUMQ.js.map
+//# sourceMappingURL=index-DqxTn6jG.js.map