@dmitryvim/form-builder 0.3.4 → 0.5.0

package/dist/types/components/file/library.d.ts

@@ -64,7 +64,7 @@ export declare function handleLibraryPickMulti(opts: HandleLibraryPickMultiOptio
  * @param state          Form builder state
  * @param element        FileElement schema definition
  * @param container      The .file-preview-container element
- * @param fileWrapper    The .space-y-2 wrapper that contains the hidden input
+ * @param fileWrapper    The .fb-row wrapper that contains the hidden input
  * @param pathKey        Field name / bracket-notation path for the hidden input
  * @param fieldPath      Bracket-notation field path (for onChange context)
  * @param renderCallback Called with the accepted resource ID; caller renders the tile

package/dist/types/components/textarea.d.ts

@@ -6,7 +6,9 @@ export declare function renderMultipleTextareaElement(element: TextareaElement,
  */
 export declare function validateTextareaElement(element: TextareaElement, key: string, context: ComponentContext): ValidationResult;
 /**
- * Update textarea field - delegates to text updater since they share update logic,
- * then triggers resize on autoExpand textareas.
+ * Update textarea field - delegates to text updater since they share update
+ * logic, then triggers resize so auto-expand recomputes height for the new
+ * value. As of v0.4.0 auto-expand is always on, so the resize event is
+ * dispatched unconditionally.
  */
 export declare function updateTextareaField(element: TextareaElement, fieldPath: string, value: any, context: ComponentContext): void;

package/dist/types/styles/theme.d.ts

@@ -88,6 +88,9 @@ export interface Theme {
     labelSectionFontSize: string;
     labelSectionLetterSpacing: string;
     labelSectionTextTransform: string;
+    labelFontSize: string;
+    labelLineHeight: string;
+    labelMarginBottom: string;
 }
 export declare const defaultTheme: Theme;
 /**

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

@@ -1,4 +1,4 @@
-export type { SelectOption, ElementAction, EnableCondition, BaseElement, TextElement, TextareaElement, NumberElement, SelectElement, SwitcherElement, BooleanElement, FileElement, FilesElement, ColourElement, SliderElement, ContainerElement, GroupElement, TableElement, TableMerge, TableData, RichInputElement, MarkdownElement, Element, Schema, ExternalAction, FormData, RenderContext, } from "./schema.js";
+export type { SelectOption, ElementAction, ElementSize, ElementWidth, EnableCondition, BaseElement, TextElement, TextareaElement, NumberElement, SelectElement, SwitcherElement, BooleanElement, FileElement, FilesElement, ColourElement, SliderElement, ContainerElement, GroupElement, TableElement, TableMerge, TableData, RichInputElement, MarkdownElement, Element, Schema, ExternalAction, FormData, RenderContext, } from "./schema.js";
 export type { Translations, Locale, Config, ResourceMetadata, PickedResource, } from "./config.js";
 export type { State } from "./state.js";
 export type { ComponentContext, ValidationResult, ComponentValidator, ComponentUpdater, ComponentOperations, } from "./component-operations.js";

package/dist/types/types/schema.d.ts

@@ -36,6 +36,20 @@ export interface EnableCondition {
     equals?: any;
     scope?: "relative" | "absolute";
 }
+/**
+ * Visual density token applied to input-bearing elements. Controls
+ * padding/font-size via the `.fb-size-{token}` class on the field wrapper.
+ * Defaults to `"md"`. Larger sizes (`lg`/`xl`) suit hero forms; smaller
+ * sizes (`sm`/`xs`) suit dense admin tables.
+ */
+export type ElementSize = "xs" | "sm" | "md" | "lg" | "xl";
+/**
+ * Horizontal slot the element occupies within its container's flex-wrap row.
+ * Defaults to `"full"` (own row). Mixing widths (e.g. `[1/2, 1/2, full]`)
+ * lets a single container hold both partial-column and full-width fields.
+ * Widths in one row should sum to ≤ 1; remainders leave whitespace.
+ */
+export type ElementWidth = "1/3" | "1/2" | "2/3" | "full";
 export interface BaseElement {
     type: string;
     key: string;
@@ -48,6 +62,10 @@ export interface BaseElement {
     default?: any;
     actions?: ElementAction[];
     enableIf?: EnableCondition;
+    /** Visual density. Default: "md". See {@link ElementSize}. */
+    size?: ElementSize;
+    /** Horizontal slot within container row. Default: "full". See {@link ElementWidth}. */
+    width?: ElementWidth;
 }
 export interface TextElement extends BaseElement {
     type: "text";
@@ -70,6 +88,11 @@ export interface TextareaElement extends BaseElement {
     multiple?: boolean;
     minCount?: number;
     maxCount?: number;
+    /**
+     * @deprecated As of v0.4.0 auto-expand is always on for textarea. This flag
+     * is ignored (kept only to avoid breaking existing schemas that set it).
+     * Use `rows` to set the initial visible row count.
+     */
     autoExpand?: boolean;
     addLabel?: string;
 }
@@ -132,13 +155,20 @@ export interface ContainerElement extends BaseElement {
     multiple?: boolean;
     minCount?: number;
     maxCount?: number;
+    /**
+     * Number of columns for horizontal layout (default: 1 for vertical).
+     * Applies to single containers (multiple !== true) and to `displayMode: "stack"` items.
+     * **Ignored for `displayMode: "slides"`** — slides use a responsive CSS grid;
+     * tune density via the `--fb-slide-min-width` CSS variable instead.
+     */
     columns?: 1 | 2 | 3 | 4;
     prefillHints?: PrefillHint[];
     /**
      * How items are arranged when `multiple: true`.
      * - "stack" (default): vertical list, one item per row (current behavior).
-     * - "slides": horizontal grid, multiple items per row, auto-wrap.
-     *   Each item card has min-width 280px and grows to fill available width.
+     * - "slides": responsive grid. Column count is driven by container width and
+     *   `--fb-slide-min-width` (default 280px). Schema `columns` is ignored —
+     *   override via theme / host CSS instead. See `.docs/theming.md` (Slides grid).
      * Ignored when `multiple: false`.
      */
     displayMode?: "stack" | "slides";

package/dist/types/utils/styles.d.ts

@@ -53,7 +53,9 @@ export declare function ensureThemingHooks(doc: Document): void;
  * where width hasn't moved — otherwise our own height writes would feed back
  * into the observer.
  */
-export declare function applyAutoExpand(textarea: HTMLTextAreaElement): void;
+export declare function applyAutoExpand(textarea: HTMLTextAreaElement, options?: {
+    minRows?: number;
+}): void;
 /**
  * Enforce single-line semantics on a textarea: block the Enter key and
  * strip newlines from pasted content. Used to render <textarea rows=1> as

package/package.json

@@ -3,7 +3,7 @@
   "publishConfig": {
     "access": "public"
   },
-  "version": "0.3.4",
+  "version": "0.5.0",
   "description": "A reusable JSON schema form builder library",
   "main": "./dist/cjs/index.cjs",
   "module": "./dist/esm/index.js",
@@ -52,23 +52,23 @@
     "url": "git+https://github.com/picazru/form-builder.git"
   },
   "devDependencies": {
-    "@babel/core": "^7.28.5",
-    "@babel/preset-env": "^7.28.5",
-    "@eslint/js": "^9.35.0",
-    "@rollup/plugin-commonjs": "^25.0.8",
-    "@rollup/plugin-node-resolve": "^15.2.3",
-    "@rollup/plugin-replace": "^6.0.2",
-    "@types/node": "^20.0.0",
-    "babel-jest": "^30.2.0",
-    "eslint": "^9.35.0",
-    "jest": "^29.0.0",
-    "jest-environment-jsdom": "^29.7.0",
-    "prettier": "^3.0.0",
-    "rollup": "^4.24.3",
-    "rollup-plugin-esbuild": "^6.1.0",
-    "serve": "^14.0.0",
-    "tsup": "^8.2.4",
-    "typescript": "^5.0.0",
-    "typescript-eslint": "^8.0.0"
+    "@babel/core": "^7.29.0",
+    "@babel/preset-env": "^7.29.5",
+    "@eslint/js": "^10.0.1",
+    "@rollup/plugin-commonjs": "^29.0.2",
+    "@rollup/plugin-node-resolve": "^16.0.3",
+    "@rollup/plugin-replace": "^6.0.3",
+    "@types/node": "^25.8.0",
+    "babel-jest": "^30.4.1",
+    "eslint": "^10.4.0",
+    "jest": "^30.4.2",
+    "jest-environment-jsdom": "^30.4.1",
+    "prettier": "^3.8.3",
+    "rollup": "^4.60.4",
+    "rollup-plugin-esbuild": "^6.2.1",
+    "serve": "^14.2.6",
+    "tsup": "^8.5.1",
+    "typescript": "^6.0.3",
+    "typescript-eslint": "^8.59.3"
   }
 }