@dforge-core/metadata 0.0.47 → 0.0.49

package/CHANGELOG.md

@@ -5,6 +5,25 @@ 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.49] — 2026-11-03
+
+### Fixed
+
+- **Query columns validate:** the column `oneOf` in `entity.schema.json` had no variant admitting `columnType: "Q"`, so every
+  Q column failed validation although the server installs it. A Q column now requires `params` and carries no
+  `dbDatatype`, `fieldTypeCd` or `link`.
+
+## [0.0.48] — 2026-11-02
+
+### Added
+
+- **Query columns (`columnType: "Q"`):** `entity.schema.json` accepts a Q column — a read-only list of rows a record reads —
+  bound by `params` to a balance register as of the record's date (`register`, `asOf`, `dimensions`) or to a query written
+  in the column and filled from the record (`entity`, `query`, `params`), with an optional `viz`. The types
+  (`QueryColumnParams` and its two forms) are exported, and `QUERY_COLUMN_RECORD_SLOTS` / `isQueryColumnRecordSlot(path)`
+  say which paths inside `params` name a column of the record's entity, so an editor can offer that entity's columns there.
+- The `Q` entry of the column-type registry now reads "Query rows".
+
 ## [0.0.47] — 2026-10-29
 
 ### Added

package/dist/index.d.ts

@@ -8,7 +8,7 @@ interface NamedKind {
 /** Horizontal alignment for a column's display (authored via `params.align`). */
 type AlignType = "left" | "right" | "center";
 /** Column kind letter as stored in entity JSON / the `column` metadata table. */
-type ColumnTypeCd = "D" | "R" | "S" | "F" | "A" | "L" | "G";
+type ColumnTypeCd = "D" | "R" | "S" | "F" | "A" | "L" | "G" | "Q";
 /** Abstract data type code from the `base_datatype` table. */
 type BaseDatatypeCd = "binary" | "bool" | "culture" | "cuid" | "date" | "guid" | "json" | "link" | "number" | "project" | "ref" | "set" | "string" | "time" | "timestamp" | "xml";
 /** Column flag letters, in any order. V=Visible, E=Editable (display/interaction),
@@ -787,6 +787,44 @@ interface EntityDef {
     views?: Record<string, EntityViewDef>;
 }
 
+/** How the card shows the rows: a report visualization by its type and config. Unset: a table. */
+interface QueryColumnViz {
+    type: string;
+    config?: Record<string, unknown>;
+}
+/** The balance of a register as of the record's date, narrowed by the record's own columns. */
+interface RegisterQueryColumnParams {
+    /** `module_cd.register_cd` of a balance register. */
+    register: string;
+    /** Date column of the record the balance is taken on. */
+    asOf: string;
+    /** Register dimension → column of the record that narrows it. */
+    dimensions?: Record<string, string>;
+    viz?: QueryColumnViz;
+}
+/** A query written in the column, its `@name` filter values filled from the record. */
+interface EntityQueryColumnParams {
+    /** `module_cd.entity_cd` the query reads. */
+    entity: string;
+    /** The query, in the shape `query.run` takes. */
+    query: {
+        columns?: unknown[];
+        filter?: unknown;
+        sort?: unknown[];
+    };
+    /** Query parameter name → column of the record that fills it. */
+    params?: Record<string, string>;
+    viz?: QueryColumnViz;
+}
+type QueryColumnParams = RegisterQueryColumnParams | EntityQueryColumnParams;
+/**
+ * The places in a Q column's `params` that name a column of the entity the column is on, so an
+ * editor can offer that entity's columns there. `*` matches any key.
+ */
+declare const QUERY_COLUMN_RECORD_SLOTS: readonly (readonly string[])[];
+/** Whether a path inside a Q column's `params` names a column of the record's entity. */
+declare function isQueryColumnRecordSlot(path: readonly (string | number)[]): boolean;
+
 /** `{ field, target }` for each Reference (R) column that declares a link. */
 declare function getLinks(entity: EntityDef): Array<{
     field: string;
@@ -1897,7 +1935,7 @@ interface JobDef {
     timeout: number;
     /** Max parallel runs (1–5; default 1). */
     concurrency?: number;
-    /** Idempotency key template, e.g. '{job_cd}:{run.month}'. */
+    /** Reserved, not enforced: stored but never read by the scheduler. */
     idempotencyKey?: string;
     /** Routing class ('long_running' required for any timeout > 300s). */
     class?: "standard" | "long_running";
@@ -1984,6 +2022,8 @@ interface PrintPageSettings {
     size?: "A4" | "letter" | "legal";
     orientation?: "portrait" | "landscape";
     margins?: PrintMargins;
+    /** The form's own culture ('uk-UA') for its numbers and dates, whoever prints it. */
+    culture?: string;
 }
 /**
  * A print template or snippet (value in the print_templates map).
@@ -2117,4 +2157,4 @@ declare const flagDefs: readonly {
     label: string;
 }[];
 
-export { AGG_TYPE_LIST, type AccumulationConfig, AggType, type AlignType, type AuditHistoryLevel, type BaseDatatypeCd, type CalendarViewConfig, type CardFieldDef, type CardFieldEntry, type CardLayout, type CardLayoutDef, type CardLayoutsFile, type CardSection, type CardSetConfig, type CardTabRef, type ColumnDef, type ColumnGroupSection, type ColumnTypeCd, type ColumnTypeDef, DEP_COLUMN_TYPES, type DataSource, type DataViewDef, type DataViewsFile, type Dataset, type DepColumn, type DepColumnMode, type DepColumnType, type DepEntity, type DepProvenance, type DepProvenanceKind, type DepsFile, type DeriveOptions, type DiagramDef, type DiagramDetail, type DiagramEntity, type DiagramFile, type DiagramRelation, type DiagramViewConfig, type DomainDef, type DomainsFile, type EntityDef, type EntityEvent, type EntityReaction, type EntityReference, type EntityViewColumnDef, type EntityViewDef, FILTER_GROUP_OPERATORS, FILTER_OPERATORS, type FieldDef, type FieldLink, type FieldOption, type FieldTypeCd, type FieldTypeDef, type Filter, type FilterCondition, type FilterGroup, type FilterGroupOperator, type FilterOperator, type FlagCd, type FolderDef, type FolderEntityBinding, type FoldersFile, type GridViewConfig, type JobDef, type JobsFile, type KanbanViewConfig, type LedgerRegistryEntry, type ListLevelConfig, type ListViewConfig, type ManifestAuthor, type ManifestDef, type MenuDef, type MenuItemDef, type MenuItemType, type MenusFile, type ModuleDependency, type ModuleFeature, NUMERIC_TOTAL, type NamedKind, type NumberSequenceDef, type ParamDef, type ParamDefBase, type PeriodConfig, type PrintMargins, type PrintPageSettings, type PrintTemplateDef, type PrintTemplatesFile, REGISTER_CODE, REGISTER_COLUMN_NAME, REGISTER_COLUMN_SLOTS, REGISTER_KINDS, REGISTER_TOTALS_PERIODS, type RegisterBindingParams, type RegisterBindingTarget, type RegisterColumnHost, type RegisterColumnSlot, type RegisterCompositionDef, type RegisterDef, type RegisterEntityInfo, type RegisterEntityLookup, type RegisterHosts, type RegisterIssue, type RegisterKind, type RegisterMapValue, type RegisterResourceDef, type RegisterSource, type RegisterTotalsDef, type RegisterTotalsPeriod, type RegistersFile, type ReportDef, type ReportEntityAttachment, type ReportLayout, type ReportPanel, type ReportQuery, type ReportsFile, type ResolvedColumnSlot, type RoleDef, type RolesFile, type SeedDataFile, type SeedDataRepeat, type SetSection, type SettingBaseDatatype, type SettingConstraintDef, type SettingDef, type SettingsFile, type SignConfig, type SortClause, type SpColumnDef, type SpParamDef, type StoredProcedureDef, type StoredProceduresFile, type TabGroupSection, type TraitCd, type TraitDef, type TraitFieldConflict, type TraitsFile, type TranslatedAction, type TranslatedEntity, type TranslatedMenu, type TranslatedOption, type TranslatedReport, type TranslatedWithOptions, type TranslationsFile, type TreeGridViewConfig, type TriggerDef, type TriggersFile, type ViewColumn, type ViewType, type VizType, type WebhookPayload, type WebhookSubscription, type WebhooksFile, baseDatatypes, baseToDbDatatype, chartTypes, checkRegister, checkRegisterBinding, checkRegisters, columnTypes, dataViewKinds, defaultParams, deriveBaseDatatype, deriveDbDatatype, expandTrait, expandTraits, fieldTypeCds, fieldTypes, fieldTypesByColumnType, flagDefs, getColumnType, getFieldType, getIdentityKeys, getLinks, getPrimaryKeys, getTrait, isFieldTypeCd, isNumericDatatype, isPlainColumnRef, isRegisterKind, registerCarrier, registerColumnHost, registerColumnSlot, registerDimensions, registerLineMode, registerRefusedProps, registerRequiredProps, registerResourceShape, registerResources, settingDefsOf, traitFieldConflicts, traits, vizTypes };
+export { AGG_TYPE_LIST, type AccumulationConfig, AggType, type AlignType, type AuditHistoryLevel, type BaseDatatypeCd, type CalendarViewConfig, type CardFieldDef, type CardFieldEntry, type CardLayout, type CardLayoutDef, type CardLayoutsFile, type CardSection, type CardSetConfig, type CardTabRef, type ColumnDef, type ColumnGroupSection, type ColumnTypeCd, type ColumnTypeDef, DEP_COLUMN_TYPES, type DataSource, type DataViewDef, type DataViewsFile, type Dataset, type DepColumn, type DepColumnMode, type DepColumnType, type DepEntity, type DepProvenance, type DepProvenanceKind, type DepsFile, type DeriveOptions, type DiagramDef, type DiagramDetail, type DiagramEntity, type DiagramFile, type DiagramRelation, type DiagramViewConfig, type DomainDef, type DomainsFile, type EntityDef, type EntityEvent, type EntityQueryColumnParams, type EntityReaction, type EntityReference, type EntityViewColumnDef, type EntityViewDef, FILTER_GROUP_OPERATORS, FILTER_OPERATORS, type FieldDef, type FieldLink, type FieldOption, type FieldTypeCd, type FieldTypeDef, type Filter, type FilterCondition, type FilterGroup, type FilterGroupOperator, type FilterOperator, type FlagCd, type FolderDef, type FolderEntityBinding, type FoldersFile, type GridViewConfig, type JobDef, type JobsFile, type KanbanViewConfig, type LedgerRegistryEntry, type ListLevelConfig, type ListViewConfig, type ManifestAuthor, type ManifestDef, type MenuDef, type MenuItemDef, type MenuItemType, type MenusFile, type ModuleDependency, type ModuleFeature, NUMERIC_TOTAL, type NamedKind, type NumberSequenceDef, type ParamDef, type ParamDefBase, type PeriodConfig, type PrintMargins, type PrintPageSettings, type PrintTemplateDef, type PrintTemplatesFile, QUERY_COLUMN_RECORD_SLOTS, type QueryColumnParams, type QueryColumnViz, REGISTER_CODE, REGISTER_COLUMN_NAME, REGISTER_COLUMN_SLOTS, REGISTER_KINDS, REGISTER_TOTALS_PERIODS, type RegisterBindingParams, type RegisterBindingTarget, type RegisterColumnHost, type RegisterColumnSlot, type RegisterCompositionDef, type RegisterDef, type RegisterEntityInfo, type RegisterEntityLookup, type RegisterHosts, type RegisterIssue, type RegisterKind, type RegisterMapValue, type RegisterQueryColumnParams, type RegisterResourceDef, type RegisterSource, type RegisterTotalsDef, type RegisterTotalsPeriod, type RegistersFile, type ReportDef, type ReportEntityAttachment, type ReportLayout, type ReportPanel, type ReportQuery, type ReportsFile, type ResolvedColumnSlot, type RoleDef, type RolesFile, type SeedDataFile, type SeedDataRepeat, type SetSection, type SettingBaseDatatype, type SettingConstraintDef, type SettingDef, type SettingsFile, type SignConfig, type SortClause, type SpColumnDef, type SpParamDef, type StoredProcedureDef, type StoredProceduresFile, type TabGroupSection, type TraitCd, type TraitDef, type TraitFieldConflict, type TraitsFile, type TranslatedAction, type TranslatedEntity, type TranslatedMenu, type TranslatedOption, type TranslatedReport, type TranslatedWithOptions, type TranslationsFile, type TreeGridViewConfig, type TriggerDef, type TriggersFile, type ViewColumn, type ViewType, type VizType, type WebhookPayload, type WebhookSubscription, type WebhooksFile, baseDatatypes, baseToDbDatatype, chartTypes, checkRegister, checkRegisterBinding, checkRegisters, columnTypes, dataViewKinds, defaultParams, deriveBaseDatatype, deriveDbDatatype, expandTrait, expandTraits, fieldTypeCds, fieldTypes, fieldTypesByColumnType, flagDefs, getColumnType, getFieldType, getIdentityKeys, getLinks, getPrimaryKeys, getTrait, isFieldTypeCd, isNumericDatatype, isPlainColumnRef, isQueryColumnRecordSlot, isRegisterKind, registerCarrier, registerColumnHost, registerColumnSlot, registerDimensions, registerLineMode, registerRefusedProps, registerRequiredProps, registerResourceShape, registerResources, settingDefsOf, traitFieldConflicts, traits, vizTypes };

package/dist/index.js

@@ -103,6 +103,7 @@ var columnTypes = [
   { cd: "F", name: "Formula", description: "A virtual value calculated from a formula expression." },
   { cd: "G", name: "Generated", description: "A physical column auto-maintained by the database (aggregate or expression)." },
   { cd: "A", name: "Accumulation register", description: "Posts this document into a balance entity (single direction)." },
+  { cd: "Q", name: "Query rows", description: "A read-only list of rows this record reads: a register's balance as of its date, or a query filled from its columns." },
   { cd: "L", name: "Ledger register", description: "Posts document lines into movements + balances (double entry)." }
 ];
 var byCd2 = new Map(columnTypes.map((ct) => [ct.cd, ct]));
@@ -331,6 +332,16 @@ var FILTER_OPERATORS = [
 ];
 var FILTER_GROUP_OPERATORS = ["and", "or", "!and", "nAnd", "!or", "nOr"];
 
+// src/query-column.ts
+var QUERY_COLUMN_RECORD_SLOTS = [
+  ["asOf"],
+  ["dimensions", "*"],
+  ["params", "*"]
+];
+function isQueryColumnRecordSlot(path) {
+  return QUERY_COLUMN_RECORD_SLOTS.some((slot2) => slot2.length === path.length && slot2.every((segment, i) => segment === "*" || segment === path[i]));
+}
+
 // src/entity-meta.ts
 function getLinks(entity) {
   const links = [];
@@ -1202,6 +1213,7 @@ export {
   FILTER_GROUP_OPERATORS,
   FILTER_OPERATORS,
   NUMERIC_TOTAL,
+  QUERY_COLUMN_RECORD_SLOTS,
   REGISTER_CODE,
   REGISTER_COLUMN_NAME,
   REGISTER_COLUMN_SLOTS,
@@ -1233,6 +1245,7 @@ export {
   isFieldTypeCd,
   isNumericDatatype,
   isPlainColumnRef,
+  isQueryColumnRecordSlot,
   isRegisterKind,
   registerCarrier,
   registerColumnHost,