@stonecrop/nuxt 0.13.12 → 0.14.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@stonecrop/nuxt",
-  "version": "0.13.12",
+  "version": "0.14.0",
   "description": "Nuxt module for Stonecrop",
   "license": "MIT",
   "type": "module",
@@ -38,45 +38,53 @@
   ],
   "dependencies": {
     "@nuxt/kit": "^4.4.4",
+    "h3": "^1.15.11",
     "pinia": "^3.0.4",
-    "citty": "^0.2.1",
-    "consola": "^3.4.0",
-    "jiti": "^2.4.2",
+    "citty": "^0.2.2",
+    "consola": "^3.4.2",
+    "jiti": "^2.7.0",
     "pathe": "^2.0.3",
     "prompts": "^2.4.2",
-    "@stonecrop/aform": "0.13.12",
-    "@stonecrop/atable": "0.13.12",
-    "@stonecrop/graphql-middleware": "0.13.12",
-    "@stonecrop/casl-middleware": "0.13.12",
-    "@stonecrop/node-editor": "0.13.12",
-    "@stonecrop/schema": "0.13.12",
-    "@stonecrop/nuxt-grafserv": "0.13.12",
-    "@stonecrop/stonecrop": "0.13.12"
+    "@stonecrop/aform": "0.14.0",
+    "@stonecrop/atable": "0.14.0",
+    "@stonecrop/desktop": "0.14.0",
+    "@stonecrop/code-editor": "0.14.0",
+    "@stonecrop/casl-middleware": "0.14.0",
+    "@stonecrop/graphql-client": "0.14.0",
+    "@stonecrop/graphql-middleware": "0.14.0",
+    "@stonecrop/node-editor": "0.14.0",
+    "@stonecrop/nuxt-grafserv": "0.14.0",
+    "@stonecrop/schema": "0.14.0",
+    "@stonecrop/stonecrop": "0.14.0",
+    "@stonecrop/themes": "0.14.0"
   },
   "devDependencies": {
     "@eslint/js": "^10.0.1",
     "@nuxt/devtools": "^3.2.4",
-    "@nuxt/eslint-config": "^1.15.2",
-    "@nuxt/eslint": "1.15.2",
+    "@nuxt/eslint-config": "^1.16.0",
+    "@nuxt/eslint": "1.16.0",
     "@nuxt/module-builder": "^1.0.2",
-    "@nuxt/schema": "^4.4.4",
+    "@nuxt/schema": "^4.4.8",
     "@nuxt/test-utils": "^4.0.3",
     "@types/prompts": "^2.4.9",
     "@vitest/coverage-istanbul": "^4.1.5",
     "baseline-browser-mapping": "latest",
     "browserslist": "latest",
     "eslint-config-prettier": "^10.1.8",
-    "eslint-plugin-vue": "^10.9.0",
-    "eslint": "^10.3.0",
+    "eslint-plugin-vue": "^10.9.2",
+    "eslint": "^10.6.0",
     "globals": "^17.6.0",
-    "nuxt": "^4.4.4",
+    "graphql": "^16.14.0",
+    "nuxt": "^4.4.8",
+    "nuxt-graphql-middleware": "^5.4.0",
     "postgraphile": "^5.0.3",
-    "typescript-eslint": "^8.59.1",
+    "typescript-eslint": "^8.62.1",
     "typescript": "^6.0.3",
+    "monaco-editor": "^0.55.1",
     "vite": "^7.3.2",
     "vitest": "^4.1.5",
     "vue-router": "^5.0.6",
-    "vue-tsc": "^3.2.7",
+    "vue-tsc": "^3.3.6",
     "vue": "^3.5.33"
   },
   "engines": {
@@ -87,9 +95,8 @@
     "prepublish": "rushx dev:prepare && nuxt-module-build build",
     "build": "rushx dev:prepare && nuxt-module-build build",
     "docs": "echo 'Nuxt modules use custom build system - skipping API docs generation'",
-    "dev": "rushx dev:prepare && nuxi dev playground",
-    "dev:basic": "rushx dev:prepare && nuxi dev playground",
-    "dev:full": "rushx dev:prepare:full && nuxi dev fullstack",
+    "dev": "rushx dev:prepare && nuxi dev playground --host",
+    "dev:full": "rushx dev:prepare:full && nuxi dev fullstack --host",
     "dev:prepare:full": "nuxt-module-build build --stub && nuxt-module-build prepare && nuxi prepare fullstack",
     "dev:build": "nuxi build playground",
     "dev:prepare": "nuxt-module-build build --stub && nuxt-module-build prepare && nuxi prepare playground && nuxi prepare fullstack",
@@ -98,6 +105,6 @@
     "test:ui": "vitest --ui",
     "test:coverage": "vitest run --coverage.enabled --coverage.provider=istanbul",
     "test:watch": "vitest watch",
-    "test:types": "vue-tsc --noEmit && cd playground && vue-tsc --noEmit"
+    "test:types": "vue-tsc --noEmit -p tsconfig.runtime.json && cd playground && vue-tsc --noEmit && cd ../fullstack && vue-tsc --noEmit"
   }
 }

package/templates/Project.json

@@ -6,35 +6,30 @@
 			"fieldname": "id",
 			"label": "ID",
 			"component": "ATextInput",
-			"fieldtype": "Data",
 			"mode": "display"
 		},
 		{
 			"fieldname": "title",
 			"label": "Title",
 			"component": "ATextInput",
-			"fieldtype": "Data",
 			"required": true
 		},
 		{
 			"fieldname": "description",
 			"label": "Description",
-			"component": "ATextarea",
-			"fieldtype": "Text"
+			"component": "ATextarea"
 		},
 		{
 			"fieldname": "status",
 			"label": "Status",
 			"component": "ADropdown",
-			"fieldtype": "Select",
 			"options": ["Active", "Archived"],
 			"default": "Active"
 		},
 		{
 			"fieldname": "createdAt",
 			"label": "Created At",
-			"component": "ATextInput",
-			"fieldtype": "Datetime",
+			"component": "ADateTime",
 			"mode": "display"
 		}
 	],
@@ -43,13 +38,12 @@
 		"actions": {
 			"save": {
 				"label": "Save",
-				"handler": "project:save"
+				"stateless": true
 			},
 			"archive": {
 				"label": "Archive Project",
-				"handler": "archive_project",
 				"allowedStates": ["Active"],
-				"confirm": true
+				"nextState": "Archived"
 			}
 		}
 	}

package/templates/Task.json

@@ -6,49 +6,42 @@
 			"fieldname": "id",
 			"label": "ID",
 			"component": "ATextInput",
-			"fieldtype": "Data",
 			"mode": "display"
 		},
 		{
 			"fieldname": "title",
 			"label": "Title",
 			"component": "ATextInput",
-			"fieldtype": "Data",
 			"required": true
 		},
 		{
 			"fieldname": "projectId",
 			"label": "Project",
-			"component": "ACombobox",
-			"fieldtype": "Link",
-			"options": "project",
+			"component": "AFormLink",
+			"doctype": "project",
 			"required": true
 		},
 		{
 			"fieldname": "status",
 			"label": "Status",
 			"component": "ADropdown",
-			"fieldtype": "Select",
 			"options": ["Todo", "In Progress", "Done"],
 			"default": "Todo"
 		},
 		{
 			"fieldname": "description",
 			"label": "Description",
-			"component": "ATextarea",
-			"fieldtype": "Text"
+			"component": "ATextarea"
 		},
 		{
 			"fieldname": "dueDate",
 			"label": "Due Date",
-			"component": "ADatepicker",
-			"fieldtype": "Date"
+			"component": "ADatePicker"
 		},
 		{
 			"fieldname": "createdAt",
 			"label": "Created At",
-			"component": "ATextInput",
-			"fieldtype": "Datetime",
+			"component": "ADateTime",
 			"mode": "display"
 		}
 	],
@@ -57,17 +50,17 @@
 		"actions": {
 			"save": {
 				"label": "Save",
-				"handler": "task:save"
+				"stateless": true
 			},
 			"start_task": {
 				"label": "Start Task",
-				"handler": "start_task",
-				"allowedStates": ["Todo"]
+				"allowedStates": ["Todo"],
+				"nextState": "In Progress"
 			},
 			"complete_task": {
 				"label": "Complete",
-				"handler": "complete_task",
-				"allowedStates": ["In Progress"]
+				"allowedStates": ["In Progress"],
+				"nextState": "Done"
 			}
 		}
 	}

package/templates/resolvers.ts

@@ -9,16 +9,16 @@
  * - loadOne($step, fn)        — batch-load data ASYNCHRONOUSLY (for DB queries)
  * - object({ ... })           — group multiple steps into a single step object
  *
- * Data reads go through loadOne; data writes happen in server/plugins/stonecrop.ts
- * via registered action handlers (start_task, complete_task, archive_project).
+ * Data reads go through loadOne. Workflow state transitions are applied by the
+ * stonecropAction resolver itself (server-owns-transition, guarded by allowedStates);
+ * side-effecting saves go through registered handlers (project:save, task:save).
  *
  * To connect a real database, replace the imports from ./data with your
  * PostGraphile setup. See: https://stonecrop.io/docs/guides/postgraphile
  */
 
 import { constant, lambda, loadOne, object } from 'grafast'
-import { getMeta, getAllMeta, getHandler } from '@stonecrop/graphql-middleware'
-import type { ActionContext } from '@stonecrop/graphql-middleware'
+import { getMeta, getAllMeta, applyGuardedTransition } from '@stonecrop/graphql-middleware'
 import type { DoctypeMeta } from '@stonecrop/schema'
 import { projects, tasks, type Project, type Task } from './data'
 
@@ -27,45 +27,22 @@ import { projects, tasks, type Project, type Task } from './data'
 // response type defined in server/schema.graphql)
 // ============================================================
 
-function formatFieldMeta(field: { kind?: string; fieldname: string; fieldtype?: string; [key: string]: unknown }) {
-	return {
-		fieldname: field.fieldname,
-		fieldtype: field.fieldtype ?? null,
-		label: field.label ?? null,
-		required: field.required ?? false,
-		readOnly: field.readOnly ?? false,
-		options: field.options ?? null,
-		default: field.default ?? null,
-		width: field.width ?? null,
-		validation: field.validation ?? null,
-		component: field.component ?? null,
-		align: field.align ?? null,
-		edit: field.edit ?? null,
-		hidden: field.hidden ?? null,
-		mask: field.mask ?? null,
-		precision: field.precision ?? null,
-		scale: field.scale ?? null,
-		mode: field.mode ?? null,
-	}
-}
-
-function formatDoctypeMeta(meta: DoctypeMeta) {
+export function formatDoctypeMeta(meta: DoctypeMeta) {
+	// Fields and actions pass through verbatim — the SDL alone decides what is
+	// selectable. Enumerating keys here silently drops any field the schema gains
+	// later; the only computed addition is `name` (an action's key in the
+	// WorkflowMeta.actions record, flattened into the list the SDL declares).
 	const actions = meta.workflow?.actions
 	const actionList = actions
 		? Object.entries(actions as Record<string, Record<string, unknown>>).map(([name, action]) => ({
 				name,
-				label: action.label ?? null,
-				handler: action.handler ?? null,
-				requiredFields: (action.requiredFields as string[]) ?? [],
-				allowedStates: (action.allowedStates as string[]) ?? [],
-				confirm: action.confirm ?? false,
-				args: action.args ?? null,
+				...action,
 			}))
 		: []
 	return {
 		name: meta.name,
 		slug: meta.slug ?? null,
-		fields: meta.fields.map(formatFieldMeta),
+		fields: meta.fields,
 		workflow: meta.workflow
 			? {
 					states: meta.workflow.states ?? null,
@@ -188,18 +165,46 @@ export const resolvers = {
 								const actionDef = meta.workflow?.actions?.[spec.action]
 								if (!actionDef) return { success: false, data: null, error: `Unknown action: ${spec.action}` }
 
-								const handler = getHandler(actionDef.handler)
-								if (!handler)
-									return { success: false, data: null, error: `Handler not registered: ${actionDef.handler}` }
-
-								// Pass doctype metadata via ActionContext. The handler in server/plugins/stonecrop.ts
-								// imports and mutates the data Maps directly — it does not need additional context here.
-								// In a PostGraphile setup, context.pgClient would provide the database connection instead.
-								const actionContext: ActionContext = { doctype: meta }
+								// Record envelope: [{ id, data }] — the transition keys off the record id, and a
+								// self-transition persists the edited field `data` in place.
+								const argList = Array.isArray(spec.actionArgs) ? spec.actionArgs : []
+								const recordId = argList[0]?.id != null ? String(argList[0].id) : undefined
+								const recordData: Record<string, unknown> = argList[0]?.data ?? {}
+								const d = spec.doctype.toLowerCase()
 
 								try {
-									const result = await handler(spec.actionArgs ?? [], actionContext)
-									return { success: true, data: result, error: null }
+									// The server owns the transition: read current state, guard against allowedStates,
+									// write nextState. Reads/writes go straight to the in-memory Maps; a PostGraphile
+									// setup swaps in pgClient SQL instead.
+									return await applyGuardedTransition(
+										actionDef,
+										{
+											readState: async () => {
+												if (recordId == null) return undefined
+												const record = getRecord(d, recordId)
+												return record?.status == null ? undefined : String(record.status)
+											},
+											writeState: async (nextState: string) => {
+												if (recordId == null) return
+												const existing = getRecord(d, recordId)
+												if (!existing) return
+												if (d === 'project') projects.set(recordId, { ...existing, status: nextState } as Project)
+												else if (d === 'task') tasks.set(recordId, { ...existing, status: nextState } as Task)
+											},
+											// Self-transition data write: merge the edited fields into the record (status
+											// untouched) and return the full record for the client writeback.
+											writeData: async (patch: Record<string, unknown>) => {
+												if (recordId == null) return {}
+												const existing = getRecord(d, recordId)
+												if (!existing) return {}
+												const updated = { ...existing, ...patch }
+												if (d === 'project') projects.set(recordId, updated as Project)
+												else if (d === 'task') tasks.set(recordId, updated as Task)
+												return updated as Record<string, unknown>
+											},
+										},
+										recordData
+									)
 								} catch (err) {
 									return { success: false, data: null, error: err instanceof Error ? err.message : String(err) }
 								}

package/templates/schema.graphql

@@ -11,36 +11,44 @@ scalar JSON
 Field metadata from doctype schema
 """
 type StonecropField {
+	kind: String!
 	fieldname: String!
-	fieldtype: String!
+	component: String
+	primaryKey: Boolean
+	computed: Boolean
+	language: String
+	doctype: String
 	label: String
-	required: Boolean
-	readOnly: Boolean
-	options: JSON
-	default: JSON
 	width: String
-	validation: JSON
-	component: String
 	align: String
 	edit: Boolean
-	hidden: Boolean
 	mask: String
-	precision: Int
-	scale: Int
+	format: String
 	mode: String
+	options: JSON
+	required: Boolean
+	readOnly: Boolean
+	hidden: Boolean
+	default: JSON
+	validation: JSON
+	cardinality: String
+	source: String
 }
 
 """
-A single workflow action definition
+A single workflow action definition (`name` is the action's key in
+WorkflowMeta.actions; the other fields mirror ActionDefinition in
+@stonecrop/schema)
 """
 type WorkflowAction {
 	name: String!
-	label: String
-	handler: String
+	label: String!
 	requiredFields: [String!]
 	allowedStates: [String!]
-	confirm: Boolean
-	args: JSON
+	nextState: String
+	stateless: Boolean
+	selfTransition: Boolean
+	clientHandler: String
 }
 
 """

package/templates/stonecrop.ts

@@ -1,82 +1,16 @@
 /**
  * Stonecrop Server Plugin
  *
- * Runs at server startup (Nitro plugin) to:
- * 1. Load doctype definitions from the doctypes/ directory
- * 2. Register built-in action handlers (validation, etc.)
- * 3. Register custom workflow action handlers
- *
- * Action handlers receive (args, context) where args is the array sent by the
- * client — the app's frontend (app/composables/useDoctypes.ts) sends a single
- * `{ id, data? }` object per action — and context.doctype is the DoctypeMeta
- * for the doctype being acted upon. For this in-memory setup, data is imported
- * directly from server/data.ts. In production with PostGraphile, context.pgClient
- * provides an active database connection instead — see:
- * https://stonecrop.io/docs/guides/postgraphile
+ * Runs at server startup (Nitro plugin) to load doctype definitions from the
+ * doctypes/ directory into the middleware registry.
  */
 
 import { resolve } from 'node:path'
-import { clearRegistry, loadDoctypes, registerBuiltinHandlers, registerHandler } from '@stonecrop/graphql-middleware'
-import { projects, tasks, type Project, type Task } from '../data'
-
-/** Action argument shape sent by the frontend (see runDoctypeAction in useDoctypes.ts) */
-type ActionArgs = [{ id: string; data?: Record<string, unknown> }]
+import { clearRegistry, loadDoctypes } from '@stonecrop/graphql-middleware'
 
 export default defineNitroPlugin(async () => {
 	clearRegistry()
 
 	const doctypesDir = resolve(process.cwd(), 'doctypes')
 	loadDoctypes(doctypesDir, { continueOnError: true })
-
-	registerBuiltinHandlers()
-
-	// Persist form edits to a Project
-	registerHandler('project:save', async (args: unknown[]) => {
-		const [{ id, data }] = args as ActionArgs
-		const project = projects.get(id)
-		if (!project) throw new Error(`Project not found: ${id}`)
-		const updated = { ...project, ...data, id } as Project
-		projects.set(id, updated)
-		return updated
-	})
-
-	// Persist form edits to a Task
-	registerHandler('task:save', async (args: unknown[]) => {
-		const [{ id, data }] = args as ActionArgs
-		const task = tasks.get(id)
-		if (!task) throw new Error(`Task not found: ${id}`)
-		const updated = { ...task, ...data, id } as Task
-		tasks.set(id, updated)
-		return updated
-	})
-
-	// Transition a Task from Todo → In Progress
-	registerHandler('start_task', async (args: unknown[]) => {
-		const [{ id }] = args as ActionArgs
-		const task = tasks.get(id)
-		if (!task) throw new Error(`Task not found: ${id}`)
-		const updated = { ...task, status: 'In Progress' as const }
-		tasks.set(id, updated)
-		return updated
-	})
-
-	// Transition a Task from In Progress → Done
-	registerHandler('complete_task', async (args: unknown[]) => {
-		const [{ id }] = args as ActionArgs
-		const task = tasks.get(id)
-		if (!task) throw new Error(`Task not found: ${id}`)
-		const updated = { ...task, status: 'Done' as const }
-		tasks.set(id, updated)
-		return updated
-	})
-
-	// Transition a Project from Active → Archived
-	registerHandler('archive_project', async (args: unknown[]) => {
-		const [{ id }] = args as ActionArgs
-		const project = projects.get(id)
-		if (!project) throw new Error(`Project not found: ${id}`)
-		const updated = { ...project, status: 'Archived' as const }
-		projects.set(id, updated)
-		return updated
-	})
 })