@stonecrop/aform 0.16.0 → 0.16.2

package/README.md

@@ -20,7 +20,7 @@ Schema-driven form components for the Stonecrop framework. Renders a `ResolvedFi
 | `AFormLink` | Linked document selector with search dropdown and navigation arrow |
 | `ANumericInput` | Numeric input with type-specific formatting |
 | `ATextInput` | Single-line text input |
-| `ATextarea` | Multi-line text input |
+| `ATextboxInput` | Multi-line long-text input |
 
 ## Installation
 

package/dist/aform.d.ts

@@ -13,7 +13,8 @@ import AFormLink from './components/form/AFormLink.vue';
 import AFormLoading from './components/AFormLoading.vue';
 import ANumericInput from './components/form/ANumericInput.vue';
 import type { App } from 'vue';
-import ATextarea from './components/form/ATextarea.vue';
+import AQuantityInput from './components/form/AQuantityInput.vue';
+import ATextboxInput from './components/form/ATextboxInput.vue';
 import ATextInput from './components/form/ATextInput.vue';
 import type { ColumnSchema } from '@stonecrop/schema';
 import type { FieldValidation } from '@stonecrop/schema';
@@ -72,7 +73,9 @@ export { AFormLoading }
 
 export { ANumericInput }
 
-export { ATextarea }
+export { AQuantityInput }
+
+export { ATextboxInput }
 
 export { ATextInput }
 
@@ -163,6 +166,38 @@ export { InteractionMode }
 
 export { Login }
 
+/**
+ * Type-specific configuration for AQuantityInput, passed via the field's `options` property.
+ * @public
+ */
+export declare interface QuantityOptions {
+    /** Dropdown choices for the `uom` field */
+    uoms?: string[];
+    /** The item's base/stock unit of measure — fixed, not user-editable */
+    stockUom?: string;
+    /** Conversion factor lookup for each non-stock UOM, relative to `stockUom` (which is implicitly `1`) */
+    conversionFactors?: Record<string, number>;
+}
+
+/**
+ * The value shape for AQuantityInput — a quantity paired with its unit of measure, plus the
+ * derived stock-equivalent quantity/UOM. `conversionFactor` is carried on the value so it
+ * round-trips with the record even though it is never shown in the UI.
+ * @public
+ */
+export declare interface QuantityValue {
+    /** The entered quantity, in `uom` units */
+    qty: number;
+    /** Unit of measure the user entered `qty` in */
+    uom: string;
+    /** `qty` converted into `stockUom` units — `qty * conversionFactor` */
+    stockQty: number;
+    /** The item's base/stock unit of measure — fixed, not user-editable */
+    stockUom: string;
+    /** Multiplier from `uom` to `stockUom` — hidden from the UI, drives `stockQty` */
+    conversionFactor: number;
+}
+
 /**
  * The discriminated union of all resolved field types — what AForm consumes,
  * usually after `resolveSchema()` has transformed the authoring `DoctypeField[]`,