@helpai/elements 0.62.1 → 0.63.0

package/configurator.d.ts

@@ -1,104 +1,69 @@
-import * as preact from 'preact';
-import { FunctionalComponent } from 'preact';
-import { z } from 'zod';
-
+import { z } from "zod";
+import { FunctionalComponent } from "preact";
+//#region src/configurator/configurator.d.ts
 /** Generic record — the configurator handles any object-shaped Zod schema. */
 type ConfigValue = Record<string, unknown>;
 interface ConfiguratorProps {
-    /**
-     * The schema to drive the form. Defaults to `widgetConfigSchema` (full
-     * surface). Pass `widgetSettingsSchema` for the dashboard-pushable UX
-     * subset, `connectionConfigSchema` for developer-facing API/auth, or
-     * any other `z.ZodObject` for arbitrary forms.
-     */
-    schema?: z.ZodObject<z.ZodRawShape>;
-    /** Current value — partial of whichever schema you passed. */
-    value: ConfigValue;
-    /** Fires on every change. Receives the full value object. */
-    onChange: (next: ConfigValue) => void;
-    /** Optional title rendered above the form. */
-    title?: string;
-    /**
-     * Top-level layout columns. `1` (default) — single flex column,
-     * suitable for narrow dashboards. `2` — two independent flex
-     * columns ("masonry"): top-level fields alternate by schema order
-     * (item 1 → col 1, item 2 → col 2, item 3 → col 1, …) so reading
-     * order matches schema order while each column flows
-     * independently. Expanding a collapsible grows it within its
-     * column without shifting the other column. Only affects the
-     * **top level** — nested object subforms stay single-column.
-     */
-    columns?: 1 | 2;
+  /**
+   * The schema to drive the form. Defaults to `widgetConfigSchema` (full
+   * surface). Pass `widgetSettingsSchema` for the dashboard-pushable UX
+   * subset, `connectionConfigSchema` for developer-facing API/auth, or
+   * any other `z.ZodObject` for arbitrary forms.
+   */
+  schema?: z.ZodObject<z.ZodRawShape>;
+  /** Current value — partial of whichever schema you passed. */
+  value: ConfigValue;
+  /** Fires on every change. Receives the full value object. */
+  onChange: (next: ConfigValue) => void;
+  /** Optional title rendered above the form. */
+  title?: string;
+  /**
+   * Top-level layout columns. `1` (default) — single flex column,
+   * suitable for narrow dashboards. `2` — two independent flex
+   * columns ("masonry"): top-level fields alternate by schema order
+   * (item 1 → col 1, item 2 → col 2, item 3 → col 1, …) so reading
+   * order matches schema order while each column flows
+   * independently. Expanding a collapsible grows it within its
+   * column without shifting the other column. Only affects the
+   * **top level** — nested object subforms stay single-column.
+   */
+  columns?: 1 | 2;
 }
-declare function Configurator({ schema, value, onChange, title, columns }: ConfiguratorProps): preact.JSX.Element;
-
-/**
- * Walks a Zod object schema and renders one form field per property.
- * Recursive — nested objects render as collapsible fieldsets.
- *
- * The dispatcher is a switch on the unwrapped `kindOf()` and a few
- * heuristics on field names (color, css length). Two annotations on
- * the schema influence the UI:
- *
- *   - `.describe("…")`           → help text shown inside the field's
- *                                  info popover (next to the label)
- *   - `.meta({ examples: […] })` → "Insert example" buttons inside the
- *                                  same popover, plus the first example
- *                                  becomes the textarea placeholder for
- *                                  JSON-fallback fields
- *
- * Description + examples are hidden behind a small `?` icon next to
- * each label so the form stays clean. Click the icon → an inline help
- * card expands beneath the field with the description text and one
- * button per example. The card is in the natural document flow so the
- * overlay's `overflow-y: auto` can't clip it.
- */
-
+declare function Configurator({ schema, value, onChange, title, columns }: ConfiguratorProps): import("preact").JSX.Element;
+//#endregion
+//#region src/configurator/object-field.d.ts
 interface ObjectFieldProps {
-    schema: z.ZodObject<z.ZodRawShape>;
-    value: Record<string, unknown> | undefined;
-    path: string[];
-    onChange: (next: Record<string, unknown> | undefined) => void;
-    /**
-     * Top-level layout columns. `1` (default) — single column.
-     * `2` — render top-level fields into two independent flex
-     * columns ("masonry"). Each column flows independently so
-     * expanding one card doesn't push the other column down. Items
-     * are distributed by a greedy bin-pack on a value-aware weight
-     * estimate so the columns end up roughly balanced visually (see
-     * `estimateFieldWeight` below) — naive odd/even put every heavy
-     * card on one side. Order within each column matches schema
-     * order. Only honoured at the top level (`path.length === 0`);
-     * nested object subforms always render single-column.
-     */
-    columns?: 1 | 2;
+  schema: z.ZodObject<z.ZodRawShape>;
+  value: Record<string, unknown> | undefined;
+  path: string[];
+  onChange: (next: Record<string, unknown> | undefined) => void;
+  /**
+   * Top-level layout columns. `1` (default) — single column.
+   * `2` — render top-level fields into two independent flex
+   * columns ("masonry"). Each column flows independently so
+   * expanding one card doesn't push the other column down. Items
+   * are distributed by a greedy bin-pack on a value-aware weight
+   * estimate so the columns end up roughly balanced visually (see
+   * `estimateFieldWeight` below) — naive odd/even put every heavy
+   * card on one side. Order within each column matches schema
+   * order. Only honoured at the top level (`path.length === 0`);
+   * nested object subforms always render single-column.
+   */
+  columns?: 1 | 2;
 }
 declare const ObjectField: FunctionalComponent<ObjectFieldProps>;
-
-/**
- * Zod 4 schema introspection helpers. The configurator walks a Zod
- * object tree and dispatches per-field renderers based on the underlying
- * type — these helpers normalize wrapped schemas (`.optional()`,
- * `.default(...)`, `.nullable()`) so the renderer dispatcher only has
- * to inspect the inner schema.
- *
- * Zod 4 stores its definition under `._def` with a lowercase `type`
- * field — `"string"`, `"object"`, `"optional"`, `"default"`, etc.
- * Wrappers expose `.innerType` for the wrapped schema. This file
- * deliberately couples to those internals; the alternative
- * (`.safeParse(undefined)` heuristics) is slower and brittler.
- */
-
+//#endregion
+//#region src/configurator/introspect.d.ts
 /**
  * Strip outer `.optional()` / `.default(...)` / `.nullable()` wrappers
  * to find the inner schema. Returns the unwrapped schema and a meta
  * record describing what was unwrapped.
  */
 declare function unwrap(schema: z.ZodTypeAny): {
-    inner: z.ZodTypeAny;
-    optional: boolean;
-    nullable: boolean;
-    defaultValue: unknown;
+  inner: z.ZodTypeAny;
+  optional: boolean;
+  nullable: boolean;
+  defaultValue: unknown;
 };
 /** Discriminate the unwrapped schema kind. Used by the renderer dispatcher. */
 type FieldKind = "string" | "number" | "boolean" | "enum" | "object" | "array" | "union" | "literal" | "record" | "unknown";
@@ -113,9 +78,9 @@ declare function objectFields(schema: z.ZodTypeAny): Record<string, z.ZodTypeAny
  * a flat `_def.checks` array, so introspection is best-effort.
  */
 declare function stringHints(schema: z.ZodTypeAny): {
-    maxLength?: number;
-    minLength?: number;
-    pattern?: string;
+  maxLength?: number;
+  minLength?: number;
+  pattern?: string;
 };
 /**
  * Heuristic: is this field probably a CSS color? A schema that's just
@@ -142,5 +107,6 @@ declare function schemaDescription(schema: z.ZodTypeAny): string | undefined;
 declare function schemaExamples(schema: z.ZodTypeAny): readonly unknown[];
 /** Pretty-print the first example as a JSON placeholder. Used by JSON-fallback fields. */
 declare function placeholderFromExamples(schema: z.ZodTypeAny): string | undefined;
-
-export { Configurator, type ConfiguratorProps, type FieldKind, ObjectField, enumValues, kindOf, looksLikeColor, objectFields, placeholderFromExamples, schemaDescription, schemaExamples, stringHints, unwrap };
+//#endregion
+export { Configurator, type ConfiguratorProps, FieldKind, ObjectField, enumValues, kindOf, looksLikeColor, objectFields, placeholderFromExamples, schemaDescription, schemaExamples, stringHints, unwrap };
+//# sourceMappingURL=configurator.d.ts.map