@dforge-core/metadata 0.0.1

package/dist/menus.d.ts

@@ -0,0 +1,32 @@
+/** Menu item type: V=Data View, D=Document, R=Report, null=folder/section. */
+export type MenuItemType = "V" | "D" | "R" | null;
+/** A menu item; folder/section nodes nest children and omit `itemType`. */
+export interface MenuItemDef {
+    itemType?: MenuItemType;
+    /** Data view code (when `itemType` is 'V'). */
+    dataViewCode?: string;
+    /** Document code (when `itemType` is 'D'). */
+    documentCode?: string;
+    /** Report code (when `itemType` is 'R'). */
+    reportCode?: string;
+    orderNum?: number;
+    /** Display text. */
+    label: string;
+    description?: string;
+    /** Bootstrap icon name. */
+    icon?: string;
+    /** Child items keyed by item code (folder/section nodes). */
+    children?: Record<string, MenuItemDef>;
+}
+/** A menu (value in the `ui/menus.json` map). */
+export interface MenuDef {
+    label: string;
+    description?: string;
+    /** Folder codes where this menu is available. */
+    folders?: string[];
+    /** Menu items keyed by item code. */
+    items: Record<string, MenuItemDef>;
+}
+/** A `ui/menus.json` file: menu code → definition. */
+export type MenusFile = Record<string, MenuDef>;
+//# sourceMappingURL=menus.d.ts.map

package/dist/menus.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"menus.d.ts","sourceRoot":"","sources":["../src/menus.ts"],"names":[],"mappings":"AAEA,8EAA8E;AAC9E,MAAM,MAAM,YAAY,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,IAAI,CAAC;AAElD,2EAA2E;AAC3E,MAAM,WAAW,WAAW;IAC3B,QAAQ,CAAC,EAAE,YAAY,CAAC;IACxB,+CAA+C;IAC/C,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,8CAA8C;IAC9C,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,4CAA4C;IAC5C,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,oBAAoB;IACpB,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,2BAA2B;IAC3B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,6DAA6D;IAC7D,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;CACvC;AAED,iDAAiD;AACjD,MAAM,WAAW,OAAO;IACvB,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,iDAAiD;IACjD,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,qCAAqC;IACrC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;CACnC;AAED,sDAAsD;AACtD,MAAM,MAAM,SAAS,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC"}

package/dist/menus.js

@@ -0,0 +1,3 @@
+// Menus — authoring shape of `ui/menus.json`. Mirror of menus.schema.json.
+export {};
+//# sourceMappingURL=menus.js.map

package/dist/menus.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"menus.js","sourceRoot":"","sources":["../src/menus.ts"],"names":[],"mappings":"AAAA,2EAA2E"}

package/dist/print-templates.d.ts

@@ -0,0 +1,36 @@
+/** Page margins (CSS lengths, e.g. '15mm'). */
+export interface PrintMargins {
+    top?: string;
+    right?: string;
+    bottom?: string;
+    left?: string;
+}
+/** Default page geometry applied when printing from the UI. */
+export interface PrintPageSettings {
+    size?: "A4" | "letter" | "legal";
+    orientation?: "portrait" | "landscape";
+    margins?: PrintMargins;
+}
+/**
+ * A print template or snippet (value in the print_templates map).
+ * `type: 'template'` (default) is entity-bound; `type: 'snippet'` is a
+ * module-scoped Liquid partial included via {% include 'module.snippet' %}.
+ * Either `file` or `template` must be set (`file` wins when both are present).
+ */
+export interface PrintTemplateDef {
+    type?: "template" | "snippet";
+    /** Entity code rendered. Required for templates; ignored for snippets. */
+    entityCd?: string;
+    /** Human-readable label shown in the print menu. */
+    description?: string;
+    /** Inline Liquid HTML. */
+    template?: string;
+    /** Relative path under the module's `print_templates/` directory. */
+    file?: string;
+    /** Inline CSS, or a `.css` filename resolved relative to `print_templates/`. */
+    css?: string;
+    pageSettings?: PrintPageSettings;
+}
+/** A `ui/print_templates.json` file: template_cd → definition. */
+export type PrintTemplatesFile = Record<string, PrintTemplateDef>;
+//# sourceMappingURL=print-templates.d.ts.map

package/dist/print-templates.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"print-templates.d.ts","sourceRoot":"","sources":["../src/print-templates.ts"],"names":[],"mappings":"AAGA,+CAA+C;AAC/C,MAAM,WAAW,YAAY;IAC5B,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;CACd;AAED,+DAA+D;AAC/D,MAAM,WAAW,iBAAiB;IACjC,IAAI,CAAC,EAAE,IAAI,GAAG,QAAQ,GAAG,OAAO,CAAC;IACjC,WAAW,CAAC,EAAE,UAAU,GAAG,WAAW,CAAC;IACvC,OAAO,CAAC,EAAE,YAAY,CAAC;CACvB;AAED;;;;;GAKG;AACH,MAAM,WAAW,gBAAgB;IAChC,IAAI,CAAC,EAAE,UAAU,GAAG,SAAS,CAAC;IAC9B,0EAA0E;IAC1E,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,oDAAoD;IACpD,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,0BAA0B;IAC1B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,qEAAqE;IACrE,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,gFAAgF;IAChF,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,YAAY,CAAC,EAAE,iBAAiB,CAAC;CACjC;AAED,kEAAkE;AAClE,MAAM,MAAM,kBAAkB,GAAG,MAAM,CAAC,MAAM,EAAE,gBAAgB,CAAC,CAAC"}

package/dist/print-templates.js

@@ -0,0 +1,4 @@
+// Print templates — authoring shape of `ui/print_templates.json`.
+// Mirror of print_templates.schema.json.
+export {};
+//# sourceMappingURL=print-templates.js.map

package/dist/print-templates.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"print-templates.js","sourceRoot":"","sources":["../src/print-templates.ts"],"names":[],"mappings":"AAAA,kEAAkE;AAClE,yCAAyC"}

package/dist/reports.d.ts

@@ -0,0 +1,84 @@
+import type { Filter, SortClause } from "./filter";
+import type { NamedKind } from "./types";
+/** Report visualization types. Source: reports.schema.json (`vizType`). */
+export type VizType = "table" | "chart" | "metric" | "pivot";
+/** Friendly picker list of report visualization types. */
+export declare const vizTypes: readonly NamedKind[];
+/** Chart kinds used by report `config.chartType` (curated; rendered via Chart.js). */
+export declare const chartTypes: readonly NamedKind[];
+/** A report parameter definition (report- or dataset-level). */
+export interface ParamDef {
+    /** Field type code (see settings for the common list). */
+    fieldTypeCd: string;
+    label?: string;
+    /** Display order in the parameter form (falls back to declaration order). */
+    orderNum?: number;
+    /** Whether the user must provide a value. */
+    required?: boolean;
+    /** Alternate spelling of `required` used by some modules. Prefer `required`. */
+    isRequired?: boolean;
+    /** Default value applied when the user doesn't provide one. */
+    default?: unknown;
+    /** Entity link for lookup-type params. */
+    link?: {
+        entity: string;
+        otherKey?: string;
+    };
+    /** Field-type-specific params. */
+    params?: Record<string, unknown>;
+}
+/** SQL/entity query for a `datasetType: 'Q'` dataset. */
+export interface ReportQuery {
+    /** Source entity code. */
+    entityCd: string;
+    /** Column codes to select (supports dot navigation: 'customer.name'). */
+    columns?: string[];
+    filter?: Filter;
+    sort?: SortClause[];
+}
+/** Per-column metadata override on a dataset. */
+export interface ColumnDef {
+    label?: string;
+    visible?: boolean;
+    width?: number;
+}
+/** A report dataset (value in the report's `datasets` map). */
+export interface Dataset {
+    /** Display label (used in panel headings if no `title`). */
+    caption?: string;
+    /** Q = SQL/entity query, S = stored procedure. */
+    datasetType: "Q" | "S";
+    /** Used when `datasetType` is 'Q'. */
+    query?: ReportQuery;
+    /** Used when `datasetType` is 'S'. */
+    procedureName?: string;
+    /** Optional column metadata overrides: field code → override. */
+    columnsDef?: Record<string, ColumnDef>;
+    /** Dataset-level parameters (alternative to report-level `parameters`). */
+    params?: Record<string, ParamDef>;
+}
+/** A single visualization panel within the report layout. */
+export interface ReportPanel {
+    vizType: VizType;
+    /** Dataset code (key in the report's `datasets` map). */
+    datasetCd: string;
+    title?: string;
+    /** Viz-type-specific config (chart → { chartType, categoryCol, … }). */
+    config?: Record<string, unknown>;
+}
+export interface ReportLayout {
+    panels: ReportPanel[];
+}
+/** A single report (value in the `ui/reports.json` map). */
+export interface ReportDef {
+    /** Human-readable report title. */
+    description: string;
+    layout: ReportLayout;
+    /** Dataset code → dataset definition. */
+    datasets: Record<string, Dataset>;
+    /** Report-level parameters (alternative to per-dataset `params`). */
+    parameters?: Record<string, ParamDef>;
+}
+/** A `ui/reports.json` file: report code → definition. */
+export type ReportsFile = Record<string, ReportDef>;
+//# sourceMappingURL=reports.d.ts.map

package/dist/reports.d.ts.map

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

package/dist/reports.js

@@ -0,0 +1,24 @@
+// Report registries + the authoring shape of a `ui/reports.json` file.
+//
+// `vizTypes` / `chartTypes` are the friendly picker lists; `ReportDef` and
+// friends mirror reports.schema.json so editors/MCP/CLI can build reports.
+/** Friendly picker list of report visualization types. */
+export const vizTypes = [
+    { cd: "table", name: "Table" },
+    { cd: "chart", name: "Chart" },
+    { cd: "metric", name: "Metric" },
+    { cd: "pivot", name: "Pivot" },
+];
+/** Chart kinds used by report `config.chartType` (curated; rendered via Chart.js). */
+export const chartTypes = [
+    { cd: "bar", name: "Bar" },
+    { cd: "line", name: "Line" },
+    { cd: "area", name: "Area" },
+    { cd: "pie", name: "Pie" },
+    { cd: "donut", name: "Donut" },
+    { cd: "scatter", name: "Scatter" },
+    { cd: "bubble", name: "Bubble" },
+    { cd: "heatmap", name: "Heatmap" },
+    { cd: "funnel", name: "Funnel" },
+];
+//# sourceMappingURL=reports.js.map

package/dist/reports.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"reports.js","sourceRoot":"","sources":["../src/reports.ts"],"names":[],"mappings":"AAAA,uEAAuE;AACvE,EAAE;AACF,2EAA2E;AAC3E,2EAA2E;AAQ3E,0DAA0D;AAC1D,MAAM,CAAC,MAAM,QAAQ,GAAyB;IAC7C,EAAE,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE;IAC9B,EAAE,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE;IAC9B,EAAE,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,QAAQ,EAAE;IAChC,EAAE,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE;CACrB,CAAC;AAEX,sFAAsF;AACtF,MAAM,CAAC,MAAM,UAAU,GAAyB;IAC/C,EAAE,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE;IAC1B,EAAE,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE;IAC5B,EAAE,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE;IAC5B,EAAE,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE;IAC1B,EAAE,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE;IAC9B,EAAE,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,SAAS,EAAE;IAClC,EAAE,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,QAAQ,EAAE;IAChC,EAAE,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,SAAS,EAAE;IAClC,EAAE,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,QAAQ,EAAE;CACvB,CAAC"}

package/dist/roles.d.ts

@@ -0,0 +1,10 @@
+/** A role with its entity rights (value in the roles map). */
+export interface RoleDef {
+    /** Role display name. */
+    description: string;
+    /** Entity code → rights string. Rights: S/I/U/D/C/E (pattern ^[SIUDCE]*$). */
+    rights: Record<string, string>;
+}
+/** A `roles.json` file: role code → definition. */
+export type RolesFile = Record<string, RoleDef>;
+//# sourceMappingURL=roles.d.ts.map

package/dist/roles.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"roles.d.ts","sourceRoot":"","sources":["../src/roles.ts"],"names":[],"mappings":"AAEA,8DAA8D;AAC9D,MAAM,WAAW,OAAO;IACvB,yBAAyB;IACzB,WAAW,EAAE,MAAM,CAAC;IACpB,8EAA8E;IAC9E,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAC/B;AAED,mDAAmD;AACnD,MAAM,MAAM,SAAS,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC"}

package/dist/roles.js

@@ -0,0 +1,3 @@
+// Roles — authoring shape of `security/roles.json`. Mirror of roles.schema.json.
+export {};
+//# sourceMappingURL=roles.js.map

package/dist/roles.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"roles.js","sourceRoot":"","sources":["../src/roles.ts"],"names":[],"mappings":"AAAA,iFAAiF"}

package/dist/seed-data.d.ts

@@ -0,0 +1,8 @@
+/** A seed-data file: records to insert into one entity. */
+export interface SeedDataFile {
+    /** Target entity code. */
+    entityCode: string;
+    /** Records to insert; each is a `column_code → value` map. */
+    records: Record<string, unknown>[];
+}
+//# sourceMappingURL=seed-data.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"seed-data.d.ts","sourceRoot":"","sources":["../src/seed-data.ts"],"names":[],"mappings":"AAGA,2DAA2D;AAC3D,MAAM,WAAW,YAAY;IAC5B,0BAA0B;IAC1B,UAAU,EAAE,MAAM,CAAC;IACnB,8DAA8D;IAC9D,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,CAAC;CACnC"}

package/dist/seed-data.js

@@ -0,0 +1,4 @@
+// Seed data — authoring shape of a `seed-data/*.json` file.
+// Mirror of seed_data.schema.json.
+export {};
+//# sourceMappingURL=seed-data.js.map

package/dist/seed-data.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"seed-data.js","sourceRoot":"","sources":["../src/seed-data.ts"],"names":[],"mappings":"AAAA,4DAA4D;AAC5D,mCAAmC"}

package/dist/settings.d.ts

@@ -0,0 +1,26 @@
+/** Underlying primitive datatype for a setting. */
+export type SettingBaseDatatype = "string" | "number" | "bool" | "date" | "dateTime" | "time" | "json";
+/** A single setting definition (value in the settings map). */
+export interface SettingDef {
+    /** Field type code (must match a `dforge.field_type` code). */
+    fieldTypeCd: string;
+    /** Underlying primitive datatype (older settings declare this explicitly). */
+    baseDatatypeCd?: SettingBaseDatatype;
+    /** Display label (preferred for new settings). */
+    label?: string;
+    /** Display label (older style). Prefer `label`. */
+    description?: string;
+    /** Alternative older label key. Prefer `label`. */
+    desc?: string;
+    /** Default value before the user sets one. */
+    defaultValue?: unknown;
+    /** Formula to evaluate the default (alternative to `defaultValue`). */
+    formula?: string;
+    /** If true, must be set somewhere in the folder chain for install to proceed. */
+    required?: boolean;
+    /** Field-type-specific parameters (dropdown options, min/max, lookup link, …). */
+    params?: Record<string, unknown>;
+}
+/** A `settings.json` file: setting code → definition. */
+export type SettingsFile = Record<string, SettingDef>;
+//# sourceMappingURL=settings.d.ts.map

package/dist/settings.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"settings.d.ts","sourceRoot":"","sources":["../src/settings.ts"],"names":[],"mappings":"AAEA,mDAAmD;AACnD,MAAM,MAAM,mBAAmB,GAAG,QAAQ,GAAG,QAAQ,GAAG,MAAM,GAAG,MAAM,GAAG,UAAU,GAAG,MAAM,GAAG,MAAM,CAAC;AAEvG,+DAA+D;AAC/D,MAAM,WAAW,UAAU;IAC1B,+DAA+D;IAC/D,WAAW,EAAE,MAAM,CAAC;IACpB,8EAA8E;IAC9E,cAAc,CAAC,EAAE,mBAAmB,CAAC;IACrC,kDAAkD;IAClD,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,mDAAmD;IACnD,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,mDAAmD;IACnD,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,8CAA8C;IAC9C,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,uEAAuE;IACvE,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,iFAAiF;IACjF,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,kFAAkF;IAClF,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACjC;AAED,yDAAyD;AACzD,MAAM,MAAM,YAAY,GAAG,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC"}

package/dist/settings.js

@@ -0,0 +1,3 @@
+// Module settings — authoring shape of `settings.json`. Mirror of settings.schema.json.
+export {};
+//# sourceMappingURL=settings.js.map

package/dist/settings.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"settings.js","sourceRoot":"","sources":["../src/settings.ts"],"names":[],"mappings":"AAAA,wFAAwF"}

package/dist/traits.d.ts

@@ -0,0 +1,14 @@
+import type { FieldDef, TraitDef } from "./types";
+export declare const traits: readonly TraitDef[];
+/** Look up a trait by code. */
+export declare function getTrait(cd: string): TraitDef | undefined;
+/**
+ * Expand a trait (and any traits it includes) into the concrete fields it adds
+ * for `entityName`, with `{entity}` / `{Entity}` tokens resolved. Returns an
+ * empty object for unknown or marker traits. Field order follows include-depth
+ * first, then declaration order; later definitions win on key collisions.
+ */
+export declare function expandTrait(traitCd: string, entityName: string): Record<string, FieldDef>;
+/** Expand several traits in order into one merged field map. */
+export declare function expandTraits(traitCds: readonly string[], entityName: string): Record<string, FieldDef>;
+//# sourceMappingURL=traits.d.ts.map

package/dist/traits.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"traits.d.ts","sourceRoot":"","sources":["../src/traits.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAElD,eAAO,MAAM,MAAM,EAAE,SAAS,QAAQ,EA2D5B,CAAC;AAIX,+BAA+B;AAC/B,wBAAgB,QAAQ,CAAC,EAAE,EAAE,MAAM,GAAG,QAAQ,GAAG,SAAS,CAEzD;AA4BD;;;;;GAKG;AACH,wBAAgB,WAAW,CAAC,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,QAAQ,CAAC,CASzF;AAED,gEAAgE;AAChE,wBAAgB,YAAY,CAAC,QAAQ,EAAE,SAAS,MAAM,EAAE,EAAE,UAAU,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,QAAQ,CAAC,CAItG"}

package/dist/traits.js

@@ -0,0 +1,121 @@
+// Trait registry — mirror of
+//   server/database/system-modules/metadata/traits.json
+//
+// Traits are authoring shortcuts: adding one to an entity injects a fixed set of
+// fields (and sometimes references) at install time. The visual editor offers
+// these as checkboxes and previews the expanded fields, so authors never
+// hand-write `created_date` / `{entity}_id` etc.
+export const traits = [
+    {
+        cd: "identity",
+        description: "Primary Key",
+        fields: {
+            "{entity}_id": { dbDatatype: "cuid", flags: "I", isPk: true, isIdentity: true, isNullable: false, orderNum: 1, description: "{Entity} ID" },
+        },
+    },
+    {
+        cd: "audit",
+        description: "Creation and update timestamps",
+        fields: {
+            created_date: { dbDatatype: "timestamptz", fieldTypeCd: "datetime", flags: "I", isNullable: false, formula: "NOW()", orderNum: 9901, description: "Created Date" },
+            last_updated: { dbDatatype: "timestamptz", fieldTypeCd: "datetime", flags: "I", isNullable: false, formula: "NOW()", orderNum: 9902, description: "Last Updated" },
+        },
+    },
+    {
+        cd: "audit-full",
+        description: "Full audit with user tracking",
+        includes: ["audit"],
+        fields: {
+            created_by: { dbDatatype: "cuid", flags: "I", isNullable: false, orderNum: 9903, description: "Created By User ID" },
+            created_by_user: { columnType: "R", fieldTypeCd: "lookup", flags: "I", orderNum: 9904, description: "Created By", link: { entity: "user", thisKey: "created_by", otherKey: "user_id" } },
+            last_updated_by: { dbDatatype: "cuid", flags: "I", isNullable: false, orderNum: 9905, description: "Last Updated By User ID" },
+            last_updated_by_user: { columnType: "R", fieldTypeCd: "lookup", flags: "I", orderNum: 9906, description: "Last Updated By", link: { entity: "user", thisKey: "last_updated_by", otherKey: "user_id" } },
+        },
+        references: {
+            "FK_{Entity}_CreatedBy": { from: { field: "created_by" }, to: { entity: "user", field: "user_id" } },
+            "FK_{Entity}_LastUpdatedBy": { from: { field: "last_updated_by" }, to: { entity: "user", field: "user_id" } },
+        },
+    },
+    {
+        cd: "soft-delete",
+        description: "Soft delete flag",
+        fields: {
+            active: { dbDatatype: "bool", fieldTypeCd: "checkbox", flags: "", isNullable: false, formula: "true", orderNum: 9910, description: "Active" },
+        },
+    },
+    {
+        cd: "sorting",
+        description: "Display order",
+        fields: {
+            order_num: { dbDatatype: "int4", fieldTypeCd: "number", flags: "VEM", orderNum: 9920, description: "Order" },
+        },
+    },
+    { cd: "postable", description: "Document posting support (marker trait — actual state managed by A/L columns)", fields: {} },
+    { cd: "accumulation", description: "Accumulation register (marker trait — config in A-type column params)", fields: {} },
+    { cd: "ledger", description: "Double-entry ledger (marker trait — config in L-type column params)", fields: {} },
+    {
+        cd: "period",
+        description: "Period entity with key format, closed flag, date range",
+        fields: {
+            period_key: { dbDatatype: "varchar", fieldTypeCd: "text", flags: "VEM", isPk: true, isNullable: false, maxLen: 20, orderNum: 1, description: "Period Key" },
+            description: { dbDatatype: "varchar", fieldTypeCd: "text", flags: "VEM", maxLen: 100, orderNum: 30, description: "Description" },
+            closed: { dbDatatype: "bool", fieldTypeCd: "checkbox", flags: "VEM", isNullable: false, formula: "false", orderNum: 40, description: "Closed" },
+            start_date: { dbDatatype: "date", fieldTypeCd: "date", flags: "VEM", orderNum: 50, description: "Start Date" },
+            end_date: { dbDatatype: "date", fieldTypeCd: "date", flags: "VEM", orderNum: 60, description: "End Date" },
+        },
+    },
+];
+const byCd = new Map(traits.map((t) => [t.cd, t]));
+/** Look up a trait by code. */
+export function getTrait(cd) {
+    return byCd.get(cd);
+}
+/** Title-case a snake_case entity code for the `{Entity}` template token. */
+function titleCaseEntity(entity) {
+    const local = entity.split(".").pop() ?? entity;
+    return local
+        .split(/[_\s]+/)
+        .filter(Boolean)
+        .map((part) => part.charAt(0).toUpperCase() + part.slice(1))
+        .join(" ");
+}
+function applyTemplate(value, entity) {
+    const local = entity.split(".").pop() ?? entity;
+    return value.replace(/\{entity\}/g, local).replace(/\{Entity\}/g, titleCaseEntity(entity));
+}
+function templateFields(fields, entity) {
+    const out = {};
+    for (const [name, def] of Object.entries(fields)) {
+        const key = applyTemplate(name, entity);
+        const next = { ...def };
+        if (typeof next.description === "string")
+            next.description = applyTemplate(next.description, entity);
+        out[key] = next;
+    }
+    return out;
+}
+/**
+ * Expand a trait (and any traits it includes) into the concrete fields it adds
+ * for `entityName`, with `{entity}` / `{Entity}` tokens resolved. Returns an
+ * empty object for unknown or marker traits. Field order follows include-depth
+ * first, then declaration order; later definitions win on key collisions.
+ */
+export function expandTrait(traitCd, entityName) {
+    const trait = byCd.get(traitCd);
+    if (!trait)
+        return {};
+    const result = {};
+    for (const included of trait.includes ?? []) {
+        Object.assign(result, expandTrait(included, entityName));
+    }
+    Object.assign(result, templateFields(trait.fields, entityName));
+    return result;
+}
+/** Expand several traits in order into one merged field map. */
+export function expandTraits(traitCds, entityName) {
+    const result = {};
+    for (const cd of traitCds)
+        Object.assign(result, expandTrait(cd, entityName));
+    return result;
+}
+//# sourceMappingURL=traits.js.map

package/dist/traits.js.map

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

package/dist/triggers.d.ts

@@ -0,0 +1,24 @@
+/** DB event a trigger or webhook watches. */
+export type EntityEvent = "insert" | "update" | "delete" | "status_change" | "any";
+/** A single trigger declaration. */
+export interface TriggerDef {
+    /** Trigger code, unique within the module. */
+    code: string;
+    description?: string;
+    /** Entity whose events this watches (cross-module via 'module.entity'). */
+    entity: string;
+    event: EntityEvent;
+    /** Optional `[field]`-syntax formula; trigger fires only when true. */
+    condition?: string;
+    /** Action code to invoke (cross-module form 'module.action' supported). */
+    action: string;
+    /** Static parameters passed to the action, merged with the injected record id. */
+    params?: Record<string, unknown>;
+    /** Run the action in the background after the triggering tx commits (default false). */
+    async?: boolean;
+}
+/** A `logic/triggers.json` file. */
+export interface TriggersFile {
+    triggers: TriggerDef[];
+}
+//# sourceMappingURL=triggers.d.ts.map

package/dist/triggers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"triggers.d.ts","sourceRoot":"","sources":["../src/triggers.ts"],"names":[],"mappings":"AAEA,6CAA6C;AAC7C,MAAM,MAAM,WAAW,GAAG,QAAQ,GAAG,QAAQ,GAAG,QAAQ,GAAG,eAAe,GAAG,KAAK,CAAC;AAEnF,oCAAoC;AACpC,MAAM,WAAW,UAAU;IAC1B,8CAA8C;IAC9C,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,2EAA2E;IAC3E,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,WAAW,CAAC;IACnB,uEAAuE;IACvE,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,2EAA2E;IAC3E,MAAM,EAAE,MAAM,CAAC;IACf,kFAAkF;IAClF,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACjC,wFAAwF;IACxF,KAAK,CAAC,EAAE,OAAO,CAAC;CAChB;AAED,oCAAoC;AACpC,MAAM,WAAW,YAAY;IAC5B,QAAQ,EAAE,UAAU,EAAE,CAAC;CACvB"}

package/dist/triggers.js

@@ -0,0 +1,3 @@
+// Triggers — authoring shape of `logic/triggers.json`. Mirror of triggers.schema.json.
+export {};
+//# sourceMappingURL=triggers.js.map

package/dist/triggers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"triggers.js","sourceRoot":"","sources":["../src/triggers.ts"],"names":[],"mappings":"AAAA,uFAAuF"}

package/dist/types.d.ts

@@ -0,0 +1,121 @@
+/** A `{ cd, name }` pair for friendly pickers (view kinds, viz types, …). */
+export interface NamedKind {
+    cd: string;
+    name: string;
+}
+/** Horizontal alignment for a column's display (authored via `params.align`). */
+export type AlignType = "left" | "right" | "center";
+/** Column kind letter as stored in entity JSON / the `column` metadata table. */
+export type ColumnTypeCd = "D" | "R" | "S" | "F" | "A" | "L" | "G";
+/** Abstract data type code from the `base_datatype` table. */
+export type BaseDatatypeCd = "binary" | "bool" | "culture" | "cuid" | "date" | "guid" | "json" | "link" | "number" | "project" | "ref" | "set" | "string" | "time" | "timestamp" | "xml";
+/** Display flags string characters. V=Visible I=Identity E=Editable M=Mandatory H=Hidden. */
+export type FlagCd = "V" | "I" | "E" | "M" | "H";
+/** Known field type codes from the field_type seed. */
+export type FieldTypeCd = "text" | "email" | "phone" | "url" | "textarea" | "number" | "currency" | "percent" | "checkbox" | "date" | "datetime" | "time" | "dropdown" | "flags" | "json" | "hidden" | "color" | "image" | "file" | "richtext" | "lookup" | "user" | "grid" | "tags" | "entitylink" | "code";
+/**
+ * A UI field type from the `field_type` table. The author picks one of these;
+ * the physical `dbDatatype` and `baseDatatypeCd` are derived from it.
+ */
+export interface FieldTypeDef {
+    /** Stable code stored as `fieldTypeCd` on a field. */
+    cd: FieldTypeCd;
+    /** Human label for pickers. */
+    name: string;
+    /** Default column kind this field type implies (D / R / S). */
+    columnType: ColumnTypeCd;
+    /** Abstract datatype used for platform semantics. */
+    baseDatatypeCd: BaseDatatypeCd;
+    /** Aggregations this type supports: S=sum C=count A=avg M=min/max (letters). */
+    supportedAgg: string | null;
+    /** Default maximum length for string-backed types (e.g. color = 20). */
+    maxLen: number | null;
+    /** Default numeric scale for number-backed types (e.g. currency = 2). */
+    precision: number | null;
+    /** Whether the value participates in text filters. */
+    useStringInFilter: boolean;
+    /** Default field-type params merged into `params` when the field is created. */
+    defParams?: Record<string, unknown>;
+}
+/** Relationship link for Reference (R) and Set (S) columns. */
+export interface FieldLink {
+    /** Target entity code (the entity being referenced or collected). */
+    entity: string;
+    /** Column(s) in this entity (comma-separated for compound keys). */
+    thisKey: string;
+    /** Column(s) in the target entity (comma-separated for compound keys). */
+    otherKey: string;
+}
+/** A dropdown/flags option in `params.options` (rich form). */
+export interface FieldOption {
+    value: string;
+    label: string;
+    icon?: string;
+    color?: string;
+}
+/**
+ * A field/column definition as it appears under an entity's `fields` map.
+ * Mirrors the `field` $def in entity.schema.json. Trait fields are a subset of
+ * this shape, so the same type covers both. The open index signature keeps it
+ * tolerant of forward-compatible / type-specific extras (e.g. A/L register
+ * config under `params`).
+ */
+export interface FieldDef {
+    /** PostgreSQL data type (e.g. uuid, varchar, int4, numeric, timestamptz). */
+    dbDatatype?: string;
+    /** Abstract base datatype; required on Formula (F) columns. */
+    baseDatatypeCd?: BaseDatatypeCd;
+    /** UI field type code. */
+    fieldTypeCd?: FieldTypeCd;
+    /** Column kind (defaults to D when omitted). */
+    columnType?: ColumnTypeCd;
+    /** Display flags string (subset of V/I/E/M/H). */
+    flags?: string;
+    isPk?: boolean;
+    isNullable?: boolean;
+    isIdentity?: boolean;
+    /** Formula expression (F/G columns) or SQL default value. */
+    formula?: string;
+    orderNum?: number;
+    description?: string;
+    maxLen?: number;
+    precision?: number;
+    /** Input mask pattern for editing. */
+    editMask?: string;
+    /** Display format pattern. */
+    displayFmt?: string;
+    /** Relationship link for R and S columns. */
+    link?: FieldLink;
+    /**
+     * On a self-referencing R column, set true to ALLOW parent/child cycles.
+     * Absent ⇒ treated as an acyclic hierarchy guarded at the DB level.
+     */
+    cyclic?: boolean;
+    /** Filter criteria for reference lookups. */
+    refFilter?: unknown;
+    /** Field-type-specific configuration (dropdown options, register config, …). */
+    params?: {
+        options?: (string | FieldOption)[];
+    } & Record<string, unknown>;
+    [key: string]: unknown;
+}
+/** A reusable trait that expands into a set of fields (and optional references). */
+export interface TraitDef {
+    cd: string;
+    description: string;
+    /** Other traits this one includes (expanded first). */
+    includes?: string[];
+    /** Fields injected, keyed by column code. `{entity}` / `{Entity}` are templated. */
+    fields: Record<string, FieldDef>;
+    /** Foreign-key references injected (legacy `references` block). */
+    references?: Record<string, unknown>;
+}
+/** Description of a column kind for friendly pickers. */
+export interface ColumnTypeDef {
+    cd: ColumnTypeCd;
+    /** Author-facing label. */
+    name: string;
+    /** One-line explanation. */
+    description: string;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAMA,6EAA6E;AAC7E,MAAM,WAAW,SAAS;IACzB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;CACb;AAED,iFAAiF;AACjF,MAAM,MAAM,SAAS,GAAG,MAAM,GAAG,OAAO,GAAG,QAAQ,CAAC;AAEpD,iFAAiF;AACjF,MAAM,MAAM,YAAY,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,CAAC;AAEnE,8DAA8D;AAC9D,MAAM,MAAM,cAAc,GACvB,QAAQ,GACR,MAAM,GACN,SAAS,GACT,MAAM,GACN,MAAM,GACN,MAAM,GACN,MAAM,GACN,MAAM,GACN,QAAQ,GACR,SAAS,GACT,KAAK,GACL,KAAK,GACL,QAAQ,GACR,MAAM,GACN,WAAW,GACX,KAAK,CAAC;AAET,6FAA6F;AAC7F,MAAM,MAAM,MAAM,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,CAAC;AAEjD,uDAAuD;AACvD,MAAM,MAAM,WAAW,GACpB,MAAM,GACN,OAAO,GACP,OAAO,GACP,KAAK,GACL,UAAU,GACV,QAAQ,GACR,UAAU,GACV,SAAS,GACT,UAAU,GACV,MAAM,GACN,UAAU,GACV,MAAM,GACN,UAAU,GACV,OAAO,GACP,MAAM,GACN,QAAQ,GACR,OAAO,GACP,OAAO,GACP,MAAM,GACN,UAAU,GACV,QAAQ,GACR,MAAM,GACN,MAAM,GACN,MAAM,GACN,YAAY,GACZ,MAAM,CAAC;AAEV;;;GAGG;AACH,MAAM,WAAW,YAAY;IAC5B,sDAAsD;IACtD,EAAE,EAAE,WAAW,CAAC;IAChB,+BAA+B;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,+DAA+D;IAC/D,UAAU,EAAE,YAAY,CAAC;IACzB,qDAAqD;IACrD,cAAc,EAAE,cAAc,CAAC;IAC/B,gFAAgF;IAChF,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,wEAAwE;IACxE,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,yEAAyE;IACzE,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,sDAAsD;IACtD,iBAAiB,EAAE,OAAO,CAAC;IAC3B,gFAAgF;IAChF,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC;AAED,+DAA+D;AAC/D,MAAM,WAAW,SAAS;IACzB,qEAAqE;IACrE,MAAM,EAAE,MAAM,CAAC;IACf,oEAAoE;IACpE,OAAO,EAAE,MAAM,CAAC;IAChB,0EAA0E;IAC1E,QAAQ,EAAE,MAAM,CAAC;CACjB;AAED,+DAA+D;AAC/D,MAAM,WAAW,WAAW;IAC3B,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;CACf;AAED;;;;;;GAMG;AACH,MAAM,WAAW,QAAQ;IACxB,6EAA6E;IAC7E,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,+DAA+D;IAC/D,cAAc,CAAC,EAAE,cAAc,CAAC;IAChC,0BAA0B;IAC1B,WAAW,CAAC,EAAE,WAAW,CAAC;IAC1B,gDAAgD;IAChD,UAAU,CAAC,EAAE,YAAY,CAAC;IAC1B,kDAAkD;IAClD,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,6DAA6D;IAC7D,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,sCAAsC;IACtC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,8BAA8B;IAC9B,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,6CAA6C;IAC7C,IAAI,CAAC,EAAE,SAAS,CAAC;IACjB;;;OAGG;IACH,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,6CAA6C;IAC7C,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,gFAAgF;IAChF,MAAM,CAAC,EAAE;QAAE,OAAO,CAAC,EAAE,CAAC,MAAM,GAAG,WAAW,CAAC,EAAE,CAAA;KAAE,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC1E,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACvB;AAED,oFAAoF;AACpF,MAAM,WAAW,QAAQ;IACxB,EAAE,EAAE,MAAM,CAAC;IACX,WAAW,EAAE,MAAM,CAAC;IACpB,uDAAuD;IACvD,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB,oFAAoF;IACpF,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;IACjC,mEAAmE;IACnE,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACrC;AAED,yDAAyD;AACzD,MAAM,WAAW,aAAa;IAC7B,EAAE,EAAE,YAAY,CAAC;IACjB,2BAA2B;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,4BAA4B;IAC5B,WAAW,EAAE,MAAM,CAAC;CACpB"}