@dforge-core/metadata 0.0.12 → 0.0.13

package/schemas/data_views.schema.json

@@ -492,7 +492,20 @@
 				},
 				"o": {
 					"type": "string",
-					"description": "Operator: eq, neq, =, !=, gt, gtEq, grEq, lt, ltEq, in, nIn, like, isNull, isNotNull, etc."
+					"enum": [
+						"=", "eq", "!=", "notEq",
+						">", "gr", ">=", "grEq", "<", "less", "<=", "lessEq",
+						"eqRef",
+						"contains", "!contains", "nContain",
+						"start", "!start", "nStart",
+						"end", "!end", "nEnd",
+						"mask", "!mask", "nMask",
+						"null", "empty", "!null", "nEmpty",
+						"in", "!in", "nIn",
+						"between", "btw", "!between", "nBetween",
+						"f", "func"
+					],
+					"description": "Operator. Closed set — this is exactly what the server's FilterBuilder translates, and an operator outside it is rejected at install. Symbolic forms and their word aliases are equivalent ('=' / 'eq', '!=' / 'notEq', '>' / 'gr', '>=' / 'grEq', '<' / 'less', '<=' / 'lessEq'); a leading '!' negates, with 'n'-prefixed spellings as the alias ('!in' / 'nIn'). Null checks are 'null' / 'empty' and '!null' / 'nEmpty' (NOT 'isNull' / 'isNotNull'); substring matching is 'contains' (NOT 'like'). 'eqRef' compares against another column (v = column code), 'f' / 'func' takes v = {fn: 'isToday' | 'isYesterday' | 'isThisWeek' | 'isThisMonth' | 'isThisYear' | 'isPast' | 'isFuture' | 'isCurrentUser'}."
 				},
 				"v": {
 					"description": "Comparison value. Scalars, arrays (for in/nIn), or parameter references like '@param_code'."
@@ -506,8 +519,8 @@
 			"properties": {
 				"g": {
 					"type": "string",
-					"enum": ["and", "or"],
-					"description": "Group combinator"
+					"enum": ["and", "or", "!and", "nAnd", "!or", "nOr"],
+					"description": "Group combinator. '!and' / '!or' negate the whole group ('nAnd' / 'nOr' are the alias spellings). Closed set — an unknown combinator is rejected at install (at query time it would silently fall back to AND)."
 				},
 				"i": {
 					"type": "array",

package/schemas/folders.schema.json

@@ -87,7 +87,23 @@
 			"required": ["c", "o"],
 			"properties": {
 				"c": { "type": "string" },
-				"o": { "type": "string" },
+				"o": {
+					"type": "string",
+					"enum": [
+						"=", "eq", "!=", "notEq",
+						">", "gr", ">=", "grEq", "<", "less", "<=", "lessEq",
+						"eqRef",
+						"contains", "!contains", "nContain",
+						"start", "!start", "nStart",
+						"end", "!end", "nEnd",
+						"mask", "!mask", "nMask",
+						"null", "empty", "!null", "nEmpty",
+						"in", "!in", "nIn",
+						"between", "btw", "!between", "nBetween",
+						"f", "func"
+					],
+					"description": "Operator — same closed set as data_views.json. Null checks are 'null' / '!null' (NOT 'isNull' / 'isNotNull'); substring matching is 'contains' (NOT 'like'). An operator outside this set is rejected at install; at query time it would be dropped, widening the row filter it was meant to enforce."
+				},
 				"v": {}
 			},
 			"additionalProperties": false
@@ -96,7 +112,7 @@
 			"type": "object",
 			"required": ["g", "i"],
 			"properties": {
-				"g": { "type": "string", "enum": ["and", "or"] },
+				"g": { "type": "string", "enum": ["and", "or", "!and", "nAnd", "!or", "nOr"] },
 				"i": {
 					"type": "array",
 					"items": { "$ref": "#/$defs/filter" }

package/schemas/reports.schema.json

@@ -366,7 +366,23 @@
 			"required": ["c", "o"],
 			"properties": {
 				"c": { "type": "string" },
-				"o": { "type": "string" },
+				"o": {
+					"type": "string",
+					"enum": [
+						"=", "eq", "!=", "notEq",
+						">", "gr", ">=", "grEq", "<", "less", "<=", "lessEq",
+						"eqRef",
+						"contains", "!contains", "nContain",
+						"start", "!start", "nStart",
+						"end", "!end", "nEnd",
+						"mask", "!mask", "nMask",
+						"null", "empty", "!null", "nEmpty",
+						"in", "!in", "nIn",
+						"between", "btw", "!between", "nBetween",
+						"f", "func"
+					],
+					"description": "Operator — same closed set as data_views.json. Null checks are 'null' / '!null' (NOT 'isNull' / 'isNotNull'); substring matching is 'contains' (NOT 'like'). An operator outside this set is rejected at install; at query time it would be dropped, silently widening the dataset."
+				},
 				"v": {}
 			},
 			"additionalProperties": false
@@ -375,7 +391,7 @@
 			"type": "object",
 			"required": ["g", "i"],
 			"properties": {
-				"g": { "type": "string", "enum": ["and", "or"] },
+				"g": { "type": "string", "enum": ["and", "or", "!and", "nAnd", "!or", "nOr"] },
 				"i": {
 					"type": "array",
 					"items": { "$ref": "#/$defs/filter" }

package/src/filter.ts

@@ -4,12 +4,44 @@
 // API: either a single condition `{c, o, v}` or a group `{g, i: [...]}`. Mirror
 // of the `filter` $def repeated across data_views / reports / folders schemas.
 
+/**
+ * Every operator the server's FilterBuilder translates — the closed set the
+ * `o` enum in the data_views / reports / folders schemas mirrors, and the set
+ * the installer validates a package's filters against.
+ *
+ * Symbolic forms and their word aliases are equivalent (`=`/`eq`, `!=`/`notEq`,
+ * `>`/`gr`, …); a leading `!` negates, with `n`-prefixed spellings as the alias
+ * (`!in`/`nIn`). Note the two spellings authors most often get wrong: null
+ * checks are `null` / `!null` (not `isNull` / `isNotNull`) and substring
+ * matching is `contains` (not `like`).
+ */
+export const FILTER_OPERATORS = [
+	"=", "eq", "!=", "notEq",
+	">", "gr", ">=", "grEq", "<", "less", "<=", "lessEq",
+	"eqRef",
+	"contains", "!contains", "nContain",
+	"start", "!start", "nStart",
+	"end", "!end", "nEnd",
+	"mask", "!mask", "nMask",
+	"null", "empty", "!null", "nEmpty",
+	"in", "!in", "nIn",
+	"between", "btw", "!between", "nBetween",
+	"f", "func",
+] as const;
+
+export type FilterOperator = (typeof FILTER_OPERATORS)[number];
+
+/** Every group combinator the server recognizes. `!`/`n` forms negate the group. */
+export const FILTER_GROUP_OPERATORS = ["and", "or", "!and", "nAnd", "!or", "nOr"] as const;
+
+export type FilterGroupOperator = (typeof FILTER_GROUP_OPERATORS)[number];
+
 /** A single filter condition. */
 export interface FilterCondition {
 	/** Column code (supports dot navigation: 'customer.name'). */
 	c: string;
-	/** Operator: eq, neq, =, !=, gt, gtEq, lt, ltEq, in, nIn, like, isNull, … */
-	o: string;
+	/** Operator — see {@link FILTER_OPERATORS}. */
+	o: FilterOperator;
 	/** Comparison value: scalar, array (in/nIn) or a `@param_code` reference. */
 	v?: unknown;
 }
@@ -17,7 +49,7 @@ export interface FilterCondition {
 /** A boolean group of nested conditions/sub-groups. */
 export interface FilterGroup {
 	/** Group combinator. */
-	g: "and" | "or";
+	g: FilterGroupOperator;
 	/** Group items: nested conditions or sub-groups. */
 	i: Filter[];
 }

package/src/index.ts

@@ -43,7 +43,15 @@ export {
 } from "./derive";
 
 // ── Shared filter expression (data views / reports / folders / API) ──────────
-export type { Filter, FilterCondition, FilterGroup, SortClause } from "./filter";
+export type {
+	Filter,
+	FilterCondition,
+	FilterGroup,
+	FilterGroupOperator,
+	FilterOperator,
+	SortClause,
+} from "./filter";
+export { FILTER_GROUP_OPERATORS, FILTER_OPERATORS } from "./filter";
 
 // ── Module-file structural types ─────────────────────────────────────────────
 export type {

package/dist/actions.d.ts

@@ -1,31 +0,0 @@
-/**
- * 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

@@ -1 +0,0 @@
-{"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

@@ -1,7 +0,0 @@
-// 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

@@ -1 +0,0 @@
-{"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

@@ -1,13 +0,0 @@
-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

@@ -1 +0,0 @@
-{"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

@@ -1,17 +0,0 @@
-// 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

@@ -1 +0,0 @@
-{"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

@@ -1,5 +0,0 @@
-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

@@ -1 +0,0 @@
-{"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

@@ -1,49 +0,0 @@
-// 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

@@ -1 +0,0 @@
-{"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

@@ -1,5 +0,0 @@
-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

@@ -1 +0,0 @@
-{"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

@@ -1,18 +0,0 @@
-// 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

@@ -1 +0,0 @@
-{"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

@@ -1,95 +0,0 @@
-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" | "matrix";
-/** 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

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

package/dist/data-views.js

@@ -1,18 +0,0 @@
-// 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" },
-    { cd: "matrix", name: "Matrix" },
-];
-//# sourceMappingURL=data-views.js.map

package/dist/data-views.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"data-views.js","sourceRoot":"","sources":["../src/data-views.ts"],"names":[],"mappings":"AAAA,6EAA6E;AAC7E,EAAE;AACF,gFAAgF;AAChF,8EAA8E;AAoB9E,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;IAClC,EAAE,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,QAAQ,EAAE;CACvB,CAAC"}

package/dist/deps.d.ts

@@ -1,55 +0,0 @@
-/**
- * Allowed storage-class tokens for a consumed column — Postgres type names with
- * length/scale stripped. Closed allowlist, kept in lockstep with the `type` enum in
- * `deps.schema.json` (and `DependencyContractValidator.ValidColumnTypes` on the C#
- * side); the `schemas.test.ts` parity guard fails if this drifts from the schema.
- * Extend all three together if a provider column legitimately uses a type not here.
- */
-export declare const DEP_COLUMN_TYPES: readonly ["int2", "int4", "int8", "smallint", "integer", "bigint", "numeric", "decimal", "float4", "float8", "real", "money", "varchar", "text", "char", "bpchar", "bool", "boolean", "date", "time", "timetz", "timestamp", "timestamptz", "uuid", "json", "jsonb", "bytea"];
-/**
- * Storage class pinned for a consumed column — the provider's physical Postgres type
- * with length/scale stripped (e.g. `int8`, `numeric`, `varchar`). dForge's `cuid`
- * Snowflake PK normalizes to `int8`. Pinning the storage class (not a coarse base
- * type) keeps FK/lookup compatibility meaningful — an `int8` key needs `int8`, not
- * any number. One of {@link DEP_COLUMN_TYPES}.
- */
-export type DepColumnType = (typeof DEP_COLUMN_TYPES)[number];
-/** Whether the consumer reads or writes a column. Default `read`. */
-export type DepColumnMode = "read" | "write";
-/** Kinds of cross-module usage a provenance token can name. */
-export type DepProvenanceKind = "ref" | "extends" | "formula" | "action" | "view" | "report" | "print" | "role";
-/**
- * A usage token of the form `<kind>:<symbol>` — e.g. `ref:invoice.customer`,
- * `extends:party`, `action:check_credit`, `role:fin.admin`. Names the consuming
- * symbol so the completeness lint can reconcile declared vs actual usage. Note:
- * `display` is intentionally not a kind — the label is the provider's concern.
- */
-export type DepProvenance = `${DepProvenanceKind}:${string}`;
-/** A single consumed provider column. */
-export interface DepColumn {
-    /** Storage class — the provider column's physical Postgres type, params stripped (`int8`, `varchar`, `numeric`, …). */
-    type: DepColumnType;
-    /** Per-column provenance: which symbols read/write/join on this column. */
-    use: DepProvenance[];
-    /** `write` implies an insert/update right + settable column. Default `read`; omit for reads. */
-    mode?: DepColumnMode;
-}
-/** What the consumer needs from one provider entity. */
-export interface DepEntity {
-    /** The provider entity's PK column — the anchor every reference joins on. No label/display. */
-    pk: string;
-    /** Entity-level provenance: why this entity is consumed (ref/extends/role/view/report/print/action). */
-    use: DepProvenance[];
-    /** Provider columns actually read/written/joined. Omit for extension-only targets. */
-    columns?: Record<string, DepColumn>;
-}
-/** A `deps/<provider>.json` file: the consumer's contract against one dependency. */
-export interface DepsFile {
-    /** Code of the dependency (provider) module this contract is against (e.g. `parties`). */
-    module: string;
-    /** Semver range the consumer requires of the provider (e.g. `>=0.1.0`). */
-    version: string;
-    /** Consumed provider entities, keyed by entity code. */
-    entities: Record<string, DepEntity>;
-}
-//# sourceMappingURL=deps.d.ts.map

package/dist/deps.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"deps.d.ts","sourceRoot":"","sources":["../src/deps.ts"],"names":[],"mappings":"AAQA;;;;;;GAMG;AACH,eAAO,MAAM,gBAAgB,+QAOnB,CAAC;AAEX;;;;;;GAMG;AACH,MAAM,MAAM,aAAa,GAAG,CAAC,OAAO,gBAAgB,CAAC,CAAC,MAAM,CAAC,CAAC;AAE9D,qEAAqE;AACrE,MAAM,MAAM,aAAa,GAAG,MAAM,GAAG,OAAO,CAAC;AAE7C,+DAA+D;AAC/D,MAAM,MAAM,iBAAiB,GAC1B,KAAK,GACL,SAAS,GACT,SAAS,GACT,QAAQ,GACR,MAAM,GACN,QAAQ,GACR,OAAO,GACP,MAAM,CAAC;AAEV;;;;;GAKG;AACH,MAAM,MAAM,aAAa,GAAG,GAAG,iBAAiB,IAAI,MAAM,EAAE,CAAC;AAE7D,yCAAyC;AACzC,MAAM,WAAW,SAAS;IACzB,uHAAuH;IACvH,IAAI,EAAE,aAAa,CAAC;IACpB,2EAA2E;IAC3E,GAAG,EAAE,aAAa,EAAE,CAAC;IACrB,gGAAgG;IAChG,IAAI,CAAC,EAAE,aAAa,CAAC;CACrB;AAED,wDAAwD;AACxD,MAAM,WAAW,SAAS;IACzB,+FAA+F;IAC/F,EAAE,EAAE,MAAM,CAAC;IACX,wGAAwG;IACxG,GAAG,EAAE,aAAa,EAAE,CAAC;IACrB,sFAAsF;IACtF,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;CACpC;AAED,qFAAqF;AACrF,MAAM,WAAW,QAAQ;IACxB,0FAA0F;IAC1F,MAAM,EAAE,MAAM,CAAC;IACf,2EAA2E;IAC3E,OAAO,EAAE,MAAM,CAAC;IAChB,wDAAwD;IACxD,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;CACpC"}

package/dist/deps.js

@@ -1,23 +0,0 @@
-// Dependency contracts — authoring shape of `deps/<provider>.json`. Mirror of deps.schema.json.
-//
-// One file per dependency declares everything a consumer module consumes from a
-// provider: the entities, columns (each pinned to its provider storage class — a
-// Postgres type token like int8/varchar/numeric, not a base datatype), and the
-// provenance of each usage. The provider stays the source of truth; this is the
-// consumer's import list. See docs/modules/dependency-contracts.md.
-/**
- * Allowed storage-class tokens for a consumed column — Postgres type names with
- * length/scale stripped. Closed allowlist, kept in lockstep with the `type` enum in
- * `deps.schema.json` (and `DependencyContractValidator.ValidColumnTypes` on the C#
- * side); the `schemas.test.ts` parity guard fails if this drifts from the schema.
- * Extend all three together if a provider column legitimately uses a type not here.
- */
-export const DEP_COLUMN_TYPES = [
-    "int2", "int4", "int8", "smallint", "integer", "bigint",
-    "numeric", "decimal", "float4", "float8", "real", "money",
-    "varchar", "text", "char", "bpchar",
-    "bool", "boolean",
-    "date", "time", "timetz", "timestamp", "timestamptz",
-    "uuid", "json", "jsonb", "bytea",
-];
-//# sourceMappingURL=deps.js.map

package/dist/deps.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"deps.js","sourceRoot":"","sources":["../src/deps.ts"],"names":[],"mappings":"AAAA,gGAAgG;AAChG,EAAE;AACF,gFAAgF;AAChF,iFAAiF;AACjF,+EAA+E;AAC/E,gFAAgF;AAChF,oEAAoE;AAEpE;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAG;IAC/B,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,SAAS,EAAE,QAAQ;IACvD,SAAS,EAAE,SAAS,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,EAAE,OAAO;IACzD,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,QAAQ;IACnC,MAAM,EAAE,SAAS;IACjB,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,WAAW,EAAE,aAAa;IACpD,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO;CACvB,CAAC"}

package/dist/derive.d.ts

@@ -1,19 +0,0 @@
-/** 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

@@ -1 +0,0 @@
-{"version":3,"file":"derive.d.ts","sourceRoot":"","sources":["../src/derive.ts"],"names":[],"mappings":"AASA,sEAAsE;AACtE,eAAO,MAAM,aAAa,KAAK,CAAC;AAkBhC,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,CA4BhG;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"}