@stonecrop/aform 0.10.11 → 0.10.13

package/dist/index.js

@@ -10,6 +10,7 @@ import AForm from './components/AForm.vue';
 import ANumericInput from './components/form/ANumericInput.vue';
 import ATextInput from './components/form/ATextInput.vue';
 import Login from './components/utilities/Login.vue';
+export { isDoctypeMany } from './utils/doctype';
 /**
  * Install all AForm components
  * @param app - Vue app instance
@@ -18,7 +19,7 @@ import Login from './components/utilities/Login.vue';
 function install(app /* options */) {
     app.use(installATable); // Install ATable components for use within AForm
     app.component('ACheckbox', ACheckbox);
-    app.component('ACombobox', AComboBox);
+    app.component('AComboBox', AComboBox);
     app.component('ADate', ADate);
     app.component('ADropdown', ADropdown);
     app.component('ADatePicker', ADatePicker);

package/dist/src/index.d.ts

@@ -12,6 +12,7 @@ import ANumericInput from './components/form/ANumericInput.vue';
 import ATextInput from './components/form/ATextInput.vue';
 import Login from './components/utilities/Login.vue';
 export type * from './types';
+export { isDoctypeMany } from './utils/doctype';
 /**
  * Install all AForm components
  * @param app - Vue app instance

package/dist/src/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,mBAAmB,yBAAyB,CAAA;AAE5C,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,KAAK,CAAA;AAE9B,OAAO,SAAS,MAAM,iCAAiC,CAAA;AACvD,OAAO,SAAS,MAAM,iCAAiC,CAAA;AACvD,OAAO,KAAK,MAAM,6BAA6B,CAAA;AAC/C,OAAO,SAAS,MAAM,iCAAiC,CAAA;AACvD,OAAO,WAAW,MAAM,mCAAmC,CAAA;AAC3D,OAAO,SAAS,MAAM,iCAAiC,CAAA;AACvD,OAAO,WAAW,MAAM,mCAAmC,CAAA;AAC3D,OAAO,KAAK,MAAM,wBAAwB,CAAA;AAC1C,OAAO,aAAa,MAAM,qCAAqC,CAAA;AAC/D,OAAO,UAAU,MAAM,kCAAkC,CAAA;AACzD,OAAO,KAAK,MAAM,kCAAkC,CAAA;AACpD,mBAAmB,SAAS,CAAA;AAE5B;;;;GAIG;AACH,iBAAS,OAAO,CAAC,GAAG,EAAE,GAAG,QAYxB;AAED,OAAO,EACN,SAAS,EACT,SAAS,EACT,KAAK,EACL,SAAS,EACT,WAAW,EACX,SAAS,EACT,WAAW,EACX,KAAK,EACL,aAAa,EACb,UAAU,EACV,KAAK,EACL,OAAO,GACP,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,mBAAmB,yBAAyB,CAAA;AAE5C,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,KAAK,CAAA;AAE9B,OAAO,SAAS,MAAM,iCAAiC,CAAA;AACvD,OAAO,SAAS,MAAM,iCAAiC,CAAA;AACvD,OAAO,KAAK,MAAM,6BAA6B,CAAA;AAC/C,OAAO,SAAS,MAAM,iCAAiC,CAAA;AACvD,OAAO,WAAW,MAAM,mCAAmC,CAAA;AAC3D,OAAO,SAAS,MAAM,iCAAiC,CAAA;AACvD,OAAO,WAAW,MAAM,mCAAmC,CAAA;AAC3D,OAAO,KAAK,MAAM,wBAAwB,CAAA;AAC1C,OAAO,aAAa,MAAM,qCAAqC,CAAA;AAC/D,OAAO,UAAU,MAAM,kCAAkC,CAAA;AACzD,OAAO,KAAK,MAAM,kCAAkC,CAAA;AACpD,mBAAmB,SAAS,CAAA;AAC5B,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAA;AAE/C;;;;GAIG;AACH,iBAAS,OAAO,CAAC,GAAG,EAAE,GAAG,QAaxB;AAED,OAAO,EACN,SAAS,EACT,SAAS,EACT,KAAK,EACL,SAAS,EACT,WAAW,EACX,SAAS,EACT,WAAW,EACX,KAAK,EACL,aAAa,EACb,UAAU,EACV,KAAK,EACL,OAAO,GACP,CAAA"}

package/dist/src/types/index.d.ts

@@ -168,12 +168,13 @@ export type FieldsetSchema = BaseSchema & {
     collapsible?: boolean;
 };
 /**
- * Schema structure for defining nested doctype fields inside AForm
+ * Schema structure for a 1:1 nested doctype field inside AForm
  *
  * @remarks
- * When a field has `fieldtype: 'Doctype'`, the `options` property contains the slug
- * of the referenced doctype. The `schema` property is populated by the framework's
- * `registry.resolveSchema()` method with the resolved child schema fields.
+ * When a field has `fieldtype: 'Doctype'` without `cardinality: 'many'`, it represents
+ * a 1:1 nested form. The `options` property contains the slug of the referenced doctype.
+ * The `schema` property is populated by the framework's `registry.resolveSchema()` method
+ * with the resolved child schema fields.
  *
  * Before resolution: `{ fieldname: 'address', fieldtype: 'Doctype', options: 'address' }`
  * After resolution: `{ fieldname: 'address', fieldtype: 'Doctype', options: 'address', schema: [...resolved fields...] }`
@@ -182,7 +183,7 @@ export type FieldsetSchema = BaseSchema & {
  *
  * @public
  */
-export type DoctypeSchema = BaseSchema & {
+export type DoctypeOneSchema = BaseSchema & {
     /**
      * The field type - must be 'Doctype' for nested doctype fields
      * @public
@@ -198,6 +199,11 @@ export type DoctypeSchema = BaseSchema & {
      * @public
      */
     label?: string;
+    /**
+     * The cardinality of the relationship — `'one'` or omitted means 1:1 nested form
+     * @public
+     */
+    cardinality?: 'one';
     /**
      * The resolved child schema fields, populated by `registry.resolveSchema()`
      * or provided manually for standalone usage
@@ -206,11 +212,12 @@ export type DoctypeSchema = BaseSchema & {
     schema?: SchemaTypes[];
 };
 /**
- * Schema structure for defining 1:many child table fields inside AForm
+ * Schema structure for a 1:many child table field inside AForm
  *
  * @remarks
- * When a field has `fieldtype: 'Table'`, the `options` property contains the slug
- * of the child doctype whose records appear as table rows.
+ * When a field has `fieldtype: 'Doctype'` with `cardinality: 'many'`, it represents
+ * a 1:many child table. The `options` property contains the slug of the child doctype
+ * whose records appear as table rows.
  *
  * `Registry.resolveSchema()` auto-derives `columns` from the child doctype's schema
  * fields and sets sensible defaults for `component` (`'ATable'`) and `config` (`{ view: 'list' }`).
@@ -220,12 +227,12 @@ export type DoctypeSchema = BaseSchema & {
  *
  * @public
  */
-export type TableDoctypeSchema = BaseSchema & {
+export type DoctypeManySchema = BaseSchema & {
     /**
-     * The field type — must be 'Table' for 1:many child table fields
+     * The field type - must be 'Doctype' for nested doctype fields
      * @public
      */
-    fieldtype: 'Table';
+    fieldtype: 'Doctype';
     /**
      * The slug of the child doctype in the registry
      * @public
@@ -236,6 +243,11 @@ export type TableDoctypeSchema = BaseSchema & {
      * @public
      */
     label?: string;
+    /**
+     * The cardinality of the relationship — `'many'` means 1:many child table
+     * @public
+     */
+    cardinality: 'many';
     /**
      * Table columns — auto-derived from child doctype schema if not provided
      * @public
@@ -251,10 +263,25 @@ export type TableDoctypeSchema = BaseSchema & {
      * @public
      */
     rows?: TableRow[];
+    /**
+     * The component to render — defaults to `'ATable'` when resolved
+     * @public
+     */
+    component?: string;
 };
+/**
+ * Discriminated union for Doctype fields — either 1:1 nested form or 1:many child table
+ *
+ * @remarks
+ * Use `isDoctypeMany()` type guard to narrow to `DoctypeManySchema`.
+ * When `cardinality` is `'many'` or omitted, the field is a 1:1 nested form.
+ *
+ * @public
+ */
+export type DoctypeSchema = DoctypeOneSchema | DoctypeManySchema;
 /**
  * Superset of all schema types for AForm
  * @public
  */
-export type SchemaTypes = FormSchema | TableSchema | FieldsetSchema | DoctypeSchema | TableDoctypeSchema;
+export type SchemaTypes = FormSchema | TableSchema | FieldsetSchema | DoctypeSchema;
 //# sourceMappingURL=index.d.ts.map

package/dist/src/types/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/types/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/types/index.ts"],"names":[],"mappings":"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"}

package/dist/src/utils/doctype.d.ts

@@ -0,0 +1,10 @@
+import type { DoctypeSchema, DoctypeManySchema } from '../types';
+/**
+ * Type guard that checks whether a Doctype schema field has `cardinality: 'many'`
+ *
+ * @param field - A DoctypeSchema field to check
+ * @returns `true` if the field has `cardinality: 'many'`
+ * @public
+ */
+export declare function isDoctypeMany(field: DoctypeSchema): field is DoctypeManySchema;
+//# sourceMappingURL=doctype.d.ts.map

package/dist/src/utils/doctype.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"doctype.d.ts","sourceRoot":"","sources":["../../../src/utils/doctype.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,iBAAiB,EAAE,MAAM,UAAU,CAAA;AAEhE;;;;;;GAMG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,aAAa,GAAG,KAAK,IAAI,iBAAiB,CAE9E"}

package/dist/utils/doctype.js

@@ -0,0 +1,10 @@
+/**
+ * Type guard that checks whether a Doctype schema field has `cardinality: 'many'`
+ *
+ * @param field - A DoctypeSchema field to check
+ * @returns `true` if the field has `cardinality: 'many'`
+ * @public
+ */
+export function isDoctypeMany(field) {
+    return field.cardinality === 'many';
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@stonecrop/aform",
-  "version": "0.10.11",
+  "version": "0.10.13",
   "license": "MIT",
   "type": "module",
   "author": {
@@ -35,9 +35,9 @@
   "dependencies": {
     "@vueuse/core": "^14.2.1",
     "@vueuse/components": "^14.2.1",
-    "@stonecrop/atable": "0.10.11",
-    "@stonecrop/themes": "0.10.11",
-    "@stonecrop/utilities": "0.10.11"
+    "@stonecrop/atable": "0.10.13",
+    "@stonecrop/utilities": "0.10.13",
+    "@stonecrop/themes": "0.10.13"
   },
   "peerDependencies": {
     "pinia": "^3.0.4",

package/src/index.ts

@@ -14,6 +14,7 @@ import ANumericInput from './components/form/ANumericInput.vue'
 import ATextInput from './components/form/ATextInput.vue'
 import Login from './components/utilities/Login.vue'
 export type * from './types'
+export { isDoctypeMany } from './utils/doctype'
 
 /**
  * Install all AForm components
@@ -22,8 +23,9 @@ export type * from './types'
  */
 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('AComboBox', AComboBox)
 	app.component('ADate', ADate)
 	app.component('ADropdown', ADropdown)
 	app.component('ADatePicker', ADatePicker)

package/src/types/index.ts

@@ -194,12 +194,13 @@ export type FieldsetSchema = BaseSchema & {
 }
 
 /**
- * Schema structure for defining nested doctype fields inside AForm
+ * Schema structure for a 1:1 nested doctype field inside AForm
  *
  * @remarks
- * When a field has `fieldtype: 'Doctype'`, the `options` property contains the slug
- * of the referenced doctype. The `schema` property is populated by the framework's
- * `registry.resolveSchema()` method with the resolved child schema fields.
+ * When a field has `fieldtype: 'Doctype'` without `cardinality: 'many'`, it represents
+ * a 1:1 nested form. The `options` property contains the slug of the referenced doctype.
+ * The `schema` property is populated by the framework's `registry.resolveSchema()` method
+ * with the resolved child schema fields.
  *
  * Before resolution: `{ fieldname: 'address', fieldtype: 'Doctype', options: 'address' }`
  * After resolution: `{ fieldname: 'address', fieldtype: 'Doctype', options: 'address', schema: [...resolved fields...] }`
@@ -208,7 +209,7 @@ export type FieldsetSchema = BaseSchema & {
  *
  * @public
  */
-export type DoctypeSchema = BaseSchema & {
+export type DoctypeOneSchema = BaseSchema & {
 	/**
 	 * The field type - must be 'Doctype' for nested doctype fields
 	 * @public
@@ -227,6 +228,12 @@ export type DoctypeSchema = BaseSchema & {
 	 */
 	label?: string
 
+	/**
+	 * The cardinality of the relationship — `'one'` or omitted means 1:1 nested form
+	 * @public
+	 */
+	cardinality?: 'one'
+
 	/**
 	 * The resolved child schema fields, populated by `registry.resolveSchema()`
 	 * or provided manually for standalone usage
@@ -236,11 +243,12 @@ export type DoctypeSchema = BaseSchema & {
 }
 
 /**
- * Schema structure for defining 1:many child table fields inside AForm
+ * Schema structure for a 1:many child table field inside AForm
  *
  * @remarks
- * When a field has `fieldtype: 'Table'`, the `options` property contains the slug
- * of the child doctype whose records appear as table rows.
+ * When a field has `fieldtype: 'Doctype'` with `cardinality: 'many'`, it represents
+ * a 1:many child table. The `options` property contains the slug of the child doctype
+ * whose records appear as table rows.
  *
  * `Registry.resolveSchema()` auto-derives `columns` from the child doctype's schema
  * fields and sets sensible defaults for `component` (`'ATable'`) and `config` (`{ view: 'list' }`).
@@ -250,12 +258,12 @@ export type DoctypeSchema = BaseSchema & {
  *
  * @public
  */
-export type TableDoctypeSchema = BaseSchema & {
+export type DoctypeManySchema = BaseSchema & {
 	/**
-	 * The field type — must be 'Table' for 1:many child table fields
+	 * The field type - must be 'Doctype' for nested doctype fields
 	 * @public
 	 */
-	fieldtype: 'Table'
+	fieldtype: 'Doctype'
 
 	/**
 	 * The slug of the child doctype in the registry
@@ -269,6 +277,12 @@ export type TableDoctypeSchema = BaseSchema & {
 	 */
 	label?: string
 
+	/**
+	 * The cardinality of the relationship — `'many'` means 1:many child table
+	 * @public
+	 */
+	cardinality: 'many'
+
 	/**
 	 * Table columns — auto-derived from child doctype schema if not provided
 	 * @public
@@ -286,10 +300,27 @@ export type TableDoctypeSchema = BaseSchema & {
 	 * @public
 	 */
 	rows?: TableRow[]
+
+	/**
+	 * The component to render — defaults to `'ATable'` when resolved
+	 * @public
+	 */
+	component?: string
 }
 
+/**
+ * Discriminated union for Doctype fields — either 1:1 nested form or 1:many child table
+ *
+ * @remarks
+ * Use `isDoctypeMany()` type guard to narrow to `DoctypeManySchema`.
+ * When `cardinality` is `'many'` or omitted, the field is a 1:1 nested form.
+ *
+ * @public
+ */
+export type DoctypeSchema = DoctypeOneSchema | DoctypeManySchema
+
 /**
  * Superset of all schema types for AForm
  * @public
  */
-export type SchemaTypes = FormSchema | TableSchema | FieldsetSchema | DoctypeSchema | TableDoctypeSchema
+export type SchemaTypes = FormSchema | TableSchema | FieldsetSchema | DoctypeSchema

package/src/utils/doctype.ts

@@ -0,0 +1,12 @@
+import type { DoctypeSchema, DoctypeManySchema } from '../types'
+
+/**
+ * Type guard that checks whether a Doctype schema field has `cardinality: 'many'`
+ *
+ * @param field - A DoctypeSchema field to check
+ * @returns `true` if the field has `cardinality: 'many'`
+ * @public
+ */
+export function isDoctypeMany(field: DoctypeSchema): field is DoctypeManySchema {
+	return field.cardinality === 'many'
+}