@happyvertical/smrt-svelte 0.55.23 → 0.55.24

package/dist/components/screens/fields.d.ts

@@ -10,6 +10,7 @@
  * `basic` markers anywhere => everything basic; any marker => unmarked fields
  * advanced).
  */
+import { type FieldRole } from './roles.js';
 import type { ScreenCollectionDefinition, ScreenField, ScreenFieldDefinition, ScreenInputKind, ScreenMode, ScreenPolicy } from './types.js';
 /** Columns shown by default on a list when the policy marks many basic. */
 export declare const DEFAULT_MAX_LIST_COLUMNS = 6;
@@ -27,13 +28,22 @@ export interface DeriveScreenFieldsOptions {
 }
 /** `dueDate` -> `Due date`; reference fields drop a trailing `Id`. */
 export declare function humanizeFieldName(name: string): string;
+/** Default label of a field: reference fields drop a trailing `Id`. */
+export declare function humanizeLabel(name: string, definition: ScreenFieldDefinition): string;
 /** Singular and plural display names derived from the class name. */
 export declare function screenTitles(definition: ScreenCollectionDefinition): {
     singular: string;
     plural: string;
 };
-/** Which control renders a field, from its widget hint and wire type. */
-export declare function inputKindFor(definition: ScreenFieldDefinition): ScreenInputKind;
+/**
+ * Which control renders a field, from its wire type, its `enum`, its widget
+ * hint and its roles (`deriveFieldRoles`): a text field with an `enum` is a
+ * `select`; an INTEGER field with the `money` role (an explicit role, a
+ * `format: 'money'` hint, the legacy `ui.widget: 'currency'`, or a money
+ * name like `totalAmount`) is `money`. Without `roles`, only the
+ * definition's own hints count.
+ */
+export declare function inputKindFor(definition: ScreenFieldDefinition, roles?: readonly FieldRole[]): ScreenInputKind;
 /**
  * Mismatch between a definition and a policy, or `null` when they belong
  * together. Components surface this instead of rendering the wrong object.

package/dist/components/screens/fields.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"fields.d.ts","sourceRoot":"","sources":["../../../src/components/screens/fields.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AACH,OAAO,KAAK,EACV,0BAA0B,EAC1B,WAAW,EACX,qBAAqB,EACrB,eAAe,EACf,UAAU,EACV,YAAY,EACb,MAAM,YAAY,CAAC;AAepB,2EAA2E;AAC3E,eAAO,MAAM,wBAAwB,IAAI,CAAC;AAE1C,MAAM,WAAW,yBAAyB;IACxC,IAAI,EAAE,UAAU,CAAC;IACjB;;;OAGG;IACH,OAAO,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAC5B,2BAA2B;IAC3B,OAAO,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAC5B,0EAA0E;IAC1E,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,sEAAsE;AACtE,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAStD;AAaD,qEAAqE;AACrE,wBAAgB,YAAY,CAAC,UAAU,EAAE,0BAA0B,GAAG;IACpE,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;CAChB,CAWA;AAED,yEAAyE;AACzE,wBAAgB,YAAY,CAC1B,UAAU,EAAE,qBAAqB,GAChC,eAAe,CA0BjB;AAUD;;;GAGG;AACH,wBAAgB,iBAAiB,CAC/B,UAAU,EAAE,0BAA0B,EACtC,MAAM,EAAE,YAAY,GAAG,SAAS,GAAG,IAAI,GACtC,MAAM,GAAG,IAAI,CAKf;AAiCD;;;;;;;;GAQG;AACH,wBAAgB,kBAAkB,CAChC,UAAU,EAAE,0BAA0B,EACtC,MAAM,EAAE,YAAY,GAAG,SAAS,GAAG,IAAI,EACvC,OAAO,EAAE,yBAAyB,GACjC,WAAW,EAAE,CA6Gf;AAED,2EAA2E;AAC3E,wBAAgB,iBAAiB,CAC/B,MAAM,EAAE,SAAS,WAAW,EAAE,GAC7B,KAAK,CAAC,CAAC,MAAM,GAAG,IAAI,EAAE,WAAW,EAAE,CAAC,CAAC,CAQvC"}
+{"version":3,"file":"fields.d.ts","sourceRoot":"","sources":["../../../src/components/screens/fields.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AACH,OAAO,EAAoB,KAAK,SAAS,EAAE,MAAM,YAAY,CAAC;AAC9D,OAAO,KAAK,EACV,0BAA0B,EAC1B,WAAW,EACX,qBAAqB,EACrB,eAAe,EACf,UAAU,EACV,YAAY,EACb,MAAM,YAAY,CAAC;AAepB,2EAA2E;AAC3E,eAAO,MAAM,wBAAwB,IAAI,CAAC;AAE1C,MAAM,WAAW,yBAAyB;IACxC,IAAI,EAAE,UAAU,CAAC;IACjB;;;OAGG;IACH,OAAO,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAC5B,2BAA2B;IAC3B,OAAO,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAC5B,0EAA0E;IAC1E,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,sEAAsE;AACtE,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAStD;AAED,uEAAuE;AACvE,wBAAgB,aAAa,CAC3B,IAAI,EAAE,MAAM,EACZ,UAAU,EAAE,qBAAqB,GAChC,MAAM,CASR;AAED,qEAAqE;AACrE,wBAAgB,YAAY,CAAC,UAAU,EAAE,0BAA0B,GAAG;IACpE,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;CAChB,CAWA;AAED;;;;;;;GAOG;AACH,wBAAgB,YAAY,CAC1B,UAAU,EAAE,qBAAqB,EACjC,KAAK,CAAC,EAAE,SAAS,SAAS,EAAE,GAC3B,eAAe,CAgCjB;AAUD;;;GAGG;AACH,wBAAgB,iBAAiB,CAC/B,UAAU,EAAE,0BAA0B,EACtC,MAAM,EAAE,YAAY,GAAG,SAAS,GAAG,IAAI,GACtC,MAAM,GAAG,IAAI,CAKf;AAiCD;;;;;;;;GAQG;AACH,wBAAgB,kBAAkB,CAChC,UAAU,EAAE,0BAA0B,EACtC,MAAM,EAAE,YAAY,GAAG,SAAS,GAAG,IAAI,EACvC,OAAO,EAAE,yBAAyB,GACjC,WAAW,EAAE,CAmHf;AAED,2EAA2E;AAC3E,wBAAgB,iBAAiB,CAC/B,MAAM,EAAE,SAAS,WAAW,EAAE,GAC7B,KAAK,CAAC,CAAC,MAAM,GAAG,IAAI,EAAE,WAAW,EAAE,CAAC,CAAC,CAQvC"}

package/dist/components/screens/fields.js

@@ -1,3 +1,16 @@
+/**
+ * Pure derivation of list / view / edit fields from a manifest-derived
+ * collection definition and its resolved field policy (#3718).
+ *
+ * Mirrors smrt-fields' `ObjectForm` selection rule: a field renders only when
+ * it is in BOTH the generated web definition and the resolved policy, so
+ * sensitive, transient and read-permission-gated fields (which the policy
+ * resolver omits) can never appear on a generated screen. Without a policy the
+ * code seed applies: the manifest `ui` hints and the cold-start rule (no
+ * `basic` markers anywhere => everything basic; any marker => unmarked fields
+ * advanced).
+ */
+import { deriveFieldRoles } from './roles.js';
 /** Managed by the platform; never editable and never a default column. */
 const SYSTEM_FIELDS = new Set([
     'id',
@@ -23,7 +36,8 @@ export function humanizeFieldName(name) {
     const lower = spaced.toLowerCase();
     return lower.charAt(0).toUpperCase() + lower.slice(1);
 }
-function humanizeLabel(name, definition) {
+/** Default label of a field: reference fields drop a trailing `Id`. */
+export function humanizeLabel(name, definition) {
     if ((definition.type === 'foreignKey' ||
         definition.type === 'crossPackageRef') &&
         /.[a-z]Id$/.test(name)) {
@@ -44,10 +58,19 @@ export function screenTitles(definition) {
                 : `${singular}s`;
     return { singular, plural };
 }
-/** Which control renders a field, from its widget hint and wire type. */
-export function inputKindFor(definition) {
+/**
+ * Which control renders a field, from its wire type, its `enum`, its widget
+ * hint and its roles (`deriveFieldRoles`): a text field with an `enum` is a
+ * `select`; an INTEGER field with the `money` role (an explicit role, a
+ * `format: 'money'` hint, the legacy `ui.widget: 'currency'`, or a money
+ * name like `totalAmount`) is `money`. Without `roles`, only the
+ * definition's own hints count.
+ */
+export function inputKindFor(definition, roles) {
     const widget = definition.ui?.widget;
     if (definition.type === 'text') {
+        if (Array.isArray(definition.enum) && definition.enum.length > 0)
+            return 'select';
         if (widget === 'textarea')
             return 'textarea';
         if (widget === 'email')
@@ -61,7 +84,10 @@ export function inputKindFor(definition) {
     // Money is integer minor units only; a currency hint on a decimal is a
     // plain decimal (rates and confidences are the only decimals).
     if (definition.type === 'integer') {
-        return widget === 'currency' ? 'money' : 'integer';
+        const money = roles?.includes('money') ??
+            (widget === 'currency' ||
+                (definition.format ?? definition.ui?.format) === 'money');
+        return money ? 'money' : 'integer';
     }
     switch (definition.type) {
         case 'decimal':
@@ -132,6 +158,7 @@ export function deriveScreenFields(definition, policy, options) {
         !SYSTEM_FIELDS.has(c.name) &&
         c.name !== definition.idField);
     const seedBasic = policy ? null : seedBasicSet(candidates);
+    const roles = deriveFieldRoles(definition);
     const decorate = (c) => {
         const policyField = policy?.fields[c.name];
         if (policy && !policyField)
@@ -145,17 +172,21 @@ export function deriveScreenFields(definition, policy, options) {
             return null;
         const label = policyField?.label?.trim();
         const help = policyField?.help ?? c.definition.description ?? null;
+        const fieldRoles = roles[c.name] ?? [];
+        const kind = inputKindFor(c.definition, fieldRoles);
         return {
             name: c.name,
             label: label || humanizeLabel(c.name, c.definition),
             help: help && help.trim() !== '' ? help : null,
             type: c.definition.type,
-            kind: inputKindFor(c.definition),
+            kind,
             required: isRequired(c.definition, policyField?.required),
             tier,
             group: policyField?.group ?? c.definition.ui?.group ?? null,
             order: policyField?.order ?? c.definition.ui?.order ?? null,
             definition: c.definition,
+            roles: fieldRoles,
+            ...(kind === 'select' ? { options: [...(c.definition.enum ?? [])] } : {}),
         };
     };
     const decorated = candidates
@@ -177,6 +208,7 @@ export function deriveScreenFields(definition, policy, options) {
             group: null,
             order: null,
             definition: fieldDefinition,
+            roles: roles[name] ?? [],
         };
     };
     if (include) {

package/dist/components/screens/index.d.ts

@@ -1,8 +1,13 @@
+export { lineItemColumns, relatedColumns } from './columns.js';
 export { default as DetailScreen } from './DetailScreen.svelte';
 export { default as EditForm } from './EditForm.svelte';
 export { DEFAULT_MAX_LIST_COLUMNS, type DeriveScreenFieldsOptions, deriveScreenFields, groupScreenFields, humanizeFieldName, inputKindFor, screenSourceError, screenTitles, } from './fields.js';
 export { default as ListScreen } from './ListScreen.svelte';
 export { default as RecipeScreens } from './RecipeScreens.svelte';
-export type { DetailScreenProps, EditFormProps, EditFormSubmitResult, ListScreenProps, RecipeScreensProps, RecipeScreensSource, RecipeScreenView, ScreenCollectionDefinition, ScreenDraft, ScreenDraftValue, ScreenField, ScreenFieldDefinition, ScreenFieldErrorCode, ScreenFieldPolicy, ScreenFieldType, ScreenFieldUIHints, ScreenFieldVisibility, ScreenInputKind, ScreenMode, ScreenPolicy, ScreenRecord, } from './types.js';
-export { compareScreenValues, currencyMinorDigits, DEFAULT_SCREEN_CURRENCY, draftForCreate, draftFromRecord, type FormatValueContext, formatScreenValue, majorStringToMinorUnits, minorUnitsToMajorString, type ParsedDraft, parseDraft, toDatetimeLocal, toDraftValue, } from './values.js';
+export { default as RecordScreen } from './RecordScreen.svelte';
+export { deriveRecordHeader, RECORD_HEADER_MAX_FACTS, type RecordFact, type RecordFactKind, type RecordHeaderModel, recordTotals, totalsFields, } from './record-header.js';
+export { deriveScreenRelations, relationKey, type ScreenRelation, } from './relations.js';
+export { currencyCodeField, deriveFieldRoles, FIELD_ROLES, type FieldRole, fieldsWithRole, fieldWithRole, hasLineItemRoles, isDocumentLike, type ScreenFieldRoles, } from './roles.js';
+export type { DetailScreenProps, EditFormProps, EditFormSubmitResult, ListScreenProps, RecipeScreensProps, RecipeScreensSource, RecipeScreenView, RecordScreenMode, RecordScreenProps, ScreenCollectionDefinition, ScreenDraft, ScreenDraftValue, ScreenField, ScreenFieldDefinition, ScreenFieldErrorCode, ScreenFieldFormat, ScreenFieldPolicy, ScreenFieldType, ScreenFieldUIHints, ScreenFieldVisibility, ScreenInputKind, ScreenMode, ScreenPolicy, ScreenRecord, ScreenRelationshipDefinition, ScreenRelationshipKind, } from './types.js';
+export { compareScreenValues, currencyMinorDigits, DEFAULT_SCREEN_CURRENCY, draftForCreate, draftFromRecord, type FormatValueContext, formatScreenValue, jsonScreenEntries, majorStringToMinorUnits, minorUnitsToMajorString, type ParsedDraft, parseDraft, type ScreenJsonEntry, shortScreenId, toDatetimeLocal, toDraftValue, } from './values.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/components/screens/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/components/screens/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,IAAI,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAChE,OAAO,EAAE,OAAO,IAAI,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AACxD,OAAO,EACL,wBAAwB,EACxB,KAAK,yBAAyB,EAC9B,kBAAkB,EAClB,iBAAiB,EACjB,iBAAiB,EACjB,YAAY,EACZ,iBAAiB,EACjB,YAAY,GACb,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,OAAO,IAAI,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAC5D,OAAO,EAAE,OAAO,IAAI,aAAa,EAAE,MAAM,wBAAwB,CAAC;AAClE,YAAY,EACV,iBAAiB,EACjB,aAAa,EACb,oBAAoB,EACpB,eAAe,EACf,kBAAkB,EAClB,mBAAmB,EACnB,gBAAgB,EAChB,0BAA0B,EAC1B,WAAW,EACX,gBAAgB,EAChB,WAAW,EACX,qBAAqB,EACrB,oBAAoB,EACpB,iBAAiB,EACjB,eAAe,EACf,kBAAkB,EAClB,qBAAqB,EACrB,eAAe,EACf,UAAU,EACV,YAAY,EACZ,YAAY,GACb,MAAM,YAAY,CAAC;AACpB,OAAO,EACL,mBAAmB,EACnB,mBAAmB,EACnB,uBAAuB,EACvB,cAAc,EACd,eAAe,EACf,KAAK,kBAAkB,EACvB,iBAAiB,EACjB,uBAAuB,EACvB,uBAAuB,EACvB,KAAK,WAAW,EAChB,UAAU,EACV,eAAe,EACf,YAAY,GACb,MAAM,aAAa,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/components/screens/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAC/D,OAAO,EAAE,OAAO,IAAI,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAChE,OAAO,EAAE,OAAO,IAAI,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AACxD,OAAO,EACL,wBAAwB,EACxB,KAAK,yBAAyB,EAC9B,kBAAkB,EAClB,iBAAiB,EACjB,iBAAiB,EACjB,YAAY,EACZ,iBAAiB,EACjB,YAAY,GACb,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,OAAO,IAAI,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAC5D,OAAO,EAAE,OAAO,IAAI,aAAa,EAAE,MAAM,wBAAwB,CAAC;AAClE,OAAO,EAAE,OAAO,IAAI,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAChE,OAAO,EACL,kBAAkB,EAClB,uBAAuB,EACvB,KAAK,UAAU,EACf,KAAK,cAAc,EACnB,KAAK,iBAAiB,EACtB,YAAY,EACZ,YAAY,GACb,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EACL,qBAAqB,EACrB,WAAW,EACX,KAAK,cAAc,GACpB,MAAM,gBAAgB,CAAC;AACxB,OAAO,EACL,iBAAiB,EACjB,gBAAgB,EAChB,WAAW,EACX,KAAK,SAAS,EACd,cAAc,EACd,aAAa,EACb,gBAAgB,EAChB,cAAc,EACd,KAAK,gBAAgB,GACtB,MAAM,YAAY,CAAC;AACpB,YAAY,EACV,iBAAiB,EACjB,aAAa,EACb,oBAAoB,EACpB,eAAe,EACf,kBAAkB,EAClB,mBAAmB,EACnB,gBAAgB,EAChB,gBAAgB,EAChB,iBAAiB,EACjB,0BAA0B,EAC1B,WAAW,EACX,gBAAgB,EAChB,WAAW,EACX,qBAAqB,EACrB,oBAAoB,EACpB,iBAAiB,EACjB,iBAAiB,EACjB,eAAe,EACf,kBAAkB,EAClB,qBAAqB,EACrB,eAAe,EACf,UAAU,EACV,YAAY,EACZ,YAAY,EACZ,4BAA4B,EAC5B,sBAAsB,GACvB,MAAM,YAAY,CAAC;AACpB,OAAO,EACL,mBAAmB,EACnB,mBAAmB,EACnB,uBAAuB,EACvB,cAAc,EACd,eAAe,EACf,KAAK,kBAAkB,EACvB,iBAAiB,EACjB,iBAAiB,EACjB,uBAAuB,EACvB,uBAAuB,EACvB,KAAK,WAAW,EAChB,UAAU,EACV,KAAK,eAAe,EACpB,aAAa,EACb,eAAe,EACf,YAAY,GACb,MAAM,aAAa,CAAC"}

package/dist/components/screens/index.js

@@ -1,6 +1,11 @@
+export { lineItemColumns, relatedColumns } from './columns.js';
 export { default as DetailScreen } from './DetailScreen.svelte';
 export { default as EditForm } from './EditForm.svelte';
 export { DEFAULT_MAX_LIST_COLUMNS, deriveScreenFields, groupScreenFields, humanizeFieldName, inputKindFor, screenSourceError, screenTitles, } from './fields.js';
 export { default as ListScreen } from './ListScreen.svelte';
 export { default as RecipeScreens } from './RecipeScreens.svelte';
-export { compareScreenValues, currencyMinorDigits, DEFAULT_SCREEN_CURRENCY, draftForCreate, draftFromRecord, formatScreenValue, majorStringToMinorUnits, minorUnitsToMajorString, parseDraft, toDatetimeLocal, toDraftValue, } from './values.js';
+export { default as RecordScreen } from './RecordScreen.svelte';
+export { deriveRecordHeader, RECORD_HEADER_MAX_FACTS, recordTotals, totalsFields, } from './record-header.js';
+export { deriveScreenRelations, relationKey, } from './relations.js';
+export { currencyCodeField, deriveFieldRoles, FIELD_ROLES, fieldsWithRole, fieldWithRole, hasLineItemRoles, isDocumentLike, } from './roles.js';
+export { compareScreenValues, currencyMinorDigits, DEFAULT_SCREEN_CURRENCY, draftForCreate, draftFromRecord, formatScreenValue, jsonScreenEntries, majorStringToMinorUnits, minorUnitsToMajorString, parseDraft, shortScreenId, toDatetimeLocal, toDraftValue, } from './values.js';

package/dist/components/screens/record-header.d.ts

@@ -0,0 +1,51 @@
+import { type ScreenFieldRoles } from './roles.js';
+import type { ScreenCollectionDefinition, ScreenField, ScreenRecord } from './types.js';
+export type RecordFactKind = 'party' | 'date' | 'money' | 'contact';
+export interface RecordFact {
+    kind: RecordFactKind;
+    field: ScreenField;
+}
+export interface RecordHeaderModel {
+    heading: string;
+    /** The heading leads with the identifier (a document): render it monospace there. */
+    headingIdentifier: boolean;
+    identifier?: {
+        field: ScreenField;
+        value: string;
+    };
+    status?: {
+        field: ScreenField;
+        value: string;
+    };
+    facts: RecordFact[];
+    /** Fields the header shows; the details card leaves them out. */
+    shown: string[];
+}
+/** Most key facts in a header. */
+export declare const RECORD_HEADER_MAX_FACTS = 4;
+/**
+ * The header of `record`: `fields` are the view fields
+ * (`deriveScreenFields(..., { mode: 'view' })`), `roles` the definition's
+ * (`deriveFieldRoles`).
+ */
+export declare function deriveRecordHeader(definition: ScreenCollectionDefinition, fields: readonly ScreenField[], record: ScreenRecord, roles: ScreenFieldRoles, options?: {
+    title?: string;
+    maxFacts?: number;
+}): RecordHeaderModel;
+/**
+ * The record's own totals, read by role (`subtotal`, `discount`, `tax`,
+ * `total`): what the line-items totals block shows as authoritative. With
+ * `visible` (the policy-filtered view fields), a field the policy omits is
+ * never read.
+ */
+export declare function recordTotals(record: ScreenRecord, roles: ScreenFieldRoles, visible?: readonly {
+    name: string;
+}[]): {
+    subtotal?: number | null;
+    discount?: number | null;
+    tax?: number | null;
+    total?: number | null;
+};
+/** Fields holding a totals role (`subtotal` / `discount` / `tax` / `total`). */
+export declare function totalsFields(roles: ScreenFieldRoles): string[];
+//# sourceMappingURL=record-header.d.ts.map

package/dist/components/screens/record-header.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"record-header.d.ts","sourceRoot":"","sources":["../../../src/components/screens/record-header.ts"],"names":[],"mappings":"AAcA,OAAO,EAAkB,KAAK,gBAAgB,EAAE,MAAM,YAAY,CAAC;AACnE,OAAO,KAAK,EACV,0BAA0B,EAC1B,WAAW,EACX,YAAY,EACb,MAAM,YAAY,CAAC;AAEpB,MAAM,MAAM,cAAc,GAAG,OAAO,GAAG,MAAM,GAAG,OAAO,GAAG,SAAS,CAAC;AAEpE,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,cAAc,CAAC;IACrB,KAAK,EAAE,WAAW,CAAC;CACpB;AAED,MAAM,WAAW,iBAAiB;IAChC,OAAO,EAAE,MAAM,CAAC;IAChB,qFAAqF;IACrF,iBAAiB,EAAE,OAAO,CAAC;IAC3B,UAAU,CAAC,EAAE;QAAE,KAAK,EAAE,WAAW,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC;IACnD,MAAM,CAAC,EAAE;QAAE,KAAK,EAAE,WAAW,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC;IAC/C,KAAK,EAAE,UAAU,EAAE,CAAC;IACpB,iEAAiE;IACjE,KAAK,EAAE,MAAM,EAAE,CAAC;CACjB;AAED,kCAAkC;AAClC,eAAO,MAAM,uBAAuB,IAAI,CAAC;AAYzC;;;;GAIG;AACH,wBAAgB,kBAAkB,CAChC,UAAU,EAAE,0BAA0B,EACtC,MAAM,EAAE,SAAS,WAAW,EAAE,EAC9B,MAAM,EAAE,YAAY,EACpB,KAAK,EAAE,gBAAgB,EACvB,OAAO,GAAE;IAAE,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;CAAO,GAClD,iBAAiB,CAyEnB;AAED;;;;;GAKG;AACH,wBAAgB,YAAY,CAC1B,MAAM,EAAE,YAAY,EACpB,KAAK,EAAE,gBAAgB,EACvB,OAAO,CAAC,EAAE,SAAS;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,EAAE,GACpC;IACD,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,GAAG,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACpB,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CACvB,CAcA;AAED,gFAAgF;AAChF,wBAAgB,YAAY,CAAC,KAAK,EAAE,gBAAgB,GAAG,MAAM,EAAE,CAM9D"}

package/dist/components/screens/record-header.js

@@ -0,0 +1,118 @@
+/**
+ * The record page header (#3718 record page), pure and Node-tested: the
+ * heading, the monospace identifier, the status and two to four key facts,
+ * all read by role from the fields the screen may show (so a field the
+ * policy omits can never reach the header).
+ *
+ * - Heading: the `title` prop, else a document's kind and identifier
+ *   ("Order GRA-3159", never the customer), else the title-role field, else
+ *   the identifier, else the class name.
+ * - Facts, in order: the party (a link), the lead date, the total money (the
+ *   `total` role, else the first money field), then a contact (email, then
+ *   phone) while there is room. Empty values are skipped.
+ */
+import { screenTitles } from './fields.js';
+import { isDocumentLike } from './roles.js';
+/** Most key facts in a header. */
+export const RECORD_HEADER_MAX_FACTS = 4;
+function present(value) {
+    if (value === null || value === undefined)
+        return false;
+    if (typeof value === 'string')
+        return value.trim() !== '';
+    return true;
+}
+function hasRole(field, role) {
+    return (field.roles ?? []).includes(role);
+}
+/**
+ * The header of `record`: `fields` are the view fields
+ * (`deriveScreenFields(..., { mode: 'view' })`), `roles` the definition's
+ * (`deriveFieldRoles`).
+ */
+export function deriveRecordHeader(definition, fields, record, roles, options = {}) {
+    const { singular } = screenTitles(definition);
+    const filled = fields.filter((f) => present(record[f.name]));
+    const find = (role) => filled.find((f) => hasRole(f, role));
+    const shown = [];
+    const titleField = find('title');
+    const identifierField = find('identifier');
+    const statusField = find('status');
+    const identifierValue = identifierField
+        ? String(record[identifierField.name])
+        : undefined;
+    let heading;
+    let headingIdentifier = false;
+    if (options.title) {
+        heading = options.title;
+    }
+    else if (identifierValue && isDocumentLike(roles)) {
+        heading = `${singular} ${identifierValue}`;
+        headingIdentifier = true;
+    }
+    else if (titleField) {
+        heading = String(record[titleField.name]);
+    }
+    else if (identifierValue) {
+        heading = identifierValue;
+        headingIdentifier = true;
+    }
+    else {
+        heading = singular;
+    }
+    if (titleField && !headingIdentifier && !options.title)
+        shown.push(titleField.name);
+    const out = {
+        heading,
+        headingIdentifier,
+        facts: [],
+        shown,
+    };
+    if (identifierField && identifierValue) {
+        out.identifier = { field: identifierField, value: identifierValue };
+        shown.push(identifierField.name);
+    }
+    if (statusField) {
+        out.status = {
+            field: statusField,
+            value: String(record[statusField.name]),
+        };
+        shown.push(statusField.name);
+    }
+    const max = options.maxFacts ?? RECORD_HEADER_MAX_FACTS;
+    const add = (kind, field) => {
+        if (!field || shown.includes(field.name) || out.facts.length >= max)
+            return;
+        out.facts.push({ kind, field });
+        shown.push(field.name);
+    };
+    add('party', find('party'));
+    add('date', filled.find((f) => hasRole(f, 'date') && f.name !== 'createdAt' && f.name !== 'updatedAt'));
+    add('money', find('total') ?? find('money'));
+    add('contact', filled.find((f) => f.kind === 'email'));
+    add('contact', filled.find((f) => f.kind === 'tel'));
+    return out;
+}
+/**
+ * The record's own totals, read by role (`subtotal`, `discount`, `tax`,
+ * `total`): what the line-items totals block shows as authoritative. With
+ * `visible` (the policy-filtered view fields), a field the policy omits is
+ * never read.
+ */
+export function recordTotals(record, roles, visible) {
+    const out = {};
+    for (const role of ['subtotal', 'discount', 'tax', 'total']) {
+        const field = Object.keys(roles).find((name) => roles[name]?.includes(role) &&
+            (!visible || visible.some((f) => f.name === name)));
+        if (!field)
+            continue;
+        const value = record[field];
+        out[role] =
+            typeof value === 'number' && Number.isSafeInteger(value) ? value : null;
+    }
+    return out;
+}
+/** Fields holding a totals role (`subtotal` / `discount` / `tax` / `total`). */
+export function totalsFields(roles) {
+    return Object.keys(roles).filter((name) => ['subtotal', 'discount', 'tax', 'total'].some((role) => roles[name]?.includes(role)));
+}

package/dist/components/screens/relations.d.ts

@@ -0,0 +1,49 @@
+/**
+ * Pure derivation of a model's relations from the generated web collection
+ * definitions (#3718 record view).
+ *
+ * A `children` relation is another collection whose `foreignKey` /
+ * `crossPackageRef` edge targets this model (a tab of the record page's
+ * related records); an `items` relation is a `children` one whose rows are
+ * this record's line items (the line-items table); a `reference` relation is one of this model's
+ * own FK fields (rendered as a link on the detail). Edges whose target or
+ * source is not in `definitions` are skipped: an unexposed model has neither
+ * a definition nor a route, so nothing could be linked.
+ */
+import type { RecordListColumn } from '../overview/widgets/data.js';
+import type { ScreenCollectionDefinition } from './types.js';
+export interface ScreenRelation {
+    /** Qualified model id (`objectRef`) of the child (`children`) or target (`reference`). */
+    model: string;
+    /** FK field name on the child (`children`) or on this model (`reference`). */
+    field: string;
+    label: string;
+    /**
+     * `items` is a `children` relation whose children are this record's line
+     * items: the edge says so (`relationships[].role: 'items'`), or the child
+     * has line-item roles (a quantity and a money field).
+     */
+    kind: 'children' | 'reference' | 'items';
+    /**
+     * `children` / `items` only: the table columns for the child model, chosen
+     * by role (`relatedColumns`; `lineItemColumns` for items), the FK back to
+     * this model excluded.
+     */
+    columns?: readonly RecordListColumn[];
+    /** `items` only: the child field lines are ordered by (`sortOrder`, ..., else `createdAt`). */
+    sort?: string;
+}
+/**
+ * A relation's stable key, `<Class>-<field>` (`Order-customerId`): what the
+ * `related` widget's `relations` option lists and default widget ids end in.
+ */
+export declare function relationKey(relation: Pick<ScreenRelation, 'model' | 'field'>): string;
+/**
+ * Relations of `model` (a qualified `objectRef`, or a key of `definitions`).
+ * `items` come first, then `children`, each sorted by label; `reference`
+ * relations follow in declaration order. A child with two FKs to the same
+ * parent yields two relations, labelled `Orders (Owner)` /
+ * `Orders (Approver)` (and is only `items` when an edge says so).
+ */
+export declare function deriveScreenRelations(definitions: Readonly<Record<string, ScreenCollectionDefinition>>, model: string): ScreenRelation[];
+//# sourceMappingURL=relations.d.ts.map

package/dist/components/screens/relations.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"relations.d.ts","sourceRoot":"","sources":["../../../src/components/screens/relations.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AACH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,6BAA6B,CAAC;AAIpE,OAAO,KAAK,EACV,0BAA0B,EAE3B,MAAM,YAAY,CAAC;AAEpB,MAAM,WAAW,cAAc;IAC7B,0FAA0F;IAC1F,KAAK,EAAE,MAAM,CAAC;IACd,8EAA8E;IAC9E,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd;;;;OAIG;IACH,IAAI,EAAE,UAAU,GAAG,WAAW,GAAG,OAAO,CAAC;IACzC;;;;OAIG;IACH,OAAO,CAAC,EAAE,SAAS,gBAAgB,EAAE,CAAC;IACtC,+FAA+F;IAC/F,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAID;;;GAGG;AACH,wBAAgB,WAAW,CACzB,QAAQ,EAAE,IAAI,CAAC,cAAc,EAAE,OAAO,GAAG,OAAO,CAAC,GAChD,MAAM,CAKR;AAyBD;;;;;;GAMG;AACH,wBAAgB,qBAAqB,CACnC,WAAW,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,0BAA0B,CAAC,CAAC,EACjE,KAAK,EAAE,MAAM,GACZ,cAAc,EAAE,CAqElB"}

package/dist/components/screens/relations.js

@@ -0,0 +1,98 @@
+import { lineItemColumns, relatedColumns } from './columns.js';
+import { humanizeLabel, screenTitles } from './fields.js';
+import { deriveFieldRoles, hasLineItemRoles } from './roles.js';
+const LINE_ORDER_FIELDS = ['sortOrder', 'position', 'lineNumber', 'sequence'];
+/**
+ * A relation's stable key, `<Class>-<field>` (`Order-customerId`): what the
+ * `related` widget's `relations` option lists and default widget ids end in.
+ */
+export function relationKey(relation) {
+    const className = relation.model.split(/[:/]/).pop() ?? relation.model;
+    return `${className}-${relation.field}`
+        .replace(/[^A-Za-z0-9_.-]+/g, '-')
+        .slice(0, 64);
+}
+const FK_KINDS = new Set([
+    'foreignKey',
+    'crossPackageRef',
+]);
+function fieldLabel(field, definition) {
+    return humanizeLabel(field, definition.fields[field]);
+}
+/** Resolve a relationship target by `definitions` key, then by `name`. */
+function targetOf(definitions, collection) {
+    return (definitions[collection] ??
+        Object.values(definitions).find((d) => d.name === collection));
+}
+/**
+ * Relations of `model` (a qualified `objectRef`, or a key of `definitions`).
+ * `items` come first, then `children`, each sorted by label; `reference`
+ * relations follow in declaration order. A child with two FKs to the same
+ * parent yields two relations, labelled `Orders (Owner)` /
+ * `Orders (Approver)` (and is only `items` when an edge says so).
+ */
+export function deriveScreenRelations(definitions, model) {
+    const self = Object.values(definitions).find((d) => d.objectRef === model) ??
+        definitions[model];
+    if (!self)
+        return [];
+    const children = [];
+    const perChild = new Map();
+    for (const child of Object.values(definitions)) {
+        const edges = (child.relationships ?? []).filter((edge) => FK_KINDS.has(edge.kind) &&
+            edge.field in child.fields &&
+            targetOf(definitions, edge.relatedCollection)?.objectRef ===
+                self.objectRef);
+        const titles = screenTitles(child);
+        const roles = edges.length > 0 ? deriveFieldRoles(child) : {};
+        const lineLike = hasLineItemRoles(roles);
+        const list = edges.map((edge) => {
+            const label = edges.length > 1
+                ? `${titles.plural} (${fieldLabel(edge.field, child)})`
+                : titles.plural;
+            if (edge.role === 'items' || (lineLike && edges.length === 1)) {
+                return {
+                    model: child.objectRef,
+                    field: edge.field,
+                    label,
+                    kind: 'items',
+                    columns: lineItemColumns(child, roles, { exclude: [edge.field] }),
+                    sort: LINE_ORDER_FIELDS.find((name) => name in child.fields) ??
+                        'createdAt',
+                };
+            }
+            return {
+                model: child.objectRef,
+                field: edge.field,
+                label,
+                kind: 'children',
+                columns: relatedColumns(child, roles, { exclude: [edge.field] }),
+            };
+        });
+        if (list.length > 0)
+            perChild.set(child.objectRef, list);
+    }
+    for (const list of perChild.values())
+        children.push(...list);
+    children.sort((a, b) => Number(b.kind === 'items') - Number(a.kind === 'items') ||
+        a.label.localeCompare(b.label));
+    const references = [];
+    const seen = new Set();
+    for (const edge of self.relationships ?? []) {
+        if (!FK_KINDS.has(edge.kind) || seen.has(edge.field))
+            continue;
+        if (!(edge.field in self.fields))
+            continue;
+        const target = targetOf(definitions, edge.relatedCollection);
+        if (!target)
+            continue;
+        seen.add(edge.field);
+        references.push({
+            model: target.objectRef,
+            field: edge.field,
+            label: fieldLabel(edge.field, self),
+            kind: 'reference',
+        });
+    }
+    return [...children, ...references];
+}

package/dist/components/screens/roles.d.ts

@@ -0,0 +1,56 @@
+/**
+ * Field roles (#3718 record page): what a field MEANS on a record page, as
+ * opposed to how it is stored. A record header reads its title, identifier,
+ * status and key facts by role; related tables pick their columns by role;
+ * line items and the totals block read quantity, money and the
+ * subtotal / tax / discount / total roles.
+ *
+ * Pure and Node-tested. Sources, in order:
+ *
+ * 1. Explicit metadata on the field definition: `role`, `format`, `enum`,
+ *    `display`. An explicit `role` is authoritative: name heuristics never
+ *    add to it (a `format` / `display` still does).
+ * 2. Manifest `ui` hints: `ui.format` (`money` / `date` / `datetime`), and
+ *    `ui.widget: 'currency'` on an INTEGER field (the legacy money hint; on a
+ *    text field it names the currency CODE, which is not money).
+ * 3. Name heuristics, only for fields with no explicit `role`.
+ *
+ * Money is integer minor units only (the cross-package invariant), so the
+ * name heuristics never mark a decimal as money; an explicit `role` or
+ * `format` on a decimal is honoured as declared.
+ */
+import type { ScreenCollectionDefinition } from './types.js';
+/** What a field means on a record page. One field may hold several roles. */
+export type FieldRole = 'title' | 'identifier' | 'status' | 'money' | 'quantity' | 'date' | 'party' | 'subtotal' | 'tax' | 'discount' | 'total';
+/** Every role, in the order a role list is reported. */
+export declare const FIELD_ROLES: readonly FieldRole[];
+/** Roles of every declared field of a definition, keyed by field name. */
+export type ScreenFieldRoles = Readonly<Record<string, readonly FieldRole[]>>;
+/**
+ * Roles of every declared field of `definition` (a key per field, possibly
+ * an empty list). Without an explicit `display` field, the first text field
+ * named `name` / `title` / `label` / `displayName` takes the `title` role.
+ */
+export declare function deriveFieldRoles(definition: ScreenCollectionDefinition): Record<string, FieldRole[]>;
+/** Fields holding `role`, in declaration order. */
+export declare function fieldsWithRole(roles: ScreenFieldRoles, role: FieldRole): string[];
+/** The first field holding `role`, or `undefined`. */
+export declare function fieldWithRole(roles: ScreenFieldRoles, role: FieldRole): string | undefined;
+/**
+ * The field naming a record's currency: a text field hinted
+ * `ui.widget: 'currency'` (the manifest's currency-code picker), else a text
+ * field named `currency` / `currencyCode`.
+ */
+export declare function currencyCodeField(definition: ScreenCollectionDefinition): string | undefined;
+/**
+ * Whether records of this definition read like documents (an order, an
+ * invoice): an identifier plus a party or a total. Their header leads with
+ * the identifier ("Order GRA-3159") rather than a name.
+ */
+export declare function isDocumentLike(roles: ScreenFieldRoles): boolean;
+/**
+ * Whether a child definition has line-item roles: a quantity and a money
+ * field (`deriveScreenRelations` classifies such a child relation `items`).
+ */
+export declare function hasLineItemRoles(roles: ScreenFieldRoles): boolean;
+//# sourceMappingURL=roles.d.ts.map

package/dist/components/screens/roles.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"roles.d.ts","sourceRoot":"","sources":["../../../src/components/screens/roles.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,OAAO,KAAK,EACV,0BAA0B,EAG3B,MAAM,YAAY,CAAC;AAEpB,6EAA6E;AAC7E,MAAM,MAAM,SAAS,GACjB,OAAO,GACP,YAAY,GACZ,QAAQ,GACR,OAAO,GACP,UAAU,GACV,MAAM,GACN,OAAO,GACP,UAAU,GACV,KAAK,GACL,UAAU,GACV,OAAO,CAAC;AAEZ,wDAAwD;AACxD,eAAO,MAAM,WAAW,EAAE,SAAS,SAAS,EAY3C,CAAC;AAEF,0EAA0E;AAC1E,MAAM,MAAM,gBAAgB,GAAG,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,SAAS,SAAS,EAAE,CAAC,CAAC,CAAC;AAsG9E;;;;GAIG;AACH,wBAAgB,gBAAgB,CAC9B,UAAU,EAAE,0BAA0B,GACrC,MAAM,CAAC,MAAM,EAAE,SAAS,EAAE,CAAC,CA0C7B;AAED,mDAAmD;AACnD,wBAAgB,cAAc,CAC5B,KAAK,EAAE,gBAAgB,EACvB,IAAI,EAAE,SAAS,GACd,MAAM,EAAE,CAEV;AAED,sDAAsD;AACtD,wBAAgB,aAAa,CAC3B,KAAK,EAAE,gBAAgB,EACvB,IAAI,EAAE,SAAS,GACd,MAAM,GAAG,SAAS,CAEpB;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,CAC/B,UAAU,EAAE,0BAA0B,GACrC,MAAM,GAAG,SAAS,CAUpB;AAED;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,gBAAgB,GAAG,OAAO,CAM/D;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,gBAAgB,GAAG,OAAO,CAKjE"}