@dforge-core/metadata 0.0.42 → 0.0.44

package/dist/index.d.ts

@@ -973,7 +973,11 @@ interface ReportQuery {
 }
 /** Per-column metadata override on a dataset. */
 interface ColumnDef {
+    /** A literal header: wins over the entity's or the procedure's translated one. */
     label?: string;
+    fieldTypeCd?: string;
+    format?: string;
+    /** Accepted, but read by nothing. */
     visible?: boolean;
     width?: number;
 }
@@ -1722,6 +1726,8 @@ interface RegisterBindingParams {
     lineEntity?: string;
     lineField?: string;
     groupLinesBy?: string[];
+    /** On a line posting: the line column dating that line's movement instead of `dateField`. */
+    lineDateField?: string;
     /** Register dimension or resource name → column of the row read. */
     map?: Record<string, RegisterMapValue>;
     /** On a line posting: register name → DOCUMENT column. */

package/dist/index.js

@@ -926,18 +926,36 @@ function checkPosting(params, ledger, error) {
     if (hasKey(params, "groupLinesBy")) {
       error(["groupLinesBy"], "register-group-lines", "'groupLinesBy' needs lines to group \u2014 name the 'lineEntity'.");
     }
+    if (hasKey(params, "lineDateField")) {
+      error(["lineDateField"], "register-line-date", "'lineDateField' dates the lines a posting is made from \u2014 name the 'lineEntity', or date the document with 'dateField'.");
+    }
   }
   if (ledger) {
     if (!lineEntity) {
       error(["lineEntity"], "register-line", "An L column posts lines: 'lineEntity' and 'lineField' are required.");
     }
-    for (const key of ["headerMap", "skipPostingWhenEmpty", "dateTrunc", "groupLinesBy"]) {
+    for (const key of ["headerMap", "skipPostingWhenEmpty", "dateTrunc", "groupLinesBy", "lineDateField"]) {
       if (hasKey(params, key)) {
         error([key], "register-ledger-only", `'${key}' is read by A columns only.`);
       }
     }
   }
   const dateField = safeTrim(params.dateField);
+  const lineDateField = safeTrim(params.lineDateField);
+  if (lineEntity && lineDateField && !ledger) {
+    if (!dateField) {
+      error(["dateField"], "register-line-date", "'lineDateField' falls back to the document's 'dateField' for a line with no date \u2014 name a 'dateField'.");
+    }
+    if (hasKey(params, "periodDimField")) {
+      error(["lineDateField"], "register-line-date", "'lineDateField' and 'periodDimField' cannot be combined: the period dimension is the document's one period, and a line dated in another month would post under it.");
+    }
+    if (!lockedLines.includes("*") && !lockedLines.includes(lineDateField)) {
+      error(["lockedLineFields"], "register-line-date", `'${lineDateField}' must be in 'lockedLineFields': a posted line re-dated would leave its movement under the old date.`);
+    }
+    if (Array.isArray(params.groupLinesBy) && !stringList(params.groupLinesBy).includes(lineDateField)) {
+      error(["groupLinesBy"], "register-line-date", `'${lineDateField}' must be in 'groupLinesBy': a group posts one movement, which has one date only when its lines share it.`);
+    }
+  }
   if (hasKey(params, "dateTrunc") && !dateField) {
     error(["dateTrunc"], "register-date", "'dateTrunc' needs a 'dateField'.");
   }