@pylonts/dsl 1.1.1 → 1.1.3

package/src/dsl.ts

@@ -1,183 +1,189 @@
-// DSL field type definitions.
-// Shape: { type: <type name>, <extension fields> }
-
-import type { DictionaryEntry } from './dictionary.js';
-import type { MockDescriptor } from './mock.js';
-
-/** Field query comparison operators (search field semantics). */
-export type Operator = 'eq' | 'gt' | 'gte' | 'lt' | 'lte' | 'like' | 'ne';
-
-export interface SchemaBase {
-  name: string;
-  description?: string;
-}
-
-/** Field collection schemas (DB table vs DTO message); `type` is the discriminator */
-export interface CollectionSchemaBase extends SchemaBase {
-  type: string;
-}
-
-export interface BaseField {
-  name: string;
-  /** 显示名称（中文标签） */
-  label?: string;
-  /** 字段描述 */
-  description?: string;
-  optional?: boolean;
-  readOnly?: boolean;
-  default?: string;
-  /** 所属 schema（db 或 dto） */
-  schema?: CollectionSchemaBase;
-  /** Pure-data mock descriptor for test data generation */
-  mock?: MockDescriptor;
-}
-
-interface StringField extends BaseField {
-  type: 'string';
-  jsType: 'string';
-  minLength?: number;
-  maxLength?: number;
-}
-
-interface TextField extends BaseField {
-  type: 'text';
-  jsType: 'string';
-}
-
-interface IntField extends BaseField {
-  type: 'integer';
-  jsType: 'number';
-  min?: number;
-  max?: number;
-}
-
-interface BigintField extends BaseField {
-  type: 'bigint';
-  jsType: 'string';
-  // Value is transported as string to keep precision beyond 2^53.
-}
-
-interface DecimalField extends BaseField {
-  type: 'decimal';
-  jsType: 'string';
-  precision: number;
-  scale: number;
-  // Value is transported as string to avoid binary float error.
-}
-
-interface BooleanField extends BaseField {
-  type: 'boolean';
-  jsType: 'boolean';
-}
-
-interface DateField extends BaseField {
-  type: 'date';
-  jsType: 'Date';
-}
-
-interface TimeField extends BaseField {
-  type: 'time';
-  jsType: 'string';
-}
-
-interface DateTimeField extends BaseField {
-  type: 'datetime';
-  jsType: 'Date';
-}
-
-export interface EnumValue {
-  value: string | number;
-  symbol: string;
-  label: string;
-}
-
-/** Shared enum definition. Pure value object, safe to reference from multiple fields/tables. */
-export interface EnumDef {
-  /** JS 定义名称，如 MerchantStatus */
-  jsName: string;
-  valueType: 'string' | 'integer';
-  values: EnumValue[];
-}
-
-export function defineEnum(
-  jsName: string,
-  valueType: 'string' | 'integer',
-  values: EnumValue[],
-): EnumDef {
-  return { jsName, valueType, values };
-}
-
-export interface EnumField extends BaseField {
-  type: 'enum';
-  jsType: 'string' | 'number';
-  /** Reference to a shared enum definition (see defineEnum). */
-  enum: EnumDef;
-}
-
-interface JsonField extends BaseField {
-  type: 'json';
-  jsType: 'object';
-}
-
-export type Field =
-  | StringField
-  | TextField
-  | IntField
-  | BigintField
-  | DecimalField
-  | BooleanField
-  | DateField
-  | TimeField
-  | DateTimeField
-  | EnumField
-  | JsonField;
-
-// Field builders: type and jsType are fixed, pass extra properties only.
-// The field name is written back from the map key later (see defineTable).
-
-type FieldExtras<T extends Field> = Omit<T, 'name' | 'type' | 'jsType'>;
-
-export function stringField(extra: FieldExtras<StringField> = {}): StringField {
-  return { name: '', type: 'string', jsType: 'string', ...extra };
-}
-
-export function textField(extra: FieldExtras<TextField> = {}): TextField {
-  return { name: '', type: 'text', jsType: 'string', ...extra };
-}
-
-export function intField(extra: FieldExtras<IntField> = {}): IntField {
-  return { name: '', type: 'integer', jsType: 'number', ...extra };
-}
-
-export function bigintField(extra: FieldExtras<BigintField> = {}): BigintField {
-  return { name: '', type: 'bigint', jsType: 'string', ...extra };
-}
-
-export function decimalField(extra: FieldExtras<DecimalField>): DecimalField {
-  return { name: '', type: 'decimal', jsType: 'string', ...extra };
-}
-
-export function booleanField(extra: FieldExtras<BooleanField> = {}): BooleanField {
-  return { name: '', type: 'boolean', jsType: 'boolean', ...extra };
-}
-
-export function dateField(extra: FieldExtras<DateField> = {}): DateField {
-  return { name: '', type: 'date', jsType: 'Date', ...extra };
-}
-
-export function timeField(extra: FieldExtras<TimeField> = {}): TimeField {
-  return { name: '', type: 'time', jsType: 'string', ...extra };
-}
-
-export function datetimeField(extra: FieldExtras<DateTimeField> = {}): DateTimeField {
-  return { name: '', type: 'datetime', jsType: 'Date', ...extra };
-}
-
-export function jsonField(extra: FieldExtras<JsonField> = {}): JsonField {
-  return { name: '', type: 'json', jsType: 'object', ...extra };
-}
-
-export function enumField(extra: Omit<EnumField, 'name' | 'type' | 'jsType'>): EnumField {
-  const jsType = extra.enum.valueType === 'integer' ? 'number' : 'string';
-  return { name: '', type: 'enum', jsType, ...extra };
+// DSL field type definitions.
+// Shape: { type: <type name>, <extension fields> }
+
+import type { DictionaryEntry } from './dictionary.js';
+import type { ImportBase } from './import-base.js';
+import type { MockDescriptor } from './mock.js';
+
+/** Field query comparison operators (search field semantics). */
+export type Operator = 'eq' | 'gt' | 'gte' | 'lt' | 'lte' | 'like' | 'ne';
+
+export interface SchemaBase {
+  name: string;
+  description?: string;
+}
+
+/** Schema base for cross-file entities. importRef locates the generating module; inline schemas omit it. */
+export interface ImportableSchemaBase extends SchemaBase {
+  importRef?: ImportBase;
+}
+
+/** Field collection schemas (DB table vs DTO message); `type` is the discriminator */
+export interface CollectionSchemaBase extends SchemaBase {
+  type: string;
+}
+
+export interface BaseField {
+  name: string;
+  /** 显示名称（中文标签） */
+  label?: string;
+  /** 字段描述 */
+  description?: string;
+  optional?: boolean;
+  readOnly?: boolean;
+  default?: string;
+  /** 所属 schema（db 或 dto） */
+  schema?: CollectionSchemaBase;
+  /** Pure-data mock descriptor for test data generation */
+  mock?: MockDescriptor;
+}
+
+interface StringField extends BaseField {
+  type: 'string';
+  jsType: 'string';
+  minLength?: number;
+  maxLength?: number;
+}
+
+interface TextField extends BaseField {
+  type: 'text';
+  jsType: 'string';
+}
+
+interface IntField extends BaseField {
+  type: 'integer';
+  jsType: 'number';
+  min?: number;
+  max?: number;
+}
+
+interface BigintField extends BaseField {
+  type: 'bigint';
+  jsType: 'string';
+  // Value is transported as string to keep precision beyond 2^53.
+}
+
+interface DecimalField extends BaseField {
+  type: 'decimal';
+  jsType: 'string';
+  precision: number;
+  scale: number;
+  // Value is transported as string to avoid binary float error.
+}
+
+interface BooleanField extends BaseField {
+  type: 'boolean';
+  jsType: 'boolean';
+}
+
+interface DateField extends BaseField {
+  type: 'date';
+  jsType: 'Date';
+}
+
+interface TimeField extends BaseField {
+  type: 'time';
+  jsType: 'string';
+}
+
+interface DateTimeField extends BaseField {
+  type: 'datetime';
+  jsType: 'Date';
+}
+
+export interface EnumValue {
+  value: string | number;
+  symbol: string;
+  label: string;
+}
+
+/** Shared enum definition. Pure value object, safe to reference from multiple fields/tables. */
+export interface EnumDef {
+  /** JS 定义名称，如 MerchantStatus */
+  jsName: string;
+  valueType: 'string' | 'integer';
+  values: EnumValue[];
+}
+
+export function defineEnum(
+  jsName: string,
+  valueType: 'string' | 'integer',
+  values: EnumValue[],
+): EnumDef {
+  return { jsName, valueType, values };
+}
+
+export interface EnumField extends BaseField {
+  type: 'enum';
+  jsType: 'string' | 'number';
+  /** Reference to a shared enum definition (see defineEnum). */
+  enum: EnumDef;
+}
+
+interface JsonField extends BaseField {
+  type: 'json';
+  jsType: 'object';
+}
+
+export type Field =
+  | StringField
+  | TextField
+  | IntField
+  | BigintField
+  | DecimalField
+  | BooleanField
+  | DateField
+  | TimeField
+  | DateTimeField
+  | EnumField
+  | JsonField;
+
+// Field builders: type and jsType are fixed, pass extra properties only.
+// The field name is written back from the map key later (see defineTable).
+
+type FieldExtras<T extends Field> = Omit<T, 'name' | 'type' | 'jsType'>;
+
+export function stringField(extra: FieldExtras<StringField> = {}): StringField {
+  return { name: '', type: 'string', jsType: 'string', ...extra };
+}
+
+export function textField(extra: FieldExtras<TextField> = {}): TextField {
+  return { name: '', type: 'text', jsType: 'string', ...extra };
+}
+
+export function intField(extra: FieldExtras<IntField> = {}): IntField {
+  return { name: '', type: 'integer', jsType: 'number', ...extra };
+}
+
+export function bigintField(extra: FieldExtras<BigintField> = {}): BigintField {
+  return { name: '', type: 'bigint', jsType: 'string', ...extra };
+}
+
+export function decimalField(extra: FieldExtras<DecimalField>): DecimalField {
+  return { name: '', type: 'decimal', jsType: 'string', ...extra };
+}
+
+export function booleanField(extra: FieldExtras<BooleanField> = {}): BooleanField {
+  return { name: '', type: 'boolean', jsType: 'boolean', ...extra };
+}
+
+export function dateField(extra: FieldExtras<DateField> = {}): DateField {
+  return { name: '', type: 'date', jsType: 'Date', ...extra };
+}
+
+export function timeField(extra: FieldExtras<TimeField> = {}): TimeField {
+  return { name: '', type: 'time', jsType: 'string', ...extra };
+}
+
+export function datetimeField(extra: FieldExtras<DateTimeField> = {}): DateTimeField {
+  return { name: '', type: 'datetime', jsType: 'Date', ...extra };
+}
+
+export function jsonField(extra: FieldExtras<JsonField> = {}): JsonField {
+  return { name: '', type: 'json', jsType: 'object', ...extra };
+}
+
+export function enumField(extra: Omit<EnumField, 'name' | 'type' | 'jsType'>): EnumField {
+  const jsType = extra.enum.valueType === 'integer' ? 'number' : 'string';
+  return { name: '', type: 'enum', jsType, ...extra };
 }