@atscript/core 0.1.13 → 0.1.15

package/dist/index.cjs

@@ -443,6 +443,11 @@ var SemanticPrimitiveNode = class SemanticPrimitiveNode extends SemanticNode {
 			});
 		}
 		if (this.type === "string") {
+			if (this.config.expect?.required === true) this.annotations.push({
+				name: "meta.required",
+				token: dummyToken,
+				args: []
+			});
 			if (typeof this.config.expect?.pattern !== "undefined") {
 				const patterns = Array.isArray(this.config.expect.pattern) ? this.config.expect.pattern : [this.config.expect.pattern];
 				for (const p of patterns) {
@@ -473,6 +478,13 @@ var SemanticPrimitiveNode = class SemanticPrimitiveNode extends SemanticNode {
 				args: []
 			});
 		}
+		if (this.type === "boolean") {
+			if (this.config.expect?.required === true) this.annotations.push({
+				name: "meta.required",
+				token: dummyToken,
+				args: []
+			});
+		}
 	}
 	get key() {
 		return this.parentKey ? `${this.parentKey}.${this._id}` : this._id;
@@ -967,13 +979,13 @@ async function bundleTsConfig(configFile, forceFormat) {
 		input: configFile,
 		platform: "node",
 		resolve: { mainFields: ["main"] },
-		define: {
+		transform: { define: {
 			"__dirname": dirnameVarName,
 			"__filename": filenameVarName,
 			"import.meta.url": importMetaUrlVarName,
 			"import.meta.dirname": dirnameVarName,
 			"import.meta.filename": filenameVarName
-		},
+		} },
 		treeshake: false,
 		external: [/^[\w@][^:]/u],
 		plugins: [{
@@ -3073,6 +3085,16 @@ const metaAnnotations = {
 		nodeType: ["prop"],
 		multiple: false
 	}),
+	required: new AnnotationSpec({
+		description: "Marks a field as required for form validation. For strings: must contain at least one non-whitespace character. For booleans: must be true.\n\n**Example:**```atscript@meta.requiredname: string\n@meta.required \"You must accept the terms\"agreed: boolean```",
+		defType: ["string", "boolean"],
+		argument: [{
+			name: "message",
+			optional: true,
+			type: "string",
+			description: "Optional error message to display if the validation fails."
+		}]
+	}),
 	isKey: new AnnotationSpec({
 		description: "Marks a **key field** inside an array. This annotation is used to identify unique fields within an array that can be used as **lookup keys**.\n\n\n\n**Example:**\n```atscript\nexport interface User {\n  id: string\n  profiles: {\n    @meta.isKey\n    profileId: string\n    name: string\n  }[]\n}\n```\n",
 		nodeType: ["prop"],
@@ -3162,6 +3184,10 @@ const primitives = {
 					pattern: /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i,
 					message: "Invalid UUID format."
 				}
+			},
+			required: {
+				documentation: "Non-empty string that contains at least one non-whitespace character.",
+				expect: { required: true }
 			}
 		}
 	},
@@ -3193,6 +3219,10 @@ const primitives = {
 		type: "boolean",
 		documentation: "Represents true/false values.",
 		extensions: {
+			required: {
+				documentation: "Boolean that must be true. Useful for checkboxes like \"accept terms\".",
+				expect: { required: true }
+			},
 			true: { documentation: "Represents a true value." },
 			false: { documentation: "Represents a false value." }
 		}

package/dist/index.d.ts

@@ -239,6 +239,7 @@ interface TPrimitiveBaseConfig {
         minLength?: number;
         maxLength?: number;
         pattern?: string | RegExp | (string | RegExp)[];
+        required?: boolean;
         message?: string;
     };
 }

package/dist/index.mjs

@@ -419,6 +419,11 @@ var SemanticPrimitiveNode = class SemanticPrimitiveNode extends SemanticNode {
 			});
 		}
 		if (this.type === "string") {
+			if (this.config.expect?.required === true) this.annotations.push({
+				name: "meta.required",
+				token: dummyToken,
+				args: []
+			});
 			if (typeof this.config.expect?.pattern !== "undefined") {
 				const patterns = Array.isArray(this.config.expect.pattern) ? this.config.expect.pattern : [this.config.expect.pattern];
 				for (const p of patterns) {
@@ -449,6 +454,13 @@ var SemanticPrimitiveNode = class SemanticPrimitiveNode extends SemanticNode {
 				args: []
 			});
 		}
+		if (this.type === "boolean") {
+			if (this.config.expect?.required === true) this.annotations.push({
+				name: "meta.required",
+				token: dummyToken,
+				args: []
+			});
+		}
 	}
 	get key() {
 		return this.parentKey ? `${this.parentKey}.${this._id}` : this._id;
@@ -943,13 +955,13 @@ async function bundleTsConfig(configFile, forceFormat) {
 		input: configFile,
 		platform: "node",
 		resolve: { mainFields: ["main"] },
-		define: {
+		transform: { define: {
 			"__dirname": dirnameVarName,
 			"__filename": filenameVarName,
 			"import.meta.url": importMetaUrlVarName,
 			"import.meta.dirname": dirnameVarName,
 			"import.meta.filename": filenameVarName
-		},
+		} },
 		treeshake: false,
 		external: [/^[\w@][^:]/u],
 		plugins: [{
@@ -3049,6 +3061,16 @@ const metaAnnotations = {
 		nodeType: ["prop"],
 		multiple: false
 	}),
+	required: new AnnotationSpec({
+		description: "Marks a field as required for form validation. For strings: must contain at least one non-whitespace character. For booleans: must be true.\n\n**Example:**```atscript@meta.requiredname: string\n@meta.required \"You must accept the terms\"agreed: boolean```",
+		defType: ["string", "boolean"],
+		argument: [{
+			name: "message",
+			optional: true,
+			type: "string",
+			description: "Optional error message to display if the validation fails."
+		}]
+	}),
 	isKey: new AnnotationSpec({
 		description: "Marks a **key field** inside an array. This annotation is used to identify unique fields within an array that can be used as **lookup keys**.\n\n\n\n**Example:**\n```atscript\nexport interface User {\n  id: string\n  profiles: {\n    @meta.isKey\n    profileId: string\n    name: string\n  }[]\n}\n```\n",
 		nodeType: ["prop"],
@@ -3138,6 +3160,10 @@ const primitives = {
 					pattern: /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i,
 					message: "Invalid UUID format."
 				}
+			},
+			required: {
+				documentation: "Non-empty string that contains at least one non-whitespace character.",
+				expect: { required: true }
 			}
 		}
 	},
@@ -3169,6 +3195,10 @@ const primitives = {
 		type: "boolean",
 		documentation: "Represents true/false values.",
 		extensions: {
+			required: {
+				documentation: "Boolean that must be true. Useful for checkboxes like \"accept terms\".",
+				expect: { required: true }
+			},
 			true: { documentation: "Represents a true value." },
 			false: { documentation: "Represents a false value." }
 		}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@atscript/core",
-  "version": "0.1.13",
+  "version": "0.1.15",
   "description": "Core library for Atscript parsing and file generation.",
   "type": "module",
   "main": "dist/index.mjs",