@dforge-core/metadata 0.0.1

package/dist/actions.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Execution mode. 'single' (default) and 'each' run the DSL per selected record;
+ * 'batch' runs once with all records exposed as `__records`.
+ */
+export type ActionExecutionMode = "single" | "each" | "batch";
+/** A single action declaration (value in the `ui/actions.json` map). */
+export interface ActionDef {
+    /** Human-readable description. */
+    description: string;
+    /** Button label. */
+    label: string;
+    /** Bootstrap icon class (e.g. 'bi-telephone-check'). */
+    icon: string;
+    /** Entity code this action targets. */
+    entityCode: string;
+    /** Per-record vs. batch execution. */
+    executionMode: ActionExecutionMode;
+    /** DSL script name (file under `logic/actions/<script>.dsl`). */
+    script: string;
+    /** Run inside a transaction (failures roll back). */
+    isTransacted?: boolean;
+    /** Display order. */
+    orderNum?: number;
+    /** Run in the background (newer `async`; some modules use `isAsync`). */
+    async?: boolean;
+    /** Alternate spelling of `async` used by some modules. Prefer `async`. */
+    isAsync?: boolean;
+}
+/** A `ui/actions.json` file: action code → definition. */
+export type ActionsFile = Record<string, ActionDef>;
+//# sourceMappingURL=actions.d.ts.map

package/dist/actions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"actions.d.ts","sourceRoot":"","sources":["../src/actions.ts"],"names":[],"mappings":"AAMA;;;GAGG;AACH,MAAM,MAAM,mBAAmB,GAAG,QAAQ,GAAG,MAAM,GAAG,OAAO,CAAC;AAE9D,wEAAwE;AACxE,MAAM,WAAW,SAAS;IACzB,kCAAkC;IAClC,WAAW,EAAE,MAAM,CAAC;IACpB,oBAAoB;IACpB,KAAK,EAAE,MAAM,CAAC;IACd,wDAAwD;IACxD,IAAI,EAAE,MAAM,CAAC;IACb,uCAAuC;IACvC,UAAU,EAAE,MAAM,CAAC;IACnB,sCAAsC;IACtC,aAAa,EAAE,mBAAmB,CAAC;IACnC,iEAAiE;IACjE,MAAM,EAAE,MAAM,CAAC;IACf,qDAAqD;IACrD,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,qBAAqB;IACrB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,yEAAyE;IACzE,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,0EAA0E;IAC1E,OAAO,CAAC,EAAE,OAAO,CAAC;CAClB;AAED,0DAA0D;AAC1D,MAAM,MAAM,WAAW,GAAG,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC"}

package/dist/actions.js

@@ -0,0 +1,7 @@
+// Actions — authoring shape of `ui/actions.json`.
+//
+// There is no published JSON schema for actions; this mirrors the shape used
+// across the core modules. Parameter declarations and logic live in the action
+// DSL file (`logic/actions/<script>.dsl`), not here.
+export {};
+//# sourceMappingURL=actions.js.map

package/dist/actions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"actions.js","sourceRoot":"","sources":["../src/actions.ts"],"names":[],"mappings":"AAAA,kDAAkD;AAClD,EAAE;AACF,6EAA6E;AAC7E,+EAA+E;AAC/E,qDAAqD"}

package/dist/aggregation.d.ts

@@ -0,0 +1,13 @@
+export declare const AggType: {
+    readonly Sum: "sum";
+    readonly Count: "count";
+    readonly Avg: "avg";
+    readonly Min: "min";
+    readonly Max: "max";
+    readonly Group: "group";
+};
+/** One of the aggregation codes ("sum" | "count" | …). */
+export type AggType = (typeof AggType)[keyof typeof AggType];
+/** All aggregation types as an array (useful for iteration). */
+export declare const AGG_TYPE_LIST: readonly AggType[];
+//# sourceMappingURL=aggregation.d.ts.map

package/dist/aggregation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"aggregation.d.ts","sourceRoot":"","sources":["../src/aggregation.ts"],"names":[],"mappings":"AAOA,eAAO,MAAM,OAAO;;;;;;;CAOV,CAAC;AAEX,0DAA0D;AAC1D,MAAM,MAAM,OAAO,GAAG,CAAC,OAAO,OAAO,CAAC,CAAC,MAAM,OAAO,OAAO,CAAC,CAAC;AAE7D,gEAAgE;AAChE,eAAO,MAAM,aAAa,EAAE,SAAS,OAAO,EAA2B,CAAC"}

package/dist/aggregation.js

@@ -0,0 +1,17 @@
+// Aggregation types — the kinds of aggregation a column/report value can use.
+//
+// Declared as a `const` object + derived union (not a TS `enum`) so the package
+// stays enum-free like the rest of its registries, while callers keep the
+// ergonomic `AggType.Sum` member access. `AggType.Sum === "sum"` at runtime, so
+// the value is interchangeable with the plain string everywhere.
+export const AggType = {
+    Sum: "sum",
+    Count: "count",
+    Avg: "avg",
+    Min: "min",
+    Max: "max",
+    Group: "group",
+};
+/** All aggregation types as an array (useful for iteration). */
+export const AGG_TYPE_LIST = Object.values(AggType);
+//# sourceMappingURL=aggregation.js.map

package/dist/aggregation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"aggregation.js","sourceRoot":"","sources":["../src/aggregation.ts"],"names":[],"mappings":"AAAA,8EAA8E;AAC9E,EAAE;AACF,gFAAgF;AAChF,0EAA0E;AAC1E,gFAAgF;AAChF,iEAAiE;AAEjE,MAAM,CAAC,MAAM,OAAO,GAAG;IACtB,GAAG,EAAE,KAAK;IACV,KAAK,EAAE,OAAO;IACd,GAAG,EAAE,KAAK;IACV,GAAG,EAAE,KAAK;IACV,GAAG,EAAE,KAAK;IACV,KAAK,EAAE,OAAO;CACL,CAAC;AAKX,gEAAgE;AAChE,MAAM,CAAC,MAAM,aAAa,GAAuB,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC"}

package/dist/base-datatypes.d.ts

@@ -0,0 +1,5 @@
+import type { BaseDatatypeCd } from "./types";
+export declare const baseDatatypes: readonly BaseDatatypeCd[];
+/** Default PostgreSQL type for a base datatype, or `null` if non-physical. */
+export declare function baseToDbDatatype(base: string): string | null;
+//# sourceMappingURL=base-datatypes.d.ts.map

package/dist/base-datatypes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"base-datatypes.d.ts","sourceRoot":"","sources":["../src/base-datatypes.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AAE9C,eAAO,MAAM,aAAa,EAAE,SAAS,cAAc,EAiBzC,CAAC;AAuBX,8EAA8E;AAC9E,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAE5D"}

package/dist/base-datatypes.js

@@ -0,0 +1,49 @@
+// Base datatype registry — mirror of
+//   server/database/system-modules/metadata/seed-data/base_datatypes.json
+//
+// Plus the canonical mapping from an abstract base datatype to the default
+// PostgreSQL column type the platform generates. The visual editor uses this so
+// the author never has to type a raw SQL type.
+export const baseDatatypes = [
+    "binary",
+    "bool",
+    "culture",
+    "cuid",
+    "date",
+    "guid",
+    "json",
+    "link",
+    "number",
+    "project",
+    "ref",
+    "set",
+    "string",
+    "time",
+    "timestamp",
+    "xml",
+];
+// Default PostgreSQL type per base datatype. `null` entries are non-physical
+// (relationship/virtual) base types that never produce a column on their own.
+const BASE_TO_DB = {
+    binary: "bytea",
+    bool: "bool",
+    culture: "varchar",
+    cuid: "cuid",
+    date: "date",
+    guid: "uuid",
+    json: "jsonb",
+    link: null,
+    number: "numeric",
+    project: "varchar",
+    ref: null,
+    set: null,
+    string: "varchar",
+    time: "time",
+    timestamp: "timestamptz",
+    xml: "xml",
+};
+/** Default PostgreSQL type for a base datatype, or `null` if non-physical. */
+export function baseToDbDatatype(base) {
+    return BASE_TO_DB[base] ?? null;
+}
+//# sourceMappingURL=base-datatypes.js.map

package/dist/base-datatypes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"base-datatypes.js","sourceRoot":"","sources":["../src/base-datatypes.ts"],"names":[],"mappings":"AAAA,qCAAqC;AACrC,0EAA0E;AAC1E,EAAE;AACF,2EAA2E;AAC3E,gFAAgF;AAChF,+CAA+C;AAI/C,MAAM,CAAC,MAAM,aAAa,GAA8B;IACvD,QAAQ;IACR,MAAM;IACN,SAAS;IACT,MAAM;IACN,MAAM;IACN,MAAM;IACN,MAAM;IACN,MAAM;IACN,QAAQ;IACR,SAAS;IACT,KAAK;IACL,KAAK;IACL,QAAQ;IACR,MAAM;IACN,WAAW;IACX,KAAK;CACI,CAAC;AAEX,6EAA6E;AAC7E,8EAA8E;AAC9E,MAAM,UAAU,GAA0C;IACzD,MAAM,EAAE,OAAO;IACf,IAAI,EAAE,MAAM;IACZ,OAAO,EAAE,SAAS;IAClB,IAAI,EAAE,MAAM;IACZ,IAAI,EAAE,MAAM;IACZ,IAAI,EAAE,MAAM;IACZ,IAAI,EAAE,OAAO;IACb,IAAI,EAAE,IAAI;IACV,MAAM,EAAE,SAAS;IACjB,OAAO,EAAE,SAAS;IAClB,GAAG,EAAE,IAAI;IACT,GAAG,EAAE,IAAI;IACT,MAAM,EAAE,SAAS;IACjB,IAAI,EAAE,MAAM;IACZ,SAAS,EAAE,aAAa;IACxB,GAAG,EAAE,KAAK;CACV,CAAC;AAEF,8EAA8E;AAC9E,MAAM,UAAU,gBAAgB,CAAC,IAAY;IAC5C,OAAQ,UAA4C,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC;AACpE,CAAC"}

package/dist/column-types.d.ts

@@ -0,0 +1,5 @@
+import type { ColumnTypeDef } from "./types";
+export declare const columnTypes: readonly ColumnTypeDef[];
+/** Look up a column type by letter. */
+export declare function getColumnType(cd: string): ColumnTypeDef | undefined;
+//# sourceMappingURL=column-types.d.ts.map

package/dist/column-types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"column-types.d.ts","sourceRoot":"","sources":["../src/column-types.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAE7C,eAAO,MAAM,WAAW,EAAE,SAAS,aAAa,EAQtC,CAAC;AAIX,uCAAuC;AACvC,wBAAgB,aAAa,CAAC,EAAE,EAAE,MAAM,GAAG,aAAa,GAAG,SAAS,CAEnE"}

package/dist/column-types.js

@@ -0,0 +1,18 @@
+// Column-type registry — the seven column kinds a field can have. Letters match
+// the `column.column_type` values and entity.schema.json. The `name` /
+// `description` here drive the friendly "what kind of field is this?" picker.
+export const columnTypes = [
+    { cd: "D", name: "Value", description: "A plain data column stored on this entity." },
+    { cd: "R", name: "Reference", description: "An N:1 lookup to another entity (foreign key)." },
+    { cd: "S", name: "Child list", description: "A 1:N collection of child records from another entity." },
+    { 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: "L", name: "Ledger register", description: "Posts document lines into movements + balances (double entry)." },
+];
+const byCd = new Map(columnTypes.map((ct) => [ct.cd, ct]));
+/** Look up a column type by letter. */
+export function getColumnType(cd) {
+    return byCd.get(cd);
+}
+//# sourceMappingURL=column-types.js.map

package/dist/column-types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"column-types.js","sourceRoot":"","sources":["../src/column-types.ts"],"names":[],"mappings":"AAAA,gFAAgF;AAChF,uEAAuE;AACvE,8EAA8E;AAI9E,MAAM,CAAC,MAAM,WAAW,GAA6B;IACpD,EAAE,EAAE,EAAE,GAAG,EAAE,IAAI,EAAE,OAAO,EAAE,WAAW,EAAE,4CAA4C,EAAE;IACrF,EAAE,EAAE,EAAE,GAAG,EAAE,IAAI,EAAE,WAAW,EAAE,WAAW,EAAE,gDAAgD,EAAE;IAC7F,EAAE,EAAE,EAAE,GAAG,EAAE,IAAI,EAAE,YAAY,EAAE,WAAW,EAAE,wDAAwD,EAAE;IACtG,EAAE,EAAE,EAAE,GAAG,EAAE,IAAI,EAAE,SAAS,EAAE,WAAW,EAAE,uDAAuD,EAAE;IAClG,EAAE,EAAE,EAAE,GAAG,EAAE,IAAI,EAAE,WAAW,EAAE,WAAW,EAAE,8EAA8E,EAAE;IAC3H,EAAE,EAAE,EAAE,GAAG,EAAE,IAAI,EAAE,uBAAuB,EAAE,WAAW,EAAE,+DAA+D,EAAE;IACxH,EAAE,EAAE,EAAE,GAAG,EAAE,IAAI,EAAE,iBAAiB,EAAE,WAAW,EAAE,gEAAgE,EAAE;CAC1G,CAAC;AAEX,MAAM,IAAI,GAAG,IAAI,GAAG,CAAwB,WAAW,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC;AAElF,uCAAuC;AACvC,MAAM,UAAU,aAAa,CAAC,EAAU;IACvC,OAAO,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;AACrB,CAAC"}

package/dist/data-views.d.ts

@@ -0,0 +1,95 @@
+import type { Filter } from "./filter";
+import type { NamedKind } from "./types";
+export type { NamedKind };
+/** `viewType` values for `ui/data_views.json`. Source: data_views.schema.json. */
+export type ViewType = "grid" | "list" | "kanban" | "calendar" | "gallery" | "tree-grid" | "diagram" | "master-detail" | "library";
+/** Friendly picker list of the view kinds. */
+export declare const dataViewKinds: readonly NamedKind[];
+/** A column in a data source: shorthand string code or a configured object. */
+export type ViewColumn = string | {
+    /** Column code. */
+    column_cd: string;
+    /** Column width in pixels. */
+    width?: number;
+    /** Whether the column is visible (default true). */
+    visible?: boolean;
+    /** Pin column to an edge. */
+    pinned?: "left" | "right";
+};
+/** One data source within a view. */
+export interface DataSource {
+    /** Entity code to query. */
+    entityCode: string;
+    /** Nesting level (0 = root, 1+ = detail). */
+    level?: number;
+    /** Human-readable label (used in master-detail tabs). */
+    label?: string;
+    /** Column configuration. */
+    columns?: ViewColumn[];
+    /** Set field on the parent entity linking to this detail level. */
+    parentSetField?: string;
+    /** Per-source filter; overrides the view-level filter for this source. */
+    filter?: Filter;
+    /** Per-source sort order (array of `{ c, d }` entries). */
+    order?: unknown;
+}
+export interface KanbanViewConfig {
+    /** Dropdown/flags/reference column to group cards by. */
+    groupByField: string;
+}
+export interface CalendarViewConfig {
+    /** Date/timestamp column used to place events. */
+    dateField: string;
+    /** Column shown as event title (defaults to the entity toString). */
+    titleField?: string;
+    /** Column whose value drives the event pill color. */
+    colorField?: string;
+}
+export interface TreeGridViewConfig {
+    /** Self-referencing FK column (parent record). */
+    parentField: string;
+    /** Node label field (defaults to entity toString). */
+    labelField?: string;
+    /** Field containing a Bootstrap icon class per node. */
+    iconField?: string;
+}
+export interface ListLevelConfig {
+    /** Entity code for this child level. */
+    entityCode: string;
+    /** FK column in the child entity linking back to the parent. */
+    foreignKey: string;
+    /** Columns to display inline for each child row. */
+    columns?: string[];
+}
+export interface ListViewConfig {
+    titleField?: string;
+    subtitleField?: string;
+    /** Hierarchical child levels for expandable list rows. */
+    levels?: ListLevelConfig[];
+}
+export interface DiagramViewConfig {
+    /** Column to group diagram nodes by. */
+    groupByField?: string;
+    /** Group values hidden by default. */
+    defaultHiddenGroups?: string[];
+}
+/** A single data view (value in the `ui/data_views.json` map). */
+export interface DataViewDef {
+    viewType: ViewType;
+    /** Human-readable view name. */
+    label?: string;
+    /** Bootstrap icon class (e.g. 'bi-bounding-box'). */
+    icon?: string;
+    description?: string;
+    /** Data sources (at least one; master-detail needs two). */
+    dataSources: DataSource[];
+    /** Default filter applied to all sources unless one declares its own. */
+    filter?: Filter;
+    /** Default sort order. */
+    order?: unknown;
+    /** View-type-specific configuration. */
+    viewConfig?: KanbanViewConfig | CalendarViewConfig | TreeGridViewConfig | ListViewConfig | DiagramViewConfig | Record<string, unknown>;
+}
+/** A `ui/data_views.json` file: data view code → definition. */
+export type DataViewsFile = Record<string, DataViewDef>;
+//# sourceMappingURL=data-views.d.ts.map

package/dist/data-views.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"data-views.d.ts","sourceRoot":"","sources":["../src/data-views.ts"],"names":[],"mappings":"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"}

package/dist/data-views.js

@@ -0,0 +1,17 @@
+// Data-view registries + the authoring shape of a `ui/data_views.json` file.
+//
+// `dataViewKinds` is the friendly picker list; `DataViewDef` and friends mirror
+// the structural `data_views.schema.json` so editors/MCP/CLI can build views.
+/** Friendly picker list of the view kinds. */
+export const dataViewKinds = [
+    { cd: "grid", name: "Grid" },
+    { cd: "list", name: "List" },
+    { cd: "kanban", name: "Kanban" },
+    { cd: "calendar", name: "Calendar" },
+    { cd: "gallery", name: "Gallery" },
+    { cd: "tree-grid", name: "Tree Grid" },
+    { cd: "diagram", name: "Diagram" },
+    { cd: "master-detail", name: "Master / Detail" },
+    { cd: "library", name: "Library" },
+];
+//# sourceMappingURL=data-views.js.map

package/dist/data-views.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"data-views.js","sourceRoot":"","sources":["../src/data-views.ts"],"names":[],"mappings":"AAAA,6EAA6E;AAC7E,EAAE;AACF,gFAAgF;AAChF,8EAA8E;AAmB9E,8CAA8C;AAC9C,MAAM,CAAC,MAAM,aAAa,GAAyB;IAClD,EAAE,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE;IAC5B,EAAE,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE;IAC5B,EAAE,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,QAAQ,EAAE;IAChC,EAAE,EAAE,EAAE,UAAU,EAAE,IAAI,EAAE,UAAU,EAAE;IACpC,EAAE,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,SAAS,EAAE;IAClC,EAAE,EAAE,EAAE,WAAW,EAAE,IAAI,EAAE,WAAW,EAAE;IACtC,EAAE,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,SAAS,EAAE;IAClC,EAAE,EAAE,EAAE,eAAe,EAAE,IAAI,EAAE,iBAAiB,EAAE;IAChD,EAAE,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,SAAS,EAAE;CACzB,CAAC"}

package/dist/derive.d.ts

@@ -0,0 +1,19 @@
+/** Total digits used when building a `numeric(total, scale)` type. */
+export declare const NUMERIC_TOTAL = 18;
+export interface DeriveOptions {
+    /** Author-specified max length; overrides the field type's default. */
+    maxLen?: number | null;
+    /** Author-specified numeric scale; overrides the field type's default. */
+    precision?: number | null;
+}
+/**
+ * Derive the PostgreSQL `dbDatatype` for a field type. Returns `null` for
+ * field types backed by relationships/sets (lookup, grid) that have no physical
+ * column of their own. Unknown field types fall back to `varchar`.
+ */
+export declare function deriveDbDatatype(fieldTypeCd: string, options?: DeriveOptions): string | null;
+/** Default `params` to seed a new field of this type with (or `undefined`). */
+export declare function defaultParams(fieldTypeCd: string): Record<string, unknown> | undefined;
+/** The base datatype code a field type maps to (for `baseDatatypeCd` on F columns). */
+export declare function deriveBaseDatatype(fieldTypeCd: string): string | undefined;
+//# sourceMappingURL=derive.d.ts.map

package/dist/derive.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"derive.d.ts","sourceRoot":"","sources":["../src/derive.ts"],"names":[],"mappings":"AASA,sEAAsE;AACtE,eAAO,MAAM,aAAa,KAAK,CAAC;AAKhC,MAAM,WAAW,aAAa;IAC7B,uEAAuE;IACvE,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,0EAA0E;IAC1E,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC1B;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,WAAW,EAAE,MAAM,EAAE,OAAO,GAAE,aAAkB,GAAG,MAAM,GAAG,IAAI,CAuBhG;AAED,+EAA+E;AAC/E,wBAAgB,aAAa,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,CAItF;AAED,uFAAuF;AACvF,wBAAgB,kBAAkB,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAE1E"}

package/dist/derive.js

@@ -0,0 +1,51 @@
+// Derivation helpers — turn a friendly field-type choice into the physical
+// metadata the platform needs, so the author never types a raw SQL type.
+//
+// Defaults follow how core modules actually author fields (e.g. currency →
+// numeric(18,2), color → varchar(20)); callers may always override the result.
+import { baseToDbDatatype } from "./base-datatypes";
+import { getFieldType } from "./field-types";
+/** Total digits used when building a `numeric(total, scale)` type. */
+export const NUMERIC_TOTAL = 18;
+/** Field types whose natural storage is unbounded `text` rather than `varchar`. */
+const TEXT_BACKED = new Set(["textarea", "richtext", "code"]);
+/**
+ * Derive the PostgreSQL `dbDatatype` for a field type. Returns `null` for
+ * field types backed by relationships/sets (lookup, grid) that have no physical
+ * column of their own. Unknown field types fall back to `varchar`.
+ */
+export function deriveDbDatatype(fieldTypeCd, options = {}) {
+    const ft = getFieldType(fieldTypeCd);
+    if (!ft)
+        return "varchar";
+    // Relationship-backed types (lookup → R, grid → S) never own a physical
+    // column — the FK lives on a separate hidden column.
+    if (ft.columnType === "R" || ft.columnType === "S")
+        return null;
+    const base = baseToDbDatatype(ft.baseDatatypeCd);
+    if (base === null)
+        return null; // other non-physical base (link/ref/set)
+    if (ft.baseDatatypeCd === "number") {
+        const precision = options.precision ?? ft.precision;
+        return precision != null ? `numeric(${NUMERIC_TOTAL},${precision})` : "numeric";
+    }
+    if (ft.baseDatatypeCd === "string") {
+        if (TEXT_BACKED.has(ft.cd))
+            return "text";
+        const maxLen = options.maxLen ?? ft.maxLen;
+        return maxLen != null ? `varchar(${maxLen})` : "varchar";
+    }
+    return base;
+}
+/** Default `params` to seed a new field of this type with (or `undefined`). */
+export function defaultParams(fieldTypeCd) {
+    const ft = getFieldType(fieldTypeCd);
+    if (!ft?.defParams)
+        return undefined;
+    return { ...ft.defParams };
+}
+/** The base datatype code a field type maps to (for `baseDatatypeCd` on F columns). */
+export function deriveBaseDatatype(fieldTypeCd) {
+    return getFieldType(fieldTypeCd)?.baseDatatypeCd;
+}
+//# sourceMappingURL=derive.js.map

package/dist/derive.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"derive.js","sourceRoot":"","sources":["../src/derive.ts"],"names":[],"mappings":"AAAA,2EAA2E;AAC3E,yEAAyE;AACzE,EAAE;AACF,2EAA2E;AAC3E,+EAA+E;AAE/E,OAAO,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AACpD,OAAO,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAE7C,sEAAsE;AACtE,MAAM,CAAC,MAAM,aAAa,GAAG,EAAE,CAAC;AAEhC,mFAAmF;AACnF,MAAM,WAAW,GAAG,IAAI,GAAG,CAAC,CAAC,UAAU,EAAE,UAAU,EAAE,MAAM,CAAC,CAAC,CAAC;AAS9D;;;;GAIG;AACH,MAAM,UAAU,gBAAgB,CAAC,WAAmB,EAAE,UAAyB,EAAE;IAChF,MAAM,EAAE,GAAG,YAAY,CAAC,WAAW,CAAC,CAAC;IACrC,IAAI,CAAC,EAAE;QAAE,OAAO,SAAS,CAAC;IAE1B,wEAAwE;IACxE,qDAAqD;IACrD,IAAI,EAAE,CAAC,UAAU,KAAK,GAAG,IAAI,EAAE,CAAC,UAAU,KAAK,GAAG;QAAE,OAAO,IAAI,CAAC;IAEhE,MAAM,IAAI,GAAG,gBAAgB,CAAC,EAAE,CAAC,cAAc,CAAC,CAAC;IACjD,IAAI,IAAI,KAAK,IAAI;QAAE,OAAO,IAAI,CAAC,CAAC,yCAAyC;IAEzE,IAAI,EAAE,CAAC,cAAc,KAAK,QAAQ,EAAE,CAAC;QACpC,MAAM,SAAS,GAAG,OAAO,CAAC,SAAS,IAAI,EAAE,CAAC,SAAS,CAAC;QACpD,OAAO,SAAS,IAAI,IAAI,CAAC,CAAC,CAAC,WAAW,aAAa,IAAI,SAAS,GAAG,CAAC,CAAC,CAAC,SAAS,CAAC;IACjF,CAAC;IAED,IAAI,EAAE,CAAC,cAAc,KAAK,QAAQ,EAAE,CAAC;QACpC,IAAI,WAAW,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,CAAC;YAAE,OAAO,MAAM,CAAC;QAC1C,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,IAAI,EAAE,CAAC,MAAM,CAAC;QAC3C,OAAO,MAAM,IAAI,IAAI,CAAC,CAAC,CAAC,WAAW,MAAM,GAAG,CAAC,CAAC,CAAC,SAAS,CAAC;IAC1D,CAAC;IAED,OAAO,IAAI,CAAC;AACb,CAAC;AAED,+EAA+E;AAC/E,MAAM,UAAU,aAAa,CAAC,WAAmB;IAChD,MAAM,EAAE,GAAG,YAAY,CAAC,WAAW,CAAC,CAAC;IACrC,IAAI,CAAC,EAAE,EAAE,SAAS;QAAE,OAAO,SAAS,CAAC;IACrC,OAAO,EAAE,GAAG,EAAE,CAAC,SAAS,EAAE,CAAC;AAC5B,CAAC;AAED,uFAAuF;AACvF,MAAM,UAAU,kBAAkB,CAAC,WAAmB;IACrD,OAAO,YAAY,CAAC,WAAW,CAAC,EAAE,cAAc,CAAC;AAClD,CAAC"}

package/dist/entity.d.ts

@@ -0,0 +1,110 @@
+import type { FieldDef } from "./types";
+/** Trait codes valid in an entity's `traits` array (entity.schema.json enum). */
+export type TraitCd = "identity" | "audit" | "audit-full" | "soft-delete" | "sorting" | "postable" | "accumulation" | "ledger" | "period" | "file-library";
+/** Foreign-key reference (legacy `references` block — prefer `link` on a field). */
+export interface EntityReference {
+    from: {
+        field: string;
+    };
+    to: {
+        entity: string;
+        field: string;
+    };
+}
+/** Automatic document numbering config (entity `numberSequence`). */
+export interface NumberSequenceDef {
+    /** Column code that receives the auto-generated number. */
+    column: string;
+    /** Module setting code to resolve the prefix from (folder-scoped). */
+    prefixSettingCd?: string;
+    /** Fallback prefix when no setting is configured. */
+    defaultPrefix: string;
+    /** Format pattern. Placeholders: {prefix}, {yyyy}, {yy}, {mm}, {dd}, {seq:N}. */
+    pattern?: string;
+    /** Counter reset period (default: year). */
+    resetPeriod?: "year" | "month" | "day" | "never";
+}
+/** Period-entity config (`period` block; requires the `period` trait). */
+export interface PeriodConfig {
+    /** Format for the period key. Placeholders: {yyyy}, {yy}, {MM}, {dd}, {q}. */
+    keyFormat: string;
+}
+/** Dynamic sign determination based on a field value. */
+export interface SignConfig {
+    /** Field code that determines direction. */
+    field: string;
+    /** Values that mean increase. */
+    positive: string[];
+    /** Values that mean decrease. */
+    negative: string[];
+}
+/** Accumulation-registry config (`accumulation` block; requires the trait). */
+export interface AccumulationConfig {
+    /** Balance entity code (e.g. 'stock'). */
+    balanceEntity: string;
+    /** Balance lookup dimensions: field-name array or balance→document field map. */
+    dimensions: string[] | Record<string, string>;
+    /** Document field → balance field resource mappings. */
+    resources: Record<string, {
+        balanceField: string;
+    }>;
+    /** Fixed posting direction for all postings. */
+    direction?: "increase" | "decrease";
+    /** Dynamic sign (alternative to `direction`). */
+    sign?: SignConfig;
+    autoCreateBalance?: boolean;
+    allowNegative?: boolean;
+    /** Document fields locked once posted. */
+    lockedFields?: string[];
+}
+/** One registry target within an L-column's `registries` array. */
+export interface LedgerRegistryEntry {
+    /** Movement entity code (e.g. 'posting_record'). */
+    movementEntity: string;
+    /** Line field → movement field mapping. */
+    movementMapping: Record<string, string>;
+    /** Balance entity code (e.g. 'balance_register'). */
+    balanceEntity: string;
+    balanceMapping: {
+        /** Balance row dimension columns. */
+        dimensions: string[];
+        /** Balance column for debit turnover. */
+        debitResource: string;
+        /** Balance column for credit turnover. */
+        creditResource: string;
+    };
+}
+/** A single entity definition (`entities/<code>.json`). */
+export interface EntityDef {
+    /** Qualified entity code to extend (e.g. 'fin.invoice') — turns this into an extension. */
+    extends?: string;
+    description?: string;
+    /** Database schema name override (defaults to module schema). */
+    schema?: string;
+    /** Database table/view name (defaults to entity code). */
+    dbObject?: string;
+    /** When true, maps to a SQL view (read-only, no DDL). */
+    isView?: boolean;
+    /** SELECT statement for view-backed entities (`isView=true`). */
+    viewSql?: string;
+    /** Display pattern using column placeholders, e.g. "{first_name} {last_name}". */
+    toString?: string;
+    /** Traits expanded at install time. */
+    traits?: TraitCd[];
+    /** Column definitions keyed by column code. */
+    fields: Record<string, FieldDef>;
+    /** Database constraints (unique, check, …); free-form per the schema. */
+    constraints?: Record<string, unknown>;
+    /** FK references (legacy format; prefer `link` on a field). */
+    references?: Record<string, EntityReference>;
+    /** Database index definitions; free-form per the schema. */
+    indexes?: Record<string, unknown>;
+    numberSequence?: NumberSequenceDef;
+    period?: PeriodConfig;
+    accumulation?: AccumulationConfig;
+    /** Entity-level platform behavior flags. */
+    params?: {
+        restricted?: boolean;
+    } & Record<string, unknown>;
+}
+//# sourceMappingURL=entity.d.ts.map

package/dist/entity.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"entity.d.ts","sourceRoot":"","sources":["../src/entity.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAExC,iFAAiF;AACjF,MAAM,MAAM,OAAO,GAChB,UAAU,GACV,OAAO,GACP,YAAY,GACZ,aAAa,GACb,SAAS,GACT,UAAU,GACV,cAAc,GACd,QAAQ,GACR,QAAQ,GACR,cAAc,CAAC;AAElB,oFAAoF;AACpF,MAAM,WAAW,eAAe;IAC/B,IAAI,EAAE;QAAE,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC;IACxB,EAAE,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC;CACtC;AAED,qEAAqE;AACrE,MAAM,WAAW,iBAAiB;IACjC,2DAA2D;IAC3D,MAAM,EAAE,MAAM,CAAC;IACf,sEAAsE;IACtE,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,qDAAqD;IACrD,aAAa,EAAE,MAAM,CAAC;IACtB,iFAAiF;IACjF,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,4CAA4C;IAC5C,WAAW,CAAC,EAAE,MAAM,GAAG,OAAO,GAAG,KAAK,GAAG,OAAO,CAAC;CACjD;AAED,0EAA0E;AAC1E,MAAM,WAAW,YAAY;IAC5B,8EAA8E;IAC9E,SAAS,EAAE,MAAM,CAAC;CAClB;AAED,yDAAyD;AACzD,MAAM,WAAW,UAAU;IAC1B,4CAA4C;IAC5C,KAAK,EAAE,MAAM,CAAC;IACd,iCAAiC;IACjC,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,iCAAiC;IACjC,QAAQ,EAAE,MAAM,EAAE,CAAC;CACnB;AAED,+EAA+E;AAC/E,MAAM,WAAW,kBAAkB;IAClC,0CAA0C;IAC1C,aAAa,EAAE,MAAM,CAAC;IACtB,iFAAiF;IACjF,UAAU,EAAE,MAAM,EAAE,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC9C,wDAAwD;IACxD,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE;QAAE,YAAY,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACpD,gDAAgD;IAChD,SAAS,CAAC,EAAE,UAAU,GAAG,UAAU,CAAC;IACpC,iDAAiD;IACjD,IAAI,CAAC,EAAE,UAAU,CAAC;IAClB,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAC5B,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,0CAA0C;IAC1C,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;CACxB;AAED,mEAAmE;AACnE,MAAM,WAAW,mBAAmB;IACnC,oDAAoD;IACpD,cAAc,EAAE,MAAM,CAAC;IACvB,2CAA2C;IAC3C,eAAe,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACxC,qDAAqD;IACrD,aAAa,EAAE,MAAM,CAAC;IACtB,cAAc,EAAE;QACf,qCAAqC;QACrC,UAAU,EAAE,MAAM,EAAE,CAAC;QACrB,yCAAyC;QACzC,aAAa,EAAE,MAAM,CAAC;QACtB,0CAA0C;QAC1C,cAAc,EAAE,MAAM,CAAC;KACvB,CAAC;CACF;AAED,2DAA2D;AAC3D,MAAM,WAAW,SAAS;IACzB,2FAA2F;IAC3F,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,iEAAiE;IACjE,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,0DAA0D;IAC1D,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,yDAAyD;IACzD,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,iEAAiE;IACjE,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,kFAAkF;IAClF,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,uCAAuC;IACvC,MAAM,CAAC,EAAE,OAAO,EAAE,CAAC;IACnB,+CAA+C;IAC/C,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;IACjC,yEAAyE;IACzE,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACtC,+DAA+D;IAC/D,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,eAAe,CAAC,CAAC;IAC7C,4DAA4D;IAC5D,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAClC,cAAc,CAAC,EAAE,iBAAiB,CAAC;IACnC,MAAM,CAAC,EAAE,YAAY,CAAC;IACtB,YAAY,CAAC,EAAE,kBAAkB,CAAC;IAClC,4CAA4C;IAC5C,MAAM,CAAC,EAAE;QAAE,UAAU,CAAC,EAAE,OAAO,CAAA;KAAE,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAC5D"}

package/dist/entity.js

@@ -0,0 +1,7 @@
+// Entity definition — authoring shape of an `entities/*.json` file.
+//
+// Mirror of entity.schema.json. Describes a table/view mapping: its fields
+// (see FieldDef in types.ts), traits, references, number sequence and the
+// register configs for accumulation/ledger entities.
+export {};
+//# sourceMappingURL=entity.js.map

package/dist/entity.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"entity.js","sourceRoot":"","sources":["../src/entity.ts"],"names":[],"mappings":"AAAA,oEAAoE;AACpE,EAAE;AACF,2EAA2E;AAC3E,0EAA0E;AAC1E,qDAAqD"}