@atscript/typescript 0.1.30 → 0.1.31

package/dist/cli.cjs

@@ -289,8 +289,9 @@ var TypeRenderer = class TypeRenderer extends BaseRenderer {
 			if (isGrp) this.write(")");
 			return this.write("[]");
 		}
+		if ((0, __atscript_core.isPrimitive)(def)) return this.write(renderPrimitiveTypeDef(def.config.type));
 	}
-	renderStructure(struct, asClass) {
+	renderStructure(struct, asClass, interfaceNode) {
 		this.blockln("{}");
 		const patterns = [];
 		const propsDefs = new Set();
@@ -336,6 +337,7 @@ var TypeRenderer = class TypeRenderer extends BaseRenderer {
 			this.writeln("static toJsonSchema: () => any");
 			if (!this.opts?.exampleData) this.writeln("/** @deprecated Example Data support is disabled. To enable, set `exampleData: true` in tsPlugin options. */");
 			this.writeln("static toExampleData?: () => any");
+			if (interfaceNode && this.hasDbTable(interfaceNode)) this.renderFlat(interfaceNode);
 		}
 		this.pop();
 	}
@@ -362,20 +364,20 @@ var TypeRenderer = class TypeRenderer extends BaseRenderer {
 					}
 					if (!firstParentProps && (0, __atscript_core.isStructure)(fpDef)) firstParentProps = fpDef.props;
 				}
-				this.renderStructureFiltered(resolved, node.id, firstParentProps);
+				this.renderStructureFiltered(resolved, node.id, firstParentProps, node);
 			} else this.writeln("{}");
 		} else {
 			this.write(`class ${node.id} `);
 			const struct = node.getDefinition();
-			if (struct?.entity === "structure") this.renderStructure(struct, node.id);
+			if (struct?.entity === "structure") this.renderStructure(struct, node.id, node);
 else this.writeln("{}");
 		}
 		this.writeln();
 	}
 	/**
 	* Renders a structure block, optionally filtering out props that exist in a parent.
-	*/ renderStructureFiltered(struct, asClass, filterProps) {
-		if (!filterProps) return this.renderStructure(struct, asClass);
+	*/ renderStructureFiltered(struct, asClass, filterProps, interfaceNode) {
+		if (!filterProps) return this.renderStructure(struct, asClass, interfaceNode);
 		this.blockln("{}");
 		for (const prop of Array.from(struct.props.values())) {
 			if (filterProps.has(prop.id)) continue;
@@ -398,6 +400,7 @@ else this.writeln("{}");
 		this.writeln("static toJsonSchema: () => any");
 		if (!this.opts?.exampleData) this.writeln("/** @deprecated Example Data support is disabled. To enable, set `exampleData: true` in tsPlugin options. */");
 		this.writeln("static toExampleData?: () => any");
+		if (interfaceNode && this.hasDbTable(interfaceNode)) this.renderFlat(interfaceNode);
 		this.pop();
 	}
 	renderType(node) {
@@ -453,6 +456,50 @@ else if ((0, __atscript_core.isPrimitive)(realDef)) typeDef = `TAtscriptTypeFina
 		this.writeln("const toExampleData: (() => any) | undefined");
 		this.popln();
 	}
+	/**
+	* Checks whether an interface has the `@db.table` annotation.
+	*
+	* NOTE: Only `@db.table` interfaces get the `__flat` static property.
+	* This is intentionally hardcoded — `__flat` exists solely to improve
+	* type-safety for filter expressions and `$select`/`$sort` operations
+	* in the DB layer. Non-DB interfaces have no use for dot-notation path types.
+	*/ hasDbTable(node) {
+		return !!node.annotations?.some((a) => a.name === "db.table");
+	}
+	/**
+	* Renders the `static __flat` property — a map of all dot-notation paths
+	* to their TypeScript value types.
+	*
+	* This enables type-safe autocomplete for filter keys and `$select`/`$sort`
+	* paths when using `AtscriptDbTable`. The `FlatOf<T>` utility type extracts
+	* this map at the type level.
+	*
+	* Special rendering rules:
+	* - **Intermediate paths** (structures, arrays of structures) → `never`
+	*   (prevents `$eq` comparisons, but allows `$select` and `$exists`)
+	* - **`@db.json` fields** → `string` (stored as serialized JSON in DB,
+	*   not individually queryable)
+	* - **Leaf fields** → their original TypeScript type
+	*/ renderFlat(node) {
+		const flatMap = (0, __atscript_core.flattenInterfaceNode)(this.doc, node);
+		if (flatMap.size === 0) return;
+		this.write("static __flat: ");
+		this.blockln("{}");
+		for (const [path$3, descriptor] of flatMap) {
+			this.write(`"${escapeQuotes(path$3)}"`);
+			if (descriptor.optional) this.write("?");
+			this.write(": ");
+			if (descriptor.intermediate) this.writeln("never");
+else if (descriptor.dbJson) this.writeln("string");
+else {
+				const originalDef = descriptor.propNode?.getDefinition();
+				const defToRender = originalDef && !((0, __atscript_core.isGroup)(descriptor.def) && descriptor.def !== originalDef) ? originalDef : descriptor.def;
+				const renderedDef = this.renderTypeDefString(defToRender);
+				renderedDef.split("\n").forEach((l) => this.writeln(l));
+			}
+		}
+		this.pop();
+	}
 	phantomPropType(def) {
 		if (!def) return undefined;
 		if ((0, __atscript_core.isPrimitive)(def) && def.config.type === "phantom") return def.id;

package/dist/index.cjs

@@ -287,8 +287,9 @@ var TypeRenderer = class TypeRenderer extends BaseRenderer {
 			if (isGrp) this.write(")");
 			return this.write("[]");
 		}
+		if ((0, __atscript_core.isPrimitive)(def)) return this.write(renderPrimitiveTypeDef(def.config.type));
 	}
-	renderStructure(struct, asClass) {
+	renderStructure(struct, asClass, interfaceNode) {
 		this.blockln("{}");
 		const patterns = [];
 		const propsDefs = new Set();
@@ -334,6 +335,7 @@ var TypeRenderer = class TypeRenderer extends BaseRenderer {
 			this.writeln("static toJsonSchema: () => any");
 			if (!this.opts?.exampleData) this.writeln("/** @deprecated Example Data support is disabled. To enable, set `exampleData: true` in tsPlugin options. */");
 			this.writeln("static toExampleData?: () => any");
+			if (interfaceNode && this.hasDbTable(interfaceNode)) this.renderFlat(interfaceNode);
 		}
 		this.pop();
 	}
@@ -360,20 +362,20 @@ var TypeRenderer = class TypeRenderer extends BaseRenderer {
 					}
 					if (!firstParentProps && (0, __atscript_core.isStructure)(fpDef)) firstParentProps = fpDef.props;
 				}
-				this.renderStructureFiltered(resolved, node.id, firstParentProps);
+				this.renderStructureFiltered(resolved, node.id, firstParentProps, node);
 			} else this.writeln("{}");
 		} else {
 			this.write(`class ${node.id} `);
 			const struct = node.getDefinition();
-			if (struct?.entity === "structure") this.renderStructure(struct, node.id);
+			if (struct?.entity === "structure") this.renderStructure(struct, node.id, node);
 else this.writeln("{}");
 		}
 		this.writeln();
 	}
 	/**
 	* Renders a structure block, optionally filtering out props that exist in a parent.
-	*/ renderStructureFiltered(struct, asClass, filterProps) {
-		if (!filterProps) return this.renderStructure(struct, asClass);
+	*/ renderStructureFiltered(struct, asClass, filterProps, interfaceNode) {
+		if (!filterProps) return this.renderStructure(struct, asClass, interfaceNode);
 		this.blockln("{}");
 		for (const prop of Array.from(struct.props.values())) {
 			if (filterProps.has(prop.id)) continue;
@@ -396,6 +398,7 @@ else this.writeln("{}");
 		this.writeln("static toJsonSchema: () => any");
 		if (!this.opts?.exampleData) this.writeln("/** @deprecated Example Data support is disabled. To enable, set `exampleData: true` in tsPlugin options. */");
 		this.writeln("static toExampleData?: () => any");
+		if (interfaceNode && this.hasDbTable(interfaceNode)) this.renderFlat(interfaceNode);
 		this.pop();
 	}
 	renderType(node) {
@@ -451,6 +454,50 @@ else if ((0, __atscript_core.isPrimitive)(realDef)) typeDef = `TAtscriptTypeFina
 		this.writeln("const toExampleData: (() => any) | undefined");
 		this.popln();
 	}
+	/**
+	* Checks whether an interface has the `@db.table` annotation.
+	*
+	* NOTE: Only `@db.table` interfaces get the `__flat` static property.
+	* This is intentionally hardcoded — `__flat` exists solely to improve
+	* type-safety for filter expressions and `$select`/`$sort` operations
+	* in the DB layer. Non-DB interfaces have no use for dot-notation path types.
+	*/ hasDbTable(node) {
+		return !!node.annotations?.some((a) => a.name === "db.table");
+	}
+	/**
+	* Renders the `static __flat` property — a map of all dot-notation paths
+	* to their TypeScript value types.
+	*
+	* This enables type-safe autocomplete for filter keys and `$select`/`$sort`
+	* paths when using `AtscriptDbTable`. The `FlatOf<T>` utility type extracts
+	* this map at the type level.
+	*
+	* Special rendering rules:
+	* - **Intermediate paths** (structures, arrays of structures) → `never`
+	*   (prevents `$eq` comparisons, but allows `$select` and `$exists`)
+	* - **`@db.json` fields** → `string` (stored as serialized JSON in DB,
+	*   not individually queryable)
+	* - **Leaf fields** → their original TypeScript type
+	*/ renderFlat(node) {
+		const flatMap = (0, __atscript_core.flattenInterfaceNode)(this.doc, node);
+		if (flatMap.size === 0) return;
+		this.write("static __flat: ");
+		this.blockln("{}");
+		for (const [path$2, descriptor] of flatMap) {
+			this.write(`"${escapeQuotes(path$2)}"`);
+			if (descriptor.optional) this.write("?");
+			this.write(": ");
+			if (descriptor.intermediate) this.writeln("never");
+else if (descriptor.dbJson) this.writeln("string");
+else {
+				const originalDef = descriptor.propNode?.getDefinition();
+				const defToRender = originalDef && !((0, __atscript_core.isGroup)(descriptor.def) && descriptor.def !== originalDef) ? originalDef : descriptor.def;
+				const renderedDef = this.renderTypeDefString(defToRender);
+				renderedDef.split("\n").forEach((l) => this.writeln(l));
+			}
+		}
+		this.pop();
+	}
 	phantomPropType(def) {
 		if (!def) return undefined;
 		if ((0, __atscript_core.isPrimitive)(def) && def.config.type === "phantom") return def.id;

package/dist/index.mjs

@@ -1,5 +1,5 @@
 import path from "path";
-import { DEFAULT_FORMAT, isArray, isConst, isGroup, isInterface, isPrimitive, isRef, isStructure } from "@atscript/core";
+import { DEFAULT_FORMAT, flattenInterfaceNode, isArray, isConst, isGroup, isInterface, isPrimitive, isRef, isStructure } from "@atscript/core";
 
 //#region packages/typescript/src/codegen/code-printer.ts
 function _define_property$4(obj, key, value) {
@@ -262,8 +262,9 @@ var TypeRenderer = class TypeRenderer extends BaseRenderer {
 			if (isGrp) this.write(")");
 			return this.write("[]");
 		}
+		if (isPrimitive(def)) return this.write(renderPrimitiveTypeDef(def.config.type));
 	}
-	renderStructure(struct, asClass) {
+	renderStructure(struct, asClass, interfaceNode) {
 		this.blockln("{}");
 		const patterns = [];
 		const propsDefs = new Set();
@@ -309,6 +310,7 @@ var TypeRenderer = class TypeRenderer extends BaseRenderer {
 			this.writeln("static toJsonSchema: () => any");
 			if (!this.opts?.exampleData) this.writeln("/** @deprecated Example Data support is disabled. To enable, set `exampleData: true` in tsPlugin options. */");
 			this.writeln("static toExampleData?: () => any");
+			if (interfaceNode && this.hasDbTable(interfaceNode)) this.renderFlat(interfaceNode);
 		}
 		this.pop();
 	}
@@ -335,20 +337,20 @@ var TypeRenderer = class TypeRenderer extends BaseRenderer {
 					}
 					if (!firstParentProps && isStructure(fpDef)) firstParentProps = fpDef.props;
 				}
-				this.renderStructureFiltered(resolved, node.id, firstParentProps);
+				this.renderStructureFiltered(resolved, node.id, firstParentProps, node);
 			} else this.writeln("{}");
 		} else {
 			this.write(`class ${node.id} `);
 			const struct = node.getDefinition();
-			if (struct?.entity === "structure") this.renderStructure(struct, node.id);
+			if (struct?.entity === "structure") this.renderStructure(struct, node.id, node);
 else this.writeln("{}");
 		}
 		this.writeln();
 	}
 	/**
 	* Renders a structure block, optionally filtering out props that exist in a parent.
-	*/ renderStructureFiltered(struct, asClass, filterProps) {
-		if (!filterProps) return this.renderStructure(struct, asClass);
+	*/ renderStructureFiltered(struct, asClass, filterProps, interfaceNode) {
+		if (!filterProps) return this.renderStructure(struct, asClass, interfaceNode);
 		this.blockln("{}");
 		for (const prop of Array.from(struct.props.values())) {
 			if (filterProps.has(prop.id)) continue;
@@ -371,6 +373,7 @@ else this.writeln("{}");
 		this.writeln("static toJsonSchema: () => any");
 		if (!this.opts?.exampleData) this.writeln("/** @deprecated Example Data support is disabled. To enable, set `exampleData: true` in tsPlugin options. */");
 		this.writeln("static toExampleData?: () => any");
+		if (interfaceNode && this.hasDbTable(interfaceNode)) this.renderFlat(interfaceNode);
 		this.pop();
 	}
 	renderType(node) {
@@ -426,6 +429,50 @@ else if (isPrimitive(realDef)) typeDef = `TAtscriptTypeFinal<${name}>`;
 		this.writeln("const toExampleData: (() => any) | undefined");
 		this.popln();
 	}
+	/**
+	* Checks whether an interface has the `@db.table` annotation.
+	*
+	* NOTE: Only `@db.table` interfaces get the `__flat` static property.
+	* This is intentionally hardcoded — `__flat` exists solely to improve
+	* type-safety for filter expressions and `$select`/`$sort` operations
+	* in the DB layer. Non-DB interfaces have no use for dot-notation path types.
+	*/ hasDbTable(node) {
+		return !!node.annotations?.some((a) => a.name === "db.table");
+	}
+	/**
+	* Renders the `static __flat` property — a map of all dot-notation paths
+	* to their TypeScript value types.
+	*
+	* This enables type-safe autocomplete for filter keys and `$select`/`$sort`
+	* paths when using `AtscriptDbTable`. The `FlatOf<T>` utility type extracts
+	* this map at the type level.
+	*
+	* Special rendering rules:
+	* - **Intermediate paths** (structures, arrays of structures) → `never`
+	*   (prevents `$eq` comparisons, but allows `$select` and `$exists`)
+	* - **`@db.json` fields** → `string` (stored as serialized JSON in DB,
+	*   not individually queryable)
+	* - **Leaf fields** → their original TypeScript type
+	*/ renderFlat(node) {
+		const flatMap = flattenInterfaceNode(this.doc, node);
+		if (flatMap.size === 0) return;
+		this.write("static __flat: ");
+		this.blockln("{}");
+		for (const [path$1, descriptor] of flatMap) {
+			this.write(`"${escapeQuotes(path$1)}"`);
+			if (descriptor.optional) this.write("?");
+			this.write(": ");
+			if (descriptor.intermediate) this.writeln("never");
+else if (descriptor.dbJson) this.writeln("string");
+else {
+				const originalDef = descriptor.propNode?.getDefinition();
+				const defToRender = originalDef && !(isGroup(descriptor.def) && descriptor.def !== originalDef) ? originalDef : descriptor.def;
+				const renderedDef = this.renderTypeDefString(defToRender);
+				renderedDef.split("\n").forEach((l) => this.writeln(l));
+			}
+		}
+		this.pop();
+	}
 	phantomPropType(def) {
 		if (!def) return undefined;
 		if (isPrimitive(def) && def.config.type === "phantom") return def.id;

package/dist/utils.d.ts

@@ -48,7 +48,7 @@ interface TValidatorPluginContext {
  * @typeParam T - The annotated type definition.
  * @typeParam DataType - The TypeScript type that `validate` narrows to (auto-inferred).
  */
-declare class Validator<T extends TAtscriptAnnotatedType = TAtscriptAnnotatedType, DataType = TAtscriptDataType<T>> {
+declare class Validator<T extends TAtscriptAnnotatedType = TAtscriptAnnotatedType, DataType = TAtscriptDataType$1<T>> {
     protected readonly def: T;
     protected opts: TValidatorOptions;
     constructor(def: T, opts?: Partial<TValidatorOptions>);
@@ -159,7 +159,7 @@ type InferDataType<T> = T extends {
  * type Data = TAtscriptDataType<typeof MyInterface>
  * ```
  */
-type TAtscriptDataType<T extends TAtscriptAnnotatedType = TAtscriptAnnotatedType> = T extends {
+type TAtscriptDataType$1<T extends TAtscriptAnnotatedType = TAtscriptAnnotatedType> = T extends {
     type: {
         __dataType?: infer D;
     };
@@ -535,5 +535,16 @@ declare function serializeAnnotatedType(type: TAtscriptAnnotatedType, options?:
  */
 declare function deserializeAnnotatedType(data: TSerializedAnnotatedType): TAtscriptAnnotatedType;
 
+/**
+ * Extracts the flat dot-notation type map from an Atscript annotated type.
+ * If the type has a `__flat` static property (emitted for `@db.table` interfaces),
+ * returns that flat map. Otherwise falls back to `TAtscriptDataType<T>`.
+ *
+ * Use this for type-safe filters and selects with dot-notation field paths.
+ */
+type FlatOf<T> = T extends {
+    __flat: infer F;
+} ? F : TAtscriptDataType<T>;
+
 export { SERIALIZE_VERSION, Validator, ValidatorError, annotate, buildJsonSchema, cloneRefProp, createDataFromAnnotatedType, defineAnnotatedType, deserializeAnnotatedType, flattenAnnotatedType, forAnnotatedType, fromJsonSchema, isAnnotatedType, isAnnotatedTypeOfPrimitive, isPhantomType, mergeJsonSchemas, serializeAnnotatedType, throwFeatureDisabled };
-export type { InferDataType, TAnnotatedTypeHandle, TAtscriptAnnotatedType, TAtscriptAnnotatedTypeConstructor, TAtscriptDataType, TAtscriptTypeArray, TAtscriptTypeComplex, TAtscriptTypeDef, TAtscriptTypeFinal, TAtscriptTypeObject, TCreateDataOptions, TFlattenOptions, TJsonSchema, TMetadataMap, TProcessAnnotationContext, TSerializeOptions, TSerializedAnnotatedType, TSerializedAnnotatedTypeInner, TSerializedTypeArray, TSerializedTypeComplex, TSerializedTypeDef, TSerializedTypeFinal, TSerializedTypeObject, TValidatorOptions, TValidatorPlugin, TValidatorPluginContext, TValueResolver };
+export type { FlatOf, InferDataType, TAnnotatedTypeHandle, TAtscriptAnnotatedType, TAtscriptAnnotatedTypeConstructor, TAtscriptDataType$1 as TAtscriptDataType, TAtscriptTypeArray, TAtscriptTypeComplex, TAtscriptTypeDef, TAtscriptTypeFinal, TAtscriptTypeObject, TCreateDataOptions, TFlattenOptions, TJsonSchema, TMetadataMap, TProcessAnnotationContext, TSerializeOptions, TSerializedAnnotatedType, TSerializedAnnotatedTypeInner, TSerializedTypeArray, TSerializedTypeComplex, TSerializedTypeDef, TSerializedTypeFinal, TSerializedTypeObject, TValidatorOptions, TValidatorPlugin, TValidatorPluginContext, TValueResolver };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@atscript/typescript",
-  "version": "0.1.30",
+  "version": "0.1.31",
   "description": "Atscript: typescript-gen support.",
   "keywords": [
     "annotations",
@@ -64,7 +64,7 @@
     "vitest": "3.2.4"
   },
   "peerDependencies": {
-    "@atscript/core": "^0.1.30"
+    "@atscript/core": "^0.1.31"
   },
   "build": [
     {},