@stonecrop/aform 0.11.9 → 0.12.0

package/dist/aform.d.ts

@@ -10,6 +10,7 @@ import AFormLink from './components/form/AFormLink.vue';
 import ANumericInput from './components/form/ANumericInput.vue';
 import type { App } from 'vue';
 import ATextInput from './components/form/ATextInput.vue';
+import type { ColumnSchema } from '@stonecrop/schema';
 import Login from './components/utilities/Login.vue';
 import type { TableColumn } from '@stonecrop/atable';
 import type { TableConfig } from '@stonecrop/atable';
@@ -83,6 +84,12 @@ export declare type BaseSchema = {
      * @public
      */
     mode?: FormMode;
+    /**
+     * Hide the field from the form UI while keeping it in the data model.
+     * Consumed by AForm — not passed down to field components.
+     * @public
+     */
+    hidden?: boolean;
 };
 
 /**
@@ -137,6 +144,22 @@ export declare type ComponentProps = {
     };
 };
 
+/**
+ * Deserializes a stringified function expression into a typed callable.
+ *
+ * Throws if the string cannot be parsed as a function (SyntaxError) or if the
+ * resulting expression is not callable (TypeError), or if the expression references
+ * an undefined variable (ReferenceError). Callers are responsible for try/catch.
+ *
+ * @example
+ * ```ts
+ * const fn = deserializeFunction<(x: number) => number>('(x) => x * 2')
+ * fn(5) // 10
+ * ```
+ * @public
+ */
+export declare function deserializeFunction<T extends (...args: any[]) => any>(source: string): T;
+
 /**
  * Schema structure for defining fieldsets inside AForm
  * @public
@@ -226,15 +249,16 @@ export { Login }
 export declare type SchemaTypes = FormSchema | TableSchema | FieldsetSchema;
 
 /**
- * Schema structure for defining tables inside AForm
+ * Schema structure for defining tables inside AForm.
+ *
+ * Two mutually exclusive forms:
+ * - **Columns-based** (no `kind`): caller provides `columns` directly
+ * - **Schema-delegated** (`kind: 'table'`): caller provides `schema`; ATable runs
+ *   `schemaToColumns` to derive columns at render time
+ *
  * @public
  */
 export declare type TableSchema = BaseSchema & {
-    /**
-     * The columns to display in the table
-     * @public
-     */
-    columns?: TableColumn[];
     /**
      * The configuration for the table
      * @public
@@ -245,7 +269,18 @@ export declare type TableSchema = BaseSchema & {
      * @public
      */
     rows?: TableRow[];
-};
+} & ({
+    /** Explicit column definitions; `schema` and `kind` must not be set */
+    columns?: TableColumn[];
+    kind?: never;
+    schema?: never;
+} | {
+    /** Marks this entry as schema-delegated; ATable derives columns from `schema` */
+    kind: 'table';
+    /** Child schema passed to ATable's `schema` prop */
+    schema: ColumnSchema[];
+    columns?: never;
+});
 
 
 export * from "@stonecrop/atable/types";