@stonecrop/aform 0.13.12 → 0.14.0

package/src/index.ts

@@ -4,7 +4,6 @@ import { install as installATable } from '@stonecrop/atable'
 import type { App } from 'vue'
 
 import ACheckbox from './components/form/ACheckbox.vue'
-import AComboBox from './components/form/AComboBox.vue'
 import ADate from './components/form/ADate.vue'
 import ADropdown from './components/form/ADropdown.vue'
 import ADatePicker from './components/form/ADatePicker.vue'
@@ -18,6 +17,7 @@ import AForm from './components/AForm.vue'
 import AFormLink from './components/form/AFormLink.vue'
 import ANumericInput from './components/form/ANumericInput.vue'
 import ATextInput from './components/form/ATextInput.vue'
+import ATextarea from './components/form/ATextarea.vue'
 import Login from './components/utilities/Login.vue'
 export type * from './types'
 
@@ -30,7 +30,6 @@ function install(app: App /* options */) {
 	app.use(installATable) // Install ATable components for use within AForm
 
 	app.component('ACheckbox', ACheckbox)
-	app.component('AComboBox', AComboBox)
 	app.component('ADate', ADate)
 	app.component('ADropdown', ADropdown)
 	app.component('ADatePicker', ADatePicker)
@@ -43,12 +42,12 @@ function install(app: App /* options */) {
 	app.component('AFormLink', AFormLink)
 	app.component('ANumericInput', ANumericInput)
 	app.component('ATextInput', ATextInput)
+	app.component('ATextarea', ATextarea)
 	app.component('ADuration', ADuration)
 }
 
 export {
 	ACheckbox,
-	AComboBox,
 	ADate,
 	ADropdown,
 	ADatePicker,
@@ -62,6 +61,7 @@ export {
 	AFormLink,
 	ANumericInput,
 	ATextInput,
+	ATextarea,
 	Login,
 	install,
 }

package/src/theme/login.css

@@ -1,2 +1 @@
-@import url('@stonecrop/themes/default.css');
 @import url('https://fonts.googleapis.com/css2?family=Material+Symbols+Outlined:opsz,wght,FILL,GRAD@20..48,100..700,0..1,-50..200');

package/src/types/index.ts

@@ -14,7 +14,18 @@ export type { InteractionMode } from '@stonecrop/schema'
 
 // ---------------------------------------------------------------------------
 // ResolvedField — the output-space type that AForm consumes
-// Produced by resolveSchema(); never authored directly.
+//
+// Usually produced by resolveSchema() from an authoring-space DoctypeField[].
+// It may also be hand-authored, for view chrome that has no backing doctype
+// (see Desktop.vue's doctype list) — annotate such literals with `satisfies
+// ResolvedTable`/`satisfies ResolvedField` so they stay checked.
+//
+// Authoring space and output space are NOT interchangeable. The trap is tables:
+// an authoring TableField carries its columns under `columns`, while resolveSchema
+// renames that key to `schema` (registry.ts) because `schema` is the ATable prop
+// that runs schemaToColumns(). Hand-authoring `columns` here — or feeding an
+// authoring-space field straight to AForm — produces a field AForm does not
+// recognise as a table.
 // ---------------------------------------------------------------------------
 
 /**
@@ -60,6 +71,14 @@ export interface ResolvedLink {
  * A resolved table — either from a Link with `noneOrMany`/`atLeastOne` cardinality,
  * or from an inline TableField. ATable receives columns via `:schema` (ColumnSchema[])
  * and row data via `:rows` from formData at render time.
+ *
+ * Note the key rename: an authoring `TableField` declares its columns under `columns`;
+ * `resolveSchema` moves them to `schema` here, because `schema` is the ATable prop that
+ * runs `schemaToColumns()` (ATable's own `columns` prop means already-converted
+ * `TableColumn[]`). A hand-authored table must therefore use `schema`, not `columns`.
+ *
+ * Rows are never part of the schema. AForm sources them from the data model at
+ * `dataModel[fieldname]`, so a `rows` key placed on this object is ignored.
  * @public
  */
 export interface ResolvedTable {
@@ -111,9 +130,13 @@ export interface ResolvedFieldset {
 }
 
 /**
- * The discriminated union of all resolved field types — what AForm consumes
- * after `resolveSchema()` has transformed the authoring `DoctypeField[]`.
+ * The discriminated union of all resolved field types — what AForm consumes,
+ * usually after `resolveSchema()` has transformed the authoring `DoctypeField[]`,
+ * but also valid hand-authored for view chrome with no backing doctype.
  * Narrowed by `kind`: `'field'` | `'link'` | `'table'` | `'fieldset'`.
+ *
+ * `kind` is required — AForm dispatches on it alone and does not infer a field's
+ * type from its structure.
  * @public
  */
 export type ResolvedField = ResolvedScalar | ResolvedLink | ResolvedTable | ResolvedFieldset
@@ -182,6 +205,14 @@ export type ComponentProps = {
 
 		[key: string]: any
 	}
+
+	/**
+	 * Inline validation error messages to display on this field. Fed by the host
+	 * (e.g. mapped from the core validation store) — the renderer stays dumb and just
+	 * shows what it is given. Takes precedence over the static `validation.errorMessage`.
+	 * @public
+	 */
+	errors?: string[]
 }
 
 /**

package/src/components/form/AComboBox.vue

@@ -1,17 +0,0 @@
-<template>
-	<ATableModal :event="event" :cell-data="cellData" class="amodal">
-		<div>
-			<input type="text" />
-			<input type="text" />
-			<input type="text" />
-		</div>
-	</ATableModal>
-</template>
-
-<script setup lang="ts">
-import type { ComponentProps } from '../../types'
-
-// TODO: change props from individual elements to the store object
-// TODO: implement full mode/display support
-defineProps<ComponentProps & { event?: any; cellData?: any; tableID?: string }>()
-</script>