@weave-kit/engine 0.1.0

package/dist/core/types/errors.d.ts

@@ -0,0 +1,21 @@
+import type { Locale, MessageKey } from '../i18n/index.js';
+/**
+ * Localized validation error.
+ *
+ * Carries a message catalog key + interpolation params + the locale used to
+ * render `message`. Keep `code`/`params` so callers can re-render the message
+ * in another locale (see {@link localize}) — e.g. log in English, respond in
+ * the request's language.
+ */
+export declare class SchemaError extends Error {
+    /** message catalog key (see core/i18n/en.ts) */
+    readonly code: MessageKey;
+    /** interpolation params used to render the message */
+    readonly params: Record<string, unknown>;
+    /** locale the message was rendered with */
+    readonly locale: Locale;
+    constructor(code: MessageKey, params?: Record<string, unknown>, locale?: Locale);
+    /** re-resolve the message in another locale without losing code/params */
+    localize(locale: Locale): string;
+}
+//# sourceMappingURL=errors.d.ts.map

package/dist/core/types/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../../src/core/types/errors.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAE3D;;;;;;;GAOG;AACH,qBAAa,WAAY,SAAQ,KAAK;IACpC,gDAAgD;IAChD,QAAQ,CAAC,IAAI,EAAE,UAAU,CAAC;IAC1B,sDAAsD;IACtD,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACzC,2CAA2C;IAC3C,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;gBAEZ,IAAI,EAAE,UAAU,EAAE,MAAM,GAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAM,EAAE,MAAM,GAAE,MAAuB;IAQnG,0EAA0E;IAC1E,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM;CAGjC"}

package/dist/core/types/errors.js

@@ -0,0 +1,29 @@
+import { translate, DEFAULT_LOCALE } from '../i18n/index.js';
+/**
+ * Localized validation error.
+ *
+ * Carries a message catalog key + interpolation params + the locale used to
+ * render `message`. Keep `code`/`params` so callers can re-render the message
+ * in another locale (see {@link localize}) — e.g. log in English, respond in
+ * the request's language.
+ */
+export class SchemaError extends Error {
+    /** message catalog key (see core/i18n/en.ts) */
+    code;
+    /** interpolation params used to render the message */
+    params;
+    /** locale the message was rendered with */
+    locale;
+    constructor(code, params = {}, locale = DEFAULT_LOCALE) {
+        super(translate(code, params, locale));
+        this.name = 'SchemaError';
+        this.code = code;
+        this.params = params;
+        this.locale = locale;
+    }
+    /** re-resolve the message in another locale without losing code/params */
+    localize(locale) {
+        return translate(this.code, this.params, locale);
+    }
+}
+//# sourceMappingURL=errors.js.map

package/dist/core/types/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../../src/core/types/errors.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAG7D;;;;;;;GAOG;AACH,MAAM,OAAO,WAAY,SAAQ,KAAK;IACpC,gDAAgD;IACvC,IAAI,CAAa;IAC1B,sDAAsD;IAC7C,MAAM,CAA0B;IACzC,2CAA2C;IAClC,MAAM,CAAS;IAExB,YAAY,IAAgB,EAAE,SAAkC,EAAE,EAAE,SAAiB,cAAc;QACjG,KAAK,CAAC,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;QACvC,IAAI,CAAC,IAAI,GAAG,aAAa,CAAC;QAC1B,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QACrB,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;IACvB,CAAC;IAED,0EAA0E;IAC1E,QAAQ,CAAC,MAAc;QACrB,OAAO,SAAS,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACnD,CAAC;CACF"}

package/dist/core/types/fields.d.ts

@@ -0,0 +1,182 @@
+import type { FIELD_TYPES, FieldType, OnDeleteAction, SequenceCycle } from './values.js';
+export type { ScalarFieldType, FieldType, OnDeleteAction, SequenceCycle } from './values.js';
+export interface FieldBase {
+    name: string;
+    type: FieldType;
+    /** default display name (English/fallback); see `labels` for per-locale names */
+    label?: string;
+    /** per-locale display names, e.g. { zh: 'label-zh', en: 'Customer' } */
+    labels?: Record<string, string>;
+    /** free-text description surfaced via describe_object */
+    description?: string;
+    /** declares this field as the new-table primary key (exactly one per new object) */
+    primary?: boolean;
+    /** user-declared system-reserved field marker (engine protects values/schema ops) */
+    system?: boolean;
+    /** row-level ownership marker (RBAC read=own); string fields only, at most one per object */
+    ownership?: boolean;
+    /** row-level team marker (RBAC read=team); string fields only, at most one per object */
+    team?: boolean;
+    /**
+     * secret field: masked (omitted) from every REST read response — written
+     * normally (create/update), never read back over REST. The data-access layer
+     * still returns it to server-side consumers (e.g. the proxy resolver), so
+     * secrets never reach the browser.
+     */
+    sensitive?: boolean;
+}
+export interface StringField extends FieldBase {
+    type: typeof FIELD_TYPES.STRING;
+    minLength?: number;
+    maxLength?: number;
+    regex?: string;
+    required?: boolean;
+    unique?: boolean;
+    default?: string;
+    /** computed field expression */
+    formula?: string;
+}
+export interface TextField extends FieldBase {
+    type: typeof FIELD_TYPES.TEXT;
+    maxLength?: number;
+    required?: boolean;
+    unique?: boolean;
+    default?: string;
+    formula?: string;
+}
+export interface IntegerField extends FieldBase {
+    type: typeof FIELD_TYPES.INTEGER;
+    min?: number;
+    max?: number;
+    required?: boolean;
+    unique?: boolean;
+    default?: number;
+    formula?: string;
+}
+export interface NumberField extends FieldBase {
+    type: typeof FIELD_TYPES.NUMBER;
+    min?: number;
+    max?: number;
+    precision?: number;
+    required?: boolean;
+    unique?: boolean;
+    default?: number;
+    formula?: string;
+}
+export interface CurrencyField extends FieldBase {
+    type: typeof FIELD_TYPES.CURRENCY;
+    min?: number;
+    max?: number;
+    required?: boolean;
+    unique?: boolean;
+    default?: number;
+    formula?: string;
+}
+export interface BooleanField extends FieldBase {
+    type: typeof FIELD_TYPES.BOOLEAN;
+    required?: boolean;
+    unique?: boolean;
+    default?: boolean;
+    formula?: string;
+}
+export interface DateTimeField extends FieldBase {
+    type: typeof FIELD_TYPES.DATETIME;
+    required?: boolean;
+    unique?: boolean;
+    default?: string;
+}
+export interface DateField extends FieldBase {
+    type: typeof FIELD_TYPES.DATE;
+    required?: boolean;
+    unique?: boolean;
+    default?: string;
+}
+export interface JsonField extends FieldBase {
+    type: typeof FIELD_TYPES.JSON;
+    required?: boolean;
+    default?: unknown;
+}
+export interface EnumField extends FieldBase {
+    type: typeof FIELD_TYPES.ENUM;
+    options: string[];
+    multiple?: boolean;
+    required?: boolean;
+    unique?: boolean;
+    default?: string | string[];
+}
+export interface RelationField extends FieldBase {
+    type: typeof FIELD_TYPES.RELATION;
+    target: string;
+    required?: boolean;
+    unique?: boolean;
+    onDelete?: OnDeleteAction;
+}
+export interface DetailsField extends FieldBase {
+    type: typeof FIELD_TYPES.DETAILS;
+    target: string;
+}
+export interface MultiRelationField extends FieldBase {
+    type: typeof FIELD_TYPES.MULTI_RELATION;
+    target: string;
+    required?: boolean;
+}
+export interface SeqNoField extends FieldBase {
+    type: typeof FIELD_TYPES.SEQ_NO;
+    format?: string;
+    cycle?: SequenceCycle;
+}
+/** string subtype (person names + contact); inherits `string` column + validation */
+export interface NameFieldBase extends FieldBase {
+    minLength?: number;
+    maxLength?: number;
+    regex?: string;
+    required?: boolean;
+    unique?: boolean;
+    default?: string;
+    formula?: string;
+}
+export interface FirstNameField extends NameFieldBase {
+    type: typeof FIELD_TYPES.FIRST_NAME;
+}
+export interface LastNameField extends NameFieldBase {
+    type: typeof FIELD_TYPES.LAST_NAME;
+}
+export interface EmailField extends NameFieldBase {
+    type: typeof FIELD_TYPES.EMAIL;
+}
+export interface PhoneField extends NameFieldBase {
+    type: typeof FIELD_TYPES.PHONE;
+}
+/** media field (image/asset); maps to a URL/file column, single or multi */
+export interface ImageField extends FieldBase {
+    type: typeof FIELD_TYPES.IMAGE;
+    required?: boolean;
+    unique?: boolean;
+    /** multi-value (TEXT[]): an array of URLs */
+    multiple?: boolean;
+    default?: string | string[];
+}
+/** identity FK to the internal 通讯录/人员 object (relation-like, mirrors RelationField) */
+export interface PersonField extends FieldBase {
+    type: typeof FIELD_TYPES.PERSON;
+    target: string;
+    required?: boolean;
+    unique?: boolean;
+    onDelete?: OnDeleteAction;
+    /**
+     * the department FK field name on the *person target* object (e.g. `dept_id`).
+     * Lets the resolve layer pull the person's department (department icon + name).
+     */
+    department?: string;
+}
+/** identity FK to the internal 部门/组织 object (relation-like, mirrors RelationField) */
+export interface DepartmentField extends FieldBase {
+    type: typeof FIELD_TYPES.DEPARTMENT;
+    target: string;
+    required?: boolean;
+    unique?: boolean;
+    onDelete?: OnDeleteAction;
+}
+/** discriminated union of every field shape; each member is keyed by its literal `type` */
+export type FieldDefinition = StringField | TextField | IntegerField | NumberField | CurrencyField | BooleanField | DateTimeField | DateField | JsonField | EnumField | RelationField | DetailsField | MultiRelationField | SeqNoField | FirstNameField | LastNameField | EmailField | PhoneField | ImageField | PersonField | DepartmentField;
+//# sourceMappingURL=fields.d.ts.map

package/dist/core/types/fields.d.ts.map

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

package/dist/core/types/fields.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=fields.js.map

package/dist/core/types/fields.js.map

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

package/dist/core/types/index.d.ts

@@ -0,0 +1,12 @@
+export type { ScalarFieldType, FieldType, OnDeleteAction } from './fields.js';
+export type { FieldBase, StringField, TextField, IntegerField, NumberField, CurrencyField, BooleanField, DateTimeField, DateField, JsonField, EnumField, RelationField, DetailsField, MultiRelationField, SeqNoField, FieldDefinition, } from './fields.js';
+export type { ReadScope, PermissionDefinition, Permissions } from './permission.js';
+export type { BelongsToEdge, HasManyEdge, MultiRelationEdge, RelationEdge, } from './relation.js';
+export type { IndexDefinition, ObjectDefinition } from './object.js';
+export type { IndexType, SequenceCycle, SequenceToken, DetailsColumn, RelationKind, RowScopeMarker } from './values.js';
+export { DETAILS_COLUMNS, FIELD_TYPES, READ_SCOPES, RELATION_KINDS, ROW_SCOPE_MARKERS } from './values.js';
+export { primaryFieldOf, primaryKeyOf } from './primaryField.js';
+export { SchemaError } from './errors.js';
+export { describeFieldType, fieldBase, fieldUiVisual, isRelationLike, isScalarFieldType, PRIMITIVE_FIELD_TYPES, SEMANTIC_FIELD_TYPES, } from './registry.js';
+export type { FieldTypeDescriptor, FieldTypeUiHints } from './registry.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/core/types/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/core/types/index.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,eAAe,EAAE,SAAS,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAC9E,YAAY,EACV,SAAS,EACT,WAAW,EACX,SAAS,EACT,YAAY,EACZ,WAAW,EACX,aAAa,EACb,YAAY,EACZ,aAAa,EACb,SAAS,EACT,SAAS,EACT,SAAS,EACT,aAAa,EACb,YAAY,EACZ,kBAAkB,EAClB,UAAU,EACV,eAAe,GAChB,MAAM,aAAa,CAAC;AACrB,YAAY,EAAE,SAAS,EAAE,oBAAoB,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AACpF,YAAY,EACV,aAAa,EACb,WAAW,EACX,iBAAiB,EACjB,YAAY,GACb,MAAM,eAAe,CAAC;AACvB,YAAY,EAAE,eAAe,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AACrE,YAAY,EAAE,SAAS,EAAE,aAAa,EAAE,aAAa,EAAE,aAAa,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AACxH,OAAO,EAAE,eAAe,EAAE,WAAW,EAAE,WAAW,EAAE,cAAc,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAC3G,OAAO,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACjE,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAE1C,OAAO,EACL,iBAAiB,EACjB,SAAS,EACT,aAAa,EACb,cAAc,EACd,iBAAiB,EACjB,qBAAqB,EACrB,oBAAoB,GACrB,MAAM,eAAe,CAAC;AACvB,YAAY,EAAE,mBAAmB,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC"}

package/dist/core/types/index.js

@@ -0,0 +1,5 @@
+export { DETAILS_COLUMNS, FIELD_TYPES, READ_SCOPES, RELATION_KINDS, ROW_SCOPE_MARKERS } from './values.js';
+export { primaryFieldOf, primaryKeyOf } from './primaryField.js';
+export { SchemaError } from './errors.js';
+export { describeFieldType, fieldBase, fieldUiVisual, isRelationLike, isScalarFieldType, PRIMITIVE_FIELD_TYPES, SEMANTIC_FIELD_TYPES, } from './registry.js';
+//# sourceMappingURL=index.js.map

package/dist/core/types/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/core/types/index.ts"],"names":[],"mappings":"AA4BA,OAAO,EAAE,eAAe,EAAE,WAAW,EAAE,WAAW,EAAE,cAAc,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAC3G,OAAO,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACjE,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAE1C,OAAO,EACL,iBAAiB,EACjB,SAAS,EACT,aAAa,EACb,cAAc,EACd,iBAAiB,EACjB,qBAAqB,EACrB,oBAAoB,GACrB,MAAM,eAAe,CAAC"}

package/dist/core/types/object.d.ts

@@ -0,0 +1,36 @@
+import type { FieldDefinition } from './fields.js';
+import type { Permissions } from './permission.js';
+import type { IndexType } from './values.js';
+/** a user-declared extra index */
+export interface IndexDefinition {
+    type: IndexType;
+    fields: string[];
+}
+/** a validated object definition (the engine's core metadata unit) */
+export interface ObjectDefinition {
+    /**
+     * on-disk `schema.json` format version (see `core/object/schema-version.ts`).
+     * Absent on legacy unversioned files; `weave schema:upgrade` stamps it.
+     */
+    schemaVersion?: number;
+    name: string;
+    label?: string;
+    /** per-locale display names, e.g. { zh: '客户', en: 'Customer' } */
+    labels?: Record<string, string>;
+    description?: string;
+    fields: FieldDefinition[];
+    permissions?: Permissions;
+    workflow?: unknown;
+    indexes?: IndexDefinition[];
+    /** composite title template, e.g. "{doc_no} {customer_name}" */
+    titleTemplate?: string;
+    /**
+     * opt-in additive auto-DDL for this object's existing table (default false).
+     * When true, `weave migrate` and `weave dev` reload emit ADD COLUMN /
+     * CONSTRAINT / FK / INDEX for schema changes on an existing table. When
+     * false (default) an existing table is read-only — a declared field missing
+     * a column fails the sync (fail-fast, protects user-owned tables).
+     */
+    alter?: boolean;
+}
+//# sourceMappingURL=object.d.ts.map

package/dist/core/types/object.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"object.d.ts","sourceRoot":"","sources":["../../../src/core/types/object.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AACnD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AACnD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAE7C,kCAAkC;AAClC,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,SAAS,CAAC;IAChB,MAAM,EAAE,MAAM,EAAE,CAAC;CAClB;AAED,sEAAsE;AACtE,MAAM,WAAW,gBAAgB;IAC/B;;;OAGG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,kEAAkE;IAClE,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAChC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,MAAM,EAAE,eAAe,EAAE,CAAC;IAC1B,WAAW,CAAC,EAAE,WAAW,CAAC;IAC1B,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,OAAO,CAAC,EAAE,eAAe,EAAE,CAAC;IAC5B,gEAAgE;IAChE,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB;;;;;;OAMG;IACH,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB"}

package/dist/core/types/object.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=object.js.map

package/dist/core/types/object.js.map

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

package/dist/core/types/permission.d.ts

@@ -0,0 +1,22 @@
+import type { ReadScope } from './values.js';
+export type { ReadScope } from './values.js';
+/** per-role permissions for one object (roles come from the user system) */
+export interface PermissionDefinition {
+    read?: ReadScope;
+    create?: boolean;
+    /** true = all fields updatable; string[] = whitelist; false/undefined = none (fail-closed) */
+    update?: boolean | string[];
+    delete?: boolean;
+    fields?: {
+        /** fields hidden from read output (and never surfaced to the identity's MCP tools) */
+        exclude?: string[];
+        /**
+         * optional create field whitelist: the only fields this role may write on
+         * create. Undefined = unrestricted (backward compatible); [] = none;
+         * otherwise the whitelist. Required fields must be listed (schema-validated).
+         */
+        create?: string[];
+    };
+}
+export type Permissions = Record<string, PermissionDefinition>;
+//# sourceMappingURL=permission.d.ts.map

package/dist/core/types/permission.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"permission.d.ts","sourceRoot":"","sources":["../../../src/core/types/permission.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAE7C,YAAY,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAE7C,4EAA4E;AAC5E,MAAM,WAAW,oBAAoB;IACnC,IAAI,CAAC,EAAE,SAAS,CAAC;IACjB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,8FAA8F;IAC9F,MAAM,CAAC,EAAE,OAAO,GAAG,MAAM,EAAE,CAAC;IAC5B,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,MAAM,CAAC,EAAE;QACP,sFAAsF;QACtF,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;QACnB;;;;WAIG;QACH,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;KACnB,CAAC;CACH;AAED,MAAM,MAAM,WAAW,GAAG,MAAM,CAAC,MAAM,EAAE,oBAAoB,CAAC,CAAC"}

package/dist/core/types/permission.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=permission.js.map

package/dist/core/types/permission.js.map

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

package/dist/core/types/primaryField.d.ts

@@ -0,0 +1,15 @@
+import type { FieldDefinition } from './fields.js';
+import type { ObjectDefinition } from './object.js';
+/**
+ * Primary-key helpers — the single derivation point for "which field is the
+ * primary key". The schema's `primary: true` flag on a field is the only truth
+ * source; `ObjectDefinition.primaryKey` was a redundant derived cache and is
+ * gone. Every consumer (migration / data-access / gen-types / MCP) reads the
+ * primary field through these functions, so a validated object always carries
+ * exactly one primary scalar field (new and existing tables alike).
+ */
+/** primary field of an object — the field carrying `primary: true` */
+export declare function primaryFieldOf(def: ObjectDefinition | undefined): FieldDefinition | undefined;
+/** name of the primary field; undefined when the object has no primary declaration */
+export declare function primaryKeyOf(def: ObjectDefinition | undefined): string | undefined;
+//# sourceMappingURL=primaryField.d.ts.map

package/dist/core/types/primaryField.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"primaryField.d.ts","sourceRoot":"","sources":["../../../src/core/types/primaryField.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AACnD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAEpD;;;;;;;GAOG;AAEH,sEAAsE;AACtE,wBAAgB,cAAc,CAAC,GAAG,EAAE,gBAAgB,GAAG,SAAS,GAAG,eAAe,GAAG,SAAS,CAE7F;AAED,sFAAsF;AACtF,wBAAgB,YAAY,CAAC,GAAG,EAAE,gBAAgB,GAAG,SAAS,GAAG,MAAM,GAAG,SAAS,CAElF"}

package/dist/core/types/primaryField.js

@@ -0,0 +1,17 @@
+/**
+ * Primary-key helpers — the single derivation point for "which field is the
+ * primary key". The schema's `primary: true` flag on a field is the only truth
+ * source; `ObjectDefinition.primaryKey` was a redundant derived cache and is
+ * gone. Every consumer (migration / data-access / gen-types / MCP) reads the
+ * primary field through these functions, so a validated object always carries
+ * exactly one primary scalar field (new and existing tables alike).
+ */
+/** primary field of an object — the field carrying `primary: true` */
+export function primaryFieldOf(def) {
+    return def === undefined ? undefined : def.fields.find((f) => f.primary === true);
+}
+/** name of the primary field; undefined when the object has no primary declaration */
+export function primaryKeyOf(def) {
+    return primaryFieldOf(def)?.name;
+}
+//# sourceMappingURL=primaryField.js.map

package/dist/core/types/primaryField.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"primaryField.js","sourceRoot":"","sources":["../../../src/core/types/primaryField.ts"],"names":[],"mappings":"AAGA;;;;;;;GAOG;AAEH,sEAAsE;AACtE,MAAM,UAAU,cAAc,CAAC,GAAiC;IAC9D,OAAO,GAAG,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,KAAK,IAAI,CAAC,CAAC;AACpF,CAAC;AAED,sFAAsF;AACtF,MAAM,UAAU,YAAY,CAAC,GAAiC;IAC5D,OAAO,cAAc,CAAC,GAAG,CAAC,EAAE,IAAI,CAAC;AACnC,CAAC"}

package/dist/core/types/registry.d.ts

@@ -0,0 +1,39 @@
+import { type FieldType } from './values.js';
+/**
+ * Field-type registry — the single source for the engine's field-type
+ * descriptors. Primitive types (scalar + relation + sequence) carry `base:
+ * undefined`; semantic types (string subtypes, media, identity FKs) carry a
+ * `base` they fully inherit (storage/describe/gen-types/MCP behavior), plus a
+ * small `ui` hints block consumed by `@weave-kit/ui`. Schema-level gating lives
+ * in the config `features.fieldTypes` whitelist (see validate.ts), NOT here.
+ */
+export interface FieldTypeUiHints {
+    /** leading visual kind rendered in list/show (avatar / building icon / none) */
+    visual?: 'avatar' | 'icon' | 'image' | 'none';
+}
+export interface FieldTypeDescriptor {
+    name: FieldType;
+    /** the inherited field type; `undefined` = engine primitive. */
+    base?: FieldType;
+    /** scalar (can be a primary key). */
+    scalar?: boolean;
+    /** relation-like (target via FK). */
+    relationLike?: boolean;
+    /** frontend hints (consumed by @weave-kit/ui). */
+    ui?: FieldTypeUiHints;
+}
+/** the base primitive a type inherits (walks one level). */
+export declare function fieldBase(type: FieldType): FieldType;
+/** true for a relation-like field (target-by-FK). */
+export declare function isRelationLike(type: FieldType): boolean;
+/** true for a field type that can be a primary key. */
+export declare function isScalarFieldType(type: FieldType): boolean;
+/** the frontend visual hint for a type (single source). */
+export declare function fieldUiVisual(type: FieldType): FieldTypeUiHints['visual'];
+/** a descriptor (or undefined for an unknown type). */
+export declare function describeFieldType(type: FieldType): FieldTypeDescriptor | undefined;
+/** engine primitives — always allowed by the default whitelist. */
+export declare const PRIMITIVE_FIELD_TYPES: readonly FieldType[];
+/** semantic types that are gated by the config `features.fieldTypes` whitelist. */
+export declare const SEMANTIC_FIELD_TYPES: readonly FieldType[];
+//# sourceMappingURL=registry.d.ts.map

package/dist/core/types/registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../../src/core/types/registry.ts"],"names":[],"mappings":"AAAA,OAAO,EAAmC,KAAK,SAAS,EAAE,MAAM,aAAa,CAAC;AAE9E;;;;;;;GAOG;AAEH,MAAM,WAAW,gBAAgB;IAC/B,gFAAgF;IAChF,MAAM,CAAC,EAAE,QAAQ,GAAG,MAAM,GAAG,OAAO,GAAG,MAAM,CAAC;CAC/C;AAED,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,SAAS,CAAC;IAChB,gEAAgE;IAChE,IAAI,CAAC,EAAE,SAAS,CAAC;IACjB,qCAAqC;IACrC,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,qCAAqC;IACrC,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,kDAAkD;IAClD,EAAE,CAAC,EAAE,gBAAgB,CAAC;CACvB;AAiCD,4DAA4D;AAC5D,wBAAgB,SAAS,CAAC,IAAI,EAAE,SAAS,GAAG,SAAS,CAGpD;AAED,qDAAqD;AACrD,wBAAgB,cAAc,CAAC,IAAI,EAAE,SAAS,GAAG,OAAO,CAEvD;AAED,uDAAuD;AACvD,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,SAAS,GAAG,OAAO,CAG1D;AAED,2DAA2D;AAC3D,wBAAgB,aAAa,CAAC,IAAI,EAAE,SAAS,GAAG,gBAAgB,CAAC,QAAQ,CAAC,CAEzE;AAED,uDAAuD;AACvD,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,SAAS,GAAG,mBAAmB,GAAG,SAAS,CAElF;AAED,mEAAmE;AACnE,eAAO,MAAM,qBAAqB,EAAE,SAAS,SAAS,EAerD,CAAC;AAEF,mFAAmF;AACnF,eAAO,MAAM,oBAAoB,EAAE,SAAS,SAAS,EAQpD,CAAC"}

package/dist/core/types/registry.js

@@ -0,0 +1,78 @@
+import { FIELD_TYPES, SCALAR_FIELD_TYPES } from './values.js';
+const registry = new Map();
+function define(descriptor) {
+    registry.set(descriptor.name, descriptor);
+}
+// ---- primitives ----
+define({ name: FIELD_TYPES.STRING, scalar: true });
+define({ name: FIELD_TYPES.TEXT, scalar: true });
+define({ name: FIELD_TYPES.INTEGER, scalar: true });
+define({ name: FIELD_TYPES.NUMBER, scalar: true });
+define({ name: FIELD_TYPES.CURRENCY, scalar: true });
+define({ name: FIELD_TYPES.BOOLEAN, scalar: true });
+define({ name: FIELD_TYPES.DATETIME, scalar: true });
+define({ name: FIELD_TYPES.DATE, scalar: true });
+define({ name: FIELD_TYPES.JSON, scalar: true });
+define({ name: FIELD_TYPES.ENUM, scalar: true });
+define({ name: FIELD_TYPES.RELATION, relationLike: true });
+define({ name: FIELD_TYPES.DETAILS, relationLike: true });
+define({ name: FIELD_TYPES.MULTI_RELATION, relationLike: true });
+define({ name: FIELD_TYPES.SEQ_NO });
+// ---- semantic types (base delegation + ui hints) ----
+define({ name: FIELD_TYPES.FIRST_NAME, base: FIELD_TYPES.STRING, scalar: true, ui: { visual: 'none' } });
+define({ name: FIELD_TYPES.LAST_NAME, base: FIELD_TYPES.STRING, scalar: true, ui: { visual: 'none' } });
+define({ name: FIELD_TYPES.EMAIL, base: FIELD_TYPES.STRING, scalar: true, ui: { visual: 'none' } });
+define({ name: FIELD_TYPES.PHONE, base: FIELD_TYPES.STRING, scalar: true, ui: { visual: 'none' } });
+define({ name: FIELD_TYPES.IMAGE, base: FIELD_TYPES.STRING, scalar: true, ui: { visual: 'image' } });
+define({ name: FIELD_TYPES.PERSON, base: FIELD_TYPES.RELATION, relationLike: true, ui: { visual: 'avatar' } });
+define({ name: FIELD_TYPES.DEPARTMENT, base: FIELD_TYPES.RELATION, relationLike: true, ui: { visual: 'icon' } });
+/** the base primitive a type inherits (walks one level). */
+export function fieldBase(type) {
+    const desc = registry.get(type);
+    return desc?.base ?? type;
+}
+/** true for a relation-like field (target-by-FK). */
+export function isRelationLike(type) {
+    return registry.get(type)?.relationLike === true;
+}
+/** true for a field type that can be a primary key. */
+export function isScalarFieldType(type) {
+    const base = fieldBase(type);
+    return base in SCALAR_FIELD_TYPES;
+}
+/** the frontend visual hint for a type (single source). */
+export function fieldUiVisual(type) {
+    return registry.get(type)?.ui?.visual ?? 'none';
+}
+/** a descriptor (or undefined for an unknown type). */
+export function describeFieldType(type) {
+    return registry.get(type);
+}
+/** engine primitives — always allowed by the default whitelist. */
+export const PRIMITIVE_FIELD_TYPES = [
+    FIELD_TYPES.STRING,
+    FIELD_TYPES.TEXT,
+    FIELD_TYPES.INTEGER,
+    FIELD_TYPES.NUMBER,
+    FIELD_TYPES.CURRENCY,
+    FIELD_TYPES.BOOLEAN,
+    FIELD_TYPES.DATETIME,
+    FIELD_TYPES.DATE,
+    FIELD_TYPES.JSON,
+    FIELD_TYPES.ENUM,
+    FIELD_TYPES.RELATION,
+    FIELD_TYPES.DETAILS,
+    FIELD_TYPES.MULTI_RELATION,
+    FIELD_TYPES.SEQ_NO,
+];
+/** semantic types that are gated by the config `features.fieldTypes` whitelist. */
+export const SEMANTIC_FIELD_TYPES = [
+    FIELD_TYPES.FIRST_NAME,
+    FIELD_TYPES.LAST_NAME,
+    FIELD_TYPES.EMAIL,
+    FIELD_TYPES.PHONE,
+    FIELD_TYPES.IMAGE,
+    FIELD_TYPES.PERSON,
+    FIELD_TYPES.DEPARTMENT,
+];
+//# sourceMappingURL=registry.js.map

package/dist/core/types/registry.js.map

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

package/dist/core/types/relation.d.ts

@@ -0,0 +1,41 @@
+import type { OnDeleteAction } from './fields.js';
+import type { RELATION_KINDS } from './values.js';
+export interface BelongsToEdge {
+    kind: typeof RELATION_KINDS.BELONGS_TO;
+    /** source object that holds the FK column */
+    object: string;
+    /** destination object the FK points to */
+    target: string;
+    /** column on `object` holding the FK value */
+    foreignKey: string;
+    required?: boolean;
+    onDelete?: OnDeleteAction;
+    /** true when derived from a `details` field (child→parent via parent_id) */
+    details?: boolean;
+}
+export interface HasManyEdge {
+    kind: typeof RELATION_KINDS.HAS_MANY;
+    /** source object (the "one" side) */
+    object: string;
+    /** child object */
+    target: string;
+    /** column on `target` holding the FK back to `object` */
+    foreignKey: string;
+    /** true for master-detail (parent_id/parent_type/parent_idx mechanism) */
+    details?: boolean;
+    /** true when the FK column is an array (multiRelation reverse) */
+    array?: boolean;
+}
+export interface MultiRelationEdge {
+    kind: typeof RELATION_KINDS.MULTI_RELATION;
+    /** source object holding the array column (e.g. customer) */
+    object: string;
+    /** referenced object (e.g. contact) */
+    target: string;
+    /** array column on `object` */
+    foreignKey: string;
+    required?: boolean;
+}
+/** union of all normalized relation edges in the relation graph */
+export type RelationEdge = BelongsToEdge | HasManyEdge | MultiRelationEdge;
+//# sourceMappingURL=relation.d.ts.map

package/dist/core/types/relation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"relation.d.ts","sourceRoot":"","sources":["../../../src/core/types/relation.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAClD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAElD,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,OAAO,cAAc,CAAC,UAAU,CAAC;IACvC,6CAA6C;IAC7C,MAAM,EAAE,MAAM,CAAC;IACf,0CAA0C;IAC1C,MAAM,EAAE,MAAM,CAAC;IACf,8CAA8C;IAC9C,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,QAAQ,CAAC,EAAE,cAAc,CAAC;IAC1B,4EAA4E;IAC5E,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,OAAO,cAAc,CAAC,QAAQ,CAAC;IACrC,qCAAqC;IACrC,MAAM,EAAE,MAAM,CAAC;IACf,mBAAmB;IACnB,MAAM,EAAE,MAAM,CAAC;IACf,yDAAyD;IACzD,UAAU,EAAE,MAAM,CAAC;IACnB,0EAA0E;IAC1E,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,kEAAkE;IAClE,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,OAAO,cAAc,CAAC,cAAc,CAAC;IAC3C,6DAA6D;IAC7D,MAAM,EAAE,MAAM,CAAC;IACf,uCAAuC;IACvC,MAAM,EAAE,MAAM,CAAC;IACf,+BAA+B;IAC/B,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED,mEAAmE;AACnE,MAAM,MAAM,YAAY,GAAG,aAAa,GAAG,WAAW,GAAG,iBAAiB,CAAC"}

package/dist/core/types/relation.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=relation.js.map

package/dist/core/types/relation.js.map

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