joist-core 2.3.0 → 2.4.0-next.10

package/build/serde/fieldSerde.cjs

@@ -0,0 +1,188 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const require_keys = require("../keys.cjs");
+const require_utils = require("../utils.cjs");
+const require_configure = require("../configure.cjs");
+const require_EntityMetadata = require("../EntityMetadata.cjs");
+const require_Entity = require("../Entity.cjs");
+//#region src/serde/fieldSerde.ts
+function hasSerde(field) {
+	return !!field.serde;
+}
+/** Binds a physical column to entity data without adding a second codec or storage declaration. */
+var FieldColumn = class {
+	fieldName;
+	column;
+	constructor(fieldName, column) {
+		this.fieldName = fieldName;
+		this.column = column;
+	}
+	get codec() {
+		return this.column.codec;
+	}
+	get insertOptional() {
+		return this.column.insertOptional;
+	}
+	get writable() {
+		return this.column.writable;
+	}
+	get insert() {
+		return this.column.insert;
+	}
+	get update() {
+		return this.column.update;
+	}
+	get idMetadata() {
+		return this.column.idMetadata;
+	}
+	get columnName() {
+		return this.column.columnName;
+	}
+	get dbType() {
+		return this.column.dbType;
+	}
+	get isArray() {
+		return this.column.isArray;
+	}
+	get isNullableArray() {
+		return this.column.isNullableArray;
+	}
+	get sqlNullable() {
+		return this.column.sqlNullable;
+	}
+	get hasDefault() {
+		return this.column.hasDefault;
+	}
+	get isGenerated() {
+		return this.column.isGenerated;
+	}
+	get outputType() {
+		return this.column.outputType;
+	}
+	mapToDb(value) {
+		return this.column.mapToDb(value);
+	}
+	mapToDbValue(value) {
+		return this.column.mapToDbValue(value);
+	}
+	mapFromDb(value) {
+		return this.column.mapFromDb(value);
+	}
+	mapFromJsonAgg(value) {
+		return this.column.mapFromJsonAgg(value);
+	}
+	/** Defers FK writes whose new target must be inserted after this entity. */
+	dbValue(data, entity, tableName, fixups) {
+		const value = data[this.fieldName];
+		if (this.column.idMetadata && fixups && require_Entity.isEntity(value) && value.isNewEntity && require_EntityMetadata.getMetadata(value).nonDeferredFkOrder && require_EntityMetadata.getMetadata(entity).nonDeferredFkOrder && require_EntityMetadata.getMetadata(value).nonDeferredFkOrder >= require_EntityMetadata.getMetadata(entity).nonDeferredFkOrder) {
+			fixups.push({
+				entity,
+				tableName,
+				column: this,
+				value: this.mapToDbValue(require_keys.maybeResolveReferenceToId(value))
+			});
+			return null;
+		}
+		return this.mapToDbValue(value);
+	}
+	/** Reconstruct the driver's row representation, which can differ from write bindings for Date and JSON. */
+	rowValue(data) {
+		return this.column.codec.mapToRow(data[this.fieldName]);
+	}
+};
+/** Binds one entity field to its physical column. */
+var SimpleFieldSerde = class extends FieldColumn {
+	columns = [this];
+	/** Decode this field's physical column without changing entity data. */
+	fromRow(rowData, rowIndex) {
+		return this.column.mapFromDb(rowData.get(rowIndex, this.column.columnName));
+	}
+	mapFromNow(now) {
+		return this.column.codec.mapFromNow(now);
+	}
+};
+/** A polymorphic field selects exactly one component while each physical column retains a scalar ID codec. */
+var PolymorphicKeySerde = class {
+	fieldName;
+	columns;
+	constructor(fieldName, components) {
+		this.fieldName = fieldName;
+		this.columns = components.map((component) => new PolymorphicFieldColumn(fieldName, component, components));
+	}
+	/** Select the first truthy component whose decoded ID is not nullish. */
+	fromRow(rowData, rowIndex) {
+		let decoded;
+		for (const column of this.columns) {
+			const value = rowData.get(rowIndex, column.columnName);
+			if (value) {
+				decoded = column.mapFromDb(value);
+				if (decoded != null) return decoded;
+			}
+		}
+		return decoded;
+	}
+};
+/** Shares domain components between relationship traversal and entity write selection. */
+function polymorphicField(fieldName, required, components) {
+	return {
+		kind: "poly",
+		fieldName,
+		fieldIdName: `${fieldName}Id`,
+		required,
+		components,
+		serde: new PolymorphicKeySerde(fieldName, components),
+		immutable: false
+	};
+}
+/** A domain relationship component references storage and only overrides a specialized domain target. */
+var PolyComponent = class {
+	column;
+	otherFieldName;
+	target;
+	constructor(column, otherFieldName, target) {
+		this.column = column;
+		this.otherFieldName = otherFieldName;
+		this.target = target;
+	}
+	get columnName() {
+		return this.column.columnName;
+	}
+	get otherMetadata() {
+		return this.target ?? this.column.idMetadata;
+	}
+};
+/** Selects a relationship component for entity writes only; direct SQL writes use its scalar column codec. */
+var PolymorphicFieldColumn = class extends FieldColumn {
+	component;
+	components;
+	constructor(fieldName, component, components) {
+		super(fieldName, component.column);
+		this.component = component;
+		this.components = components;
+	}
+	get otherMetadata() {
+		return this.component.otherMetadata;
+	}
+	/** Preserve exact subtype selection when multiple components share a base type. */
+	mapToDbValue(value) {
+		const id = require_keys.maybeResolveReferenceToId(value);
+		const cstr = require_Entity.isEntity(value) ? require_EntityMetadata.getMetadata(value).cstr : id ? require_configure.getConstructorFromTaggedId(id) : void 0;
+		const hasMultipleComponentsWithSameBaseType = [...require_utils.groupBy(this.components, (component) => require_EntityMetadata.getBaseMeta(component.otherMetadata()).type).values()].some((group) => group.length > 1);
+		const otherMeta = this.otherMetadata();
+		return (hasMultipleComponentsWithSameBaseType ? cstr === otherMeta.cstr : cstr === otherMeta.cstr || cstr === require_EntityMetadata.getBaseMeta(otherMeta).cstr || otherMeta.subTypes.some((subTypeMeta) => cstr === subTypeMeta.cstr)) ? this.column.mapToDbValue(id) : void 0;
+	}
+	dbValue(data) {
+		return this.mapToDbValue(data[this.fieldName]);
+	}
+	rowValue(data) {
+		return this.dbValue(data);
+	}
+};
+//#endregion
+exports.FieldColumn = FieldColumn;
+exports.PolyComponent = PolyComponent;
+exports.PolymorphicKeySerde = PolymorphicKeySerde;
+exports.SimpleFieldSerde = SimpleFieldSerde;
+exports.hasSerde = hasSerde;
+exports.polymorphicField = polymorphicField;
+
+//# sourceMappingURL=fieldSerde.cjs.map

package/build/serde/fieldSerde.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"fieldSerde.cjs","names":["isEntity","getMetadata","maybeResolveReferenceToId","getConstructorFromTaggedId","groupBy","getBaseMeta"],"sources":["../../src/serde/fieldSerde.ts"],"sourcesContent":["import { getConstructorFromTaggedId } from \"src/configure.ts\";\nimport type { InsertFixup } from \"src/drivers/EntityWriter.ts\";\nimport { type Entity, isEntity } from \"src/Entity.ts\";\nimport {\n  type EntityMetadata,\n  type Field,\n  type PolymorphicField,\n  type PolymorphicFieldComponent,\n  type SerdeField,\n  getBaseMeta,\n  getMetadata,\n} from \"src/EntityMetadata.ts\";\nimport { maybeResolveReferenceToId } from \"src/keys.ts\";\nimport type { RowData } from \"src/RowData.ts\";\nimport type { Column } from \"src/serde/columns.ts\";\nimport type { TimestampCodec } from \"src/serde/serde.ts\";\nimport { groupBy } from \"src/utils.ts\";\n\nexport function hasSerde(field: Field): field is SerdeField {\n  return !!field.serde;\n}\n\n/** Entity hydration and flush bindings; a polymorphic relationship spans several physical columns. */\nexport interface FieldSerde {\n  columns: FieldColumn[];\n  /** Decode one domain value from accessed cells; callers own entity assignment and caching. */\n  fromRow(rowData: RowData, rowIndex: number): unknown;\n}\n\nexport interface TimestampSerde<T> extends FieldSerde {\n  mapFromNow(now: Date): T;\n  dbValue(data: any): any;\n}\n\n/** Binds a physical column to entity data without adding a second codec or storage declaration. */\nexport class FieldColumn {\n  constructor(\n    readonly fieldName: string,\n    readonly column: Column,\n  ) {}\n  get codec() {\n    return this.column.codec;\n  }\n  get insertOptional() {\n    return this.column.insertOptional;\n  }\n  get writable() {\n    return this.column.writable;\n  }\n  get insert() {\n    return this.column.insert;\n  }\n  get update() {\n    return this.column.update;\n  }\n  get idMetadata() {\n    return this.column.idMetadata;\n  }\n  get columnName(): string {\n    return this.column.columnName;\n  }\n  get dbType(): string {\n    return this.column.dbType;\n  }\n  get isArray(): boolean {\n    return this.column.isArray;\n  }\n  get isNullableArray(): boolean {\n    return this.column.isNullableArray;\n  }\n  get sqlNullable(): boolean {\n    return this.column.sqlNullable;\n  }\n  get hasDefault(): boolean {\n    return this.column.hasDefault;\n  }\n  get isGenerated(): boolean {\n    return this.column.isGenerated;\n  }\n  get outputType() {\n    return this.column.outputType;\n  }\n  mapToDb(value: any): any {\n    return this.column.mapToDb(value);\n  }\n  mapToDbValue(value: unknown): unknown {\n    return this.column.mapToDbValue(value);\n  }\n  mapFromDb(value: unknown): unknown {\n    return this.column.mapFromDb(value);\n  }\n  mapFromJsonAgg(value: any): any {\n    return this.column.mapFromJsonAgg(value);\n  }\n\n  /** Defers FK writes whose new target must be inserted after this entity. */\n  dbValue(data: any, entity: Entity, tableName: string, fixups: InsertFixup[] | undefined): any {\n    const value = data[this.fieldName];\n    if (\n      this.column.idMetadata &&\n      fixups &&\n      isEntity(value) &&\n      value.isNewEntity &&\n      getMetadata(value).nonDeferredFkOrder &&\n      getMetadata(entity).nonDeferredFkOrder &&\n      getMetadata(value).nonDeferredFkOrder! >= getMetadata(entity).nonDeferredFkOrder!\n    ) {\n      fixups.push({ entity, tableName, column: this, value: this.mapToDbValue(maybeResolveReferenceToId(value)) });\n      return null;\n    }\n    return this.mapToDbValue(value);\n  }\n\n  /** Reconstruct the driver's row representation, which can differ from write bindings for Date and JSON. */\n  rowValue(data: any): any {\n    return this.column.codec.mapToRow(data[this.fieldName]);\n  }\n}\n\n/** Binds one entity field to its physical column. */\nexport class SimpleFieldSerde extends FieldColumn implements FieldSerde {\n  readonly columns: FieldColumn[] = [this];\n  /** Decode this field's physical column without changing entity data. */\n  fromRow(rowData: RowData, rowIndex: number): unknown {\n    return this.column.mapFromDb(rowData.get(rowIndex, this.column.columnName));\n  }\n  mapFromNow(now: Date): unknown {\n    return (this.column.codec as TimestampCodec<unknown>).mapFromNow(now);\n  }\n}\n\n/** A polymorphic field selects exactly one component while each physical column retains a scalar ID codec. */\nexport class PolymorphicKeySerde implements FieldSerde {\n  readonly columns: PolymorphicFieldColumn[];\n  constructor(\n    readonly fieldName: string,\n    components: PolymorphicFieldComponent[],\n  ) {\n    this.columns = components.map((component) => new PolymorphicFieldColumn(fieldName, component, components));\n  }\n  /** Select the first truthy component whose decoded ID is not nullish. */\n  fromRow(rowData: RowData, rowIndex: number): unknown {\n    let decoded: unknown;\n    for (const column of this.columns) {\n      const value = rowData.get(rowIndex, column.columnName);\n      if (value) {\n        decoded = column.mapFromDb(value);\n        if (decoded != null) return decoded;\n      }\n    }\n    return decoded;\n  }\n}\n\n/** Shares domain components between relationship traversal and entity write selection. */\nexport function polymorphicField(\n  fieldName: string,\n  required: boolean,\n  components: PolymorphicFieldComponent[],\n): PolymorphicField {\n  return {\n    kind: \"poly\",\n    fieldName,\n    fieldIdName: `${fieldName}Id`,\n    required,\n    components,\n    serde: new PolymorphicKeySerde(fieldName, components),\n    immutable: false,\n  };\n}\n\n/** A domain relationship component references storage and only overrides a specialized domain target. */\nexport class PolyComponent implements PolymorphicFieldComponent {\n  constructor(\n    readonly column: Column,\n    readonly otherFieldName: string,\n    private readonly target?: () => EntityMetadata,\n  ) {}\n  get columnName(): string {\n    return this.column.columnName;\n  }\n  get otherMetadata(): () => EntityMetadata {\n    return this.target ?? this.column.idMetadata!;\n  }\n}\n\n/** Selects a relationship component for entity writes only; direct SQL writes use its scalar column codec. */\nclass PolymorphicFieldColumn extends FieldColumn {\n  constructor(\n    fieldName: string,\n    private readonly component: PolymorphicFieldComponent,\n    private readonly components: PolymorphicFieldComponent[],\n  ) {\n    super(fieldName, component.column);\n  }\n  get otherMetadata() {\n    return this.component.otherMetadata;\n  }\n\n  /** Preserve exact subtype selection when multiple components share a base type. */\n  mapToDbValue(value: unknown): unknown {\n    const id = maybeResolveReferenceToId(value as Parameters<typeof maybeResolveReferenceToId>[0]);\n    const cstr = isEntity(value) ? getMetadata(value).cstr : id ? getConstructorFromTaggedId(id) : undefined;\n    // If our poly has multiple components from the same base type, i.e.\n    // `parent_small_publisher_id` and `parent_large_publisher_id`, then we\n    // need slightly different logic...\n    const hasMultipleComponentsWithSameBaseType = [\n      ...groupBy(this.components, (component) => getBaseMeta(component.otherMetadata()).type).values(),\n    ].some((group) => group.length > 1);\n    const otherMeta = this.otherMetadata();\n    // We'll have multiple columns, i.e. [parent_author_id, parent_book_id], and each column\n    // will only return a value if the `id` matches its type, i.e. `parent_author_id=a:1` will\n    // return 1, but `parent_book_id` will return null.\n    const applies = hasMultipleComponentsWithSameBaseType\n      ? cstr === otherMeta.cstr\n      : cstr === otherMeta.cstr ||\n        cstr === getBaseMeta(otherMeta).cstr ||\n        otherMeta.subTypes.some((subTypeMeta) => cstr === subTypeMeta.cstr);\n    return applies ? this.column.mapToDbValue(id) : undefined;\n  }\n  // Polymorphic writes historically do not schedule non-deferred FK fixups.\n  dbValue(data: any): any {\n    return this.mapToDbValue(data[this.fieldName]);\n  }\n  rowValue(data: any): any {\n    return this.dbValue(data);\n  }\n}\n"],"mappings":"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"}

package/build/serde/fieldSerde.d.cts

@@ -0,0 +1,87 @@
+import { TypeInfo } from "./TypeInfo.cjs";
+import { ScalarCodec } from "./serde.cjs";
+import { Column } from "./columns.cjs";
+import { InsertFixup } from "../drivers/EntityWriter.cjs";
+import { RowData } from "../RowData.cjs";
+import { EntityMetadata, Field, PolymorphicField, PolymorphicFieldComponent, SerdeField } from "../EntityMetadata.cjs";
+import { Entity } from "../Entity.cjs";
+//#region src/serde/fieldSerde.d.ts
+declare function hasSerde(field: Field): field is SerdeField;
+/** Entity hydration and flush bindings; a polymorphic relationship spans several physical columns. */
+interface FieldSerde {
+  columns: FieldColumn[];
+  /** Decode one domain value from accessed cells; callers own entity assignment and caching. */
+  fromRow(rowData: RowData, rowIndex: number): unknown;
+}
+interface TimestampSerde<T> extends FieldSerde {
+  mapFromNow(now: Date): T;
+  dbValue(data: any): any;
+}
+/** Binds a physical column to entity data without adding a second codec or storage declaration. */
+declare class FieldColumn {
+  readonly fieldName: string;
+  readonly column: Column;
+  constructor(fieldName: string, column: Column);
+  get codec(): ScalarCodec;
+  get insertOptional(): boolean;
+  get writable(): boolean;
+  get insert(): "never" | "optional" | "required";
+  get update(): boolean;
+  get idMetadata(): (() => EntityMetadata) | undefined;
+  get columnName(): string;
+  get dbType(): string;
+  get isArray(): boolean;
+  get isNullableArray(): boolean;
+  get sqlNullable(): boolean;
+  get hasDefault(): boolean;
+  get isGenerated(): boolean;
+  get outputType(): TypeInfo | undefined;
+  mapToDb(value: any): any;
+  mapToDbValue(value: unknown): unknown;
+  mapFromDb(value: unknown): unknown;
+  mapFromJsonAgg(value: any): any;
+  /** Defers FK writes whose new target must be inserted after this entity. */
+  dbValue(data: any, entity: Entity, tableName: string, fixups: InsertFixup[] | undefined): any;
+  /** Reconstruct the driver's row representation, which can differ from write bindings for Date and JSON. */
+  rowValue(data: any): any;
+}
+/** Binds one entity field to its physical column. */
+declare class SimpleFieldSerde extends FieldColumn implements FieldSerde {
+  readonly columns: FieldColumn[];
+  /** Decode this field's physical column without changing entity data. */
+  fromRow(rowData: RowData, rowIndex: number): unknown;
+  mapFromNow(now: Date): unknown;
+}
+/** A polymorphic field selects exactly one component while each physical column retains a scalar ID codec. */
+declare class PolymorphicKeySerde implements FieldSerde {
+  readonly fieldName: string;
+  readonly columns: PolymorphicFieldColumn[];
+  constructor(fieldName: string, components: PolymorphicFieldComponent[]);
+  /** Select the first truthy component whose decoded ID is not nullish. */
+  fromRow(rowData: RowData, rowIndex: number): unknown;
+}
+/** Shares domain components between relationship traversal and entity write selection. */
+declare function polymorphicField(fieldName: string, required: boolean, components: PolymorphicFieldComponent[]): PolymorphicField;
+/** A domain relationship component references storage and only overrides a specialized domain target. */
+declare class PolyComponent implements PolymorphicFieldComponent {
+  readonly column: Column;
+  readonly otherFieldName: string;
+  private readonly target?;
+  constructor(column: Column, otherFieldName: string, target?: (() => EntityMetadata) | undefined);
+  get columnName(): string;
+  get otherMetadata(): () => EntityMetadata;
+}
+/** Selects a relationship component for entity writes only; direct SQL writes use its scalar column codec. */
+declare class PolymorphicFieldColumn extends FieldColumn {
+  private readonly component;
+  private readonly components;
+  constructor(fieldName: string, component: PolymorphicFieldComponent, components: PolymorphicFieldComponent[]);
+  get otherMetadata(): () => EntityMetadata;
+  /** Preserve exact subtype selection when multiple components share a base type. */
+  mapToDbValue(value: unknown): unknown;
+  dbValue(data: any): any;
+  rowValue(data: any): any;
+}
+//#endregion
+export { FieldColumn, FieldSerde, PolyComponent, PolymorphicKeySerde, SimpleFieldSerde, TimestampSerde, hasSerde, polymorphicField };
+//# sourceMappingURL=fieldSerde.d.cts.map

package/build/serde/fieldSerde.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fieldSerde.d.cts","names":[],"sources":["../../src/serde/fieldSerde.ts"],"mappings":";;;;;;;;iBAkBgB,SAAS,OAAO,QAAQ,SAAS;;UAKhC;EACf,SAAS;;EAET,QAAQ,SAAS,SAAS;;UAGX,eAAe,WAAW;EACzC,WAAW,KAAK,OAAO;EACvB,QAAQ;;;cAIG;WAEA;WACA,QAAQ;EAFnB,YACW,mBACA,QAAQ;MAEf,SAFe;MAKf;MAGA;MAGA;MAGA;MAGA,qBAAU;MAGV;MAGA;MAGA;MAGA;MAGA;MAGA;MAGA;MAGA,cAxBU;EA2Bd,QAAQ;EAGR,aAAa;EAGb,UAAU;EAGV,eAAe;;EAKf,QAAQ,WAAW,QAAQ,QAAQ,mBAAmB,QAAQ;;EAkB9D,SAAS;;;cAME,yBAAyB,uBAAuB;WAClD,SAAS;;EAElB,QAAQ,SAAS,SAAS;EAG1B,WAAW,KAAK;;;cAML,+BAA+B;WAG/B;WAFF,SAAS;EAClB,YACW,mBACT,YAAY;;EAKd,QAAQ,SAAS,SAAS;;;iBAcZ,iBACd,mBACA,mBACA,YAAY,8BACX;;cAaU,yBAAyB;WAEzB,QAAQ;WACR;mBACQ;EAHnB,YACW,QAAQ,QACR,wBACQ,gBAAe;MAE9B;MAGA,uBAAuB;;;cAMvB,+BAA+B;mBAGhB;mBACA;EAHnB,YACE,mBACiB,WAAW,2BACX,YAAY;MAI3B,uBAAa;;EAKjB,aAAa;EAqBb,QAAQ;EAGR,SAAS"}

package/build/serde/fieldSerde.d.mts

@@ -0,0 +1,87 @@
+import { TypeInfo } from "./TypeInfo.mjs";
+import { ScalarCodec } from "./serde.mjs";
+import { Column } from "./columns.mjs";
+import { InsertFixup } from "../drivers/EntityWriter.mjs";
+import { RowData } from "../RowData.mjs";
+import { EntityMetadata, Field, PolymorphicField, PolymorphicFieldComponent, SerdeField } from "../EntityMetadata.mjs";
+import { Entity } from "../Entity.mjs";
+//#region src/serde/fieldSerde.d.ts
+declare function hasSerde(field: Field): field is SerdeField;
+/** Entity hydration and flush bindings; a polymorphic relationship spans several physical columns. */
+interface FieldSerde {
+  columns: FieldColumn[];
+  /** Decode one domain value from accessed cells; callers own entity assignment and caching. */
+  fromRow(rowData: RowData, rowIndex: number): unknown;
+}
+interface TimestampSerde<T> extends FieldSerde {
+  mapFromNow(now: Date): T;
+  dbValue(data: any): any;
+}
+/** Binds a physical column to entity data without adding a second codec or storage declaration. */
+declare class FieldColumn {
+  readonly fieldName: string;
+  readonly column: Column;
+  constructor(fieldName: string, column: Column);
+  get codec(): ScalarCodec;
+  get insertOptional(): boolean;
+  get writable(): boolean;
+  get insert(): "never" | "optional" | "required";
+  get update(): boolean;
+  get idMetadata(): (() => EntityMetadata) | undefined;
+  get columnName(): string;
+  get dbType(): string;
+  get isArray(): boolean;
+  get isNullableArray(): boolean;
+  get sqlNullable(): boolean;
+  get hasDefault(): boolean;
+  get isGenerated(): boolean;
+  get outputType(): TypeInfo | undefined;
+  mapToDb(value: any): any;
+  mapToDbValue(value: unknown): unknown;
+  mapFromDb(value: unknown): unknown;
+  mapFromJsonAgg(value: any): any;
+  /** Defers FK writes whose new target must be inserted after this entity. */
+  dbValue(data: any, entity: Entity, tableName: string, fixups: InsertFixup[] | undefined): any;
+  /** Reconstruct the driver's row representation, which can differ from write bindings for Date and JSON. */
+  rowValue(data: any): any;
+}
+/** Binds one entity field to its physical column. */
+declare class SimpleFieldSerde extends FieldColumn implements FieldSerde {
+  readonly columns: FieldColumn[];
+  /** Decode this field's physical column without changing entity data. */
+  fromRow(rowData: RowData, rowIndex: number): unknown;
+  mapFromNow(now: Date): unknown;
+}
+/** A polymorphic field selects exactly one component while each physical column retains a scalar ID codec. */
+declare class PolymorphicKeySerde implements FieldSerde {
+  readonly fieldName: string;
+  readonly columns: PolymorphicFieldColumn[];
+  constructor(fieldName: string, components: PolymorphicFieldComponent[]);
+  /** Select the first truthy component whose decoded ID is not nullish. */
+  fromRow(rowData: RowData, rowIndex: number): unknown;
+}
+/** Shares domain components between relationship traversal and entity write selection. */
+declare function polymorphicField(fieldName: string, required: boolean, components: PolymorphicFieldComponent[]): PolymorphicField;
+/** A domain relationship component references storage and only overrides a specialized domain target. */
+declare class PolyComponent implements PolymorphicFieldComponent {
+  readonly column: Column;
+  readonly otherFieldName: string;
+  private readonly target?;
+  constructor(column: Column, otherFieldName: string, target?: (() => EntityMetadata) | undefined);
+  get columnName(): string;
+  get otherMetadata(): () => EntityMetadata;
+}
+/** Selects a relationship component for entity writes only; direct SQL writes use its scalar column codec. */
+declare class PolymorphicFieldColumn extends FieldColumn {
+  private readonly component;
+  private readonly components;
+  constructor(fieldName: string, component: PolymorphicFieldComponent, components: PolymorphicFieldComponent[]);
+  get otherMetadata(): () => EntityMetadata;
+  /** Preserve exact subtype selection when multiple components share a base type. */
+  mapToDbValue(value: unknown): unknown;
+  dbValue(data: any): any;
+  rowValue(data: any): any;
+}
+//#endregion
+export { FieldColumn, FieldSerde, PolyComponent, PolymorphicKeySerde, SimpleFieldSerde, TimestampSerde, hasSerde, polymorphicField };
+//# sourceMappingURL=fieldSerde.d.mts.map

package/build/serde/fieldSerde.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fieldSerde.d.mts","names":[],"sources":["../../src/serde/fieldSerde.ts"],"mappings":";;;;;;;;iBAkBgB,SAAS,OAAO,QAAQ,SAAS;;UAKhC;EACf,SAAS;;EAET,QAAQ,SAAS,SAAS;;UAGX,eAAe,WAAW;EACzC,WAAW,KAAK,OAAO;EACvB,QAAQ;;;cAIG;WAEA;WACA,QAAQ;EAFnB,YACW,mBACA,QAAQ;MAEf,SAFe;MAKf;MAGA;MAGA;MAGA;MAGA,qBAAU;MAGV;MAGA;MAGA;MAGA;MAGA;MAGA;MAGA;MAGA,cAxBU;EA2Bd,QAAQ;EAGR,aAAa;EAGb,UAAU;EAGV,eAAe;;EAKf,QAAQ,WAAW,QAAQ,QAAQ,mBAAmB,QAAQ;;EAkB9D,SAAS;;;cAME,yBAAyB,uBAAuB;WAClD,SAAS;;EAElB,QAAQ,SAAS,SAAS;EAG1B,WAAW,KAAK;;;cAML,+BAA+B;WAG/B;WAFF,SAAS;EAClB,YACW,mBACT,YAAY;;EAKd,QAAQ,SAAS,SAAS;;;iBAcZ,iBACd,mBACA,mBACA,YAAY,8BACX;;cAaU,yBAAyB;WAEzB,QAAQ;WACR;mBACQ;EAHnB,YACW,QAAQ,QACR,wBACQ,gBAAe;MAE9B;MAGA,uBAAuB;;;cAMvB,+BAA+B;mBAGhB;mBACA;EAHnB,YACE,mBACiB,WAAW,2BACX,YAAY;MAI3B,uBAAa;;EAKjB,aAAa;EAqBb,QAAQ;EAGR,SAAS"}

package/build/serde/fieldSerde.js

@@ -0,0 +1,182 @@
+import { maybeResolveReferenceToId } from "../keys.js";
+import { groupBy } from "../utils.js";
+import { getConstructorFromTaggedId } from "../configure.js";
+import { getBaseMeta, getMetadata } from "../EntityMetadata.js";
+import { isEntity } from "../Entity.js";
+//#region src/serde/fieldSerde.ts
+function hasSerde(field) {
+	return !!field.serde;
+}
+/** Binds a physical column to entity data without adding a second codec or storage declaration. */
+var FieldColumn = class {
+	fieldName;
+	column;
+	constructor(fieldName, column) {
+		this.fieldName = fieldName;
+		this.column = column;
+	}
+	get codec() {
+		return this.column.codec;
+	}
+	get insertOptional() {
+		return this.column.insertOptional;
+	}
+	get writable() {
+		return this.column.writable;
+	}
+	get insert() {
+		return this.column.insert;
+	}
+	get update() {
+		return this.column.update;
+	}
+	get idMetadata() {
+		return this.column.idMetadata;
+	}
+	get columnName() {
+		return this.column.columnName;
+	}
+	get dbType() {
+		return this.column.dbType;
+	}
+	get isArray() {
+		return this.column.isArray;
+	}
+	get isNullableArray() {
+		return this.column.isNullableArray;
+	}
+	get sqlNullable() {
+		return this.column.sqlNullable;
+	}
+	get hasDefault() {
+		return this.column.hasDefault;
+	}
+	get isGenerated() {
+		return this.column.isGenerated;
+	}
+	get outputType() {
+		return this.column.outputType;
+	}
+	mapToDb(value) {
+		return this.column.mapToDb(value);
+	}
+	mapToDbValue(value) {
+		return this.column.mapToDbValue(value);
+	}
+	mapFromDb(value) {
+		return this.column.mapFromDb(value);
+	}
+	mapFromJsonAgg(value) {
+		return this.column.mapFromJsonAgg(value);
+	}
+	/** Defers FK writes whose new target must be inserted after this entity. */
+	dbValue(data, entity, tableName, fixups) {
+		const value = data[this.fieldName];
+		if (this.column.idMetadata && fixups && isEntity(value) && value.isNewEntity && getMetadata(value).nonDeferredFkOrder && getMetadata(entity).nonDeferredFkOrder && getMetadata(value).nonDeferredFkOrder >= getMetadata(entity).nonDeferredFkOrder) {
+			fixups.push({
+				entity,
+				tableName,
+				column: this,
+				value: this.mapToDbValue(maybeResolveReferenceToId(value))
+			});
+			return null;
+		}
+		return this.mapToDbValue(value);
+	}
+	/** Reconstruct the driver's row representation, which can differ from write bindings for Date and JSON. */
+	rowValue(data) {
+		return this.column.codec.mapToRow(data[this.fieldName]);
+	}
+};
+/** Binds one entity field to its physical column. */
+var SimpleFieldSerde = class extends FieldColumn {
+	columns = [this];
+	/** Decode this field's physical column without changing entity data. */
+	fromRow(rowData, rowIndex) {
+		return this.column.mapFromDb(rowData.get(rowIndex, this.column.columnName));
+	}
+	mapFromNow(now) {
+		return this.column.codec.mapFromNow(now);
+	}
+};
+/** A polymorphic field selects exactly one component while each physical column retains a scalar ID codec. */
+var PolymorphicKeySerde = class {
+	fieldName;
+	columns;
+	constructor(fieldName, components) {
+		this.fieldName = fieldName;
+		this.columns = components.map((component) => new PolymorphicFieldColumn(fieldName, component, components));
+	}
+	/** Select the first truthy component whose decoded ID is not nullish. */
+	fromRow(rowData, rowIndex) {
+		let decoded;
+		for (const column of this.columns) {
+			const value = rowData.get(rowIndex, column.columnName);
+			if (value) {
+				decoded = column.mapFromDb(value);
+				if (decoded != null) return decoded;
+			}
+		}
+		return decoded;
+	}
+};
+/** Shares domain components between relationship traversal and entity write selection. */
+function polymorphicField(fieldName, required, components) {
+	return {
+		kind: "poly",
+		fieldName,
+		fieldIdName: `${fieldName}Id`,
+		required,
+		components,
+		serde: new PolymorphicKeySerde(fieldName, components),
+		immutable: false
+	};
+}
+/** A domain relationship component references storage and only overrides a specialized domain target. */
+var PolyComponent = class {
+	column;
+	otherFieldName;
+	target;
+	constructor(column, otherFieldName, target) {
+		this.column = column;
+		this.otherFieldName = otherFieldName;
+		this.target = target;
+	}
+	get columnName() {
+		return this.column.columnName;
+	}
+	get otherMetadata() {
+		return this.target ?? this.column.idMetadata;
+	}
+};
+/** Selects a relationship component for entity writes only; direct SQL writes use its scalar column codec. */
+var PolymorphicFieldColumn = class extends FieldColumn {
+	component;
+	components;
+	constructor(fieldName, component, components) {
+		super(fieldName, component.column);
+		this.component = component;
+		this.components = components;
+	}
+	get otherMetadata() {
+		return this.component.otherMetadata;
+	}
+	/** Preserve exact subtype selection when multiple components share a base type. */
+	mapToDbValue(value) {
+		const id = maybeResolveReferenceToId(value);
+		const cstr = isEntity(value) ? getMetadata(value).cstr : id ? getConstructorFromTaggedId(id) : void 0;
+		const hasMultipleComponentsWithSameBaseType = [...groupBy(this.components, (component) => getBaseMeta(component.otherMetadata()).type).values()].some((group) => group.length > 1);
+		const otherMeta = this.otherMetadata();
+		return (hasMultipleComponentsWithSameBaseType ? cstr === otherMeta.cstr : cstr === otherMeta.cstr || cstr === getBaseMeta(otherMeta).cstr || otherMeta.subTypes.some((subTypeMeta) => cstr === subTypeMeta.cstr)) ? this.column.mapToDbValue(id) : void 0;
+	}
+	dbValue(data) {
+		return this.mapToDbValue(data[this.fieldName]);
+	}
+	rowValue(data) {
+		return this.dbValue(data);
+	}
+};
+//#endregion
+export { FieldColumn, PolyComponent, PolymorphicKeySerde, SimpleFieldSerde, hasSerde, polymorphicField };
+
+//# sourceMappingURL=fieldSerde.js.map

package/build/serde/fieldSerde.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fieldSerde.js","names":[],"sources":["../../src/serde/fieldSerde.ts"],"sourcesContent":["import { getConstructorFromTaggedId } from \"src/configure.ts\";\nimport type { InsertFixup } from \"src/drivers/EntityWriter.ts\";\nimport { type Entity, isEntity } from \"src/Entity.ts\";\nimport {\n  type EntityMetadata,\n  type Field,\n  type PolymorphicField,\n  type PolymorphicFieldComponent,\n  type SerdeField,\n  getBaseMeta,\n  getMetadata,\n} from \"src/EntityMetadata.ts\";\nimport { maybeResolveReferenceToId } from \"src/keys.ts\";\nimport type { RowData } from \"src/RowData.ts\";\nimport type { Column } from \"src/serde/columns.ts\";\nimport type { TimestampCodec } from \"src/serde/serde.ts\";\nimport { groupBy } from \"src/utils.ts\";\n\nexport function hasSerde(field: Field): field is SerdeField {\n  return !!field.serde;\n}\n\n/** Entity hydration and flush bindings; a polymorphic relationship spans several physical columns. */\nexport interface FieldSerde {\n  columns: FieldColumn[];\n  /** Decode one domain value from accessed cells; callers own entity assignment and caching. */\n  fromRow(rowData: RowData, rowIndex: number): unknown;\n}\n\nexport interface TimestampSerde<T> extends FieldSerde {\n  mapFromNow(now: Date): T;\n  dbValue(data: any): any;\n}\n\n/** Binds a physical column to entity data without adding a second codec or storage declaration. */\nexport class FieldColumn {\n  constructor(\n    readonly fieldName: string,\n    readonly column: Column,\n  ) {}\n  get codec() {\n    return this.column.codec;\n  }\n  get insertOptional() {\n    return this.column.insertOptional;\n  }\n  get writable() {\n    return this.column.writable;\n  }\n  get insert() {\n    return this.column.insert;\n  }\n  get update() {\n    return this.column.update;\n  }\n  get idMetadata() {\n    return this.column.idMetadata;\n  }\n  get columnName(): string {\n    return this.column.columnName;\n  }\n  get dbType(): string {\n    return this.column.dbType;\n  }\n  get isArray(): boolean {\n    return this.column.isArray;\n  }\n  get isNullableArray(): boolean {\n    return this.column.isNullableArray;\n  }\n  get sqlNullable(): boolean {\n    return this.column.sqlNullable;\n  }\n  get hasDefault(): boolean {\n    return this.column.hasDefault;\n  }\n  get isGenerated(): boolean {\n    return this.column.isGenerated;\n  }\n  get outputType() {\n    return this.column.outputType;\n  }\n  mapToDb(value: any): any {\n    return this.column.mapToDb(value);\n  }\n  mapToDbValue(value: unknown): unknown {\n    return this.column.mapToDbValue(value);\n  }\n  mapFromDb(value: unknown): unknown {\n    return this.column.mapFromDb(value);\n  }\n  mapFromJsonAgg(value: any): any {\n    return this.column.mapFromJsonAgg(value);\n  }\n\n  /** Defers FK writes whose new target must be inserted after this entity. */\n  dbValue(data: any, entity: Entity, tableName: string, fixups: InsertFixup[] | undefined): any {\n    const value = data[this.fieldName];\n    if (\n      this.column.idMetadata &&\n      fixups &&\n      isEntity(value) &&\n      value.isNewEntity &&\n      getMetadata(value).nonDeferredFkOrder &&\n      getMetadata(entity).nonDeferredFkOrder &&\n      getMetadata(value).nonDeferredFkOrder! >= getMetadata(entity).nonDeferredFkOrder!\n    ) {\n      fixups.push({ entity, tableName, column: this, value: this.mapToDbValue(maybeResolveReferenceToId(value)) });\n      return null;\n    }\n    return this.mapToDbValue(value);\n  }\n\n  /** Reconstruct the driver's row representation, which can differ from write bindings for Date and JSON. */\n  rowValue(data: any): any {\n    return this.column.codec.mapToRow(data[this.fieldName]);\n  }\n}\n\n/** Binds one entity field to its physical column. */\nexport class SimpleFieldSerde extends FieldColumn implements FieldSerde {\n  readonly columns: FieldColumn[] = [this];\n  /** Decode this field's physical column without changing entity data. */\n  fromRow(rowData: RowData, rowIndex: number): unknown {\n    return this.column.mapFromDb(rowData.get(rowIndex, this.column.columnName));\n  }\n  mapFromNow(now: Date): unknown {\n    return (this.column.codec as TimestampCodec<unknown>).mapFromNow(now);\n  }\n}\n\n/** A polymorphic field selects exactly one component while each physical column retains a scalar ID codec. */\nexport class PolymorphicKeySerde implements FieldSerde {\n  readonly columns: PolymorphicFieldColumn[];\n  constructor(\n    readonly fieldName: string,\n    components: PolymorphicFieldComponent[],\n  ) {\n    this.columns = components.map((component) => new PolymorphicFieldColumn(fieldName, component, components));\n  }\n  /** Select the first truthy component whose decoded ID is not nullish. */\n  fromRow(rowData: RowData, rowIndex: number): unknown {\n    let decoded: unknown;\n    for (const column of this.columns) {\n      const value = rowData.get(rowIndex, column.columnName);\n      if (value) {\n        decoded = column.mapFromDb(value);\n        if (decoded != null) return decoded;\n      }\n    }\n    return decoded;\n  }\n}\n\n/** Shares domain components between relationship traversal and entity write selection. */\nexport function polymorphicField(\n  fieldName: string,\n  required: boolean,\n  components: PolymorphicFieldComponent[],\n): PolymorphicField {\n  return {\n    kind: \"poly\",\n    fieldName,\n    fieldIdName: `${fieldName}Id`,\n    required,\n    components,\n    serde: new PolymorphicKeySerde(fieldName, components),\n    immutable: false,\n  };\n}\n\n/** A domain relationship component references storage and only overrides a specialized domain target. */\nexport class PolyComponent implements PolymorphicFieldComponent {\n  constructor(\n    readonly column: Column,\n    readonly otherFieldName: string,\n    private readonly target?: () => EntityMetadata,\n  ) {}\n  get columnName(): string {\n    return this.column.columnName;\n  }\n  get otherMetadata(): () => EntityMetadata {\n    return this.target ?? this.column.idMetadata!;\n  }\n}\n\n/** Selects a relationship component for entity writes only; direct SQL writes use its scalar column codec. */\nclass PolymorphicFieldColumn extends FieldColumn {\n  constructor(\n    fieldName: string,\n    private readonly component: PolymorphicFieldComponent,\n    private readonly components: PolymorphicFieldComponent[],\n  ) {\n    super(fieldName, component.column);\n  }\n  get otherMetadata() {\n    return this.component.otherMetadata;\n  }\n\n  /** Preserve exact subtype selection when multiple components share a base type. */\n  mapToDbValue(value: unknown): unknown {\n    const id = maybeResolveReferenceToId(value as Parameters<typeof maybeResolveReferenceToId>[0]);\n    const cstr = isEntity(value) ? getMetadata(value).cstr : id ? getConstructorFromTaggedId(id) : undefined;\n    // If our poly has multiple components from the same base type, i.e.\n    // `parent_small_publisher_id` and `parent_large_publisher_id`, then we\n    // need slightly different logic...\n    const hasMultipleComponentsWithSameBaseType = [\n      ...groupBy(this.components, (component) => getBaseMeta(component.otherMetadata()).type).values(),\n    ].some((group) => group.length > 1);\n    const otherMeta = this.otherMetadata();\n    // We'll have multiple columns, i.e. [parent_author_id, parent_book_id], and each column\n    // will only return a value if the `id` matches its type, i.e. `parent_author_id=a:1` will\n    // return 1, but `parent_book_id` will return null.\n    const applies = hasMultipleComponentsWithSameBaseType\n      ? cstr === otherMeta.cstr\n      : cstr === otherMeta.cstr ||\n        cstr === getBaseMeta(otherMeta).cstr ||\n        otherMeta.subTypes.some((subTypeMeta) => cstr === subTypeMeta.cstr);\n    return applies ? this.column.mapToDbValue(id) : undefined;\n  }\n  // Polymorphic writes historically do not schedule non-deferred FK fixups.\n  dbValue(data: any): any {\n    return this.mapToDbValue(data[this.fieldName]);\n  }\n  rowValue(data: any): any {\n    return this.dbValue(data);\n  }\n}\n"],"mappings":";;;;;;AAkBA,SAAgB,SAAS,OAAmC;CAC1D,OAAO,CAAC,CAAC,MAAM;AACjB;;AAeA,IAAa,cAAb,MAAyB;CAEZ;CACA;CAFX,YACE,WACA,QACA;EAFS,KAAA,YAAA;EACA,KAAA,SAAA;CACR;CACH,IAAI,QAAQ;EACV,OAAO,KAAK,OAAO;CACrB;CACA,IAAI,iBAAiB;EACnB,OAAO,KAAK,OAAO;CACrB;CACA,IAAI,WAAW;EACb,OAAO,KAAK,OAAO;CACrB;CACA,IAAI,SAAS;EACX,OAAO,KAAK,OAAO;CACrB;CACA,IAAI,SAAS;EACX,OAAO,KAAK,OAAO;CACrB;CACA,IAAI,aAAa;EACf,OAAO,KAAK,OAAO;CACrB;CACA,IAAI,aAAqB;EACvB,OAAO,KAAK,OAAO;CACrB;CACA,IAAI,SAAiB;EACnB,OAAO,KAAK,OAAO;CACrB;CACA,IAAI,UAAmB;EACrB,OAAO,KAAK,OAAO;CACrB;CACA,IAAI,kBAA2B;EAC7B,OAAO,KAAK,OAAO;CACrB;CACA,IAAI,cAAuB;EACzB,OAAO,KAAK,OAAO;CACrB;CACA,IAAI,aAAsB;EACxB,OAAO,KAAK,OAAO;CACrB;CACA,IAAI,cAAuB;EACzB,OAAO,KAAK,OAAO;CACrB;CACA,IAAI,aAAa;EACf,OAAO,KAAK,OAAO;CACrB;CACA,QAAQ,OAAiB;EACvB,OAAO,KAAK,OAAO,QAAQ,KAAK;CAClC;CACA,aAAa,OAAyB;EACpC,OAAO,KAAK,OAAO,aAAa,KAAK;CACvC;CACA,UAAU,OAAyB;EACjC,OAAO,KAAK,OAAO,UAAU,KAAK;CACpC;CACA,eAAe,OAAiB;EAC9B,OAAO,KAAK,OAAO,eAAe,KAAK;CACzC;;CAGA,QAAQ,MAAW,QAAgB,WAAmB,QAAwC;EAC5F,MAAM,QAAQ,KAAK,KAAK;EACxB,IACE,KAAK,OAAO,cACZ,UACA,SAAS,KAAK,KACd,MAAM,eACN,YAAY,KAAK,CAAC,CAAC,sBACnB,YAAY,MAAM,CAAC,CAAC,sBACpB,YAAY,KAAK,CAAC,CAAC,sBAAuB,YAAY,MAAM,CAAC,CAAC,oBAC9D;GACA,OAAO,KAAK;IAAE;IAAQ;IAAW,QAAQ;IAAM,OAAO,KAAK,aAAa,0BAA0B,KAAK,CAAC;GAAE,CAAC;GAC3G,OAAO;EACT;EACA,OAAO,KAAK,aAAa,KAAK;CAChC;;CAGA,SAAS,MAAgB;EACvB,OAAO,KAAK,OAAO,MAAM,SAAS,KAAK,KAAK,UAAU;CACxD;AACF;;AAGA,IAAa,mBAAb,cAAsC,YAAkC;CACtE,UAAkC,CAAC,IAAI;;CAEvC,QAAQ,SAAkB,UAA2B;EACnD,OAAO,KAAK,OAAO,UAAU,QAAQ,IAAI,UAAU,KAAK,OAAO,UAAU,CAAC;CAC5E;CACA,WAAW,KAAoB;EAC7B,OAAQ,KAAK,OAAO,MAAkC,WAAW,GAAG;CACtE;AACF;;AAGA,IAAa,sBAAb,MAAuD;CAG1C;CAFX;CACA,YACE,WACA,YACA;EAFS,KAAA,YAAA;EAGT,KAAK,UAAU,WAAW,KAAK,cAAc,IAAI,uBAAuB,WAAW,WAAW,UAAU,CAAC;CAC3G;;CAEA,QAAQ,SAAkB,UAA2B;EACnD,IAAI;EACJ,KAAK,MAAM,UAAU,KAAK,SAAS;GACjC,MAAM,QAAQ,QAAQ,IAAI,UAAU,OAAO,UAAU;GACrD,IAAI,OAAO;IACT,UAAU,OAAO,UAAU,KAAK;IAChC,IAAI,WAAW,MAAM,OAAO;GAC9B;EACF;EACA,OAAO;CACT;AACF;;AAGA,SAAgB,iBACd,WACA,UACA,YACkB;CAClB,OAAO;EACL,MAAM;EACN;EACA,aAAa,GAAG,UAAU;EAC1B;EACA;EACA,OAAO,IAAI,oBAAoB,WAAW,UAAU;EACpD,WAAW;CACb;AACF;;AAGA,IAAa,gBAAb,MAAgE;CAEnD;CACA;CACQ;CAHnB,YACE,QACA,gBACA,QACA;EAHS,KAAA,SAAA;EACA,KAAA,iBAAA;EACQ,KAAA,SAAA;CAChB;CACH,IAAI,aAAqB;EACvB,OAAO,KAAK,OAAO;CACrB;CACA,IAAI,gBAAsC;EACxC,OAAO,KAAK,UAAU,KAAK,OAAO;CACpC;AACF;;AAGA,IAAM,yBAAN,cAAqC,YAAY;CAG5B;CACA;CAHnB,YACE,WACA,WACA,YACA;EACA,MAAM,WAAW,UAAU,MAAM;EAHhB,KAAA,YAAA;EACA,KAAA,aAAA;CAGnB;CACA,IAAI,gBAAgB;EAClB,OAAO,KAAK,UAAU;CACxB;;CAGA,aAAa,OAAyB;EACpC,MAAM,KAAK,0BAA0B,KAAwD;EAC7F,MAAM,OAAO,SAAS,KAAK,IAAI,YAAY,KAAK,CAAC,CAAC,OAAO,KAAK,2BAA2B,EAAE,IAAI,KAAA;EAI/F,MAAM,wCAAwC,CAC5C,GAAG,QAAQ,KAAK,aAAa,cAAc,YAAY,UAAU,cAAc,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,OAAO,CACjG,CAAC,CAAC,MAAM,UAAU,MAAM,SAAS,CAAC;EAClC,MAAM,YAAY,KAAK,cAAc;EASrC,QALgB,wCACZ,SAAS,UAAU,OACnB,SAAS,UAAU,QACnB,SAAS,YAAY,SAAS,CAAC,CAAC,QAChC,UAAU,SAAS,MAAM,gBAAgB,SAAS,YAAY,IAAI,KACrD,KAAK,OAAO,aAAa,EAAE,IAAI,KAAA;CAClD;CAEA,QAAQ,MAAgB;EACtB,OAAO,KAAK,aAAa,KAAK,KAAK,UAAU;CAC/C;CACA,SAAS,MAAgB;EACvB,OAAO,KAAK,QAAQ,IAAI;CAC1B;AACF"}