@dforge-core/metadata 0.0.44 → 0.0.46

package/CHANGELOG.md

@@ -5,6 +5,38 @@ All notable changes to `@dforge-core/metadata` are documented here.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
 and this package adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [0.0.46] — 2026-10-25
+
+### Added
+
+- **Register column slots:** `REGISTER_COLUMN_SLOTS` lists every place a register declaration names a
+  stored column — the entity it lives on, what to call it, whether it is summed. `registerColumnSlot(path,
+  kind?)` resolves a path to its slot and `registerColumnHost(def, host)` names the entity a slot is on, so an
+  editor can offer the right entity's columns at a path. `checkRegister` reads columns through the same table.
+- **`column-not-numeric` warning:** a column that a balance, turnover or accounting register adds up (its
+  resources, and its totals cache's) must store a scalar number. It runs when the `RegisterEntityLookup` returns
+  `datatypes` (a new optional `Map` of storage type per column) and skips a column whose type is unknown.
+  An information register's resources are returned, not summed, so they may be any type.
+- `isNumericDatatype()` and the `RegisterHosts` type.
+
+### Changed
+
+- **`unknown-column` message** for a register column quotes the entity: `... isn't a stored column of 'stock'.`
+
+## [0.0.45] — 2026-10-24
+
+### Added
+
+- **DSL `attachText(content, fileName, encoding?, mimeType?)` / `attachBase64(base64, fileName,
+  mimeType?)`:** build a file for `sendEmail()`'s fourth argument, keeping its own type (an `.ics` as
+  `text/calendar`). Unlike a `printPdf()` result they have no owner, so a scheduled job can attach them.
+  Listed in `BUILTINS`; they share the per-run file limit with `downloadText()` / `downloadBase64()`.
+
+### Changed
+
+- **DSL `sendEmail()`:** the attachments argument now accepts `attachText()` / `attachBase64()` results as
+  well as `printPdf()` ones.
+
 ## [0.0.44] — 2026-10-21
 
 ### Added

package/dist/{actions-DvYTrCbP.d.ts → actions-D-0G_mqf.d.ts}

@@ -53,8 +53,26 @@ interface ActionDef {
      * "Run in Background". A parameterless `isAsync` action is queued directly.
      */
     isAsync?: boolean;
+    /**
+     * Code of a print template of the action's entity. The run dialog renders it as a PDF beside the params when the
+     * action is opened on one record, so the user sees the document the action sends before it goes.
+     */
+    previewTemplate?: string;
+    /**
+     * Saved parameter sets the module ships for this action, keyed by set name. They install as shared sets owned by
+     * the module: read-only for users and refreshed on every install, and a user can save a set of their own under the
+     * same name, which wins for them. Each `values` key must be a param the action declares; a string starting with `=`
+     * is a formula. Needs the action to declare params.
+     */
+    paramSets?: Record<string, ActionParamSetDef>;
+}
+/** One shipped parameter set of an action. */
+interface ActionParamSetDef {
+    description?: string;
+    /** Value by param code. */
+    values: Record<string, unknown>;
 }
 /** A `ui/actions.json` file: action code → definition. */
 type ActionsFile = Record<string, ActionDef>;
 
-export type { ActionExecutionMode as A, ActionDef as a, ActionsFile as b };
+export type { ActionExecutionMode as A, ActionDef as a, ActionParamSetDef as b, ActionsFile as c };

package/dist/dsl/index.d.ts

@@ -1,4 +1,4 @@
-import { A as ActionExecutionMode } from '../actions-DvYTrCbP.js';
+import { A as ActionExecutionMode } from '../actions-D-0G_mqf.js';
 
 type TokenKind = "ident" | "number" | "string" | "template" | "regex" | "punct" | "comment";
 interface Token {

package/dist/dsl/index.js

@@ -856,7 +856,7 @@ var BUILTINS = [
     name: "sendEmail",
     signature: "sendEmail(to, subjectOrTemplate, dataOrBody?, attachments?)",
     returns: "void",
-    doc: "Queue an outbound email. Three arguments, and the **second** picks the mode: `sendEmail(to, 'order.shipped', { ref: [code] })` sends a template, `sendEmail(to, 'Your order shipped', '<p>\u2026</p>')` sends raw HTML. A second argument with no spaces that contains `.` or `_` is read as a template code \u2014 so a raw subject like `'Shipped.'` silently becomes one; give a raw subject spaces. The optional **fourth** argument attaches files: a `printPdf()` result, or an array of them (`[a, b]`; pass a single file as itself, because a one-name `[a]` reads as a field reference in the DSL). Only a `printPdf()` result can be attached, and only by the user who generated it (or a workspace admin); at most 5 files and 10 MB in all per email (`Email:MaxAttachments`, `Email:MaxAttachmentBytes`). A file the sender may not attach fails the action. Not available in a scheduled job, whose emails with attachments are not queued."
+    doc: "Queue an outbound email. Three arguments, and the **second** picks the mode: `sendEmail(to, 'order.shipped', { ref: [code] })` sends a template, `sendEmail(to, 'Your order shipped', '<p>\u2026</p>')` sends raw HTML. A second argument with no spaces that contains `.` or `_` is read as a template code \u2014 so a raw subject like `'Shipped.'` silently becomes one; give a raw subject spaces. The optional **fourth** argument attaches files: a `printPdf()`, `attachText()` or `attachBase64()` result, or an array of them (`[a, b]`; pass a single file as itself, because a one-name `[a]` reads as a field reference in the DSL). A `printPdf()` file can be attached only by the user who generated it (or a workspace admin) and not in a scheduled job; a file built with `attachText()` / `attachBase64()` has no owner and works everywhere, a scheduled job included. At most 5 files and 10 MB in all per email (`Email:MaxAttachments`, `Email:MaxAttachmentBytes`). A file the sender may not attach fails the action."
   },
   // External calls
   {
@@ -909,6 +909,18 @@ var BUILTINS = [
     returns: "string",
     doc: "`downloadText()` for bytes: decodes `base64` and hands it to the user as `fileName` (`application/octet-stream` unless `mimeType` says otherwise). Returns the signed download URL."
   },
+  {
+    name: "attachText",
+    signature: "attachText(content, fileName, encoding?, mimeType?)",
+    returns: "object",
+    doc: "Build a text file to attach to an email: encodes `content` in `encoding` (`utf-8` by default) and returns a descriptor for `sendEmail()`'s fourth argument, e.g. `sendEmail(to, 'Interview', body, attachText(ics, 'invite.ics', 'utf-8', 'text/calendar'))`. The file keeps `mimeType` (`text/plain` by default). It is the script's own output, so no user's rights are involved and it works in a scheduled job. Only the emails of this run can name it. Max 10 MB per file and 10 files per run, shared with `downloadText()` / `downloadBase64()`."
+  },
+  {
+    name: "attachBase64",
+    signature: "attachBase64(base64, fileName, mimeType?)",
+    returns: "object",
+    doc: "`attachText()` for bytes given as base64 (`application/octet-stream` unless `mimeType` says otherwise)."
+  },
   {
     name: "getSetting",
     signature: "getSetting(settingCd)",