@atscript/ui 0.1.85 → 0.1.86

package/dist/index.cjs

@@ -14,6 +14,7 @@ const UI_FORM_ORDER = "ui.form.order";
 const UI_FORM_TYPE = "ui.form.type";
 const UI_FORM_COMPONENT = "ui.form.component";
 const UI_FORM_HIDDEN = "ui.form.hidden";
+const UI_FORM_PUSH_DOWN = "ui.form.pushDown";
 const UI_FORM_ATTR = "ui.form.attr";
 const UI_FORM_GRID_COL_SPAN = "ui.form.grid.colSpan";
 const UI_FORM_GRID_ROW_SPAN = "ui.form.grid.rowSpan";
@@ -290,10 +291,13 @@ const UI_TAGS = new Set([
 function createFormDef(type, opts) {
 	if (type.type.kind !== "object") {
 		const rootField = createFieldDef("", type);
+		const fields = [rootField];
 		return {
 			type,
 			rootField,
-			fields: [rootField],
+			fields,
+			mainFields: fields,
+			pushDownFields: [],
 			flatMap: /* @__PURE__ */ new Map()
 		};
 	}
@@ -326,12 +330,21 @@ function createFormDef(type, opts) {
 		type: "object",
 		phantom: false,
 		name: "",
-		allStatic: false
+		allStatic: false,
+		pushDown: false
 	};
+	let mainFields = fields;
+	const pushDownFields = [];
+	if (fields.some((f) => f.pushDown)) {
+		mainFields = [];
+		for (const f of fields) (f.pushDown ? pushDownFields : mainFields).push(f);
+	}
 	const def = {
 		type,
 		rootField,
 		fields,
+		mainFields,
+		pushDownFields,
 		flatMap
 	};
 	rootField.objectDef = def;
@@ -343,12 +356,14 @@ function createFieldDef(path, prop) {
 	const name = path.slice(path.lastIndexOf(".") + 1);
 	const allStatic = !hasComputedAnnotations(prop);
 	const uiType = getFieldMeta(prop, "ui.form.type") ?? getFieldMeta(prop, "ui.type");
+	const pushDown = getFieldMeta(prop, UI_FORM_PUSH_DOWN) !== void 0;
 	const base = {
 		path,
 		prop,
 		phantom: false,
 		name,
-		allStatic
+		allStatic,
+		pushDown
 	};
 	const customType = uiType;
 	if (kind === "array") {
@@ -385,7 +400,8 @@ function createFieldDef(path, prop) {
 			...v.itemField,
 			path,
 			name,
-			allStatic
+			allStatic,
+			pushDown
 		};
 		if (v?.def) return {
 			...base,

package/dist/index.d.cts

@@ -140,6 +140,13 @@ interface FormFieldDef {
   name: string;
   /** True when no `ui.fn.*` metadata keys exist. Vue perf flag. */
   allStatic: boolean;
+  /**
+   * `@ui.form.pushDown` — render this field below the submit button in its
+   * own grid, instead of in the main field grid above submit. Set on
+   * top-level form fields (typically secondary `ui.action` links). The field
+   * stays in `fields[]` for validation/data; only its render slot moves.
+   */
+  pushDown: boolean;
 }
 /**
  * Complete form definition — produced by createFormDef().
@@ -150,6 +157,15 @@ interface FormDef {
   /** Root field representing the entire form. For interface types this is `type='object'`; for single-type forms it is a leaf field. */
   rootField: FormFieldDef;
   fields: FormFieldDef[];
+  /**
+   * Render partition of `fields` by `@ui.form.pushDown`, precomputed once so
+   * the renderer never re-scans per frame. `mainFields` (above submit) plus
+   * `pushDownFields` (below submit) cover `fields` exactly once. In the common
+   * case nothing is pushed down: `mainFields === fields` (same ref) and
+   * `pushDownFields` is empty.
+   */
+  mainFields: FormFieldDef[];
+  pushDownFields: FormFieldDef[];
   flatMap: Map<string, TAtscriptAnnotatedType>;
 }
 /** One branch of a union type — used by union fields and union array items. */

package/dist/index.d.mts

@@ -140,6 +140,13 @@ interface FormFieldDef {
   name: string;
   /** True when no `ui.fn.*` metadata keys exist. Vue perf flag. */
   allStatic: boolean;
+  /**
+   * `@ui.form.pushDown` — render this field below the submit button in its
+   * own grid, instead of in the main field grid above submit. Set on
+   * top-level form fields (typically secondary `ui.action` links). The field
+   * stays in `fields[]` for validation/data; only its render slot moves.
+   */
+  pushDown: boolean;
 }
 /**
  * Complete form definition — produced by createFormDef().
@@ -150,6 +157,15 @@ interface FormDef {
   /** Root field representing the entire form. For interface types this is `type='object'`; for single-type forms it is a leaf field. */
   rootField: FormFieldDef;
   fields: FormFieldDef[];
+  /**
+   * Render partition of `fields` by `@ui.form.pushDown`, precomputed once so
+   * the renderer never re-scans per frame. `mainFields` (above submit) plus
+   * `pushDownFields` (below submit) cover `fields` exactly once. In the common
+   * case nothing is pushed down: `mainFields === fields` (same ref) and
+   * `pushDownFields` is empty.
+   */
+  mainFields: FormFieldDef[];
+  pushDownFields: FormFieldDef[];
   flatMap: Map<string, TAtscriptAnnotatedType>;
 }
 /** One branch of a union type — used by union fields and union array items. */

package/dist/index.mjs

@@ -13,6 +13,7 @@ const UI_FORM_ORDER = "ui.form.order";
 const UI_FORM_TYPE = "ui.form.type";
 const UI_FORM_COMPONENT = "ui.form.component";
 const UI_FORM_HIDDEN = "ui.form.hidden";
+const UI_FORM_PUSH_DOWN = "ui.form.pushDown";
 const UI_FORM_ATTR = "ui.form.attr";
 const UI_FORM_GRID_COL_SPAN = "ui.form.grid.colSpan";
 const UI_FORM_GRID_ROW_SPAN = "ui.form.grid.rowSpan";
@@ -289,10 +290,13 @@ const UI_TAGS = new Set([
 function createFormDef(type, opts) {
 	if (type.type.kind !== "object") {
 		const rootField = createFieldDef("", type);
+		const fields = [rootField];
 		return {
 			type,
 			rootField,
-			fields: [rootField],
+			fields,
+			mainFields: fields,
+			pushDownFields: [],
 			flatMap: /* @__PURE__ */ new Map()
 		};
 	}
@@ -325,12 +329,21 @@ function createFormDef(type, opts) {
 		type: "object",
 		phantom: false,
 		name: "",
-		allStatic: false
+		allStatic: false,
+		pushDown: false
 	};
+	let mainFields = fields;
+	const pushDownFields = [];
+	if (fields.some((f) => f.pushDown)) {
+		mainFields = [];
+		for (const f of fields) (f.pushDown ? pushDownFields : mainFields).push(f);
+	}
 	const def = {
 		type,
 		rootField,
 		fields,
+		mainFields,
+		pushDownFields,
 		flatMap
 	};
 	rootField.objectDef = def;
@@ -342,12 +355,14 @@ function createFieldDef(path, prop) {
 	const name = path.slice(path.lastIndexOf(".") + 1);
 	const allStatic = !hasComputedAnnotations(prop);
 	const uiType = getFieldMeta(prop, "ui.form.type") ?? getFieldMeta(prop, "ui.type");
+	const pushDown = getFieldMeta(prop, UI_FORM_PUSH_DOWN) !== void 0;
 	const base = {
 		path,
 		prop,
 		phantom: false,
 		name,
-		allStatic
+		allStatic,
+		pushDown
 	};
 	const customType = uiType;
 	if (kind === "array") {
@@ -384,7 +399,8 @@ function createFieldDef(path, prop) {
 			...v.itemField,
 			path,
 			name,
-			allStatic
+			allStatic,
+			pushDown
 		};
 		if (v?.def) return {
 			...base,

package/dist/plugin.cjs

@@ -244,6 +244,10 @@ const uiAnnotations = { ui: {
 				description: "Singular label, e.g. \"phone number\" for a `phones` field."
 			}
 		}) },
+		pushDown: new _atscript_core.AnnotationSpec({
+			description: "Render this field below the form's submit button instead of above it. Pushed-down fields collect into their own grid (same 12-column layout, `@ui.form.order`/`@ui.form.grid.*` honoured) that sits under the submit action. Typical use: a secondary `ui.action` link such as \"Already have an account? Sign in\" beneath a Sign-up button.\n\n**Example:**\n```atscript\n@ui.form.pushDown\n@ui.form.attr 'text', 'Already have an account?'\n@ui.form.attr 'align', 'center'\n@ui.form.action 'signin', 'Sign in'\nsigninAction: ui.action\n```\n",
+			nodeType: ["prop", "type"]
+		}),
 		action: new _atscript_core.AnnotationSpec({
 			description: "Form action button for this field.",
 			nodeType: ["prop", "type"],

package/dist/plugin.mjs

@@ -244,6 +244,10 @@ const uiAnnotations = { ui: {
 				description: "Singular label, e.g. \"phone number\" for a `phones` field."
 			}
 		}) },
+		pushDown: new AnnotationSpec({
+			description: "Render this field below the form's submit button instead of above it. Pushed-down fields collect into their own grid (same 12-column layout, `@ui.form.order`/`@ui.form.grid.*` honoured) that sits under the submit action. Typical use: a secondary `ui.action` link such as \"Already have an account? Sign in\" beneath a Sign-up button.\n\n**Example:**\n```atscript\n@ui.form.pushDown\n@ui.form.attr 'text', 'Already have an account?'\n@ui.form.attr 'align', 'center'\n@ui.form.action 'signin', 'Sign in'\nsigninAction: ui.action\n```\n",
+			nodeType: ["prop", "type"]
+		}),
 		action: new AnnotationSpec({
 			description: "Form action button for this field.",
 			nodeType: ["prop", "type"],

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@atscript/ui",
-  "version": "0.1.85",
+  "version": "0.1.86",
   "description": "Framework-agnostic runtime for form and table definitions from atscript annotated types",
   "keywords": [
     "annotations",