@stonecrop/desktop 0.13.8 → 0.13.9

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@stonecrop/desktop",
-  "version": "0.13.8",
+  "version": "0.13.9",
   "license": "MIT",
   "type": "module",
   "author": {
@@ -32,11 +32,11 @@
     "**/*.css"
   ],
   "dependencies": {
-    "@stonecrop/aform": "0.13.8",
-    "@stonecrop/atable": "0.13.8",
-    "@stonecrop/stonecrop": "0.13.8",
-    "@stonecrop/themes": "0.13.8",
-    "@stonecrop/schema": "0.13.8"
+    "@stonecrop/aform": "0.13.9",
+    "@stonecrop/atable": "0.13.9",
+    "@stonecrop/schema": "0.13.9",
+    "@stonecrop/stonecrop": "0.13.9",
+    "@stonecrop/themes": "0.13.9"
   },
   "peerDependencies": {
     "vue": "^3.5.33"

package/src/components/Desktop.vue

@@ -32,9 +32,9 @@
 
 <script setup lang="ts">
 import { useStonecrop } from '@stonecrop/stonecrop'
-import { AForm, type AFormLinkNavigator, type SchemaTypes } from '@stonecrop/aform'
+import { AForm, type AFormLinkNavigator, type ResolvedField, type ResolvedTable } from '@stonecrop/aform'
 import type { ColumnSchema } from '@stonecrop/schema'
-import { computed, onMounted, provide, ref, unref, watch } from 'vue'
+import { computed, onMounted, onUnmounted, provide, ref, unref, watch } from 'vue'
 
 import ActionSet from './ActionSet.vue'
 import SheetNav from './SheetNav.vue'
@@ -49,7 +49,12 @@ import type {
 	LoadRecordEventPayload,
 } from '../types'
 
-const props = defineProps<{
+const {
+	availableDoctypes = [],
+	routeAdapter,
+	confirmFn,
+	recordIdField,
+} = defineProps<{
 	availableDoctypes?: string[]
 	/**
 	 * Pluggable router adapter. When provided, Desktop uses these functions for all
@@ -98,19 +103,45 @@ const emit = defineEmits<{
 	'load-record': [payload: LoadRecordEventPayload]
 }>()
 
-const { availableDoctypes = [] } = props
-
 const { stonecrop } = useStonecrop()
 
 // State
 const loading = ref(false)
 const commandPaletteOpen = ref(false)
 
-// HST-based form data management - field triggers are handled automatically by HST
-
-// Computed property that reads from HST store for reactive form data
+// Form/list data management — each view produces a different data shape.
+// List views (doctypes, records) return table row data keyed by fieldname.
+// Record view returns HST record fields for two-way binding.
 const currentViewData = computed<Record<string, any>>({
 	get() {
+		// Doctypes list — rows come from availableDoctypes prop (reactive via availableDoctypes)
+		if (currentView.value === 'doctypes') {
+			return {
+				doctypes_table:
+					availableDoctypes?.map(doctype => ({
+						id: doctype,
+						doctype,
+						display_name: formatDoctypeName(doctype),
+						record_count: getRecordCount(doctype),
+						actions: 'View Records',
+					})) ?? [],
+			}
+		}
+
+		// Records list — rows come from HST store (reactive because HST is Vue reactive())
+		if (currentView.value === 'records') {
+			const idField = recordIdField || 'id'
+			return {
+				records_table: getRecords().map(record =>
+					Object.assign({}, record, {
+						id: record[idField] || record.id || '',
+						actions: 'Edit | Delete',
+					})
+				),
+			}
+		}
+
+		// Record form — read single record from HST
 		if (!stonecrop.value || !currentDoctype.value || !currentRecordId.value) {
 			return {}
 		}
@@ -128,14 +159,9 @@ const currentViewData = computed<Record<string, any>>({
 			const doctype = stonecrop.value.registry.registry[currentDoctype.value]
 			if (doctype) {
 				for (const field of doctype.getSchemaArray()) {
-					if (
-						'fieldtype' in field &&
-						field.fieldtype === 'Fieldset' &&
-						'schema' in field &&
-						Array.isArray(field.schema)
-					) {
+					if (field.kind === 'fieldset') {
 						const nested: Record<string, any> = {}
-						for (const child of field.schema as any[]) {
+						for (const child of field.schema) {
 							if (child.fieldname) nested[child.fieldname] = flat[child.fieldname]
 						}
 						flat[field.fieldname] = nested
@@ -148,6 +174,8 @@ const currentViewData = computed<Record<string, any>>({
 		}
 	},
 	set(newData: Record<string, any>) {
+		// List views are read-only from AForm's perspective — HST writes only apply to record form
+		if (currentView.value !== 'record') return
 		if (!stonecrop.value || !currentDoctype.value || !currentRecordId.value) {
 			return
 		}
@@ -159,7 +187,7 @@ const currentViewData = computed<Record<string, any>>({
 			const fieldsetNames = new Set<string>()
 			if (doctype) {
 				for (const field of doctype.getSchemaArray()) {
-					if ('fieldtype' in field && field.fieldtype === 'Fieldset') {
+					if (field.kind === 'fieldset') {
 						fieldsetNames.add(field.fieldname)
 					}
 				}
@@ -182,9 +210,12 @@ const currentViewData = computed<Record<string, any>>({
 				Object.assign(flatData, nestedValue)
 			}
 
-			// Only update fields that actually changed to avoid triggering actions for unchanged fields
+			// Only update fields that actually changed. Never write undefined — AForm may emit
+			// schema fields absent from the record as undefined; writing them would silently
+			// clear values that exist in HST. Explicit null is allowed (intentional clear).
 			const hstStore = stonecrop.value.getStore()
 			for (const [fieldname, value] of Object.entries(flatData)) {
+				if (value === undefined) continue
 				const fieldPath = `${currentDoctype.value}.${currentRecordId.value}.${fieldname}`
 				const currentValue = hstStore.has(fieldPath) ? hstStore.get(fieldPath) : undefined
 				if (currentValue !== value) {
@@ -199,10 +230,10 @@ const currentViewData = computed<Record<string, any>>({
 
 // Computed properties for current route context.
 // When a routeAdapter is provided it takes full precedence over the registry's internal router.
-const route = computed(() => (props.routeAdapter ? null : unref(stonecrop.value?.registry.router?.currentRoute)))
-const router = computed(() => (props.routeAdapter ? null : stonecrop.value?.registry.router))
+const route = computed(() => (routeAdapter ? null : unref(stonecrop.value?.registry.router?.currentRoute)))
+const router = computed(() => (routeAdapter ? null : stonecrop.value?.registry.router))
 const currentDoctype = computed(() => {
-	if (props.routeAdapter) return props.routeAdapter.getCurrentDoctype()
+	if (routeAdapter) return routeAdapter.getCurrentDoctype()
 	if (!route.value) return ''
 
 	// First check if we have actualDoctype in meta (from registered routes)
@@ -226,7 +257,7 @@ const currentDoctype = computed(() => {
 
 // The route doctype for display and navigation (e.g., 'todo')
 const routeDoctype = computed(() => {
-	if (props.routeAdapter) return props.routeAdapter.getCurrentDoctype()
+	if (routeAdapter) return routeAdapter.getCurrentDoctype()
 	if (!route.value) return ''
 
 	// Check route meta first
@@ -249,7 +280,7 @@ const routeDoctype = computed(() => {
 })
 
 const currentRecordId = computed(() => {
-	if (props.routeAdapter) return props.routeAdapter.getCurrentRecordId()
+	if (routeAdapter) return routeAdapter.getCurrentRecordId()
 	if (!route.value) return ''
 
 	// For named routes, use params.recordId
@@ -269,7 +300,7 @@ const isNewRecord = computed(() => currentRecordId.value?.startsWith('new-'))
 
 // Determine current view based on route
 const currentView = computed(() => {
-	if (props.routeAdapter) return props.routeAdapter.getCurrentView()
+	if (routeAdapter) return routeAdapter.getCurrentView()
 	if (!route.value) {
 		return 'doctypes'
 	}
@@ -468,8 +499,8 @@ const getRecordCount = (doctype: string): number => {
 // or falls back to the registry's Vue Router instance.
 const doNavigate = async (target: NavigationTarget) => {
 	emit('navigate', target)
-	if (props.routeAdapter) {
-		await props.routeAdapter.navigate(target)
+	if (routeAdapter) {
+		await routeAdapter.navigate(target)
 	} else {
 		if (target.view === 'doctypes') {
 			await router.value?.push('/')
@@ -499,11 +530,11 @@ const createNewRecord = async () => {
 // Flatten Fieldset containers into individual columns for list/table views.
 // A Fieldset groups form fields visually but has no DB column; its children are the
 // actual data fields and should appear as flat columns in a list view.
-const flattenFieldsets = (fields: SchemaTypes[]): SchemaTypes[] => {
-	const result: SchemaTypes[] = []
+const flattenFieldsets = (fields: ResolvedField[]): ResolvedField[] => {
+	const result: ResolvedField[] = []
 	for (const field of fields) {
-		if ('fieldtype' in field && field.fieldtype === 'Fieldset' && 'schema' in field && Array.isArray(field.schema)) {
-			result.push(...flattenFieldsets(field.schema as SchemaTypes[]))
+		if (field.kind === 'fieldset') {
+			result.push(...flattenFieldsets(field.schema))
 		} else {
 			result.push(field)
 		}
@@ -512,65 +543,55 @@ const flattenFieldsets = (fields: SchemaTypes[]): SchemaTypes[] => {
 }
 
 // Schema generator functions - moved here to be available to computed properties
-const getDoctypesSchema = (): SchemaTypes[] => {
-	if (!availableDoctypes.length) return []
-
-	const rows = availableDoctypes.map(doctype => ({
-		id: doctype,
-		doctype,
-		display_name: formatDoctypeName(doctype),
-		record_count: getRecordCount(doctype),
-		actions: 'View Records',
-	}))
+const getDoctypesSchema = (): ResolvedField[] => {
+	if (!availableDoctypes?.length) return []
 
 	return [
 		{
+			kind: 'table' as const,
 			fieldname: 'doctypes_table',
 			component: 'ATable',
-			columns: [
+			label: 'Doctypes',
+			schema: [
 				{
+					fieldname: 'doctype',
 					label: 'Doctype',
-					name: 'doctype',
 					fieldtype: 'Data',
-					align: 'left',
+					align: 'left' as const,
 					edit: false,
 					width: '20ch',
 				},
 				{
+					fieldname: 'display_name',
 					label: 'Name',
-					name: 'display_name',
 					fieldtype: 'Data',
-					align: 'left',
+					align: 'left' as const,
 					edit: false,
 					width: '30ch',
 				},
 				{
+					fieldname: 'record_count',
 					label: 'Records',
-					name: 'record_count',
 					fieldtype: 'Int',
-					align: 'center',
+					align: 'center' as const,
 					edit: false,
 					width: '15ch',
 				},
 				{
+					fieldname: 'actions',
 					label: 'Actions',
-					name: 'actions',
 					fieldtype: 'Data',
-					align: 'center',
+					align: 'center' as const,
 					edit: false,
 					width: '20ch',
 				},
 			],
-			config: {
-				view: 'list',
-				fullWidth: true,
-			},
-			rows,
-		},
+			config: { view: 'list' as const, fullWidth: true },
+		} satisfies ResolvedTable,
 	]
 }
 
-const getRecordsSchema = (): SchemaTypes[] => {
+const getRecordsSchema = (): ResolvedField[] => {
 	if (!currentDoctype.value) return []
 	if (!stonecrop.value) return []
 
@@ -584,35 +605,21 @@ const getRecordsSchema = (): SchemaTypes[] => {
 	// If no schema is available, let the template fallback handle the loading state
 	if (schema.length === 0) return []
 
-	const records = getRecords()
-	const idField = props.recordIdField || 'id'
-
-	const rows = records.map(record =>
-		Object.assign({}, record, {
-			id: record[idField] || record.id || '',
-			actions: 'Edit | Delete',
-		})
-	)
-
 	return [
 		{
+			kind: 'table' as const,
 			fieldname: 'records_table',
 			component: 'ATable',
-			kind: 'table',
 			schema: [
 				...(flattenFieldsets(schema) as ColumnSchema[]),
 				{ fieldname: 'actions', label: 'Actions', fieldtype: 'Data' },
 			],
-			config: {
-				view: 'list',
-				fullWidth: true,
-			},
-			rows,
-		},
+			config: { view: 'list' as const, fullWidth: true },
+		} satisfies ResolvedTable,
 	]
 }
 
-const getRecordFormSchema = (): SchemaTypes[] => {
+const getRecordFormSchema = (): ResolvedField[] => {
 	if (!currentDoctype.value) return []
 	if (!stonecrop.value) return []
 
@@ -674,8 +681,8 @@ const handleDelete = async (recordId?: string) => {
 	const targetRecordId = recordId || currentRecordId.value
 	if (!targetRecordId) return
 
-	const confirmed = props.confirmFn
-		? await props.confirmFn('Are you sure you want to delete this record?')
+	const confirmed = confirmFn
+		? await confirmFn('Are you sure you want to delete this record?')
 		: confirm('Are you sure you want to delete this record?')
 
 	if (confirmed) {
@@ -703,7 +710,7 @@ const getRecordIdFromRow = (rowElement: HTMLTableRowElement): string | null => {
 	const record = records[rowIndex]
 	if (!record) return null
 
-	const idField = props.recordIdField || 'id'
+	const idField = recordIdField || 'id'
 	return record[idField] || record.id || null
 }
 
@@ -834,25 +841,21 @@ provide('aformLinkResolver', async (doctypeSlug: string, id: string): Promise<st
 	}
 })
 
-onMounted(() => {
-	// Add keyboard shortcuts
-	const handleKeydown = (event: KeyboardEvent) => {
-		// Ctrl+K or Cmd+K to open command palette
-		if ((event.ctrlKey || event.metaKey) && event.key === 'k') {
-			event.preventDefault()
-			commandPaletteOpen.value = true
-		}
-		// Escape to close command palette
-		if (event.key === 'Escape' && commandPaletteOpen.value) {
-			commandPaletteOpen.value = false
-		}
+const handleKeydown = (event: KeyboardEvent) => {
+	if ((event.ctrlKey || event.metaKey) && event.key === 'k') {
+		event.preventDefault()
+		commandPaletteOpen.value = true
+	}
+	if (event.key === 'Escape' && commandPaletteOpen.value) {
+		commandPaletteOpen.value = false
 	}
+}
 
+onMounted(() => {
 	document.addEventListener('keydown', handleKeydown)
+})
 
-	// Cleanup event listener on unmount
-	return () => {
-		document.removeEventListener('keydown', handleKeydown)
-	}
+onUnmounted(() => {
+	document.removeEventListener('keydown', handleKeydown)
 })
 </script>