@stonecrop/nuxt 0.35.0 → 0.38.0

package/README.md

@@ -427,7 +427,7 @@ await dispatchAction({ name: 'plan' }, 'SUBMIT', [recordId])
 | `setMeta(fn)` | `(fn: (ctx) => Doctype \| Promise<Doctype>) => void` | Sets the `getMeta` function on the Registry. Called by `useStonecrop({ doctype: 'slug' })` to lazy-load that doctype's metadata. `ctx` = `{ path, segments }`. |
 | `setClient(client)` | `(client: DataClient) => void` | Set the data client for record fetching. Throws if stonecrop not available. |
 | `getClient()` | `() => DataClient \| undefined` | Get the currently configured client. |
-| `dispatchAction(doctype, action, args)` | `Promise<{ success, data, error }>` | Dispatch an action via the configured client. Returns error if doctype not found in registry. |
+| `dispatchAction(doctype, action, args)` | `Promise<{ success, data, error }>` | Dispatch an action via the configured client, storing the result's `record` (the server's read of the record after the action). Returns error if doctype not found in registry. |
 
 ## Advanced Features
 
@@ -481,8 +481,13 @@ const taskMachine = createMachine({
 
 ## Examples
 
-- **[playground](./playground)** — the default example: doctypes introspected from a live public GraphQL API with the `stonecrop-schema generate` CLI, browsed through the Desktop shell, and refined in the built-in DocBuilder (provenance-locked introspected fields, plus hand-authored workflow fixtures for the graph editor). `pnpm run dev` runs it.
-- **[fullstack](./fullstack)** — the middleware core on the app's own GraphQL server (grafserv + guarded workflow transitions over in-memory storage, no database). `pnpm run dev:full` runs it.
+All runnable examples live in **[documentation](./documentation)** at **`/playground`**:
+
+- **Workflow** — grafserv + guarded transitions over session-scoped in-memory storage (Orders/Users), Desktop rail panels
+- **Countries** — doctypes introspected from the public [countries GraphQL API](https://countries.trevorblades.com/graphql), same Desktop shell
+- **DocBuilder** — public doctype prototyping at `/docbuilder`
+
+`pnpm run dev` (alias for `dev:documentation`) runs the docs site on port 3002.
 
 
 ## Contribution
@@ -497,10 +502,10 @@ pnpm install
 # Generate type stubs
 pnpm run dev:prepare
 
-# Develop with the playground
+# Develop the documentation site (docs + playgrounds)
 pnpm run dev
 
-# Build the playground
+# Build the documentation site
 pnpm run dev:build
 
 # Run ESLint
@@ -570,8 +575,10 @@ The CLI will detect that you're in a Nuxt project and prompt for features:
 
 ? Select features to install
   ◉ @stonecrop/nuxt - Frontend module
+  ◯ @stonecrop/graphql-client - GraphQL client
   ◯ @stonecrop/nuxt-grafserv - GraphQL server
   ◯ @stonecrop/casl-middleware - Authorization
+  ◯ @stonecrop/rockfoil - PostGraphile middleware
   ◉ Sample doctypes
 ```
 

package/dist/module.d.mts

@@ -48,6 +48,8 @@ type RouteStrategyFn = (doctypes: ParsedDoctype[]) => NuxtPage[];
 interface ModuleOptions {
     /** Enable the DocBuilder feature with /docbuilder routes */
     docbuilder?: boolean;
+    /** Allow DocBuilder routes and handlers outside development (e.g. public documentation playground) */
+    docbuilderPublic?: boolean;
     /** Path to doctypes folder relative to the project root (defaults to 'doctypes') */
     doctypesDir?: string;
     /**

package/dist/module.json

@@ -1,7 +1,7 @@
 {
   "name": "@stonecrop/nuxt",
   "configKey": "stonecrop",
-  "version": "0.35.0",
+  "version": "0.38.0",
   "builder": {
     "@nuxt/module-builder": "1.0.3",
     "unbuild": "unknown"

package/dist/module.mjs

@@ -196,7 +196,7 @@ const module$1 = defineNuxtModule({
         }
       }
     });
-    if (options.docbuilder && process.env.NODE_ENV === "development") {
+    if (options.docbuilder && (options.docbuilderPublic || process.env.NODE_ENV === "development")) {
       logger.log("DocBuilder enabled, adding routes and handlers");
       nuxt.options.css.push("@vue-flow/core/dist/style.css");
       nuxt.options.css.push("@vue-flow/core/dist/theme-default.css");

package/dist/runtime/app/components/DocBuilderFieldsPanel.vue

@@ -336,5 +336,5 @@ function bool(v) {
 </script>
 
 <style scoped>
-.fields-panel{padding:.5em 1em}.fields-panel :deep(.atable-row>td){border-top:1px solid var(--sc-row-border-color);padding:var(--sc-atable-row-padding) .75em;vertical-align:middle}.fields-panel :deep(input[type=text]),.fields-panel :deep(select){border:1px solid var(--sc-gray-20);border-radius:var(--sc-border-radius);font-family:inherit;font-size:inherit;padding:.25em .5em;width:100%}.fields-panel :deep(input.locked),.fields-panel :deep(select.locked){background:var(--sc-gray-10);color:var(--sc-header-text-color);cursor:not-allowed}.fields-panel :deep(input.json-invalid){background:var(--sc-badge-danger-bg);border-color:var(--sc-brand-danger)}.center{text-align:center}.badge{border-radius:9999px;display:inline-block;font-size:.75rem;font-weight:500;padding:.125em .5em}.badge-manual{background:var(--sc-badge-brand-bg);color:var(--sc-badge-brand-text)}.badge-introspected{background:var(--sc-badge-neutral-bg);color:var(--sc-badge-neutral-text)}.field-detail{display:grid;gap:.75rem 1rem;grid-template-columns:repeat(auto-fill,minmax(14rem,1fr));padding:.75rem 1rem}.field-prop{color:var(--sc-header-text-color);display:flex;flex-direction:column;font-size:.75rem;gap:.25rem}.field-prop-inline{align-items:center;flex-direction:row;gap:.5rem}.field-prop-wide{grid-column:1/-1}.field-detail-actions{align-items:center;display:flex;gap:1rem;justify-content:space-between;padding:0 1rem .75rem}.locked-note{color:var(--sc-header-text-color);font-size:.75rem;font-style:italic}.btn-add{background:none;border:1px dashed var(--sc-gray-20);border-radius:var(--sc-border-radius);color:var(--sc-primary-color);cursor:pointer;font-size:.875rem;margin-top:.5rem;padding:.4em 1em}.fields-empty{color:var(--sc-header-text-color);font-style:italic;padding:1rem 0}
+.fields-panel{box-sizing:border-box;max-width:100%;overflow-x:auto;padding:.5em 1em}.fields-panel :deep(.atable-row>td){border-top:1px solid var(--sc-row-border-color);padding:var(--sc-atable-row-padding) .75em;vertical-align:middle}.fields-panel :deep(input[type=text]),.fields-panel :deep(select){border:1px solid var(--sc-gray-20);border-radius:var(--sc-border-radius);font-family:inherit;font-size:inherit;padding:.25em .5em;width:100%}.fields-panel :deep(input.locked),.fields-panel :deep(select.locked){background:var(--sc-gray-10);color:var(--sc-header-text-color);cursor:not-allowed}.fields-panel :deep(input.json-invalid){background:var(--sc-badge-danger-bg);border-color:var(--sc-brand-danger)}.center{text-align:center}.badge{border-radius:9999px;display:inline-block;font-size:.75rem;font-weight:500;padding:.125em .5em}.badge-manual{background:var(--sc-badge-brand-bg);color:var(--sc-badge-brand-text)}.badge-introspected{background:var(--sc-badge-neutral-bg);color:var(--sc-badge-neutral-text)}.field-detail{display:grid;gap:.75rem 1rem;grid-template-columns:repeat(auto-fill,minmax(14rem,1fr));padding:.75rem 1rem}.field-prop{color:var(--sc-header-text-color);display:flex;flex-direction:column;font-size:.75rem;gap:.25rem}.field-prop-inline{align-items:center;flex-direction:row;gap:.5rem}.field-prop-wide{grid-column:1/-1}.field-detail-actions{align-items:center;display:flex;gap:1rem;justify-content:space-between;padding:0 1rem .75rem}.locked-note{color:var(--sc-header-text-color);font-size:.75rem;font-style:italic}.btn-add{background:none;border:1px dashed var(--sc-gray-20);border-radius:var(--sc-border-radius);color:var(--sc-primary-color);cursor:pointer;font-size:.875rem;margin-top:.5rem;padding:.4em 1em}.fields-empty{color:var(--sc-header-text-color);font-style:italic;padding:1rem 0}
 </style>

package/dist/runtime/app/pages/DocBuilderDetail.vue

@@ -1,55 +1,57 @@
 <template>
 	<ClientOnly>
-		<Desktop class="docbuilder-desktop" :route-adapter="routeAdapter" :host-actions="docbuilderActions">
-			<div v-if="loading" class="docbuilder-loading">Loading...</div>
-			<div v-else class="docbuilder-page">
-				<div v-if="validationIssues.length > 0 && !warningsDismissed" class="validation-panel">
-					<div v-if="errorCount > 0" class="validation-errors">
-						<strong>⚠️ {{ errorCount }} Error(s) — Cannot Save</strong>
-						<ul>
-							<li v-for="(issue, idx) in validationIssues.filter(i => i.severity === 'error')" :key="`err-${idx}`">
-								<code v-if="issue.fieldname">{{ issue.fieldname }}:</code> {{ issue.message }}
-							</li>
-						</ul>
-					</div>
-					<div v-if="warningCount > 0" class="validation-warnings">
-						<strong>⚡ {{ warningCount }} Warning(s)</strong>
-						<button class="dismiss-button" @click="warningsDismissed = true">Dismiss</button>
+		<div class="docbuilder-shell">
+			<Desktop class="docbuilder-desktop" :route-adapter="routeAdapter" :host-actions="docbuilderActions">
+				<div v-if="loading" class="docbuilder-loading">Loading...</div>
+				<div v-else class="docbuilder-page">
+					<div v-if="validationIssues.length > 0 && !warningsDismissed" class="validation-panel">
+						<div v-if="errorCount > 0" class="validation-errors">
+							<strong>⚠️ {{ errorCount }} Error(s) — Cannot Save</strong>
+							<ul>
+								<li v-for="(issue, idx) in validationIssues.filter(i => i.severity === 'error')" :key="`err-${idx}`">
+									<code v-if="issue.fieldname">{{ issue.fieldname }}:</code> {{ issue.message }}
+								</li>
+							</ul>
+						</div>
+						<div v-if="warningCount > 0" class="validation-warnings">
+							<strong>⚡ {{ warningCount }} Warning(s)</strong>
+							<button class="dismiss-button" @click="warningsDismissed = true">Dismiss</button>
+						</div>
 					</div>
-				</div>
 
-				<AFieldset label="Workflow" :schema="[]" :collapsible="true">
-					<div class="builder-workflow">
-						<StateEditor
-							v-if="workflowConfig && workflowConfig.states && workflowConfig.states.length > 0"
-							v-model="workflowConfig"
-							v-model:layout="layout"
-							node-container-class="node-editor" />
-						<div v-else class="empty-workflow">
-							<p class="empty-workflow-hint">No workflow yet. Name the first state to start building the workflow.</p>
-							<div class="empty-workflow-form">
-								<input v-model="newStateName" type="text" placeholder="e.g. Draft" @keyup.enter="seedWorkflow" />
-								<button class="btn-primary" type="button" :disabled="!newStateName.trim()" @click="seedWorkflow">
-									Add first state
-								</button>
+					<AFieldset label="Workflow" :schema="[]" :collapsible="true">
+						<div class="builder-workflow">
+							<StateEditor
+								v-if="workflowConfig && workflowConfig.states && workflowConfig.states.length > 0"
+								v-model="workflowConfig"
+								v-model:layout="layout"
+								node-container-class="node-editor" />
+							<div v-else class="empty-workflow">
+								<p class="empty-workflow-hint">No workflow yet. Name the first state to start building the workflow.</p>
+								<div class="empty-workflow-form">
+									<input v-model="newStateName" type="text" placeholder="e.g. Draft" @keyup.enter="seedWorkflow" />
+									<button class="btn-primary" type="button" :disabled="!newStateName.trim()" @click="seedWorkflow">
+										Add first state
+									</button>
+								</div>
 							</div>
 						</div>
-					</div>
-				</AFieldset>
+					</AFieldset>
 
-				<AFieldset label="Actions" :schema="[]" :collapsible="true">
-					<DocBuilderActionsPanel v-model="workflowConfig" />
-				</AFieldset>
+					<AFieldset label="Actions" :schema="[]" :collapsible="true">
+						<DocBuilderActionsPanel v-model="workflowConfig" />
+					</AFieldset>
 
-				<AFieldset label="Schema" :schema="[]" :collapsible="true">
-					<DocBuilderFieldsPanel v-model="fields" />
-				</AFieldset>
+					<AFieldset label="Schema" :schema="[]" :collapsible="true">
+						<DocBuilderFieldsPanel v-model="fields" />
+					</AFieldset>
 
-				<div v-if="saveMessage" class="builder-actions">
-					<span class="save-message" :class="saveMessage.type">{{ saveMessage.text }}</span>
+					<div v-if="saveMessage" class="builder-actions">
+						<span class="save-message" :class="saveMessage.type">{{ saveMessage.text }}</span>
+					</div>
 				</div>
-			</div>
-		</Desktop>
+			</Desktop>
+		</div>
 		<template #fallback>
 			<div class="docbuilder-loading">Loading...</div>
 		</template>
@@ -150,5 +152,5 @@ const docbuilderActions = computed(() => [
 </script>
 
 <style scoped>
-.docbuilder-desktop{height:100vh}.docbuilder-loading{color:var(--sc-header-text-color);padding:2rem;text-align:center}.docbuilder-page{box-sizing:border-box;padding:2rem}.builder-workflow{min-height:8rem;padding:.5em 1em}:deep(.node-editor){height:40vh;overflow:hidden;width:100%}.empty-workflow{padding:1rem 0}.empty-workflow-hint{color:var(--sc-header-text-color);font-style:italic;margin:0 0 .75rem}.empty-workflow-form{align-items:center;display:flex;gap:.5rem}.empty-workflow-form input{border:1px solid var(--sc-input-border-color);border-radius:var(--sc-border-radius);font-family:inherit;font-size:.875rem;padding:.4em .6em}.btn-primary{background:var(--sc-primary-color);border:none;border-radius:var(--sc-border-radius);color:var(--sc-primary-text-color);cursor:pointer;font-size:.875rem;font-weight:500;padding:.45em 1em}.btn-primary:disabled{cursor:not-allowed;opacity:.5}.validation-panel{margin-bottom:1rem}.validation-errors{background:var(--sc-badge-danger-bg);border:1px solid var(--sc-badge-danger-accent);border-radius:var(--sc-border-radius);color:var(--sc-badge-danger-text);margin-bottom:.5rem;padding:1rem}.validation-warnings{background:var(--sc-badge-warning-bg);border:1px solid var(--sc-badge-warning-accent);border-radius:var(--sc-border-radius);color:var(--sc-badge-warning-text);padding:1rem}.dismiss-button{background:none;border:1px solid;border-radius:var(--sc-border-radius);cursor:pointer;font-size:.75rem;margin-left:1rem;padding:.125em .5em}.builder-actions{align-items:center;display:flex;gap:1rem;padding:1rem}.save-message{font-size:.875rem}.save-message.success{color:var(--sc-brand-success)}.save-message.error{color:var(--sc-brand-danger)}
+.docbuilder-shell{display:flex;flex-direction:column;min-height:100dvh}.docbuilder-desktop{flex:1;min-height:0}.docbuilder-loading{color:var(--sc-header-text-color);padding:2rem;text-align:center}.docbuilder-page{box-sizing:border-box;padding:2rem}.builder-workflow{min-height:8rem;padding:.5em 1em}:deep(.node-editor){height:40vh;overflow:hidden;width:100%}.empty-workflow{padding:1rem 0}.empty-workflow-hint{color:var(--sc-header-text-color);font-style:italic;margin:0 0 .75rem}.empty-workflow-form{align-items:center;display:flex;gap:.5rem}.empty-workflow-form input{border:1px solid var(--sc-input-border-color);border-radius:var(--sc-border-radius);font-family:inherit;font-size:.875rem;padding:.4em .6em}.btn-primary{background:var(--sc-primary-color);border:none;border-radius:var(--sc-border-radius);color:var(--sc-primary-text-color);cursor:pointer;font-size:.875rem;font-weight:500;padding:.45em 1em}.btn-primary:disabled{cursor:not-allowed;opacity:.5}.validation-panel{margin-bottom:1rem}.validation-errors{background:var(--sc-badge-danger-bg);border:1px solid var(--sc-badge-danger-accent);border-radius:var(--sc-border-radius);color:var(--sc-badge-danger-text);margin-bottom:.5rem;padding:1rem}.validation-warnings{background:var(--sc-badge-warning-bg);border:1px solid var(--sc-badge-warning-accent);border-radius:var(--sc-border-radius);color:var(--sc-badge-warning-text);padding:1rem}.dismiss-button{background:none;border:1px solid;border-radius:var(--sc-border-radius);cursor:pointer;font-size:.75rem;margin-left:1rem;padding:.125em .5em}.builder-actions{align-items:center;display:flex;gap:1rem;padding:1rem}.save-message{font-size:.875rem}.save-message.success{color:var(--sc-brand-success)}.save-message.error{color:var(--sc-brand-danger)}
 </style>

package/dist/runtime/app/pages/DocBuilderIndex.vue

@@ -1,28 +1,30 @@
 <template>
 	<ClientOnly>
-		<Desktop class="docbuilder-desktop" :route-adapter="routeAdapter" :host-actions="indexActions">
-			<div class="docbuilder-index-inner">
-				<div class="docbuilder-header">
-					<h1>DocType Builder</h1>
-					<p class="subtitle">Select a DocType to view and edit its schema</p>
+		<div class="docbuilder-shell">
+			<Desktop class="docbuilder-desktop" :route-adapter="routeAdapter" :host-actions="indexActions">
+				<div class="docbuilder-index-inner">
+					<div class="docbuilder-header">
+						<h1>DocType Builder</h1>
+						<p class="subtitle">Select a DocType to view and edit its schema</p>
+					</div>
+					<div class="docbuilder-create">
+						<input
+							v-model="newName"
+							type="text"
+							placeholder="New doctype name (e.g. Invoice)"
+							:disabled="creating"
+							@keyup.enter="createDoctype" />
+						<button type="button" class="btn-primary" :disabled="creating || !newName.trim()" @click="createDoctype">
+							{{ creating ? 'Creating\u2026' : '+ New DocType' }}
+						</button>
+					</div>
+					<p v-if="createError" class="create-error">{{ createError }}</p>
+					<div v-if="loading" class="loading">Loading doctypes...</div>
+					<p v-else-if="!doctypes.length" class="empty">No doctypes yet — create one above.</p>
+					<ATable v-else :columns="columns" :rows="doctypes" :config="config" @row:click="handleRowClick" />
 				</div>
-				<div class="docbuilder-create">
-					<input
-						v-model="newName"
-						type="text"
-						placeholder="New doctype name (e.g. Invoice)"
-						:disabled="creating"
-						@keyup.enter="createDoctype" />
-					<button type="button" class="btn-primary" :disabled="creating || !newName.trim()" @click="createDoctype">
-						{{ creating ? 'Creating\u2026' : '+ New DocType' }}
-					</button>
-				</div>
-				<p v-if="createError" class="create-error">{{ createError }}</p>
-				<div v-if="loading" class="loading">Loading doctypes...</div>
-				<p v-else-if="!doctypes.length" class="empty">No doctypes yet — create one above.</p>
-				<ATable v-else :columns="columns" :rows="doctypes" :config="config" @row:click="handleRowClick" />
-			</div>
-		</Desktop>
+			</Desktop>
+		</div>
 	</ClientOnly>
 </template>
 
@@ -95,5 +97,5 @@ const indexActions = computed(() => [{ type: "button", label: "Home", action: ()
 </script>
 
 <style scoped>
-.docbuilder-desktop{height:100vh}.docbuilder-index-inner{margin:0 auto;max-width:1200px;padding:2rem}.docbuilder-header{padding:2rem 0 3rem;text-align:center}.docbuilder-header h1{font-size:2.5rem;font-weight:700;margin:0 0 1rem}.subtitle{font-size:1.125rem;margin:0}.empty,.loading,.subtitle{color:var(--sc-header-text-color)}.empty,.loading{padding:2rem;text-align:center}.docbuilder-create{display:flex;gap:.5rem;margin-bottom:1rem}.docbuilder-create input{border:1px solid var(--sc-input-border-color);border-radius:var(--sc-border-radius);flex:1;font:inherit;padding:.5em .75em}.btn-primary{background:var(--sc-primary-color);border:none;border-radius:var(--sc-border-radius);color:var(--sc-primary-text-color);cursor:pointer;font-weight:500;padding:.5em 1.25em;white-space:nowrap}.btn-primary:disabled{cursor:not-allowed;opacity:.5}.create-error{color:var(--sc-brand-danger);font-size:.875rem;margin:-.5rem 0 1rem}
+.docbuilder-shell{display:flex;flex-direction:column;min-height:100dvh}.docbuilder-desktop{flex:1;min-height:0}.docbuilder-index-inner{margin:0 auto;max-width:1200px;padding:2rem}.docbuilder-header{padding:2rem 0 3rem;text-align:center}.docbuilder-header h1{font-size:2.5rem;font-weight:700;margin:0 0 1rem}.subtitle{font-size:1.125rem;margin:0}.empty,.loading,.subtitle{color:var(--sc-header-text-color)}.empty,.loading{padding:2rem;text-align:center}.docbuilder-create{display:flex;gap:.5rem;margin-bottom:1rem}.docbuilder-create input{border:1px solid var(--sc-input-border-color);border-radius:var(--sc-border-radius);flex:1;font:inherit;padding:.5em .75em}.btn-primary{background:var(--sc-primary-color);border:none;border-radius:var(--sc-border-radius);color:var(--sc-primary-text-color);cursor:pointer;font-weight:500;padding:.5em 1.25em;white-space:nowrap}.btn-primary:disabled{cursor:not-allowed;opacity:.5}.create-error{color:var(--sc-brand-danger);font-size:.875rem;margin:-.5rem 0 1rem}
 </style>

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@stonecrop/nuxt",
-  "version": "0.35.0",
+  "version": "0.38.0",
   "description": "Nuxt module for Stonecrop",
   "keywords": [
     "nuxt",
@@ -60,18 +60,18 @@
     "pathe": "^2.0.3",
     "pinia": "^3.0.4",
     "prompts": "^2.4.2",
-    "@stonecrop/aform": "0.35.0",
-    "@stonecrop/atable": "0.35.0",
-    "@stonecrop/casl-middleware": "0.35.0",
-    "@stonecrop/code-editor": "0.35.0",
-    "@stonecrop/desktop": "0.35.0",
-    "@stonecrop/graphql-client": "0.35.0",
-    "@stonecrop/schema": "0.35.0",
-    "@stonecrop/node-editor": "0.35.0",
-    "@stonecrop/nuxt-grafserv": "0.35.0",
-    "@stonecrop/themes": "0.35.0",
-    "@stonecrop/stonecrop": "0.35.0",
-    "@stonecrop/graphql-middleware": "0.35.0"
+    "@stonecrop/aform": "0.38.0",
+    "@stonecrop/atable": "0.38.0",
+    "@stonecrop/casl-middleware": "0.38.0",
+    "@stonecrop/code-editor": "0.38.0",
+    "@stonecrop/graphql-client": "0.38.0",
+    "@stonecrop/nuxt-grafserv": "0.38.0",
+    "@stonecrop/graphql-middleware": "0.38.0",
+    "@stonecrop/node-editor": "0.38.0",
+    "@stonecrop/stonecrop": "0.38.0",
+    "@stonecrop/desktop": "0.38.0",
+    "@stonecrop/themes": "0.38.0",
+    "@stonecrop/schema": "0.38.0"
   },
   "devDependencies": {
     "@eslint/js": "^10.0.1",
@@ -95,6 +95,7 @@
     "nuxt": "^4.4.8",
     "nuxt-graphql-middleware": "^5.4.0",
     "postgraphile": "^5.0.3",
+    "temporal-polyfill": "^1.0.5",
     "typescript": "^6.0.3",
     "typescript-eslint": "^8.62.1",
     "vite": "^8.2.2",
@@ -107,13 +108,11 @@
     "node": ">=24.0.0"
   },
   "scripts": {
-    "dev": "node --run dev:prepare && nuxi dev playground --host",
-    "dev:build": "nuxi build playground",
+    "dev": "node --run dev:documentation",
+    "dev:build": "nuxi build documentation",
     "dev:documentation": "node --run dev:prepare:documentation && nuxi dev documentation --host",
-    "dev:full": "node --run dev:prepare:full && nuxi dev fullstack --host",
     "dev:prepare": "nuxt-module-build build --stub && nuxt-module-build prepare && sh scripts/nuxt-apps.sh prepare",
-    "dev:prepare:documentation": "nuxi prepare documentation",
-    "dev:prepare:full": "nuxt-module-build build --stub && nuxt-module-build prepare && nuxi prepare fullstack",
+    "dev:prepare:documentation": "nuxt-module-build build --stub && nuxt-module-build prepare && nuxi prepare documentation",
     "docs": "echo 'Nuxt modules use custom build system - skipping API docs generation'",
     "generate:documentation": "nuxi generate documentation",
     "lint": "eslint .",

package/src/cli/installers/frontend.ts

@@ -26,11 +26,12 @@ export async function installFrontend(options: FrontendInstallerOptions): Promis
 
 	try {
 		// Add @stonecrop/nuxt and its required peer dependencies
-		// These packages are imported by the Nuxt module and need to be available at runtime
+		// These packages are imported by the Nuxt module or the scaffolded app files and need to be available at runtime
 		await addDependencies(cwd, {
 			'@stonecrop/nuxt': 'latest',
 			'@stonecrop/aform': 'latest',
 			'@stonecrop/atable': 'latest',
+			'@stonecrop/graphql-client': 'latest',
 			'@stonecrop/stonecrop': 'latest',
 			'@stonecrop/node-editor': 'latest',
 			'@stonecrop/schema': 'latest',

package/src/cli/installers/grafserv.ts

@@ -39,8 +39,10 @@ export async function installGrafserv(options: GrafservInstallerOptions): Promis
 		await addDependencies(cwd, {
 			'@stonecrop/nuxt-grafserv': 'latest',
 			'@stonecrop/graphql-middleware': 'latest',
+			'@stonecrop/schema': 'latest',
 			graphql: '^16.11.0',
 			grafast: '^1.0.1',
+			'temporal-polyfill': '^1.0.5',
 		})
 
 		// Update nuxt.config.ts

package/templates/resolvers.ts

@@ -22,6 +22,7 @@ import { constant, lambda, loadOne, object } from 'grafast'
 import { getMeta, getAllMeta, applyGuardedTransition } from '@stonecrop/graphql-middleware'
 import { getRecordIdField } from '@stonecrop/schema'
 import type { DoctypeMeta } from '@stonecrop/schema'
+import { Temporal } from 'temporal-polyfill'
 import { projects, tasks, type Project, type Task } from './data'
 
 // ============================================================
@@ -142,8 +143,8 @@ function nextId(doctype: string): string {
 // `selfTransition` has nothing for the dispatcher to apply, and without an entry here it fails
 // loudly rather than reporting a false success.
 //
-// Add your own by registering under the doctype's `name`. Throwing rejects the action; returning
-// the updated record makes it the client writeback payload.
+// Add your own by registering under the doctype's `name`. Throwing rejects the action; what it
+// returns becomes the result's `data`, while the client stores the record as a read returns it.
 
 type ActionHandler = (context: {
 	recordId?: string
@@ -165,9 +166,9 @@ export const actionHandlers: Record<string, Record<string, ActionHandler>> = {
 			const task = recordId != null ? tasks.get(recordId) : undefined
 			if (!task) throw new Error(`Task ${recordId ?? '(none)'} not found`)
 
-			const from = task.dueDate ? new Date(task.dueDate) : new Date()
-			from.setDate(from.getDate() + 7)
-			const updated: Task = { ...task, dueDate: from.toISOString().slice(0, 10) }
+			// A task with no due date is snoozed from the server's today.
+			const from = task.dueDate ? Temporal.PlainDate.from(task.dueDate) : Temporal.Now.plainDateISO()
+			const updated: Task = { ...task, dueDate: from.add({ weeks: 1 }).toString() }
 			tasks.set(task.id, updated)
 			return Promise.resolve(updated)
 		},
@@ -278,7 +279,7 @@ export const resolvers = {
 									// 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(
+									const outcome = await applyGuardedTransition(
 										actionDef,
 										{
 											readState: async () => {
@@ -302,7 +303,7 @@ export const resolvers = {
 											// untouched); creating derives the identity from the doctype's declared
 											// primary key when the submitted data carries it, which is how a
 											// natural-keyed doctype is identified, and mints one only otherwise.
-											// Either way the full record comes back for the client writeback.
+											// Either way the full record comes back, stating its identity.
 											writeData: async (patch: Record<string, unknown>, exists: boolean) => {
 												if (exists) {
 													if (recordId == null) return {}
@@ -340,6 +341,15 @@ export const resolvers = {
 										},
 										recordData
 									)
+									// The record as `stonecropRecord` returns it: the client stores this, never
+									// `data`. Keyed by the identity the reply states, since a save may create it.
+									const repliedId: unknown =
+										outcome.data !== null && typeof outcome.data === 'object'
+											? Reflect.get(outcome.data, lookupField)
+											: undefined
+									const readId = repliedId ?? recordId
+									const record = outcome.success && readId != null ? getRecord(d, String(readId), lookupField) : null
+									return { ...outcome, record }
 								} catch (err) {
 									return { success: false, data: null, error: err instanceof Error ? err.message : String(err) }
 								}

package/templates/schema.graphql

@@ -101,6 +101,8 @@ type ActionResult {
 	success: Boolean!
 	data: JSON
 	error: String
+	"The record as stonecropRecord returns it after the action. Null when the action failed or targets no record."
+	record: JSON
 }
 
 # ============================================