@dmitryvim/form-builder 0.2.29 → 0.2.30

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

@@ -0,0 +1,15 @@
+import type { MarkdownElement, ComponentContext, ValidationResult } from "../../types/index.js";
+import { renderMarkdown } from "./render.js";
+export { renderMarkdown };
+/**
+ * Validate a markdown element.
+ * Markdown elements are display-only — they produce no value and no errors.
+ * Returning `{ value: undefined, errors: [] }` with the special `skip: true`
+ * flag tells the aggregation layer not to include this element in form data.
+ */
+export declare function validateMarkdown(_element: MarkdownElement, _key: string, _context: ComponentContext): ValidationResult;
+/**
+ * Update handler for markdown elements — noop.
+ * Markdown content is static; no programmatic update path is needed.
+ */
+export declare function updateMarkdown(_element: MarkdownElement, _fieldPath: string, _value: unknown, _context: ComponentContext): void;

package/dist/types/components/markdown/render.d.ts

@@ -0,0 +1,6 @@
+import type { MarkdownElement, RenderContext } from "../../types/index.js";
+/**
+ * Render a markdown element into the parent container.
+ * Returns the created wrapper element.
+ */
+export declare function renderMarkdown(element: MarkdownElement, _ctx: RenderContext, parent: HTMLElement): HTMLElement;

package/dist/types/components/markdown/snarkdown.d.ts

@@ -0,0 +1,2 @@
+/** Parse Markdown into an HTML String. */
+export default function parse(md: string, prevLinks?: Record<string, string>): string;

package/dist/types/index.d.ts

@@ -5,7 +5,7 @@
  */
 import { FormBuilderInstance } from "./instance/FormBuilderInstance.js";
 import { validateSchema } from "./utils/validation.js";
-export type { SelectOption, ElementAction, BaseElement, TextElement, TextareaElement, NumberElement, SelectElement, FileElement, FilesElement, ContainerElement, GroupElement, RichInputElement, Element, Schema, ExternalAction, FormData, RenderContext, Translations, Locale, Config, ResourceMetadata, PickedResource, State, } from "./types/index.js";
+export type { SelectOption, ElementAction, BaseElement, TextElement, TextareaElement, NumberElement, SelectElement, FileElement, FilesElement, ContainerElement, GroupElement, MarkdownElement, RichInputElement, Element, Schema, ExternalAction, FormData, RenderContext, Translations, Locale, Config, ResourceMetadata, PickedResource, State, } from "./types/index.js";
 export type { Theme } from "./styles/theme.js";
 export { defaultTheme, exampleThemes } from "./styles/theme.js";
 /**

package/dist/types/instance/FormBuilderInstance.d.ts

@@ -141,6 +141,16 @@ export declare class FormBuilderInstance {
      * Delegates to component-specific updaters via registry
      */
     private updateFieldValue;
+    /**
+     * Find the field wrapper DOM element for a given element+path combo.
+     * Used by reevaluateConditionalFields.
+     */
+    private findFieldWrapper;
+    /**
+     * Apply enableIf show/hide logic to a single field wrapper.
+     * Extracted to reduce cyclomatic complexity of checkElements.
+     */
+    private applyEnableIfVisibility;
     /**
      * Re-evaluate all conditional fields (enableIf) based on current form data
      * This is called automatically when form data changes (via onChange events)

package/dist/types/types/component-operations.d.ts

@@ -26,6 +26,11 @@ export interface ValidationResult {
     errors: string[];
     /** When true, value is spread into parent data instead of nested under element.key */
     spread?: boolean;
+    /**
+     * When true, this element should be completely excluded from form data output.
+     * Used by display-only elements (e.g., markdown) that have no associated value.
+     */
+    skip?: boolean;
 }
 /**
  * Component validator function type

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

@@ -1,4 +1,4 @@
-export type { SelectOption, ElementAction, EnableCondition, BaseElement, TextElement, TextareaElement, NumberElement, SelectElement, SwitcherElement, FileElement, FilesElement, ColourElement, SliderElement, ContainerElement, GroupElement, TableElement, TableMerge, TableData, RichInputElement, Element, Schema, ExternalAction, FormData, RenderContext, } from "./schema.js";
+export type { SelectOption, ElementAction, EnableCondition, BaseElement, TextElement, TextareaElement, NumberElement, SelectElement, SwitcherElement, 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

@@ -186,6 +186,19 @@ export interface TableElement extends BaseElement {
 export interface HiddenElement extends BaseElement {
     type: "hidden";
 }
+/**
+ * Markdown display element — renders arbitrary text/headings/lists/links
+ * between input fields. Produces no form data entry. `key` is optional
+ * (only used as a stable DOM id for enableIf targeting).
+ *
+ * Extends BaseElement (with key made optional) so that existing code that
+ * accesses BaseElement properties on Element union members continues to compile.
+ */
+export interface MarkdownElement extends Omit<BaseElement, "key"> {
+    type: "markdown";
+    content: string;
+    key?: string;
+}
 export interface RichInputElement extends BaseElement {
     type: "richinput";
     placeholder?: string;
@@ -200,7 +213,7 @@ export interface RichInputElement extends BaseElement {
     filesKey?: string;
     flatOutput?: boolean;
 }
-export type Element = TextElement | TextareaElement | NumberElement | SelectElement | SwitcherElement | FileElement | FilesElement | HiddenElement | ColourElement | SliderElement | ContainerElement | GroupElement | TableElement | RichInputElement;
+export type Element = TextElement | TextareaElement | NumberElement | SelectElement | SwitcherElement | FileElement | FilesElement | HiddenElement | ColourElement | SliderElement | ContainerElement | GroupElement | TableElement | RichInputElement | MarkdownElement;
 export interface Schema {
     version?: string;
     elements: Element[];

package/dist/types/types/state.d.ts

@@ -1,4 +1,4 @@
-import type { Schema, ExternalAction } from "./schema.js";
+import type { Schema, ExternalAction, Element } from "./schema.js";
 import type { Config, ResourceMetadata } from "./config.js";
 export interface State {
     schema: Schema | null;
@@ -9,4 +9,8 @@ export interface State {
     config: Config;
     debounceTimer: number | null;
     prefill: Record<string, any>;
+    /** Stable synthetic IDs for keyless elements (e.g. markdown without a key). WeakMap so elements can be GC'd. */
+    syntheticElementIds: WeakMap<Element, string>;
+    /** Counter for generating unique synthetic IDs. */
+    syntheticElementIdCounter: number;
 }

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

@@ -1,4 +1,5 @@
 import type { State } from "../types/state.js";
+import type { Element } from "../types/schema.js";
 export declare function isElementReadonly(element: {
     readonly?: boolean;
 }, state: State, ctx?: {
@@ -10,6 +11,19 @@ export declare function isPlainObject(obj: any): obj is Record<string, any>;
  * Use when inserting user-controlled or translated content via innerHTML
  */
 export declare function escapeHtml(text: string): string;
+/**
+ * Return a stable lookup key for a schema element.
+ *
+ * For elements that carry a `key`, returns that key directly.
+ * For keyless elements (e.g. markdown display blocks), generates and caches a
+ * synthetic id in `state.syntheticElementIds` so that the same id is returned
+ * on every subsequent call for the same element object. This makes enableIf
+ * re-evaluation work correctly for keyless elements.
+ *
+ * The WeakMap does not prevent GC of the element objects — correct for schema
+ * elements that are owned by the caller and may be released after `destroy()`.
+ */
+export declare function getElementLookupKey(element: Element, state: State): string;
 export declare function pathJoin(base: string, key: string): string;
 export declare function pretty(obj: any): string;
 export declare function clear(node: HTMLElement): void;

package/package.json

@@ -3,7 +3,7 @@
   "publishConfig": {
     "access": "public"
   },
-  "version": "0.2.29",
+  "version": "0.2.30",
   "description": "A reusable JSON schema form builder library",
   "main": "./dist/cjs/index.cjs",
   "module": "./dist/esm/index.js",