@atscript/ui 0.1.71 → 0.1.73

package/dist/index.cjs

@@ -282,8 +282,12 @@ const UI_TAGS = new Set([
 * - **Object types** (`kind === 'object'`): produces an object root with nested fields.
 * - **Non-object types** (primitive, array, union, etc.): produces a single leaf root field
 *   with `path: ''`.
+*
+* @param opts.versionColumn - Name of a server-managed OCC version column to
+*   exclude from `fields[]` (it stays in `flatMap` so the wire payload is
+*   unchanged). Root-table concept; not propagated into nested recursive calls.
 */
-function createFormDef(type) {
+function createFormDef(type, opts) {
 	if (type.type.kind !== "object") {
 		const rootField = createFieldDef("", type);
 		return {
@@ -299,6 +303,7 @@ function createFormDef(type) {
 	const structuredPrefixes = /* @__PURE__ */ new Set();
 	for (const [path, prop] of flatMap.entries()) {
 		if (path === "") continue;
+		if (path === opts?.versionColumn) continue;
 		if (isChildOfStructured(path, structuredPrefixes)) continue;
 		const originalProp = resolveOriginalProp(objectType, path) ?? prop;
 		const kind = originalProp.type.kind;
@@ -687,12 +692,14 @@ function resetValueHelpCache() {
 }
 function buildResolved(url, meta, targetType) {
 	const objectType = targetType.type.kind === "object" ? targetType.type : void 0;
+	const versionColumn = meta.versionColumn;
 	const primaryKeys = [];
 	let labelField;
 	let descrField;
 	const attrFields = [];
 	let firstStringField;
 	if (objectType) for (const [name, fieldProp] of objectType.props) {
+		if (name === versionColumn) continue;
 		const isPK = fieldProp.metadata.has(META_ID);
 		if (isPK) primaryKeys.push(name);
 		if (fieldProp.metadata.has("ui.dict.label")) labelField = name;
@@ -705,6 +712,7 @@ function buildResolved(url, meta, targetType) {
 	const filterableFields = [];
 	const sortableFields = [];
 	if (meta.fields) for (const [name, fm] of Object.entries(meta.fields)) {
+		if (name === versionColumn) continue;
 		if (fm?.filterable) filterableFields.push(name);
 		if (fm?.sortable) sortableFields.push(name);
 	}
@@ -1375,6 +1383,7 @@ function createTableDef(meta, preDeserializedType) {
 	const columns = [];
 	for (const [path, prop] of flatMap.entries()) {
 		if (path === "") continue;
+		if (path === meta.versionColumn) continue;
 		if (!(path in meta.fields)) {
 			const kind = prop.type.kind;
 			if (path.includes(".") || kind === "object" || kind === "array") continue;
@@ -1412,6 +1421,7 @@ function createTableDef(meta, preDeserializedType) {
 		flatMap,
 		primaryKeys: meta.primaryKeys,
 		preferredId: meta.preferredId ?? meta.primaryKeys,
+		versionColumn: meta.versionColumn,
 		crud,
 		canRemove: "remove" in crud,
 		actions,

package/dist/index.d.cts

@@ -203,8 +203,14 @@ declare function isTupleField(field: FormFieldDef): field is FormTupleFieldDef;
  * - **Object types** (`kind === 'object'`): produces an object root with nested fields.
  * - **Non-object types** (primitive, array, union, etc.): produces a single leaf root field
  *   with `path: ''`.
+ *
+ * @param opts.versionColumn - Name of a server-managed OCC version column to
+ *   exclude from `fields[]` (it stays in `flatMap` so the wire payload is
+ *   unchanged). Root-table concept; not propagated into nested recursive calls.
  */
-declare function createFormDef(type: TAtscriptAnnotatedType): FormDef;
+declare function createFormDef(type: TAtscriptAnnotatedType, opts?: {
+  versionColumn?: string;
+}): FormDef;
 /**
  * Builds union variant definitions from a union annotated type.
  * Iterates top-level items directly — one variant per item.
@@ -673,6 +679,15 @@ interface MetaResponse {
    * construction for action POSTs and `'navigate'` URL `$1` substitution.
    */
   preferredId: string[];
+  /**
+   * Server-managed OCC column name (from `@db.column.version`). When present,
+   * names a normal `int` field that ships with rows like any other column.
+   * Consumers MUST keep the field's value in update payloads — the server
+   * auto-lifts it to `$cas` to detect concurrent writes — but MUST NOT render
+   * it as a user-facing column, filter, or sorter. `createTableDef` skips it
+   * from the generated `columns[]` array on this basis.
+   */
+  versionColumn?: string;
   crud: TCrudPermissions$1;
   actions: TDbActionInfo$1[];
   relations: RelationInfo[];
@@ -709,6 +724,8 @@ interface TableDef {
   primaryKeys: string[];
   /** Preferred row identifier — see `MetaResponse.preferredId`. */
   preferredId: string[];
+  /** Server-managed OCC column name — see `MetaResponse.versionColumn`. */
+  versionColumn?: string;
   /** Per-op CRUD permissions advertised in `/meta`. Key absent → denied. */
   crud: TCrudPermissions$1;
   canRemove: boolean;

package/dist/index.d.mts

@@ -203,8 +203,14 @@ declare function isTupleField(field: FormFieldDef): field is FormTupleFieldDef;
  * - **Object types** (`kind === 'object'`): produces an object root with nested fields.
  * - **Non-object types** (primitive, array, union, etc.): produces a single leaf root field
  *   with `path: ''`.
+ *
+ * @param opts.versionColumn - Name of a server-managed OCC version column to
+ *   exclude from `fields[]` (it stays in `flatMap` so the wire payload is
+ *   unchanged). Root-table concept; not propagated into nested recursive calls.
  */
-declare function createFormDef(type: TAtscriptAnnotatedType): FormDef;
+declare function createFormDef(type: TAtscriptAnnotatedType, opts?: {
+  versionColumn?: string;
+}): FormDef;
 /**
  * Builds union variant definitions from a union annotated type.
  * Iterates top-level items directly — one variant per item.
@@ -673,6 +679,15 @@ interface MetaResponse {
    * construction for action POSTs and `'navigate'` URL `$1` substitution.
    */
   preferredId: string[];
+  /**
+   * Server-managed OCC column name (from `@db.column.version`). When present,
+   * names a normal `int` field that ships with rows like any other column.
+   * Consumers MUST keep the field's value in update payloads — the server
+   * auto-lifts it to `$cas` to detect concurrent writes — but MUST NOT render
+   * it as a user-facing column, filter, or sorter. `createTableDef` skips it
+   * from the generated `columns[]` array on this basis.
+   */
+  versionColumn?: string;
   crud: TCrudPermissions$1;
   actions: TDbActionInfo$1[];
   relations: RelationInfo[];
@@ -709,6 +724,8 @@ interface TableDef {
   primaryKeys: string[];
   /** Preferred row identifier — see `MetaResponse.preferredId`. */
   preferredId: string[];
+  /** Server-managed OCC column name — see `MetaResponse.versionColumn`. */
+  versionColumn?: string;
   /** Per-op CRUD permissions advertised in `/meta`. Key absent → denied. */
   crud: TCrudPermissions$1;
   canRemove: boolean;

package/dist/index.mjs

@@ -281,8 +281,12 @@ const UI_TAGS = new Set([
 * - **Object types** (`kind === 'object'`): produces an object root with nested fields.
 * - **Non-object types** (primitive, array, union, etc.): produces a single leaf root field
 *   with `path: ''`.
+*
+* @param opts.versionColumn - Name of a server-managed OCC version column to
+*   exclude from `fields[]` (it stays in `flatMap` so the wire payload is
+*   unchanged). Root-table concept; not propagated into nested recursive calls.
 */
-function createFormDef(type) {
+function createFormDef(type, opts) {
 	if (type.type.kind !== "object") {
 		const rootField = createFieldDef("", type);
 		return {
@@ -298,6 +302,7 @@ function createFormDef(type) {
 	const structuredPrefixes = /* @__PURE__ */ new Set();
 	for (const [path, prop] of flatMap.entries()) {
 		if (path === "") continue;
+		if (path === opts?.versionColumn) continue;
 		if (isChildOfStructured(path, structuredPrefixes)) continue;
 		const originalProp = resolveOriginalProp(objectType, path) ?? prop;
 		const kind = originalProp.type.kind;
@@ -686,12 +691,14 @@ function resetValueHelpCache() {
 }
 function buildResolved(url, meta, targetType) {
 	const objectType = targetType.type.kind === "object" ? targetType.type : void 0;
+	const versionColumn = meta.versionColumn;
 	const primaryKeys = [];
 	let labelField;
 	let descrField;
 	const attrFields = [];
 	let firstStringField;
 	if (objectType) for (const [name, fieldProp] of objectType.props) {
+		if (name === versionColumn) continue;
 		const isPK = fieldProp.metadata.has(META_ID);
 		if (isPK) primaryKeys.push(name);
 		if (fieldProp.metadata.has("ui.dict.label")) labelField = name;
@@ -704,6 +711,7 @@ function buildResolved(url, meta, targetType) {
 	const filterableFields = [];
 	const sortableFields = [];
 	if (meta.fields) for (const [name, fm] of Object.entries(meta.fields)) {
+		if (name === versionColumn) continue;
 		if (fm?.filterable) filterableFields.push(name);
 		if (fm?.sortable) sortableFields.push(name);
 	}
@@ -1374,6 +1382,7 @@ function createTableDef(meta, preDeserializedType) {
 	const columns = [];
 	for (const [path, prop] of flatMap.entries()) {
 		if (path === "") continue;
+		if (path === meta.versionColumn) continue;
 		if (!(path in meta.fields)) {
 			const kind = prop.type.kind;
 			if (path.includes(".") || kind === "object" || kind === "array") continue;
@@ -1411,6 +1420,7 @@ function createTableDef(meta, preDeserializedType) {
 		flatMap,
 		primaryKeys: meta.primaryKeys,
 		preferredId: meta.preferredId ?? meta.primaryKeys,
+		versionColumn: meta.versionColumn,
 		crud,
 		canRemove: "remove" in crud,
 		actions,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@atscript/ui",
-  "version": "0.1.71",
+  "version": "0.1.73",
   "description": "Framework-agnostic runtime for form and table definitions from atscript annotated types",
   "keywords": [
     "annotations",
@@ -46,18 +46,18 @@
     "access": "public"
   },
   "dependencies": {
-    "@atscript/db-client": "^0.1.82"
+    "@atscript/db-client": "^0.1.85"
   },
   "devDependencies": {
-    "@atscript/core": "^0.1.58",
-    "@atscript/db": "^0.1.82",
-    "@atscript/typescript": "^0.1.58",
-    "unplugin-atscript": "^0.1.58",
+    "@atscript/core": "^0.1.59",
+    "@atscript/db": "^0.1.85",
+    "@atscript/typescript": "^0.1.59",
+    "unplugin-atscript": "^0.1.59",
     "vitest": "npm:@voidzero-dev/vite-plus-test@0.1.14"
   },
   "peerDependencies": {
-    "@atscript/core": "^0.1.58",
-    "@atscript/typescript": "^0.1.58"
+    "@atscript/core": "^0.1.59",
+    "@atscript/typescript": "^0.1.59"
   },
   "scripts": {
     "build": "vp pack",