@stonecrop/schema 0.13.14 → 0.14.0

package/dist/src/column-schema.d.ts

@@ -20,11 +20,19 @@ export interface ColumnSchema {
     /** Unique identifier for the field within its doctype. Maps to `name` on `TableColumn`. */
     fieldname: string;
     /**
-     * Semantic field type (e.g. `'Data'`, `'Int'`, `'Date'`, `'Check'`). Fields without a
-     * `fieldtype` are treated as non-scalar (nested table or fieldset) and excluded by
-     * `schemaToColumns`.
+     * Rendering component (e.g. `'ATextInput'`, `'ANumericInput'`, `'ADate'`). Default cell
+     * formatting and filter widgets derive from its {@link ComponentCategory}.
+     *
+     * Optional here, unlike `ValueField.component`: absence is what marks an entry as non-scalar
+     * (a nested table or fieldset), which `schemaToColumns` excludes — it has no column equivalent.
+     */
+    component?: string;
+    /**
+     * Target doctype slug — marks this column as a link. When set and no `cellComponent` is given,
+     * `schemaToColumns` copies it to `TableColumn.linkDoctype`, which ACell uses to resolve a bare
+     * id to display text.
      */
-    fieldtype?: string;
+    doctype?: string;
     /**
      * Human-readable column header. When absent, ATable assigns labels alphabetically
      * (A, B, C, …).
@@ -35,7 +43,7 @@ export interface ColumnSchema {
     /**
      * Horizontal text alignment for the column cell and header.
      *
-     * @defaultValue 'left'
+     * @defaultValue 'center'
      */
     align?: 'left' | 'right' | 'center' | 'start' | 'end';
     /**
@@ -75,9 +83,10 @@ export interface ColumnSchema {
      */
     filterable?: boolean;
     /**
-     * The type of filter control to render. When absent, a default is derived from `fieldtype`
-     * (`Check` → `checkbox`, `Date` → `date`, `Datetime` → `dateRange`, `Select` → `select`,
-     * numeric types → `number`, everything else → `text`).
+     * The type of filter control to render. When absent, a default is derived from the
+     * `component`'s {@link ComponentCategory} (`boolean` → `checkbox`, `date` → `date`,
+     * `datetime` → `dateRange`, `select` → `select`, `number` → `number`, everything else
+     * — including an unknown component — → `text`).
      */
     filterType?: 'text' | 'select' | 'number' | 'date' | 'dateRange' | 'checkbox' | 'component';
     /**

package/dist/src/column-schema.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"column-schema.d.ts","sourceRoot":"","sources":["../../src/column-schema.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,WAAW,YAAY;IAC5B,2FAA2F;IAC3F,SAAS,EAAE,MAAM,CAAA;IAEjB;;;;OAIG;IACH,SAAS,CAAC,EAAE,MAAM,CAAA;IAElB;;;OAGG;IACH,KAAK,CAAC,EAAE,MAAM,CAAA;IAEd,wFAAwF;IACxF,MAAM,CAAC,EAAE,OAAO,CAAA;IAEhB;;;;OAIG;IACH,KAAK,CAAC,EAAE,MAAM,GAAG,OAAO,GAAG,QAAQ,GAAG,OAAO,GAAG,KAAK,CAAA;IAErD;;;;OAIG;IACH,IAAI,CAAC,EAAE,OAAO,CAAA;IAEd;;;;OAIG;IACH,KAAK,CAAC,EAAE,MAAM,CAAA;IAEd;;;;OAIG;IACH,MAAM,CAAC,EAAE,OAAO,CAAA;IAEhB;;;;OAIG;IACH,SAAS,CAAC,EAAE,OAAO,CAAA;IAEnB;;;;OAIG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAA;IAElB;;;;OAIG;IACH,UAAU,CAAC,EAAE,OAAO,CAAA;IAEpB;;;;OAIG;IACH,UAAU,CAAC,EAAE,MAAM,GAAG,QAAQ,GAAG,QAAQ,GAAG,MAAM,GAAG,WAAW,GAAG,UAAU,GAAG,WAAW,CAAA;IAE3F;;;OAGG;IACH,aAAa,CAAC,EAAE,GAAG,EAAE,CAAA;IAErB,yEAAyE;IACzE,eAAe,CAAC,EAAE,MAAM,CAAA;IAExB;;;OAGG;IACH,aAAa,CAAC,EAAE,MAAM,CAAA;IAEtB;;;;OAIG;IACH,kBAAkB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAA;IAExC;;;;;;;;;OASG;IACH,cAAc,CAAC,EAAE,MAAM,CAAA;IAEvB;;;;OAIG;IACH,wBAAwB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAA;IAE9C;;;;OAIG;IACH,MAAM,CAAC,EAAE,MAAM,CAAA;IAEf;;;;;;OAMG;IACH,OAAO,CAAC,EAAE,OAAO,CAAA;IAEjB;;;;;;OAMG;IACH,cAAc,CAAC,EAAE,MAAM,CAAA;IAEvB;;;;;OAKG;IACH,OAAO,CAAC,EAAE,MAAM,CAAA;CAChB"}
+{"version":3,"file":"column-schema.d.ts","sourceRoot":"","sources":["../../src/column-schema.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,WAAW,YAAY;IAC5B,2FAA2F;IAC3F,SAAS,EAAE,MAAM,CAAA;IAEjB;;;;;;OAMG;IACH,SAAS,CAAC,EAAE,MAAM,CAAA;IAElB;;;;OAIG;IACH,OAAO,CAAC,EAAE,MAAM,CAAA;IAEhB;;;OAGG;IACH,KAAK,CAAC,EAAE,MAAM,CAAA;IAEd,wFAAwF;IACxF,MAAM,CAAC,EAAE,OAAO,CAAA;IAEhB;;;;OAIG;IACH,KAAK,CAAC,EAAE,MAAM,GAAG,OAAO,GAAG,QAAQ,GAAG,OAAO,GAAG,KAAK,CAAA;IAErD;;;;OAIG;IACH,IAAI,CAAC,EAAE,OAAO,CAAA;IAEd;;;;OAIG;IACH,KAAK,CAAC,EAAE,MAAM,CAAA;IAEd;;;;OAIG;IACH,MAAM,CAAC,EAAE,OAAO,CAAA;IAEhB;;;;OAIG;IACH,SAAS,CAAC,EAAE,OAAO,CAAA;IAEnB;;;;OAIG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAA;IAElB;;;;OAIG;IACH,UAAU,CAAC,EAAE,OAAO,CAAA;IAEpB;;;;;OAKG;IACH,UAAU,CAAC,EAAE,MAAM,GAAG,QAAQ,GAAG,QAAQ,GAAG,MAAM,GAAG,WAAW,GAAG,UAAU,GAAG,WAAW,CAAA;IAE3F;;;OAGG;IACH,aAAa,CAAC,EAAE,GAAG,EAAE,CAAA;IAErB,yEAAyE;IACzE,eAAe,CAAC,EAAE,MAAM,CAAA;IAExB;;;OAGG;IACH,aAAa,CAAC,EAAE,MAAM,CAAA;IAEtB;;;;OAIG;IACH,kBAAkB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAA;IAExC;;;;;;;;;OASG;IACH,cAAc,CAAC,EAAE,MAAM,CAAA;IAEvB;;;;OAIG;IACH,wBAAwB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAA;IAE9C;;;;OAIG;IACH,MAAM,CAAC,EAAE,MAAM,CAAA;IAEf;;;;;;OAMG;IACH,OAAO,CAAC,EAAE,OAAO,CAAA;IAEjB;;;;;;OAMG;IACH,cAAc,CAAC,EAAE,MAAM,CAAA;IAEvB;;;;;OAKG;IACH,OAAO,CAAC,EAAE,MAAM,CAAA;CAChB"}

package/dist/src/component-meta.d.ts

@@ -0,0 +1,96 @@
+/**
+ * Semantic category for a rendering component.
+ *
+ * `component` is the primary field axis, so the runtime consumers that need to know what a field
+ * *means* (atable cell formatting / filter widgets, record-default init) derive it from here. This
+ * is the single source of "what kind of value does this component render", keyed by the canonical
+ * registered component names — each consumer maps the category to its own concern (filter widget,
+ * default value, …).
+ *
+ * @public
+ */
+export type ComponentCategory = 'text' | 'number' | 'boolean' | 'date' | 'datetime' | 'select' | 'code' | 'link' | 'attach';
+/**
+ * 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
+ */
+export declare const COMPONENT_CATEGORY: Record<string, ComponentCategory>;
+/**
+ * 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
+ */
+export declare function componentCategory(component?: string): ComponentCategory | undefined;
+/**
+ * Whether a link component expands its target doctype, or renders the link inline.
+ *
+ * This is the *only* axis the component decides. It deliberately does not choose between an
+ * embedded record and an embedded table: `cardinality` states whether the value is a scalar or
+ * an array, which is a fact about the data rather than a rendering preference, so a component
+ * must not be able to override it (an `AForm` over a `noneOrMany` link would be handed an array
+ * it cannot render). Component names encode both axes — `AFormLink`/`ATableLink` are the inline
+ * pair, `AForm`/`ATable` the expanding pair — but only the inline/expand half is authoritative.
+ *
+ * @public
+ */
+export type LinkExpansion = 'inline' | 'expand';
+/**
+ * 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
+ */
+export declare const COMPONENT_LINK_EXPANSION: Record<string, LinkExpansion>;
+/**
+ * Resolve a component's link expansion, or `undefined` for an absent/unmapped component.
+ * @public
+ */
+export declare function componentLinkExpansion(component?: string): LinkExpansion | undefined;
+/**
+ * How a link field renders.
+ *
+ * - `inline` — a scalar id-picker; the target is *not* expanded (the field keeps its own value
+ *   and carries a `doctype` prop for async display-text resolution and navigation).
+ * - `record` — the target doctype is resolved and embedded as a nested form.
+ * - `table` — the target doctype is resolved and embedded as a child table.
+ *
+ * @public
+ */
+export type LinkRenderMode = 'inline' | 'record' | 'table';
+/**
+ * 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
+ */
+export declare function resolveLinkRenderMode(link: {
+    component?: string;
+    cardinality?: string;
+}, fieldComponent?: string): LinkRenderMode;
+/**
+ * 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
+ */
+export declare const CANONICAL_COMPONENTS: readonly string[];
+//# sourceMappingURL=component-meta.d.ts.map

package/dist/src/component-meta.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"component-meta.d.ts","sourceRoot":"","sources":["../../src/component-meta.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,MAAM,MAAM,iBAAiB,GAC5B,MAAM,GAAG,QAAQ,GAAG,SAAS,GAAG,MAAM,GAAG,UAAU,GAAG,QAAQ,GAAG,MAAM,GAAG,MAAM,GAAG,QAAQ,CAAA;AAE5F;;;;GAIG;AACH,eAAO,MAAM,kBAAkB,EAAE,MAAM,CAAC,MAAM,EAAE,iBAAiB,CAehE,CAAA;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,iBAAiB,GAAG,SAAS,CAEnF;AAED;;;;;;;;;;;GAWG;AACH,MAAM,MAAM,aAAa,GAAG,QAAQ,GAAG,QAAQ,CAAA;AAE/C;;;;;GAKG;AACH,eAAO,MAAM,wBAAwB,EAAE,MAAM,CAAC,MAAM,EAAE,aAAa,CAIlE,CAAA;AAED;;;GAGG;AACH,wBAAgB,sBAAsB,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,aAAa,GAAG,SAAS,CAEpF;AAED;;;;;;;;;GASG;AACH,MAAM,MAAM,cAAc,GAAG,QAAQ,GAAG,QAAQ,GAAG,OAAO,CAAA;AAE1D;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,qBAAqB,CACpC,IAAI,EAAE;IAAE,SAAS,CAAC,EAAE,MAAM,CAAC;IAAC,WAAW,CAAC,EAAE,MAAM,CAAA;CAAE,EAClD,cAAc,CAAC,EAAE,MAAM,GACrB,cAAc,CAGhB;AAED;;;;;;;;;;;;;GAaG;AACH,eAAO,MAAM,oBAAoB,EAAE,SAAS,MAAM,EAEtC,CAAA"}

package/dist/src/component-meta.js

@@ -0,0 +1,85 @@
+/**
+ * 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
+ */
+export const COMPONENT_CATEGORY = {
+    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',
+};
+/**
+ * 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
+ */
+export function componentCategory(component) {
+    return component ? COMPONENT_CATEGORY[component] : undefined;
+}
+/**
+ * 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
+ */
+export const COMPONENT_LINK_EXPANSION = {
+    AFormLink: 'inline',
+    AForm: 'expand',
+    ATable: 'expand',
+};
+/**
+ * Resolve a component's link expansion, or `undefined` for an absent/unmapped component.
+ * @public
+ */
+export function componentLinkExpansion(component) {
+    return component ? COMPONENT_LINK_EXPANSION[component] : undefined;
+}
+/**
+ * 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
+ */
+export 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
+ */
+export const CANONICAL_COMPONENTS = [
+    ...new Set([...Object.keys(COMPONENT_CATEGORY), ...Object.keys(COMPONENT_LINK_EXPANSION)]),
+].toSorted();

package/dist/src/converter/heuristics.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"heuristics.d.ts","sourceRoot":"","sources":["../../../src/converter/heuristics.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EAON,KAAK,iBAAiB,EACtB,KAAK,YAAY,EAGjB,MAAM,SAAS,CAAA;AAGhB,OAAO,KAAK,EAAE,0BAA0B,EAAE,wBAAwB,EAAE,MAAM,SAAS,CAAA;AA+BnF;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,iBAAiB,GAAG,OAAO,CA8BtF;AAQD;;;;;;;;;GASG;AACH,wBAAgB,oBAAoB,CACnC,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,YAAY,CAAC,OAAO,EAAE,OAAO,CAAC,EACtC,WAAW,EAAE,iBAAiB,GAC5B,OAAO,CAET;AAyED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,iBAAiB,CAChC,SAAS,EAAE,MAAM,EACjB,KAAK,EAAE,YAAY,CAAC,OAAO,EAAE,OAAO,CAAC,EACrC,WAAW,EAAE,GAAG,CAAC,MAAM,CAAC,EACxB,OAAO,GAAE,wBAA6B,GACpC,0BAA0B,CAyG5B"}
+{"version":3,"file":"heuristics.d.ts","sourceRoot":"","sources":["../../../src/converter/heuristics.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EAON,KAAK,iBAAiB,EACtB,KAAK,YAAY,EAGjB,MAAM,SAAS,CAAA;AAGhB,OAAO,KAAK,EAAE,0BAA0B,EAAE,wBAAwB,EAAE,MAAM,SAAS,CAAA;AA+BnF;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,iBAAiB,GAAG,OAAO,CA8BtF;AAQD;;;;;;;;;GASG;AACH,wBAAgB,oBAAoB,CACnC,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,YAAY,CAAC,OAAO,EAAE,OAAO,CAAC,EACtC,WAAW,EAAE,iBAAiB,GAC5B,OAAO,CAET;AAyED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,iBAAiB,CAChC,SAAS,EAAE,MAAM,EACjB,KAAK,EAAE,YAAY,CAAC,OAAO,EAAE,OAAO,CAAC,EACrC,WAAW,EAAE,GAAG,CAAC,MAAM,CAAC,EACxB,OAAO,GAAE,wBAA6B,GACpC,0BAA0B,CAkG5B"}

package/dist/src/converter/heuristics.js

@@ -182,7 +182,6 @@ export function classifyFieldType(fieldName, field, entityTypes, options = {}) {
         fieldname: fieldName,
         label: camelToLabel(fieldName),
         component: 'ATextInput',
-        fieldtype: 'Data',
     };
     if (required) {
         base.required = true;
@@ -201,16 +200,14 @@ export function classifyFieldType(fieldName, field, entityTypes, options = {}) {
         if (namedType.name === 'ID') {
             const candidateTypeName = toPascalCase(fieldName);
             if (entityTypes.has(candidateTypeName)) {
-                base.component = 'ALink';
-                base.fieldtype = 'Link';
-                base.options = toSlug(candidateTypeName);
+                base.component = 'AFormLink';
+                base.doctype = toSlug(candidateTypeName);
                 return base;
             }
         }
         const template = scalarMap[namedType.name];
         if (template) {
             base.component = template.component;
-            base.fieldtype = template.fieldtype;
         }
         else {
             // Unknown scalar — default to Data with unmapped marker
@@ -224,7 +221,6 @@ export function classifyFieldType(fieldName, field, entityTypes, options = {}) {
     // 2. Enum types → Select
     if (isEnumType(namedType)) {
         base.component = 'ADropdown';
-        base.fieldtype = 'Select';
         base.options = namedType.getValues().map(v => v.name);
         return base;
     }
@@ -232,9 +228,8 @@ export function classifyFieldType(fieldName, field, entityTypes, options = {}) {
     if (isObjectType(namedType)) {
         // 3. Direct reference to an entity type → Link
         if (!isList && entityTypes.has(namedType.name)) {
-            base.component = 'ALink';
-            base.fieldtype = 'Link';
-            base.options = toSlug(namedType.name);
+            base.component = 'AFormLink';
+            base.doctype = toSlug(namedType.name);
             return base;
         }
         // 4. Connection type → link (child table)
@@ -242,18 +237,16 @@ export function classifyFieldType(fieldName, field, entityTypes, options = {}) {
         if (connectionNodeTypeName && entityTypes.has(connectionNodeTypeName)) {
             base.component = 'ATable';
             base._isLink = true;
-            base.options = toSlug(connectionNodeTypeName);
+            base.doctype = toSlug(connectionNodeTypeName);
             base.cardinality = 'noneOrMany';
-            delete base.fieldtype;
             return base;
         }
         // 5. List of entity type → link
         if (isList && entityTypes.has(namedType.name)) {
             base.component = 'ATable';
             base._isLink = true;
-            base.options = toSlug(namedType.name);
+            base.doctype = toSlug(namedType.name);
             base.cardinality = 'noneOrMany';
-            delete base.fieldtype;
             return base;
         }
         // Unknown object type — mark as unmapped

package/dist/src/converter/index.d.ts

@@ -31,7 +31,7 @@ import type { IntrospectionSource, GraphQLConversionOptions, ConvertedGraphQLDoc
  * // With PostGraphile custom scalars
  * const doctypes = convertGraphQLSchema(introspection, {
  *   customScalars: {
- *     BigFloat: { component: 'ADecimalInput', fieldtype: 'Decimal' }
+ *     BigFloat: { component: 'ANumericInput' }
  *   }
  * })
  * ```

package/dist/src/converter/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/converter/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAMH,OAAO,KAAK,EAAE,mBAAmB,EAAE,wBAAwB,EAAE,uBAAuB,EAAE,MAAM,SAAS,CAAA;AAIrG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AACH,wBAAgB,oBAAoB,CACnC,MAAM,EAAE,mBAAmB,EAC3B,OAAO,GAAE,wBAA6B,GACpC,uBAAuB,EAAE,CA8H3B;AAwBD,OAAO,EAAE,oBAAoB,IAAI,OAAO,EAAE,CAAA;AAG1C,YAAY,EACX,mBAAmB,EACnB,wBAAwB,EACxB,0BAA0B,EAC1B,uBAAuB,GACvB,MAAM,SAAS,CAAA;AAGhB,OAAO,EAAE,cAAc,EAAE,kBAAkB,EAAE,gBAAgB,EAAE,cAAc,EAAE,MAAM,WAAW,CAAA;AAGhG,OAAO,EAAE,mBAAmB,EAAE,oBAAoB,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAA;AAG3F,OAAO,EAAE,MAAM,EAAE,YAAY,EAAE,aAAa,EAAE,YAAY,EAAE,YAAY,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,WAAW,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/converter/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAMH,OAAO,KAAK,EAAE,mBAAmB,EAAE,wBAAwB,EAAE,uBAAuB,EAAE,MAAM,SAAS,CAAA;AAIrG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AACH,wBAAgB,oBAAoB,CACnC,MAAM,EAAE,mBAAmB,EAC3B,OAAO,GAAE,wBAA6B,GACpC,uBAAuB,EAAE,CA+H3B;AAwBD,OAAO,EAAE,oBAAoB,IAAI,OAAO,EAAE,CAAA;AAG1C,YAAY,EACX,mBAAmB,EACnB,wBAAwB,EACxB,0BAA0B,EAC1B,uBAAuB,GACvB,MAAM,SAAS,CAAA;AAGhB,OAAO,EAAE,cAAc,EAAE,kBAAkB,EAAE,gBAAgB,EAAE,cAAc,EAAE,MAAM,WAAW,CAAA;AAGhG,OAAO,EAAE,mBAAmB,EAAE,oBAAoB,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAA;AAG3F,OAAO,EAAE,MAAM,EAAE,YAAY,EAAE,aAAa,EAAE,YAAY,EAAE,YAAY,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,WAAW,CAAA"}

package/dist/src/converter/index.js

@@ -33,7 +33,7 @@ import { defaultIsEntityType, defaultIsEntityField, classifyFieldType } from './
  * // With PostGraphile custom scalars
  * const doctypes = convertGraphQLSchema(introspection, {
  *   customScalars: {
- *     BigFloat: { component: 'ADecimalInput', fieldtype: 'Decimal' }
+ *     BigFloat: { component: 'ANumericInput' }
  *   }
  * })
  * ```
@@ -99,7 +99,6 @@ export function convertGraphQLSchema(source, options = {}) {
                         fieldname: fieldName,
                         label: custom.label ?? fieldName,
                         component: custom.component ?? 'ATextInput',
-                        fieldtype: custom.fieldtype ?? 'Data',
                         ...custom,
                     };
                 }
@@ -116,28 +115,30 @@ export function convertGraphQLSchema(source, options = {}) {
         const links = {};
         const convertedFields = allClassifiedFields
             .filter(field => {
-            if (field._isLink && typeof field.options === 'string' && field.cardinality) {
+            if (field._isLink && field.doctype && field.cardinality) {
                 links[field.fieldname] = {
-                    target: field.options,
+                    target: field.doctype,
                     cardinality: field.cardinality,
                 };
                 return false;
             }
             return true;
         })
-            // Clean up internal metadata unless requested
+            // Clean up internal metadata unless requested, and stamp provenance.
+            // Stamped last so every classification path (default, classifyField,
+            // typeOverrides) carries the marker — the docbuilder's identity lock
+            // keys off it, and an override must not be able to unset it.
             .map(field => {
             if (!options.includeUnmappedMeta) {
                 const { _graphqlType, _unmapped, _isLink, ...clean } = field;
-                return clean;
+                return Object.assign(clean, { source: 'introspected' });
             }
             const { _isLink, ...rest } = field;
-            return rest;
+            return Object.assign(rest, { source: 'introspected' });
         });
         const doctype = {
             name: typeName,
             slug: toSlug(typeName),
-            // oxlint-disable-next-line typescript/no-unsafe-type-assertion -- safe: heuristics always set a fieldtype default ('Data'); the optional fieldtype on GraphQLConversionFieldMeta is for intermediate processing, not because output fields lack fieldtype
             fields: convertedFields,
         };
         if (Object.keys(links).length > 0) {

package/dist/src/converter/scalars.d.ts

@@ -8,7 +8,7 @@
  *
  * @packageDocumentation
  */
-import type { FieldTemplate } from '../fieldtype';
+import type { FieldTemplate } from './types';
 /**
  * Mapping from standard GraphQL scalar types to Stonecrop field types.
  * These are defined by the GraphQL specification and are always available.

package/dist/src/converter/scalars.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"scalars.d.ts","sourceRoot":"","sources":["../../../src/converter/scalars.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,cAAc,CAAA;AAEjD;;;;;GAKG;AACH,eAAO,MAAM,cAAc,EAAE,MAAM,CAAC,MAAM,EAAE,aAAa,CAMxD,CAAA;AAED;;;;;;;;;GASG;AACH,eAAO,MAAM,kBAAkB,EAAE,MAAM,CAAC,MAAM,EAAE,aAAa,CAuB5D,CAAA;AAED;;;;;GAKG;AACH,eAAO,MAAM,gBAAgB,aAAsB,CAAA;AAEnD;;;;;;;GAOG;AACH,wBAAgB,cAAc,CAAC,aAAa,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,aAAa,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC,CAmBpH"}
+{"version":3,"file":"scalars.d.ts","sourceRoot":"","sources":["../../../src/converter/scalars.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,SAAS,CAAA;AAE5C;;;;;GAKG;AACH,eAAO,MAAM,cAAc,EAAE,MAAM,CAAC,MAAM,EAAE,aAAa,CAMxD,CAAA;AAED;;;;;;;;;GASG;AACH,eAAO,MAAM,kBAAkB,EAAE,MAAM,CAAC,MAAM,EAAE,aAAa,CAuB5D,CAAA;AAED;;;;;GAKG;AACH,eAAO,MAAM,gBAAgB,aAAsB,CAAA;AAEnD;;;;;;;GAOG;AACH,wBAAgB,cAAc,CAAC,aAAa,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,aAAa,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC,CAgBpH"}

package/dist/src/converter/scalars.js

@@ -15,11 +15,11 @@
  * @public
  */
 export const GQL_SCALAR_MAP = {
-    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' },
+    String: { component: 'ATextInput' },
+    Int: { component: 'ANumericInput' },
+    Float: { component: 'ANumericInput' },
+    Boolean: { component: 'ACheckbox' },
+    ID: { component: 'ATextInput' },
 };
 /**
  * Mapping from well-known custom GraphQL scalars to Stonecrop field types.
@@ -32,25 +32,25 @@ export const GQL_SCALAR_MAP = {
  * @public
  */
 export const WELL_KNOWN_SCALARS = {
-    // Arbitrary precision / large numbers
-    BigFloat: { component: 'ADecimalInput', fieldtype: 'Decimal' },
-    BigDecimal: { component: 'ADecimalInput', fieldtype: 'Decimal' },
-    Decimal: { component: 'ADecimalInput', fieldtype: 'Decimal' },
-    BigInt: { component: 'ANumericInput', fieldtype: 'Int' },
-    Long: { component: 'ANumericInput', fieldtype: 'Int' },
+    // Arbitrary precision / large numbers — all numeric variants render with ANumericInput.
+    BigFloat: { component: 'ANumericInput' },
+    BigDecimal: { component: 'ANumericInput' },
+    Decimal: { component: 'ANumericInput' },
+    BigInt: { component: 'ANumericInput' },
+    Long: { component: 'ANumericInput' },
     // Identifiers
-    UUID: { component: 'ATextInput', fieldtype: 'Data' },
-    // Date / Time
-    DateTime: { component: 'ADatetimePicker', fieldtype: 'Datetime' },
-    Datetime: { component: 'ADatetimePicker', fieldtype: 'Datetime' },
-    Date: { component: 'ADate', fieldtype: 'Date' },
-    Time: { component: 'ATimeInput', fieldtype: 'Time' },
-    Interval: { component: 'ADurationInput', fieldtype: 'Duration' },
-    Duration: { component: 'ADurationInput', fieldtype: 'Duration' },
+    UUID: { component: 'ATextInput' },
+    // Date / Time — no dedicated Time SFC exists; Time falls back to a plain text input.
+    DateTime: { component: 'ADateTime' },
+    Datetime: { component: 'ADateTime' },
+    Date: { component: 'ADate' },
+    Time: { component: 'ATextInput' },
+    Interval: { component: 'ADuration' },
+    Duration: { component: 'ADuration' },
     // Structured data
-    JSON: { component: 'ACodeEditor', fieldtype: 'JSON' },
-    JSONObject: { component: 'ACodeEditor', fieldtype: 'JSON' },
-    JsonNode: { component: 'ACodeEditor', fieldtype: 'JSON' },
+    JSON: { component: 'ACodeEditor' },
+    JSONObject: { component: 'ACodeEditor' },
+    JsonNode: { component: 'ACodeEditor' },
 };
 /**
  * Set of scalar type names that are internal to GraphQL servers and should be skipped
@@ -76,10 +76,7 @@ export function buildScalarMap(customScalars) {
     // Custom scalars override everything
     if (customScalars) {
         for (const [key, value] of Object.entries(customScalars)) {
-            merged[key] = {
-                component: value.component ?? 'ATextInput',
-                fieldtype: value.fieldtype ?? 'Data',
-            };
+            merged[key] = { component: value.component ?? 'ATextInput' };
         }
     }
     return merged;

package/dist/src/converter/types.d.ts

@@ -6,7 +6,18 @@
 import type { IntrospectionQuery } from 'graphql';
 import type { GraphQLObjectType, GraphQLField } from 'graphql';
 import type { ValueField } from '../field';
-import type { FieldTemplate } from '../fieldtype';
+/**
+ * The component a GraphQL scalar maps to.
+ *
+ * A one-property interface rather than a bare string so `customScalars` stays extensible: an
+ * override is a `Partial<FieldTemplate>`, and widening this later does not change that signature.
+ *
+ * @public
+ */
+export interface FieldTemplate {
+    /** The Vue component name to render fields of this scalar type (e.g. `'ATextInput'`). */
+    component: string;
+}
 /**
  * Input source for the GraphQL schema converter.
  * Accepts either a standard GraphQL introspection result or an SDL string.
@@ -46,22 +57,22 @@ export interface GraphQLConversionOptions {
      * ```typescript
      * {
      *   SalesOrder: {
-     *     totalAmount: { fieldtype: 'Currency', component: 'ACurrencyInput' }
+     *     totalAmount: { component: 'ANumericInput', align: 'right' }
      *   }
      * }
      * ```
      */
     typeOverrides?: Record<string, Record<string, Omit<Partial<ValueField>, 'kind'>>>;
     /**
-     * Map custom or non-standard GraphQL scalar types to Stonecrop field types.
+     * Map custom or non-standard GraphQL scalar types to the component that renders them.
      * Merged with the built-in scalar maps (GQL_SCALAR_MAP + WELL_KNOWN_SCALARS).
      * User-provided entries take highest precedence.
      *
      * @example
      * ```typescript
      * {
-     *   MyCustomMoney: { component: 'ACurrencyInput', fieldtype: 'Currency' },
-     *   PostGISPoint: { component: 'ATextInput', fieldtype: 'Data' }
+     *   MyCustomMoney: { component: 'ANumericInput' },
+     *   PostGISPoint: { component: 'ATextInput' }
      * }
      * ```
      */
@@ -114,9 +125,7 @@ export interface GraphQLConversionOptions {
  *
  * @public
  */
-export interface GraphQLConversionFieldMeta extends Omit<ValueField, 'fieldtype'> {
-    /** Semantic field type - optional for link fields which don't have a fieldtype */
-    fieldtype?: string;
+export interface GraphQLConversionFieldMeta extends ValueField {
     /** Original GraphQL type name (for debugging/reference) */
     _graphqlType?: string;
     /** Marks fields that couldn't be automatically mapped */

package/dist/src/converter/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/converter/types.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,SAAS,CAAA;AACjD,OAAO,KAAK,EAAE,iBAAiB,EAAE,YAAY,EAAE,MAAM,SAAS,CAAA;AAE9D,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,UAAU,CAAA;AAC1C,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,cAAc,CAAA;AAEjD;;;;;;;;;;;;GAYG;AACH,MAAM,MAAM,mBAAmB,GAAG,kBAAkB,GAAG,MAAM,CAAA;AAE7D;;;;;GAKG;AACH,MAAM,WAAW,wBAAwB;IACxC;;;OAGG;IACH,OAAO,CAAC,EAAE,MAAM,EAAE,CAAA;IAElB;;;OAGG;IACH,OAAO,CAAC,EAAE,MAAM,EAAE,CAAA;IAElB;;;;;;;;;;;;OAYG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC,CAAC,CAAC,CAAA;IAEjF;;;;;;;;;;;;OAYG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,aAAa,CAAC,CAAC,CAAA;IAEtD;;;;;;;;;;;OAWG;IACH,YAAY,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,iBAAiB,KAAK,OAAO,CAAA;IAErE;;;;;;;;;;OAUG;IACH,aAAa,CAAC,EAAE,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,YAAY,CAAC,OAAO,EAAE,OAAO,CAAC,EAAE,UAAU,EAAE,iBAAiB,KAAK,OAAO,CAAA;IAEpH;;;;;;;;;OASG;IACH,aAAa,CAAC,EAAE,CACf,SAAS,EAAE,MAAM,EACjB,KAAK,EAAE,YAAY,CAAC,OAAO,EAAE,OAAO,CAAC,EACrC,UAAU,EAAE,iBAAiB,KACzB,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC,GAAG,IAAI,CAAA;IAE7C;;;OAGG;IACH,mBAAmB,CAAC,EAAE,OAAO,CAAA;CAC7B;AAED;;;;;GAKG;AACH,MAAM,WAAW,0BAA2B,SAAQ,IAAI,CAAC,UAAU,EAAE,WAAW,CAAC;IAChF,kFAAkF;IAClF,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,2DAA2D;IAC3D,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,yDAAyD;IACzD,SAAS,CAAC,EAAE,OAAO,CAAA;IACnB,qEAAqE;IACrE,OAAO,CAAC,EAAE,OAAO,CAAA;CACjB;AAED;;;;GAIG;AACH,MAAM,WAAW,uBAAwB,SAAQ,IAAI,CAAC,WAAW,EAAE,QAAQ,CAAC;IAC3E,iGAAiG;IACjG,MAAM,EAAE,UAAU,EAAE,CAAA;IACpB,2DAA2D;IAC3D,gBAAgB,CAAC,EAAE,MAAM,CAAA;CACzB;AAGD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAA"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/converter/types.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,SAAS,CAAA;AACjD,OAAO,KAAK,EAAE,iBAAiB,EAAE,YAAY,EAAE,MAAM,SAAS,CAAA;AAE9D,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,UAAU,CAAA;AAE1C;;;;;;;GAOG;AACH,MAAM,WAAW,aAAa;IAC7B,yFAAyF;IACzF,SAAS,EAAE,MAAM,CAAA;CACjB;AAED;;;;;;;;;;;;GAYG;AACH,MAAM,MAAM,mBAAmB,GAAG,kBAAkB,GAAG,MAAM,CAAA;AAE7D;;;;;GAKG;AACH,MAAM,WAAW,wBAAwB;IACxC;;;OAGG;IACH,OAAO,CAAC,EAAE,MAAM,EAAE,CAAA;IAElB;;;OAGG;IACH,OAAO,CAAC,EAAE,MAAM,EAAE,CAAA;IAElB;;;;;;;;;;;;OAYG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC,CAAC,CAAC,CAAA;IAEjF;;;;;;;;;;;;OAYG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,aAAa,CAAC,CAAC,CAAA;IAEtD;;;;;;;;;;;OAWG;IACH,YAAY,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,iBAAiB,KAAK,OAAO,CAAA;IAErE;;;;;;;;;;OAUG;IACH,aAAa,CAAC,EAAE,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,YAAY,CAAC,OAAO,EAAE,OAAO,CAAC,EAAE,UAAU,EAAE,iBAAiB,KAAK,OAAO,CAAA;IAEpH;;;;;;;;;OASG;IACH,aAAa,CAAC,EAAE,CACf,SAAS,EAAE,MAAM,EACjB,KAAK,EAAE,YAAY,CAAC,OAAO,EAAE,OAAO,CAAC,EACrC,UAAU,EAAE,iBAAiB,KACzB,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC,GAAG,IAAI,CAAA;IAE7C;;;OAGG;IACH,mBAAmB,CAAC,EAAE,OAAO,CAAA;CAC7B;AAED;;;;;GAKG;AACH,MAAM,WAAW,0BAA2B,SAAQ,UAAU;IAC7D,2DAA2D;IAC3D,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,yDAAyD;IACzD,SAAS,CAAC,EAAE,OAAO,CAAA;IACnB,qEAAqE;IACrE,OAAO,CAAC,EAAE,OAAO,CAAA;CACjB;AAED;;;;GAIG;AACH,MAAM,WAAW,uBAAwB,SAAQ,IAAI,CAAC,WAAW,EAAE,QAAQ,CAAC;IAC3E,iGAAiG;IACjG,MAAM,EAAE,UAAU,EAAE,CAAA;IACpB,2DAA2D;IAC3D,gBAAgB,CAAC,EAAE,MAAM,CAAA;CACzB;AAGD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAA"}