@stonecrop/schema 0.30.0 → 0.32.0

package/dist/index.js

@@ -1,131 +1,137 @@
-import { A as F, D as T, F as N, G as C, I as D, b as E, L as I, T as L, d as _, e as h, V as p, W as P, g as B, h as R, i as j, j as M, k as w, l as K, n as G, o as x, c as k, q as V, r as W, f as Y, t as z, u as Q, w as J, x as X, y as q, z as H, B as U, C as Z, m as $, E as ee, H as re, J as ae, K as te, p as ie, M as ne, N as se, s as le, O as fe, P as oe, v as ce, Q as de } from "./validation-C9P__pRF.js";
-import { C as ge, a as Ae, b as ye, c as Se, d as be, r as ve, u as Oe } from "./record-Bc0lI9Rq.js";
-import { f as Fe } from "./flatten-C1MjkzFh.js";
-const c = /* @__PURE__ */ new Set(["neutral", "success", "warning", "danger", "brand"]), d = /* @__PURE__ */ new Set(["variant", "color", "label"]);
-function t(e) {
-  return !Array.isArray(e);
+import { A as snakeToCamel, B as getPrimaryKeyField, C as WorkflowMeta, D as camelToLabel, E as linkDisplayFieldname, F as FieldsetFieldSchema, G as stripFieldKind, H as getRecordIdentity, I as INTROSPECTED_IDENTITY_PROPS, K as TableViewConfig, L as TableFieldSchema, M as toPascalCase, N as toSlug, O as camelToSnake, P as DoctypeFieldSchema, R as ValueFieldSchema, S as WorkflowLayout, T as isActionAllowedInState, U as inferFieldKind, V as getRecordIdField, W as normalizeFieldKind, _ as validateDoctype, a as aggregateDoctypeName, b as LINK_DISPLAY_SUFFIX, c as classifyFieldType, d as GQL_SCALAR_MAP, f as INTERNAL_SCALARS, g as parseField, h as parseDoctype, j as snakeToLabel, k as pascalToSnake, l as defaultIsEntityField, m as buildScalarMap, n as formatDoctypeDrift, o as buildAggregateDoctype, p as WELL_KNOWN_SCALARS, r as mergeIntrospectedDoctype, s as planGeneration, t as convertGraphQLSchema, u as defaultIsEntityType, v as validateField, w as getDoctypeSlug, x as TriggerDefinition, y as ActionDefinition, z as getDisplayField } from "./converter-CLwduvT_.js";
+import { a as componentCategory, i as COMPONENT_LINK_EXPANSION, n as CANONICAL_COMPONENTS, o as componentLinkExpansion, r as COMPONENT_CATEGORY, s as resolveLinkRenderMode, t as unwrapInlineLinks } from "./record-BQOOi83C.js";
+import { t as flattenFields } from "./flatten-Bx2cfvw3.js";
+//#region src/badge.ts
+var BADGE_VARIANTS = /* @__PURE__ */ new Set([
+	"neutral",
+	"success",
+	"warning",
+	"danger",
+	"brand"
+]);
+var BADGE_SPEC_OBJECT_KEYS = /* @__PURE__ */ new Set([
+	"variant",
+	"color",
+	"label"
+]);
+function isOptionsRecord(options) {
+	return !Array.isArray(options);
 }
-function n(e) {
-  return typeof e == "string" && c.has(e);
+function isBadgeVariant(value) {
+	return typeof value === "string" && BADGE_VARIANTS.has(value);
 }
-function f(e) {
-  if (e === null || typeof e != "object" || Array.isArray(e)) return !1;
-  for (const a of Object.keys(e))
-    if (!d.has(a)) return !1;
-  const r = e;
-  return !(r.variant !== void 0 && !n(r.variant) || r.color !== void 0 && typeof r.color != "string" || r.label !== void 0 && typeof r.label != "string");
+function isBadgeSpecObject(value) {
+	if (value === null || typeof value !== "object" || Array.isArray(value)) return false;
+	for (const key of Object.keys(value)) if (!BADGE_SPEC_OBJECT_KEYS.has(key)) return false;
+	const obj = value;
+	if (obj.variant !== void 0 && !isBadgeVariant(obj.variant)) return false;
+	if (obj.color !== void 0 && typeof obj.color !== "string") return false;
+	if (obj.label !== void 0 && typeof obj.label !== "string") return false;
+	return true;
 }
-function l(e) {
-  return n(e) || f(e);
+function isBadgeSpec(value) {
+	return isBadgeVariant(value) || isBadgeSpecObject(value);
 }
-function i(e) {
-  return Array.isArray(e.choices);
+/**
+* Narrows an options record to the structured `{ choices, badges }` form. A type predicate rather
+* than a cast: `SelectOptions` requires `choices`, so asserting into it trips `no-unsafe-type-assertion`.
+*/
+function isStructuredSelectOptions(options) {
+	return Array.isArray(options.choices);
 }
-function A(e) {
-  if (e === null || typeof e != "object" || Array.isArray(e)) return !1;
-  const r = e;
-  return !(typeof r.label != "string" || r.variant !== void 0 && !n(r.variant) || r.color !== void 0 && typeof r.color != "string");
+/**
+* True when `value` is a resolved badge descriptor for ACell / ADropdown.
+* @public
+*/
+function isBadgeDescriptor(value) {
+	if (value === null || typeof value !== "object" || Array.isArray(value)) return false;
+	const obj = value;
+	if (typeof obj.label !== "string") return false;
+	if (obj.variant !== void 0 && !isBadgeVariant(obj.variant)) return false;
+	if (obj.color !== void 0 && typeof obj.color !== "string") return false;
+	return true;
 }
-function s(e) {
-  if (e === void 0 || Array.isArray(e) || !t(e)) return !1;
-  if (i(e)) {
-    const a = e.badges;
-    return a === void 0 ? !1 : Object.values(a).every(l);
-  }
-  const r = Object.entries(e);
-  return r.length === 0 ? !1 : r.every(([, a]) => l(a));
+/**
+* True when `options` is a Select choice map (`{ Open: "warning", ... }` or
+* `{ choices: [...], badges: {...} }`), not a quantity/currency/code config bag.
+* @public
+*/
+function isSelectChoiceMap(options) {
+	if (options === void 0 || Array.isArray(options) || !isOptionsRecord(options)) return false;
+	if (isStructuredSelectOptions(options)) {
+		const badges = options.badges;
+		if (badges === void 0) return false;
+		return Object.values(badges).every(isBadgeSpec);
+	}
+	const entries = Object.entries(options);
+	if (entries.length === 0) return false;
+	return entries.every(([, value]) => isBadgeSpec(value));
 }
-function y(e) {
-  return e === void 0 || Array.isArray(e) || !t(e) ? !1 : i(e);
+/**
+* True when `options` uses the structured SelectOptions shape.
+* @public
+*/
+function isSelectOptions(options) {
+	if (options === void 0 || Array.isArray(options) || !isOptionsRecord(options)) return false;
+	return isStructuredSelectOptions(options);
 }
-function S(e) {
-  return e === void 0 ? [] : Array.isArray(e) ? e : t(e) ? i(e) ? e.choices : s(e) ? Object.keys(e) : [] : [];
+/**
+* Dropdown / filter choice strings.
+* @public
+*/
+function selectChoices(options) {
+	if (options === void 0) return [];
+	if (Array.isArray(options)) return options;
+	if (!isOptionsRecord(options)) return [];
+	if (isStructuredSelectOptions(options)) return options.choices;
+	if (isSelectChoiceMap(options)) return Object.keys(options);
+	return [];
 }
-function o(e, r) {
-  return n(e) ? { label: r, variant: e } : f(e) ? {
-    label: e.label ?? r,
-    variant: e.variant,
-    color: e.color
-  } : { label: r };
+function normalizeBadgeSpec(spec, key) {
+	if (isBadgeVariant(spec)) return {
+		label: key,
+		variant: spec
+	};
+	if (!isBadgeSpecObject(spec)) return { label: key };
+	return {
+		label: spec.label ?? key,
+		variant: spec.variant,
+		color: spec.color
+	};
 }
-function u(e, r) {
-  if (!(r === void 0 || r === "") && r in e)
-    return o(e[r], r);
+function lookupFromBareMap(map, key) {
+	if (key === void 0 || key === "") return void 0;
+	if (!(key in map)) return void 0;
+	return normalizeBadgeSpec(map[key], key);
 }
-function g(e, r) {
-  if (r === void 0 || r === "") return;
-  const a = e.badges;
-  if (!(!a || !(r in a)))
-    return o(a[r], r);
+function lookupFromStructured(options, key) {
+	if (key === void 0 || key === "") return void 0;
+	const badges = options.badges;
+	if (!badges || !(key in badges)) return void 0;
+	return normalizeBadgeSpec(badges[key], key);
 }
-function b(e, r) {
-  if (!(e === void 0 || r === void 0 || r === "") && !Array.isArray(e) && t(e)) {
-    if (i(e)) return g(e, r);
-    if (s(e)) return u(e, r);
-  }
+/**
+* Resolve a stored choice value to a badge descriptor using field options.
+* @public
+*/
+function lookupBadge(options, key) {
+	if (options === void 0 || key === void 0 || key === "") return void 0;
+	if (Array.isArray(options)) return void 0;
+	if (!isOptionsRecord(options)) return void 0;
+	if (isStructuredSelectOptions(options)) return lookupFromStructured(options, key);
+	if (isSelectChoiceMap(options)) return lookupFromBareMap(options, key);
 }
-function v(e) {
-  return e === void 0 || Array.isArray(e) || !t(e) ? !1 : i(e) ? e.badges !== void 0 && Object.keys(e.badges).length > 0 : s(e);
+/**
+* Whether field options carry any badge mapping.
+* @public
+*/
+function hasBadgeOptions(options) {
+	if (options === void 0 || Array.isArray(options)) return false;
+	if (!isOptionsRecord(options)) return false;
+	if (isStructuredSelectOptions(options)) return options.badges !== void 0 && Object.keys(options.badges).length > 0;
+	return isSelectChoiceMap(options);
 }
-export {
-  F as ActionDefinition,
-  ge as CANONICAL_COMPONENTS,
-  Ae as COMPONENT_CATEGORY,
-  ye as COMPONENT_LINK_EXPANSION,
-  T as DoctypeFieldSchema,
-  N as FieldsetFieldSchema,
-  C as GQL_SCALAR_MAP,
-  D as INTERNAL_SCALARS,
-  E as INTROSPECTED_IDENTITY_PROPS,
-  I as LINK_DISPLAY_SUFFIX,
-  L as TableFieldSchema,
-  _ as TableViewConfig,
-  h as TriggerDefinition,
-  p as ValueFieldSchema,
-  P as WELL_KNOWN_SCALARS,
-  B as WorkflowLayout,
-  R as WorkflowMeta,
-  j as aggregateDoctypeName,
-  M as buildAggregateDoctype,
-  w as buildScalarMap,
-  K as camelToLabel,
-  G as camelToSnake,
-  x as classifyFieldType,
-  Se as componentCategory,
-  be as componentLinkExpansion,
-  k as convertGraphQLSchema,
-  V as defaultIsEntityField,
-  W as defaultIsEntityType,
-  Fe as flattenFields,
-  Y as formatDoctypeDrift,
-  z as getDisplayField,
-  Q as getDoctypeSlug,
-  J as getPrimaryKeyField,
-  X as getRecordIdField,
-  q as getRecordIdentity,
-  v as hasBadgeOptions,
-  H as inferFieldKind,
-  U as isActionAllowedInState,
-  A as isBadgeDescriptor,
-  s as isSelectChoiceMap,
-  y as isSelectOptions,
-  Z as linkDisplayFieldname,
-  b as lookupBadge,
-  $ as mergeIntrospectedDoctype,
-  ee as normalizeFieldKind,
-  re as parseDoctype,
-  ae as parseField,
-  te as pascalToSnake,
-  ie as planGeneration,
-  ve as resolveLinkRenderMode,
-  S as selectChoices,
-  ne as snakeToCamel,
-  se as snakeToLabel,
-  le as stripFieldKind,
-  fe as toPascalCase,
-  oe as toSlug,
-  Oe as unwrapInlineLinks,
-  ce as validateDoctype,
-  de as validateField
-};
-//# sourceMappingURL=index.js.map
+//#endregion
+export { ActionDefinition, CANONICAL_COMPONENTS, COMPONENT_CATEGORY, COMPONENT_LINK_EXPANSION, DoctypeFieldSchema, FieldsetFieldSchema, GQL_SCALAR_MAP, INTERNAL_SCALARS, INTROSPECTED_IDENTITY_PROPS, LINK_DISPLAY_SUFFIX, TableFieldSchema, TableViewConfig, TriggerDefinition, ValueFieldSchema, WELL_KNOWN_SCALARS, WorkflowLayout, WorkflowMeta, aggregateDoctypeName, buildAggregateDoctype, buildScalarMap, camelToLabel, camelToSnake, classifyFieldType, componentCategory, componentLinkExpansion, convertGraphQLSchema, defaultIsEntityField, defaultIsEntityType, flattenFields, formatDoctypeDrift, getDisplayField, getDoctypeSlug, getPrimaryKeyField, getRecordIdField, getRecordIdentity, hasBadgeOptions, inferFieldKind, isActionAllowedInState, isBadgeDescriptor, isSelectChoiceMap, isSelectOptions, linkDisplayFieldname, lookupBadge, mergeIntrospectedDoctype, normalizeFieldKind, parseDoctype, parseField, pascalToSnake, planGeneration, resolveLinkRenderMode, selectChoices, snakeToCamel, snakeToLabel, stripFieldKind, toPascalCase, toSlug, unwrapInlineLinks, validateDoctype, validateField };
+
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sources":["../src/badge.ts"],"sourcesContent":["import type { FieldOptions } from './field'\n\n/**\n * Semantic badge variant. Maps to theme tokens `--sc-badge-{variant}-*`.\n * @public\n */\nexport type BadgeVariant = 'neutral' | 'success' | 'warning' | 'danger' | 'brand'\n\n/**\n * Where ABadge paints the same descriptor.\n * @public\n */\nexport type BadgePresentation = 'cell-fill' | 'input-accent'\n\n/**\n * Per-choice badge configuration in a Select options map.\n * @public\n */\nexport interface BadgeSpecObject {\n\tvariant?: BadgeVariant\n\tcolor?: string\n\tlabel?: string\n}\n\n/**\n * Value in a choice→badge map: shorthand variant or object form.\n * @public\n */\nexport type BadgeSpec = BadgeVariant | BadgeSpecObject\n\n/**\n * Select field options when choices carry badge colors.\n * @public\n */\nexport interface SelectOptions extends Record<string, unknown> {\n\tchoices: string[]\n\tbadges?: Record<string, BadgeSpec>\n}\n\n/**\n * Resolved badge for rendering. Returned by `format` or built from an options map.\n * @public\n */\nexport interface BadgeDescriptor {\n\tlabel: string\n\tvariant?: BadgeVariant\n\tcolor?: string\n}\n\nconst BADGE_VARIANTS = new Set<string>(['neutral', 'success', 'warning', 'danger', 'brand'])\n\nconst BADGE_SPEC_OBJECT_KEYS = new Set(['variant', 'color', 'label'])\n\nfunction isOptionsRecord(options: FieldOptions): options is Record<string, unknown> {\n\treturn !Array.isArray(options)\n}\n\nfunction isBadgeVariant(value: unknown): value is BadgeVariant {\n\treturn typeof value === 'string' && BADGE_VARIANTS.has(value)\n}\n\nfunction isBadgeSpecObject(value: unknown): value is BadgeSpecObject {\n\tif (value === null || typeof value !== 'object' || Array.isArray(value)) return false\n\tfor (const key of Object.keys(value)) {\n\t\tif (!BADGE_SPEC_OBJECT_KEYS.has(key)) return false\n\t}\n\tconst obj = value as BadgeSpecObject\n\tif (obj.variant !== undefined && !isBadgeVariant(obj.variant)) return false\n\tif (obj.color !== undefined && typeof obj.color !== 'string') return false\n\tif (obj.label !== undefined && typeof obj.label !== 'string') return false\n\treturn true\n}\n\nfunction isBadgeSpec(value: unknown): value is BadgeSpec {\n\treturn isBadgeVariant(value) || isBadgeSpecObject(value)\n}\n\n/**\n * Narrows an options record to the structured `{ choices, badges }` form. A type predicate rather\n * than a cast: `SelectOptions` requires `choices`, so asserting into it trips `no-unsafe-type-assertion`.\n */\nfunction isStructuredSelectOptions(options: Record<string, unknown>): options is SelectOptions {\n\treturn Array.isArray(options.choices)\n}\n\n/**\n * True when `value` is a resolved badge descriptor for ACell / ADropdown.\n * @public\n */\nexport function isBadgeDescriptor(value: unknown): value is BadgeDescriptor {\n\tif (value === null || typeof value !== 'object' || Array.isArray(value)) return false\n\t// Partial<> keeps this a widening assertion; asserting into BadgeDescriptor itself (required\n\t// `label`) narrows, which `no-unsafe-type-assertion` rejects.\n\tconst obj = value as Partial<BadgeDescriptor>\n\tif (typeof obj.label !== 'string') return false\n\tif (obj.variant !== undefined && !isBadgeVariant(obj.variant)) return false\n\tif (obj.color !== undefined && typeof obj.color !== 'string') return false\n\treturn true\n}\n\n/**\n * True when `options` is a Select choice map (`{ Open: \"warning\", ... }` or\n * `{ choices: [...], badges: {...} }`), not a quantity/currency/code config bag.\n * @public\n */\nexport function isSelectChoiceMap(options: FieldOptions | undefined): options is Record<string, BadgeSpec> {\n\tif (options === undefined || Array.isArray(options) || !isOptionsRecord(options)) return false\n\tif (isStructuredSelectOptions(options)) {\n\t\tconst badges = options.badges\n\t\tif (badges === undefined) return false\n\t\treturn Object.values(badges).every(isBadgeSpec)\n\t}\n\tconst entries = Object.entries(options)\n\tif (entries.length === 0) return false\n\treturn entries.every(([, value]) => isBadgeSpec(value))\n}\n\n/**\n * True when `options` uses the structured SelectOptions shape.\n * @public\n */\nexport function isSelectOptions(options: FieldOptions | undefined): options is SelectOptions {\n\tif (options === undefined || Array.isArray(options) || !isOptionsRecord(options)) return false\n\treturn isStructuredSelectOptions(options)\n}\n\n/**\n * Dropdown / filter choice strings.\n * @public\n */\nexport function selectChoices(options: FieldOptions | undefined): string[] {\n\tif (options === undefined) return []\n\tif (Array.isArray(options)) return options\n\tif (!isOptionsRecord(options)) return []\n\tif (isStructuredSelectOptions(options)) return options.choices\n\tif (isSelectChoiceMap(options)) return Object.keys(options)\n\treturn []\n}\n\nfunction normalizeBadgeSpec(spec: unknown, key: string): BadgeDescriptor {\n\tif (isBadgeVariant(spec)) {\n\t\treturn { label: key, variant: spec }\n\t}\n\t// A malformed spec still names a real choice, so keep the label and drop only the styling.\n\t// Reading `.variant`/`.color` off an unvalidated value is what let a misspelt variant reach the\n\t// DOM as an unmatched class, and threw outright on null.\n\tif (!isBadgeSpecObject(spec)) {\n\t\treturn { label: key }\n\t}\n\treturn {\n\t\tlabel: spec.label ?? key,\n\t\tvariant: spec.variant,\n\t\tcolor: spec.color,\n\t}\n}\n\nfunction lookupFromBareMap(map: Record<string, BadgeSpec>, key: string | undefined): BadgeDescriptor | undefined {\n\tif (key === undefined || key === '') return undefined\n\tif (!(key in map)) return undefined\n\treturn normalizeBadgeSpec(map[key], key)\n}\n\nfunction lookupFromStructured(options: SelectOptions, key: string | undefined): BadgeDescriptor | undefined {\n\tif (key === undefined || key === '') return undefined\n\tconst badges = options.badges\n\tif (!badges || !(key in badges)) return undefined\n\treturn normalizeBadgeSpec(badges[key], key)\n}\n\n/**\n * Resolve a stored choice value to a badge descriptor using field options.\n * @public\n */\nexport function lookupBadge(options: FieldOptions | undefined, key: string | undefined): BadgeDescriptor | undefined {\n\tif (options === undefined || key === undefined || key === '') return undefined\n\tif (Array.isArray(options)) return undefined\n\tif (!isOptionsRecord(options)) return undefined\n\tif (isStructuredSelectOptions(options)) return lookupFromStructured(options, key)\n\tif (isSelectChoiceMap(options)) return lookupFromBareMap(options, key)\n\treturn undefined\n}\n\n/**\n * Whether field options carry any badge mapping.\n * @public\n */\nexport function hasBadgeOptions(options: FieldOptions | undefined): boolean {\n\tif (options === undefined || Array.isArray(options)) return false\n\tif (!isOptionsRecord(options)) return false\n\tif (isStructuredSelectOptions(options)) return options.badges !== undefined && Object.keys(options.badges).length > 0\n\treturn isSelectChoiceMap(options)\n}\n"],"names":["BADGE_VARIANTS","BADGE_SPEC_OBJECT_KEYS","isOptionsRecord","options","isBadgeVariant","value","isBadgeSpecObject","key","obj","isBadgeSpec","isStructuredSelectOptions","isBadgeDescriptor","isSelectChoiceMap","badges","entries","isSelectOptions","selectChoices","normalizeBadgeSpec","spec","lookupFromBareMap","map","lookupFromStructured","lookupBadge","hasBadgeOptions"],"mappings":"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"}
+{"version":3,"file":"index.js","names":[],"sources":["../src/badge.ts"],"sourcesContent":["import type { FieldOptions } from './field'\n\n/**\n * Semantic badge variant. Maps to theme tokens `--sc-badge-{variant}-*`.\n * @public\n */\nexport type BadgeVariant = 'neutral' | 'success' | 'warning' | 'danger' | 'brand'\n\n/**\n * Where ABadge paints the same descriptor.\n * @public\n */\nexport type BadgePresentation = 'cell-fill' | 'input-accent'\n\n/**\n * Per-choice badge configuration in a Select options map.\n * @public\n */\nexport interface BadgeSpecObject {\n\tvariant?: BadgeVariant\n\tcolor?: string\n\tlabel?: string\n}\n\n/**\n * Value in a choice→badge map: shorthand variant or object form.\n * @public\n */\nexport type BadgeSpec = BadgeVariant | BadgeSpecObject\n\n/**\n * Select field options when choices carry badge colors.\n * @public\n */\nexport interface SelectOptions extends Record<string, unknown> {\n\tchoices: string[]\n\tbadges?: Record<string, BadgeSpec>\n}\n\n/**\n * Resolved badge for rendering. Returned by `format` or built from an options map.\n * @public\n */\nexport interface BadgeDescriptor {\n\tlabel: string\n\tvariant?: BadgeVariant\n\tcolor?: string\n}\n\nconst BADGE_VARIANTS = new Set<string>(['neutral', 'success', 'warning', 'danger', 'brand'])\n\nconst BADGE_SPEC_OBJECT_KEYS = new Set(['variant', 'color', 'label'])\n\nfunction isOptionsRecord(options: FieldOptions): options is Record<string, unknown> {\n\treturn !Array.isArray(options)\n}\n\nfunction isBadgeVariant(value: unknown): value is BadgeVariant {\n\treturn typeof value === 'string' && BADGE_VARIANTS.has(value)\n}\n\nfunction isBadgeSpecObject(value: unknown): value is BadgeSpecObject {\n\tif (value === null || typeof value !== 'object' || Array.isArray(value)) return false\n\tfor (const key of Object.keys(value)) {\n\t\tif (!BADGE_SPEC_OBJECT_KEYS.has(key)) return false\n\t}\n\tconst obj = value as BadgeSpecObject\n\tif (obj.variant !== undefined && !isBadgeVariant(obj.variant)) return false\n\tif (obj.color !== undefined && typeof obj.color !== 'string') return false\n\tif (obj.label !== undefined && typeof obj.label !== 'string') return false\n\treturn true\n}\n\nfunction isBadgeSpec(value: unknown): value is BadgeSpec {\n\treturn isBadgeVariant(value) || isBadgeSpecObject(value)\n}\n\n/**\n * Narrows an options record to the structured `{ choices, badges }` form. A type predicate rather\n * than a cast: `SelectOptions` requires `choices`, so asserting into it trips `no-unsafe-type-assertion`.\n */\nfunction isStructuredSelectOptions(options: Record<string, unknown>): options is SelectOptions {\n\treturn Array.isArray(options.choices)\n}\n\n/**\n * True when `value` is a resolved badge descriptor for ACell / ADropdown.\n * @public\n */\nexport function isBadgeDescriptor(value: unknown): value is BadgeDescriptor {\n\tif (value === null || typeof value !== 'object' || Array.isArray(value)) return false\n\t// Partial<> keeps this a widening assertion; asserting into BadgeDescriptor itself (required\n\t// `label`) narrows, which `no-unsafe-type-assertion` rejects.\n\tconst obj = value as Partial<BadgeDescriptor>\n\tif (typeof obj.label !== 'string') return false\n\tif (obj.variant !== undefined && !isBadgeVariant(obj.variant)) return false\n\tif (obj.color !== undefined && typeof obj.color !== 'string') return false\n\treturn true\n}\n\n/**\n * True when `options` is a Select choice map (`{ Open: \"warning\", ... }` or\n * `{ choices: [...], badges: {...} }`), not a quantity/currency/code config bag.\n * @public\n */\nexport function isSelectChoiceMap(options: FieldOptions | undefined): options is Record<string, BadgeSpec> {\n\tif (options === undefined || Array.isArray(options) || !isOptionsRecord(options)) return false\n\tif (isStructuredSelectOptions(options)) {\n\t\tconst badges = options.badges\n\t\tif (badges === undefined) return false\n\t\treturn Object.values(badges).every(isBadgeSpec)\n\t}\n\tconst entries = Object.entries(options)\n\tif (entries.length === 0) return false\n\treturn entries.every(([, value]) => isBadgeSpec(value))\n}\n\n/**\n * True when `options` uses the structured SelectOptions shape.\n * @public\n */\nexport function isSelectOptions(options: FieldOptions | undefined): options is SelectOptions {\n\tif (options === undefined || Array.isArray(options) || !isOptionsRecord(options)) return false\n\treturn isStructuredSelectOptions(options)\n}\n\n/**\n * Dropdown / filter choice strings.\n * @public\n */\nexport function selectChoices(options: FieldOptions | undefined): string[] {\n\tif (options === undefined) return []\n\tif (Array.isArray(options)) return options\n\tif (!isOptionsRecord(options)) return []\n\tif (isStructuredSelectOptions(options)) return options.choices\n\tif (isSelectChoiceMap(options)) return Object.keys(options)\n\treturn []\n}\n\nfunction normalizeBadgeSpec(spec: unknown, key: string): BadgeDescriptor {\n\tif (isBadgeVariant(spec)) {\n\t\treturn { label: key, variant: spec }\n\t}\n\t// A malformed spec still names a real choice, so keep the label and drop only the styling.\n\t// Reading `.variant`/`.color` off an unvalidated value is what let a misspelt variant reach the\n\t// DOM as an unmatched class, and threw outright on null.\n\tif (!isBadgeSpecObject(spec)) {\n\t\treturn { label: key }\n\t}\n\treturn {\n\t\tlabel: spec.label ?? key,\n\t\tvariant: spec.variant,\n\t\tcolor: spec.color,\n\t}\n}\n\nfunction lookupFromBareMap(map: Record<string, BadgeSpec>, key: string | undefined): BadgeDescriptor | undefined {\n\tif (key === undefined || key === '') return undefined\n\tif (!(key in map)) return undefined\n\treturn normalizeBadgeSpec(map[key], key)\n}\n\nfunction lookupFromStructured(options: SelectOptions, key: string | undefined): BadgeDescriptor | undefined {\n\tif (key === undefined || key === '') return undefined\n\tconst badges = options.badges\n\tif (!badges || !(key in badges)) return undefined\n\treturn normalizeBadgeSpec(badges[key], key)\n}\n\n/**\n * Resolve a stored choice value to a badge descriptor using field options.\n * @public\n */\nexport function lookupBadge(options: FieldOptions | undefined, key: string | undefined): BadgeDescriptor | undefined {\n\tif (options === undefined || key === undefined || key === '') return undefined\n\tif (Array.isArray(options)) return undefined\n\tif (!isOptionsRecord(options)) return undefined\n\tif (isStructuredSelectOptions(options)) return lookupFromStructured(options, key)\n\tif (isSelectChoiceMap(options)) return lookupFromBareMap(options, key)\n\treturn undefined\n}\n\n/**\n * Whether field options carry any badge mapping.\n * @public\n */\nexport function hasBadgeOptions(options: FieldOptions | undefined): boolean {\n\tif (options === undefined || Array.isArray(options)) return false\n\tif (!isOptionsRecord(options)) return false\n\tif (isStructuredSelectOptions(options)) return options.badges !== undefined && Object.keys(options.badges).length > 0\n\treturn isSelectChoiceMap(options)\n}\n"],"mappings":"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"}

package/dist/record-BQOOi83C.js

@@ -0,0 +1,134 @@
+import { t as flattenFields } from "./flatten-Bx2cfvw3.js";
+//#region src/component-meta.ts
+/**
+* Canonical component → semantic category. Only the components Stonecrop ships with appear here;
+* custom/unknown component names have no category and consumers fall back to their default.
+* @public
+*/
+var COMPONENT_CATEGORY = {
+	ATextInput: "text",
+	ATextboxInput: "text",
+	ANumericInput: "number",
+	ACheckbox: "boolean",
+	ADate: "date",
+	ADatePicker: "date",
+	ADateSelection: "date",
+	ADateTime: "datetime",
+	ADuration: "text",
+	ADateRange: "date",
+	ADropdown: "select",
+	ASegmentedControl: "select",
+	ACodeEditor: "code",
+	AFormLink: "link",
+	AFileAttach: "attach",
+	AQuantityInput: "quantity",
+	ACurrencyInput: "currency"
+};
+/**
+* Resolve a component's semantic category, or `undefined` for an unknown (custom) component —
+* callers treat that as "no opinion" and use their own default.
+* @public
+*/
+function componentCategory(component) {
+	return component ? COMPONENT_CATEGORY[component] : void 0;
+}
+/**
+* Canonical link component → expansion. Only components Stonecrop ships with appear here; an
+* unmapped (custom) component has none, and callers treat that as `expand` — the behaviour that
+* predates this map, so a custom component can never silently collapse a link to a picker.
+* @public
+*/
+var COMPONENT_LINK_EXPANSION = {
+	AFormLink: "inline",
+	AForm: "expand",
+	ATable: "expand"
+};
+/**
+* Resolve a component's link expansion, or `undefined` for an absent/unmapped component.
+* @public
+*/
+function componentLinkExpansion(component) {
+	return component ? COMPONENT_LINK_EXPANSION[component] : void 0;
+}
+/**
+* Decide how a *declared* link (one with a `LinkDeclaration`) renders.
+*
+* Two independent axes: the **component** picks inline vs expand, and when expanding the
+* **cardinality** picks record vs table (many → table). The declaration's component wins over the
+* field's, matching the precedence the resolver already uses for the rendered component.
+*
+* This is the single definition of "does this link expand" — it is consumed by both the client
+* resolver (which builds the nested schema) and the server column builder (which must still
+* SELECT an `inline` link's FK column). Call it; never re-derive the rule at the call site, or
+* the two will drift and the client will render a table for a column the server never selected.
+*
+* @param link - the link declaration (only `component` and `cardinality` are consulted)
+* @param fieldComponent - the linked field's own `component`, used when the declaration names none
+* @public
+*/
+function resolveLinkRenderMode(link, fieldComponent) {
+	if (componentLinkExpansion(link.component ?? fieldComponent) === "inline") return "inline";
+	return link.cardinality === "noneOrMany" || link.cardinality === "atLeastOne" ? "table" : "record";
+}
+/**
+* Every component Stonecrop ships with that can render a value field, sorted by name.
+*
+* The union of the two maps above is the definition, not a copy of it: a shipped component either
+* categorises a value ({@link COMPONENT_CATEGORY}) or is one of the link containers that has no
+* value of its own ({@link COMPONENT_LINK_EXPANSION}'s `AForm`/`ATable`). `AFieldset` is absent by
+* the same rule — it is a `kind: 'fieldset'` container, so it is never a value field's component.
+*
+* `component` is an **open** axis: any string is valid, and naming a custom component is how an app
+* renders a field Stonecrop ships no widget for. This list is therefore the set to *suggest* to an
+* author, and to check first-party data against — never a set to validate arbitrary input against.
+*
+* @public
+*/
+var CANONICAL_COMPONENTS = [.../* @__PURE__ */ new Set([...Object.keys(COMPONENT_CATEGORY), ...Object.keys(COMPONENT_LINK_EXPANSION)])].toSorted();
+//#endregion
+//#region src/record.ts
+/**
+* Reduce a record's *inline* link values to the ids that get persisted.
+*
+* The adapter returns an inline link as `{ id, displayText }`, so that is what a record holds
+* everywhere it is read — the store, a list row, a form field. A column takes the id alone, so
+* this is the single definition of the shape a record leaves in, and it belongs at the boundary
+* a record crosses on its way to the server, never on the way into the store.
+*
+* Doing it on the way in destroys the text the adapter looked up: nothing else holds it, so the
+* field that resolved a moment ago renders its raw id, and the same record then renders
+* differently depending on whether anything had edited the form yet. That is the bug this exists
+* to prevent, and its damage is a wrong render, not a throw.
+*
+* Only *inline* links may be reduced. An inline link's value is indistinguishable by inspection
+* from an expanded one (`{ id, ...the whole target record }`), so `component` — which states
+* which of the two a field is — is what tells them apart, via {@link componentLinkExpansion}.
+* Reducing an expanded link would send the id in place of the record.
+*
+* Fieldsets are descended into in both shapes a record appears in: flat, as the store and the
+* server hold it, and nested under the fieldset's own key, as a form emits it.
+*
+* @param fields - the doctype's top-level fields
+* @param record - the record to reduce; not mutated
+* @returns a shallow copy with every inline link reduced to its id
+* @public
+*/
+function unwrapInlineLinks(fields, record) {
+	const inline = new Set(flattenFields(fields).filter((field) => field.kind === "field" && Boolean(field.doctype)).filter((field) => componentLinkExpansion(field.component) === "inline").map((field) => field.fieldname));
+	if (inline.size === 0) return record;
+	return unwrapWith(inline, new Set(fields.filter((field) => field.kind === "fieldset").map((field) => field.fieldname)), record);
+}
+function unwrapWith(inline, fieldsets, record) {
+	const result = { ...record };
+	for (const [key, value] of Object.entries(result)) {
+		if (value === null || typeof value !== "object" || Array.isArray(value)) continue;
+		if (inline.has(key)) {
+			if ("id" in value) result[key] = value.id;
+		} else if (fieldsets.has(key)) result[key] = unwrapWith(inline, fieldsets, value);
+	}
+	return result;
+}
+//#endregion
+export { componentCategory as a, COMPONENT_LINK_EXPANSION as i, CANONICAL_COMPONENTS as n, componentLinkExpansion as o, COMPONENT_CATEGORY as r, resolveLinkRenderMode as s, unwrapInlineLinks as t };
+
+//# sourceMappingURL=record-BQOOi83C.js.map

package/dist/record-BQOOi83C.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"record-BQOOi83C.js","names":[],"sources":["../src/component-meta.ts","../src/record.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'\n\t| 'number'\n\t| 'boolean'\n\t| 'date'\n\t| 'datetime'\n\t| 'select'\n\t| 'code'\n\t| 'link'\n\t| 'attach'\n\t| 'quantity'\n\t| 'currency'\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\tATextboxInput: '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\tASegmentedControl: 'select',\n\tACodeEditor: 'code',\n\tAFormLink: 'link',\n\tAFileAttach: 'attach',\n\tAQuantityInput: 'quantity',\n\tACurrencyInput: 'currency',\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","import { componentLinkExpansion } from './component-meta'\nimport type { DoctypeField } from './field'\nimport { flattenFields } from './flatten'\n\n/**\n * Reduce a record's *inline* link values to the ids that get persisted.\n *\n * The adapter returns an inline link as `{ id, displayText }`, so that is what a record holds\n * everywhere it is read — the store, a list row, a form field. A column takes the id alone, so\n * this is the single definition of the shape a record leaves in, and it belongs at the boundary\n * a record crosses on its way to the server, never on the way into the store.\n *\n * Doing it on the way in destroys the text the adapter looked up: nothing else holds it, so the\n * field that resolved a moment ago renders its raw id, and the same record then renders\n * differently depending on whether anything had edited the form yet. That is the bug this exists\n * to prevent, and its damage is a wrong render, not a throw.\n *\n * Only *inline* links may be reduced. An inline link's value is indistinguishable by inspection\n * from an expanded one (`{ id, ...the whole target record }`), so `component` — which states\n * which of the two a field is — is what tells them apart, via {@link componentLinkExpansion}.\n * Reducing an expanded link would send the id in place of the record.\n *\n * Fieldsets are descended into in both shapes a record appears in: flat, as the store and the\n * server hold it, and nested under the fieldset's own key, as a form emits it.\n *\n * @param fields - the doctype's top-level fields\n * @param record - the record to reduce; not mutated\n * @returns a shallow copy with every inline link reduced to its id\n * @public\n */\nexport function unwrapInlineLinks(fields: readonly DoctypeField[], record: Record<string, any>): Record<string, any> {\n\tconst inline = new Set(\n\t\tflattenFields(fields)\n\t\t\t.filter(field => field.kind === 'field' && Boolean(field.doctype))\n\t\t\t.filter(field => componentLinkExpansion(field.component) === 'inline')\n\t\t\t.map(field => field.fieldname)\n\t)\n\tif (inline.size === 0) return record\n\n\tconst fieldsets = new Set(fields.filter(field => field.kind === 'fieldset').map(field => field.fieldname))\n\treturn unwrapWith(inline, fieldsets, record)\n}\n\nfunction unwrapWith(\n\tinline: ReadonlySet<string>,\n\tfieldsets: ReadonlySet<string>,\n\trecord: Record<string, any>\n): Record<string, any> {\n\tconst result: Record<string, any> = { ...record }\n\tfor (const [key, value] of Object.entries(result)) {\n\t\tif (value === null || typeof value !== 'object' || Array.isArray(value)) continue\n\t\tif (inline.has(key)) {\n\t\t\t// `'id' in value` rather than a truthiness test: an inline link that was never resolved\n\t\t\t// is still a bare scalar, and reducing it a second time would be a no-op at best.\n\t\t\tif ('id' in value) result[key] = value.id\n\t\t} else if (fieldsets.has(key)) {\n\t\t\tresult[key] = unwrapWith(inline, fieldsets, value)\n\t\t}\n\t}\n\treturn result\n}\n"],"mappings":";;;;;;;AA6BA,IAAa,qBAAwD;CACpE,YAAY;CACZ,eAAe;CACf,eAAe;CACf,WAAW;CACX,OAAO;CACP,aAAa;CACb,gBAAgB;CAChB,WAAW;CACX,WAAW;CACX,YAAY;CACZ,WAAW;CACX,mBAAmB;CACnB,aAAa;CACb,WAAW;CACX,aAAa;CACb,gBAAgB;CAChB,gBAAgB;AACjB;;;;;;AAOA,SAAgB,kBAAkB,WAAmD;CACpF,OAAO,YAAY,mBAAmB,aAAa,KAAA;AACpD;;;;;;;AAsBA,IAAa,2BAA0D;CACtE,WAAW;CACX,OAAO;CACP,QAAQ;AACT;;;;;AAMA,SAAgB,uBAAuB,WAA+C;CACrF,OAAO,YAAY,yBAAyB,aAAa,KAAA;AAC1D;;;;;;;;;;;;;;;;;AA8BA,SAAgB,sBACf,MACA,gBACiB;CACjB,IAAI,uBAAuB,KAAK,aAAa,cAAc,MAAM,UAAU,OAAO;CAClF,OAAO,KAAK,gBAAgB,gBAAgB,KAAK,gBAAgB,eAAe,UAAU;AAC3F;;;;;;;;;;;;;;;AAgBA,IAAa,uBAA0C,CACtD,mBAAG,IAAI,IAAI,CAAC,GAAG,OAAO,KAAK,kBAAkB,GAAG,GAAG,OAAO,KAAK,wBAAwB,CAAC,CAAC,CAC1F,CAAC,CAAC,SAAS;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AClHX,SAAgB,kBAAkB,QAAiC,QAAkD;CACpH,MAAM,SAAS,IAAI,IAClB,cAAc,MAAM,CAAC,CACnB,QAAO,UAAS,MAAM,SAAS,WAAW,QAAQ,MAAM,OAAO,CAAC,CAAC,CACjE,QAAO,UAAS,uBAAuB,MAAM,SAAS,MAAM,QAAQ,CAAC,CACrE,KAAI,UAAS,MAAM,SAAS,CAC/B;CACA,IAAI,OAAO,SAAS,GAAG,OAAO;CAG9B,OAAO,WAAW,QAAQ,IADJ,IAAI,OAAO,QAAO,UAAS,MAAM,SAAS,UAAU,CAAC,CAAC,KAAI,UAAS,MAAM,SAAS,CAC9E,GAAW,MAAM;AAC5C;AAEA,SAAS,WACR,QACA,WACA,QACsB;CACtB,MAAM,SAA8B,EAAE,GAAG,OAAO;CAChD,KAAK,MAAM,CAAC,KAAK,UAAU,OAAO,QAAQ,MAAM,GAAG;EAClD,IAAI,UAAU,QAAQ,OAAO,UAAU,YAAY,MAAM,QAAQ,KAAK,GAAG;EACzE,IAAI,OAAO,IAAI,GAAG,GAGb;OAAA,QAAQ,OAAO,OAAO,OAAO,MAAM;EAAA,OACjC,IAAI,UAAU,IAAI,GAAG,GAC3B,OAAO,OAAO,WAAW,QAAQ,WAAW,KAAK;CAEnD;CACA,OAAO;AACR"}

package/dist/record.js

@@ -1,6 +1,2 @@
-import { u as o } from "./record-Bc0lI9Rq.js";
-import "./flatten-C1MjkzFh.js";
-export {
-  o as unwrapInlineLinks
-};
-//# sourceMappingURL=record.js.map
+import { t as unwrapInlineLinks } from "./record-BQOOi83C.js";
+export { unwrapInlineLinks };

package/dist/tsdoc-metadata.json

@@ -5,7 +5,7 @@
   "toolPackages": [
     {
       "packageName": "@microsoft/api-extractor",
-      "packageVersion": "7.58.11"
+      "packageVersion": "7.59.0"
     }
   ]
 }

package/package.json

@@ -1,35 +1,50 @@
 {
   "name": "@stonecrop/schema",
-  "version": "0.30.0",
+  "version": "0.32.0",
   "description": "Stonecrop schema definitions and validation tooling",
+  "keywords": [
+    "doctype",
+    "schema",
+    "stonecrop",
+    "validation"
+  ],
+  "homepage": "https://github.com/agritheory/stonecrop#readme",
+  "bugs": {
+    "url": "https://github.com/agritheory/stonecrop/issues"
+  },
+  "author": {
+    "name": "Tyler Matteson",
+    "email": "tyler@agritheory.com"
+  },
   "repository": {
     "type": "git",
     "url": "https://github.com/agritheory/stonecrop",
     "directory": "schema"
   },
-  "sideEffects": false,
+  "bin": {
+    "stonecrop-schema": "./dist/cli.js"
+  },
+  "files": [
+    "dist",
+    "!dist/src"
+  ],
   "type": "module",
+  "sideEffects": false,
+  "types": "./dist/schema.d.ts",
   "exports": {
     ".": {
       "types": "./dist/schema.d.ts",
       "import": "./dist/index.js"
-    }
+    },
+    "./package.json": "./package.json"
   },
-  "types": "./dist/schema.d.ts",
-  "bin": {
-    "stonecrop-schema": "./dist/cli.js"
-  },
-  "files": [
-    "dist"
-  ],
   "dependencies": {
     "graphql": "^16.14.0",
     "pluralize": "^8.0.0",
     "zod": "^4.3.6"
   },
   "devDependencies": {
-    "@microsoft/api-documenter": "^7.30.5",
-    "@rushstack/heft": "^1.2.17",
+    "@microsoft/api-extractor": "^7.58.7",
     "@types/node": "^24.12.4",
     "@types/pluralize": "^0.0.33",
     "@vitest/coverage-istanbul": "^4.1.5",
@@ -37,14 +52,15 @@
     "oxlint": "1.67.0",
     "oxlint-tsgolint": "0.23.0",
     "typescript": "^6.0.3",
-    "vite": "^7.3.2",
-    "vitest": "^4.1.5",
-    "stonecrop-rig": "0.7.0"
+    "vite": "^8.2.2",
+    "vitest": "^4.1.5"
+  },
+  "engines": {
+    "node": ">=24.0.0"
   },
   "scripts": {
-    "_phase:build": "heft build --clean && vite build && rushx docs",
-    "build": "heft build --clean && vite build && rushx docs",
-    "docs": "bash ../common/scripts/run-docs.sh schema",
+    "dev": "vite build --watch",
+    "docs": "bash ../tools/scripts/run-docs.sh schema",
     "lint": "oxlint",
     "lint:fix": "oxlint --fix",
     "preview": "vite preview",

package/dist/flatten-C1MjkzFh.js

@@ -1,10 +0,0 @@
-function f(t) {
-  const e = [];
-  for (const s of t)
-    s.kind === "fieldset" ? e.push(...f(s.schema)) : e.push(s);
-  return e;
-}
-export {
-  f
-};
-//# sourceMappingURL=flatten-C1MjkzFh.js.map

package/dist/flatten-C1MjkzFh.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"flatten-C1MjkzFh.js","sources":["../src/flatten.ts"],"sourcesContent":["import type { DoctypeField, TableField, ValueField } from './field'\n\n/**\n * Recursively flatten Fieldset containers into a flat array of non-container fields.\n * Fieldset entries are replaced by their children; all other fields pass through.\n *\n * A fieldset is a layout grouping, not a scope: every field inside one is a field of the doctype,\n * with a column of its own and a name a link can bind to. Anything asking \"what does this doctype\n * declare\" must therefore descend, and the two ways to get that wrong point opposite ways — the\n * SELECT builder would omit real columns, while a validator would report a working declaration as\n * broken.\n *\n * Lives here rather than in the adapter because both sides need it: the middleware builds SQL from\n * it, and `DoctypeMeta`'s own validation asks the same question at the load gate. It sat in the\n * adapter while the validator hand-rolled a top-level-only scan, and that is exactly the second\n * failure this comment names — a `displayField` inside a fieldset was rejected at authoring time\n * and would have worked at runtime.\n *\n * A module of its own, importing nothing at runtime, because callers need the descent without\n * needing the rest of `field.ts` — which defines the Zod schemas, so a runtime edge to it is a\n * runtime edge to Zod. Zod reaching a Nitro SSR entry collides with the `process` Nitro imports\n * there and takes the server down with a `SyntaxError` per request, which no build reports.\n * `field.ts` still calls this and `index.ts` still exports it, so nothing outside moves.\n *\n * @param fields - the doctype's top-level fields\n * @returns every non-container field, fieldset children included\n * @public\n */\nexport function flattenFields(fields: readonly DoctypeField[]): (ValueField | TableField)[] {\n\tconst result: (ValueField | TableField)[] = []\n\tfor (const f of fields) {\n\t\tif (f.kind === 'fieldset') {\n\t\t\tresult.push(...flattenFields(f.schema))\n\t\t} else {\n\t\t\tresult.push(f)\n\t\t}\n\t}\n\treturn result\n}\n"],"names":["flattenFields","fields","result","f"],"mappings":"AA4BO,SAASA,EAAcC,GAA8D;AAC3F,QAAMC,IAAsC,CAAA;AAC5C,aAAWC,KAAKF;AACf,IAAIE,EAAE,SAAS,aACdD,EAAO,KAAK,GAAGF,EAAcG,EAAE,MAAM,CAAC,IAEtCD,EAAO,KAAKC,CAAC;AAGf,SAAOD;AACR;"}