@stonecrop/schema 0.13.14 → 0.15.0

package/dist/index.js

@@ -1,34 +1,73 @@
-import { B as s, D as l, F as i, G as t, I as o, S as c, T as d, a as p, b as S, V as T, W as n, c as F, d as m, e as L, f as r, g as y, h as A, i as C, j as _, k as f, p as h, l as u, m as E, r as I, s as b, n as D, t as k, o as v, v as N, q as P } from "./index-D66L9JNw.js";
+import { A as d, D as A, F as p, G as S, I as T, T as m, a as u, b as L, V as N, W as y, c as C, d as F, e as f, f as k, g as O, h as b, i as D, j as x, k as E, l as h, n as I, p as _, m as M, o as g, s as v, q as P, t as R, r as w, v as W, u as G } from "./index-rozX0Luh.js";
+const a = {
+  ATextInput: "text",
+  ATextarea: "text",
+  ANumericInput: "number",
+  ACheckbox: "boolean",
+  ADate: "date",
+  ADatePicker: "date",
+  ADateSelection: "date",
+  ADateTime: "datetime",
+  ADuration: "text",
+  ADateRange: "date",
+  ADropdown: "select",
+  ACodeEditor: "code",
+  AFormLink: "link",
+  AFileAttach: "attach"
+};
+function o(e) {
+  return e ? a[e] : void 0;
+}
+const t = {
+  AFormLink: "inline",
+  AForm: "expand",
+  ATable: "expand"
+};
+function i(e) {
+  return e ? t[e] : void 0;
+}
+function s(e, n) {
+  return i(e.component ?? n) === "inline" ? "inline" : e.cardinality === "noneOrMany" || e.cardinality === "atLeastOne" ? "table" : "record";
+}
+const l = [
+  .../* @__PURE__ */ new Set([...Object.keys(a), ...Object.keys(t)])
+].toSorted();
 export {
-  s as BUILTIN_FIELD_TYPES,
-  l as DoctypeFieldSchema,
-  i as FieldsetFieldSchema,
-  t as GQL_SCALAR_MAP,
-  o as INTERNAL_SCALARS,
-  c as StonecropFieldType,
-  d as TYPE_MAP,
-  p as TableFieldSchema,
-  S as TableViewConfig,
-  T as ValueFieldSchema,
-  n as WELL_KNOWN_SCALARS,
-  F as buildScalarMap,
-  m as camelToLabel,
-  L as camelToSnake,
-  r as classifyFieldType,
-  y as convertGraphQLSchema,
-  A as defaultIsEntityField,
-  C as defaultIsEntityType,
-  _ as getDefaultComponent,
-  f as isBuiltinFieldType,
-  h as parseDoctype,
-  u as parseField,
-  E as pascalToSnake,
-  I as resolveComponent,
-  b as snakeToCamel,
-  D as snakeToLabel,
-  k as toPascalCase,
-  v as toSlug,
-  N as validateDoctype,
-  P as validateField
+  d as ActionDefinition,
+  l as CANONICAL_COMPONENTS,
+  a as COMPONENT_CATEGORY,
+  t as COMPONENT_LINK_EXPANSION,
+  A as DoctypeFieldSchema,
+  p as FieldsetFieldSchema,
+  S as GQL_SCALAR_MAP,
+  T as INTERNAL_SCALARS,
+  m as TableFieldSchema,
+  u as TableViewConfig,
+  L as TriggerDefinition,
+  N as ValueFieldSchema,
+  y as WELL_KNOWN_SCALARS,
+  C as WorkflowLayout,
+  F as WorkflowMeta,
+  f as buildScalarMap,
+  k as camelToLabel,
+  O as camelToSnake,
+  b as classifyFieldType,
+  o as componentCategory,
+  i as componentLinkExpansion,
+  D as convertGraphQLSchema,
+  x as defaultIsEntityField,
+  E as defaultIsEntityType,
+  h as isActionAllowedInState,
+  I as normalizeFieldKind,
+  _ as parseDoctype,
+  M as parseField,
+  g as pascalToSnake,
+  s as resolveLinkRenderMode,
+  v as snakeToCamel,
+  P as snakeToLabel,
+  R as toPascalCase,
+  w as toSlug,
+  W as validateDoctype,
+  G as validateField
 };
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sources":[],"sourcesContent":[],"names":[],"mappings":";"}
+{"version":3,"file":"index.js","sources":["../src/component-meta.ts"],"sourcesContent":["/**\n * Semantic category for a rendering component.\n *\n * `component` is the primary field axis, so the runtime consumers that need to know what a field\n * *means* (atable cell formatting / filter widgets, record-default init) derive it from here. This\n * is the single source of \"what kind of value does this component render\", keyed by the canonical\n * registered component names — each consumer maps the category to its own concern (filter widget,\n * default value, …).\n *\n * @public\n */\nexport type ComponentCategory =\n\t'text' | 'number' | 'boolean' | 'date' | 'datetime' | 'select' | 'code' | 'link' | 'attach'\n\n/**\n * Canonical component → semantic category. Only the components Stonecrop ships with appear here;\n * custom/unknown component names have no category and consumers fall back to their default.\n * @public\n */\nexport const COMPONENT_CATEGORY: Record<string, ComponentCategory> = {\n\tATextInput: 'text',\n\tATextarea: 'text',\n\tANumericInput: 'number',\n\tACheckbox: 'boolean',\n\tADate: 'date',\n\tADatePicker: 'date',\n\tADateSelection: 'date',\n\tADateTime: 'datetime',\n\tADuration: 'text',\n\tADateRange: 'date',\n\tADropdown: 'select',\n\tACodeEditor: 'code',\n\tAFormLink: 'link',\n\tAFileAttach: 'attach',\n}\n\n/**\n * Resolve a component's semantic category, or `undefined` for an unknown (custom) component —\n * callers treat that as \"no opinion\" and use their own default.\n * @public\n */\nexport function componentCategory(component?: string): ComponentCategory | undefined {\n\treturn component ? COMPONENT_CATEGORY[component] : undefined\n}\n\n/**\n * Whether a link component expands its target doctype, or renders the link inline.\n *\n * This is the *only* axis the component decides. It deliberately does not choose between an\n * embedded record and an embedded table: `cardinality` states whether the value is a scalar or\n * an array, which is a fact about the data rather than a rendering preference, so a component\n * must not be able to override it (an `AForm` over a `noneOrMany` link would be handed an array\n * it cannot render). Component names encode both axes — `AFormLink`/`ATableLink` are the inline\n * pair, `AForm`/`ATable` the expanding pair — but only the inline/expand half is authoritative.\n *\n * @public\n */\nexport type LinkExpansion = 'inline' | 'expand'\n\n/**\n * Canonical link component → expansion. Only components Stonecrop ships with appear here; an\n * unmapped (custom) component has none, and callers treat that as `expand` — the behaviour that\n * predates this map, so a custom component can never silently collapse a link to a picker.\n * @public\n */\nexport const COMPONENT_LINK_EXPANSION: Record<string, LinkExpansion> = {\n\tAFormLink: 'inline',\n\tAForm: 'expand',\n\tATable: 'expand',\n}\n\n/**\n * Resolve a component's link expansion, or `undefined` for an absent/unmapped component.\n * @public\n */\nexport function componentLinkExpansion(component?: string): LinkExpansion | undefined {\n\treturn component ? COMPONENT_LINK_EXPANSION[component] : undefined\n}\n\n/**\n * How a link field renders.\n *\n * - `inline` — a scalar id-picker; the target is *not* expanded (the field keeps its own value\n *   and carries a `doctype` prop for async display-text resolution and navigation).\n * - `record` — the target doctype is resolved and embedded as a nested form.\n * - `table` — the target doctype is resolved and embedded as a child table.\n *\n * @public\n */\nexport type LinkRenderMode = 'inline' | 'record' | 'table'\n\n/**\n * Decide how a *declared* link (one with a `LinkDeclaration`) renders.\n *\n * Two independent axes: the **component** picks inline vs expand, and when expanding the\n * **cardinality** picks record vs table (many → table). The declaration's component wins over the\n * field's, matching the precedence the resolver already uses for the rendered component.\n *\n * This is the single definition of \"does this link expand\" — it is consumed by both the client\n * resolver (which builds the nested schema) and the server column builder (which must still\n * SELECT an `inline` link's FK column). Call it; never re-derive the rule at the call site, or\n * the two will drift and the client will render a table for a column the server never selected.\n *\n * @param link - the link declaration (only `component` and `cardinality` are consulted)\n * @param fieldComponent - the linked field's own `component`, used when the declaration names none\n * @public\n */\nexport function resolveLinkRenderMode(\n\tlink: { component?: string; cardinality?: string },\n\tfieldComponent?: string\n): LinkRenderMode {\n\tif (componentLinkExpansion(link.component ?? fieldComponent) === 'inline') return 'inline'\n\treturn link.cardinality === 'noneOrMany' || link.cardinality === 'atLeastOne' ? 'table' : 'record'\n}\n\n/**\n * Every component Stonecrop ships with that can render a value field, sorted by name.\n *\n * The union of the two maps above is the definition, not a copy of it: a shipped component either\n * categorises a value ({@link COMPONENT_CATEGORY}) or is one of the link containers that has no\n * value of its own ({@link COMPONENT_LINK_EXPANSION}'s `AForm`/`ATable`). `AFieldset` is absent by\n * the same rule — it is a `kind: 'fieldset'` container, so it is never a value field's component.\n *\n * `component` is an **open** axis: any string is valid, and naming a custom component is how an app\n * renders a field Stonecrop ships no widget for. This list is therefore the set to *suggest* to an\n * author, and to check first-party data against — never a set to validate arbitrary input against.\n *\n * @public\n */\nexport const CANONICAL_COMPONENTS: readonly string[] = [\n\t...new Set([...Object.keys(COMPONENT_CATEGORY), ...Object.keys(COMPONENT_LINK_EXPANSION)]),\n].toSorted()\n"],"names":["COMPONENT_CATEGORY","componentCategory","component","COMPONENT_LINK_EXPANSION","componentLinkExpansion","resolveLinkRenderMode","link","fieldComponent","CANONICAL_COMPONENTS"],"mappings":";AAmBO,MAAMA,IAAwD;AAAA,EACpE,YAAY;AAAA,EACZ,WAAW;AAAA,EACX,eAAe;AAAA,EACf,WAAW;AAAA,EACX,OAAO;AAAA,EACP,aAAa;AAAA,EACb,gBAAgB;AAAA,EAChB,WAAW;AAAA,EACX,WAAW;AAAA,EACX,YAAY;AAAA,EACZ,WAAW;AAAA,EACX,aAAa;AAAA,EACb,WAAW;AAAA,EACX,aAAa;AACd;AAOO,SAASC,EAAkBC,GAAmD;AACpF,SAAOA,IAAYF,EAAmBE,CAAS,IAAI;AACpD;AAsBO,MAAMC,IAA0D;AAAA,EACtE,WAAW;AAAA,EACX,OAAO;AAAA,EACP,QAAQ;AACT;AAMO,SAASC,EAAuBF,GAA+C;AACrF,SAAOA,IAAYC,EAAyBD,CAAS,IAAI;AAC1D;AA8BO,SAASG,EACfC,GACAC,GACiB;AACjB,SAAIH,EAAuBE,EAAK,aAAaC,CAAc,MAAM,WAAiB,WAC3ED,EAAK,gBAAgB,gBAAgBA,EAAK,gBAAgB,eAAe,UAAU;AAC3F;AAgBO,MAAME,IAA0C;AAAA,EACtD,GAAG,oBAAI,IAAI,CAAC,GAAG,OAAO,KAAKR,CAAkB,GAAG,GAAG,OAAO,KAAKG,CAAwB,CAAC,CAAC;AAC1F,EAAE,SAAA;"}